@ericminassian/plat 0.0.0-stage → 0.2.0

package/dist/build.js

@@ -0,0 +1,185 @@
+import { spawn } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { delimiter, join, resolve } from 'node:path';
+import { build as esbuild } from 'esbuild';
+import { cliVersion, loadProject } from './project.js';
+import { buildFailureList } from './util/esbuild.js';
+import { CliError, EXIT, step } from './util/output.js';
+import { dirExists, zipDirectory } from './util/zip.js';
+export const SDK_SERVER = '@ericminassian/platform/server';
+export const SDK_WORKER = '@ericminassian/platform/worker';
+/**
+ * Builds an app into deployable artifacts:
+ *  - `server.zip`  → `index.mjs` (+ map): the app's fetch handler wrapped by the SDK server
+ *  - `worker.zip`  → `index.mjs` (+ map): `export const handler` for the worker Lambda
+ *  - `static.zip`  → the built frontend
+ *  - `manifest.json` → `{ manifest, resolved, build }` (`manifest` is plat.config.ts evaluated to JSON)
+ */
+export async function buildApp(opts) {
+    const project = opts.project ?? (await loadProject(opts.cwd));
+    const { root, manifest, raw } = project;
+    const outDir = resolve(opts.outDir ?? join(root, '.plat', 'build'));
+    const want = (part) => !opts.only || opts.only.includes(part);
+    const log = opts.quiet ? () => { } : step;
+    validateForBuild(root, manifest);
+    rmSync(outDir, { recursive: true, force: true });
+    mkdirSync(outDir, { recursive: true });
+    const files = {};
+    const plugins = opts.resolveOverrides ? [overridePlugin(opts.resolveOverrides)] : [];
+    const minify = opts.minify ?? true;
+    if (manifest.web?.server && want('server')) {
+        log('bundling server');
+        const entry = resolve(root, manifest.web.server);
+        const dir = await bundle({
+            root,
+            outDir: join(outDir, 'server'),
+            contents: `import handler from ${JSON.stringify(entry)};\nimport { startServer } from ${JSON.stringify(SDK_SERVER)};\nawait startServer(handler);\n`,
+            plugins,
+            minify,
+        });
+        files['server.zip'] = writeZip(outDir, 'server.zip', zipDirectory(dir));
+    }
+    if (manifest.worker && want('worker')) {
+        log('bundling worker');
+        const dir = await bundleWorker(root, manifest, join(outDir, 'worker'), { plugins, minify });
+        files['worker.zip'] = writeZip(outDir, 'worker.zip', zipDirectory(dir));
+    }
+    if (manifest.web?.static && want('static')) {
+        if (manifest.web.build && !opts.skipWebBuild) {
+            log(`building frontend: ${manifest.web.build}`);
+            await runCommand(manifest.web.build, root);
+        }
+        const staticDir = resolve(root, manifest.web.static);
+        if (!dirExists(staticDir)) {
+            throw new CliError(`web.static directory ${manifest.web.static} does not exist`, {
+                hint: manifest.web.build
+                    ? 'check that web.build writes to web.static'
+                    : 'add a web.build command or build the frontend first',
+                exitCode: EXIT.usage,
+            });
+        }
+        if (!existsSync(join(staticDir, 'index.html')) && manifest.web.spa) {
+            throw new CliError(`${manifest.web.static}/index.html is missing but web.spa is true`, {
+                exitCode: EXIT.usage,
+            });
+        }
+        files['static.zip'] = writeZip(outDir, 'static.zip', zipDirectory(staticDir));
+    }
+    const manifestPath = join(outDir, 'manifest.json');
+    writeFileSync(manifestPath, `${JSON.stringify({
+        manifest: raw,
+        resolved: manifest,
+        build: {
+            cli: cliVersion(),
+            builtAt: new Date().toISOString(),
+            files: Object.keys(files),
+        },
+    }, null, 2)}\n`);
+    files['manifest.json'] = manifestPath;
+    return { manifest, files };
+}
+/** Bundle just the worker into `outDir/index.mjs` (used by build and `plat dev`). */
+export async function bundleWorker(root, manifest, outDir, opts = {}) {
+    if (!manifest.worker)
+        throw new Error('manifest has no worker');
+    const entry = resolve(root, manifest.worker.entry);
+    return bundle({
+        root,
+        outDir,
+        contents: `import def from ${JSON.stringify(entry)};\nimport { createWorkerHandler } from ${JSON.stringify(SDK_WORKER)};\nexport const handler = createWorkerHandler(def);\n`,
+        plugins: opts.plugins ?? [],
+        minify: opts.minify ?? true,
+    });
+}
+/** Zip of a bundled directory, for UpdateFunctionCode. */
+export function zipBundle(dir) {
+    return zipDirectory(dir);
+}
+export function validateForBuild(root, manifest) {
+    const problems = [];
+    if (manifest.auth.enabled && !manifest.web?.server)
+        problems.push('auth needs web.server (sign-in routes run in the server)');
+    if (manifest.web?.server && !existsSync(resolve(root, manifest.web.server))) {
+        problems.push(`web.server entry ${manifest.web.server} does not exist`);
+    }
+    if (manifest.worker && !existsSync(resolve(root, manifest.worker.entry))) {
+        problems.push(`worker entry ${manifest.worker.entry} does not exist (needed for ${describeWorkerNeeds(manifest)})`);
+    }
+    if (problems.length)
+        throw new CliError(`can't build ${manifest.name}:\n  - ${problems.join('\n  - ')}`, {
+            exitCode: EXIT.usage,
+        });
+}
+function describeWorkerNeeds(m) {
+    const parts = [
+        ...Object.keys(m.queues).map((q) => `queue ${q}`),
+        ...m.events.map((e) => `event ${e}`),
+        ...Object.keys(m.crons).map((c) => `cron ${c}`),
+    ];
+    return parts.join(', ') || 'worker';
+}
+async function bundle(o) {
+    mkdirSync(o.outDir, { recursive: true });
+    try {
+        await esbuild({
+            stdin: { contents: o.contents, resolveDir: o.root, sourcefile: 'platform-entry.ts', loader: 'ts' },
+            outfile: join(o.outDir, 'index.mjs'),
+            bundle: true,
+            platform: 'node',
+            format: 'esm',
+            target: 'node24',
+            minify: o.minify,
+            sourcemap: 'external',
+            sourcesContent: false,
+            legalComments: 'none',
+            logLevel: 'silent',
+            // ESM bundles of CJS dependencies still call require(). process.getBuiltinModule
+            // (not a static `import 'node:module'`) keeps the bundle loadable in runtimes
+            // without node:module, such as the AWS Emulator's Lambda sandbox.
+            banner: {
+                js: "const require = globalThis.process?.getBuiltinModule?.('module')?.createRequire(import.meta.url);",
+            },
+            plugins: o.plugins,
+            absWorkingDir: o.root,
+        });
+    }
+    catch (err) {
+        throw new CliError(`bundling failed:${buildFailureList(err)}`);
+    }
+    return o.outDir;
+}
+function overridePlugin(map) {
+    const keys = Object.keys(map);
+    const filter = new RegExp(`^(${keys.map((k) => k.replace(/[.*+?^${}()|[\]\\/]/g, '\\$&')).join('|')})$`);
+    return {
+        name: 'plat-resolve-overrides',
+        setup(b) {
+            b.onResolve({ filter }, (args) => ({ path: map[args.path] }));
+        },
+    };
+}
+function writeZip(outDir, name, data) {
+    const p = join(outDir, name);
+    writeFileSync(p, data);
+    return p;
+}
+/** Run a manifest shell command with the app's `node_modules/.bin` on PATH. */
+export function runCommand(command, cwd, env = process.env) {
+    return new Promise((resolvePromise, reject) => {
+        const child = spawn(command, {
+            cwd,
+            shell: true,
+            stdio: ['ignore', 'inherit', 'inherit'],
+            env: withLocalBin(cwd, env),
+        });
+        child.once('exit', (code) => code === 0 ? resolvePromise() : reject(new CliError(`\`${command}\` exited with code ${code}`)));
+        child.once('error', reject);
+    });
+}
+export function withLocalBin(cwd, env = process.env) {
+    return { ...env, PATH: [join(cwd, 'node_modules', '.bin'), env.PATH ?? ''].join(delimiter) };
+}
+export function readBuildManifest(outDir) {
+    return JSON.parse(readFileSync(join(outDir, 'manifest.json'), 'utf8'));
+}
+//# sourceMappingURL=build.js.map

package/dist/build.js.map

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

package/dist/commands/account.d.ts

@@ -0,0 +1,2 @@
+import { type Command } from 'commander';
+export declare function registerAccount(program: Command): void;

package/dist/commands/account.js

@@ -0,0 +1,45 @@
+import { spawnSync } from 'node:child_process';
+import { Option } from 'commander';
+import pc from 'picocolors';
+import { ApiClient, apiBaseUrl } from '../api.js';
+import { clearCredentials, credentialsPath, loadCredentials, saveCredentials } from '../credentials.js';
+import { CliError, EXIT, result, success } from '../util/output.js';
+import { action, apiFor, withCommon } from './common.js';
+export function registerAccount(program) {
+    withCommon(program
+        .command('login')
+        .description('sign in to the platform with your GitHub identity (uses `gh auth token`)')
+        .addOption(new Option('--github-token <token>', 'GitHub token to use instead of `gh auth token`').env('PLAT_GITHUB_TOKEN'))).action(action(async (opts) => {
+        const baseUrl = opts.apiUrl ?? apiBaseUrl();
+        const githubToken = opts.githubToken ?? ghToken();
+        const api = new ApiClient({ baseUrl, auth: 'none' });
+        const res = await api.login({ githubToken });
+        saveCredentials({ apiUrl: baseUrl, token: res.token, github: res.github, expiresAt: res.expiresAt });
+        result({ github: res.github, role: res.role, expiresAt: res.expiresAt, apiUrl: baseUrl }, (r) => {
+            success(`signed in as ${pc.bold(r.github)} (${r.role}) until ${r.expiresAt}`);
+            return undefined;
+        });
+    }));
+    withCommon(program.command('logout').description('forget the stored platform login')).action(action(async () => {
+        const removed = clearCredentials();
+        result({ loggedOut: removed, path: credentialsPath() }, (r) => r.loggedOut ? 'logged out' : 'not logged in');
+    }));
+    withCommon(program.command('whoami').description('show the signed-in platform member')).action(action(async (opts) => {
+        const me = await apiFor(opts).me();
+        const stored = loadCredentials();
+        result({ ...me, expiresAt: stored?.expiresAt }, (r) => `${pc.bold(r.github)} (${r.role})`);
+    }));
+}
+function ghToken() {
+    const env = process.env.GH_TOKEN || process.env.GITHUB_TOKEN;
+    const r = spawnSync('gh', ['auth', 'token'], { encoding: 'utf8' });
+    const token = r.status === 0 ? r.stdout.trim() : env;
+    if (!token) {
+        throw new CliError('could not get a GitHub token', {
+            hint: 'install the GitHub CLI and run `gh auth login`, or pass --github-token',
+            exitCode: EXIT.auth,
+        });
+    }
+    return token;
+}
+//# sourceMappingURL=account.js.map

package/dist/commands/account.js.map

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

package/dist/commands/apps.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerApps(program: Command): void;

package/dist/commands/apps.js

@@ -0,0 +1,75 @@
+import { validateAppName } from '@ericminassian/platform-core';
+import pc from 'picocolors';
+import { CliError, EXIT, result, table } from '../util/output.js';
+import { confirmByTyping } from '../util/prompt.js';
+import { shortTime } from '../util/time.js';
+import { action, apiFor, withCommon } from './common.js';
+export function registerApps(program) {
+    const apps = program
+        .command('apps')
+        .description('register and inspect apps (repos are created by you, not the CLI)');
+    withCommon(apps
+        .command('create <name>')
+        .description('register an app with the platform')
+        .requiredOption('--repo <owner/name>', 'GitHub repository whose CI may deploy this app')
+        .option('--description <text>', 'one-line description')).action(action(async (name, opts) => {
+        const err = validateAppName(name);
+        if (err)
+            throw new CliError(err, { exitCode: EXIT.usage });
+        if (!/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/.test(opts.repo)) {
+            throw new CliError(`--repo must look like owner/name, got "${opts.repo}"`, { exitCode: EXIT.usage });
+        }
+        const app = await apiFor(opts).createApp({
+            name,
+            repo: opts.repo,
+            ...(opts.description ? { description: opts.description } : {}),
+        });
+        result(app, (a) => [
+            `${pc.green('✓')} registered ${pc.bold(a.name)} (deploys from ${a.repo})`,
+            '',
+            '  next:',
+            '    1. push the repo with the platform workflow (.github/workflows/platform.yml)',
+            `    2. merging to main deploys https://${a.name}.<domain>; PRs get previews`,
+        ].join('\n'));
+    }));
+    withCommon(apps.command('list').description('list apps you can see')).action(action(async (opts) => {
+        const list = await apiFor(opts).listApps();
+        result(list, (l) => table(l.map((s) => ({
+            app: s.app.name,
+            repo: s.app.repo,
+            stages: s.stages.map((st) => st.stage).join(','),
+            up: s.health?.up === null || s.health === null
+                ? '-'
+                : s.health.up
+                    ? pc.green('up')
+                    : pc.red('down'),
+            'req/min': s.health?.reqPerMin ?? '-',
+            p95: s.health?.p95 != null ? `${s.health.p95}ms` : '-',
+            'cost MTD': s.costMonthToDateUsd != null ? `$${s.costMonthToDateUsd.toFixed(2)}` : '-',
+        }))));
+    }));
+    withCommon(apps.command('show <name>').description('app details, stages and health')).action(action(async (name, opts) => {
+        const s = await apiFor(opts).getApp(name);
+        result(s, (v) => [
+            `${pc.bold(v.app.name)}  ${pc.dim(v.app.description ?? '')}`,
+            `repo: ${v.app.repo}   owners: ${v.app.owners.join(', ')}   created: ${shortTime(v.app.createdAt)}`,
+            '',
+            table(v.stages.map((st) => ({
+                stage: st.stage,
+                status: st.status,
+                url: st.url,
+                deployment: st.currentDeployment ?? '',
+                updated: shortTime(st.updatedAt),
+            }))),
+        ].join('\n'));
+    }));
+    withCommon(apps
+        .command('delete <name>')
+        .description('unregister an app (destroy its stages first)')
+        .option('--yes', 'skip the confirmation prompt')).action(action(async (name, opts) => {
+        await confirmByTyping(`unregister ${name}?`, name, opts.yes);
+        await apiFor(opts).deleteApp(name);
+        result({ app: name, deleted: true }, () => `${pc.green('✓')} unregistered ${name}`);
+    }));
+}
+//# sourceMappingURL=apps.js.map

package/dist/commands/apps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps.js","sourceRoot":"","sources":["../../src/commands/apps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAmB,UAAU,EAAE,MAAM,aAAa,CAAC;AAE1E,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,MAAM,IAAI,GAAG,OAAO;SACjB,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,mEAAmE,CAAC,CAAC;IAEpF,UAAU,CACR,IAAI;SACD,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,mCAAmC,CAAC;SAChD,cAAc,CAAC,qBAAqB,EAAE,gDAAgD,CAAC;SACvF,MAAM,CAAC,sBAAsB,EAAE,sBAAsB,CAAC,CAC1D,CAAC,MAAM,CACN,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,IAAyD,EAAE,EAAE;QACvF,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,GAAG;YAAE,MAAM,IAAI,QAAQ,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,oCAAoC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,QAAQ,CAAC,0CAA0C,IAAI,CAAC,IAAI,GAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACvG,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC;YACvC,IAAI;YACJ,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/D,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAChB;YACE,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,IAAI,GAAG;YACzE,EAAE;YACF,SAAS;YACT,kFAAkF;YAClF,0CAA0C,CAAC,CAAC,IAAI,6BAA6B;SAC9E,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IAEF,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC,CAAC,MAAM,CAC1E,MAAM,CAAC,KAAK,EAAE,IAAgB,EAAE,EAAE;QAChC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC3C,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CACjB,KAAK,CACH,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACZ,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI;YACf,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI;YAChB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YAChD,EAAE,EACA,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI;gBACxC,CAAC,CAAC,GAAG;gBACL,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;oBACX,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;oBAChB,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC;YACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS,IAAI,GAAG;YACrC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG;YACtD,UAAU,EAAE,CAAC,CAAC,kBAAkB,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG;SACvF,CAAC,CAAC,CACJ,CACF,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IAEF,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,WAAW,CAAC,gCAAgC,CAAC,CAAC,CAAC,MAAM,CAC1F,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,IAAgB,EAAE,EAAE;QAC9C,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CACd;YACE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE;YAC5D,SAAS,CAAC,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE;YACnG,EAAE;YACF,KAAK,CACH,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBACpB,KAAK,EAAE,EAAE,CAAC,KAAK;gBACf,MAAM,EAAE,EAAE,CAAC,MAAM;gBACjB,GAAG,EAAE,EAAE,CAAC,GAAG;gBACX,UAAU,EAAE,EAAE,CAAC,iBAAiB,IAAI,EAAE;gBACtC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC;aACjC,CAAC,CAAC,CACJ;SACF,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IAEF,UAAU,CACR,IAAI;SACD,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,8CAA8C,CAAC;SAC3D,MAAM,CAAC,OAAO,EAAE,8BAA8B,CAAC,CACnD,CAAC,MAAM,CACN,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,IAAoC,EAAE,EAAE;QAClE,MAAM,eAAe,CAAC,cAAc,IAAI,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IACtF,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/commands/common.d.ts

@@ -0,0 +1,19 @@
+import { type Command } from 'commander';
+import { ApiClient } from '../api.ts';
+export interface CommonOpts {
+    json?: boolean;
+    apiUrl?: string;
+    app?: string;
+    stage?: string;
+}
+/** `--json` and `--api-url` on every command. */
+export declare function withCommon(cmd: Command): Command;
+/** `--app` (defaults to plat.config.ts) and `--stage` (defaults to prod). */
+export declare function withTarget(cmd: Command, stageDefault?: string | false): Command;
+export declare function apiFor(opts: CommonOpts): ApiClient;
+export declare function appFor(opts: CommonOpts): Promise<string>;
+/**
+ * Wraps a command action: applies `--json`, turns errors into a concise
+ * message + hint and a meaningful exit code.
+ */
+export declare function action<A extends unknown[]>(fn: (...args: A) => Promise<void> | void): (...args: A) => Promise<void>;

package/dist/commands/common.js

@@ -0,0 +1,43 @@
+import { Option } from 'commander';
+import { ApiClient } from '../api.js';
+import { resolveAppName } from '../project.js';
+import { reportError, setJsonMode } from '../util/output.js';
+/** `--json` and `--api-url` on every command. */
+export function withCommon(cmd) {
+    return cmd
+        .option('--json', 'machine-readable JSON output on stdout')
+        .addOption(new Option('--api-url <url>', 'platform API base URL').env('PLATFORM_API_URL'));
+}
+/** `--app` (defaults to plat.config.ts) and `--stage` (defaults to prod). */
+export function withTarget(cmd, stageDefault = 'prod') {
+    cmd.option('--app <name>', 'app name (default: from plat.config.ts)');
+    if (stageDefault)
+        cmd.option('--stage <stage>', 'stage', stageDefault);
+    else
+        cmd.option('--stage <stage>', 'stage');
+    return withCommon(cmd);
+}
+export function apiFor(opts) {
+    return new ApiClient(opts.apiUrl ? { baseUrl: opts.apiUrl } : {});
+}
+export function appFor(opts) {
+    return resolveAppName(opts.app);
+}
+/**
+ * Wraps a command action: applies `--json`, turns errors into a concise
+ * message + hint and a meaningful exit code.
+ */
+export function action(fn) {
+    return async (...args) => {
+        const cmd = args[args.length - 1];
+        const opts = (typeof cmd?.optsWithGlobals === 'function' ? cmd.optsWithGlobals() : {});
+        setJsonMode(!!opts.json);
+        try {
+            await fn(...args);
+        }
+        catch (err) {
+            process.exitCode = reportError(err);
+        }
+    };
+}
+//# sourceMappingURL=common.js.map

package/dist/commands/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/commands/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,MAAM,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAS7D,iDAAiD;AACjD,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,OAAO,GAAG;SACP,MAAM,CAAC,QAAQ,EAAE,wCAAwC,CAAC;SAC1D,SAAS,CAAC,IAAI,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAC/F,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,UAAU,CAAC,GAAY,EAAE,YAAY,GAAmB,MAAM;IAC5E,GAAG,CAAC,MAAM,CAAC,cAAc,EAAE,yCAAyC,CAAC,CAAC;IACtE,IAAI,YAAY;QAAE,GAAG,CAAC,MAAM,CAAC,iBAAiB,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;;QAClE,GAAG,CAAC,MAAM,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAgB;IACrC,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAgB;IACrC,OAAO,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAsB,EAAwC;IAClF,OAAO,KAAK,EAAE,GAAG,IAAO,EAAE,EAAE;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAY,CAAC;QAC7C,MAAM,IAAI,GAAG,CAAC,OAAO,GAAG,EAAE,eAAe,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAe,CAAC;QACrG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/commands/lifecycle.d.ts

@@ -0,0 +1,3 @@
+import { type Command } from 'commander';
+export declare function registerLifecycle(program: Command): void;
+export declare function parsePort(v: string): number;

package/dist/commands/lifecycle.js

@@ -0,0 +1,106 @@
+import { relative } from 'node:path';
+import { PLATFORM_DEFAULTS } from '@ericminassian/platform-core';
+import { Option } from 'commander';
+import pc from 'picocolors';
+import { initApp } from '../init.js';
+import { CliError, EXIT, result, success } from '../util/output.js';
+import { action, apiFor, withCommon } from './common.js';
+export function registerLifecycle(program) {
+    withCommon(program
+        .command('init [dir]')
+        .description('scaffold a new app from the template (local files only; create the GitHub repo yourself)')
+        .option('--name <app>', 'app name (default: directory name)')
+        .option('--force', 'write into a non-empty directory')).action(action(async (dir, opts) => {
+        const target = dir ?? opts.name ?? '.';
+        const r = initApp({
+            dir: target,
+            ...(opts.name ? { name: opts.name } : {}),
+            ...(opts.force ? { force: true } : {}),
+        });
+        const rel = relative(process.cwd(), r.dir) || '.';
+        result(r, (v) => [
+            `${pc.green('✓')} created ${pc.bold(v.name)} in ${rel} (${v.files.length} files)`,
+            '',
+            '  next:',
+            rel === '.' ? '' : `    cd ${rel}`,
+            '    pnpm install                               # creates the lockfile CI installs from',
+            '    pnpm dev                                   # local, on the AWS Emulator',
+            `    plat apps create ${v.name} --repo <owner>/${v.name}   # register before the first push`,
+            `    git init && git add -A && git commit -m "Initial commit"`,
+            `    gh repo create <owner>/${v.name} --private --source . --push   # CI deploys https://${v.name}.<domain>`,
+        ]
+            .filter(Boolean)
+            .join('\n'));
+    }));
+    withCommon(program
+        .command('build')
+        .description('bundle the app into deployable artifacts (.plat/build)')
+        .option('--out <dir>', 'output directory')
+        .option('--no-minify', 'skip minification')).action(action(async (opts) => {
+        const { buildApp } = await import('../build.js');
+        const r = await buildApp({
+            cwd: process.cwd(),
+            ...(opts.out ? { outDir: opts.out } : {}),
+            minify: opts.minify,
+        });
+        result({ app: r.manifest.name, files: r.files }, (v) => {
+            success(`built ${v.app}`);
+            return Object.entries(v.files)
+                .map(([k, p]) => `  ${k.padEnd(14)} ${relative(process.cwd(), p)}`)
+                .join('\n');
+        });
+    }));
+    withCommon(program
+        .command('deploy')
+        .description('build and deploy (CI derives the stage: PR → pr-<n>, main → prod)')
+        .option('--stage <stage>', 'target stage (required outside CI)')
+        .option('--no-wait', "don't wait for the deployment to finish")).action(action(async (opts) => {
+        const { deploy } = await import('../deploy.js');
+        const r = await deploy(apiFor(opts), {
+            cwd: process.cwd(),
+            ...(opts.stage ? { stage: opts.stage } : {}),
+            wait: opts.wait,
+        });
+        result({ deployment: r.deployment, url: r.url }, (v) => (v.url ? v.url : undefined));
+    }));
+    const dev = withCommon(program
+        .command('dev')
+        .description('run the app locally against the AWS Emulator')
+        .addOption(new Option('--port <port>', 'local router port')
+        .default(String(PLATFORM_DEFAULTS.localPort))
+        .env('PLAT_DEV_PORT'))
+        .option('--spans', 'also print trace spans (db, queue, fetch calls)')).action(action(async (opts) => {
+        const { runDev } = await import('../dev/index.js');
+        await runDev({
+            cwd: process.cwd(),
+            port: parsePort(opts.port),
+            ...(opts.spans ? { spans: true } : {}),
+        });
+    }));
+    withCommon(dev
+        .command('run-cron <name>')
+        .description('fire a cron now in a running `plat dev` (same --port as `plat dev`)')).action(action(async (name, _opts, cmd) => {
+        // `--port` belongs to `plat dev` (the parent); commander parses it there.
+        const port = cmd.parent?.opts()?.port ?? String(PLATFORM_DEFAULTS.localPort);
+        const { runCronOnDev } = await import('../dev/index.js');
+        await runCronOnDev(name, parsePort(port));
+        result({ cron: name, triggered: true }, () => `${pc.green('✓')} ran ${name}`);
+    }));
+    withCommon(program
+        .command('test')
+        .description('run integration tests against a throwaway AWS Emulator with this app provisioned')
+        .argument('[vitestArgs...]', 'extra arguments for vitest')
+        .allowUnknownOption()).action(action(async (vitestArgs) => {
+        const { runTests } = await import('../dev/test.js');
+        const code = await runTests({ cwd: process.cwd(), args: vitestArgs ?? [] });
+        if (code !== 0)
+            throw new CliError(`tests failed (vitest exit ${code})`, { exitCode: code });
+    }));
+}
+export function parsePort(v) {
+    const n = Number(v);
+    if (!Number.isInteger(n) || n <= 0 || n > 65535)
+        throw new CliError(`invalid port ${v}`, { exitCode: EXIT.usage });
+    return n;
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/commands/lifecycle.js.map

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

package/dist/commands/manage.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerManage(program: Command): void;