@ericminassian/plat 0.0.0-stage → 0.1.0

package/dist/commands/manage.js

@@ -0,0 +1,103 @@
+import { ENV_NAME_PATTERN, PROD_STAGE } from '@ericminassian/platform-core';
+import pc from 'picocolors';
+import { CliError, EXIT, result, table } from '../util/output.js';
+import { confirmByTyping, prompt } from '../util/prompt.js';
+import { shortTime } from '../util/time.js';
+import { action, apiFor, appFor, withTarget } from './common.js';
+import { readStdin } from './observe.js';
+export function registerManage(program) {
+    // ------------------------------------------------------------ secrets
+    const secrets = program.command('secrets').description('app secrets (values never shown)');
+    withTarget(secrets.command('list').description('secret names for a stage (and shared ones)')).action(action(async (opts) => {
+        const list = await apiFor(opts).listSecrets(appFor(opts), { stage: opts.stage });
+        result(list, (l) => table(l.map((s) => ({
+            name: s.name,
+            scope: s.scope,
+            stage: s.stage ?? '',
+            updated: s.updatedAt ? shortTime(s.updatedAt) : '',
+        }))));
+    }));
+    withTarget(secrets
+        .command('set <name> [value]')
+        .description('set a secret (value from the argument or stdin)')
+        .option('--shared', 'app-wide: every stage without its own value uses it')).action(action(async (name, value, opts) => {
+        checkSecretName(name);
+        const v = value ?? (process.stdin.isTTY ? await prompt(`value for ${name}: `) : readStdin());
+        if (!v)
+            throw new CliError('empty secret value', { exitCode: EXIT.usage });
+        const info = await apiFor(opts).setSecret(appFor(opts), name, opts.shared ? { value: v, shared: true } : { value: v, stage: opts.stage });
+        result(info, () => `${pc.green('✓')} set ${name} (${opts.shared ? 'shared' : opts.stage}); new value applies within ~5 minutes`);
+    }));
+    withTarget(secrets
+        .command('rm <name>')
+        .description('delete a secret')
+        .option('--shared', 'delete the app-wide value')).action(action(async (name, opts) => {
+        checkSecretName(name);
+        await apiFor(opts).deleteSecret(appFor(opts), name, opts.shared ? { shared: true } : { stage: opts.stage });
+        result({ deleted: name }, () => `${pc.green('✓')} deleted ${name}`);
+    }));
+    // ------------------------------------------------------------ deployments & stages
+    withTarget(program.command('deployments').description('recent deployments'), false).action(action(async (opts) => {
+        const list = await apiFor(opts).listDeployments(appFor(opts), opts.stage);
+        result(list, (l) => table(l.map((d) => ({
+            id: d.id,
+            stage: d.stage,
+            status: d.status === 'succeeded'
+                ? pc.green(d.status)
+                : d.status === 'failed'
+                    ? pc.red(d.status)
+                    : d.status,
+            commit: d.commit?.slice(0, 7) ?? '',
+            message: (d.message ?? '').slice(0, 50),
+            by: d.actor,
+            at: shortTime(d.createdAt),
+        }))));
+    }));
+    withTarget(program.command('stages').description('stages of an app'), false).action(action(async (opts) => {
+        const list = await apiFor(opts).listStages(appFor(opts));
+        result(list, (l) => table(l.map((s) => ({
+            stage: s.stage,
+            status: s.status,
+            url: s.url,
+            deployment: s.currentDeployment ?? '',
+            updated: shortTime(s.updatedAt),
+        }))));
+    }));
+    withTarget(program
+        .command('rollback')
+        .description('point a stage back at its previous deployment (instant)')
+        .option('--to <deploymentId>', 'a specific earlier deployment')).action(action(async (opts) => {
+        const r = await apiFor(opts).rollback(appFor(opts), opts.stage, opts.to);
+        result(r, () => `${pc.green('✓')} rolled back ${opts.stage}`);
+    }));
+    withTarget(program
+        .command('destroy')
+        .description('delete a stage and its resources')
+        .option('--yes', 'skip the confirmation prompt')
+        .option('--force', 'required to destroy prod'), false).action(action(async (opts) => {
+        if (!opts.stage)
+            throw new CliError('--stage is required', { exitCode: EXIT.usage });
+        if (opts.stage === PROD_STAGE && !opts.force) {
+            throw new CliError('refusing to destroy prod', {
+                hint: 'pass --force if you really mean it',
+                exitCode: EXIT.usage,
+            });
+        }
+        const app = appFor(opts);
+        await confirmByTyping(`destroy ${app}/${opts.stage}?`, opts.stage, opts.yes);
+        await apiFor(opts).destroyStage(app, opts.stage);
+        result({ app, stage: opts.stage, destroyed: true }, () => `${pc.green('✓')} destroying ${app}/${opts.stage}`);
+    }));
+    // ------------------------------------------------------------ crons
+    const cron = program.command('cron').description('scheduled jobs');
+    withTarget(cron.command('run <name>').description('run a cron now on a deployed stage')).action(action(async (name, opts) => {
+        await apiFor(opts).runCron(appFor(opts), name, opts.stage);
+        result({ cron: name, stage: opts.stage, triggered: true }, () => `${pc.green('✓')} triggered ${name} on ${opts.stage}`);
+    }));
+}
+function checkSecretName(name) {
+    if (!ENV_NAME_PATTERN.test(name)) {
+        throw new CliError(`secret names are UPPER_SNAKE_CASE, got "${name}"`, { exitCode: EXIT.usage });
+    }
+}
+//# sourceMappingURL=manage.js.map

package/dist/commands/manage.js.map

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

package/dist/commands/observe.d.ts

@@ -0,0 +1,8 @@
+import type { LogLine, TelemetryEvent } from '@ericminassian/platform-core';
+import type { Command } from 'commander';
+export declare function registerObserve(program: Command): void;
+/** `["userId=1", "kind=a"]` → `"userId=1&kind=a"` (URL-encoded pairs, as the API expects). */
+export declare function parsePartition(pairs: string[]): string;
+export declare function formatLogLine(l: LogLine): string;
+export declare function formatTrace(events: TelemetryEvent[]): string;
+export declare function readStdin(): string;

package/dist/commands/observe.js

@@ -0,0 +1,195 @@
+import { readFileSync } from 'node:fs';
+import pc from 'picocolors';
+import { formatEvent } from '../dev/pretty.js';
+import { CliError, EXIT, isJsonMode, result, sparkline, table } from '../util/output.js';
+import { shortTime, sinceRange } from '../util/time.js';
+import { action, apiFor, appFor, withTarget } from './common.js';
+export function registerObserve(program) {
+    withTarget(program
+        .command('logs')
+        .description('search recent logs (web + worker); --follow streams live')
+        .option('--since <duration>', 'how far back', '1h')
+        .option('--filter <text>', 'only lines containing this text / CloudWatch filter pattern')
+        .option('--limit <n>', 'max lines', '200')
+        .option('-f, --follow', 'stream new lines (live tail)')
+        .option('--runtime', "include the Lambda runtime's own records (hidden by default)")).action(action(async (opts) => {
+        const keep = (l) => opts.runtime || l.level !== 'system';
+        const api = apiFor(opts);
+        const app = appFor(opts);
+        if (opts.follow) {
+            const ac = new AbortController();
+            process.once('SIGINT', () => ac.abort());
+            try {
+                for await (const line of api.tailLogs(app, { stage: opts.stage, ...(opts.filter ? { filter: opts.filter } : {}) }, ac.signal)) {
+                    if (!keep(line))
+                        continue;
+                    process.stdout.write(`${isJsonMode() ? JSON.stringify(line) : formatLogLine(line)}\n`);
+                }
+            }
+            catch (err) {
+                if (err.name !== 'AbortError')
+                    throw err;
+            }
+            return;
+        }
+        const { from, to } = sinceRange(opts.since);
+        const res = await api.logs(app, {
+            stage: opts.stage,
+            from,
+            to,
+            limit: Number(opts.limit),
+            ...(opts.filter ? { filter: opts.filter } : {}),
+        });
+        const shown = { ...res, lines: res.lines.filter(keep) };
+        result(shown, (r) => r.lines.length ? r.lines.map(formatLogLine).join('\n') : pc.dim('(no log lines)'));
+    }));
+    withTarget(program
+        .command('metrics')
+        .description('requests, errors, latency and jobs for a stage')
+        .option('--since <duration>', 'time range', '6h')).action(action(async (opts) => {
+        const api = apiFor(opts);
+        const app = appFor(opts);
+        const range = sinceRange(opts.since);
+        const [metrics, routes, jobs] = await Promise.all([
+            api.metrics(app, { stage: opts.stage, ...range }),
+            api.routes(app, { stage: opts.stage, from: range.from, to: range.to }).catch(() => []),
+            api
+                .jobs(app, { stage: opts.stage, from: range.from, to: range.to })
+                .catch(() => ({ jobs: [], queues: [] })),
+        ]);
+        result({ metrics, routes, ...jobs }, (v) => {
+            const pts = v.metrics.points;
+            const total = pts.reduce((a, p) => a + p.req, 0);
+            const errors = pts.reduce((a, p) => a + p.s5xx, 0);
+            const p95s = pts.map((p) => p.p95).filter((x) => x !== null);
+            const lines = [
+                `${pc.bold(app)} ${pc.dim(`${opts.stage} · last ${opts.since} · ${v.metrics.res} buckets`)}`,
+                '',
+                `  requests  ${String(total).padStart(8)}  ${sparkline(pts.map((p) => p.req))}`,
+                `  5xx       ${String(errors).padStart(8)}  ${pc.red(sparkline(pts.map((p) => p.s5xx)))}`,
+                `  p95 (ms)  ${String(p95s.length ? Math.max(...p95s) : '-').padStart(8)}  ${sparkline(pts.map((p) => p.p95))}`,
+                `  cold      ${String(pts.reduce((a, p) => a + p.cold, 0)).padStart(8)}  ${sparkline(pts.map((p) => p.cold))}`,
+            ];
+            if (v.routes.length) {
+                lines.push('', pc.bold('routes'), table(v.routes.map((r) => ({
+                    method: r.method,
+                    route: r.route,
+                    req: r.req,
+                    '5xx': r.s5xx,
+                    '4xx': r.s4xx,
+                    p50: r.p50 ?? '-',
+                    p95: r.p95 ?? '-',
+                }))));
+            }
+            if (v.jobs.length) {
+                lines.push('', pc.bold('jobs'), table(v.jobs.map((j) => ({
+                    job: `${j.kind}:${j.name}`,
+                    ok: j.ok,
+                    error: j.error,
+                    p95: j.p95 ?? '-',
+                    last: j.lastRun ? shortTime(j.lastRun) : '-',
+                }))));
+            }
+            if (v.queues.length) {
+                lines.push('', pc.bold('queues'), table(v.queues.map((q) => ({
+                    queue: q.name,
+                    visible: q.visible,
+                    inFlight: q.inFlight,
+                    dlq: q.deadLetter,
+                    oldest: q.oldestAgeSeconds ?? '-',
+                }))));
+            }
+            return lines.join('\n');
+        });
+    }));
+    withTarget(program.command('errors').description('grouped errors for a stage')).action(action(async (opts) => {
+        const groups = await apiFor(opts).errors(appFor(opts), { stage: opts.stage });
+        result(groups, (g) => table(g.map((e) => ({
+            id: e.fingerprint,
+            status: e.status === 'open' ? pc.red('open') : e.status,
+            count: e.count,
+            error: `${e.name}: ${e.message}`.slice(0, 80),
+            where: e.sample.route ?? e.sample.job ?? '',
+            last: shortTime(e.lastSeen),
+            trace: e.sample.trace ?? '',
+        }))));
+    }));
+    withTarget(program
+        .command('traces <traceId>')
+        .description('every event of one request/job across web, queues and worker')).action(action(async (traceId, opts) => {
+        const t = await apiFor(opts).trace(appFor(opts), traceId, { stage: opts.stage });
+        result(t, (v) => formatTrace(v.events));
+    }));
+    withTarget(program
+        .command('data [collection]')
+        .description('browse database collections or file stores')
+        .option('--partition <k=v...>', 'partition key values (repeatable)')
+        .option('--store <name>', 'list files in a storage store instead')
+        .option('--prefix <prefix>', 'file key prefix (with --store)')
+        .option('--cursor <cursor>', 'continue from a previous page')
+        .option('--limit <n>', 'page size', '50')).action(action(async (collection, opts) => {
+        const api = apiFor(opts);
+        const app = appFor(opts);
+        if (opts.store) {
+            const r = await api.files(app, {
+                stage: opts.stage,
+                store: opts.store,
+                ...(opts.prefix ? { prefix: opts.prefix } : {}),
+                ...(opts.cursor ? { cursor: opts.cursor } : {}),
+            });
+            result(r, (v) => `${table(v.objects.map((o) => ({ key: o.key, size: o.size, modified: o.lastModified ?? '' })))}${v.cursor ? `\n${pc.dim(`more: --cursor ${v.cursor}`)}` : ''}`);
+            return;
+        }
+        if (!collection) {
+            const cols = await api.collections(app, { stage: opts.stage });
+            result(cols, (c) => (c.length ? c.join('\n') : pc.dim('(no collections yet)')));
+            return;
+        }
+        const page = await api.items(app, {
+            stage: opts.stage,
+            collection,
+            limit: Number(opts.limit),
+            ...(opts.partition ? { partition: parsePartition(opts.partition) } : {}),
+            ...(opts.cursor ? { cursor: opts.cursor } : {}),
+        });
+        result(page, (v) => `${v.items.map((i) => JSON.stringify(i)).join('\n') || pc.dim('(no items)')}${v.cursor ? `\n${pc.dim(`more: --cursor ${v.cursor}`)}` : ''}`);
+    }));
+}
+/** `["userId=1", "kind=a"]` → `"userId=1&kind=a"` (URL-encoded pairs, as the API expects). */
+export function parsePartition(pairs) {
+    const params = new URLSearchParams();
+    for (const p of pairs) {
+        const i = p.indexOf('=');
+        if (i <= 0)
+            throw new CliError(`--partition expects key=value, got "${p}"`, { exitCode: EXIT.usage });
+        params.append(p.slice(0, i), p.slice(i + 1));
+    }
+    return params.toString();
+}
+export function formatLogLine(l) {
+    const ts = pc.dim(shortTime(l.ts));
+    const stream = l.stream === 'web' ? pc.green('web   ') : pc.yellow('worker');
+    const body = l.event ? (formatEvent(l.event, { spans: true }) ?? l.message) : l.message;
+    return `${ts} ${stream} ${body}`;
+}
+export function formatTrace(events) {
+    if (events.length === 0)
+        return pc.dim('(no events for this trace)');
+    const sorted = [...events].sort((a, b) => a.ts - b.ts);
+    const t0 = sorted[0].ts;
+    return sorted
+        .map((e) => {
+        const offset = `+${String(e.ts - t0).padStart(5)}ms`;
+        return `${pc.dim(offset)} ${formatEvent(e, { spans: true }) ?? e.t}`;
+    })
+        .join('\n');
+}
+export function readStdin() {
+    try {
+        return readFileSync(0, 'utf8').replace(/\r?\n$/, '');
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=observe.js.map

package/dist/commands/observe.js.map

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

package/dist/credentials.d.ts

@@ -0,0 +1,13 @@
+/** What `plat login` stores. The token is a platform token, never a GitHub token. */
+export interface StoredCredentials {
+    apiUrl: string;
+    token: string;
+    github: string;
+    expiresAt: string;
+}
+export declare function configDir(): string;
+export declare function credentialsPath(): string;
+export declare function saveCredentials(creds: StoredCredentials, path?: string): void;
+export declare function loadCredentials(path?: string): StoredCredentials | null;
+export declare function clearCredentials(path?: string): boolean;
+export declare function isExpired(c: StoredCredentials, now?: number): boolean;

package/dist/credentials.js

@@ -0,0 +1,42 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+export function configDir() {
+    if (process.env.PLAT_CONFIG_DIR)
+        return process.env.PLAT_CONFIG_DIR;
+    const base = process.env.XDG_CONFIG_HOME || join(homedir(), '.config');
+    return join(base, 'plat');
+}
+export function credentialsPath() {
+    return join(configDir(), 'credentials.json');
+}
+export function saveCredentials(creds, path = credentialsPath()) {
+    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+    writeFileSync(path, `${JSON.stringify(creds, null, 2)}\n`, { mode: 0o600 });
+    // writeFileSync only applies `mode` when creating; enforce it on overwrite too.
+    chmodSync(path, 0o600);
+}
+export function loadCredentials(path = credentialsPath()) {
+    if (!existsSync(path))
+        return null;
+    try {
+        const c = JSON.parse(readFileSync(path, 'utf8'));
+        if (!c.token || !c.apiUrl)
+            return null;
+        return c;
+    }
+    catch {
+        return null;
+    }
+}
+export function clearCredentials(path = credentialsPath()) {
+    if (!existsSync(path))
+        return false;
+    rmSync(path);
+    return true;
+}
+export function isExpired(c, now = Date.now()) {
+    const t = Date.parse(c.expiresAt);
+    return Number.isFinite(t) && t <= now;
+}
+//# sourceMappingURL=credentials.js.map

package/dist/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAChG,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAU1C,MAAM,UAAU,SAAS;IACvB,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IACpE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IACvE,OAAO,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,kBAAkB,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAwB,EAAE,IAAI,GAAG,eAAe,EAAE;IAChF,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5E,gFAAgF;IAChF,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAI,GAAG,eAAe,EAAE;IACtD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAsB,CAAC;QACtE,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACvC,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAI,GAAG,eAAe,EAAE;IACvD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,MAAM,CAAC,IAAI,CAAC,CAAC;IACb,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,CAAoB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAC9D,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;AACxC,CAAC"}

package/dist/deploy.d.ts

@@ -0,0 +1,23 @@
+import type { DeploymentEventEntry, DeploymentRecord, DeploymentStatus, PresignedPost } from '@ericminassian/platform-core';
+import type { ApiClient } from './api.ts';
+export declare const TERMINAL_STATUSES: readonly DeploymentStatus[];
+export interface DeployOptions {
+    cwd: string;
+    stage?: string;
+    wait: boolean;
+    timeoutMs?: number;
+    pollMs?: number;
+}
+export interface DeployResult {
+    deployment: DeploymentRecord;
+    url?: string;
+}
+export declare function deploy(api: ApiClient, opts: DeployOptions): Promise<DeployResult>;
+/** Builds the multipart body for an S3 presigned POST (policy fields first, file last). */
+export declare function presignedPostForm(post: PresignedPost, data: Uint8Array, filename: string): FormData;
+export declare function uploadPresignedPost(post: PresignedPost, path: string, name: string): Promise<void>;
+export declare function waitForDeployment(api: ApiClient, id: string, opts: {
+    timeoutMs: number;
+    pollMs: number;
+    onEvent?: (e: DeploymentEventEntry) => void;
+}): Promise<DeploymentRecord>;

package/dist/deploy.js

@@ -0,0 +1,100 @@
+import { readFileSync } from 'node:fs';
+import { basename } from 'node:path';
+import pc from 'picocolors';
+import { buildApp } from './build.js';
+import { appendStepSummary, deriveStage, gitInfo, isGitHubActions, setOutput } from './github.js';
+import { loadProject } from './project.js';
+import { CliError, EXIT, info, step, success } from './util/output.js';
+export const TERMINAL_STATUSES = ['succeeded', 'failed', 'rolled_back'];
+export async function deploy(api, opts) {
+    const project = loadProject(opts.cwd);
+    const stage = deriveStage(opts.stage);
+    const app = project.manifest.name;
+    const { files } = await buildApp({ cwd: project.root });
+    // The API always issues an upload for manifest.json; `files` lists the optional bundles.
+    const fileNames = Object.keys(files).filter((f) => f !== 'manifest.json');
+    const git = gitInfo(project.root);
+    step(`creating deployment of ${pc.bold(app)} to ${pc.bold(stage)}`);
+    const created = await api.createDeployment(app, {
+        stage,
+        manifest: project.raw,
+        files: fileNames,
+        ...git,
+    });
+    const id = created.deployment.id;
+    for (const name of Object.keys(files)) {
+        const post = created.uploads[name];
+        if (!post)
+            throw new CliError(`the API did not return an upload URL for ${name}`);
+        step(`uploading ${name}`);
+        await uploadPresignedPost(post, files[name], name);
+    }
+    step('starting deployment');
+    let deployment = await api.startDeployment(id);
+    if (!opts.wait) {
+        info(`deployment ${id} is ${deployment.status}; follow with \`plat deployments --stage ${stage}\``);
+        return { deployment, url: deployment.url };
+    }
+    deployment = await waitForDeployment(api, id, {
+        timeoutMs: opts.timeoutMs ?? 15 * 60_000,
+        pollMs: opts.pollMs ?? 2_000,
+        onEvent: printEvent,
+    });
+    if (deployment.status !== 'succeeded') {
+        throw new CliError(`deployment ${id} ${deployment.status}${deployment.error ? `: ${deployment.error}` : ''}`, {
+            hint: `see \`plat logs --stage ${stage}\` and the events above`,
+            exitCode: EXIT.deployFailed,
+        });
+    }
+    const url = deployment.url;
+    success(`deployed ${app} to ${stage}${url ? `: ${pc.underline(url)}` : ''}`);
+    if (isGitHubActions()) {
+        if (url)
+            setOutput('url', url);
+        setOutput('deployment', id);
+        appendStepSummary(`### Deployed \`${app}\` → \`${stage}\`\n\n${url ? `**URL:** ${url}\n\n` : ''}Deployment \`${id}\`${git.commit ? ` at \`${git.commit.slice(0, 7)}\`` : ''}`);
+    }
+    return { deployment, url };
+}
+/** Builds the multipart body for an S3 presigned POST (policy fields first, file last). */
+export function presignedPostForm(post, data, filename) {
+    const form = new FormData();
+    for (const [k, v] of Object.entries(post.fields))
+        form.append(k, v);
+    form.append('file', new Blob([new Uint8Array(data)]), filename);
+    return form;
+}
+export async function uploadPresignedPost(post, path, name) {
+    const data = readFileSync(path);
+    const res = await fetch(post.url, { method: 'POST', body: presignedPostForm(post, data, basename(name)) });
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        throw new CliError(`upload of ${name} failed (HTTP ${res.status})`, {
+            hint: text.slice(0, 300) || undefined,
+        });
+    }
+}
+export async function waitForDeployment(api, id, opts) {
+    const deadline = Date.now() + opts.timeoutMs;
+    let seen = 0;
+    for (;;) {
+        const d = await api.getDeployment(id);
+        const events = d.events ?? [];
+        for (const e of events.slice(seen))
+            opts.onEvent?.(e);
+        seen = Math.max(seen, events.length);
+        if (TERMINAL_STATUSES.includes(d.status))
+            return d;
+        if (Date.now() > deadline) {
+            throw new CliError(`timed out waiting for deployment ${id} (status ${d.status})`, {
+                exitCode: EXIT.deployFailed,
+            });
+        }
+        await new Promise((r) => setTimeout(r, opts.pollMs));
+    }
+}
+function printEvent(e) {
+    const color = e.level === 'error' ? pc.red : e.level === 'warn' ? pc.yellow : pc.dim;
+    info(`  ${color(new Date(e.ts).toISOString().slice(11, 19))} ${e.msg}${e.resource ? pc.dim(` (${e.resource})`) : ''}`);
+}
+//# sourceMappingURL=deploy.js.map

package/dist/deploy.js.map

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

package/dist/dev/crons.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Local stand-in for EventBridge Scheduler (the emulator creates schedules but
+ * never fires them). Same expressions as platform.json: 5-field cron in UTC
+ * (or the cron's timezone) or `rate(n unit)`.
+ */
+export interface LocalCron {
+    name: string;
+    schedule: string;
+    timezone?: string;
+}
+export declare function nextRun(cron: LocalCron, from?: Date): Date;
+export interface CronScheduler {
+    next(name: string): Date | undefined;
+    stop(): void;
+}
+export declare function scheduleCrons(crons: LocalCron[], fire: (name: string) => void | Promise<void>): CronScheduler;

package/dist/dev/crons.js

@@ -0,0 +1,47 @@
+import { CronExpressionParser } from 'cron-parser';
+export function nextRun(cron, from = new Date()) {
+    const rate = /^rate\(\s*(\d+)\s+(minute|minutes|hour|hours|day|days)\s*\)$/.exec(cron.schedule.trim());
+    if (rate) {
+        const unit = rate[2].startsWith('minute')
+            ? 60_000
+            : rate[2].startsWith('hour')
+                ? 3_600_000
+                : 86_400_000;
+        return new Date(from.getTime() + Number(rate[1]) * unit);
+    }
+    return CronExpressionParser.parse(cron.schedule, { currentDate: from, tz: cron.timezone ?? 'UTC' })
+        .next()
+        .toDate();
+}
+export function scheduleCrons(crons, fire) {
+    const timers = new Map();
+    const nexts = new Map();
+    const arm = (c) => {
+        const at = nextRun(c);
+        nexts.set(c.name, at);
+        // setTimeout caps at ~24.8 days; re-arm in steps.
+        const delay = Math.min(at.getTime() - Date.now(), 2 ** 31 - 1);
+        timers.set(c.name, setTimeout(async () => {
+            if (Date.now() >= at.getTime() - 5) {
+                try {
+                    await fire(c.name);
+                }
+                catch {
+                    // reported by `fire`
+                }
+            }
+            arm(c);
+        }, Math.max(delay, 0)));
+    };
+    for (const c of crons)
+        arm(c);
+    return {
+        next: (name) => nexts.get(name),
+        stop: () => {
+            for (const t of timers.values())
+                clearTimeout(t);
+            timers.clear();
+        },
+    };
+}
+//# sourceMappingURL=crons.js.map

package/dist/dev/crons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crons.js","sourceRoot":"","sources":["../../src/dev/crons.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAanD,MAAM,UAAU,OAAO,CAAC,IAAe,EAAE,IAAI,GAAG,IAAI,IAAI,EAAE;IACxD,MAAM,IAAI,GAAG,8DAA8D,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACvG,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YACxC,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,UAAU,CAAC,MAAM,CAAC;gBAC3B,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,UAAU,CAAC;QACjB,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK,EAAE,CAAC;SAChG,IAAI,EAAE;SACN,MAAM,EAAE,CAAC;AACd,CAAC;AAOD,MAAM,UAAU,aAAa,CAC3B,KAAkB,EAClB,IAA4C;IAE5C,MAAM,MAAM,GAAG,IAAI,GAAG,EAA0B,CAAC;IACjD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IACtC,MAAM,GAAG,GAAG,CAAC,CAAY,EAAE,EAAE;QAC3B,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACtB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACtB,kDAAkD;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;QAC/D,MAAM,CAAC,GAAG,CACR,CAAC,CAAC,IAAI,EACN,UAAU,CACR,KAAK,IAAI,EAAE;YACT,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC;gBACnC,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACrB,CAAC;gBAAC,MAAM,CAAC;oBACP,qBAAqB;gBACvB,CAAC;YACH,CAAC;YACD,GAAG,CAAC,CAAC,CAAC,CAAC;QACT,CAAC,EACD,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CACnB,CACF,CAAC;IACJ,CAAC,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9B,OAAO;QACL,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;QAC/B,IAAI,EAAE,GAAG,EAAE;YACT,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE;gBAAE,YAAY,CAAC,CAAC,CAAC,CAAC;YACjD,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/dev/entries.d.ts

@@ -0,0 +1,6 @@
+/** Path to tsx's CLI (it has no `./cli` export, so go through its package.json). */
+export declare function tsxCli(): string;
+/** A CLI-owned entry file next to this module (`.ts` in the repo, `.js` when published). */
+export declare function devEntry(name: 'server-entry' | 'worker-host'): string;
+/** argv for running an entry under tsx, optionally restarting on edits. */
+export declare function tsxArgs(name: 'server-entry' | 'worker-host', watch: boolean): string[];