@ericminassian/plat 0.0.0-stage → 0.1.0

package/dist/dev/worker.js

@@ -0,0 +1,216 @@
+import { spawn } from 'node:child_process';
+import { resolve } from 'node:path';
+import { EventBridgeClient, ListRulesCommand, ListTargetsByRuleCommand, PutTargetsCommand, RemoveTargetsCommand, } from '@aws-sdk/client-eventbridge';
+import { LambdaClient, ListEventSourceMappingsCommand, UpdateEventSourceMappingCommand, } from '@aws-sdk/client-lambda';
+import { CreateQueueCommand, DeleteMessageBatchCommand, GetQueueAttributesCommand, ReceiveMessageCommand, SetQueueAttributesCommand, SQSClient, } from '@aws-sdk/client-sqs';
+import { names } from '@ericminassian/platform-core';
+import { SDK_WORKER } from '../build.js';
+import { resolveFromApp } from '../project.js';
+import { freePort, waitForPort } from '../util/net.js';
+import { tsxArgs } from './entries.js';
+import { emulatorClientConfig, localEnv } from './local-stage.js';
+import { killTree } from './proc.js';
+export async function startLocalWorker(stage, manifest, root, opts = {}) {
+    if (!manifest.worker)
+        throw new Error('manifest has no worker');
+    const port = await freePort();
+    const env = localEnv(stage, manifest, {
+        PLATFORM_WORKER_ENTRY: resolve(root, manifest.worker.entry),
+        PLATFORM_SDK_WORKER: resolveFromApp(root, SDK_WORKER),
+        PLATFORM_WORKER_PORT: String(port),
+        PLATFORM_WORKER_TIMEOUT_MS: String(manifest.worker.timeoutSeconds * 1000),
+        PLATFORM_WORKER_FUNCTION: stage.result.workerFunction?.name ?? names.workerFunction(manifest.name, stage.stage),
+        PLATFORM_LOG_PRETTY: '1',
+    });
+    const child = spawn(process.execPath, tsxArgs('worker-host', opts.watch !== false), {
+        cwd: root,
+        env,
+        detached: true,
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    await waitForPort(port, '127.0.0.1', 60_000);
+    return {
+        port,
+        child,
+        async invoke(event) {
+            // tsx watch restarts the host on edits; wait for it to come back.
+            await waitForPort(port, '127.0.0.1', 30_000);
+            const res = await fetch(`http://127.0.0.1:${port}/`, { method: 'POST', body: JSON.stringify(event) });
+            return (await res.json());
+        },
+        stop() {
+            killTree(child);
+        },
+    };
+}
+export async function startWorkerDispatch(stage, manifest, worker, log = () => { }) {
+    const cfg = emulatorClientConfig(stage.conn);
+    const sqs = new SQSClient(cfg);
+    const lambda = new LambdaClient(cfg);
+    const events = new EventBridgeClient(cfg);
+    const functionName = stage.result.workerFunction?.name;
+    let stopped = false;
+    // The emulator's own event source mappings would hand messages to its sandboxed runtime; turn them off.
+    if (functionName) {
+        const esms = await lambda
+            .send(new ListEventSourceMappingsCommand({ FunctionName: functionName }))
+            .catch(() => undefined);
+        for (const m of esms?.EventSourceMappings ?? []) {
+            if (m.UUID && m.State !== 'Disabled') {
+                await lambda
+                    .send(new UpdateEventSourceMappingCommand({ UUID: m.UUID, Enabled: false }))
+                    .catch(() => undefined);
+            }
+        }
+    }
+    const loops = [];
+    for (const [name, q] of Object.entries(stage.bindings.queues)) {
+        const batchSize = manifest.queues[name]?.batchSize ?? 10;
+        loops.push(pollQueue(sqs, q.url, batchSize, () => stopped, async (messages) => {
+            const r = await worker.invoke(sqsEvent(messages, q.arn, stage.conn.region));
+            const failed = new Set(r.ok
+                ? (r.result
+                    ?.batchItemFailures ?? []).map((f) => f.itemIdentifier)
+                : messages.map((m) => m.MessageId));
+            log('queue', name, failed.size ? 'error' : 'ok', r.ok ? (failed.size ? `${failed.size} failed` : undefined) : r.error?.message);
+            return messages.filter((m) => !failed.has(m.MessageId));
+        }));
+    }
+    if (functionName && stage.bindings.bus) {
+        const tapUrl = await tapEventRules(sqs, events, stage, functionName);
+        if (tapUrl) {
+            loops.push(pollQueue(sqs, tapUrl, 1, () => stopped, async (messages) => {
+                const done = [];
+                for (const m of messages) {
+                    const event = JSON.parse(m.Body ?? '{}');
+                    const attempts = Number(m.Attributes?.ApproximateReceiveCount ?? '1');
+                    const r = await worker.invoke(event);
+                    log('event', event['detail-type'] ?? '?', r.ok ? 'ok' : 'error', r.error?.message);
+                    // Lambda async invokes retry twice, then drop: same here.
+                    if (r.ok || attempts >= 3)
+                        done.push(m);
+                }
+                return done;
+            }, 5));
+        }
+    }
+    return {
+        async runCron(name) {
+            const r = await worker.invoke({ __platform: 'cron', name });
+            log('cron', name, r.ok ? 'ok' : 'error', r.error?.message);
+            return r;
+        },
+        stop() {
+            stopped = true;
+            sqs.destroy();
+            lambda.destroy();
+            events.destroy();
+        },
+    };
+}
+/** Lambda's SQS event shape. */
+export function sqsEvent(messages, queueArn, region) {
+    return {
+        Records: messages.map((m) => ({
+            messageId: m.MessageId,
+            receiptHandle: m.ReceiptHandle,
+            body: m.Body ?? '',
+            attributes: m.Attributes ?? {},
+            messageAttributes: Object.fromEntries(Object.entries(m.MessageAttributes ?? {}).map(([k, v]) => [
+                k,
+                {
+                    stringValue: v.StringValue,
+                    binaryValue: v.BinaryValue,
+                    dataType: v.DataType,
+                    stringListValues: [],
+                    binaryListValues: [],
+                },
+            ])),
+            md5OfBody: m.MD5OfBody,
+            eventSource: 'aws:sqs',
+            eventSourceARN: queueArn,
+            awsRegion: region,
+        })),
+    };
+}
+/**
+ * Re-point the stage's EventBridge rules from the (sandboxed) emulator Lambda
+ * to a tap queue the dispatcher polls. Returns the tap queue URL.
+ */
+async function tapEventRules(sqs, events, stage, functionName) {
+    const bus = stage.bindings.bus.name;
+    const rules = (await events.send(new ListRulesCommand({ EventBusName: bus })).catch(() => undefined))?.Rules ?? [];
+    if (rules.length === 0)
+        return null;
+    const tapName = `${names.base(stage.bindings.app, stage.stage)}--plat-dev-events`;
+    const tapUrl = (await sqs.send(new CreateQueueCommand({ QueueName: tapName }))).QueueUrl;
+    const tapArn = (await sqs.send(new GetQueueAttributesCommand({ QueueUrl: tapUrl, AttributeNames: ['QueueArn'] }))).Attributes.QueueArn;
+    await sqs.send(new SetQueueAttributesCommand({
+        QueueUrl: tapUrl,
+        Attributes: {
+            Policy: JSON.stringify({
+                Version: '2012-10-17',
+                Statement: [
+                    {
+                        Effect: 'Allow',
+                        Principal: { Service: 'events.amazonaws.com' },
+                        Action: 'sqs:SendMessage',
+                        Resource: tapArn,
+                    },
+                ],
+            }),
+        },
+    }));
+    for (const rule of rules) {
+        if (!rule.Name)
+            continue;
+        const targets = (await events.send(new ListTargetsByRuleCommand({ Rule: rule.Name, EventBusName: bus }))).Targets ?? [];
+        const lambdaTargets = targets.filter((t) => t.Arn?.includes(`:function:${functionName}`));
+        if (lambdaTargets.length === 0)
+            continue;
+        await events.send(new RemoveTargetsCommand({ Rule: rule.Name, EventBusName: bus, Ids: lambdaTargets.map((t) => t.Id) }));
+        await events.send(new PutTargetsCommand({
+            Rule: rule.Name,
+            EventBusName: bus,
+            Targets: [{ Id: 'plat-dev-tap', Arn: tapArn }],
+        }));
+    }
+    return tapUrl;
+}
+/** Long-poll a queue; `handle` returns the messages to delete. */
+async function pollQueue(sqs, url, batchSize, stopped, handle, waitSeconds = 5) {
+    while (!stopped()) {
+        let messages = [];
+        try {
+            messages =
+                (await sqs.send(new ReceiveMessageCommand({
+                    QueueUrl: url,
+                    MaxNumberOfMessages: batchSize,
+                    WaitTimeSeconds: waitSeconds,
+                    MessageSystemAttributeNames: ['All'],
+                    MessageAttributeNames: ['All'],
+                }))).Messages ?? [];
+        }
+        catch {
+            if (stopped())
+                return;
+            await new Promise((r) => setTimeout(r, 1_000));
+            continue;
+        }
+        if (messages.length === 0)
+            continue;
+        try {
+            const done = await handle(messages);
+            if (done.length) {
+                await sqs.send(new DeleteMessageBatchCommand({
+                    QueueUrl: url,
+                    Entries: done.map((m, i) => ({ Id: String(i), ReceiptHandle: m.ReceiptHandle })),
+                }));
+            }
+        }
+        catch {
+            // Leave the messages; they become visible again after the visibility timeout.
+        }
+    }
+}
+//# sourceMappingURL=worker.js.map

package/dist/dev/worker.js.map

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

package/dist/github.d.ts

@@ -0,0 +1,39 @@
+/** GitHub Actions environment, read from `process.env` (injectable for tests). */
+export type Env = Record<string, string | undefined>;
+export declare function isGitHubActions(env?: Env): boolean;
+interface GitHubEvent {
+    number?: number;
+    pull_request?: {
+        number?: number;
+        head?: {
+            sha?: string;
+            ref?: string;
+        };
+        title?: string;
+    };
+    head_commit?: {
+        message?: string;
+    };
+    repository?: {
+        default_branch?: string;
+    };
+}
+export declare function readEvent(env?: Env): GitHubEvent;
+/**
+ * The stage a CI run deploys to: `pr-<n>` for pull requests, `prod` for pushes
+ * (or manual runs) on the default branch. `explicit` (from `--stage`) wins.
+ */
+export declare function deriveStage(explicit: string | undefined, env?: Env): string;
+/** Commit metadata for the deployment record. */
+export declare function gitInfo(cwd: string, env?: Env): {
+    commit?: string;
+    ref?: string;
+    message?: string;
+};
+/** GitHub Actions OIDC token for `audience` (requires `permissions: id-token: write`). */
+export declare function fetchOidcToken(audience: string, env?: Env): Promise<string>;
+export declare function canUseOidc(env?: Env): boolean;
+/** `key=value` into `$GITHUB_OUTPUT` (no-op outside Actions). */
+export declare function setOutput(key: string, value: string, env?: Env): void;
+export declare function appendStepSummary(markdown: string, env?: Env): void;
+export {};

package/dist/github.js

@@ -0,0 +1,108 @@
+import { execFileSync } from 'node:child_process';
+import { appendFileSync, readFileSync } from 'node:fs';
+import { PROD_STAGE, previewStage, validateStageName } from '@ericminassian/platform-core';
+import { CliError, EXIT } from './util/output.js';
+export function isGitHubActions(env = process.env) {
+    return env.GITHUB_ACTIONS === 'true';
+}
+export function readEvent(env = process.env) {
+    if (!env.GITHUB_EVENT_PATH)
+        return {};
+    try {
+        return JSON.parse(readFileSync(env.GITHUB_EVENT_PATH, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * The stage a CI run deploys to: `pr-<n>` for pull requests, `prod` for pushes
+ * (or manual runs) on the default branch. `explicit` (from `--stage`) wins.
+ */
+export function deriveStage(explicit, env = process.env) {
+    if (explicit) {
+        const err = validateStageName(explicit);
+        if (err)
+            throw new CliError(err, { exitCode: EXIT.usage });
+        return explicit;
+    }
+    if (!isGitHubActions(env)) {
+        throw new CliError('no stage given', {
+            hint: 'pass --stage <name> (CI derives it: pull requests → pr-<n>, main → prod)',
+            exitCode: EXIT.usage,
+        });
+    }
+    const event = readEvent(env);
+    const name = env.GITHUB_EVENT_NAME;
+    if (name === 'pull_request' || name === 'pull_request_target') {
+        const n = event.pull_request?.number ?? event.number;
+        if (!n)
+            throw new CliError('pull_request event without a PR number', { exitCode: EXIT.usage });
+        return previewStage(n);
+    }
+    const defaultBranch = event.repository?.default_branch ?? 'main';
+    if (env.GITHUB_REF === `refs/heads/${defaultBranch}`)
+        return PROD_STAGE;
+    throw new CliError(`can't derive a stage for ${name ?? 'this event'} on ${env.GITHUB_REF ?? 'unknown ref'}`, {
+        hint: 'pass --stage explicitly',
+        exitCode: EXIT.usage,
+    });
+}
+/** Commit metadata for the deployment record. */
+export function gitInfo(cwd, env = process.env) {
+    if (isGitHubActions(env)) {
+        const event = readEvent(env);
+        return {
+            commit: event.pull_request?.head?.sha ?? env.GITHUB_SHA,
+            ref: event.pull_request?.head?.ref ? `refs/heads/${event.pull_request.head.ref}` : env.GITHUB_REF,
+            message: (event.pull_request?.title ?? event.head_commit?.message)?.split('\n')[0],
+        };
+    }
+    const git = (...args) => {
+        try {
+            return execFileSync('git', args, { cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+        }
+        catch {
+            return undefined;
+        }
+    };
+    const branch = git('rev-parse', '--abbrev-ref', 'HEAD');
+    return {
+        commit: git('rev-parse', 'HEAD'),
+        ref: branch ? `refs/heads/${branch}` : undefined,
+        message: git('log', '-1', '--format=%s'),
+    };
+}
+/** GitHub Actions OIDC token for `audience` (requires `permissions: id-token: write`). */
+export async function fetchOidcToken(audience, env = process.env) {
+    const url = env.ACTIONS_ID_TOKEN_REQUEST_URL;
+    const token = env.ACTIONS_ID_TOKEN_REQUEST_TOKEN;
+    if (!url || !token) {
+        throw new CliError('GitHub Actions OIDC is not available', {
+            hint: 'add `permissions: { id-token: write }` to the workflow',
+            exitCode: EXIT.auth,
+        });
+    }
+    const res = await fetch(`${url}${url.includes('?') ? '&' : '?'}audience=${encodeURIComponent(audience)}`, {
+        headers: { authorization: `bearer ${token}`, accept: 'application/json' },
+    });
+    if (!res.ok)
+        throw new CliError(`OIDC token request failed: HTTP ${res.status}`, { exitCode: EXIT.auth });
+    const body = (await res.json());
+    if (!body.value)
+        throw new CliError('OIDC token response had no value', { exitCode: EXIT.auth });
+    return body.value;
+}
+export function canUseOidc(env = process.env) {
+    return isGitHubActions(env) && !!env.ACTIONS_ID_TOKEN_REQUEST_URL && !!env.ACTIONS_ID_TOKEN_REQUEST_TOKEN;
+}
+/** `key=value` into `$GITHUB_OUTPUT` (no-op outside Actions). */
+export function setOutput(key, value, env = process.env) {
+    if (env.GITHUB_OUTPUT)
+        appendFileSync(env.GITHUB_OUTPUT, `${key}=${value}\n`);
+}
+export function appendStepSummary(markdown, env = process.env) {
+    if (env.GITHUB_STEP_SUMMARY)
+        appendFileSync(env.GITHUB_STEP_SUMMARY, `${markdown}\n`);
+}
+//# sourceMappingURL=github.js.map

package/dist/github.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @ericminassian/plat — programmatic API of the CLI. The foundation deploy
+ * and tests import `buildApp`; everything else is for the `plat` binary.
+ */
+export { ApiClient, ApiError, apiBaseUrl } from './api.ts';
+export { type BuildOptions, type BuildResult, buildApp, bundleWorker, validateForBuild } from './build.ts';
+export { configDir, credentialsPath, loadCredentials, type StoredCredentials } from './credentials.ts';
+export { type DeployOptions, type DeployResult, deploy, presignedPostForm, waitForDeployment, } from './deploy.ts';
+export { type LocalStage, localEnv, startLocalStage } from './dev/local-stage.ts';
+export { deriveStage, fetchOidcToken, gitInfo, isGitHubActions } from './github.ts';
+export { type InitOptions, type InitResult, initApp, TEMPLATE_APP_NAME } from './init.ts';
+export { createProgram, main } from './main.ts';
+export { findProjectRoot, loadProject, type Project } from './project.ts';
+export { CliError, EXIT } from './util/output.ts';

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * @ericminassian/plat — programmatic API of the CLI. The foundation deploy
+ * and tests import `buildApp`; everything else is for the `plat` binary.
+ */
+export { ApiClient, ApiError, apiBaseUrl } from './api.js';
+export { buildApp, bundleWorker, validateForBuild } from './build.js';
+export { configDir, credentialsPath, loadCredentials } from './credentials.js';
+export { deploy, presignedPostForm, waitForDeployment, } from './deploy.js';
+export { localEnv, startLocalStage } from './dev/local-stage.js';
+export { deriveStage, fetchOidcToken, gitInfo, isGitHubActions } from './github.js';
+export { initApp, TEMPLATE_APP_NAME } from './init.js';
+export { createProgram, main } from './main.js';
+export { findProjectRoot, loadProject } from './project.js';
+export { CliError, EXIT } from './util/output.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAuC,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC3G,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAA0B,MAAM,kBAAkB,CAAC;AACvG,OAAO,EAGL,MAAM,EACN,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAmB,QAAQ,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAqC,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAgB,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,23 @@
+/** The app name used throughout `templates/app`; replaced on `plat init`. */
+export declare const TEMPLATE_APP_NAME = "template-app";
+export declare const TEMPLATE_PACKAGE_NAME = "platform-app-template";
+/** Written into new apps so CI's corepack uses the same pnpm as the platform. */
+export declare const PACKAGE_MANAGER = "pnpm@12.11.2";
+/** Published CLI: `template/` inside the package. In this repo: `templates/app`. */
+export declare function templateDir(): string;
+export interface InitOptions {
+    dir: string;
+    name?: string;
+    force?: boolean;
+    /** Version range written for platform packages. Default `^<cli version>`. */
+    versionRange?: string;
+    template?: string;
+}
+export interface InitResult {
+    dir: string;
+    name: string;
+    files: string[];
+}
+export declare function initApp(opts: InitOptions): InitResult;
+export declare function replaceAppName(content: string, name: string): string;
+export declare function rewritePackageJson(content: string, name: string, range: string): string;

package/dist/init.js

@@ -0,0 +1,102 @@
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync, } from 'node:fs';
+import { basename, dirname, extname, join, relative, resolve } from 'node:path';
+import { validateAppName } from '@ericminassian/platform-core';
+import { cliPackageRoot, cliVersion } from './project.js';
+import { CliError, EXIT } from './util/output.js';
+/** The app name used throughout `templates/app`; replaced on `plat init`. */
+export const TEMPLATE_APP_NAME = 'template-app';
+export const TEMPLATE_PACKAGE_NAME = 'platform-app-template';
+/** Written into new apps so CI's corepack uses the same pnpm as the platform. */
+export const PACKAGE_MANAGER = 'pnpm@12.11.2';
+const SKIP = new Set(['node_modules', '.plat', 'dist', 'coverage', '.turbo']);
+const TEXT_EXT = new Set([
+    '.ts',
+    '.tsx',
+    '.js',
+    '.mjs',
+    '.cjs',
+    '.json',
+    '.md',
+    '.html',
+    '.css',
+    '.yml',
+    '.yaml',
+    '.txt',
+    '.gitignore',
+    '',
+]);
+/** Published CLI: `template/` inside the package. In this repo: `templates/app`. */
+export function templateDir() {
+    const packaged = join(cliPackageRoot(), 'template');
+    if (existsSync(join(packaged, 'platform.json')))
+        return packaged;
+    const repo = resolve(cliPackageRoot(), '..', '..', 'templates', 'app');
+    if (existsSync(join(repo, 'platform.json')))
+        return repo;
+    throw new CliError('app template not found (broken CLI install?)');
+}
+export function initApp(opts) {
+    const dir = resolve(opts.dir);
+    const name = opts.name ?? basename(dir);
+    const err = validateAppName(name);
+    if (err)
+        throw new CliError(`invalid app name: ${err}`, { exitCode: EXIT.usage });
+    if (existsSync(dir) && readdirSync(dir).filter((f) => f !== '.git').length > 0 && !opts.force) {
+        throw new CliError(`${dir} is not empty`, {
+            hint: 'choose an empty directory or pass --force',
+            exitCode: EXIT.usage,
+        });
+    }
+    const src = opts.template ?? templateDir();
+    const range = opts.versionRange ?? `^${cliVersion()}`;
+    const files = copyTree(src, dir, (rel, content) => rel === 'package.json' ? rewritePackageJson(content, name, range) : replaceAppName(content, name));
+    return { dir, name, files: files.sort() };
+}
+export function replaceAppName(content, name) {
+    return content.split(TEMPLATE_APP_NAME).join(name);
+}
+export function rewritePackageJson(content, name, range) {
+    const pkg = JSON.parse(content);
+    pkg.name = name;
+    pkg.packageManager ??= PACKAGE_MANAGER;
+    for (const field of ['dependencies', 'devDependencies', 'peerDependencies', 'optionalDependencies']) {
+        const deps = pkg[field];
+        if (!deps)
+            continue;
+        for (const [dep, v] of Object.entries(deps))
+            if (v.startsWith('workspace:'))
+                deps[dep] = range;
+    }
+    return `${JSON.stringify(pkg, null, 2)}\n`;
+}
+/** Copies `src` to `dest`, transforming text files; returns the written paths (relative). */
+function copyTree(src, dest, transform) {
+    const written = [];
+    const walk = (from) => {
+        for (const entry of readdirSync(from, { withFileTypes: true })) {
+            if (SKIP.has(entry.name))
+                continue;
+            const abs = join(from, entry.name);
+            const rel = relative(src, abs).split('\\').join('/');
+            if (rel === 'web/dist')
+                continue;
+            if (entry.isDirectory()) {
+                walk(abs);
+                continue;
+            }
+            // npm drops `.gitignore` from packages, so the published template stores `_gitignore`.
+            const outRel = rel.replace(/(^|\/)_gitignore$/, '$1.gitignore');
+            const target = join(dest, outRel);
+            mkdirSync(dirname(target), { recursive: true });
+            const isText = TEXT_EXT.has(extname(entry.name)) && statSync(abs).size < 1_000_000;
+            if (isText)
+                writeFileSync(target, transform(outRel, readFileSync(abs, 'utf8')));
+            else
+                copyFileSync(abs, target);
+            written.push(outRel);
+        }
+    };
+    walk(src);
+    return written;
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createProgram(): Command;
+export declare function main(argv: string[]): Promise<void>;

package/dist/main.js

@@ -0,0 +1,24 @@
+import { Command } from 'commander';
+import { registerAccount } from './commands/account.js';
+import { registerApps } from './commands/apps.js';
+import { registerLifecycle } from './commands/lifecycle.js';
+import { registerManage } from './commands/manage.js';
+import { registerObserve } from './commands/observe.js';
+import { cliVersion } from './project.js';
+export function createProgram() {
+    const program = new Command('plat')
+        .description('The platform CLI: create, run locally (AWS Emulator), deploy and observe apps.\nEvery command accepts --json for machine-readable output.')
+        .version(cliVersion(), '-v, --version')
+        .showHelpAfterError('(run with --help for usage)')
+        .configureHelp({ sortSubcommands: false });
+    registerLifecycle(program);
+    registerApps(program);
+    registerAccount(program);
+    registerObserve(program);
+    registerManage(program);
+    return program;
+}
+export async function main(argv) {
+    await createProgram().parseAsync(argv);
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;SAChC,WAAW,CACV,2IAA2I,CAC5I;SACA,OAAO,CAAC,UAAU,EAAE,EAAE,eAAe,CAAC;SACtC,kBAAkB,CAAC,6BAA6B,CAAC;SACjD,aAAa,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC;IAE7C,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC3B,YAAY,CAAC,OAAO,CAAC,CAAC;IACtB,eAAe,CAAC,OAAO,CAAC,CAAC;IACzB,eAAe,CAAC,OAAO,CAAC,CAAC;IACzB,cAAc,CAAC,OAAO,CAAC,CAAC;IACxB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAc;IACvC,MAAM,aAAa,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC"}

package/dist/project.d.ts

@@ -0,0 +1,22 @@
+import { type ResolvedManifest } from '@ericminassian/platform-core';
+export declare const MANIFEST_FILE = "platform.json";
+export interface Project {
+    /** Directory containing platform.json. */
+    root: string;
+    /** platform.json as written. */
+    raw: Record<string, unknown>;
+    manifest: ResolvedManifest;
+}
+/** Walk up from `cwd` to the nearest platform.json. */
+export declare function findProjectRoot(cwd: string): string | null;
+export declare function loadProject(cwd: string): Project;
+/** App name from `--app`, else the nearest platform.json. */
+export declare function resolveAppName(opt: string | undefined, cwd?: string): string;
+export declare function cliVersion(): string;
+export declare function cliPackageRoot(): string;
+/**
+ * Resolve a module the way the *app* would (its own node_modules first), so
+ * the server wrapper and app code share one copy of the SDK. Falls back to the
+ * CLI's own dependency.
+ */
+export declare function resolveFromApp(appRoot: string, specifier: string): string;