@ericminassian/plat 0.0.0-stage → 0.2.0

package/dist/dev/proc.js

@@ -0,0 +1,16 @@
+/**
+ * Dev children are spawned `detached` so each leads its own process group:
+ * `shell: true` commands (`pnpm --dir web dev` → pnpm → vite) and `tsx watch`
+ * fork grandchildren that a plain `child.kill()` leaves running.
+ */
+export function killTree(child, signal = 'SIGTERM') {
+    if (child.exitCode !== null || child.signalCode !== null || !child.pid)
+        return;
+    try {
+        process.kill(-child.pid, signal);
+    }
+    catch {
+        child.kill(signal);
+    }
+}
+//# sourceMappingURL=proc.js.map

package/dist/dev/proc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proc.js","sourceRoot":"","sources":["../../src/dev/proc.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAmB,EAAE,MAAM,GAAmB,SAAS;IAC9E,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG;QAAE,OAAO;IAC/E,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/dev/router.d.ts

@@ -0,0 +1,67 @@
+import { type IncomingMessage, type Server, type ServerResponse } from 'node:http';
+import { type RouteRecord } from '@ericminassian/platform-core';
+/**
+ * `plat dev`'s stand-in for the CloudFront router: the same `decide()` the
+ * edge function runs, against a local route record. Server routes go to the
+ * local web server; static routes go to the frontend dev server (original URL,
+ * so it can do HMR and its own SPA fallback) or to files in `web.static`.
+ */
+export interface Target {
+    host: string;
+    port: number;
+}
+export interface LocalRouterState {
+    record: RouteRecord;
+    server?: Target;
+    webDev?: Target;
+    /** A frontend dev server is configured but not accepting connections yet. */
+    webDevStarting?: boolean;
+    staticDir?: string;
+}
+export type LocalDecision = {
+    kind: 'server';
+    target: Target;
+} | {
+    kind: 'webdev';
+    target: Target;
+} | {
+    kind: 'file';
+    path: string;
+} | {
+    kind: 'unavailable';
+    reason: string;
+} | {
+    kind: 'notfound';
+};
+/** Pure routing decision, shared by the router and tests. */
+export declare function localDecision(state: LocalRouterState, uri: string): LocalDecision;
+/** Local route record for an app (mirrors what the engine writes to the KVS). */
+export declare function localRouteRecord(opts: {
+    app: string;
+    stage: string;
+    deploymentId: string;
+    hasServer: boolean;
+    hasStatic: boolean;
+    serverRoutes: string[];
+    spa: boolean;
+}): RouteRecord;
+export type Interceptor = (req: IncomingMessage, res: ServerResponse, url: URL) => Promise<boolean> | boolean;
+export interface LocalRouterOptions {
+    port: number;
+    host?: string;
+    state: () => LocalRouterState;
+    /** Handled before routing (local sign-in, dev endpoints). Return true when handled. */
+    intercept?: Interceptor[];
+    onRequest?: (line: {
+        method: string;
+        url: string;
+        status: number;
+        ms: number;
+        kind: string;
+    }) => void;
+}
+export declare function startLocalRouter(opts: LocalRouterOptions): Promise<Server>;
+/** Headers the edge would add, so apps see their public host. */
+export declare function forwardedHeaders(req: IncomingMessage, toServer: boolean): Record<string, string | string[] | undefined>;
+/** Join without escaping `root` (path traversal). */
+export declare function safeJoin(root: string, rel: string): string | null;

package/dist/dev/router.js

@@ -0,0 +1,184 @@
+import { createReadStream, existsSync, statSync } from 'node:fs';
+import { createServer, request as httpRequest, } from 'node:http';
+import { connect } from 'node:net';
+import { extname, join, normalize, sep } from 'node:path';
+import { decide, HOST_HEADER } from '@ericminassian/platform-core';
+/** Pure routing decision, shared by the router and tests. */
+export function localDecision(state, uri) {
+    const pathname = uri.split('?')[0] ?? '/';
+    const d = decide(state.record, pathname);
+    if (d.t === 'notfound')
+        return { kind: 'notfound' };
+    if (d.t === 'server') {
+        return state.server
+            ? { kind: 'server', target: state.server }
+            : { kind: 'unavailable', reason: 'the web server is starting' };
+    }
+    if (state.webDev)
+        return { kind: 'webdev', target: state.webDev };
+    if (state.webDevStarting)
+        return { kind: 'unavailable', reason: 'the frontend dev server is starting' };
+    if (!state.staticDir)
+        return { kind: 'unavailable', reason: 'no frontend: set web.static or web.dev in plat.config.ts' };
+    const prefix = `/${state.record.s ?? ''}`;
+    const rel = d.key.startsWith(prefix) ? d.key.slice(prefix.length) : d.key;
+    const file = safeJoin(state.staticDir, decodeURIComponent(rel));
+    return file ? { kind: 'file', path: file } : { kind: 'notfound' };
+}
+/** Local route record for an app (mirrors what the engine writes to the KVS). */
+export function localRouteRecord(opts) {
+    return {
+        v: 1,
+        app: opts.app,
+        stage: opts.stage,
+        d: opts.deploymentId,
+        ...(opts.hasServer ? { o: 'local-server' } : {}),
+        ...(opts.hasStatic ? { s: 'local' } : {}),
+        ...(opts.hasServer && opts.hasStatic ? { r: opts.serverRoutes } : {}),
+        spa: opts.spa ? 1 : 0,
+    };
+}
+export function startLocalRouter(opts) {
+    const server = createServer(async (req, res) => {
+        const started = Date.now();
+        const url = new URL(req.url ?? '/', `http://${req.headers.host ?? 'localhost'}`);
+        let kind = 'intercept';
+        res.once('finish', () => opts.onRequest?.({
+            method: req.method ?? 'GET',
+            url: req.url ?? '/',
+            status: res.statusCode,
+            ms: Date.now() - started,
+            kind,
+        }));
+        try {
+            for (const fn of opts.intercept ?? [])
+                if (await fn(req, res, url))
+                    return;
+            const d = localDecision(opts.state(), req.url ?? '/');
+            kind = d.kind;
+            switch (d.kind) {
+                case 'server':
+                    return proxy(req, res, d.target, true);
+                case 'webdev':
+                    return proxy(req, res, d.target, false);
+                case 'file':
+                    return serveFile(res, d.path);
+                case 'unavailable':
+                    return text(res, 503, `${d.reason}\n`);
+                case 'notfound':
+                    return text(res, 404, 'Not found\n');
+            }
+        }
+        catch (err) {
+            if (!res.headersSent)
+                text(res, 502, `plat dev router error: ${err.message}\n`);
+            else
+                res.destroy();
+        }
+    });
+    server.on('upgrade', (req, socket, head) => {
+        const d = localDecision(opts.state(), req.url ?? '/');
+        // Web Functions don't do WebSockets; only the frontend dev server (HMR) gets upgrades.
+        if (d.kind !== 'webdev') {
+            socket.end('HTTP/1.1 501 Not Implemented\r\n\r\n');
+            return;
+        }
+        tunnel(req, socket, head, d.target);
+    });
+    return new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(opts.port, opts.host ?? '127.0.0.1', () => resolve(server));
+    });
+}
+/** Headers the edge would add, so apps see their public host. */
+export function forwardedHeaders(req, toServer) {
+    const headers = { ...req.headers };
+    const host = req.headers.host ?? 'localhost';
+    if (toServer) {
+        headers[HOST_HEADER] = host;
+        headers['x-forwarded-host'] = host;
+        headers['x-forwarded-proto'] = 'http';
+    }
+    return headers;
+}
+function proxy(req, res, target, toServer) {
+    return new Promise((resolve) => {
+        const upstream = httpRequest({
+            host: target.host,
+            port: target.port,
+            method: req.method,
+            path: req.url,
+            headers: forwardedHeaders(req, toServer),
+        }, (up) => {
+            res.writeHead(up.statusCode ?? 502, up.statusMessage, up.headers);
+            up.pipe(res);
+            up.once('end', resolve);
+        });
+        upstream.once('error', (err) => {
+            if (!res.headersSent)
+                text(res, 502, `upstream ${target.host}:${target.port} unavailable: ${err.message}\n`);
+            resolve();
+        });
+        req.pipe(upstream);
+    });
+}
+function tunnel(req, socket, head, target) {
+    const up = connect(target.port, target.host, () => {
+        const lines = [`${req.method} ${req.url} HTTP/${req.httpVersion}`];
+        for (let i = 0; i < req.rawHeaders.length; i += 2)
+            lines.push(`${req.rawHeaders[i]}: ${req.rawHeaders[i + 1]}`);
+        up.write(`${lines.join('\r\n')}\r\n\r\n`);
+        if (head.length)
+            up.write(head);
+        up.pipe(socket);
+        socket.pipe(up);
+    });
+    const close = () => {
+        up.destroy();
+        socket.destroy();
+    };
+    up.once('error', close);
+    socket.once('error', close);
+}
+const MIME = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.mjs': 'text/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.json': 'application/json',
+    '.map': 'application/json',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.ico': 'image/x-icon',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.txt': 'text/plain; charset=utf-8',
+    '.wasm': 'application/wasm',
+    '.webmanifest': 'application/manifest+json',
+};
+function serveFile(res, path) {
+    if (!existsSync(path) || !statSync(path).isFile()) {
+        text(res, 404, 'Not found\n');
+        return;
+    }
+    res.writeHead(200, {
+        'content-type': MIME[extname(path)] ?? 'application/octet-stream',
+        'cache-control': 'no-cache',
+    });
+    createReadStream(path).pipe(res);
+}
+function text(res, status, body) {
+    res.writeHead(status, { 'content-type': 'text/plain; charset=utf-8' });
+    res.end(body);
+}
+/** Join without escaping `root` (path traversal). */
+export function safeJoin(root, rel) {
+    const full = normalize(join(root, rel));
+    const base = normalize(root.endsWith(sep) ? root : root + sep);
+    return full === normalize(root) || full.startsWith(base) ? full : null;
+}
+//# sourceMappingURL=router.js.map

package/dist/dev/router.js.map

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

package/dist/dev/server-entry.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/dev/server-entry.js

@@ -0,0 +1,28 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+// Entry for the local web server under `plat dev` (run with `tsx watch`, so
+// edits to the app restart it). Loads the app's fetch handler and starts it
+// with the SDK server wrapper — the same wrapper the Web Function runs — using
+// the app's own copy of the SDK so app code and wrapper share state.
+import { pathToFileURL } from 'node:url';
+const entry = process.env.PLATFORM_ENTRY;
+const sdkServer = process.env.PLATFORM_SDK_SERVER ?? '@ericminassian/platform/server';
+if (!entry) {
+    console.error('PLATFORM_ENTRY is not set (this file is started by `plat dev`)');
+    process.exit(1);
+}
+const mod = (await import(__rewriteRelativeImportExtension(pathToFileURL(entry).href)));
+if (!mod.default) {
+    console.error(`${entry} has no default export; export your app (e.g. \`export default app\`)`);
+    process.exit(1);
+}
+const sdkUrl = sdkServer.startsWith('/') ? pathToFileURL(sdkServer).href : sdkServer;
+const { startServer } = (await import(__rewriteRelativeImportExtension(sdkUrl)));
+await startServer(mod.default);
+//# sourceMappingURL=server-entry.js.map

package/dist/dev/server-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-entry.js","sourceRoot":"","sources":["../../src/dev/server-entry.ts"],"names":[],"mappings":";;;;;;;;AAAA,4EAA4E;AAC5E,4EAA4E;AAC5E,+EAA+E;AAC/E,qEAAqE;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;AACzC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,gCAAgC,CAAC;AACtF,IAAI,CAAC,KAAK,EAAE,CAAC;IACX,OAAO,CAAC,KAAK,CAAC,gEAAgE,CAAC,CAAC;IAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,kCAAC,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,EAAC,CAA0B,CAAC;AAC/E,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACjB,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,uEAAuE,CAAC,CAAC;IAC/F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AACD,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACrF,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,MAAM,kCAAC,MAAM,EAAC,CAAoD,CAAC;AAClG,MAAM,WAAW,CAAC,GAAG,CAAC,OAA4C,CAAC,CAAC"}

package/dist/dev/test.d.ts

@@ -0,0 +1,10 @@
+export declare const INTEGRATION_CONFIG = "vitest.integration.config.ts";
+/**
+ * `plat test`: a throwaway emulator with this app's resources (stage `test`),
+ * then vitest with the same environment the deployed code gets. Uses
+ * `vitest.integration.config.ts` when present.
+ */
+export declare function runTests(opts: {
+    cwd: string;
+    args: string[];
+}): Promise<number>;

package/dist/dev/test.js

@@ -0,0 +1,62 @@
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { EMULATOR_INSTALL_HINT } from '@ericminassian/platform-engine';
+import { withLocalBin } from '../build.js';
+import { loadProject } from '../project.js';
+import { CliError, step, success } from '../util/output.js';
+import { localEnv, startLocalStage } from './local-stage.js';
+import { startLocalWorker, startWorkerDispatch } from './worker.js';
+export const INTEGRATION_CONFIG = 'vitest.integration.config.ts';
+/**
+ * `plat test`: a throwaway emulator with this app's resources (stage `test`),
+ * then vitest with the same environment the deployed code gets. Uses
+ * `vitest.integration.config.ts` when present.
+ */
+export async function runTests(opts) {
+    const { root, manifest } = await loadProject(opts.cwd);
+    step('starting the AWS Emulator');
+    let stage;
+    try {
+        stage = await startLocalStage({ root, manifest, stage: 'test', port: 3999 });
+    }
+    catch (err) {
+        if (err.message === EMULATOR_INSTALL_HINT)
+            throw new CliError('the AWS Emulator is not installed', { hint: EMULATOR_INSTALL_HINT });
+        throw err;
+    }
+    success(`provisioned ${manifest.name} (stage test)`);
+    let worker;
+    let dispatcher;
+    try {
+        if (manifest.worker) {
+            worker = await startLocalWorker(stage, manifest, root, { watch: false });
+            worker.child.stdout?.pipe(process.stdout);
+            worker.child.stderr?.pipe(process.stderr);
+            dispatcher = await startWorkerDispatch(stage, manifest, worker);
+        }
+        const args = ['run'];
+        if (existsSync(join(root, INTEGRATION_CONFIG)) && !opts.args.includes('--config'))
+            args.push('--config', INTEGRATION_CONFIG);
+        args.push(...opts.args);
+        return await new Promise((resolve, reject) => {
+            const child = spawn('vitest', args, {
+                cwd: root,
+                stdio: 'inherit',
+                shell: process.platform === 'win32',
+                env: withLocalBin(root, localEnv(stage, manifest, {
+                    PLATFORM_TEST: '1',
+                    ...(worker ? { PLATFORM_LOCAL_WORKER_URL: `http://127.0.0.1:${worker.port}/` } : {}),
+                })),
+            });
+            child.once('exit', (code) => resolve(code ?? 1));
+            child.once('error', (err) => reject(new CliError(`could not run vitest: ${err.message}`, { hint: 'add vitest to devDependencies' })));
+        });
+    }
+    finally {
+        dispatcher?.stop();
+        worker?.stop();
+        await stage.stop();
+    }
+}
+//# sourceMappingURL=test.js.map

package/dist/dev/test.js.map

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

package/dist/dev/worker-host.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/dev/worker-host.js

@@ -0,0 +1,67 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+// Local worker host for `plat dev` / `plat test`. The AWS Emulator's Lambda
+// runtime is an embedded JS sandbox without node:http/https/net/async_hooks,
+// so a worker that talks to AWS (through the SDK) can't run inside it. This
+// process runs the worker in real Node instead: it builds the same handler the
+// Lambda would (`createWorkerHandler(def)` from the app's SDK) and accepts
+// Lambda-shaped events over a loopback HTTP endpoint. The CLI feeds it SQS
+// messages, EventBridge events and crons from the emulator.
+import { randomUUID } from 'node:crypto';
+import { createServer } from 'node:http';
+import { pathToFileURL } from 'node:url';
+const entry = process.env.PLATFORM_WORKER_ENTRY;
+const sdkWorker = process.env.PLATFORM_SDK_WORKER ?? '@ericminassian/platform/worker';
+const port = Number(process.env.PLATFORM_WORKER_PORT);
+const timeoutMs = Number(process.env.PLATFORM_WORKER_TIMEOUT_MS ?? 60_000);
+const functionName = process.env.PLATFORM_WORKER_FUNCTION ?? 'local-worker';
+if (!entry || !port) {
+    console.error('PLATFORM_WORKER_ENTRY / PLATFORM_WORKER_PORT not set (this file is started by `plat dev`)');
+    process.exit(1);
+}
+const mod = (await import(__rewriteRelativeImportExtension(pathToFileURL(entry).href)));
+if (!mod.default) {
+    console.error(`${entry} has no default export; export your worker (\`export default defineWorker({...})\`)`);
+    process.exit(1);
+}
+const sdkUrl = sdkWorker.startsWith('/') ? pathToFileURL(sdkWorker).href : sdkWorker;
+const { createWorkerHandler } = (await import(__rewriteRelativeImportExtension(sdkUrl)));
+const handler = createWorkerHandler(mod.default);
+createServer((req, res) => {
+    let body = '';
+    req.setEncoding('utf8');
+    req.on('data', (c) => (body += c));
+    req.on('end', async () => {
+        const started = Date.now();
+        const context = {
+            awsRequestId: randomUUID(),
+            functionName,
+            functionVersion: '$LATEST',
+            invokedFunctionArn: `arn:aws:lambda:${process.env.AWS_REGION ?? 'us-east-1'}:000000000000:function:${functionName}`,
+            memoryLimitInMB: '512',
+            logGroupName: `/aws/lambda/${functionName}`,
+            logStreamName: 'local',
+            callbackWaitsForEmptyEventLoop: false,
+            getRemainingTimeInMillis: () => Math.max(0, started + timeoutMs - Date.now()),
+        };
+        let reply;
+        try {
+            reply = { ok: true, result: (await handler(JSON.parse(body || '{}'), context)) ?? null };
+        }
+        catch (err) {
+            const e = err;
+            reply = {
+                ok: false,
+                error: { name: e?.name ?? 'Error', message: e?.message ?? String(err), stack: e?.stack },
+            };
+        }
+        res.writeHead(200, { 'content-type': 'application/json' }).end(JSON.stringify(reply));
+    });
+}).listen(port, '127.0.0.1');
+//# sourceMappingURL=worker-host.js.map

package/dist/dev/worker-host.js.map

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

package/dist/dev/worker.d.ts

@@ -0,0 +1,57 @@
+import { type ChildProcess } from 'node:child_process';
+import { type Message } from '@aws-sdk/client-sqs';
+import { type ResolvedManifest } from '@ericminassian/platform-core';
+import { type LocalStage } from './local-stage.ts';
+/**
+ * Local worker: the app's worker in a real Node process (see worker-host.ts
+ * for why), fed by a dispatcher that does what Lambda's event sources would:
+ * polls each SQS queue (batches, partial failures, retries via visibility
+ * timeout, DLQ via the queue's redrive policy), receives EventBridge events
+ * through a tap queue, and runs crons on demand.
+ */
+export interface InvokeResult {
+    ok: boolean;
+    result?: unknown;
+    error?: {
+        name: string;
+        message: string;
+        stack?: string;
+    };
+}
+export interface LocalWorker {
+    port: number;
+    child: ChildProcess;
+    invoke(event: unknown): Promise<InvokeResult>;
+    stop(): void;
+}
+export declare function startLocalWorker(stage: LocalStage, manifest: ResolvedManifest, root: string, opts?: {
+    watch?: boolean;
+}): Promise<LocalWorker>;
+export type DispatchLog = (kind: 'queue' | 'event' | 'cron', name: string, outcome: 'ok' | 'error', detail?: string) => void;
+export interface Dispatcher {
+    runCron(name: string): Promise<InvokeResult>;
+    stop(): void;
+}
+export declare function startWorkerDispatch(stage: LocalStage, manifest: ResolvedManifest, worker: Pick<LocalWorker, 'invoke'>, log?: DispatchLog): Promise<Dispatcher>;
+/** Lambda's SQS event shape. */
+export declare function sqsEvent(messages: Message[], queueArn: string, region: string): {
+    Records: {
+        messageId: string | undefined;
+        receiptHandle: string | undefined;
+        body: string;
+        attributes: Partial<Record<import("@aws-sdk/client-sqs").MessageSystemAttributeName, string>>;
+        messageAttributes: {
+            [k: string]: {
+                stringValue: string | undefined;
+                binaryValue: Uint8Array<ArrayBufferLike> | undefined;
+                dataType: string | undefined;
+                stringListValues: never[];
+                binaryListValues: never[];
+            };
+        };
+        md5OfBody: string | undefined;
+        eventSource: string;
+        eventSourceARN: string;
+        awsRegion: string;
+    }[];
+};