@ericminassian/platform 0.0.0-stage → 0.1.0

package/dist/storage.js

@@ -0,0 +1,108 @@
+import { getBindings } from './bindings.js';
+import { client } from './clients.js';
+import { span } from './telemetry.js';
+function location(name) {
+    const s = getBindings().storage;
+    if (!s?.stores.includes(name)) {
+        const declared = s?.stores ?? [];
+        throw new Error(`Unknown store "${name}". Declared storage: ${declared.length ? declared.join(', ') : '(none)'} — add it under "storage" in platform.json.`);
+    }
+    return { bucket: s.bucket, prefix: `${s.prefix}${name}/` };
+}
+/** The S3 client and command module, loaded on first use. */
+async function s3() {
+    const [c, m] = await Promise.all([client('s3'), import('@aws-sdk/client-s3')]);
+    return { c, m };
+}
+async function sign(command, expiresIn) {
+    const [{ getSignedUrl }, c] = await Promise.all([import('@aws-sdk/s3-request-presigner'), client('s3')]);
+    // biome-ignore lint/suspicious/noExplicitAny: presigner and client generics differ across smithy versions
+    return getSignedUrl(c, command, { expiresIn });
+}
+function objectKey(prefix, key) {
+    const k = key.replace(/^\/+/, '');
+    if (!k || k.split('/').some((p) => p === '..'))
+        throw new Error(`Invalid storage key "${key}"`);
+    return prefix + k;
+}
+function isNotFound(e) {
+    const name = e?.name;
+    const status = e?.$metadata?.httpStatusCode;
+    return name === 'NoSuchKey' || name === 'NotFound' || status === 404;
+}
+export function storage(name) {
+    const get = (key) => span('storage.get', name, async () => {
+        const { bucket, prefix } = location(name);
+        const { c, m } = await s3();
+        try {
+            const out = await c.send(new m.GetObjectCommand({ Bucket: bucket, Key: objectKey(prefix, key) }));
+            return out.Body ? await out.Body.transformToByteArray() : new Uint8Array();
+        }
+        catch (e) {
+            if (isNotFound(e))
+                return undefined;
+            throw e;
+        }
+    });
+    return {
+        put: (key, body, opts) => span('storage.put', name, async () => {
+            const { bucket, prefix } = location(name);
+            const { c, m } = await s3();
+            await c.send(new m.PutObjectCommand({
+                Bucket: bucket,
+                Key: objectKey(prefix, key),
+                Body: typeof body === 'string' ? Buffer.from(body) : body,
+                ...(opts?.contentType ? { ContentType: opts.contentType } : {}),
+            }));
+        }),
+        get,
+        getText: async (key) => {
+            const bytes = await get(key);
+            return bytes ? new TextDecoder().decode(bytes) : undefined;
+        },
+        delete: (key) => span('storage.delete', name, async () => {
+            const { bucket, prefix } = location(name);
+            const { c, m } = await s3();
+            await c.send(new m.DeleteObjectCommand({ Bucket: bucket, Key: objectKey(prefix, key) }));
+        }),
+        list: (sub, opts) => span('storage.list', name, async () => {
+            const { bucket, prefix } = location(name);
+            const { c, m } = await s3();
+            const out = await c.send(new m.ListObjectsV2Command({
+                Bucket: bucket,
+                Prefix: prefix + (sub ?? '').replace(/^\/+/, ''),
+                ...(opts?.cursor ? { ContinuationToken: opts.cursor } : {}),
+                ...(opts?.limit ? { MaxKeys: opts.limit } : {}),
+            }));
+            const objects = (out.Contents ?? []).map((o) => ({
+                key: (o.Key ?? '').slice(prefix.length),
+                size: o.Size ?? 0,
+                ...(o.LastModified ? { lastModified: o.LastModified } : {}),
+            }));
+            return out.NextContinuationToken ? { objects, cursor: out.NextContinuationToken } : { objects };
+        }),
+        uploadUrl: (key, opts) => span('storage.sign', name, async () => {
+            const { bucket, prefix } = location(name);
+            const { m } = await s3();
+            const cmd = new m.PutObjectCommand({
+                Bucket: bucket,
+                Key: objectKey(prefix, key),
+                ...(opts?.contentType ? { ContentType: opts.contentType } : {}),
+            });
+            return sign(cmd, opts?.expiresInSeconds ?? 900);
+        }),
+        downloadUrl: (key, opts) => span('storage.sign', name, async () => {
+            const { bucket, prefix } = location(name);
+            const { m } = await s3();
+            const cmd = new m.GetObjectCommand({
+                Bucket: bucket,
+                Key: objectKey(prefix, key),
+                ...(opts?.filename
+                    ? { ResponseContentDisposition: `attachment; filename="${opts.filename.replace(/"/g, '')}"` }
+                    : {}),
+            });
+            return sign(cmd, opts?.expiresInSeconds ?? 900);
+        }),
+    };
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

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

package/dist/telemetry.d.ts

@@ -0,0 +1,42 @@
+import { type ErrorEvent, type TelemetryEvent, type TelemetryKind } from '@ericminassian/platform-core';
+/**
+ * Telemetry writer. Every line is one core `TelemetryEvent` as JSON on stdout
+ * (Lambda ships stdout to CloudWatch Logs; the account-level subscription
+ * filter forwards `_p: 1` lines to the telemetry processor). Under `plat dev`
+ * (`PLATFORM_LOG_PRETTY=1`) lines are printed compactly for humans instead.
+ * Nothing here may ever throw into app code.
+ */
+type Sink = (event: TelemetryEvent) => void;
+/** Replace the output (tests). `null` restores stdout. */
+export declare function setTelemetrySink(s: Sink | null): void;
+type Fields<K extends TelemetryKind> = Omit<Extract<TelemetryEvent, {
+    t: K;
+}>, '_p' | 'ts' | 'app' | 'stage' | 'rev' | 't'> & {
+    ts?: number;
+};
+export declare function emit<K extends TelemetryKind>(t: K, fields: Fields<K>): void;
+/** Time `fn` as a span (`db.get`, `queue.send`, ...) under the current trace. */
+export declare function span<T>(op: string, name: string | undefined, fn: () => Promise<T>): Promise<T>;
+/** Emit an `err` event for a thrown value. */
+export declare function emitError(err: unknown, source: ErrorEvent['source'], extra?: {
+    route?: string;
+    job?: string;
+}): void;
+export declare function toError(err: unknown): Error;
+export declare const metrics: {
+    count(name: string, n?: number): void;
+    value(name: string, value: number, unit?: string): void;
+};
+export declare const log: {
+    debug: (msg: string, fields?: Record<string, unknown>) => void;
+    info: (msg: string, fields?: Record<string, unknown>) => void;
+    warn: (msg: string, fields?: Record<string, unknown>) => void;
+    error: (msg: string, fields?: Record<string, unknown> | unknown) => void;
+};
+/** Route console.* through telemetry so app logs carry the trace id. */
+export declare function installConsoleCapture(): void;
+/** Record outgoing `fetch` calls as spans (method + host only; no URLs with secrets). */
+export declare function installFetchInstrumentation(): void;
+/** Undo console/fetch patching (tests). */
+export declare function uninstallInstrumentation(): void;
+export {};

package/dist/telemetry.js

@@ -0,0 +1,218 @@
+import { format } from 'node:util';
+import { errorFingerprint, newSpanId, } from '@ericminassian/platform-core';
+import { tryBindings } from './bindings.js';
+import { currentContext } from './context.js';
+// Captured before console is patched so telemetry never recurses through it.
+const rawWrite = process.stdout.write.bind(process.stdout);
+let sink = null;
+/** Replace the output (tests). `null` restores stdout. */
+export function setTelemetrySink(s) {
+    sink = s;
+}
+export function emit(t, fields) {
+    try {
+        const b = tryBindings();
+        const ctx = currentContext();
+        const event = {
+            _p: 1,
+            t,
+            ts: Date.now(),
+            app: b?.app ?? process.env.PLATFORM_APP ?? 'unknown',
+            stage: b?.stage ?? process.env.PLATFORM_STAGE ?? 'unknown',
+            rev: b?.revision ?? 'unknown',
+            ...(ctx ? { trace: ctx.trace } : {}),
+            ...fields,
+        };
+        if (sink)
+            sink(event);
+        else
+            rawWrite(`${process.env.PLATFORM_LOG_PRETTY === '1' ? pretty(event) : JSON.stringify(event)}\n`);
+    }
+    catch {
+        // never throw from telemetry
+    }
+}
+/** Time `fn` as a span (`db.get`, `queue.send`, ...) under the current trace. */
+export async function span(op, name, fn) {
+    const t0 = performance.now();
+    const ctx = currentContext();
+    const id = newSpanId();
+    let status = 'ok';
+    try {
+        return await fn();
+    }
+    catch (e) {
+        status = 'error';
+        throw e;
+    }
+    finally {
+        // Spans only matter as part of a trace; skip them outside a request/job.
+        if (ctx)
+            emit('span', {
+                op,
+                ...(name ? { name } : {}),
+                dur: round(performance.now() - t0),
+                status,
+                span: id,
+                parent: ctx.span,
+                start: round(t0 - ctx.startedAt),
+            });
+    }
+}
+/** Emit an `err` event for a thrown value. */
+export function emitError(err, source, extra = {}) {
+    const e = toError(err);
+    emit('err', {
+        source,
+        name: e.name,
+        message: e.message,
+        ...(e.stack ? { stack: e.stack } : {}),
+        ...extra,
+        fingerprint: errorFingerprint(e.name, e.message, e.stack),
+    });
+}
+export function toError(err) {
+    if (err instanceof Error)
+        return err;
+    return new Error(typeof err === 'string' ? err : safeStringify(err));
+}
+// ---------------------------------------------------------------- metrics & log
+export const metrics = {
+    count(name, n = 1) {
+        emit('metric', { name, value: n, unit: 'count' });
+    },
+    value(name, value, unit) {
+        emit('metric', { name, value, ...(unit ? { unit } : {}) });
+    },
+};
+function logAt(level, msg, fields) {
+    if (level === 'error' &&
+        (fields instanceof Error || (fields && typeof fields === 'object' && 'stack' in fields))) {
+        const e = toError(fields);
+        emit('log', { level, msg, error: { name: e.name, message: e.message, stack: e.stack } });
+        emitError(e, 'log', jobOrRoute());
+        return;
+    }
+    const extra = fields && typeof fields === 'object'
+        ? fields
+        : fields === undefined
+            ? {}
+            : { value: fields };
+    emit('log', { ...extra, level, msg });
+}
+export const log = {
+    debug: (msg, fields) => logAt('debug', msg, fields),
+    info: (msg, fields) => logAt('info', msg, fields),
+    warn: (msg, fields) => logAt('warn', msg, fields),
+    error: (msg, fields) => logAt('error', msg, fields),
+};
+function jobOrRoute() {
+    const ctx = currentContext();
+    if (!ctx)
+        return {};
+    return { ...(ctx.route ? { route: ctx.route } : {}), ...(ctx.job ? { job: ctx.job } : {}) };
+}
+// ---------------------------------------------------------------- console capture
+let consolePatched = false;
+const originalConsole = {};
+/** Route console.* through telemetry so app logs carry the trace id. */
+export function installConsoleCapture() {
+    if (consolePatched)
+        return;
+    consolePatched = true;
+    const map = [
+        ['log', 'info'],
+        ['info', 'info'],
+        ['debug', 'debug'],
+        ['warn', 'warn'],
+        ['error', 'error'],
+    ];
+    for (const [method, level] of map) {
+        originalConsole[method] = console[method];
+        console[method] = (...args) => {
+            emit('log', { level, msg: format(...args) });
+        };
+    }
+}
+// ---------------------------------------------------------------- fetch spans
+let fetchPatched = false;
+let originalFetch;
+/** Record outgoing `fetch` calls as spans (method + host only; no URLs with secrets). */
+export function installFetchInstrumentation() {
+    if (fetchPatched || typeof globalThis.fetch !== 'function')
+        return;
+    fetchPatched = true;
+    originalFetch = globalThis.fetch;
+    const original = globalThis.fetch.bind(globalThis);
+    globalThis.fetch = (async (input, init) => {
+        if (!currentContext())
+            return original(input, init);
+        let name = 'fetch';
+        try {
+            const url = new URL(typeof input === 'string' || input instanceof URL ? input : input.url);
+            const method = init?.method ?? (input instanceof Request ? input.method : 'GET');
+            name = `${method.toUpperCase()} ${url.host}`;
+        }
+        catch { }
+        return span('fetch', name, () => original(input, init));
+    });
+}
+/** Undo console/fetch patching (tests). */
+export function uninstallInstrumentation() {
+    if (consolePatched) {
+        for (const [k, v] of Object.entries(originalConsole))
+            console[k] = v;
+        consolePatched = false;
+    }
+    if (fetchPatched && originalFetch) {
+        globalThis.fetch = originalFetch;
+        fetchPatched = false;
+    }
+}
+// ---------------------------------------------------------------- pretty printing
+const COLORS = {
+    dim: '\x1b[2m',
+    red: '\x1b[31m',
+    yellow: '\x1b[33m',
+    green: '\x1b[32m',
+    cyan: '\x1b[36m',
+    reset: '\x1b[0m',
+};
+function pretty(e) {
+    const time = new Date(e.ts).toISOString().slice(11, 23);
+    const c = (color, s) => `${COLORS[color]}${s}${COLORS.reset}`;
+    switch (e.t) {
+        case 'req': {
+            const color = e.status >= 500 ? 'red' : e.status >= 400 ? 'yellow' : 'green';
+            return `${c('dim', time)} ${c(color, String(e.status))} ${e.method} ${e.path} ${c('dim', `${e.dur}ms${e.cold ? ' cold' : ''}`)}`;
+        }
+        case 'err':
+            return `${c('dim', time)} ${c('red', `✖ ${e.name}: ${e.message}`)}${e.stack ? `\n${c('dim', e.stack.split('\n').slice(1, 6).join('\n'))}` : ''}`;
+        case 'job':
+            return `${c('dim', time)} ${c(e.status === 'ok' ? 'cyan' : 'red', `${e.kind}:${e.name}`)} ${e.status} ${c('dim', `${e.dur}ms`)}`;
+        case 'span':
+            return `${c('dim', `${time}   ↳ ${e.op}${e.name ? ` ${e.name}` : ''} ${e.dur}ms${e.status === 'error' ? ' error' : ''}`)}`;
+        case 'log': {
+            const { _p, t, ts, app, stage, rev, trace, span: _s, parent, level, msg, ...rest } = e;
+            const extra = Object.keys(rest).length ? ` ${c('dim', safeStringify(rest))}` : '';
+            const color = level === 'error' ? 'red' : level === 'warn' ? 'yellow' : 'reset';
+            return `${c('dim', time)} ${c(color, msg)}${extra}`;
+        }
+        case 'metric':
+            return `${c('dim', `${time} metric ${e.name}=${e.value}${e.unit ? ` ${e.unit}` : ''}`)}`;
+        case 'env':
+            return `${c('dim', `${time} ${e.runtime} ${e.event}${e.initMs !== undefined ? ` (${e.initMs}ms)` : ''}`)}`;
+    }
+}
+function round(ms) {
+    return Math.round(ms * 10) / 10;
+}
+function safeStringify(v) {
+    try {
+        return JSON.stringify(v);
+    }
+    catch {
+        return String(v);
+    }
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

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

package/dist/testing.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Test helpers for apps and the SDK itself.
+ *
+ *   import { useTestBindings, captureTelemetry } from '@ericminassian/platform/testing';
+ *
+ * For tests against real (emulated) resources use `plat test`, which starts
+ * the AWS Emulator, provisions the app and sets PLATFORM_BINDINGS for vitest.
+ */
+import type { Bindings, TelemetryEvent } from '@ericminassian/platform-core';
+import { type SendClient } from './clients.ts';
+export type { SendClient } from './clients.ts';
+export { createPlatformFetch } from './server.ts';
+export { createWorkerHandler } from './worker.ts';
+/** Complete bindings with sensible test defaults. */
+export declare function testBindings(overrides?: Partial<Bindings>): Bindings;
+/** Install bindings for the current test process (returns them). */
+export declare function useTestBindings(overrides?: Partial<Bindings>): Bindings;
+/** Replace an AWS client with a fake `{ send(command) }`. */
+export declare function mockClient(name: 'ddb' | 'sqs' | 'events' | 's3' | 'ssm' | 'lambda' | 'cognito', send: (command: {
+    constructor: {
+        name: string;
+    };
+    input: Record<string, unknown>;
+}) => unknown): SendClient;
+/** Collect telemetry events instead of writing them to stdout. Call `stop()` to restore. */
+export declare function captureTelemetry(): {
+    events: TelemetryEvent[];
+    stop(): void;
+};
+/** Reset all SDK module state (bindings, clients, caches, telemetry sink). */
+export declare function resetPlatform(): void;

package/dist/testing.js

@@ -0,0 +1,54 @@
+import { setBindings } from './bindings.js';
+import { resetClients, setClient } from './clients.js';
+import { clearSecretsCache } from './secrets.js';
+import { setTelemetrySink, uninstallInstrumentation } from './telemetry.js';
+export { createPlatformFetch } from './server.js';
+export { createWorkerHandler } from './worker.js';
+/** Complete bindings with sensible test defaults. */
+export function testBindings(overrides = {}) {
+    return {
+        v: 1,
+        app: 'test-app',
+        stage: 'test',
+        host: 'test-app.localhost',
+        url: 'http://test-app.localhost:3000',
+        revision: 'dtest',
+        region: 'us-east-1',
+        queues: {},
+        secrets: {
+            path: '/platform/apps/test-app/test/secrets/',
+            sharedPath: '/platform/apps/test-app/_shared/secrets/',
+            names: [],
+        },
+        ...overrides,
+    };
+}
+/** Install bindings for the current test process (returns them). */
+export function useTestBindings(overrides = {}) {
+    const b = testBindings(overrides);
+    setBindings(b);
+    return b;
+}
+/** Replace an AWS client with a fake `{ send(command) }`. */
+export function mockClient(name, send) {
+    const fake = {
+        send: async (command) => send(command),
+    };
+    setClient(name, fake);
+    return fake;
+}
+/** Collect telemetry events instead of writing them to stdout. Call `stop()` to restore. */
+export function captureTelemetry() {
+    const events = [];
+    setTelemetrySink((e) => events.push(e));
+    return { events, stop: () => setTelemetrySink(null) };
+}
+/** Reset all SDK module state (bindings, clients, caches, telemetry sink). */
+export function resetPlatform() {
+    setBindings(undefined);
+    resetClients();
+    clearSecretsCache();
+    setTelemetrySink(null);
+    uninstallInstrumentation();
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAmB,SAAS,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAG5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,qDAAqD;AACrD,MAAM,UAAU,YAAY,CAAC,SAAS,GAAsB,EAAE;IAC5D,OAAO;QACL,CAAC,EAAE,CAAC;QACJ,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,oBAAoB;QAC1B,GAAG,EAAE,gCAAgC;QACrC,QAAQ,EAAE,OAAO;QACjB,MAAM,EAAE,WAAW;QACnB,MAAM,EAAE,EAAE;QACV,OAAO,EAAE;YACP,IAAI,EAAE,uCAAuC;YAC7C,UAAU,EAAE,0CAA0C;YACtD,KAAK,EAAE,EAAE;SACV;QACD,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,eAAe,CAAC,SAAS,GAAsB,EAAE;IAC/D,MAAM,CAAC,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IAClC,WAAW,CAAC,CAAC,CAAC,CAAC;IACf,OAAO,CAAC,CAAC;AACX,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,UAAU,CACxB,IAAoE,EACpE,IAA6F;IAE7F,MAAM,IAAI,GAAe;QACvB,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CACtB,IAAI,CAAC,OAA4E,CAAC;KACrF,CAAC;IACF,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,gBAAgB;IAC9B,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,gBAAgB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;AACxD,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,aAAa;IAC3B,WAAW,CAAC,SAAS,CAAC,CAAC;IACvB,YAAY,EAAE,CAAC;IACf,iBAAiB,EAAE,CAAC;IACpB,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACvB,wBAAwB,EAAE,CAAC;AAC7B,CAAC"}

package/dist/worker.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Worker (Lambda Event Function) entry. Apps write:
+ *
+ *   export default defineWorker({
+ *     queues: { emails: async (msg) => { ... } },
+ *     events: { 'order.created': async (evt) => { ... } },
+ *     crons: { nightly: async () => { ... } },
+ *   });
+ *
+ * `plat build` generates `export const handler = createWorkerHandler(def)`.
+ * One function per stage handles every queue, event subscription, cron and
+ * direct invocation; the handler dispatches on the event shape. Each job is
+ * auto-instrumented (`job`/`err` telemetry, trace propagation from the
+ * producer). SQS batches report partial failures.
+ *
+ * CONTRACT: used by the CLI build and the control plane. Keep stable.
+ */
+export interface JobContext {
+    /** Trace id propagated from whoever enqueued/published/invoked this job. */
+    trace: string;
+    attempt: number;
+    /** Remaining Lambda time in ms. */
+    remainingMs(): number;
+}
+export interface QueueMessage<T = unknown> {
+    id: string;
+    body: T;
+    attempt: number;
+    sentAt: Date;
+}
+export interface PlatformEvent<T = unknown> {
+    id: string;
+    type: string;
+    detail: T;
+    time: Date;
+}
+/** Decoded CloudWatch Logs subscription payload (system use: telemetry processor). */
+export interface LogsBatch {
+    logGroup: string;
+    logStream: string;
+    logEvents: Array<{
+        id: string;
+        timestamp: number;
+        message: string;
+    }>;
+}
+type AnyPayload = any;
+export interface WorkerDefinition {
+    queues?: Record<string, (message: QueueMessage<AnyPayload>, ctx: JobContext) => unknown | Promise<unknown>>;
+    events?: Record<string, (event: PlatformEvent<AnyPayload>, ctx: JobContext) => unknown | Promise<unknown>>;
+    crons?: Record<string, (ctx: JobContext) => unknown | Promise<unknown>>;
+    /** Direct invocations by name, e.g. the control plane's `deploy`. Return value is the invoke result. */
+    invoke?: Record<string, (payload: AnyPayload, ctx: JobContext) => unknown | Promise<unknown>>;
+    /** CloudWatch Logs subscription deliveries (system use). */
+    logs?: (batch: LogsBatch, ctx: JobContext) => unknown | Promise<unknown>;
+}
+/** Payload shapes the platform sends to the worker besides SQS/EventBridge records. */
+export type DirectPayload = {
+    __platform: 'cron';
+    name: string;
+    trace?: string;
+} | {
+    __platform: 'invoke';
+    name: string;
+    payload: unknown;
+    trace?: string;
+};
+export declare function defineWorker<T extends WorkerDefinition>(def: T): T;
+/** Lambda handler for a worker definition. */
+export declare function createWorkerHandler(def: WorkerDefinition): (event: unknown, context: unknown) => Promise<unknown>;
+/** Invoke another named job on this stage's worker asynchronously. */
+export declare function invokeJob(name: string, payload: unknown): Promise<void>;
+export {};