local-serverless-stack 0.5.0 → 0.8.0

package/dist/server/engine/backends/localstack-backend.js

@@ -0,0 +1,199 @@
+// LocalStack lifecycle backend (docker container, managed/external). This is
+// the code that used to live in services/localstack-manager.ts — that module
+// is now a thin facade over EngineManager so existing call sites keep working
+// regardless of the active engine.
+import { spawn, exec } from 'child_process';
+import { promisify } from 'util';
+import { ConfigManager } from '../../services/config-manager.js';
+const execAsync = promisify(exec);
+export class LocalStackBackend {
+    kind = 'localstack';
+    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}`;
+    }
+    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);
+            });
+        });
+    }
+    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.');
+    }
+    isRunning() {
+        return this._isRunning;
+    }
+    getEndpoint() {
+        return this.endpoint;
+    }
+    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',
+            },
+        };
+    }
+    healthDetail() {
+        return {
+            endpoint: this.endpoint,
+            running: this._isRunning,
+            mode: this.configManager.getMode(),
+            image: this.configManager.isExternal() ? undefined : this.configManager.getLocalStackImage(),
+        };
+    }
+}
+//# sourceMappingURL=localstack-backend.js.map

package/dist/server/engine/backends/localstack-backend.js.map

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

package/dist/server/engine/backends/self-backend.d.ts

@@ -0,0 +1,32 @@
+import type { EngineBackend } from '../engine-backend.js';
+import { type ResolvedSelfEngineConfig } from '../../services/config-manager.js';
+export declare class SelfEngineBackend implements EngineBackend {
+    readonly kind: "self";
+    private readonly overrides;
+    private config;
+    private store;
+    private sqs;
+    private dispatcher;
+    private scheduler;
+    private server;
+    private readonly sockets;
+    private boundPort;
+    private running;
+    constructor(overrides?: Partial<ResolvedSelfEngineConfig>);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    isRunning(): boolean;
+    getEndpoint(): string;
+    getConfig(): {
+        endpoint: string;
+        region: string;
+        credentials: {
+            accessKeyId: string;
+            secretAccessKey: string;
+        };
+    };
+    healthDetail(): Record<string, unknown>;
+    private resolveConfig;
+    private restoreSqsSnapshot;
+}
+//# sourceMappingURL=self-backend.d.ts.map

package/dist/server/engine/backends/self-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-backend.d.ts","sourceRoot":"","sources":["../../../../src/server/engine/backends/self-backend.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAiB,KAAK,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAmBhG,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAEhC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,GAAG,CAA4B;IACvC,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,MAAM,CAA4B;IAE1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,OAAO,CAAS;gBAIZ,SAAS,GAAE,OAAO,CAAC,wBAAwB,CAAM;IAIvD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsFtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkC3B,SAAS,IAAI,OAAO;IAIpB,WAAW,IAAI,MAAM;IAIrB,SAAS,IAAI;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,eAAe,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;IAQhH,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYvC,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,kBAAkB;CAU3B"}

package/dist/server/engine/backends/self-backend.js

@@ -0,0 +1,205 @@
+// In-process self engine backend: opens the JSONL store, constructs the
+// emulators + dispatcher + scheduler over a shared EngineContext, rearms
+// event delivery from persisted metadata (ESMs, schedule rules) and binds the
+// AWS wire front door on config.port. Boot is file reads only — no Docker, no
+// health polling, no sleeps (PRD RF1.2: well under 500 ms).
+import http from 'http';
+import fs from 'fs';
+import path from 'path';
+import { ConfigManager } from '../../services/config-manager.js';
+import { EngineBus } from '../bus.js';
+import { createEngineStore } from '../store/engine-store.js';
+import { createEngineRequestHandler } from '../http/router.js';
+import { DynamoDbEmulator } from '../emulators/dynamodb/index.js';
+import { SqsEmulator } from '../emulators/sqs/index.js';
+import { S3Emulator } from '../emulators/s3/index.js';
+import { EventsEmulator } from '../emulators/events/index.js';
+import { SnsEmulator } from '../emulators/sns/index.js';
+import { StsEmulator } from '../emulators/sts.js';
+import { LambdaCtlEmulator } from '../emulators/lambda-ctl/index.js';
+import { EngineDispatcher } from '../dispatch/dispatcher.js';
+import { EngineScheduler } from '../dispatch/scheduler.js';
+const SERVICES = ['dynamodb', 'sqs', 'sns', 's3', 'events', 'lambda', 'sts'];
+const SQS_SNAPSHOT_FILE = 'sqs-messages.snapshot.json';
+export class SelfEngineBackend {
+    kind = 'self';
+    overrides;
+    config = null;
+    store = null;
+    sqs = null;
+    dispatcher = null;
+    scheduler = null;
+    server = null;
+    // Keep-alive sockets must be destroyed for server.close() not to hang.
+    sockets = new Set();
+    boundPort = null;
+    running = false;
+    // `overrides` merge over ConfigManager's resolved self-engine config —
+    // tests use it for ephemeral ports (0) and temp data dirs.
+    constructor(overrides = {}) {
+        this.overrides = overrides;
+    }
+    async start() {
+        if (this.running)
+            return;
+        const config = this.resolveConfig();
+        this.config = config;
+        const store = createEngineStore({
+            dataDir: config.dataDir,
+            idleUnloadMs: config.idleUnloadMs,
+            memoryBudgetMb: config.memoryBudgetMb,
+            fsync: config.fsync,
+        });
+        this.store = store;
+        const bus = new EngineBus();
+        const ctx = {
+            config,
+            store,
+            bus,
+            // Late-bound below; emulators only touch it while handling requests.
+            dispatcher: notReadyDispatcher(),
+            endpoint: () => this.getEndpoint(),
+        };
+        const dynamo = new DynamoDbEmulator(ctx);
+        const sqs = new SqsEmulator(ctx);
+        const s3 = new S3Emulator(ctx);
+        const events = new EventsEmulator(ctx);
+        const sns = new SnsEmulator(ctx);
+        const sts = new StsEmulator(ctx);
+        const lambdaCtl = new LambdaCtlEmulator(ctx);
+        this.sqs = sqs;
+        const dispatcher = new EngineDispatcher({ ctx, sqs, dynamo, s3, events, lambdaCtl });
+        ctx.dispatcher = dispatcher;
+        this.dispatcher = dispatcher;
+        const scheduler = new EngineScheduler({
+            ctx,
+            events,
+            invoke: dispatcher.invokeFunction.bind(dispatcher),
+        });
+        this.scheduler = scheduler;
+        // Restore the graceful-shutdown SQS message snapshot before the delivery
+        // loops start draining.
+        if (config.persistence)
+            this.restoreSqsSnapshot(config, sqs);
+        // Rearm delivery from persisted metadata: ESM loops + schedule rules
+        // survive engine restarts (PRD RF8.2).
+        await dispatcher.start(config.region);
+        await scheduler.resync(config.region);
+        store.startSweeper();
+        const handler = createEngineRequestHandler({
+            ctx,
+            emulators: [dynamo, sqs, s3, events, sns, sts, lambdaCtl],
+        });
+        const server = http.createServer(handler);
+        server.on('connection', socket => {
+            this.sockets.add(socket);
+            socket.on('close', () => this.sockets.delete(socket));
+        });
+        this.server = server;
+        await new Promise((resolve, reject) => {
+            const onError = (err) => {
+                server.removeListener('listening', onListening);
+                if (err.code === 'EADDRINUSE') {
+                    reject(new Error(`Self engine could not bind port ${config.port}: address already in use. ` +
+                        'Another process is listening there — a real LocalStack install intercepts ports ' +
+                        '4566-4599 on some hosts. Stop the conflicting process or set selfEngine.port to a free port.'));
+                }
+                else {
+                    reject(err);
+                }
+            };
+            const onListening = () => {
+                server.removeListener('error', onError);
+                resolve();
+            };
+            server.once('error', onError);
+            server.once('listening', onListening);
+            server.listen(config.port, '0.0.0.0');
+        });
+        this.boundPort = server.address().port;
+        this.running = true;
+    }
+    async stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        this.scheduler?.stop();
+        this.dispatcher?.stop();
+        const config = this.config;
+        if (config.persistence && this.sqs && this.store) {
+            try {
+                const snapshot = JSON.stringify(this.sqs.serializeMessages());
+                await fs.promises.writeFile(path.join(this.store.dir(), SQS_SNAPSHOT_FILE), snapshot);
+            }
+            catch (err) {
+                console.warn('[self-engine] failed to snapshot SQS messages:', err);
+            }
+        }
+        if (this.store) {
+            await this.store.flushAll();
+            this.store.stopSweeper();
+        }
+        const server = this.server;
+        if (server) {
+            await new Promise(resolve => {
+                server.close(() => resolve());
+                for (const socket of this.sockets)
+                    socket.destroy();
+                this.sockets.clear();
+            });
+            this.server = null;
+        }
+        this.boundPort = null;
+    }
+    isRunning() {
+        return this.running;
+    }
+    getEndpoint() {
+        return `http://localhost:${this.boundPort ?? this.resolveConfig().port}`;
+    }
+    getConfig() {
+        return {
+            endpoint: this.getEndpoint(),
+            region: this.resolveConfig().region,
+            credentials: { accessKeyId: 'test', secretAccessKey: 'test' },
+        };
+    }
+    healthDetail() {
+        const detail = {
+            port: this.boundPort ?? this.resolveConfig().port,
+            services: [...SERVICES],
+        };
+        if (this.running && this.dispatcher && this.scheduler) {
+            detail.eventSourceLoops = this.dispatcher.loopCounts();
+            detail.scheduleRules = this.scheduler.scheduleCount();
+        }
+        return detail;
+    }
+    resolveConfig() {
+        if (this.config)
+            return this.config;
+        return { ...ConfigManager.getInstance().getSelfEngineConfig(), ...this.overrides };
+    }
+    restoreSqsSnapshot(config, sqs) {
+        const file = path.join(config.dataDir, SQS_SNAPSHOT_FILE);
+        if (!fs.existsSync(file))
+            return;
+        try {
+            const snapshot = JSON.parse(fs.readFileSync(file, 'utf8'));
+            sqs.restoreMessages(snapshot);
+        }
+        catch (err) {
+            console.warn(`[self-engine] ignoring unreadable SQS snapshot ${file}:`, err);
+        }
+    }
+}
+function notReadyDispatcher() {
+    return {
+        invokeFunction: async () => ({
+            ok: false,
+            errorType: 'EngineNotReady',
+            errorMessage: 'The self engine dispatcher is not wired yet',
+        }),
+    };
+}
+//# sourceMappingURL=self-backend.js.map

package/dist/server/engine/backends/self-backend.js.map

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

package/dist/server/engine/bus.d.ts

@@ -0,0 +1,10 @@
+import type { EngineBusEvents } from './types.js';
+export declare class EngineBus {
+    private emitter;
+    constructor();
+    emit<K extends keyof EngineBusEvents>(event: K, payload: EngineBusEvents[K]): void;
+    on<K extends keyof EngineBusEvents>(event: K, listener: (payload: EngineBusEvents[K]) => void): void;
+    off<K extends keyof EngineBusEvents>(event: K, listener: (payload: EngineBusEvents[K]) => void): void;
+    removeAll(): void;
+}
+//# sourceMappingURL=bus.d.ts.map

package/dist/server/engine/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../../src/server/engine/bus.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAsB;;IAOrC,IAAI,CAAC,CAAC,SAAS,MAAM,eAAe,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IAIlF,EAAE,CAAC,CAAC,SAAS,MAAM,eAAe,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAIpG,GAAG,CAAC,CAAC,SAAS,MAAM,eAAe,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAIrG,SAAS,IAAI,IAAI;CAGlB"}

package/dist/server/engine/bus.js

@@ -0,0 +1,24 @@
+// Typed in-process event bus connecting emulators (producers) to the
+// dispatcher (consumer). A thin wrapper over EventEmitter so payloads stay
+// typed per event name and listeners never see `any`.
+import { EventEmitter } from 'events';
+export class EngineBus {
+    emitter = new EventEmitter();
+    constructor() {
+        // Delivery fan-out can register one listener per event source mapping.
+        this.emitter.setMaxListeners(1000);
+    }
+    emit(event, payload) {
+        this.emitter.emit(event, payload);
+    }
+    on(event, listener) {
+        this.emitter.on(event, listener);
+    }
+    off(event, listener) {
+        this.emitter.off(event, listener);
+    }
+    removeAll() {
+        this.emitter.removeAllListeners();
+    }
+}
+//# sourceMappingURL=bus.js.map

package/dist/server/engine/bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.js","sourceRoot":"","sources":["../../../src/server/engine/bus.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,2EAA2E;AAC3E,sDAAsD;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,MAAM,OAAO,SAAS;IACZ,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;IAErC;QACE,uEAAuE;QACvE,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,CAAkC,KAAQ,EAAE,OAA2B;QACzE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,EAAE,CAAkC,KAAQ,EAAE,QAA+C;QAC3F,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAsC,CAAC,CAAC;IACjE,CAAC;IAED,GAAG,CAAkC,KAAQ,EAAE,QAA+C;QAC5F,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAsC,CAAC,CAAC;IAClE,CAAC;IAED,SAAS;QACP,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;IACpC,CAAC;CACF"}

package/dist/server/engine/dispatch/dispatcher.d.ts

@@ -0,0 +1,46 @@
+import type { DispatcherApi, EngineContext, EngineInvokeResult } from '../types.js';
+import type { SqsEmulator } from '../emulators/sqs/index.js';
+import type { DynamoDbEmulator } from '../emulators/dynamodb/index.js';
+import type { S3Emulator } from '../emulators/s3/index.js';
+import type { EventsEmulator } from '../emulators/events/index.js';
+import type { LambdaCtlEmulator } from '../emulators/lambda-ctl/index.js';
+export interface EngineDispatcherDeps {
+    ctx: EngineContext;
+    sqs: SqsEmulator;
+    dynamo: DynamoDbEmulator;
+    s3: S3Emulator;
+    events: EventsEmulator;
+    lambdaCtl: LambdaCtlEmulator;
+    tuning?: {
+        s3RetryDelaysMs?: number[];
+        sqsRuntimeRetryBackoffMs?: number[];
+        streamRetryBackoffMs?: number;
+    };
+}
+export declare class EngineDispatcher implements DispatcherApi {
+    private readonly deps;
+    private readonly sqsPollers;
+    private readonly streamTailers;
+    private readonly warnedUnresolvable;
+    private started;
+    private stopped;
+    private syncChain;
+    private readonly s3Listener;
+    private readonly ruleListener;
+    constructor(deps: EngineDispatcherDeps);
+    start(region: string): Promise<void>;
+    stop(): void;
+    loopCounts(): {
+        sqs: number;
+        streams: number;
+    };
+    private syncEventSourceMappings;
+    invokeFunction(ref: string, event: unknown, opts?: {
+        async?: boolean;
+    }): Promise<EngineInvokeResult>;
+    private runMaybeAsync;
+    private handleS3ObjectEvent;
+    private deliverS3Notification;
+    private handleRuleMatched;
+}
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/server/engine/dispatch/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../../../src/server/engine/dispatch/dispatcher.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,kBAAkB,EAGnB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAA8B,MAAM,0BAA0B,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAO1E,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,aAAa,CAAC;IACnB,GAAG,EAAE,WAAW,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,EAAE,EAAE,UAAU,CAAC;IACf,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,iBAAiB,CAAC;IAE7B,MAAM,CAAC,EAAE;QACP,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;QACpC,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;CACH;AAMD,qBAAa,gBAAiB,YAAW,aAAa;IACpD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAe;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkB;IAChD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IAExB,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAEzB;IACF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAE3B;gBAEU,IAAI,EAAE,oBAAoB;IAsBhC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1C,IAAI,IAAI,IAAI;IAQZ,UAAU,IAAI;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;YAIhC,uBAAuB;IAa/B,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuC1G,OAAO,CAAC,aAAa;YAsBP,mBAAmB;YAcnB,qBAAqB;IAqBnC,OAAO,CAAC,iBAAiB;CAa1B"}