@ericminassian/plat 0.0.0-stage → 0.1.0

package/dist/api-types.d.ts

@@ -0,0 +1,7 @@
+/** 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;
+}

package/dist/api-types.js

@@ -0,0 +1,3 @@
+/** Re-exports of the core API DTOs plus the few shapes core doesn't define. */
+export * from '@ericminassian/platform-core';
+//# sourceMappingURL=api-types.js.map

package/dist/api-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-types.js","sourceRoot":"","sources":["../src/api-types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,cAAc,8BAA8B,CAAC"}

package/dist/api.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Typed client for the control plane API (`/v1`). Route shapes follow the
+ * design in docs/DESIGN.md; list endpoints return `{ <plural>: [...] }`.
+ *
+ * Auth, in order: an explicit token, GitHub Actions OIDC (CI), the token
+ * stored by `plat login`.
+ */
+import { type AppRecord, type AppSummary, type CliLoginRequest, type CliLoginResponse, type CreateAppRequest, type CreateDeploymentRequest, type CreateDeploymentResponse, type DataPage, type DeploymentRecord, type ErrorGroup, type JobStats, type LogLine, type LogsResponse, type MeResponse, type MetricsResponse, type QueueStats, type Resolution, type RouteStats, type SecretInfo, type StageRecord, type StoredObjectInfo, type TraceResponse } from './api-types.ts';
+import { CliError } from './util/output.ts';
+export declare function apiBaseUrl(env?: NodeJS.ProcessEnv): string;
+export declare class ApiError extends CliError {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+export type AuthMode = 'auto' | 'token' | 'oidc' | 'none';
+export interface ApiClientOptions {
+    baseUrl?: string;
+    token?: string;
+    auth?: AuthMode;
+    fetch?: typeof fetch;
+}
+type Query = Record<string, string | number | boolean | undefined>;
+export declare class ApiClient {
+    readonly baseUrl: string;
+    private readonly fetchImpl;
+    private readonly authMode;
+    private token?;
+    constructor(opts?: ApiClientOptions);
+    /** The bearer token this client will send (resolved lazily). */
+    authorization(): Promise<string | undefined>;
+    url(path: string, query?: Query): string;
+    request<T>(method: string, path: string, opts?: {
+        query?: Query;
+        body?: unknown;
+    }): Promise<T>;
+    /** Server-sent events stream; yields parsed `data:` payloads. */
+    stream<T>(path: string, query?: Query, signal?: AbortSignal): AsyncGenerator<T>;
+    login(req: CliLoginRequest): Promise<CliLoginResponse>;
+    me(): Promise<MeResponse>;
+    listApps(): Promise<AppSummary[]>;
+    getApp(app: string): Promise<AppSummary>;
+    createApp(req: CreateAppRequest): Promise<AppRecord>;
+    /** Unregister an app. The API refuses while any stage is still live. */
+    deleteApp(app: string): Promise<unknown>;
+    listStages(app: string): Promise<StageRecord[]>;
+    destroyStage(app: string, stage: string): Promise<unknown>;
+    rollback(app: string, stage: string, toDeployment?: string): Promise<DeploymentRecord | StageRecord>;
+    createDeployment(app: string, req: CreateDeploymentRequest): Promise<CreateDeploymentResponse>;
+    startDeployment(id: string): Promise<DeploymentRecord>;
+    getDeployment(id: string): Promise<DeploymentRecord>;
+    listDeployments(app: string, stage?: string): Promise<DeploymentRecord[]>;
+    metrics(app: string, q: {
+        stage: string;
+        from: number;
+        to: number;
+        res: Resolution;
+    }): Promise<MetricsResponse>;
+    routes(app: string, q: {
+        stage: string;
+        from: number;
+        to: number;
+    }): Promise<RouteStats[]>;
+    jobs(app: string, q: {
+        stage: string;
+        from: number;
+        to: number;
+    }): Promise<{
+        jobs: JobStats[];
+        queues: QueueStats[];
+    }>;
+    errors(app: string, q: {
+        stage: string;
+    }): Promise<ErrorGroup[]>;
+    logs(app: string, q: {
+        stage: string;
+        from: number;
+        to?: number;
+        filter?: string;
+        nextToken?: string;
+        limit?: number;
+    }): Promise<LogsResponse>;
+    tailLogs(app: string, q: {
+        stage: string;
+        filter?: string;
+    }, signal?: AbortSignal): AsyncGenerator<LogLine, any, any>;
+    trace(app: string, trace: string, q: {
+        stage: string;
+    }): Promise<TraceResponse>;
+    collections(app: string, q: {
+        stage: string;
+    }): Promise<string[]>;
+    items(app: string, q: {
+        stage: string;
+        collection: string;
+        partition?: string;
+        cursor?: string;
+        limit?: number;
+    }): Promise<DataPage>;
+    files(app: string, q: {
+        stage: string;
+        store: string;
+        prefix?: string;
+        cursor?: string;
+    }): Promise<{
+        objects: StoredObjectInfo[];
+        cursor?: string;
+    }>;
+    listSecrets(app: string, q: {
+        stage: string;
+    }): Promise<SecretInfo[]>;
+    setSecret(app: string, name: string, body: {
+        value: string;
+        stage?: string;
+        shared?: boolean;
+    }): Promise<SecretInfo>;
+    deleteSecret(app: string, name: string, q: {
+        stage?: string;
+        shared?: boolean;
+    }): Promise<unknown>;
+    runCron(app: string, name: string, stage: string): Promise<unknown>;
+}
+export {};

package/dist/api.js

@@ -0,0 +1,271 @@
+/**
+ * Typed client for the control plane API (`/v1`). Route shapes follow the
+ * design in docs/DESIGN.md; list endpoints return `{ <plural>: [...] }`.
+ *
+ * Auth, in order: an explicit token, GitHub Actions OIDC (CI), the token
+ * stored by `plat login`.
+ */
+import { PLATFORM_DEFAULTS, } from './api-types.js';
+import { isExpired, loadCredentials } from './credentials.js';
+import { canUseOidc, fetchOidcToken } from './github.js';
+import { CliError, EXIT } from './util/output.js';
+export function apiBaseUrl(env = process.env) {
+    return (env.PLATFORM_API_URL || PLATFORM_DEFAULTS.apiUrl).replace(/\/$/, '');
+}
+export class ApiError extends CliError {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message, {
+            hint: hintFor(status),
+            exitCode: status === 401 || status === 403 ? EXIT.auth : status === 404 ? EXIT.notFound : EXIT.error,
+        });
+        this.status = status;
+        this.code = code;
+    }
+}
+function hintFor(status) {
+    if (status === 401)
+        return 'run `plat login` (or check the CI workflow has `id-token: write`)';
+    if (status === 403)
+        return 'you are not allowed to do this; ask a platform admin';
+    if (status === 404)
+        return 'check the app/stage name with `plat apps list` / `plat stages`';
+    return undefined;
+}
+export class ApiClient {
+    baseUrl;
+    fetchImpl;
+    authMode;
+    token;
+    constructor(opts = {}) {
+        this.baseUrl = (opts.baseUrl ?? apiBaseUrl()).replace(/\/$/, '');
+        this.fetchImpl = opts.fetch ?? fetch;
+        this.authMode = opts.auth ?? 'auto';
+        this.token = opts.token;
+    }
+    /** The bearer token this client will send (resolved lazily). */
+    async authorization() {
+        if (this.token)
+            return this.token;
+        if (this.authMode === 'none')
+            return undefined;
+        if (this.authMode !== 'token' && canUseOidc()) {
+            this.token = await fetchOidcToken(PLATFORM_DEFAULTS.oidcAudience);
+            return this.token;
+        }
+        if (this.authMode === 'oidc') {
+            throw new CliError('GitHub Actions OIDC is not available here', { exitCode: EXIT.auth });
+        }
+        const creds = loadCredentials();
+        if (!creds)
+            throw new CliError('not logged in', { hint: 'run `plat login`', exitCode: EXIT.auth });
+        if (isExpired(creds))
+            throw new CliError('your platform login has expired', {
+                hint: 'run `plat login`',
+                exitCode: EXIT.auth,
+            });
+        if (creds.apiUrl.replace(/\/$/, '') !== this.baseUrl) {
+            throw new CliError(`stored login is for ${creds.apiUrl}, not ${this.baseUrl}`, {
+                hint: 'run `plat login` again',
+                exitCode: EXIT.auth,
+            });
+        }
+        this.token = creds.token;
+        return this.token;
+    }
+    url(path, query) {
+        const u = new URL(this.baseUrl + path);
+        for (const [k, v] of Object.entries(query ?? {}))
+            if (v !== undefined && v !== '')
+                u.searchParams.set(k, String(v));
+        return u.toString();
+    }
+    async request(method, path, opts = {}) {
+        const headers = { accept: 'application/json' };
+        const auth = await this.authorization();
+        if (auth)
+            headers.authorization = `Bearer ${auth}`;
+        if (opts.body !== undefined)
+            headers['content-type'] = 'application/json';
+        let res;
+        try {
+            res = await this.fetchImpl(this.url(path, opts.query), {
+                method,
+                headers,
+                body: opts.body === undefined ? undefined : JSON.stringify(opts.body),
+            });
+        }
+        catch (err) {
+            throw new CliError(`can't reach the platform API at ${this.baseUrl}: ${err.message}`, {
+                hint: 'set PLATFORM_API_URL if the API lives elsewhere',
+            });
+        }
+        const text = await res.text();
+        const body = text ? safeJson(text) : undefined;
+        if (!res.ok) {
+            const e = body?.error;
+            throw new ApiError(res.status, e?.code ?? `http_${res.status}`, e?.message ?? `${method} ${path} failed (HTTP ${res.status})`);
+        }
+        return body;
+    }
+    /** Server-sent events stream; yields parsed `data:` payloads. */
+    async *stream(path, query, signal) {
+        const headers = { accept: 'text/event-stream' };
+        const auth = await this.authorization();
+        if (auth)
+            headers.authorization = `Bearer ${auth}`;
+        const res = await this.fetchImpl(this.url(path, query), { headers, signal });
+        if (!res.ok || !res.body)
+            throw new ApiError(res.status, `http_${res.status}`, `stream ${path} failed (HTTP ${res.status})`);
+        const decoder = new TextDecoder();
+        let buf = '';
+        for await (const chunk of res.body) {
+            buf += decoder.decode(chunk, { stream: true });
+            let idx = buf.indexOf('\n\n');
+            while (idx !== -1) {
+                const frame = buf.slice(0, idx);
+                buf = buf.slice(idx + 2);
+                const data = frame
+                    .split('\n')
+                    .filter((l) => l.startsWith('data:'))
+                    .map((l) => l.slice(5).trimStart())
+                    .join('\n');
+                if (data)
+                    yield safeJson(data);
+                idx = buf.indexOf('\n\n');
+            }
+        }
+    }
+    // ------------------------------------------------------------- auth
+    login(req) {
+        return this.request('POST', '/v1/auth/cli', { body: req });
+    }
+    me() {
+        return this.request('GET', '/v1/me');
+    }
+    // ------------------------------------------------------------- apps
+    async listApps() {
+        return list(await this.request('GET', '/v1/apps'), 'apps');
+    }
+    getApp(app) {
+        return this.request('GET', `/v1/apps/${enc(app)}`);
+    }
+    createApp(req) {
+        return this.request('POST', '/v1/apps', { body: req });
+    }
+    /** Unregister an app. The API refuses while any stage is still live. */
+    deleteApp(app) {
+        return this.request('DELETE', `/v1/apps/${enc(app)}`);
+    }
+    // ------------------------------------------------------------- stages & deployments
+    async listStages(app) {
+        return list(await this.request('GET', `/v1/apps/${enc(app)}/stages`), 'stages');
+    }
+    destroyStage(app, stage) {
+        // The API requires an explicit confirmation to destroy prod.
+        return this.request('DELETE', `/v1/apps/${enc(app)}/stages/${enc(stage)}`, {
+            query: stage === 'prod' ? { confirm: app } : {},
+        });
+    }
+    rollback(app, stage, toDeployment) {
+        return this.request('POST', `/v1/apps/${enc(app)}/stages/${enc(stage)}/rollback`, {
+            body: toDeployment ? { deploymentId: toDeployment } : {},
+        });
+    }
+    createDeployment(app, req) {
+        return this.request('POST', `/v1/apps/${enc(app)}/deployments`, { body: req });
+    }
+    startDeployment(id) {
+        return this.request('POST', `/v1/deployments/${enc(id)}/start`, { body: {} });
+    }
+    getDeployment(id) {
+        return this.request('GET', `/v1/deployments/${enc(id)}`);
+    }
+    async listDeployments(app, stage) {
+        return list(await this.request('GET', `/v1/apps/${enc(app)}/deployments`, { query: { stage } }), 'deployments');
+    }
+    // ------------------------------------------------------------- observability
+    metrics(app, q) {
+        return this.request('GET', `/v1/apps/${enc(app)}/metrics`, { query: q });
+    }
+    async routes(app, q) {
+        return list(await this.request('GET', `/v1/apps/${enc(app)}/routes`, { query: q }), 'routes');
+    }
+    async jobs(app, q) {
+        const [body, queues] = await Promise.all([
+            this.request('GET', `/v1/apps/${enc(app)}/jobs`, { query: q }),
+            this.request('GET', `/v1/apps/${enc(app)}/queues`, { query: { stage: q.stage } }),
+        ]);
+        return { jobs: body?.jobs ?? [], queues: Array.isArray(queues) ? queues : [] };
+    }
+    async errors(app, q) {
+        return list(await this.request('GET', `/v1/apps/${enc(app)}/errors`, { query: q }), 'errors');
+    }
+    logs(app, q) {
+        const { filter, nextToken, ...rest } = q;
+        return this.request('GET', `/v1/apps/${enc(app)}/logs`, {
+            query: { ...rest, ...(filter ? { q: filter } : {}), ...(nextToken ? { next: nextToken } : {}) },
+        });
+    }
+    tailLogs(app, q, signal) {
+        return this.stream(`/v1/apps/${enc(app)}/logs/tail`, { stage: q.stage, ...(q.filter ? { q: q.filter } : {}) }, signal);
+    }
+    trace(app, trace, q) {
+        return this.request('GET', `/v1/apps/${enc(app)}/traces/${enc(trace)}`, { query: q });
+    }
+    // ------------------------------------------------------------- data
+    async collections(app, q) {
+        const rows = list(await this.request('GET', `/v1/apps/${enc(app)}/data/collections`, { query: q }), 'collections');
+        return rows.map((r) => (typeof r === 'string' ? r : r.name));
+    }
+    items(app, q) {
+        return this.request('GET', `/v1/apps/${enc(app)}/data/items`, { query: q });
+    }
+    async files(app, q) {
+        return this.request('GET', `/v1/apps/${enc(app)}/storage`, { query: q });
+    }
+    // ------------------------------------------------------------- secrets & jobs
+    async listSecrets(app, q) {
+        return list(await this.request('GET', `/v1/apps/${enc(app)}/secrets`, { query: q }), 'secrets');
+    }
+    setSecret(app, name, body) {
+        return this.request('PUT', `/v1/apps/${enc(app)}/secrets/${enc(name)}`, {
+            body: { value: body.value },
+            query: secretScope(body),
+        });
+    }
+    deleteSecret(app, name, q) {
+        return this.request('DELETE', `/v1/apps/${enc(app)}/secrets/${enc(name)}`, {
+            query: secretScope(q),
+        });
+    }
+    runCron(app, name, stage) {
+        return this.request('POST', `/v1/apps/${enc(app)}/crons/${enc(name)}/run`, {
+            body: {},
+            query: { stage },
+        });
+    }
+}
+const enc = encodeURIComponent;
+/** The API scopes secrets with `?scope=shared` (app-wide) or `?stage=`. */
+function secretScope(o) {
+    return o.shared ? { scope: 'shared' } : o.stage ? { stage: o.stage } : {};
+}
+function safeJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+/** Accept `[...]` or `{ key: [...] }` / `{ items: [...] }`. */
+function list(body, key) {
+    if (Array.isArray(body))
+        return body;
+    const obj = (body ?? {});
+    const v = obj[key] ?? obj.items;
+    return Array.isArray(v) ? v : [];
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/bin.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { main } from './main.js';
+await main(process.argv);
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/build.d.ts

@@ -0,0 +1,45 @@
+import type { ArtifactFile, ResolvedManifest } from '@ericminassian/platform-core';
+import { type Plugin } from 'esbuild';
+export declare const SDK_SERVER = "@ericminassian/platform/server";
+export declare const SDK_WORKER = "@ericminassian/platform/worker";
+export interface BuildOptions {
+    cwd: string;
+    /** Default `<app>/.plat/build`. */
+    outDir?: string;
+    /** Skip `web.build` (e.g. `plat dev`, which runs the dev server instead). */
+    skipWebBuild?: boolean;
+    /** Only build these parts. Default: everything the manifest declares. */
+    only?: Array<'server' | 'worker' | 'static'>;
+    /**
+     * Replace module specifiers during bundling (absolute paths). Tests use it to
+     * stand in for the SDK; nothing else should need it.
+     */
+    resolveOverrides?: Record<string, string>;
+    minify?: boolean;
+    quiet?: boolean;
+}
+export interface BuildResult {
+    manifest: ResolvedManifest;
+    /** Absolute paths of the produced artifacts. */
+    files: Partial<Record<ArtifactFile, string>>;
+}
+/**
+ * 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 }`
+ */
+export declare function buildApp(opts: BuildOptions): Promise<BuildResult>;
+/** Bundle just the worker into `outDir/index.mjs` (used by build and `plat dev`). */
+export declare function bundleWorker(root: string, manifest: ResolvedManifest, outDir: string, opts?: {
+    plugins?: Plugin[];
+    minify?: boolean;
+}): Promise<string>;
+/** Zip of a bundled directory, for UpdateFunctionCode. */
+export declare function zipBundle(dir: string): Uint8Array;
+export declare function validateForBuild(root: string, manifest: ResolvedManifest): void;
+/** Run a manifest shell command with the app's `node_modules/.bin` on PATH. */
+export declare function runCommand(command: string, cwd: string, env?: NodeJS.ProcessEnv): Promise<void>;
+export declare function withLocalBin(cwd: string, env?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export declare function readBuildManifest(outDir: string): unknown;