local-serverless-stack 0.6.0 → 0.8.0

package/dist/server/services/localstack-manager.js

@@ -1,24 +1,11 @@
-import { spawn, exec } from 'child_process';
-import { promisify } from 'util';
-import { ConfigManager } from './config-manager.js';
-const execAsync = promisify(exec);
+// Deprecated facade kept so the ~10 existing call sites (provisioner,
+// explorers, seeds, dynamo-proxy, routes) stay untouched: they keep importing
+// LocalStackManager, but the active provider may be the LocalStack container
+// OR the in-process self engine — EngineManager decides from the config.
+// New code should use EngineManager directly.
+import { EngineManager } from '../engine/engine-manager.js';
 export class LocalStackManager {
     static instance;
-    process = null;
-    _isRunning = false;
-    endpoint;
-    // Container name is scoped to the LocalStack port so multiple LSS instances
-    // (one per example/project) can launch their own container side by side.
-    // Falls back to "lss-localstack" when the default 4566 is in use to preserve
-    // existing teardown scripts that look for that name.
-    containerName;
-    configManager;
-    constructor() {
-        this.configManager = ConfigManager.getInstance();
-        this.endpoint = this.configManager.getLocalStackEndpoint();
-        const port = this.configManager.getLocalStackPort();
-        this.containerName = port === 4566 ? 'lss-localstack' : `lss-localstack-${port}`;
-    }
     static getInstance() {
         if (!LocalStackManager.instance) {
             LocalStackManager.instance = new LocalStackManager();
@@ -26,168 +13,19 @@ export class LocalStackManager {
         return LocalStackManager.instance;
     }
     async start() {
-        if (this._isRunning) {
-            console.log('⚠️  LocalStack already running');
-            return;
-        }
-        if (this.configManager.isExternal()) {
-            console.log(`🔗 Using external LocalStack at ${this.endpoint}`);
-            await this.waitForReady(30);
-            this._isRunning = true;
-            console.log('✅ Connected to external LocalStack');
-            return;
-        }
-        try {
-            // Check if docker is available
-            await execAsync('docker ps -q', { timeout: 5000 });
-        }
-        catch {
-            throw new Error('Docker is not available or not running. Please start Docker first.');
-        }
-        const edition = this.configManager.getLocalStackEdition();
-        const image = this.configManager.getLocalStackImage();
-        const authToken = this.configManager.getLocalStackAuthToken();
-        if (edition === 'pro' && !authToken) {
-            throw new Error('LocalStack Pro requires LOCALSTACK_AUTH_TOKEN. Set the env var or "localstackAuthToken" in your config.');
-        }
-        if (edition === 'community' && !authToken) {
-            console.warn('⚠️  LOCALSTACK_AUTH_TOKEN not set. Recent localstack/localstack images (>= 2026.5) require a token even for the community edition.');
-        }
-        return new Promise((resolve, reject) => {
-            console.log(`🔄 Starting LocalStack (${image})...`);
-            const port = this.configManager.getLocalStackPort();
-            const services = this.configManager.getServices().join(',');
-            const persistence = this.configManager.isPersistence() ? '1' : '0';
-            const debug = this.configManager.isDebug() ? '1' : '0';
-            // Persistence volume is scoped to the container so two LSS instances
-            // don't share (and corrupt) the same on-disk state.
-            const volumeName = this.containerName === 'lss-localstack'
-                ? 'lss-localstack-data'
-                : `${this.containerName}-data`;
-            const dockerArgs = [
-                'run',
-                '--rm',
-                '-p',
-                `${port}:4566`,
-                '-v',
-                `${volumeName}:/var/lib/localstack`,
-                '-v',
-                '/var/run/docker.sock:/var/run/docker.sock',
-                // host.docker.internal resolves natively on Docker Desktop but not on
-                // Linux; the generated Lambda proxies target it to reach the invoke
-                // listeners on the host, so map it explicitly (no-op elsewhere).
-                '--add-host',
-                'host.docker.internal:host-gateway',
-                '--name',
-                this.containerName,
-                '-e',
-                `SERVICES=${services}`,
-                '-e',
-                'LAMBDA_EXECUTOR=local',
-                // Lambda containers spawned BY LocalStack (which run the proxies) need
-                // the same host mapping.
-                '-e',
-                'LAMBDA_DOCKER_FLAGS=--add-host host.docker.internal:host-gateway',
-                '-e',
-                `PERSISTENCE=${persistence}`,
-                '-e',
-                `DEBUG=${debug}`,
-            ];
-            if (authToken) {
-                dockerArgs.push('-e', `LOCALSTACK_AUTH_TOKEN=${authToken}`);
-            }
-            dockerArgs.push(image);
-            this.process = spawn('docker', dockerArgs);
-            let stderr = '';
-            let stdout = '';
-            this.process.stderr?.on('data', data => {
-                stderr += data.toString();
-                console.log(`[LocalStack stderr] ${data.toString().trim()}`);
-            });
-            this.process.stdout?.on('data', data => {
-                stdout += data.toString();
-                console.log(`[LocalStack stdout] ${data.toString().trim()}`);
-            });
-            this.process.on('error', error => {
-                console.error('❌ Failed to start LocalStack process:', error);
-                reject(error);
-            });
-            this.process.on('close', code => {
-                if (code !== 0) {
-                    console.error(`Container exited with code ${code}`);
-                    console.error('stderr:', stderr);
-                    console.error('stdout:', stdout);
-                }
-            });
-            // Wait for LocalStack to be ready
-            this.waitForReady()
-                .then(() => {
-                this._isRunning = true;
-                console.log('✅ LocalStack ready');
-                resolve();
-            })
-                .catch(err => {
-                console.error('LocalStack startup error:', err.message);
-                this.process?.kill();
-                reject(err);
-            });
-        });
+        return EngineManager.getInstance().start();
     }
     async stop() {
-        if (!this._isRunning) {
-            return;
-        }
-        if (this.configManager.isExternal()) {
-            console.log('🔗 External LocalStack — leaving container untouched');
-            this._isRunning = false;
-            return;
-        }
-        console.log('🛑 Stopping LocalStack...');
-        try {
-            await execAsync(`docker stop ${this.containerName}`, { timeout: 10000 });
-            this._isRunning = false;
-            this.process = null;
-            console.log('✅ LocalStack stopped');
-        }
-        catch (error) {
-            console.error('⚠️  Error stopping LocalStack:', error instanceof Error ? error.message : 'Unknown error');
-            this._isRunning = false;
-        }
-    }
-    async waitForReady(maxAttempts = 120) {
-        for (let i = 0; i < maxAttempts; i++) {
-            try {
-                const response = await fetch(`${this.endpoint}/_localstack/health`);
-                if (response.ok) {
-                    console.log(`✓ LocalStack is responsive (attempt ${i + 1}/${maxAttempts})`);
-                    return;
-                }
-            }
-            catch {
-                // Ignore fetch errors during startup
-                if (i % 20 === 0) {
-                    console.log(`⏳ Waiting for LocalStack... (attempt ${i + 1}/${maxAttempts})`);
-                }
-            }
-            await new Promise(resolve => setTimeout(resolve, 1000));
-        }
-        throw new Error('LocalStack failed to start in time (120s timeout). Check Docker and container logs.');
+        return EngineManager.getInstance().stop();
     }
     isRunning() {
-        return this._isRunning;
+        return EngineManager.getInstance().isRunning();
     }
     getEndpoint() {
-        return this.endpoint;
+        return EngineManager.getInstance().getEndpoint();
     }
     getConfig() {
-        return {
-            endpoint: this.endpoint,
-            region: this.configManager.getRegion(),
-            credentials: {
-                accessKeyId: process.env.LOCALSTACK_ACCESS_KEY_ID || 'test',
-                secretAccessKey: process.env.LOCALSTACK_SECRET_ACCESS_KEY || 'test',
-            },
-        };
+        return EngineManager.getInstance().getConfig();
     }
 }
 //# sourceMappingURL=localstack-manager.js.map

package/dist/server/services/localstack-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"localstack-manager.js","sourceRoot":"","sources":["../../../src/server/services/localstack-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"localstack-manager.js","sourceRoot":"","sources":["../../../src/server/services/localstack-manager.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,8EAA8E;AAC9E,6EAA6E;AAC7E,yEAAyE;AACzE,8CAA8C;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,MAAM,OAAO,iBAAiB;IACpB,MAAM,CAAC,QAAQ,CAAoB;IAE3C,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC;YAChC,iBAAiB,CAAC,QAAQ,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACvD,CAAC;QACD,OAAO,iBAAiB,CAAC,QAAQ,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,OAAO,aAAa,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,aAAa,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED,SAAS;QACP,OAAO,aAAa,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,CAAC;IACjD,CAAC;IAED,WAAW;QACT,OAAO,aAAa,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,CAAC;IACnD,CAAC;IAED,SAAS;QACP,OAAO,aAAa,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,CAAC;IACjD,CAAC;CACF"}

package/dist/server/services/resource-provisioner.d.ts

@@ -7,6 +7,7 @@ export declare class ResourceProvisioner {
     private snsClient;
     private s3Client;
     private lambdaClient;
+    private eventBridgeClient;
     private currentRegion;
     private resourcesByLogicalId;
     private constructor();
@@ -29,6 +30,9 @@ export declare class ResourceProvisioner {
     private resolveLambdaName;
     private generateProxyLambdaCode;
     private createEventSourceMapping;
+    private createEventBus;
+    private resolveEventBusName;
+    private createEventRule;
     private ensureLambdaProxyExists;
     private convertCamelCaseToKebab;
     private resolveEventSourceArn;
@@ -43,6 +47,8 @@ export declare class ResourceProvisioner {
     private listSNSTopics;
     private listS3Buckets;
     cleanupResources(serviceName: string, resources: Resource[]): Promise<void>;
+    private deleteEventRule;
+    private deleteEventBus;
     private deleteDynamoDBTable;
     private deleteSQSQueue;
     private deleteS3Bucket;

package/dist/server/services/resource-provisioner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-provisioner.d.ts","sourceRoot":"","sources":["../../../src/server/services/resource-provisioner.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,QAAQ,EAQT,MAAM,oBAAoB,CAAC;AAM5B,OAAO,KAAK,EACV,QAAQ,EAMT,MAAM,4BAA4B,CAAC;AAGpC,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsB;IAC7C,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,QAAQ,CAAY;IAC5B,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,aAAa,CAAuB;IAM5C,OAAO,CAAC,oBAAoB,CAA+B;IAE3D,OAAO;IAIP,MAAM,CAAC,WAAW,IAAI,mBAAmB;IAOzC,OAAO,CAAC,iBAAiB;IAezB,WAAW,IAAI,QAAQ;IAIvB,gBAAgB,IAAI,MAAM;IAIpB,kBAAkB,CACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,QAAQ,EAAE,EACrB,QAAQ,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACtE,OAAO,CAAC,IAAI,CAAC;YAuFF,mBAAmB;YA+DnB,eAAe;YAqBf,cAAc;YAiCd,cAAc;YAiBd,cAAc;YA4Bd,wBAAwB;IAiEtC,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,uBAAuB;YAoEjB,wBAAwB;YAsExB,uBAAuB;IAqErC,OAAO,CAAC,uBAAuB;YAOjB,qBAAqB;IAkH7B,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAC/C,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;YAoBY,kBAAkB;YASlB,aAAa;YASb,aAAa;YAYb,aAAa;IASrB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAyCnE,mBAAmB;YAYnB,cAAc;YAiBd,cAAc;YAsBd,cAAc;YAkBd,wBAAwB;CA6BvC"}
+{"version":3,"file":"resource-provisioner.d.ts","sourceRoot":"","sources":["../../../src/server/services/resource-provisioner.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,QAAQ,EAQT,MAAM,oBAAoB,CAAC;AAe5B,OAAO,KAAK,EACV,QAAQ,EAQT,MAAM,4BAA4B,CAAC;AAGpC,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsB;IAC7C,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,QAAQ,CAAY;IAC5B,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,aAAa,CAAuB;IAM5C,OAAO,CAAC,oBAAoB,CAA+B;IAE3D,OAAO;IAIP,MAAM,CAAC,WAAW,IAAI,mBAAmB;IAOzC,OAAO,CAAC,iBAAiB;IAgBzB,WAAW,IAAI,QAAQ;IAIvB,gBAAgB,IAAI,MAAM;IAIpB,kBAAkB,CACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,QAAQ,EAAE,EACrB,QAAQ,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACtE,OAAO,CAAC,IAAI,CAAC;YAwGF,mBAAmB;YA+DnB,eAAe;YAqBf,cAAc;YAiCd,cAAc;YAiBd,cAAc;YA4Bd,wBAAwB;IAiEtC,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,uBAAuB;YAmEjB,wBAAwB;YAsExB,cAAc;IAgB5B,OAAO,CAAC,mBAAmB;YASb,eAAe;YAyEf,uBAAuB;IAqErC,OAAO,CAAC,uBAAuB;YAOjB,qBAAqB;IAkH7B,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAC/C,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;YAoBY,kBAAkB;YASlB,aAAa;YASb,aAAa;YAYb,aAAa;IASrB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAuEnE,eAAe;YAuBf,cAAc;YAWd,mBAAmB;YAYnB,cAAc;YAiBd,cAAc;YAsBd,cAAc;YAkBd,wBAAwB;CA6BvC"}

package/dist/server/services/resource-provisioner.js

@@ -4,6 +4,7 @@ import { SNSClient, CreateTopicCommand, ListTopicsCommand, DeleteTopicCommand }
 import { S3Client, CreateBucketCommand, ListBucketsCommand, DeleteBucketCommand, PutBucketVersioningCommand, PutBucketNotificationConfigurationCommand, ListObjectsV2Command, DeleteObjectCommand, } from '@aws-sdk/client-s3';
 import { LambdaClient, CreateFunctionCommand, GetFunctionCommand, DeleteFunctionCommand, AddPermissionCommand, UpdateFunctionConfigurationCommand } from '@aws-sdk/client-lambda';
 import { CreateEventSourceMappingCommand, ListEventSourceMappingsCommand, DeleteEventSourceMappingCommand } from '@aws-sdk/client-lambda';
+import { EventBridgeClient, CreateEventBusCommand, DeleteEventBusCommand, PutRuleCommand, PutTargetsCommand, RemoveTargetsCommand, DeleteRuleCommand, } from '@aws-sdk/client-eventbridge';
 import { LocalStackManager } from './localstack-manager.js';
 import { ConfigManager } from './config-manager.js';
 import { SeedManager } from './seed-manager.js';
@@ -15,6 +16,7 @@ export class ResourceProvisioner {
     snsClient;
     s3Client;
     lambdaClient;
+    eventBridgeClient;
     currentRegion = 'us-east-1';
     // CFN logical id → resource snapshot for the service currently being
     // provisioned. Lets resolveEventSourceArn map Fn::GetAtt references
@@ -44,6 +46,7 @@ export class ResourceProvisioner {
         // rather than as a virtual-host subdomain (which resolves to host.docker.internal).
         this.s3Client = new S3Client({ ...config, forcePathStyle: true });
         this.lambdaClient = new LambdaClient(config);
+        this.eventBridgeClient = new EventBridgeClient(config);
     }
     getS3Client() {
         return this.s3Client;
@@ -93,6 +96,10 @@ export class ResourceProvisioner {
                         await this.createS3Bucket(resource);
                         provisionedCount++;
                         break;
+                    case 'eventbus':
+                        await this.createEventBus(resource);
+                        provisionedCount++;
+                        break;
                 }
             }
             catch (error) {
@@ -117,6 +124,19 @@ export class ResourceProvisioner {
                 }
             }
         }
+        // EventBridge rules ride the same proxy model as event source mappings:
+        // rule + pattern on the bus → Lambda proxy in LocalStack → LSS invoke API.
+        const eventRules = resources.filter(r => r.type === 'event-rule');
+        for (const rule of eventRules) {
+            try {
+                await this.createEventRule(serviceName, rule, invokeUrl);
+                provisionedCount++;
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                console.error(`Failed to provision event-rule ${rule.name}:`, errorMessage);
+            }
+        }
         // Third pass: Wire S3 bucket notifications to Lambda proxies.
         // Done after event-source pass so proxies created there are available; the
         // wiring also creates a proxy on demand when only S3 (no SQS/Dynamo) triggers it.
@@ -374,14 +394,13 @@ export const handler = async (event, context) => {
   const invokeUrl = process.env.INVOKE_URL || '${invokeUrl}';
   const parsedUrl = url.parse(invokeUrl);
 
-  // Transform event based on source
-  // LocalStack sends events through different sources (SQS, DynamoDB, SNS, etc.)
-  // We need to pass them correctly to the Serverless Offline handler
+  // SQS/DynamoDB/SNS deliver batches under Records; EventBridge delivers the
+  // event object itself (source / detail-type / detail) with no wrapper — real
+  // AWS Lambda targets read event.detail directly, so wrapping it would break
+  // handlers written for production. Wrap only non-EventBridge-shaped events.
   let transformedEvent = event;
-  
-  // If the event already has Records (SQS/DynamoDB/SNS event), use it as is
-  // Otherwise wrap it in a Records array
-  if (!event.Records) {
+  const isEventBridgeEvent = Boolean(event && event['detail-type'] !== undefined && event.source !== undefined);
+  if (!event.Records && !isEventBridgeEvent) {
     transformedEvent = {
       Records: [event]
     };
@@ -493,6 +512,92 @@ export const handler = async (event, context) => {
             }
         }
     }
+    async createEventBus(resource) {
+        try {
+            await this.eventBridgeClient.send(new CreateEventBusCommand({ Name: resource.name }));
+            console.log(`  ✓ Created EventBridge bus: ${resource.name}`);
+        }
+        catch (error) {
+            if (error?.name === 'ResourceAlreadyExistsException') {
+                console.log(`  ⚠ EventBridge bus already exists: ${resource.name}`);
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    // Resolve a rule's EventBusName: a logical id from the same template maps to
+    // the provisioned bus name; anything else is a literal name/ARN, both of
+    // which PutRule/PutTargets accept. Undefined targets the default bus.
+    resolveEventBusName(busRef) {
+        if (!busRef)
+            return undefined;
+        const direct = this.resourcesByLogicalId.get(busRef);
+        if (direct && direct.type === 'eventbus') {
+            return direct.name;
+        }
+        return busRef;
+    }
+    async createEventRule(serviceName, rule, invokeUrl) {
+        if (rule.eventBusUnresolved) {
+            // Binding it to the default bus instead would "work" but never match the
+            // producers' events — skipping with a warning is the honest failure.
+            console.warn(`  ⚠ Skipped EventBridge rule ${rule.name}: EventBusName could not be resolved from the template (e.g. Fn::ImportValue).`);
+            return;
+        }
+        const eventBusName = this.resolveEventBusName(rule.eventBusRef);
+        // PutRule/PutTargets are upserts, so re-registration is naturally idempotent.
+        await this.eventBridgeClient.send(new PutRuleCommand({
+            Name: rule.name,
+            EventBusName: eventBusName,
+            EventPattern: rule.eventPattern ? JSON.stringify(rule.eventPattern) : undefined,
+            ScheduleExpression: rule.scheduleExpression,
+            State: rule.enabled ? 'ENABLED' : 'DISABLED',
+        }));
+        console.log(`  ✓ Put EventBridge rule: ${rule.name}${eventBusName ? ` (bus: ${eventBusName})` : ''}`);
+        const targets = [];
+        for (const target of rule.targets) {
+            // Targets arrive as logical ids (Fn::GetAtt) or literal Lambda ARNs.
+            const actualFunctionName = target.functionRef.startsWith('arn:aws:')
+                ? target.functionRef.split(':function:')[1]?.split(':')[0]
+                : this.resolveLambdaName(serviceName, target.functionRef);
+            if (!actualFunctionName) {
+                console.warn(`  ⚠ Skipped EventBridge target ${target.id} on rule ${rule.name}: unsupported target ${target.functionRef}`);
+                continue;
+            }
+            await this.ensureLambdaProxyExists(serviceName, actualFunctionName, actualFunctionName, invokeUrl);
+            const ruleArn = `arn:aws:events:${this.currentRegion}:000000000000:rule/${eventBusName ? `${eventBusName}/` : ''}${rule.name}`;
+            try {
+                await this.lambdaClient.send(new AddPermissionCommand({
+                    FunctionName: actualFunctionName,
+                    StatementId: `events-invoke-${rule.name}`,
+                    Action: 'lambda:InvokeFunction',
+                    Principal: 'events.amazonaws.com',
+                    SourceArn: ruleArn,
+                }));
+            }
+            catch (error) {
+                // ResourceConflictException = statement already exists, which is fine.
+                if (error?.name !== 'ResourceConflictException') {
+                    console.warn(`  ⚠ Could not add EventBridge invoke permission for ${actualFunctionName}: ${error?.message || error}`);
+                }
+            }
+            targets.push({
+                Id: target.id,
+                Arn: `arn:aws:lambda:${this.currentRegion}:000000000000:function:${actualFunctionName}`,
+                Input: target.input,
+                InputPath: target.inputPath,
+            });
+        }
+        if (targets.length === 0)
+            return;
+        await this.eventBridgeClient.send(new PutTargetsCommand({
+            Rule: rule.name,
+            EventBusName: eventBusName,
+            Targets: targets,
+        }));
+        console.log(`  ✓ Wired ${targets.length} target(s) on EventBridge rule: ${rule.name}`);
+    }
     async ensureLambdaProxyExists(serviceName, proxyName, invokeName, invokeUrl) {
         try {
             // Check if function already exists
@@ -715,7 +820,19 @@ export const handler = async (event, context) => {
             console.log(`No resources to clean up for ${serviceName}`);
             return;
         }
+        // Rebuild the logical id map so event-rule cleanup can resolve which bus
+        // each rule lives on (same lookup provisioning uses).
+        this.resourcesByLogicalId.clear();
+        for (const r of resources) {
+            if ('logicalId' in r && r.logicalId) {
+                this.resourcesByLogicalId.set(r.logicalId, r);
+            }
+        }
         let cleaned = 0;
+        // Buses are deleted after the main loop: EventBridge refuses to delete a
+        // bus that still has rules, and template order doesn't guarantee the rules
+        // come first.
+        const eventBuses = [];
         for (const resource of resources) {
             try {
                 switch (resource.type) {
@@ -735,6 +852,13 @@ export const handler = async (event, context) => {
                         await this.deleteS3Bucket(resource.name);
                         cleaned++;
                         break;
+                    case 'eventbus':
+                        eventBuses.push(resource);
+                        break;
+                    case 'event-rule':
+                        await this.deleteEventRule(resource);
+                        cleaned++;
+                        break;
                     case 'event-source':
                         await this.deleteEventSourceMapping(serviceName, resource.functionName);
                         cleaned++;
@@ -747,8 +871,48 @@ export const handler = async (event, context) => {
                 console.error(`Failed to cleanup ${resource.type}:${resourceName}:`, errorMessage);
             }
         }
+        for (const bus of eventBuses) {
+            try {
+                await this.deleteEventBus(bus.name);
+                cleaned++;
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                console.error(`Failed to cleanup eventbus:${bus.name}:`, errorMessage);
+            }
+        }
         console.log(`✅ Cleaned up ${cleaned} resources for ${serviceName}`);
     }
+    async deleteEventRule(rule) {
+        const eventBusName = this.resolveEventBusName(rule.eventBusRef);
+        try {
+            if (rule.targets.length > 0) {
+                await this.eventBridgeClient.send(new RemoveTargetsCommand({
+                    Rule: rule.name,
+                    EventBusName: eventBusName,
+                    Ids: rule.targets.map(t => t.id),
+                }));
+            }
+            await this.eventBridgeClient.send(new DeleteRuleCommand({ Name: rule.name, EventBusName: eventBusName }));
+            console.log(`Deleted EventBridge rule: ${rule.name}`);
+        }
+        catch (error) {
+            if (error?.name !== 'ResourceNotFoundException') {
+                throw error;
+            }
+        }
+    }
+    async deleteEventBus(busName) {
+        try {
+            await this.eventBridgeClient.send(new DeleteEventBusCommand({ Name: busName }));
+            console.log(`Deleted EventBridge bus: ${busName}`);
+        }
+        catch (error) {
+            if (error?.name !== 'ResourceNotFoundException') {
+                throw error;
+            }
+        }
+    }
     async deleteDynamoDBTable(tableName) {
         try {
             await this.dynamoClient.send(new DeleteTableCommand({ TableName: tableName }));