puls-dev 0.2.0 → 0.2.2

package/dist/providers/gcp/cloudrun.test.js

@@ -0,0 +1,281 @@
+import { test, describe, beforeEach, afterEach, mock } from "node:test";
+import assert from "node:assert";
+import { GoogleAuth } from "google-auth-library";
+import { GCPCloudRunBuilder } from "./cloudrun.js";
+import { Config } from "../../core/config.js";
+describe("GCPCloudRunBuilder Unit Tests", () => {
+    let originalFetch;
+    let fetchCalls = [];
+    let mockResponses = {};
+    beforeEach(() => {
+        Config.set({
+            dryRun: false,
+            providers: {
+                gcp: {
+                    projectId: "my-gcp-project",
+                    serviceAccountPath: "/fake/sa.json",
+                    region: "us-east1",
+                },
+            },
+        });
+        originalFetch = globalThis.fetch;
+        fetchCalls = [];
+        mockResponses = {};
+        globalThis.fetch = async (input, init) => {
+            const url = String(input);
+            const method = init?.method ?? "GET";
+            let body;
+            if (init?.body) {
+                if (typeof init.body === "string") {
+                    try {
+                        body = JSON.parse(init.body);
+                    }
+                    catch {
+                        body = init.body;
+                    }
+                }
+                else {
+                    body = "[Binary/Buffer Body]";
+                }
+            }
+            const headers = init?.headers;
+            fetchCalls.push({ url, method, body, headers });
+            const matchKey = Object.keys(mockResponses)
+                .filter((key) => {
+                const [mMethod, mPath] = key.split(" ");
+                return method === mMethod && url.includes(mPath);
+            })
+                .sort((a, b) => b.split(" ")[1].length - a.split(" ")[1].length)[0];
+            if (matchKey) {
+                const resp = mockResponses[matchKey];
+                return {
+                    ok: resp.status >= 200 && resp.status < 300,
+                    status: resp.status,
+                    json: async () => resp.body,
+                    text: async () => JSON.stringify(resp.body),
+                };
+            }
+            return {
+                ok: false,
+                status: 404,
+                json: async () => ({ message: `Endpoint not mocked: ${method} ${url}` }),
+                text: async () => `Endpoint not mocked: ${method} ${url}`,
+            };
+        };
+        mock.method(GoogleAuth.prototype, "getClient", async () => {
+            return {
+                getAccessToken: async () => ({ token: "fake-gcp-token" }),
+            };
+        });
+    });
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+        mock.restoreAll();
+    });
+    test("fluent builder api sets properties correctly", () => {
+        const builder = new GCPCloudRunBuilder("my-service")
+            .image("gcr.io/my-proj/my-image:v1")
+            .port(3000)
+            .cpu(2)
+            .memory(1024)
+            .minInstances(2)
+            .maxInstances(20)
+            .env({ DB_HOST: "localhost", PORT: "3000" })
+            .region("europe-west1")
+            .public(false);
+        assert.strictEqual(builder._image, "gcr.io/my-proj/my-image:v1");
+        assert.strictEqual(builder._port, 3000);
+        assert.strictEqual(builder._cpu, 2);
+        assert.strictEqual(builder._memory, 1024);
+        assert.strictEqual(builder._minInstances, 2);
+        assert.strictEqual(builder._maxInstances, 20);
+        assert.deepStrictEqual(builder._env, { DB_HOST: "localhost", PORT: "3000" });
+        assert.strictEqual(builder._region, "europe-west1");
+        assert.strictEqual(builder._public, false);
+    });
+    test("runs in dry-run mode safely and logs plans", async () => {
+        Config.set({
+            dryRun: true,
+            providers: {
+                gcp: {
+                    projectId: "my-gcp-project",
+                    serviceAccountPath: "/fake/sa.json",
+                    region: "us-central1",
+                },
+            },
+        });
+        const builder = new GCPCloudRunBuilder("dry-run-service")
+            .image("gcr.io/my-proj/my-image:v1")
+            .minInstances(1)
+            .maxInstances(5);
+        const result = await builder.deploy();
+        assert.strictEqual(result.serviceId, "dry-run-service");
+        assert.strictEqual(result.url, "https://dry-run-service-dryrun.a.run.app");
+        const writeCalls = fetchCalls.filter((c) => c.method !== "GET");
+        assert.strictEqual(writeCalls.length, 0); // No write requests in dry-run
+    });
+    test("creates a new service when it does not exist", async () => {
+        // 1. Mock GET returning 404 (discovery)
+        mockResponses["GET /services/new-service"] = {
+            status: 404,
+            body: { message: "Not found" },
+        };
+        // 2. Mock POST (create)
+        mockResponses["POST /services?serviceId=new-service"] = {
+            status: 201,
+            body: {
+                name: "projects/my-gcp-project/locations/us-east1/services/new-service",
+                uri: "https://new-service-xyz.run.app",
+            },
+        };
+        // 3. Mock POST (setIamPolicy)
+        mockResponses["POST /services/new-service:setIamPolicy"] = {
+            status: 200,
+            body: {},
+        };
+        const builder = new GCPCloudRunBuilder("new-service")
+            .image("gcr.io/my-proj/my-image:v1")
+            .port(8080)
+            .cpu("1")
+            .memory("512Mi")
+            .minInstances(0)
+            .maxInstances(10)
+            .public(true);
+        const result = await builder.deploy();
+        assert.strictEqual(result.serviceId, "new-service");
+        assert.strictEqual(result.url, "https://new-service-xyz.run.app");
+        // Assert fetch calls occurred
+        const postCalls = fetchCalls.filter((c) => c.method === "POST" && c.url.includes("serviceId="));
+        assert.strictEqual(postCalls.length, 1);
+        assert.deepStrictEqual(postCalls[0].body.template.containers[0].image, "gcr.io/my-proj/my-image:v1");
+        const iamCalls = fetchCalls.filter((c) => c.method === "POST" && c.url.includes(":setIamPolicy"));
+        assert.strictEqual(iamCalls.length, 1);
+        assert.deepStrictEqual(iamCalls[0].body.policy.bindings[0].role, "roles/run.invoker");
+        assert.deepStrictEqual(iamCalls[0].body.policy.bindings[0].members, ["allUsers"]);
+    });
+    test("updates an existing service if configuration differs", async () => {
+        // 1. Mock GET returning existing service config with different image
+        mockResponses["GET /services/existing-service"] = {
+            status: 200,
+            body: {
+                name: "projects/my-gcp-project/locations/us-east1/services/existing-service",
+                uri: "https://existing-service-xyz.run.app",
+                template: {
+                    containers: [
+                        {
+                            image: "gcr.io/my-proj/old-image:v1",
+                            ports: [{ containerPort: 8080 }],
+                            resources: { limits: { cpu: "1", memory: "512Mi" } },
+                        },
+                    ],
+                    scaling: { minInstanceCount: 0, maxInstanceCount: 10 },
+                },
+                ingress: "INGRESS_TRAFFIC_ALL",
+            },
+        };
+        // 2. Mock PATCH (update)
+        mockResponses["PATCH /services/existing-service"] = {
+            status: 200,
+            body: {
+                name: "projects/my-gcp-project/locations/us-east1/services/existing-service",
+                uri: "https://existing-service-xyz.run.app",
+            },
+        };
+        // 3. Mock POST (setIamPolicy)
+        mockResponses["POST /services/existing-service:setIamPolicy"] = {
+            status: 200,
+            body: {},
+        };
+        const builder = new GCPCloudRunBuilder("existing-service")
+            .image("gcr.io/my-proj/new-image:v1") // Image changed!
+            .minInstances(0)
+            .maxInstances(10)
+            .public(true);
+        const result = await builder.deploy();
+        assert.strictEqual(result.serviceId, "existing-service");
+        assert.strictEqual(result.url, "https://existing-service-xyz.run.app");
+        // Verify PATCH was called
+        const patchCalls = fetchCalls.filter((c) => c.method === "PATCH");
+        assert.strictEqual(patchCalls.length, 1);
+        assert.deepStrictEqual(patchCalls[0].body.template.containers[0].image, "gcr.io/my-proj/new-image:v1");
+        const iamCalls = fetchCalls.filter((c) => c.method === "POST" && c.url.includes(":setIamPolicy"));
+        assert.strictEqual(iamCalls.length, 1);
+    });
+    test("skips updating an existing service if configuration is identical", async () => {
+        // 1. Mock GET returning exact same config
+        mockResponses["GET /services/identical-service"] = {
+            status: 200,
+            body: {
+                name: "projects/my-gcp-project/locations/us-east1/services/identical-service",
+                uri: "https://identical-service-xyz.run.app",
+                template: {
+                    containers: [
+                        {
+                            image: "gcr.io/my-proj/image:v1",
+                            ports: [{ containerPort: 8080 }],
+                            resources: { limits: { cpu: "1", memory: "512Mi" } },
+                            env: [{ name: "NODE_ENV", value: "production" }],
+                        },
+                    ],
+                    scaling: { minInstanceCount: 0, maxInstanceCount: 10 },
+                },
+                ingress: "INGRESS_TRAFFIC_ALL",
+            },
+        };
+        // 2. Mock POST (setIamPolicy)
+        mockResponses["POST /services/identical-service:setIamPolicy"] = {
+            status: 200,
+            body: {},
+        };
+        const builder = new GCPCloudRunBuilder("identical-service")
+            .image("gcr.io/my-proj/image:v1")
+            .port(8080)
+            .cpu("1")
+            .memory("512Mi")
+            .minInstances(0)
+            .maxInstances(10)
+            .env({ NODE_ENV: "production" })
+            .public(true);
+        const result = await builder.deploy();
+        assert.strictEqual(result.serviceId, "identical-service");
+        assert.strictEqual(result.url, "https://identical-service-xyz.run.app");
+        // Verify PATCH or POST for services was NOT called
+        const writeCalls = fetchCalls.filter((c) => (c.method === "PATCH" || (c.method === "POST" && c.url.includes("serviceId="))));
+        assert.strictEqual(writeCalls.length, 0);
+        // Verify setIamPolicy was still called
+        const iamCalls = fetchCalls.filter((c) => c.method === "POST" && c.url.includes(":setIamPolicy"));
+        assert.strictEqual(iamCalls.length, 1);
+    });
+    test("destroys an existing service", async () => {
+        // 1. Mock GET returning existing service config (discovery on destroy)
+        mockResponses["GET /services/to-delete"] = {
+            status: 200,
+            body: { name: "projects/my-gcp-project/locations/us-east1/services/to-delete" },
+        };
+        // 2. Mock DELETE
+        mockResponses["DELETE /services/to-delete"] = {
+            status: 200,
+            body: {},
+        };
+        const builder = new GCPCloudRunBuilder("to-delete");
+        const result = await builder.destroy();
+        assert.deepStrictEqual(result, { destroyed: "to-delete" });
+        // Verify DELETE was called
+        const deleteCalls = fetchCalls.filter((c) => c.method === "DELETE");
+        assert.strictEqual(deleteCalls.length, 1);
+        assert.strictEqual(deleteCalls[0].url.includes("/services/to-delete"), true);
+    });
+    test("destroy does nothing when service does not exist", async () => {
+        // 1. Mock GET returning 404
+        mockResponses["GET /services/not-exist"] = {
+            status: 404,
+            body: { message: "Not found" },
+        };
+        const builder = new GCPCloudRunBuilder("not-exist");
+        const result = await builder.destroy();
+        assert.deepStrictEqual(result, { destroyed: "not-exist" });
+        // Verify DELETE was NOT called
+        const deleteCalls = fetchCalls.filter((c) => c.method === "DELETE");
+        assert.strictEqual(deleteCalls.length, 0);
+    });
+});

package/dist/providers/gcp/cloudsql.d.ts

@@ -0,0 +1,37 @@
+import { BaseBuilder } from "../../core/resource.js";
+export declare class GCPCloudSQLBuilder extends BaseBuilder {
+    private _engine;
+    private _engineVersion;
+    private _tier;
+    private _storage;
+    private _username?;
+    private _password?;
+    private _dbName?;
+    private _publicAccess;
+    private _region?;
+    resolvedEndpoint: string | null;
+    resolvedPort: number | null;
+    resolvedConnectionName: string | null;
+    constructor(instanceId: string);
+    engine(e: {
+        engine: "postgres" | "mysql";
+        version: string;
+    }): this;
+    size(tier: string): this;
+    storage(gb: number): this;
+    credentials(username: string, password: string): this;
+    database(name: string): this;
+    publicAccess(enabled?: boolean): this;
+    region(reg: string): this;
+    private discoverInstance;
+    private waitForOperation;
+    deploy(): Promise<{
+        name: string;
+        endpoint: string | null;
+        port: number;
+        connectionName: string | null;
+    }>;
+    destroy(): Promise<{
+        destroyed: string;
+    }>;
+}

package/dist/providers/gcp/cloudsql.js

@@ -0,0 +1,262 @@
+import { BaseBuilder } from "../../core/resource.js";
+import { gcpFetch, getProjectId, getRegion } from "./api.js";
+const SQL_BASE = "https://sqladmin.googleapis.com";
+const DB_PORT = {
+    postgres: 5432,
+    postgresql: 5432,
+    mysql: 3306,
+};
+function formatDatabaseVersion(engine, version) {
+    const eng = engine.toLowerCase();
+    if (eng === "postgres" || eng === "postgresql") {
+        return `POSTGRES_${version.split(".")[0]}`;
+    }
+    if (eng === "mysql") {
+        return `MYSQL_${version.replace(/\./g, "_")}`;
+    }
+    return `${engine.toUpperCase()}_${version}`;
+}
+export class GCPCloudSQLBuilder extends BaseBuilder {
+    _engine = "postgres";
+    _engineVersion = "16";
+    _tier = "db-f1-micro";
+    _storage = 10;
+    _username;
+    _password;
+    _dbName;
+    _publicAccess = false;
+    _region;
+    resolvedEndpoint = null;
+    resolvedPort = null;
+    resolvedConnectionName = null;
+    constructor(instanceId) {
+        super(instanceId);
+        this.discoveryPromise = this.discoverInstance();
+    }
+    engine(e) {
+        this._engine = e.engine;
+        this._engineVersion = e.version;
+        return this;
+    }
+    size(tier) {
+        this._tier = tier;
+        return this;
+    }
+    storage(gb) {
+        this._storage = gb;
+        return this;
+    }
+    credentials(username, password) {
+        this._username = username;
+        this._password = password;
+        return this;
+    }
+    database(name) {
+        this._dbName = name;
+        return this;
+    }
+    publicAccess(enabled = true) {
+        this._publicAccess = enabled;
+        return this;
+    }
+    region(reg) {
+        this._region = reg;
+        this.discoveryPromise = this.discoverInstance();
+        return this;
+    }
+    async discoverInstance() {
+        try {
+            const project = getProjectId();
+            const instanceId = this.name;
+            const res = await gcpFetch(SQL_BASE, `/v1/projects/${project}/instances/${instanceId}`);
+            if (res.state === "DELETED")
+                return null;
+            const primaryIp = res.ipAddresses?.find((ip) => ip.type === "PRIMARY")?.ipAddress;
+            this.resolvedEndpoint = primaryIp ?? null;
+            this.resolvedPort = DB_PORT[this._engine] ?? 5432;
+            this.resolvedConnectionName = res.connectionName ?? null;
+            return res;
+        }
+        catch (e) {
+            if (e.message?.includes("404") ||
+                e.message?.includes("403") ||
+                e.message?.includes("credentials not configured")) {
+                return null;
+            }
+            throw e;
+        }
+    }
+    async waitForOperation(opName, label) {
+        const project = getProjectId();
+        await this.waitFor(label, async () => {
+            const op = await gcpFetch(SQL_BASE, `/v1/projects/${project}/operations/${opName}`);
+            if (op.status === "DONE") {
+                if (op.error) {
+                    throw new Error(`Cloud SQL Operation failed: ${JSON.stringify(op.error)}`);
+                }
+                return true;
+            }
+            return false;
+        }, { intervalMs: 10_000, timeoutMs: 900_000 });
+    }
+    async deploy() {
+        const dryRun = this.isDryRunActive();
+        const project = getProjectId();
+        const location = this._region ?? getRegion();
+        const instanceId = this.name;
+        const port = DB_PORT[this._engine] ?? 5432;
+        console.log(`\n⚡ Finalizing GCP Cloud SQL Instance "${instanceId}"...`);
+        if (!this._username || !this._password) {
+            throw new Error(`[GCP.CloudSQL:${instanceId}] .credentials(username, password) is required`);
+        }
+        const existing = await this.discoveryPromise;
+        const targetDbVersion = formatDatabaseVersion(this._engine, this._engineVersion);
+        const targetAuthorizedNetworks = this._publicAccess
+            ? [{ value: "0.0.0.0/0", name: "internet" }]
+            : [];
+        if (dryRun) {
+            console.log(`   📝 [PLAN] ${existing ? "Update" : "Create"} Cloud SQL instance "${instanceId}" in ${location}`);
+            console.log(`      └─ Engine: ${this._engine} (${targetDbVersion})`);
+            console.log(`      └─ Tier: ${this._tier} | Disk: ${this._storage}GB`);
+            console.log(`      └─ Public Access: ${this._publicAccess ? "enabled" : "disabled"}`);
+            if (this._dbName) {
+                console.log(`      └─ Database to create: "${this._dbName}"`);
+            }
+            if (this._username && this._username !== "postgres" && this._username !== "root") {
+                console.log(`      └─ Custom user to create: "${this._username}"`);
+            }
+            this.resolvedEndpoint = "127.0.0.1";
+            this.resolvedPort = port;
+            this.resolvedConnectionName = `${project}:${location}:${instanceId}`;
+            return {
+                name: instanceId,
+                endpoint: this.resolvedEndpoint,
+                port: this.resolvedPort,
+                connectionName: this.resolvedConnectionName,
+            };
+        }
+        let needsUpdate = !existing;
+        if (existing) {
+            const existingSettings = existing.settings ?? {};
+            const existingNetworks = existingSettings.ipConfiguration?.authorizedNetworks ?? [];
+            const hasTierChange = existingSettings.tier !== this._tier;
+            const hasStorageChange = Number(existingSettings.dataDiskSizeGb ?? 0) < this._storage;
+            const hasNetworkChange = JSON.stringify(existingNetworks) !== JSON.stringify(targetAuthorizedNetworks);
+            needsUpdate = hasTierChange || hasStorageChange || hasNetworkChange;
+        }
+        const settings = {
+            tier: this._tier,
+            dataDiskSizeGb: String(this._storage),
+            ipConfiguration: {
+                ipv4Enabled: true,
+                authorizedNetworks: targetAuthorizedNetworks,
+            },
+        };
+        let currentInstance;
+        if (!existing) {
+            console.log(`🚀 Creating GCP Cloud SQL instance "${instanceId}" (takes several minutes)...`);
+            const op = await gcpFetch(SQL_BASE, `/v1/projects/${project}/instances`, {
+                method: "POST",
+                body: JSON.stringify({
+                    name: instanceId,
+                    databaseVersion: targetDbVersion,
+                    region: location,
+                    rootPassword: this._password,
+                    settings,
+                }),
+            });
+            await this.waitForOperation(op.name, `Instance creation "${instanceId}"`);
+            currentInstance = await gcpFetch(SQL_BASE, `/v1/projects/${project}/instances/${instanceId}`);
+        }
+        else if (needsUpdate) {
+            console.log(`🔄 Updating GCP Cloud SQL instance "${instanceId}"...`);
+            const op = await gcpFetch(SQL_BASE, `/v1/projects/${project}/instances/${instanceId}`, {
+                method: "PATCH",
+                body: JSON.stringify({ settings }),
+            });
+            await this.waitForOperation(op.name, `Instance update "${instanceId}"`);
+            currentInstance = await gcpFetch(SQL_BASE, `/v1/projects/${project}/instances/${instanceId}`);
+        }
+        else {
+            console.log(`✅ GCP Cloud SQL instance "${instanceId}" is up to date.`);
+            currentInstance = existing;
+        }
+        const primaryIp = currentInstance.ipAddresses?.find((ip) => ip.type === "PRIMARY")?.ipAddress;
+        this.resolvedEndpoint = primaryIp ?? null;
+        this.resolvedPort = port;
+        this.resolvedConnectionName = currentInstance.connectionName ?? null;
+        if (this._dbName) {
+            console.log(`   🗄️  Ensuring database "${this._dbName}" exists...`);
+            try {
+                await gcpFetch(SQL_BASE, `/v1/projects/${project}/instances/${instanceId}/databases`, {
+                    method: "POST",
+                    body: JSON.stringify({
+                        name: this._dbName,
+                        instance: instanceId,
+                        project,
+                    }),
+                });
+                console.log(`   ✅ Database "${this._dbName}" created.`);
+            }
+            catch (e) {
+                if (!e.message?.includes("409")) {
+                    throw e;
+                }
+                console.log(`   ✅ Database "${this._dbName}" already exists.`);
+            }
+        }
+        const defaultAdmin = this._engine === "postgres" ? "postgres" : "root";
+        if (this._username && this._username !== defaultAdmin) {
+            console.log(`   👤 Ensuring custom user "${this._username}" exists...`);
+            try {
+                await gcpFetch(SQL_BASE, `/v1/projects/${project}/instances/${instanceId}/users`, {
+                    method: "POST",
+                    body: JSON.stringify({
+                        name: this._username,
+                        password: this._password,
+                        instance: instanceId,
+                        project,
+                    }),
+                });
+                console.log(`   ✅ Custom user "${this._username}" created.`);
+            }
+            catch (e) {
+                if (!e.message?.includes("409")) {
+                    throw e;
+                }
+                console.log(`   ✅ Custom user "${this._username}" already exists.`);
+            }
+        }
+        await this.deploySidecars();
+        console.log(`🚀 Database available → ${this.resolvedEndpoint}:${this.resolvedPort}`);
+        return {
+            name: instanceId,
+            endpoint: this.resolvedEndpoint,
+            port: this.resolvedPort,
+            connectionName: this.resolvedConnectionName,
+        };
+    }
+    async destroy() {
+        const dryRun = this.isDryRunActive();
+        const project = getProjectId();
+        const instanceId = this.name;
+        console.log(`\n🗑️  Destroying GCP Cloud SQL Instance "${instanceId}"...`);
+        const existing = await this.discoverInstance();
+        if (!existing) {
+            console.log(`   ✅ Instance "${instanceId}" does not exist - nothing to do.`);
+            return { destroyed: instanceId };
+        }
+        if (dryRun) {
+            console.log(`   📝 [PLAN] Delete Cloud SQL instance "${instanceId}"`);
+            return { destroyed: instanceId };
+        }
+        console.log(`   🔄 Deleting Cloud SQL instance "${instanceId}"...`);
+        const op = await gcpFetch(SQL_BASE, `/v1/projects/${project}/instances/${instanceId}`, {
+            method: "DELETE",
+        });
+        await this.waitForOperation(op.name, `Instance deletion "${instanceId}"`);
+        console.log(`   ✅ Instance "${instanceId}" deleted.`);
+        await this.destroySidecars();
+        return { destroyed: instanceId };
+    }
+}

package/dist/providers/gcp/cloudsql.test.d.ts

@@ -0,0 +1 @@
+export {};