local-serverless-stack 0.5.0 → 0.8.0

package/dist/server/engine/dispatch/dispatcher.js

@@ -0,0 +1,312 @@
+// The self engine's dispatcher: the single place events leave the emulators
+// and enter Lambda code. Resolution order for a function ref (PRD RF4.5):
+//   1. FunctionRegistry → LambdaRuntimeManager.invoke() in-process (the LSS
+//      native runtime — no HTTP hop);
+//   2. engine-absorbed function metadata with an INVOKE_URL env → HTTP POST in
+//      the AWS Invoke shape (serverless-offline holdouts keep working);
+//   3. a failed EngineInvokeResult (never a throw) + one warn per function.
+// Also owns the bus consumers: S3 notification fan-out and EventBridge
+// rule-matched target delivery, plus the SQS/stream delivery loop sets.
+import http from 'http';
+import { randomUUID } from 'crypto';
+import { SqsPollerSet } from './sqs-poller.js';
+import { StreamTailerSet } from './stream-tailer.js';
+import { resolveTargetInput } from './scheduler.js';
+import { FunctionRegistry } from '../../services/function-registry.js';
+import { LambdaRuntimeManager } from '../../services/lambda-runtime-manager.js';
+const DEFAULT_S3_RETRY_DELAYS_MS = [1000, 3000];
+const INVOKE_URL_TIMEOUT_MS = 30_000;
+const LAMBDA_ARN_REGION = /^arn:aws:lambda:([^:]+):/;
+export class EngineDispatcher {
+    deps;
+    sqsPollers;
+    streamTailers;
+    warnedUnresolvable = new Set();
+    started = false;
+    stopped = false;
+    // Serializes ESM re-syncs triggered by lambda-ctl catalog changes.
+    syncChain = Promise.resolve();
+    s3Listener = (event) => {
+        void this.handleS3ObjectEvent(event);
+    };
+    ruleListener = (event) => {
+        this.handleRuleMatched(event);
+    };
+    constructor(deps) {
+        this.deps = deps;
+        const invoke = this.invokeFunction.bind(this);
+        this.sqsPollers = new SqsPollerSet({
+            ctx: deps.ctx,
+            sqs: deps.sqs,
+            lambdaCtl: deps.lambdaCtl,
+            invoke,
+            runtimeRetryBackoffMs: deps.tuning?.sqsRuntimeRetryBackoffMs,
+        });
+        this.streamTailers = new StreamTailerSet({
+            ctx: deps.ctx,
+            dynamo: deps.dynamo,
+            sqs: deps.sqs,
+            lambdaCtl: deps.lambdaCtl,
+            invoke,
+            retryBackoffMs: deps.tuning?.streamRetryBackoffMs,
+        });
+    }
+    // Boot rearm: loads the catalogs the sync loop APIs read, syncs delivery
+    // loops from persisted ESMs and subscribes the bus consumers.
+    async start(region) {
+        if (this.started)
+            return;
+        this.started = true;
+        await this.syncEventSourceMappings(region);
+        this.deps.lambdaCtl.onEsmChanged(changedRegion => {
+            this.syncChain = this.syncChain
+                .then(() => this.syncEventSourceMappings(changedRegion))
+                .catch(err => console.warn('[engine-dispatcher] ESM re-sync failed:', err));
+        });
+        this.deps.ctx.bus.on('s3:object-event', this.s3Listener);
+        this.deps.ctx.bus.on('events:rule-matched', this.ruleListener);
+    }
+    stop() {
+        this.stopped = true;
+        this.sqsPollers.stopAll();
+        this.streamTailers.stopAll();
+        this.deps.ctx.bus.off('s3:object-event', this.s3Listener);
+        this.deps.ctx.bus.off('events:rule-matched', this.ruleListener);
+    }
+    loopCounts() {
+        return { sqs: this.sqsPollers.loopCount(), streams: this.streamTailers.tailerCount() };
+    }
+    async syncEventSourceMappings(region) {
+        // The loop sets read sync emulator APIs, which only see loaded catalogs.
+        await this.deps.lambdaCtl.ensureLoaded(region);
+        await this.deps.sqs.ensureRegionLoaded(region);
+        await this.deps.dynamo.primeRegion(region);
+        this.sqsPollers.sync(region);
+        this.streamTailers.sync(region);
+    }
+    // -------------------------------------------------------------------------
+    // DispatcherApi
+    // -------------------------------------------------------------------------
+    async invokeFunction(ref, event, opts) {
+        // 1. LSS-native runtime, in-process.
+        const registered = FunctionRegistry.getInstance().resolve(ref);
+        if (registered) {
+            const run = async () => {
+                const result = await LambdaRuntimeManager.getInstance().invoke(registered.service.name, registered.fn, event);
+                return result.ok
+                    ? { ok: true, payload: result.payload }
+                    : { ok: false, errorType: result.errorType, errorMessage: result.errorMessage };
+            };
+            return this.runMaybeAsync(ref, run, opts);
+        }
+        // 2. Engine-absorbed proxy metadata with a stored INVOKE_URL.
+        const arnRegion = LAMBDA_ARN_REGION.exec(ref)?.[1];
+        const record = this.deps.lambdaCtl.getFunctionRecord(arnRegion ?? this.deps.ctx.config.region, ref);
+        const invokeUrl = record?.environment.INVOKE_URL;
+        if (record && invokeUrl) {
+            const name = record.environment.FUNCTION_NAME || record.functionName;
+            return this.runMaybeAsync(ref, () => httpInvoke(invokeUrl, name, event), opts);
+        }
+        // 3. Nowhere to deliver.
+        if (!this.warnedUnresolvable.has(ref)) {
+            this.warnedUnresolvable.add(ref);
+            console.warn(`[engine-dispatcher] function "${ref}" is not resolvable: not in the LSS runtime registry and ` +
+                'no engine-registered function with an INVOKE_URL — events for it are dropped');
+        }
+        return {
+            ok: false,
+            errorType: 'FunctionNotResolvable',
+            errorMessage: `Function "${ref}" could not be resolved to an LSS runtime or an INVOKE_URL fallback`,
+        };
+    }
+    // Fire-and-forget for async invocations: resolution already happened, so
+    // callers get an immediate ok; execution failures are only logged.
+    runMaybeAsync(ref, run, opts) {
+        if (!opts?.async)
+            return run();
+        void run()
+            .then(result => {
+            if (!result.ok) {
+                console.warn(`[engine-dispatcher] async invoke of "${ref}" failed: ${result.errorType ?? 'Error'}: ${result.errorMessage ?? ''}`);
+            }
+        })
+            .catch(err => console.warn(`[engine-dispatcher] async invoke of "${ref}" crashed:`, err));
+        return Promise.resolve({ ok: true });
+    }
+    // -------------------------------------------------------------------------
+    // S3 notifications (PRD RF5.2)
+    // -------------------------------------------------------------------------
+    async handleS3ObjectEvent(event) {
+        let configs;
+        try {
+            configs = await this.deps.s3.getNotificationConfiguration(event.bucket);
+        }
+        catch (err) {
+            console.warn(`[engine-dispatcher] notification lookup for bucket ${event.bucket} failed:`, err);
+            return;
+        }
+        for (const config of configs) {
+            if (!s3EventMatches(config, event))
+                continue;
+            void this.deliverS3Notification(config, event);
+        }
+    }
+    async deliverS3Notification(config, event) {
+        const payload = buildS3NotificationPayload(config, event);
+        const delays = this.deps.tuning?.s3RetryDelaysMs ?? DEFAULT_S3_RETRY_DELAYS_MS;
+        let result = await this.invokeFunction(config.lambdaFunctionArn, payload);
+        for (let retry = 0; !result.ok && retry < delays.length && !this.stopped; retry++) {
+            await sleep(delays[retry]);
+            if (this.stopped)
+                return;
+            result = await this.invokeFunction(config.lambdaFunctionArn, payload);
+        }
+        if (!result.ok) {
+            console.warn(`[engine-dispatcher] S3 notification ${config.id} for s3://${event.bucket}/${event.key} dropped ` +
+                `after ${delays.length + 1} attempts: ${result.errorType ?? 'Error'}: ${result.errorMessage ?? ''}`);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // EventBridge targets (PRD RF6.2)
+    // -------------------------------------------------------------------------
+    handleRuleMatched(event) {
+        for (const target of event.targets) {
+            const payload = resolveTargetInput(target, event.event);
+            void this.invokeFunction(target.arn, payload, { async: true }).then(result => {
+                if (!result.ok) {
+                    console.warn(`[engine-dispatcher] rule ${event.ruleName}: target ${target.id} (${target.arn}) failed: ` +
+                        `${result.errorType ?? 'Error'}: ${result.errorMessage ?? ''}`);
+                }
+            });
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// S3 notification helpers
+// ---------------------------------------------------------------------------
+// Config events are exact names ("s3:ObjectCreated:Put") or globs
+// ("s3:ObjectCreated:*"); filter rules are prefix/suffix on the raw key.
+function s3EventMatches(config, event) {
+    const eventOk = config.events.some(pattern => pattern.endsWith('*') ? event.eventName.startsWith(pattern.slice(0, -1)) : event.eventName === pattern);
+    if (!eventOk)
+        return false;
+    for (const rule of config.filterRules) {
+        if (rule.name === 'prefix' && !event.key.startsWith(rule.value))
+            return false;
+        if (rule.name === 'suffix' && !event.key.endsWith(rule.value))
+            return false;
+    }
+    return true;
+}
+// AWS URL-encodes the object key in notification records, but keeps '/'.
+function encodeS3Key(key) {
+    return encodeURIComponent(key).replace(/%2F/gi, '/');
+}
+function buildS3NotificationPayload(config, event) {
+    const requestId = randomUUID().replace(/-/g, '').slice(0, 16).toUpperCase();
+    return {
+        Records: [
+            {
+                eventVersion: '2.1',
+                eventSource: 'aws:s3',
+                awsRegion: event.region,
+                eventTime: new Date().toISOString(),
+                // Record eventName drops the "s3:" prefix the config carries.
+                eventName: event.eventName.replace(/^s3:/, ''),
+                userIdentity: { principalId: 'AWS:SELFENGINE' },
+                requestParameters: { sourceIPAddress: '127.0.0.1' },
+                responseElements: {
+                    'x-amz-request-id': requestId,
+                    'x-amz-id-2': Buffer.from(requestId).toString('base64'),
+                },
+                s3: {
+                    s3SchemaVersion: '1.0',
+                    configurationId: config.id,
+                    bucket: {
+                        name: event.bucket,
+                        ownerIdentity: { principalId: 'SELFENGINE' },
+                        arn: `arn:aws:s3:::${event.bucket}`,
+                    },
+                    object: {
+                        key: encodeS3Key(event.key),
+                        size: event.size,
+                        eTag: event.eTag,
+                        sequencer: event.sequencer,
+                    },
+                },
+            },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// INVOKE_URL HTTP fallback (absorbed LocalStack proxies / serverless-offline)
+// ---------------------------------------------------------------------------
+function httpInvoke(invokeUrl, functionName, event) {
+    return new Promise(resolve => {
+        let url;
+        try {
+            url = new URL(`${invokeUrl.replace(/\/$/, '')}/2015-03-31/functions/${functionName}/invocations`);
+        }
+        catch (err) {
+            resolve({
+                ok: false,
+                errorType: 'InvocationFailed',
+                errorMessage: `Invalid INVOKE_URL "${invokeUrl}": ${err instanceof Error ? err.message : String(err)}`,
+            });
+            return;
+        }
+        const body = JSON.stringify(event ?? {});
+        const request = http.request({
+            hostname: url.hostname,
+            port: url.port,
+            path: url.pathname,
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Length': Buffer.byteLength(body),
+                'X-Amz-Invocation-Type': 'RequestResponse',
+            },
+            timeout: INVOKE_URL_TIMEOUT_MS,
+        }, response => {
+            const chunks = [];
+            response.on('data', chunk => chunks.push(chunk));
+            response.on('end', () => {
+                const text = Buffer.concat(chunks).toString('utf8');
+                const status = response.statusCode ?? 0;
+                if (status < 200 || status >= 300) {
+                    resolve({
+                        ok: false,
+                        errorType: 'InvocationFailed',
+                        errorMessage: `POST ${url.href} returned ${status}: ${text.slice(0, 200)}`,
+                    });
+                    return;
+                }
+                let payload = text;
+                try {
+                    payload = text.length > 0 ? JSON.parse(text) : undefined;
+                }
+                catch {
+                    // Non-JSON body: hand it over verbatim.
+                }
+                resolve({ ok: true, payload });
+            });
+            response.on('error', err => {
+                resolve({ ok: false, errorType: 'InvocationFailed', errorMessage: err.message });
+            });
+        });
+        request.on('timeout', () => {
+            request.destroy(new Error(`invoke timed out after ${INVOKE_URL_TIMEOUT_MS} ms`));
+        });
+        request.on('error', err => {
+            resolve({ ok: false, errorType: 'InvocationFailed', errorMessage: `POST ${url.href} failed: ${err.message}` });
+        });
+        request.end(body);
+    });
+}
+function sleep(ms) {
+    return new Promise(resolve => {
+        const timer = setTimeout(resolve, ms);
+        timer.unref();
+    });
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/server/engine/dispatch/dispatcher.js.map

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

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

@@ -0,0 +1,47 @@
+import type { EngineContext, EngineInvokeResult, EventRuleTarget } from '../types.js';
+import type { EventsEmulator } from '../emulators/events/index.js';
+export declare function resolveTargetInput(target: EventRuleTarget, envelope: Record<string, unknown>): unknown;
+interface CronField {
+    kind: 'any' | 'question' | 'set';
+    values?: Set<number>;
+}
+export type ParsedSchedule = {
+    kind: 'rate';
+    intervalMs: number;
+} | {
+    kind: 'cron';
+    minute: CronField;
+    hour: CronField;
+    dayOfMonth: CronField;
+    month: CronField;
+    dayOfWeek: CronField;
+    year: CronField;
+};
+export declare function parseScheduleExpression(expression: string): ParsedSchedule | undefined;
+export declare function nextFireAt(schedule: ParsedSchedule, fromMs: number): number | undefined;
+export interface EngineSchedulerDeps {
+    ctx: EngineContext;
+    events: EventsEmulator;
+    invoke: (ref: string, event: unknown, opts?: {
+        async?: boolean;
+    }) => Promise<EngineInvokeResult>;
+}
+export declare class EngineScheduler {
+    private readonly deps;
+    private entries;
+    private timer;
+    private stopped;
+    private readonly warnedUnsupported;
+    private resyncChain;
+    constructor(deps: EngineSchedulerDeps);
+    resync(region: string): Promise<void>;
+    stop(): void;
+    scheduleCount(): number;
+    private doResync;
+    private arm;
+    private clearTimer;
+    private fireDue;
+    private deliver;
+}
+export {};
+//# sourceMappingURL=scheduler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../../../src/server/engine/dispatch/scheduler.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAUnE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAWtG;AAkBD,UAAU,SAAS;IACjB,IAAI,EAAE,KAAK,GAAG,UAAU,GAAG,KAAK,CAAC;IACjC,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACtB;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAuBzI,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CA6BtF;AA4DD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWvF;AA+BD,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,aAAa,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAClG;AAWD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsB;IAC3C,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAqB;IAEvD,OAAO,CAAC,WAAW,CAAoC;gBAE3C,IAAI,EAAE,mBAAmB;IASrC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrC,IAAI,IAAI,IAAI;IAOZ,aAAa,IAAI,MAAM;YAIT,QAAQ;IAkCtB,OAAO,CAAC,GAAG;IAWX,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,OAAO;IAgBf,OAAO,CAAC,OAAO;CA6BhB"}