@ericminassian/plat 0.0.0-stage → 0.1.0

package/dist/dev/entries.js

@@ -0,0 +1,21 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** Path to tsx's CLI (it has no `./cli` export, so go through its package.json). */
+export function tsxCli() {
+    const pkg = createRequire(import.meta.url).resolve('tsx/package.json');
+    const bin = JSON.parse(readFileSync(pkg, 'utf8')).bin;
+    const rel = typeof bin === 'string' ? bin : (bin.tsx ?? Object.values(bin)[0]);
+    return join(dirname(pkg), rel);
+}
+/** A CLI-owned entry file next to this module (`.ts` in the repo, `.js` when published). */
+export function devEntry(name) {
+    const ts = fileURLToPath(new URL(`./${name}.ts`, import.meta.url));
+    return existsSync(ts) ? ts : fileURLToPath(new URL(`./${name}.js`, import.meta.url));
+}
+/** argv for running an entry under tsx, optionally restarting on edits. */
+export function tsxArgs(name, watch) {
+    return watch ? [tsxCli(), 'watch', '--clear-screen=false', devEntry(name)] : [tsxCli(), devEntry(name)];
+}
+//# sourceMappingURL=entries.js.map

package/dist/dev/entries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entries.js","sourceRoot":"","sources":["../../src/dev/entries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,oFAAoF;AACpF,MAAM,UAAU,MAAM;IACpB,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACvE,MAAM,GAAG,GAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAA8C,CAAC,GAAG,CAAC;IACpG,MAAM,GAAG,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;IAChF,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,QAAQ,CAAC,IAAoC;IAC3D,MAAM,EAAE,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,KAAK,IAAI,KAAK,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACnE,OAAO,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,KAAK,IAAI,KAAK,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACvF,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,OAAO,CAAC,IAAoC,EAAE,KAAc;IAC1E,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1G,CAAC"}

package/dist/dev/index.d.ts

@@ -0,0 +1,33 @@
+import { type ChildProcess } from 'node:child_process';
+import { type ResolvedManifest } from '@ericminassian/platform-core';
+import { type LocalStage } from './local-stage.ts';
+export interface DevOptions {
+    cwd: string;
+    port: number;
+    /** Print SDK trace spans too. */
+    spans?: boolean;
+}
+export declare const DEV_CONTROL_PREFIX = "/__plat_dev/";
+/**
+ * `plat dev`: the whole app locally against the AWS Emulator.
+ *
+ *  emulator ← engine (same code as prod; `webMode: 'external'`)
+ *  web server (SDK wrapper, tsx watch) ─┐
+ *  frontend dev server (web.dev) ───────┼─ local router (core `decide()`)
+ *  local sign-in page ──────────────────┘
+ *  worker (real Node, tsx watch) ← dispatcher (emulator SQS + EventBridge tap + local crons)
+ */
+export declare function runDev(opts: DevOptions): Promise<void>;
+/**
+ * The app's server exactly as the Web Function runs it (SDK wrapper, bindings,
+ * `AWS_LAMBDA_HTTP_ENDPOINT`), under `tsx watch` so edits restart it.
+ */
+export declare function spawnWebServer(stage: LocalStage, manifest: ResolvedManifest, root: string, opts?: {
+    watch?: boolean;
+    workerUrl?: string;
+}): Promise<{
+    child: ChildProcess;
+    port: number;
+}>;
+/** `plat dev run-cron <name>`: ask a running `plat dev` to fire a cron now. */
+export declare function runCronOnDev(name: string, port: number): Promise<void>;

package/dist/dev/index.js

@@ -0,0 +1,262 @@
+import { spawn } from 'node:child_process';
+import { resolve } from 'node:path';
+import { LOCAL_STAGE } from '@ericminassian/platform-core';
+import { EMULATOR_INSTALL_HINT } from '@ericminassian/platform-engine';
+import pc from 'picocolors';
+import { SDK_SERVER, withLocalBin } from '../build.js';
+import { loadProject, resolveFromApp } from '../project.js';
+import { freePort, waitForPort } from '../util/net.js';
+import { CliError, info, step, success, warn } from '../util/output.js';
+import { scheduleCrons } from './crons.js';
+import { tsxArgs } from './entries.js';
+import { localEnv, startLocalStage } from './local-stage.js';
+import { prefixer } from './pretty.js';
+import { killTree } from './proc.js';
+import { localRouteRecord, startLocalRouter } from './router.js';
+import { startLocalWorker, startWorkerDispatch } from './worker.js';
+export const DEV_CONTROL_PREFIX = '/__plat_dev/';
+/**
+ * `plat dev`: the whole app locally against the AWS Emulator.
+ *
+ *  emulator ← engine (same code as prod; `webMode: 'external'`)
+ *  web server (SDK wrapper, tsx watch) ─┐
+ *  frontend dev server (web.dev) ───────┼─ local router (core `decide()`)
+ *  local sign-in page ──────────────────┘
+ *  worker (real Node, tsx watch) ← dispatcher (emulator SQS + EventBridge tap + local crons)
+ */
+export async function runDev(opts) {
+    const { root, manifest } = loadProject(opts.cwd);
+    const children = [];
+    const cleanups = [];
+    let stage;
+    let router;
+    let shuttingDown = false;
+    const shutdown = async (code = 0) => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        info(pc.dim('\nstopping…'));
+        for (const fn of cleanups)
+            await fn();
+        for (const c of children)
+            killTree(c);
+        router?.close();
+        await stage?.stop();
+        process.exit(code);
+    };
+    process.once('SIGINT', () => void shutdown(0));
+    process.once('SIGTERM', () => void shutdown(0));
+    try {
+        step('starting the AWS Emulator');
+        stage = await startLocalStage({
+            root,
+            manifest,
+            stage: LOCAL_STAGE,
+            port: opts.port,
+            log: (e) => {
+                if (e.level !== 'info' || process.env.PLAT_DEV_VERBOSE)
+                    info(pc.dim(`  engine ${e.level}: ${e.msg}`));
+            },
+        });
+    }
+    catch (err) {
+        await stage?.stop();
+        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.result.resources.length} resources) in the emulator`);
+    const state = {
+        record: localRouteRecord({
+            app: manifest.name,
+            stage: LOCAL_STAGE,
+            deploymentId: stage.deploymentId,
+            hasServer: !!manifest.web?.server,
+            hasStatic: !!(manifest.web?.static || manifest.web?.dev),
+            serverRoutes: manifest.web?.serverRoutes ?? ['/api/'],
+            spa: manifest.web?.spa ?? true,
+        }),
+        ...(manifest.web?.static ? { staticDir: resolve(root, manifest.web.static) } : {}),
+    };
+    // ------------------------------------------------------------ worker
+    let dispatcher;
+    let workerPort;
+    if (manifest.worker) {
+        const worker = await startLocalWorker(stage, manifest, root);
+        workerPort = worker.port;
+        children.push(worker.child);
+        const out = prefixer(pc.yellow('worker│'), (s) => process.stdout.write(s), { spans: opts.spans });
+        worker.child.stdout.on('data', out);
+        worker.child.stderr.on('data', out);
+        dispatcher = await startWorkerDispatch(stage, manifest, worker, (kind, name, outcome, detail) => {
+            if (outcome === 'error')
+                warn(`${kind} ${name} failed${detail ? `: ${detail}` : ''}`);
+        });
+        cleanups.push(() => dispatcher?.stop());
+    }
+    const runCron = async (name) => {
+        if (!dispatcher)
+            throw new CliError('this app has no worker');
+        if (!manifest.crons[name]) {
+            throw new CliError(`no cron named ${name}`, {
+                hint: `crons: ${Object.keys(manifest.crons).join(', ') || '(none)'}`,
+            });
+        }
+        info(`${pc.magenta('cron  │')} running ${name}`);
+        const r = await dispatcher.runCron(name);
+        if (!r.ok)
+            throw new CliError(`cron ${name} failed: ${r.error?.message}`);
+    };
+    const crons = dispatcher
+        ? scheduleCrons(Object.entries(manifest.crons).map(([name, c]) => ({ name, ...c })), (name) => runCron(name).catch((err) => warn(err.message)))
+        : undefined;
+    if (crons)
+        cleanups.push(() => crons.stop());
+    // ------------------------------------------------------------ web server
+    if (manifest.web?.server) {
+        const { child, port: serverPort } = await spawnWebServer(stage, manifest, root, {
+            ...(workerPort ? { workerUrl: `http://127.0.0.1:${workerPort}/` } : {}),
+        });
+        children.push(child);
+        const out = prefixer(pc.green('web   │'), (s) => process.stdout.write(s), { spans: opts.spans });
+        child.stdout.on('data', out);
+        child.stderr.on('data', out);
+        child.once('exit', (code) => {
+            if (!shuttingDown)
+                warn(`web server exited (code ${code})`);
+        });
+        void waitForPort(serverPort, '127.0.0.1', 60_000)
+            .then(() => {
+            state.server = { host: '127.0.0.1', port: serverPort };
+        })
+            .catch((err) => warn(`web server did not start: ${err.message}`));
+    }
+    // ------------------------------------------------------------ frontend dev server
+    if (manifest.web?.dev) {
+        const { command, port } = manifest.web.dev;
+        const child = spawn(command, {
+            cwd: root,
+            shell: true,
+            detached: true,
+            env: withLocalBin(root, { ...process.env, PLATFORM_DEV_ROUTER: `http://localhost:${opts.port}` }),
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        children.push(child);
+        const out = prefixer(pc.blue('front │'), (s) => process.stdout.write(s));
+        child.stdout.on('data', out);
+        child.stderr.on('data', out);
+        state.webDevStarting = true;
+        // Dev servers often bind `localhost` (::1 on many systems); connect the same way.
+        void waitForPort(port, 'localhost', 60_000)
+            .then(() => {
+            state.webDev = { host: 'localhost', port };
+        })
+            .catch((err) => warn(`frontend dev server did not start: ${err.message}`))
+            .finally(() => {
+            state.webDevStarting = false;
+        });
+    }
+    // ------------------------------------------------------------ router
+    const intercept = [
+        async (req, res, url) => {
+            if (!url.pathname.startsWith(DEV_CONTROL_PREFIX))
+                return false;
+            const cron = /^\/__plat_dev\/cron\/([^/]+)$/.exec(url.pathname);
+            if (cron && req.method === 'POST') {
+                try {
+                    await runCron(decodeURIComponent(cron[1]));
+                    res.writeHead(200, { 'content-type': 'application/json' }).end(JSON.stringify({ ok: true }));
+                }
+                catch (err) {
+                    res
+                        .writeHead(400, { 'content-type': 'application/json' })
+                        .end(JSON.stringify({ error: err.message }));
+                }
+                return true;
+            }
+            if (url.pathname === `${DEV_CONTROL_PREFIX}status`) {
+                res
+                    .writeHead(200, { 'content-type': 'application/json' })
+                    .end(JSON.stringify({ app: manifest.name, bindings: stage.bindings, emulator: stage.conn.endpoint }));
+                return true;
+            }
+            res.writeHead(404).end();
+            return true;
+        },
+    ];
+    // Local sign-in (`/__platform/auth/*`) is served by the SDK's server wrapper in local mode.
+    router = await startLocalRouter({ port: opts.port, host: '127.0.0.1', state: () => state, intercept });
+    printBanner(manifest, stage, opts.port, crons);
+    await new Promise(() => { }); // run until signalled
+}
+/**
+ * The app's server exactly as the Web Function runs it (SDK wrapper, bindings,
+ * `AWS_LAMBDA_HTTP_ENDPOINT`), under `tsx watch` so edits restart it.
+ */
+export async function spawnWebServer(stage, manifest, root, opts = {}) {
+    if (!manifest.web?.server)
+        throw new Error('manifest has no web.server');
+    const port = await freePort();
+    const env = localEnv(stage, manifest, {
+        AWS_LAMBDA_HTTP_ENDPOINT: `127.0.0.1:${port}`,
+        PLATFORM_LOG_PRETTY: '1',
+        PLATFORM_ENTRY: resolve(root, manifest.web.server),
+        PLATFORM_SDK_SERVER: resolveFromApp(root, SDK_SERVER),
+        // `invokeJob` locally: the SDK posts here instead of invoking the emulator's sandboxed Lambda.
+        ...(opts.workerUrl ? { PLATFORM_LOCAL_WORKER_URL: opts.workerUrl } : {}),
+    });
+    const child = spawn(process.execPath, tsxArgs('server-entry', opts.watch !== false), {
+        cwd: root,
+        env,
+        detached: true,
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    return { child, port };
+}
+function printBanner(manifest, stage, port, crons) {
+    const b = stage.bindings;
+    const lines = [
+        '',
+        `  ${pc.bold(manifest.name)} ${pc.dim('running locally on the AWS Emulator')}`,
+        '',
+        `  ${pc.green('➜')} App:       ${pc.underline(`http://${manifest.name}.localhost:${port}`)}  ${pc.dim(`(or http://localhost:${port})`)}`,
+        `  ${pc.dim('➜')} Emulator:  ${stage.conn.endpoint}`,
+    ];
+    if (b.table)
+        lines.push(`  ${pc.dim('➜')} Database:  ${b.table}`);
+    const queues = Object.keys(b.queues);
+    if (queues.length)
+        lines.push(`  ${pc.dim('➜')} Queues:    ${queues.join(', ')}`);
+    if (manifest.events.length)
+        lines.push(`  ${pc.dim('➜')} Events:    ${manifest.events.join(', ')}`);
+    if (b.storage)
+        lines.push(`  ${pc.dim('➜')} Storage:   ${b.storage.stores.join(', ')}`);
+    if (b.auth)
+        lines.push(`  ${pc.dim('➜')} Auth:      local sign-in at /__platform/auth/login (any email)`);
+    for (const name of Object.keys(manifest.crons)) {
+        const next = crons?.next(name);
+        lines.push(`  ${pc.dim('➜')} Cron:      ${name} ${pc.dim(`next ${next?.toISOString() ?? '?'} · now: plat dev run-cron ${name}`)}`);
+    }
+    lines.push('', pc.dim('  Ctrl+C to stop. Emulator state lives in memory and is discarded on exit.'), '');
+    info(lines.join('\n'));
+}
+/** `plat dev run-cron <name>`: ask a running `plat dev` to fire a cron now. */
+export async function runCronOnDev(name, port) {
+    let res;
+    try {
+        res = await fetch(`http://127.0.0.1:${port}${DEV_CONTROL_PREFIX}cron/${encodeURIComponent(name)}`, {
+            method: 'POST',
+        });
+    }
+    catch {
+        throw new CliError(`no \`plat dev\` running on port ${port}`, {
+            hint: 'start it with `plat dev` (or pass --port)',
+        });
+    }
+    if (!res.ok) {
+        const body = (await res.json().catch(() => ({})));
+        throw new CliError(body.error ?? `HTTP ${res.status}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/dev/index.js.map

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

package/dist/dev/local-stage.d.ts

@@ -0,0 +1,46 @@
+import { Agent } from 'node:https';
+import { type Bindings, type PlatformRuntimeConfig, type ResolvedManifest } from '@ericminassian/platform-core';
+import { type DeployStageResult, type EmulatorConnection, type Engine, type EngineLogEntry, type S3Location } from '@ericminassian/platform-engine';
+/**
+ * A stage running inside a private AWS Emulator: shared platform resources
+ * (`ensureLocalPlatform`) plus this app's resources, created by the same
+ * engine that deploys to AWS. The web server runs outside the emulator
+ * (`webMode: 'external'`) because the emulator doesn't serve Web Function
+ * endpoints yet.
+ */
+export interface LocalStage {
+    conn: EmulatorConnection;
+    engine: Engine;
+    platform: PlatformRuntimeConfig;
+    result: DeployStageResult;
+    bindings: Bindings;
+    deploymentId: string;
+    stage: string;
+    stop(): Promise<void>;
+}
+export interface StartLocalStageOptions {
+    root: string;
+    manifest: ResolvedManifest;
+    stage: 'local' | 'test';
+    /** Public port of the local router (used in URLs, auth redirects). */
+    port: number;
+    log?: (e: EngineLogEntry) => void;
+    onEmulatorLog?: (line: string) => void;
+}
+export declare function startLocalStage(opts: StartLocalStageOptions): Promise<LocalStage>;
+export declare function uploadWorker(engine: Engine, platform: PlatformRuntimeConfig, root: string, manifest: ResolvedManifest, stage: string, deploymentId: string): Promise<S3Location>;
+/** Environment for the local web server, worker tests and `plat test`. */
+export declare function localEnv(stage: LocalStage, manifest: ResolvedManifest, extra?: Record<string, string>): NodeJS.ProcessEnv;
+/** AWS SDK client config for talking to the emulator from the CLI process itself. */
+export declare function emulatorClientConfig(conn: EmulatorConnection): {
+    region: string;
+    endpoint: string;
+    credentials: {
+        accessKeyId: string;
+        secretAccessKey: string;
+    };
+    requestHandler: {
+        httpsAgent: Agent;
+    };
+};
+export declare function readDotEnv(path: string): Record<string, string>;

package/dist/dev/local-stage.js

@@ -0,0 +1,116 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { Agent } from 'node:https';
+import { join } from 'node:path';
+import { PutParameterCommand, SSMClient } from '@aws-sdk/client-ssm';
+import { encodeBindings, names, newDeploymentId, } from '@ericminassian/platform-core';
+import { createEngine, emulatorChildEnv, ensureLocalPlatform, startEmulator, } from '@ericminassian/platform-engine';
+import { bundleWorker, zipBundle } from '../build.js';
+import { CliError } from '../util/output.js';
+export async function startLocalStage(opts) {
+    const conn = await startEmulator({ port: 0, idleTimeoutSeconds: 6 * 3600, onLog: opts.onEmulatorLog });
+    try {
+        const engine = createEngine({
+            region: conn.region,
+            emulator: { endpoint: conn.endpoint, caFile: conn.caFile, credentials: conn.credentials },
+            log: opts.log,
+        });
+        const platform = await ensureLocalPlatform(engine, { port: opts.port, jwksBaseUrl: conn.endpoint });
+        const deploymentId = newDeploymentId();
+        const worker = opts.manifest.worker
+            ? await uploadWorker(engine, platform, opts.root, opts.manifest, opts.stage, deploymentId)
+            : undefined;
+        const result = await engine.deployStage({
+            manifest: opts.manifest,
+            stage: opts.stage,
+            deploymentId,
+            platform,
+            artifacts: worker ? { worker } : {},
+            webMode: 'external',
+            logRetentionDays: 1,
+        });
+        await seedSecrets(conn, result.bindings, opts.root);
+        return {
+            conn,
+            engine,
+            platform,
+            result,
+            bindings: result.bindings,
+            deploymentId,
+            stage: opts.stage,
+            stop: () => conn.stop(),
+        };
+    }
+    catch (err) {
+        await conn.stop();
+        throw err;
+    }
+}
+export async function uploadWorker(engine, platform, root, manifest, stage, deploymentId) {
+    const dir = await bundleWorker(root, manifest, join(root, '.plat', stage, 'worker'), { minify: false });
+    const zip = zipBundle(dir);
+    return engine.putArtifact(platform, names.artifactKey(manifest.name, stage, deploymentId, 'worker.zip'), zip);
+}
+/** Environment for the local web server, worker tests and `plat test`. */
+export function localEnv(stage, manifest, extra = {}) {
+    return {
+        ...emulatorChildEnv(stage.conn),
+        ...manifest.env,
+        PLATFORM_BINDINGS: encodeBindings(stage.bindings),
+        PLATFORM_LOCAL: '1',
+        ...extra,
+    };
+}
+/** AWS SDK client config for talking to the emulator from the CLI process itself. */
+export function emulatorClientConfig(conn) {
+    return {
+        region: conn.region,
+        endpoint: conn.endpoint,
+        credentials: conn.credentials,
+        requestHandler: { httpsAgent: new Agent({ ca: readFileSync(conn.caFile), keepAlive: true }) },
+    };
+}
+/**
+ * `.env.local` (KEY=VALUE, not committed) → SecureString parameters, so
+ * `secrets.get()` works locally exactly as deployed. Only names declared in
+ * platform.json are loaded.
+ */
+async function seedSecrets(conn, bindings, root) {
+    const values = readDotEnv(join(root, '.env.local'));
+    const declared = new Set(bindings.secrets.names);
+    const entries = Object.entries(values).filter(([k]) => declared.has(k));
+    if (entries.length === 0)
+        return;
+    const ssm = new SSMClient(emulatorClientConfig(conn));
+    try {
+        for (const [name, value] of entries) {
+            await ssm.send(new PutParameterCommand({
+                Name: `${bindings.secrets.path}${name}`,
+                Value: value,
+                Type: 'SecureString',
+                Overwrite: true,
+            }));
+        }
+    }
+    catch (err) {
+        throw new CliError(`could not load .env.local secrets into the emulator: ${err.message}`);
+    }
+    finally {
+        ssm.destroy();
+    }
+}
+export function readDotEnv(path) {
+    if (!existsSync(path))
+        return {};
+    const out = {};
+    for (const line of readFileSync(path, 'utf8').split(/\r?\n/)) {
+        const m = /^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)\s*$/.exec(line);
+        if (!m)
+            continue;
+        let v = m[2];
+        if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'")))
+            v = v.slice(1, -1);
+        out[m[1]] = v;
+    }
+    return out;
+}
+//# sourceMappingURL=local-stage.js.map

package/dist/dev/local-stage.js.map

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

package/dist/dev/pretty.d.ts

@@ -0,0 +1,16 @@
+import { type TelemetryEvent } from '@ericminassian/platform-core';
+/**
+ * Human formatting for telemetry lines (`{"_p":1,...}`) printed by the SDK in
+ * the local web server and worker. Non-telemetry lines pass through as-is.
+ * Returns null for lines that are noise locally (spans, Lambda START/END).
+ */
+export declare function prettyLine(line: string, opts?: {
+    spans?: boolean;
+}): string | null;
+export declare function formatEvent(e: TelemetryEvent, opts?: {
+    spans?: boolean;
+}): string | null;
+/** Prefix every line of a child process stream. */
+export declare function prefixer(label: string, write: (s: string) => void, opts?: {
+    spans?: boolean;
+}): (chunk: Buffer | string) => void;

package/dist/dev/pretty.js

@@ -0,0 +1,91 @@
+import { isTelemetryEvent } from '@ericminassian/platform-core';
+import pc from 'picocolors';
+/**
+ * Human formatting for telemetry lines (`{"_p":1,...}`) printed by the SDK in
+ * the local web server and worker. Non-telemetry lines pass through as-is.
+ * Returns null for lines that are noise locally (spans, Lambda START/END).
+ */
+export function prettyLine(line, opts = {}) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return null;
+    if (/^(START|END) RequestId:/.test(trimmed))
+        return null;
+    if (trimmed.startsWith('REPORT RequestId:')) {
+        const dur = /Duration: ([\d.]+) ms/.exec(trimmed)?.[1];
+        return pc.dim(`lambda invocation ${dur ? `${Math.round(Number(dur))}ms` : 'done'}`);
+    }
+    // Lambda prefixes console output with "<ts>\t<requestId>\t<LEVEL>\t" in text log format.
+    const jsonStart = trimmed.indexOf('{');
+    if (jsonStart === -1)
+        return trimmed;
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed.slice(jsonStart));
+    }
+    catch {
+        return trimmed;
+    }
+    if (!isTelemetryEvent(parsed))
+        return trimmed;
+    return formatEvent(parsed, opts);
+}
+export function formatEvent(e, opts = {}) {
+    const trace = e.trace ? pc.dim(` ${e.trace.slice(0, 8)}`) : '';
+    switch (e.t) {
+        case 'req': {
+            const color = e.status >= 500 ? pc.red : e.status >= 400 ? pc.yellow : pc.green;
+            return `${pc.bold(e.method.padEnd(6))} ${e.path} ${color(String(e.status))} ${pc.dim(`${Math.round(e.dur)}ms`)}${e.cold ? pc.magenta(' cold') : ''}${trace}`;
+        }
+        case 'err': {
+            const head = `${pc.red('✗')} ${pc.red(`${e.name}: ${e.message}`)}${e.route ? pc.dim(` at ${e.route}`) : ''}${e.job ? pc.dim(` in ${e.job}`) : ''}${trace}`;
+            const stack = e.stack
+                ?.split('\n')
+                .slice(1, 4)
+                .map((l) => pc.dim(`    ${l.trim()}`))
+                .join('\n');
+            return stack ? `${head}\n${stack}` : head;
+        }
+        case 'job': {
+            const status = e.status === 'ok' ? pc.green('ok') : pc.red('error');
+            return `${pc.cyan('job')} ${e.kind}:${e.name} ${status} ${pc.dim(`${Math.round(e.dur)}ms`)}${e.attempt && e.attempt > 1 ? pc.yellow(` attempt ${e.attempt}`) : ''}${trace}`;
+        }
+        case 'log': {
+            const { _p, t, ts, app, stage, rev, trace: tr, span, parent, level, msg, ...fields } = e;
+            const color = level === 'error'
+                ? pc.red
+                : level === 'warn'
+                    ? pc.yellow
+                    : level === 'debug'
+                        ? pc.dim
+                        : (s) => s;
+            const extra = Object.keys(fields).length ? pc.dim(` ${JSON.stringify(fields)}`) : '';
+            return `${color(level.toUpperCase().padEnd(5))} ${msg}${extra}${trace}`;
+        }
+        case 'metric':
+            return pc.blue(`metric ${e.name}=${e.value}${e.unit ? e.unit : ''}`);
+        case 'env':
+            return pc.dim(`${e.runtime} environment ${e.event}${e.initMs !== undefined ? ` (${Math.round(e.initMs)}ms init)` : ''}`);
+        case 'span':
+            return opts.spans
+                ? pc.dim(`  span ${e.op}${e.name ? ` ${e.name}` : ''} ${Math.round(e.dur)}ms ${e.status}`)
+                : null;
+    }
+}
+/** Prefix every line of a child process stream. */
+export function prefixer(label, write, opts = {}) {
+    let buf = '';
+    return (chunk) => {
+        buf += chunk.toString();
+        let idx = buf.indexOf('\n');
+        while (idx !== -1) {
+            const line = buf.slice(0, idx);
+            buf = buf.slice(idx + 1);
+            const pretty = prettyLine(line, opts);
+            if (pretty !== null)
+                write(`${label} ${pretty.split('\n').join(`\n${label} `)}\n`);
+            idx = buf.indexOf('\n');
+        }
+    };
+}
+//# sourceMappingURL=pretty.js.map

package/dist/dev/pretty.js.map

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

package/dist/dev/proc.d.ts

@@ -0,0 +1,7 @@
+import type { ChildProcess } from 'node:child_process';
+/**
+ * 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 declare function killTree(child: ChildProcess, signal?: NodeJS.Signals): void;