puls-dev 0.1.0 → 0.1.8

package/dist/providers/firebase/storage.js

@@ -1,8 +1,8 @@
-import { readFileSync } from 'node:fs';
-import { BaseBuilder } from '../../core/resource.js';
-import { cloudFetch, getProjectId } from './api.js';
-const RULES_BASE = 'https://firebaserules.googleapis.com/v1';
-const GCS_BASE = 'https://storage.googleapis.com/storage/v1';
+import { readFileSync } from "node:fs";
+import { BaseBuilder } from "../../core/resource.js";
+import { cloudFetch, getProjectId } from "./api.js";
+const RULES_BASE = "https://firebaserules.googleapis.com/v1";
+const GCS_BASE = "https://storage.googleapis.com/storage/v1";
 export class FirebaseStorageBuilder extends BaseBuilder {
     _rulesPath;
     _cors = [];
@@ -10,13 +10,22 @@ export class FirebaseStorageBuilder extends BaseBuilder {
     _resolvedBucket;
     constructor(bucket) {
         // Bucket name resolved lazily in deploy() if not provided (needs projectId)
-        super(bucket ?? '__default__');
+        super(bucket ?? "__default__");
         this._resolvedBucket = bucket;
         this.discoveryPromise = Promise.resolve(null);
     }
-    rules(filePath) { this._rulesPath = filePath; return this; }
-    cors(rules) { this._cors = rules; return this; }
-    lifecycle(rule) { this._lifecycle = rule; return this; }
+    rules(filePath) {
+        this._rulesPath = filePath;
+        return this;
+    }
+    cors(rules) {
+        this._cors = rules;
+        return this;
+    }
+    lifecycle(rule) {
+        this._lifecycle = rule;
+        return this;
+    }
     bucket() {
         return this._resolvedBucket ?? `${getProjectId()}.appspot.com`;
     }
@@ -27,26 +36,31 @@ export class FirebaseStorageBuilder extends BaseBuilder {
     async deployRules(dryRun) {
         if (!this._rulesPath)
             return;
-        const source = readFileSync(this._rulesPath, 'utf8');
+        const source = readFileSync(this._rulesPath, "utf8");
         if (dryRun) {
             console.log(`   📝 [PLAN] Deploy Storage rules from "${this._rulesPath}" → ${this.bucket()}`);
             return;
         }
         const ruleset = await cloudFetch(RULES_BASE, `/projects/${getProjectId()}/rulesets`, {
-            method: 'POST',
-            body: JSON.stringify({ source: { files: [{ name: 'storage.rules', content: source }] } }),
+            method: "POST",
+            body: JSON.stringify({
+                source: { files: [{ name: "storage.rules", content: source }] },
+            }),
         });
         await cloudFetch(RULES_BASE, `/${this.releaseName()}`, {
-            method: 'PUT',
-            body: JSON.stringify({ name: this.releaseName(), rulesetName: ruleset.name }),
+            method: "PUT",
+            body: JSON.stringify({
+                name: this.releaseName(),
+                rulesetName: ruleset.name,
+            }),
         });
-        console.log(`   ✅ Storage rules deployed (ruleset: ${ruleset.name.split('/').pop()})`);
+        console.log(`   ✅ Storage rules deployed (ruleset: ${ruleset.name.split("/").pop()})`);
     }
     // ── CORS ──────────────────────────────────────────────────────────────────
     async deployCors(dryRun) {
         if (this._cors.length === 0)
             return;
-        const corsBody = this._cors.map(r => ({
+        const corsBody = this._cors.map((r) => ({
             origin: r.origin,
             method: r.method,
             responseHeader: r.responseHeader ?? [],
@@ -55,12 +69,12 @@ export class FirebaseStorageBuilder extends BaseBuilder {
         if (dryRun) {
             console.log(`   📝 [PLAN] Set CORS on bucket "${this.bucket()}" (${this._cors.length} rule(s))`);
             for (const r of this._cors) {
-                console.log(`      └─ origins: [${r.origin.join(', ')}], methods: [${r.method.join(', ')}]`);
+                console.log(`      └─ origins: [${r.origin.join(", ")}], methods: [${r.method.join(", ")}]`);
             }
             return;
         }
         await cloudFetch(GCS_BASE, `/b/${this.bucket()}`, {
-            method: 'PATCH',
+            method: "PATCH",
             body: JSON.stringify({ cors: corsBody }),
         });
         console.log(`   ✅ CORS configured on "${this.bucket()}"`);
@@ -70,7 +84,7 @@ export class FirebaseStorageBuilder extends BaseBuilder {
         if (!this._lifecycle)
             return;
         const rule = {
-            action: { type: 'Delete' },
+            action: { type: "Delete" },
             condition: {},
         };
         if (this._lifecycle.deleteAfterDays !== undefined)
@@ -82,12 +96,12 @@ export class FirebaseStorageBuilder extends BaseBuilder {
             if (this._lifecycle.deleteAfterDays)
                 parts.push(`delete after ${this._lifecycle.deleteAfterDays} days`);
             if (this._lifecycle.matchesPrefix)
-                parts.push(`prefix: [${this._lifecycle.matchesPrefix.join(', ')}]`);
-            console.log(`   📝 [PLAN] Set lifecycle on "${this.bucket()}": ${parts.join(', ')}`);
+                parts.push(`prefix: [${this._lifecycle.matchesPrefix.join(", ")}]`);
+            console.log(`   📝 [PLAN] Set lifecycle on "${this.bucket()}": ${parts.join(", ")}`);
             return;
         }
         await cloudFetch(GCS_BASE, `/b/${this.bucket()}`, {
-            method: 'PATCH',
+            method: "PATCH",
             body: JSON.stringify({ lifecycle: { rule: [rule] } }),
         });
         console.log(`   ✅ Lifecycle configured on "${this.bucket()}"`);
@@ -107,10 +121,10 @@ export class FirebaseStorageBuilder extends BaseBuilder {
         const dryRun = this.isDryRunActive();
         console.log(`\n🗑️  Destroying Firebase Storage config "${this.bucket()}"...`);
         if (dryRun) {
-            console.log(`   ℹ️  Storage buckets cannot be deleted via API — remove manually in the GCP console`);
+            console.log(`   ℹ️  Storage buckets cannot be deleted via API - remove manually in the GCP console`);
         }
         else {
-            console.log(`   ℹ️  Storage buckets cannot be deleted via API — remove manually in the GCP console`);
+            console.log(`   ℹ️  Storage buckets cannot be deleted via API - remove manually in the GCP console`);
         }
         return { destroyed: this.bucket() };
     }

package/dist/providers/proxmox/vm.d.ts

@@ -24,7 +24,7 @@ export declare class VMBuilder extends BaseBuilder {
     image(os: OSImage): this;
     cores(n: number): this;
     memory(mb: number): this;
-    provision(playbookPath: string): this;
+    provision(playbookPath: string | string[]): this;
     replace(oldVmName: string): this;
     node(n: string): this;
     storage(pool: string): this;

package/dist/providers/proxmox/vm.js

@@ -106,15 +106,19 @@ export class VMBuilder extends BaseBuilder {
             console.log(`      └─ Cores: ${this._cores}  Memory: ${this._memory} MB`);
             if (this._vlan)
                 console.log(`      └─ VLAN: ${this._vlan}`);
-            if (this._provision)
-                console.log(`      └─ Provision: ${this._provision}`);
+            if (this._provision) {
+                const p = Array.isArray(this._provision)
+                    ? this._provision.join(", ")
+                    : this._provision;
+                console.log(`      └─ Provision: ${p}`);
+            }
             if (this._replace)
                 console.log(`      └─ Replace: "${this._replace}" after creation`);
             this.out.vmid.resolve(-1);
             this.out.ip.resolve(this._ip?.split("/")[0] ?? "0.0.0.0");
             return { name: this.name, vmid: "PENDING" };
         }
-        // Find the template — match by VMID (numeric string) or name substring
+        // Find the template - match by VMID (numeric string) or name substring
         const resources = await pm.get("/cluster/resources?type=vm");
         const isVmid = this._image && /^\d+$/.test(this._image);
         const template = this._image
@@ -152,7 +156,7 @@ export class VMBuilder extends BaseBuilder {
                 storage,
                 format: "raw",
             });
-            // Clone is async — wait for the Proxmox task to finish before configuring
+            // Clone is async - wait for the Proxmox task to finish before configuring
             await this.waitForTask(node, taskId, pm);
         }
         else {
@@ -180,11 +184,11 @@ export class VMBuilder extends BaseBuilder {
                     console.log(`   🔍 DNS: ${this.name}.${domain} → ${addr}`);
                 }
                 catch {
-                    // Not in DNS — will fall through to DHCP
+                    // Not in DNS - will fall through to DHCP
                 }
             }
         }
-        // Build net0 string — VirtIO on vmbr1, optional VLAN tag
+        // Build net0 string - VirtIO on vmbr1, optional VLAN tag
         const net0 = `virtio,bridge=vmbr1${this._vlan ? `,tag=${this._vlan}` : ""}`;
         const configPatch = {
             onboot: 1,
@@ -240,7 +244,12 @@ export class VMBuilder extends BaseBuilder {
         if (this._provision) {
             await this.waitFor(`SSH on ${this.resolvedIp} to be ready`, () => this.checkPort(this.resolvedIp, 22), { intervalMs: 10_000, timeoutMs: 300_000 });
             await this.waitFor(`cloud-init to finish on ${this.resolvedIp}`, () => this.checkCloudInit(this.resolvedIp), { intervalMs: 15_000, timeoutMs: 300_000 });
-            await this.runProvisioner(this.resolvedIp, this._provision);
+            const scripts = Array.isArray(this._provision)
+                ? this._provision
+                : [this._provision];
+            for (const script of scripts) {
+                await this.runProvisioner(this.resolvedIp, script);
+            }
         }
         if (this._replace) {
             await this.destroyVmByName(this._replace, pm);
@@ -280,7 +289,7 @@ export class VMBuilder extends BaseBuilder {
         const resources = await pm.get("/cluster/resources?type=vm");
         const vm = (resources ?? []).find((r) => r.name === name && !r.template);
         if (!vm) {
-            console.log(`   ℹ️  VM "${name}" not found — already gone`);
+            console.log(`   ℹ️  VM "${name}" not found - already gone`);
             return;
         }
         if (vm.status === "running") {
@@ -325,27 +334,37 @@ export class VMBuilder extends BaseBuilder {
     }
     checkCloudInit(ip) {
         const keyPath = this.sshKeyPath();
-        return new Promise(resolve => {
-            const proc = spawn('ssh', [
-                '-i', keyPath,
-                '-o', 'StrictHostKeyChecking=no',
-                '-o', 'ConnectTimeout=10',
-                '-o', 'BatchMode=yes',
+        return new Promise((resolve) => {
+            const proc = spawn("ssh", [
+                "-i",
+                keyPath,
+                "-o",
+                "StrictHostKeyChecking=no",
+                "-o",
+                "ConnectTimeout=10",
+                "-o",
+                "BatchMode=yes",
                 `root@${ip}`,
-                'cloud-init status',
-            ], { stdio: ['ignore', 'pipe', 'ignore'] });
-            let out = '';
-            proc.stdout.on('data', (d) => out += d.toString());
-            proc.on('close', () => resolve(out.includes('done') || out.includes('error')));
-            proc.on('error', () => resolve(false));
+                "cloud-init status",
+            ], { stdio: ["ignore", "pipe", "ignore"] });
+            let out = "";
+            proc.stdout.on("data", (d) => (out += d.toString()));
+            proc.on("close", () => resolve(out.includes("done") || out.includes("error")));
+            proc.on("error", () => resolve(false));
         });
     }
     checkPort(ip, port) {
-        return new Promise(resolve => {
+        return new Promise((resolve) => {
             const socket = createConnection({ host: ip, port, timeout: 3_000 });
-            socket.on('connect', () => { socket.destroy(); resolve(true); });
-            socket.on('timeout', () => { socket.destroy(); resolve(false); });
-            socket.on('error', () => resolve(false));
+            socket.on("connect", () => {
+                socket.destroy();
+                resolve(true);
+            });
+            socket.on("timeout", () => {
+                socket.destroy();
+                resolve(false);
+            });
+            socket.on("error", () => resolve(false));
         });
     }
     sshKeyPath() {

package/dist/types/aws.js

@@ -1,4 +1,4 @@
-// Define your secret IDs here — reference them everywhere instead of raw strings.
+// Define your secret IDs here - reference them everywhere instead of raw strings.
 // Example:
 // export const SECRETS = {
 //   API_KEY:     "myapp/api-key",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "puls-dev",
-  "version": "0.1.0",
+  "version": "0.1.8",
   "description": "Intent-driven infrastructure-as-code with eager discovery and no state files.",
   "type": "module",
   "main": "./dist/index.js",
@@ -14,7 +14,7 @@
   "scripts": {
     "build": "tsc",
     "prepublishOnly": "npm run build",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "tsx --test src/**/*.test.ts"
   },
   "keywords": [
     "iac",
@@ -50,6 +50,7 @@
     "@aws-sdk/client-sqs": "^3.1045.0",
     "dotenv": "^17.4.2",
     "google-auth-library": "^10.6.2",
+    "mkdocs": "^0.0.1",
     "reflect-metadata": "^0.2.2",
     "undici": "^8.2.0"
   }