puls-dev 0.1.0 → 0.1.8

package/dist/providers/aws/fargate.js

@@ -1,14 +1,20 @@
-import { DescribeClustersCommand, CreateClusterCommand, DescribeServicesCommand, CreateServiceCommand, UpdateServiceCommand, DeleteServiceCommand, RegisterTaskDefinitionCommand, NetworkMode, LaunchType, SchedulingStrategy, } from '@aws-sdk/client-ecs';
-import { DescribeVpcsCommand, DescribeSubnetsCommand, DescribeSecurityGroupsCommand, CreateSecurityGroupCommand, AuthorizeSecurityGroupIngressCommand, } from '@aws-sdk/client-ec2';
-import { GetRoleCommand, CreateRoleCommand, AttachRolePolicyCommand, } from '@aws-sdk/client-iam';
-import { DescribeLogGroupsCommand, CreateLogGroupCommand, } from '@aws-sdk/client-cloudwatch-logs';
-import { BaseBuilder } from '../../core/resource.js';
-import { getECSClient, getEC2Client, getIAMClient, getCWLogsClient } from './api.js';
-import { resolveEnvVars } from './secrets.js';
-import { Config } from '../../core/config.js';
+import { DescribeClustersCommand, CreateClusterCommand, DescribeServicesCommand, CreateServiceCommand, UpdateServiceCommand, DeleteServiceCommand, RegisterTaskDefinitionCommand, NetworkMode, LaunchType, SchedulingStrategy, } from "@aws-sdk/client-ecs";
+import { DescribeVpcsCommand, DescribeSubnetsCommand, DescribeSecurityGroupsCommand, CreateSecurityGroupCommand, AuthorizeSecurityGroupIngressCommand, } from "@aws-sdk/client-ec2";
+import { GetRoleCommand, CreateRoleCommand, AttachRolePolicyCommand, } from "@aws-sdk/client-iam";
+import { DescribeLogGroupsCommand, CreateLogGroupCommand, } from "@aws-sdk/client-cloudwatch-logs";
+import { BaseBuilder } from "../../core/resource.js";
+import { getECSClient, getEC2Client, getIAMClient, getCWLogsClient, } from "./api.js";
+import { resolveEnvVars } from "./secrets.js";
+import { Config } from "../../core/config.js";
 const ECS_ASSUME_ROLE_POLICY = JSON.stringify({
-    Version: '2012-10-17',
-    Statement: [{ Effect: 'Allow', Principal: { Service: 'ecs-tasks.amazonaws.com' }, Action: 'sts:AssumeRole' }],
+    Version: "2012-10-17",
+    Statement: [
+        {
+            Effect: "Allow",
+            Principal: { Service: "ecs-tasks.amazonaws.com" },
+            Action: "sts:AssumeRole",
+        },
+    ],
 });
 export class FargateBuilder extends BaseBuilder {
     _image;
@@ -17,7 +23,7 @@ export class FargateBuilder extends BaseBuilder {
     _port;
     _replicas = 1;
     _env = {};
-    _clusterName = 'puls';
+    _clusterName = "puls";
     _subnetIds;
     _securityGroupIds;
     resolvedArn = null;
@@ -25,33 +31,61 @@ export class FargateBuilder extends BaseBuilder {
         super(name);
         this.discoveryPromise = this.discoverService(name);
     }
-    image(img) { this._image = img; return this; }
-    cpu(units) { this._cpu = units; return this; }
-    memory(mb) { this._memory = mb; return this; }
-    port(p) { this._port = p; return this; }
-    replicas(n) { this._replicas = n; return this; }
-    cluster(name) { this._clusterName = name; return this; }
-    subnets(ids) { this._subnetIds = ids; return this; }
-    securityGroups(ids) { this._securityGroupIds = ids; return this; }
-    env(vars) { this._env = { ...this._env, ...vars }; return this; }
+    image(img) {
+        this._image = img;
+        return this;
+    }
+    cpu(units) {
+        this._cpu = units;
+        return this;
+    }
+    memory(mb) {
+        this._memory = mb;
+        return this;
+    }
+    port(p) {
+        this._port = p;
+        return this;
+    }
+    replicas(n) {
+        this._replicas = n;
+        return this;
+    }
+    cluster(name) {
+        this._clusterName = name;
+        return this;
+    }
+    subnets(ids) {
+        this._subnetIds = ids;
+        return this;
+    }
+    securityGroups(ids) {
+        this._securityGroupIds = ids;
+        return this;
+    }
+    env(vars) {
+        this._env = { ...this._env, ...vars };
+        return this;
+    }
     async discoverService(name) {
         try {
             const ecs = getECSClient();
             const clusterDesc = await ecs.send(new DescribeClustersCommand({ clusters: [this._clusterName] }));
-            const cluster = clusterDesc.clusters?.find(c => c.status === 'ACTIVE');
+            const cluster = clusterDesc.clusters?.find((c) => c.status === "ACTIVE");
             if (!cluster)
                 return null;
             const result = await ecs.send(new DescribeServicesCommand({
                 cluster: this._clusterName,
                 services: [name],
             }));
-            const svc = result.services?.find(s => s.status !== 'INACTIVE');
+            const svc = result.services?.find((s) => s.status !== "INACTIVE");
             if (svc)
                 this.resolvedArn = svc.serviceArn ?? null;
             return svc ?? null;
         }
         catch (e) {
-            if (e.name === 'ClusterNotFoundException' || e.name === 'CredentialsProviderError')
+            if (e.name === "ClusterNotFoundException" ||
+                e.name === "CredentialsProviderError")
                 return null;
             throw e;
         }
@@ -59,7 +93,7 @@ export class FargateBuilder extends BaseBuilder {
     async ensureCluster() {
         const ecs = getECSClient();
         const desc = await ecs.send(new DescribeClustersCommand({ clusters: [this._clusterName] }));
-        const existing = desc.clusters?.find(c => c.status === 'ACTIVE');
+        const existing = desc.clusters?.find((c) => c.status === "ACTIVE");
         if (existing)
             return existing.clusterArn;
         const created = await ecs.send(new CreateClusterCommand({ clusterName: this._clusterName }));
@@ -74,7 +108,7 @@ export class FargateBuilder extends BaseBuilder {
             return existing.Role.Arn;
         }
         catch (e) {
-            if (e.name !== 'NoSuchEntityException')
+            if (e.name !== "NoSuchEntityException")
                 throw e;
         }
         const created = await iam.send(new CreateRoleCommand({
@@ -84,7 +118,7 @@ export class FargateBuilder extends BaseBuilder {
         }));
         await iam.send(new AttachRolePolicyCommand({
             RoleName: roleName,
-            PolicyArn: 'arn:aws:iam::aws:policy/service-role/AmazonECSTaskExecutionRolePolicy',
+            PolicyArn: "arn:aws:iam::aws:policy/service-role/AmazonECSTaskExecutionRolePolicy",
         }));
         console.log(`   ✅ Created execution role: ${roleName}`);
         return created.Role.Arn;
@@ -93,7 +127,7 @@ export class FargateBuilder extends BaseBuilder {
         const logGroupName = `/puls/${this.name}`;
         const cw = getCWLogsClient();
         const existing = await cw.send(new DescribeLogGroupsCommand({ logGroupNamePrefix: logGroupName }));
-        if (existing.logGroups?.some(g => g.logGroupName === logGroupName))
+        if (existing.logGroups?.some((g) => g.logGroupName === logGroupName))
             return logGroupName;
         await cw.send(new CreateLogGroupCommand({ logGroupName }));
         console.log(`   ✅ Created log group: ${logGroupName}`);
@@ -102,15 +136,17 @@ export class FargateBuilder extends BaseBuilder {
     async discoverDefaultVpc() {
         const ec2 = getEC2Client();
         const vpcs = await ec2.send(new DescribeVpcsCommand({
-            Filters: [{ Name: 'isDefault', Values: ['true'] }],
+            Filters: [{ Name: "isDefault", Values: ["true"] }],
         }));
         const vpcId = vpcs.Vpcs?.[0]?.VpcId;
         if (!vpcId)
             throw new Error(`[Fargate:${this.name}] No default VPC found. Use .subnets(ids[]) to specify subnets.`);
         const subnets = await ec2.send(new DescribeSubnetsCommand({
-            Filters: [{ Name: 'vpc-id', Values: [vpcId] }],
+            Filters: [{ Name: "vpc-id", Values: [vpcId] }],
         }));
-        const subnetIds = (subnets.Subnets ?? []).map(s => s.SubnetId).filter(Boolean);
+        const subnetIds = (subnets.Subnets ?? [])
+            .map((s) => s.SubnetId)
+            .filter(Boolean);
         return { vpcId, subnetIds };
     }
     async ensureSecurityGroup(vpcId) {
@@ -118,8 +154,8 @@ export class FargateBuilder extends BaseBuilder {
         const sgName = `puls-${this.name}-sg`;
         const existing = await ec2.send(new DescribeSecurityGroupsCommand({
             Filters: [
-                { Name: 'group-name', Values: [sgName] },
-                { Name: 'vpc-id', Values: [vpcId] },
+                { Name: "group-name", Values: [sgName] },
+                { Name: "vpc-id", Values: [vpcId] },
             ],
         }));
         if (existing.SecurityGroups?.length)
@@ -133,13 +169,15 @@ export class FargateBuilder extends BaseBuilder {
         if (this._port) {
             await ec2.send(new AuthorizeSecurityGroupIngressCommand({
                 GroupId: sgId,
-                IpPermissions: [{
-                        IpProtocol: 'tcp',
+                IpPermissions: [
+                    {
+                        IpProtocol: "tcp",
                         FromPort: this._port,
                         ToPort: this._port,
-                        IpRanges: [{ CidrIp: '0.0.0.0/0' }],
-                        Ipv6Ranges: [{ CidrIpv6: '::/0' }],
-                    }],
+                        IpRanges: [{ CidrIp: "0.0.0.0/0" }],
+                        Ipv6Ranges: [{ CidrIpv6: "::/0" }],
+                    },
+                ],
             }));
         }
         console.log(`   ✅ Created security group: ${sgName} (${sgId})`);
@@ -147,10 +185,13 @@ export class FargateBuilder extends BaseBuilder {
     }
     async resolveNetworking() {
         if (this._subnetIds && this._securityGroupIds) {
-            return { subnetIds: this._subnetIds, securityGroupIds: this._securityGroupIds };
+            return {
+                subnetIds: this._subnetIds,
+                securityGroupIds: this._securityGroupIds,
+            };
         }
         const { vpcId, subnetIds } = await this.discoverDefaultVpc();
-        const sgId = this._securityGroupIds?.[0] ?? await this.ensureSecurityGroup(vpcId);
+        const sgId = this._securityGroupIds?.[0] ?? (await this.ensureSecurityGroup(vpcId));
         return {
             subnetIds: this._subnetIds ?? subnetIds,
             securityGroupIds: [sgId],
@@ -159,19 +200,19 @@ export class FargateBuilder extends BaseBuilder {
     async deploy() {
         const dryRun = this.isDryRunActive();
         const existing = await this.discoveryPromise;
-        const region = Config.get().providers.aws?.region ?? 'us-east-1';
+        const region = Config.get().providers.aws?.region ?? "us-east-1";
         console.log(`\n⚡ Finalizing Fargate Service "${this.name}"...`);
         if (!this._image)
             throw new Error(`[Fargate:${this.name}] .image("...") is required`);
         if (dryRun) {
-            console.log(`   📝 [PLAN] ${existing ? 'Update' : 'Create'} Fargate service "${this.name}"`);
+            console.log(`   📝 [PLAN] ${existing ? "Update" : "Create"} Fargate service "${this.name}"`);
             console.log(`      └─ Cluster: ${this._clusterName}`);
             console.log(`      └─ Image: ${this._image}`);
             console.log(`      └─ CPU: ${this._cpu} | Memory: ${this._memory}MB | Replicas: ${this._replicas}`);
             if (this._port)
                 console.log(`      └─ Port: ${this._port}`);
             if (Object.keys(this._env).length)
-                console.log(`      └─ Env vars: ${Object.keys(this._env).join(', ')}`);
+                console.log(`      └─ Env vars: ${Object.keys(this._env).join(", ")}`);
             this.resolvedArn = `arn:aws:ecs:${region}:000000000000:service/${this._clusterName}/DRYRUN`;
             return { name: this.name, arn: this.resolvedArn };
         }
@@ -187,16 +228,18 @@ export class FargateBuilder extends BaseBuilder {
             image: this._image,
             essential: true,
             logConfiguration: {
-                logDriver: 'awslogs',
+                logDriver: "awslogs",
                 options: {
-                    'awslogs-group': logGroupName,
-                    'awslogs-region': region,
-                    'awslogs-stream-prefix': this.name,
+                    "awslogs-group": logGroupName,
+                    "awslogs-region": region,
+                    "awslogs-stream-prefix": this.name,
                 },
             },
         };
         if (this._port)
-            containerDef.portMappings = [{ containerPort: this._port, protocol: 'tcp' }];
+            containerDef.portMappings = [
+                { containerPort: this._port, protocol: "tcp" },
+            ];
         if (Object.keys(this._env).length) {
             const resolvedEnv = await resolveEnvVars(this._env);
             containerDef.environment = Object.entries(resolvedEnv).map(([name, value]) => ({ name, value }));
@@ -204,7 +247,7 @@ export class FargateBuilder extends BaseBuilder {
         const taskDef = await getECSClient().send(new RegisterTaskDefinitionCommand({
             family: this.name,
             networkMode: NetworkMode.AWSVPC,
-            requiresCompatibilities: ['FARGATE'],
+            requiresCompatibilities: ["FARGATE"],
             cpu: String(this._cpu),
             memory: String(this._memory),
             executionRoleArn,
@@ -216,7 +259,7 @@ export class FargateBuilder extends BaseBuilder {
             awsvpcConfiguration: {
                 subnets: networking.subnetIds,
                 securityGroups: networking.securityGroupIds,
-                assignPublicIp: 'ENABLED',
+                assignPublicIp: "ENABLED",
             },
         };
         const ecs = getECSClient();
@@ -245,14 +288,18 @@ export class FargateBuilder extends BaseBuilder {
             console.log(`🚀 Created Fargate service "${this.name}" (arn=${this.resolvedArn})`);
         }
         await this.deploySidecars();
-        return { name: this.name, arn: this.resolvedArn, cluster: this._clusterName };
+        return {
+            name: this.name,
+            arn: this.resolvedArn,
+            cluster: this._clusterName,
+        };
     }
     async destroy() {
         const dryRun = this.isDryRunActive();
         const existing = await this.discoveryPromise;
         console.log(`\n🗑️  Destroying Fargate Service "${this.name}"...`);
         if (!existing) {
-            console.log(`   ✅ Service "${this.name}" does not exist — nothing to do`);
+            console.log(`   ✅ Service "${this.name}" does not exist - nothing to do`);
             return { destroyed: this.name };
         }
         if (dryRun) {
@@ -260,7 +307,7 @@ export class FargateBuilder extends BaseBuilder {
             return { destroyed: this.name };
         }
         const ecs = getECSClient();
-        // Drain before delete — required by ECS
+        // Drain before delete - required by ECS
         await ecs.send(new UpdateServiceCommand({
             cluster: this._clusterName,
             service: this.name,

package/dist/providers/aws/lambda.d.ts

@@ -1,5 +1,5 @@
-import { BaseBuilder } from '../../core/resource.js';
-import { SecretsBuilder } from './secrets.js';
+import { BaseBuilder } from "../../core/resource.js";
+import { SecretsBuilder } from "./secrets.js";
 export declare class LambdaBuilder extends BaseBuilder {
     private _runtime;
     private _handler;

package/dist/providers/aws/lambda.js

@@ -1,19 +1,25 @@
-import { readFileSync, unlinkSync } from 'node:fs';
-import { execSync } from 'node:child_process';
-import { tmpdir } from 'node:os';
-import { join, extname } from 'node:path';
-import { GetFunctionCommand, CreateFunctionCommand, UpdateFunctionCodeCommand, UpdateFunctionConfigurationCommand, DeleteFunctionCommand, } from '@aws-sdk/client-lambda';
-import { GetRoleCommand, CreateRoleCommand, AttachRolePolicyCommand, } from '@aws-sdk/client-iam';
-import { BaseBuilder } from '../../core/resource.js';
-import { getLambdaClient, getIAMClient } from './api.js';
-import { resolveEnvVars } from './secrets.js';
+import { readFileSync, unlinkSync } from "node:fs";
+import { execSync } from "node:child_process";
+import { tmpdir } from "node:os";
+import { join, extname } from "node:path";
+import { GetFunctionCommand, CreateFunctionCommand, UpdateFunctionCodeCommand, UpdateFunctionConfigurationCommand, DeleteFunctionCommand, } from "@aws-sdk/client-lambda";
+import { GetRoleCommand, CreateRoleCommand, AttachRolePolicyCommand, } from "@aws-sdk/client-iam";
+import { BaseBuilder } from "../../core/resource.js";
+import { getLambdaClient, getIAMClient } from "./api.js";
+import { resolveEnvVars } from "./secrets.js";
 const ASSUME_ROLE_POLICY = JSON.stringify({
-    Version: '2012-10-17',
-    Statement: [{ Effect: 'Allow', Principal: { Service: 'lambda.amazonaws.com' }, Action: 'sts:AssumeRole' }],
+    Version: "2012-10-17",
+    Statement: [
+        {
+            Effect: "Allow",
+            Principal: { Service: "lambda.amazonaws.com" },
+            Action: "sts:AssumeRole",
+        },
+    ],
 });
 export class LambdaBuilder extends BaseBuilder {
-    _runtime = 'nodejs20.x';
-    _handler = 'index.handler';
+    _runtime = "nodejs20.x";
+    _handler = "index.handler";
     _memory = 128;
     _timeout = 30;
     _codePath;
@@ -31,20 +37,41 @@ export class LambdaBuilder extends BaseBuilder {
             return result.Configuration ?? null;
         }
         catch (e) {
-            if (e.name === 'ResourceNotFoundException')
+            if (e.name === "ResourceNotFoundException")
                 return null;
-            if (e.name === 'CredentialsProviderError')
+            if (e.name === "CredentialsProviderError")
                 return null;
             throw e;
         }
     }
-    code(pathOrZip) { this._codePath = pathOrZip; return this; }
-    runtime(r) { this._runtime = r; return this; }
-    handler(h) { this._handler = h; return this; }
-    memory(mb) { this._memory = mb; return this; }
-    timeout(seconds) { this._timeout = seconds; return this; }
-    role(arn) { this._roleArn = arn; return this; }
-    env(vars) { this._env = { ...this._env, ...vars }; return this; }
+    code(pathOrZip) {
+        this._codePath = pathOrZip;
+        return this;
+    }
+    runtime(r) {
+        this._runtime = r;
+        return this;
+    }
+    handler(h) {
+        this._handler = h;
+        return this;
+    }
+    memory(mb) {
+        this._memory = mb;
+        return this;
+    }
+    timeout(seconds) {
+        this._timeout = seconds;
+        return this;
+    }
+    role(arn) {
+        this._roleArn = arn;
+        return this;
+    }
+    env(vars) {
+        this._env = { ...this._env, ...vars };
+        return this;
+    }
     async ensureRole() {
         if (this._roleArn)
             return this._roleArn;
@@ -55,7 +82,7 @@ export class LambdaBuilder extends BaseBuilder {
             return existing.Role.Arn;
         }
         catch (e) {
-            if (e.name !== 'NoSuchEntityException')
+            if (e.name !== "NoSuchEntityException")
                 throw e;
         }
         const created = await iam.send(new CreateRoleCommand({
@@ -65,21 +92,23 @@ export class LambdaBuilder extends BaseBuilder {
         }));
         await iam.send(new AttachRolePolicyCommand({
             RoleName: roleName,
-            PolicyArn: 'arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole',
+            PolicyArn: "arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole",
         }));
         console.log(`   ✅ Created execution role: ${roleName}`);
-        // IAM propagation — Lambda rejects a brand-new role for ~10s
-        await new Promise(r => setTimeout(r, 10_000));
+        // IAM propagation - Lambda rejects a brand-new role for ~10s
+        await new Promise((r) => setTimeout(r, 10_000));
         return created.Role.Arn;
     }
     buildZip() {
         if (!this._codePath)
             throw new Error(`[Lambda:${this.name}] .code(path) is required`);
-        if (extname(this._codePath) === '.zip') {
+        if (extname(this._codePath) === ".zip") {
             return readFileSync(this._codePath);
         }
         const outPath = join(tmpdir(), `puls-lambda-${this.name}-${Date.now()}.zip`);
-        execSync(`cd "${this._codePath}" && zip -r "${outPath}" .`, { stdio: 'pipe' });
+        execSync(`cd "${this._codePath}" && zip -r "${outPath}" .`, {
+            stdio: "pipe",
+        });
         const buf = readFileSync(outPath);
         unlinkSync(outPath);
         return buf;
@@ -90,13 +119,13 @@ export class LambdaBuilder extends BaseBuilder {
         const lambda = getLambdaClient();
         console.log(`\n⚡ Finalizing Lambda Function "${this.name}"...`);
         if (dryRun) {
-            console.log(`   📝 [PLAN] ${existing ? 'Update' : 'Create'} function "${this.name}"`);
+            console.log(`   📝 [PLAN] ${existing ? "Update" : "Create"} function "${this.name}"`);
             console.log(`      └─ Runtime: ${this._runtime} | Handler: ${this._handler}`);
             console.log(`      └─ Memory: ${this._memory}MB | Timeout: ${this._timeout}s`);
             if (this._codePath)
                 console.log(`      └─ Code: ${this._codePath}`);
             if (Object.keys(this._env).length)
-                console.log(`      └─ Env vars: ${Object.keys(this._env).join(', ')}`);
+                console.log(`      └─ Env vars: ${Object.keys(this._env).join(", ")}`);
             this.resolvedArn = `arn:aws:lambda:DRYRUN:000000000000:function:${this.name}`;
             return { name: this.name, arn: this.resolvedArn };
         }
@@ -111,7 +140,9 @@ export class LambdaBuilder extends BaseBuilder {
             MemorySize: this._memory,
             Timeout: this._timeout,
             Role: roleArn,
-            Environment: Object.keys(resolvedEnv).length ? { Variables: resolvedEnv } : undefined,
+            Environment: Object.keys(resolvedEnv).length
+                ? { Variables: resolvedEnv }
+                : undefined,
         };
         if (existing) {
             this.resolvedArn = existing.FunctionArn;
@@ -145,7 +176,7 @@ export class LambdaBuilder extends BaseBuilder {
         const existing = await this.discoveryPromise;
         console.log(`\n🗑️  Destroying Lambda Function "${this.name}"...`);
         if (!existing) {
-            console.log(`   ✅ Function "${this.name}" does not exist — nothing to do`);
+            console.log(`   ✅ Function "${this.name}" does not exist - nothing to do`);
             return { destroyed: this.name };
         }
         if (dryRun) {

package/dist/providers/aws/rds.d.ts

@@ -1,4 +1,4 @@
-import { BaseBuilder } from '../../core/resource.js';
+import { BaseBuilder } from "../../core/resource.js";
 export declare class RDSBuilder extends BaseBuilder {
     private _engine;
     private _engineVersion;