@microagi/alchemy-gcp 0.3.0 → 0.5.0

package/lib/Sqladmin/Database.js

@@ -0,0 +1,87 @@
+import * as sql from "@distilled.cloud/gcp/sqladmin-v1";
+import { Resource } from "alchemy";
+import { isResolved, somePropsAreDifferent } from "alchemy/Diff";
+import * as Provider from "alchemy/Provider";
+import * as Effect from "effect/Effect";
+import { makeAwaitOperation } from "./Operations.js";
+import { reshapeBadRequest, validateDatabaseName } from "./Validation.js";
+export const SqlDatabase = Resource("GCP.SqlDatabase");
+const toAttributes = (d, parent) => ({
+    name: parent.name,
+    instance: parent.instance,
+    project: parent.project,
+    selfLink: d.selfLink ?? "",
+    charset: d.charset,
+    collation: d.collation,
+});
+export const SqlDatabaseProvider = () => Provider.effect(SqlDatabase, Effect.gen(function* () {
+    const getDatabases = yield* sql.getDatabases;
+    const insertDatabases = yield* sql.insertDatabases;
+    const deleteDatabases = yield* sql.deleteDatabases;
+    const getOperations = yield* sql.getOperations;
+    const awaitOperation = makeAwaitOperation(getOperations);
+    const observe = (project, instance, database) => getDatabases({ project, instance, database }).pipe(Effect.catchTag("NotFound", () => Effect.succeed(undefined)), Effect.catchTag("Forbidden", () => Effect.succeed(undefined)));
+    return {
+        stables: ["name", "instance", "project", "selfLink"],
+        diff: Effect.fn(function* ({ news, olds = {} }) {
+            if (!isResolved(news))
+                return undefined;
+            if (somePropsAreDifferent(olds, news, [
+                "project",
+                "instance",
+                "name",
+            ])) {
+                return { action: "replace" };
+            }
+            return undefined;
+        }),
+        reconcile: Effect.fn(function* ({ news, session }) {
+            yield* validateDatabaseName(news.name);
+            let observed = yield* observe(news.project, news.instance, news.name);
+            if (!observed) {
+                const op = yield* insertDatabases({
+                    project: news.project,
+                    instance: news.instance,
+                    body: {
+                        name: news.name,
+                        ...(news.charset ? { charset: news.charset } : {}),
+                        ...(news.collation ? { collation: news.collation } : {}),
+                    },
+                }).pipe(Effect.catchTag("Conflict", () => Effect.succeed(undefined)), Effect.catchTag("BadRequest", reshapeBadRequest("Database", "insert")));
+                if (op?.name)
+                    yield* awaitOperation(news.project, op.name, session);
+                observed = yield* getDatabases({
+                    project: news.project,
+                    instance: news.instance,
+                    database: news.name,
+                });
+            }
+            return toAttributes(observed, {
+                project: news.project,
+                instance: news.instance,
+                name: news.name,
+            });
+        }),
+        delete: Effect.fn(function* ({ output, session }) {
+            yield* deleteDatabases({
+                project: output.project,
+                instance: output.instance,
+                database: output.name,
+            }).pipe(Effect.flatMap((op) => op.name
+                ? awaitOperation(output.project, op.name, session)
+                : Effect.succeed(op)), Effect.catchTag("NotFound", () => Effect.void), Effect.catchTag("BadRequest", reshapeBadRequest("Database", "delete")));
+        }),
+        read: Effect.fn(function* ({ output, olds }) {
+            const project = output?.project ?? olds?.project;
+            const instance = output?.instance ?? olds?.instance;
+            const name = output?.name ?? olds?.name;
+            if (!project || !instance || !name)
+                return undefined;
+            const observed = yield* observe(project, instance, name);
+            if (!observed)
+                return undefined;
+            return toAttributes(observed, { project, instance, name });
+        }),
+    };
+}));
+//# sourceMappingURL=Database.js.map

package/lib/Sqladmin/Database.js.map

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

package/lib/Sqladmin/Instance.d.ts

@@ -0,0 +1,234 @@
+import { Resource } from "alchemy";
+import * as Provider from "alchemy/Provider";
+import * as Redacted from "effect/Redacted";
+import type * as GCP from "../Providers.ts";
+import type { PostgresVersion, SqlActivationPolicy, SqlAvailabilityType, SqlDataDiskType, SqlEdition } from "./Types.ts";
+/**
+ * A Cloud SQL for Postgres instance.
+ *
+ * **Resource model.** A Cloud SQL instance bundles the storage volume,
+ * compute tier, networking (public IP / VPC private IP via PSA), and
+ * managed backups. Databases (`GCP.SqlDatabase`) and users
+ * (`GCP.SqlUser`) hang off it and are modelled as separate resources.
+ *
+ * **Lifecycle.** observe → ensure (insert; retry on the "API not yet
+ * enabled" 403 propagation race) → sync (patch top-level fields, with
+ * `settingsVersion` round-trip for optimistic concurrency) → return.
+ *
+ * **Replace triggers.** `project`, `region`, `name`, `databaseVersion`.
+ * Everything else — tier, disk size, IP config, backup config — is
+ * in-place via `patch`.
+ *
+ * **Optimistic concurrency.** Cloud SQL uses `settings.settingsVersion`
+ * (NOT `etag` — etag is deprecated). Every patch reads the live
+ * instance and threads the observed `settingsVersion` through the
+ * body. Concurrent edits surface as `Conflict`.
+ *
+ * **Adoption.** Label-gated: an instance whose `settings.userLabels`
+ * lack our `alchemy_*` keys is wrapped in `Unowned(attrs)` from
+ * `read`, forcing `--adopt` before takeover.
+ *
+ * **Deletion protection.** When `settings.deletionProtectionEnabled`
+ * is `true`, alchemy `destroy` will fail with a `BadRequest`. Set the
+ * flag to `false` in a separate deploy (which patches the instance),
+ * then re-run destroy.
+ *
+ * @example Minimal private-IP Postgres 17 instance on a Shared VPC
+ * ```typescript
+ * const db = yield* GCP.SqlInstance("Primary", {
+ *   project: project.projectId,
+ *   region: "europe-west4",
+ *   databaseVersion: "POSTGRES_17",
+ *   settings: {
+ *     tier: "db-custom-2-7680",
+ *     edition: "ENTERPRISE",
+ *     dataDiskSizeGb: 50,
+ *     ipConfiguration: {
+ *       ipv4Enabled: false,
+ *       privateNetwork: hostVpc.selfLink,
+ *     },
+ *     backupConfiguration: { enabled: true, pointInTimeRecoveryEnabled: true },
+ *   },
+ * });
+ * ```
+ *
+ * @see https://cloud.google.com/sql/docs/postgres/admin-api/rest/v1/instances
+ */
+export type SqlInstanceProps = {
+    /**
+     * GCP project ID hosting the instance. Immutable — replace if changed.
+     * @see https://cloud.google.com/sql/docs/postgres/admin-api/rest/v1/instances#SqlInstance
+     */
+    project: string;
+    /**
+     * Cloud SQL region (e.g. `europe-west4`). Cloud SQL is regional;
+     * zonality is configured inside `settings.availabilityType`.
+     * Immutable — replace if changed.
+     * @see https://cloud.google.com/sql/docs/postgres/locations
+     */
+    region: string;
+    /**
+     * Instance name. Defaults to `createPhysicalName({ id, lowercase:
+     * true, maxLength: 98 })`. Lowercase letters/digits/hyphens; begin
+     * with a letter, no trailing hyphen; 1–98 chars. Immutable — replace.
+     * @see https://cloud.google.com/sql/docs/postgres/admin-api/rest/v1/instances#SqlInstance
+     */
+    name?: string;
+    /**
+     * Postgres engine version. Immutable — Cloud SQL exposes major
+     * version *upgrades* via a separate `upgrade` operation, not via
+     * `patch`. Surfacing it as immutable here forces an explicit replace
+     * (or out-of-band upgrade) for clarity.
+     * @see https://cloud.google.com/sql/docs/postgres/db-versions
+     */
+    databaseVersion: PostgresVersion;
+    /**
+     * Initial Postgres `postgres` superuser password. Only set on
+     * insert; ignored on subsequent patches (Cloud SQL silently drops
+     * `rootPassword` on patch). Typically omitted on IAM-only stacks
+     * since the `postgres` role is unused.
+     * @see https://cloud.google.com/sql/docs/postgres/create-manage-users#user-root
+     */
+    rootPassword?: Redacted.Redacted<string>;
+    /**
+     * Resource labels. Alchemy internal labels (`alchemy_app`,
+     * `alchemy_stage`, `alchemy_id`) are merged on top automatically.
+     * Cloud SQL stores user labels under `settings.userLabels`; we
+     * surface them at the top level for symmetry with other GCP
+     * resources. Mutable via `patch`.
+     * @see https://cloud.google.com/sql/docs/postgres/label-instance
+     */
+    labels?: Record<string, string>;
+    /** Instance settings (tier, disk, IP, backups, …). Mostly mutable via `patch`. */
+    settings: {
+        /**
+         * Machine tier (`db-custom-{vCPU}-{memMiB}`, `db-f1-micro`,
+         * `db-perf-optimized-*`). Mutable via `patch` (causes a restart).
+         * @see https://cloud.google.com/sql/docs/postgres/instance-settings
+         */
+        tier: string;
+        /**
+         * Cloud SQL edition. `ENTERPRISE_PLUS` is required for
+         * Data Cache + the `db-perf-optimized-*` tiers. Mutable via
+         * `patch` (some transitions require a restart).
+         * @see https://cloud.google.com/sql/docs/postgres/editions-intro
+         */
+        edition?: SqlEdition;
+        /**
+         * Storage size in GB. Mutable via `patch`; can only grow, not
+         * shrink (shrink requires a side-channel operation).
+         * @see https://cloud.google.com/sql/docs/postgres/instance-settings#storage-capacity-2ndgen
+         */
+        dataDiskSizeGb?: number;
+        /**
+         * Disk type. `PD_SSD` is the default; `PD_HDD` is legacy.
+         * Immutable in practice — Cloud SQL rejects type changes on patch.
+         * @see https://cloud.google.com/sql/docs/postgres/instance-settings#storage-type-2ndgen
+         */
+        dataDiskType?: SqlDataDiskType;
+        /** Auto-grow the data disk when nearing full. Mutable via `patch`. */
+        diskAutoresize?: boolean;
+        /** Cap on auto-grown size, in GB. Mutable via `patch`. */
+        diskAutoresizeLimit?: number;
+        /** Networking — public IP, private IP via PSA, or both. Mutable via `patch`. */
+        ipConfiguration?: {
+            /**
+             * VPC selfLink (`https://www.googleapis.com/compute/v1/projects/{p}/global/networks/{n}`)
+             * to attach the private IP to. The VPC must already have a PSA
+             * peering with `servicenetworking.googleapis.com`. Immutable
+             * after first set (Cloud SQL refuses to change the private network).
+             * @see https://cloud.google.com/sql/docs/postgres/private-ip
+             */
+            privateNetwork?: string;
+            /** Enable a public IPv4 endpoint. Mutable via `patch`. */
+            ipv4Enabled?: boolean;
+            /**
+             * Allow Google-managed services (BigQuery, Vertex AI, etc.) to
+             * reach the private IP over Google's backbone. Mutable via `patch`.
+             */
+            enablePrivatePathForGoogleCloudServices?: boolean;
+            /** Require SSL/TLS on all connections. Mutable via `patch`. */
+            requireSsl?: boolean;
+        };
+        /** Backup window + retention settings. Mutable via `patch`. */
+        backupConfiguration?: {
+            /** Enable automated daily backups. Mutable via `patch`. */
+            enabled?: boolean;
+            /** Enable PITR (write-ahead log archiving). Mutable via `patch`. */
+            pointInTimeRecoveryEnabled?: boolean;
+            /** Backup start time in UTC, `HH:MM` 24-hour. Mutable via `patch`. */
+            startTime?: string;
+            /** WAL retention window (1–7 days). Mutable via `patch`. */
+            transactionLogRetentionDays?: number;
+        };
+        /**
+         * Postgres flags (e.g. `shared_buffers`, `max_connections`).
+         * Mutable via `patch`; some flags trigger a restart.
+         * @see https://cloud.google.com/sql/docs/postgres/flags
+         */
+        databaseFlags?: ReadonlyArray<{
+            name: string;
+            value: string;
+        }>;
+        /**
+         * Block alchemy from deleting the instance via the API. Disable
+         * before running destroy.
+         * @see https://cloud.google.com/sql/docs/postgres/deletion-protection
+         */
+        deletionProtectionEnabled?: boolean;
+        /** Park (`NEVER`) or run (`ALWAYS`) the instance. Mutable via `patch`. */
+        activationPolicy?: SqlActivationPolicy;
+        /**
+         * `ZONAL` = single zone; `REGIONAL` = HA standby in a second zone.
+         * Mutable via `patch` (transitions to/from `REGIONAL` take ~10 min).
+         * @see https://cloud.google.com/sql/docs/postgres/high-availability
+         */
+        availabilityType?: SqlAvailabilityType;
+    };
+};
+export type SqlInstanceIpAddress = {
+    /** Address class — `PRIMARY` (public), `PRIVATE`, or `OUTGOING`. */
+    type: string | undefined;
+    /** The IP itself. */
+    ipAddress: string | undefined;
+};
+export type SqlInstanceAttributes = {
+    /** Bare instance name (no `projects/.../instances/` prefix). */
+    name: string;
+    /** Server-defined URL for the instance. */
+    selfLink: string;
+    /** GCP project ID. */
+    project: string;
+    /** Region. */
+    region: string;
+    /**
+     * `project:region:name` — the canonical identifier the Cloud SQL
+     * Auth Proxy and the IAM authn token exchange both consume.
+     */
+    connectionName: string;
+    /** Echoed Postgres version (e.g. `POSTGRES_17`). */
+    databaseVersion: string;
+    /** Lifecycle state — `RUNNABLE` once ready. */
+    state: string;
+    /** All IPs Cloud SQL has assigned. */
+    ipAddresses: ReadonlyArray<SqlInstanceIpAddress>;
+    /** Convenience: first `PRIVATE` IP, if any. */
+    privateIpAddress: string | undefined;
+    /** Convenience: first `PRIMARY` (public) IP, if any. */
+    publicIpAddress: string | undefined;
+    /** Server CA cert; useful for pinning TLS roots from a client. */
+    serverCaCert: {
+        cert: string | undefined;
+        commonName: string | undefined;
+        expirationTime: string | undefined;
+        sha1Fingerprint: string | undefined;
+    } | undefined;
+    /** Monotonic optimistic-concurrency token — round-tripped on patch. */
+    settingsVersion: string | undefined;
+    /** Labels currently set, including alchemy internals. */
+    labels: Record<string, string>;
+};
+export type SqlInstance = Resource<"GCP.SqlInstance", SqlInstanceProps, SqlInstanceAttributes, never, GCP.Providers>;
+export declare const SqlInstance: import("alchemy").ResourceClass<SqlInstance>;
+export declare const SqlInstanceProvider: () => import("effect/Layer").Layer<Provider.Provider<SqlInstance>, never, import("effect/unstable/http/HttpClient").HttpClient | import("alchemy").Stage | import("alchemy").Stack | import("@distilled.cloud/gcp").Credentials>;
+//# sourceMappingURL=Instance.d.ts.map

package/lib/Sqladmin/Instance.d.ts.map

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

package/lib/Sqladmin/Instance.js

@@ -0,0 +1,251 @@
+import * as sql from "@distilled.cloud/gcp/sqladmin-v1";
+import { Resource } from "alchemy";
+import { Unowned } from "alchemy/AdoptPolicy";
+import { deepEqual, isResolved, somePropsAreDifferent } from "alchemy/Diff";
+import { createPhysicalName } from "alchemy/PhysicalName";
+import * as Provider from "alchemy/Provider";
+import { diffTags } from "alchemy/Tags";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import * as Schedule from "effect/Schedule";
+import { gcpInternalLabels, hasAlchemyLabels } from "../Tags.js";
+import { makeAwaitOperation } from "./Operations.js";
+import { reshapeBadRequest, validateInstanceName } from "./Validation.js";
+export const SqlInstance = Resource("GCP.SqlInstance");
+const toAddress = (m) => ({
+    type: m.type,
+    ipAddress: m.ipAddress,
+});
+const toAttributes = (i, parent) => {
+    const ipAddresses = (i.ipAddresses ?? []).map(toAddress);
+    return {
+        name: parent.name,
+        selfLink: i.selfLink ?? "",
+        project: parent.project,
+        region: parent.region,
+        connectionName: i.connectionName ?? `${parent.project}:${parent.region}:${parent.name}`,
+        databaseVersion: i.databaseVersion ?? "",
+        state: i.state ?? "",
+        ipAddresses,
+        privateIpAddress: ipAddresses.find((a) => a.type === "PRIVATE")?.ipAddress,
+        publicIpAddress: ipAddresses.find((a) => a.type === "PRIMARY")?.ipAddress,
+        serverCaCert: i.serverCaCert
+            ? {
+                cert: i.serverCaCert.cert,
+                commonName: i.serverCaCert.commonName,
+                expirationTime: i.serverCaCert.expirationTime,
+                sha1Fingerprint: i.serverCaCert.sha1Fingerprint,
+            }
+            : undefined,
+        settingsVersion: i.settings?.settingsVersion,
+        labels: { ...(i.settings?.userLabels ?? {}) },
+    };
+};
+/**
+ * Build the `Settings` body sent to the API.
+ *
+ * Only sets fields the user has populated, so distinct from a settings
+ * stanza diff: server-injected defaults aren't overwritten by an
+ * `undefined` from us.
+ */
+const toSettingsBody = (s, userLabels, settingsVersion) => ({
+    tier: s.tier,
+    userLabels,
+    ...(s.edition ? { edition: s.edition } : {}),
+    ...(s.dataDiskSizeGb !== undefined
+        ? { dataDiskSizeGb: String(s.dataDiskSizeGb) }
+        : {}),
+    ...(s.dataDiskType ? { dataDiskType: s.dataDiskType } : {}),
+    ...(s.diskAutoresize !== undefined
+        ? { storageAutoResize: s.diskAutoresize }
+        : {}),
+    ...(s.diskAutoresizeLimit !== undefined
+        ? { storageAutoResizeLimit: String(s.diskAutoresizeLimit) }
+        : {}),
+    ...(s.ipConfiguration
+        ? {
+            ipConfiguration: {
+                ...(s.ipConfiguration.ipv4Enabled !== undefined
+                    ? { ipv4Enabled: s.ipConfiguration.ipv4Enabled }
+                    : {}),
+                ...(s.ipConfiguration.privateNetwork
+                    ? { privateNetwork: s.ipConfiguration.privateNetwork }
+                    : {}),
+                ...(s.ipConfiguration.enablePrivatePathForGoogleCloudServices !==
+                    undefined
+                    ? {
+                        enablePrivatePathForGoogleCloudServices: s.ipConfiguration.enablePrivatePathForGoogleCloudServices,
+                    }
+                    : {}),
+                ...(s.ipConfiguration.requireSsl !== undefined
+                    ? { requireSsl: s.ipConfiguration.requireSsl }
+                    : {}),
+            },
+        }
+        : {}),
+    ...(s.backupConfiguration ? { backupConfiguration: s.backupConfiguration } : {}),
+    ...(s.databaseFlags ? { databaseFlags: s.databaseFlags } : {}),
+    ...(s.deletionProtectionEnabled !== undefined
+        ? { deletionProtectionEnabled: s.deletionProtectionEnabled }
+        : {}),
+    ...(s.activationPolicy ? { activationPolicy: s.activationPolicy } : {}),
+    ...(s.availabilityType ? { availabilityType: s.availabilityType } : {}),
+    ...(settingsVersion !== undefined ? { settingsVersion } : {}),
+});
+export const SqlInstanceProvider = () => Provider.effect(SqlInstance, Effect.gen(function* () {
+    const getInstances = yield* sql.getInstances;
+    const insertInstances = yield* sql.insertInstances;
+    const patchInstances = yield* sql.patchInstances;
+    const deleteInstances = yield* sql.deleteInstances;
+    const getOperations = yield* sql.getOperations;
+    const awaitOperation = makeAwaitOperation(getOperations);
+    const observe = (project, name) => getInstances({ project, instance: name }).pipe(Effect.catchTag("NotFound", () => Effect.succeed(undefined)), Effect.catchTag("Forbidden", () => Effect.succeed(undefined)));
+    const syncMutable = Effect.fn(function* (args) {
+        const obsSettings = args.observed.settings ?? {};
+        const desiredSettingsForCompare = toSettingsBody(args.news.settings, args.desiredLabels);
+        // Per-field diff — settingsVersion is added below only if we
+        // actually need to patch, so it's not part of the no-op check.
+        let needPatch = false;
+        const reasons = [];
+        const compare = (key, a, b) => {
+            if (!deepEqual(a, b)) {
+                needPatch = true;
+                reasons.push(key);
+            }
+        };
+        compare("tier", obsSettings.tier, desiredSettingsForCompare.tier);
+        compare("edition", obsSettings.edition, desiredSettingsForCompare.edition);
+        compare("dataDiskSizeGb", obsSettings.dataDiskSizeGb, desiredSettingsForCompare.dataDiskSizeGb);
+        compare("dataDiskType", obsSettings.dataDiskType, desiredSettingsForCompare.dataDiskType);
+        compare("storageAutoResize", obsSettings.storageAutoResize, desiredSettingsForCompare.storageAutoResize);
+        compare("storageAutoResizeLimit", obsSettings.storageAutoResizeLimit, desiredSettingsForCompare.storageAutoResizeLimit);
+        compare("ipConfiguration", obsSettings.ipConfiguration, desiredSettingsForCompare.ipConfiguration);
+        compare("backupConfiguration", obsSettings.backupConfiguration, desiredSettingsForCompare.backupConfiguration);
+        compare("databaseFlags", obsSettings.databaseFlags ?? [], desiredSettingsForCompare.databaseFlags ?? []);
+        compare("deletionProtectionEnabled", obsSettings.deletionProtectionEnabled, desiredSettingsForCompare.deletionProtectionEnabled);
+        compare("activationPolicy", obsSettings.activationPolicy, desiredSettingsForCompare.activationPolicy);
+        compare("availabilityType", obsSettings.availabilityType, desiredSettingsForCompare.availabilityType);
+        const labelDiff = diffTags({ ...(obsSettings.userLabels ?? {}) }, args.desiredLabels);
+        if (labelDiff.removed.length > 0 || labelDiff.upsert.length > 0) {
+            needPatch = true;
+            reasons.push("userLabels");
+        }
+        if (!needPatch)
+            return;
+        // Thread the observed settingsVersion through the patch body
+        // — Cloud SQL uses it as the optimistic-concurrency token
+        // (etag is deprecated on this resource).
+        const body = {
+            settings: toSettingsBody(args.news.settings, args.desiredLabels, obsSettings.settingsVersion),
+        };
+        const op = yield* patchInstances({
+            project: args.project,
+            instance: args.name,
+            body,
+        }).pipe(Effect.catchTag("BadRequest", reshapeBadRequest("Instance", "patch")));
+        if (op.name)
+            yield* awaitOperation(args.project, op.name, args.session);
+    });
+    return {
+        stables: ["name", "selfLink", "project", "region", "connectionName"],
+        diff: Effect.fn(function* ({ news, olds = {} }) {
+            if (!isResolved(news))
+                return undefined;
+            if (somePropsAreDifferent(olds, news, [
+                "project",
+                "region",
+                "name",
+                "databaseVersion",
+            ])) {
+                return { action: "replace" };
+            }
+            return undefined;
+        }),
+        reconcile: Effect.fn(function* ({ id, news, session }) {
+            const internalLabels = yield* gcpInternalLabels(id);
+            const desiredName = news.name ??
+                (yield* createPhysicalName({ id, maxLength: 98 })).toLowerCase();
+            yield* validateInstanceName(desiredName);
+            const desiredLabels = {
+                ...(news.labels ?? {}),
+                ...internalLabels,
+            };
+            // 1. Observe — collapse 403 to "missing" alongside 404.
+            let observed = yield* observe(news.project, desiredName);
+            // 2. Ensure — insert. Like Cloud Run / GKE, sqladmin can 403
+            //    with "Cloud SQL Admin API has not been used in project
+            //    ... If you enabled this API recently, wait …" for ~1–2
+            //    minutes after ApiEnable lands. Retry the insert on that
+            //    specific 403; other Forbidden cases propagate.
+            if (!observed) {
+                const op = yield* insertInstances({
+                    project: news.project,
+                    body: {
+                        name: desiredName,
+                        region: news.region,
+                        databaseVersion: news.databaseVersion,
+                        ...(news.rootPassword
+                            ? { rootPassword: Redacted.value(news.rootPassword) }
+                            : {}),
+                        settings: toSettingsBody(news.settings, desiredLabels),
+                    },
+                }).pipe(Effect.retry({
+                    while: (e) => e?._tag === "Forbidden" &&
+                        /enabled this API recently|has not been used/i.test(e.message ?? ""),
+                    schedule: Schedule.spaced(Duration.seconds(15)).pipe(Schedule.both(Schedule.recurs(20)), Schedule.tapOutput(() => session.note("Waiting for Cloud SQL Admin API enablement to propagate…"))),
+                }), Effect.catchTag("Conflict", () => Effect.succeed(undefined)), Effect.catchTag("BadRequest", reshapeBadRequest("Instance", "insert")));
+                if (op?.name)
+                    yield* awaitOperation(news.project, op.name, session);
+                observed = yield* getInstances({
+                    project: news.project,
+                    instance: desiredName,
+                });
+            }
+            // 3. Sync — single patch with the full settings body when any
+            //    field drifts. settingsVersion threaded through for OCC.
+            yield* syncMutable({
+                project: news.project,
+                name: desiredName,
+                observed,
+                news,
+                desiredLabels,
+                session,
+            });
+            const final = yield* getInstances({
+                project: news.project,
+                instance: desiredName,
+            });
+            return toAttributes(final, {
+                project: news.project,
+                region: news.region,
+                name: desiredName,
+            });
+        }),
+        delete: Effect.fn(function* ({ output, session }) {
+            yield* deleteInstances({
+                project: output.project,
+                instance: output.name,
+            }).pipe(Effect.flatMap((op) => op.name
+                ? awaitOperation(output.project, op.name, session)
+                : Effect.succeed(op)), Effect.catchTag("NotFound", () => Effect.void), Effect.catchTag("BadRequest", reshapeBadRequest("Instance", "delete")));
+        }),
+        read: Effect.fn(function* ({ id, output, olds }) {
+            const project = output?.project ?? olds?.project;
+            const region = output?.region ?? olds?.region;
+            if (!project || !region)
+                return undefined;
+            const name = output?.name ??
+                olds?.name ??
+                (yield* createPhysicalName({ id, maxLength: 98 })).toLowerCase();
+            const observed = yield* observe(project, name);
+            if (!observed)
+                return undefined;
+            const attrs = toAttributes(observed, { project, region, name });
+            return (yield* hasAlchemyLabels(id, observed.settings?.userLabels))
+                ? attrs
+                : Unowned(attrs);
+        }),
+    };
+}));
+//# sourceMappingURL=Instance.js.map

package/lib/Sqladmin/Instance.js.map

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

package/lib/Sqladmin/Operations.d.ts

@@ -0,0 +1,41 @@
+import { ConfigError } from "@distilled.cloud/gcp";
+import * as sql from "@distilled.cloud/gcp/sqladmin-v1";
+import type { ScopedPlanStatusSession } from "alchemy/Cli/Cli";
+import * as Effect from "effect/Effect";
+/**
+ * Resolved callable signature of `sql.getOperations`.
+ *
+ * `sql.getOperations` is itself an `Effect<callable, never, Credentials |
+ * HttpClient>`, so `Effect.Success` extracts the callable. Using a
+ * derived alias keeps the helper aligned with the SDK without us
+ * hand-writing the input/output/error union, which would drift if the
+ * patch set changes.
+ */
+type GetOperations = Effect.Success<typeof sql.getOperations>;
+/**
+ * Build the Cloud SQL Admin long-running-operation polling helper.
+ *
+ * Sqladmin `Operation`s carry `.status: "PENDING" | "RUNNING" | "DONE"`
+ * (NOT `.done: boolean` like Cloud Resource Manager / Cloud Run, and
+ * NOT `.status === "DONE"` against a different enum). Verified at
+ * `vendor/distilled/packages/gcp/src/services/sqladmin-v1.ts:606–612`.
+ *
+ * Unlike Cloud Run, Sqladmin operations are NOT fully-qualified path
+ * names — the API returns a bare operation id (e.g. `e9e88dca-...`),
+ * and `getOperations` takes `{ project, operation }`. Callers therefore
+ * pass the bare id alongside the parent project context.
+ *
+ * Schedule: exponential 1s → 1.5× growth, capped via the count cap of
+ * 60 retries → roughly a few minutes wall ceiling. Most Cloud SQL
+ * operations (CREATE_USER, CREATE_DATABASE, UPDATE settings) finish
+ * in 1–30 s; instance CREATE / patch involving a restart are the long
+ * pole at 4–10 min, so callers running those should be aware that
+ * recurs(60) may bottom out and surface as a retry budget exhaustion.
+ *
+ * @see https://cloud.google.com/sql/docs/postgres/admin-api/rest/v1/operations
+ */
+export declare const makeAwaitOperation: (getOperations: GetOperations) => (project: string, operationName: string, session: ScopedPlanStatusSession) => Effect.Effect<sql.Operation, ConfigError | sql.GetOperationsError | {
+    _tag: "OperationPending";
+}, never>;
+export {};
+//# sourceMappingURL=Operations.d.ts.map

package/lib/Sqladmin/Operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Operations.d.ts","sourceRoot":"","sources":["../../src/Sqladmin/Operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,GAAG,MAAM,kCAAkC,CAAC;AACxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE/D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC;;;;;;;;GAQG;AACH,KAAK,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,GAAG,CAAC,aAAa,CAAC,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,kBAAkB,GAAI,eAAe,aAAa;;SAgC3D,CAAC"}