@ericminassian/plat 0.0.0-stage → 0.1.0

package/dist/project.js

@@ -0,0 +1,81 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { ManifestError, parseManifest } from '@ericminassian/platform-core';
+import { CliError, EXIT } from './util/output.js';
+export const MANIFEST_FILE = 'platform.json';
+/** Walk up from `cwd` to the nearest platform.json. */
+export function findProjectRoot(cwd) {
+    let dir = resolve(cwd);
+    for (;;) {
+        if (existsSync(join(dir, MANIFEST_FILE)))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+export function loadProject(cwd) {
+    const root = findProjectRoot(cwd);
+    if (!root) {
+        throw new CliError(`no ${MANIFEST_FILE} found in ${cwd} or its parents`, {
+            hint: 'run this inside an app, or create one with `plat init <dir> --name <app>`',
+            exitCode: EXIT.usage,
+        });
+    }
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(join(root, MANIFEST_FILE), 'utf8'));
+    }
+    catch (err) {
+        throw new CliError(`${MANIFEST_FILE} is not valid JSON: ${err.message}`, {
+            exitCode: EXIT.usage,
+        });
+    }
+    try {
+        return { root, raw, manifest: parseManifest(raw) };
+    }
+    catch (err) {
+        if (err instanceof ManifestError)
+            throw new CliError(err.message, { exitCode: EXIT.usage });
+        throw err;
+    }
+}
+/** App name from `--app`, else the nearest platform.json. */
+export function resolveAppName(opt, cwd = process.cwd()) {
+    if (opt)
+        return opt;
+    const root = findProjectRoot(cwd);
+    if (!root) {
+        throw new CliError('no app given', {
+            hint: 'pass --app <name> or run inside an app directory',
+            exitCode: EXIT.usage,
+        });
+    }
+    return loadProject(root).manifest.name;
+}
+export function cliVersion() {
+    return cliPackageJson().version ?? '0.0.0';
+}
+export function cliPackageRoot() {
+    return fileURLToPath(new URL('..', import.meta.url));
+}
+function cliPackageJson() {
+    return JSON.parse(readFileSync(join(cliPackageRoot(), 'package.json'), 'utf8'));
+}
+/**
+ * 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 function resolveFromApp(appRoot, specifier) {
+    try {
+        return createRequire(join(appRoot, 'package.json')).resolve(specifier);
+    }
+    catch {
+        return createRequire(import.meta.url).resolve(specifier);
+    }
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

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

package/dist/util/net.d.ts

@@ -0,0 +1,4 @@
+/** A free TCP port on 127.0.0.1. */
+export declare function freePort(): Promise<number>;
+/** Resolves once something accepts TCP connections on host:port. */
+export declare function waitForPort(port: number, host?: string, timeoutMs?: number): Promise<void>;

package/dist/util/net.js

@@ -0,0 +1,33 @@
+import { createServer } from 'node:net';
+/** A free TCP port on 127.0.0.1. */
+export function freePort() {
+    return new Promise((resolve, reject) => {
+        const srv = createServer();
+        srv.once('error', reject);
+        srv.listen(0, '127.0.0.1', () => {
+            const addr = srv.address();
+            const port = typeof addr === 'object' && addr ? addr.port : 0;
+            srv.close(() => resolve(port));
+        });
+    });
+}
+/** Resolves once something accepts TCP connections on host:port. */
+export async function waitForPort(port, host = '127.0.0.1', timeoutMs = 30_000) {
+    const { connect } = await import('node:net');
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const ok = await new Promise((resolve) => {
+            const s = connect(port, host);
+            s.once('connect', () => {
+                s.end();
+                resolve(true);
+            });
+            s.once('error', () => resolve(false));
+        });
+        if (ok)
+            return;
+        await new Promise((r) => setTimeout(r, 200));
+    }
+    throw new Error(`nothing listening on ${host}:${port} after ${timeoutMs}ms`);
+}
+//# sourceMappingURL=net.js.map

package/dist/util/net.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"net.js","sourceRoot":"","sources":["../../src/util/net.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,oCAAoC;AACpC,MAAM,UAAU,QAAQ;IACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;QAC3B,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE;YAC9B,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9D,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,IAAI,GAAG,WAAW,EAAE,SAAS,GAAG,MAAM;IACpF,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,MAAM,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;YAChD,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC9B,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;gBACrB,CAAC,CAAC,GAAG,EAAE,CAAC;gBACR,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;YACH,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QACH,IAAI,EAAE;YAAE,OAAO;QACf,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,IAAI,IAAI,UAAU,SAAS,IAAI,CAAC,CAAC;AAC/E,CAAC"}

package/dist/util/output.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Output conventions: human-readable by default, `--json` prints exactly one
+ * JSON document on stdout (progress goes to stderr) so agents can parse it.
+ */
+export declare class CliError extends Error {
+    readonly hint?: string;
+    readonly exitCode: number;
+    constructor(message: string, opts?: {
+        hint?: string;
+        exitCode?: number;
+    });
+}
+export declare const EXIT: {
+    readonly ok: 0;
+    readonly error: 1;
+    readonly usage: 2;
+    readonly auth: 3;
+    readonly notFound: 4;
+    readonly deployFailed: 5;
+};
+export interface OutputOptions {
+    json?: boolean;
+}
+export declare function setJsonMode(on: boolean): void;
+export declare function isJsonMode(): boolean;
+/** Progress/status lines; stderr so `--json` stdout stays clean. */
+export declare function info(msg: string): void;
+export declare function step(msg: string): void;
+export declare function success(msg: string): void;
+export declare function warn(msg: string): void;
+/** Prints the command result: JSON in `--json` mode, else via `human`. */
+export declare function result<T>(value: T, human: (v: T) => string | undefined): void;
+export declare function formatError(err: unknown): {
+    message: string;
+    hint?: string;
+    exitCode: number;
+};
+export declare function reportError(err: unknown): number;
+/** Plain-text table with padded columns. */
+export declare function table(rows: Array<Record<string, unknown>>, columns?: string[]): string;
+/** Unicode sparkline; nulls render as spaces. */
+export declare function sparkline(values: Array<number | null>): string;

package/dist/util/output.js

@@ -0,0 +1,105 @@
+import pc from 'picocolors';
+/**
+ * Output conventions: human-readable by default, `--json` prints exactly one
+ * JSON document on stdout (progress goes to stderr) so agents can parse it.
+ */
+export class CliError extends Error {
+    hint;
+    exitCode;
+    constructor(message, opts = {}) {
+        super(message);
+        this.hint = opts.hint;
+        this.exitCode = opts.exitCode ?? 1;
+    }
+}
+export const EXIT = {
+    ok: 0,
+    error: 1,
+    usage: 2,
+    auth: 3,
+    notFound: 4,
+    deployFailed: 5,
+};
+let jsonMode = false;
+export function setJsonMode(on) {
+    jsonMode = on;
+}
+export function isJsonMode() {
+    return jsonMode;
+}
+/** Progress/status lines; stderr so `--json` stdout stays clean. */
+export function info(msg) {
+    process.stderr.write(`${msg}\n`);
+}
+export function step(msg) {
+    info(`${pc.cyan('›')} ${msg}`);
+}
+export function success(msg) {
+    info(`${pc.green('✓')} ${msg}`);
+}
+export function warn(msg) {
+    info(`${pc.yellow('!')} ${msg}`);
+}
+/** Prints the command result: JSON in `--json` mode, else via `human`. */
+export function result(value, human) {
+    if (jsonMode) {
+        process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+        return;
+    }
+    const text = human(value);
+    if (text)
+        process.stdout.write(`${text}\n`);
+}
+export function formatError(err) {
+    if (err instanceof CliError)
+        return { message: err.message, hint: err.hint, exitCode: err.exitCode };
+    if (err instanceof Error)
+        return { message: err.message, exitCode: EXIT.error };
+    return { message: String(err), exitCode: EXIT.error };
+}
+export function reportError(err) {
+    const { message, hint, exitCode } = formatError(err);
+    if (jsonMode) {
+        process.stdout.write(`${JSON.stringify({ error: { message, hint, exitCode } }, null, 2)}\n`);
+    }
+    else {
+        info(`${pc.red('✗')} ${message}`);
+        if (hint)
+            info(`  ${pc.dim(hint)}`);
+    }
+    return exitCode;
+}
+/** Plain-text table with padded columns. */
+export function table(rows, columns) {
+    if (rows.length === 0)
+        return pc.dim('(none)');
+    const cols = columns ?? Object.keys(rows[0]);
+    const cell = (v) => v === undefined || v === null ? '' : typeof v === 'object' ? JSON.stringify(v) : String(v);
+    const widths = cols.map((c) => Math.max(c.length, ...rows.map((r) => visibleLength(cell(r[c])))));
+    const line = (vals) => vals.map((v, i) => v + ' '.repeat(widths[i] - visibleLength(v))).join('  ');
+    return [pc.bold(line(cols)), ...rows.map((r) => line(cols.map((c) => cell(r[c]))))].join('\n');
+}
+// biome-ignore lint/suspicious/noControlCharactersInRegex: matching ANSI escape codes is the point
+const ANSI = /\x1b\[[0-9;]*m/g;
+function visibleLength(s) {
+    return s.replace(ANSI, '').length;
+}
+const SPARKS = ['▁', '▂', '▃', '▄', '▅', '▆', '▇', '█'];
+/** Unicode sparkline; nulls render as spaces. */
+export function sparkline(values) {
+    const nums = values.filter((v) => v !== null && Number.isFinite(v));
+    if (nums.length === 0)
+        return '';
+    const min = Math.min(...nums);
+    const max = Math.max(...nums);
+    return values
+        .map((v) => {
+        if (v === null || !Number.isFinite(v))
+            return ' ';
+        if (max === min)
+            return v === 0 ? SPARKS[0] : SPARKS[3];
+        return SPARKS[Math.round(((v - min) / (max - min)) * (SPARKS.length - 1))];
+    })
+        .join('');
+}
+//# sourceMappingURL=output.js.map

package/dist/util/output.js.map

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

package/dist/util/prompt.d.ts

@@ -0,0 +1,3 @@
+export declare function prompt(question: string): Promise<string>;
+/** Ask the user to type `expected` back; `--yes` skips it, and non-interactive runs must pass it. */
+export declare function confirmByTyping(question: string, expected: string, yes?: boolean): Promise<void>;

package/dist/util/prompt.js

@@ -0,0 +1,22 @@
+import { createInterface } from 'node:readline/promises';
+import { CliError, EXIT } from './output.js';
+export async function prompt(question) {
+    const rl = createInterface({ input: process.stdin, output: process.stderr });
+    try {
+        return await rl.question(question);
+    }
+    finally {
+        rl.close();
+    }
+}
+/** Ask the user to type `expected` back; `--yes` skips it, and non-interactive runs must pass it. */
+export async function confirmByTyping(question, expected, yes) {
+    if (yes)
+        return;
+    if (!process.stdin.isTTY)
+        throw new CliError('confirmation needed', { hint: 'pass --yes', exitCode: EXIT.usage });
+    const answer = await prompt(`${question} type ${expected} to confirm: `);
+    if (answer.trim() !== expected)
+        throw new CliError('aborted', { exitCode: EXIT.usage });
+}
+//# sourceMappingURL=prompt.js.map

package/dist/util/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/util/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAgB;IAC3C,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7E,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,qGAAqG;AACrG,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,QAAgB,EAAE,GAAa;IACrF,IAAI,GAAG;QAAE,OAAO;IAChB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK;QACtB,MAAM,IAAI,QAAQ,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1F,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,QAAQ,SAAS,QAAQ,eAAe,CAAC,CAAC;IACzE,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,QAAQ;QAAE,MAAM,IAAI,QAAQ,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;AAC1F,CAAC"}

package/dist/util/time.d.ts

@@ -0,0 +1,11 @@
+import type { Resolution } from '@ericminassian/platform-core';
+/** `"90s" | "15m" | "6h" | "7d" | "2w"` → milliseconds. */
+export declare function parseDuration(input: string): number;
+/** Pick a rollup resolution that yields a readable number of points. */
+export declare function resolutionFor(rangeMs: number): Resolution;
+export declare function sinceRange(since: string, now?: number): {
+    from: number;
+    to: number;
+    res: Resolution;
+};
+export declare function shortTime(iso: string | number): string;

package/dist/util/time.js

@@ -0,0 +1,29 @@
+import { CliError, EXIT } from './output.js';
+const UNITS = { s: 1_000, m: 60_000, h: 3_600_000, d: 86_400_000, w: 604_800_000 };
+/** `"90s" | "15m" | "6h" | "7d" | "2w"` → milliseconds. */
+export function parseDuration(input) {
+    const m = /^(\d+(?:\.\d+)?)\s*([smhdw])$/.exec(input.trim());
+    if (!m)
+        throw new CliError(`invalid duration "${input}"`, { hint: 'use e.g. 30m, 6h, 7d', exitCode: EXIT.usage });
+    return Number(m[1]) * UNITS[m[2]];
+}
+/** Pick a rollup resolution that yields a readable number of points. */
+export function resolutionFor(rangeMs) {
+    if (rangeMs <= 6 * UNITS.h)
+        return '1m';
+    if (rangeMs <= 14 * UNITS.d)
+        return '1h';
+    return '1d';
+}
+export function sinceRange(since, now = Date.now()) {
+    const ms = parseDuration(since);
+    return { from: now - ms, to: now, res: resolutionFor(ms) };
+}
+export function shortTime(iso) {
+    const d = new Date(iso);
+    return d
+        .toISOString()
+        .replace('T', ' ')
+        .replace(/\.\d+Z$/, 'Z');
+}
+//# sourceMappingURL=time.js.map

package/dist/util/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/util/time.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,KAAK,GAA2B,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC;AAE3G,2DAA2D;AAC3D,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,CAAC,GAAG,+BAA+B,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7D,IAAI,CAAC,CAAC;QACJ,MAAM,IAAI,QAAQ,CAAC,qBAAqB,KAAK,GAAG,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC5G,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAE,CAAE,CAAC;AACtC,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,CAAC,CAAE;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,OAAO,IAAI,EAAE,GAAG,KAAK,CAAC,CAAE;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IACxD,MAAM,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAChC,OAAO,EAAE,IAAI,EAAE,GAAG,GAAG,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,aAAa,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAoB;IAC5C,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,CAAC;SACL,WAAW,EAAE;SACb,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC;SACjB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AAC7B,CAAC"}

package/dist/util/zip.d.ts

@@ -0,0 +1,10 @@
+/** Every file under `dir`, as zip paths (forward slashes) → absolute paths. */
+export declare function listFiles(dir: string): Array<{
+    zipPath: string;
+    absPath: string;
+}>;
+/** Zip a directory. Timestamps are fixed so identical inputs produce identical zips. */
+export declare function zipDirectory(dir: string): Uint8Array;
+export declare function zipEntries(entries: Record<string, Uint8Array | string>): Uint8Array;
+export declare function zipFileNames(zip: Uint8Array): string[];
+export declare function dirExists(path: string): boolean;

package/dist/util/zip.js

@@ -0,0 +1,45 @@
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+import { unzipSync, zipSync } from 'fflate';
+/** Every file under `dir`, as zip paths (forward slashes) → absolute paths. */
+export function listFiles(dir) {
+    const out = [];
+    const walk = (d) => {
+        for (const entry of readdirSync(d, { withFileTypes: true })) {
+            const abs = join(d, entry.name);
+            if (entry.isDirectory())
+                walk(abs);
+            else if (entry.isFile())
+                out.push({ zipPath: relative(dir, abs).split(sep).join('/'), absPath: abs });
+        }
+    };
+    walk(dir);
+    return out.sort((a, b) => a.zipPath.localeCompare(b.zipPath));
+}
+/** Zip a directory. Timestamps are fixed so identical inputs produce identical zips. */
+export function zipDirectory(dir) {
+    const files = {};
+    for (const f of listFiles(dir))
+        files[f.zipPath] = [readFileSync(f.absPath), { mtime: FIXED_MTIME }];
+    return zipSync(files, { level: 6 });
+}
+export function zipEntries(entries) {
+    const files = {};
+    for (const [name, data] of Object.entries(entries)) {
+        files[name] = [typeof data === 'string' ? new TextEncoder().encode(data) : data, { mtime: FIXED_MTIME }];
+    }
+    return zipSync(files, { level: 6 });
+}
+export function zipFileNames(zip) {
+    return Object.keys(unzipSync(zip)).sort();
+}
+export function dirExists(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+const FIXED_MTIME = new Date('2020-01-01T00:00:00Z');
+//# sourceMappingURL=zip.js.map

package/dist/util/zip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.js","sourceRoot":"","sources":["../../src/util/zip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,SAAS,EAAiB,OAAO,EAAE,MAAM,QAAQ,CAAC;AAE3D,+EAA+E;AAC/E,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,GAAG,GAAgD,EAAE,CAAC;IAC5D,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE;QACzB,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,KAAK,CAAC,WAAW,EAAE;gBAAE,IAAI,CAAC,GAAG,CAAC,CAAC;iBAC9B,IAAI,KAAK,CAAC,MAAM,EAAE;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QACxG,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC;QAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IACrG,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAA4C;IACrE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IAC3G,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAe;IAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,sBAAsB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "@ericminassian/plat",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "CLI for the platform: init, dev (AWS Emulator), build, deploy, logs, metrics, errors, data.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eric-minassian/platform.git",
+    "directory": "packages/cli"
+  },
+  "bin": {
+    "plat": "./dist/bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "src",
+    "template"
+  ],
+  "dependencies": {
+    "@aws-sdk/client-cloudwatch-logs": "^3.1169.0",
+    "@aws-sdk/client-cognito-identity-provider": "^3.1169.0",
+    "@aws-sdk/client-eventbridge": "^3.1169.0",
+    "@aws-sdk/client-lambda": "^3.1169.0",
+    "@aws-sdk/client-s3": "^3.1169.0",
+    "@aws-sdk/client-sqs": "^3.1169.0",
+    "@aws-sdk/client-ssm": "^3.1169.0",
+    "@ericminassian/platform": "0.1.0",
+    "@ericminassian/platform-core": "0.1.0",
+    "@ericminassian/platform-engine": "0.1.0",
+    "commander": "^15.1.0",
+    "cron-parser": "^5.10.6",
+    "esbuild": "^0.28.2",
+    "fflate": "^0.8.3",
+    "picocolors": "^1.1.1",
+    "tsx": "^4.23.15"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node scripts/copy-template.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:integration": "vitest run --config vitest.integration.config.ts"
+  }
 }

package/src/api-types.ts

@@ -0,0 +1,8 @@
+/** Re-exports of the core API DTOs plus the few shapes core doesn't define. */
+export * from '@ericminassian/platform-core';
+
+export interface StoredObjectInfo {
+  key: string;
+  size: number;
+  lastModified?: string;
+}