@embeddables/cli 0.7.19 → 0.8.1

package/dist/proxy/sse.d.ts

@@ -0,0 +1,5 @@
+import type express from 'express';
+export declare function attachSse(app: express.Express): {
+    broadcastReload: () => void;
+};
+//# sourceMappingURL=sse.d.ts.map

package/dist/proxy/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/proxy/sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAA;AAElC,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO;;EAoB7C"}

package/dist/proxy/sse.js

@@ -0,0 +1,17 @@
+export function attachSse(app) {
+    const clients = new Set();
+    app.get('/__embeddables_reload', (req, res) => {
+        res.setHeader('Content-Type', 'text/event-stream');
+        res.setHeader('Cache-Control', 'no-store');
+        res.setHeader('Connection', 'keep-alive');
+        res.flushHeaders?.();
+        clients.add(res);
+        req.on('close', () => clients.delete(res));
+    });
+    function broadcastReload() {
+        for (const res of clients) {
+            res.write(`event: reload\ndata: ${Date.now()}\n\n`);
+        }
+    }
+    return { broadcastReload };
+}

package/dist/sentry-context.d.ts

@@ -0,0 +1,48 @@
+export interface SentryContextUser {
+    id: string;
+    email?: string | null;
+}
+export interface SentryContextProject {
+    id: string;
+    title?: string | null;
+}
+export interface SentryContextOrg {
+    id: string;
+    title?: string | null;
+}
+export interface SentryContextEmbeddable {
+    id: string;
+    title?: string | null;
+}
+export interface SentryContextBranch {
+    id: string;
+    name?: string | null;
+}
+export interface SentryContextInput {
+    user?: SentryContextUser | null;
+    project?: SentryContextProject | null;
+    org?: SentryContextOrg | null;
+    embeddable?: SentryContextEmbeddable | null;
+    branch?: SentryContextBranch | null;
+    versionNumber?: number | null;
+}
+/**
+ * Set Sentry scope with the given context. Only sets keys that are present and have valid values.
+ * Uses setUser/setContext for error events and setAttributes on the current scope so values
+ * (project, org, embeddable, branch, versionNumber) are included in log events.
+ */
+export declare function setSentryContext(ctx: SentryContextInput): void;
+/**
+ * Return project and org context from embeddables.json when present.
+ */
+export declare function getSentryContextFromProjectConfig(): Partial<SentryContextInput>;
+/**
+ * Return embeddable title (from metadata.json), branch and versionNumber (from config.json)
+ * for embeddables/{embeddableId}/ when present.
+ */
+export declare function getSentryContextFromEmbeddableConfig(embeddableId: string): Partial<SentryContextInput>;
+/**
+ * Set Sentry user from auth when logged in. Call after requireLogin for commands that need user context.
+ */
+export declare function setSentryUserFromAuth(): Promise<void>;
+//# sourceMappingURL=sentry-context.d.ts.map

package/dist/sentry-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentry-context.d.ts","sourceRoot":"","sources":["../src/sentry-context.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAC/B,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAA;IACrC,GAAG,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAC7B,UAAU,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAA;IAC3C,MAAM,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAA;IACnC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI,CA4D9D;AAED;;GAEG;AACH,wBAAgB,iCAAiC,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAW/E;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6CtG;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAY3D"}

package/dist/sentry-context.js

@@ -0,0 +1,156 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import * as Sentry from '@sentry/node';
+import { readProjectConfig } from './config/index.js';
+/**
+ * Set Sentry scope with the given context. Only sets keys that are present and have valid values.
+ * Uses setUser/setContext for error events and setAttributes on the current scope so values
+ * (project, org, embeddable, branch, versionNumber) are included in log events.
+ */
+export function setSentryContext(ctx) {
+    if (ctx.user?.id) {
+        Sentry.setUser({
+            id: ctx.user.id,
+            email: ctx.user.email ?? undefined,
+        });
+    }
+    if (ctx.project?.id) {
+        Sentry.setContext('project', {
+            id: ctx.project.id,
+            title: ctx.project.title ?? undefined,
+        });
+    }
+    if (ctx.org?.id) {
+        Sentry.setContext('org', {
+            id: ctx.org.id,
+            title: ctx.org.title ?? undefined,
+        });
+    }
+    if (ctx.embeddable?.id) {
+        Sentry.setContext('embeddable', {
+            id: ctx.embeddable.id,
+            title: ctx.embeddable.title ?? undefined,
+        });
+    }
+    if (ctx.branch?.id) {
+        Sentry.setContext('branch', {
+            id: ctx.branch.id,
+            name: ctx.branch.name ?? undefined,
+        });
+    }
+    if (ctx.versionNumber != null && !isNaN(ctx.versionNumber)) {
+        Sentry.setContext('version', { versionNumber: ctx.versionNumber });
+    }
+    // Scope attributes are included in log events; only string/number/boolean are supported
+    const scope = Sentry.getCurrentScope();
+    const attrs = {};
+    if (ctx.project?.id) {
+        attrs.projectId = ctx.project.id;
+        if (ctx.project.title != null)
+            attrs.projectTitle = String(ctx.project.title);
+    }
+    if (ctx.org?.id) {
+        attrs.orgId = ctx.org.id;
+        if (ctx.org.title != null)
+            attrs.orgTitle = String(ctx.org.title);
+    }
+    if (ctx.embeddable?.id) {
+        attrs.embeddableId = ctx.embeddable.id;
+        if (ctx.embeddable.title != null)
+            attrs.embeddableTitle = String(ctx.embeddable.title);
+    }
+    if (ctx.branch?.id) {
+        attrs.branchId = ctx.branch.id;
+        if (ctx.branch.name != null)
+            attrs.branchName = String(ctx.branch.name);
+    }
+    if (ctx.versionNumber != null && !isNaN(ctx.versionNumber)) {
+        attrs.versionNumber = ctx.versionNumber;
+    }
+    if (Object.keys(attrs).length > 0) {
+        scope.setAttributes(attrs);
+    }
+}
+/**
+ * Return project and org context from embeddables.json when present.
+ */
+export function getSentryContextFromProjectConfig() {
+    const config = readProjectConfig();
+    if (!config)
+        return {};
+    const out = {};
+    if (config.project_id) {
+        out.project = { id: config.project_id, title: config.project_name ?? null };
+    }
+    if (config.org_id) {
+        out.org = { id: config.org_id, title: config.org_title ?? null };
+    }
+    return out;
+}
+/**
+ * Return embeddable title (from metadata.json), branch and versionNumber (from config.json)
+ * for embeddables/{embeddableId}/ when present.
+ */
+export function getSentryContextFromEmbeddableConfig(embeddableId) {
+    const out = {};
+    const embeddableDir = path.join('embeddables', embeddableId);
+    // Embeddable title from metadata.json (written by pull)
+    const metadataPath = path.join(embeddableDir, 'metadata.json');
+    if (fs.existsSync(metadataPath)) {
+        try {
+            const metadata = JSON.parse(fs.readFileSync(metadataPath, 'utf8'));
+            const title = metadata.title;
+            if (typeof title === 'string' && title) {
+                out.embeddable = { id: embeddableId, title };
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    if (!out.embeddable) {
+        out.embeddable = { id: embeddableId };
+    }
+    const configPath = path.join(embeddableDir, 'config.json');
+    if (!fs.existsSync(configPath))
+        return out;
+    try {
+        const raw = fs.readFileSync(configPath, 'utf8');
+        const config = JSON.parse(raw);
+        const branchId = config._branch_id;
+        if (typeof branchId === 'string' && branchId) {
+            const branchName = config._branch_name;
+            out.branch = {
+                id: branchId,
+                name: typeof branchName === 'string' ? branchName : null,
+            };
+        }
+        else if (config._version != null) {
+            // Config was written by pull; no _branch_id means we're on main
+            out.branch = { id: 'main', name: 'main' };
+        }
+        const ver = config._version;
+        if (typeof ver === 'number' && !isNaN(ver)) {
+            out.versionNumber = ver;
+        }
+        return out;
+    }
+    catch {
+        return out;
+    }
+}
+/**
+ * Set Sentry user from auth when logged in. Call after requireLogin for commands that need user context.
+ */
+export async function setSentryUserFromAuth() {
+    const { getAuthenticatedSupabaseClient } = await import('./auth/index.js');
+    const supabase = await getAuthenticatedSupabaseClient();
+    if (!supabase)
+        return;
+    const { data: { user }, } = await supabase.auth.getUser();
+    if (user?.id) {
+        setSentryContext({
+            user: { id: user.id, email: user.email ?? null },
+        });
+    }
+}

package/dist/stdout.d.ts

@@ -0,0 +1,61 @@
+import { type Ora } from 'ora';
+import { type Options as BoxenOptions } from 'boxen';
+/** Suppress all print/dim/step output. Used to silence verbose compiler output. */
+export declare function mute(): void;
+export declare function unmute(): void;
+/**
+ * Write a line to stdout. Use this for all user-facing CLI terminal output.
+ * Replaces console.log so that user-facing output and observability logging
+ * (logger.info → Sentry) are clearly distinct in the code.
+ */
+export declare function print(message?: string): void;
+/**
+ * Write a warning line to stdout with a yellow WARN badge.
+ * Replaces console.warn.
+ */
+export declare function warn(message: string): void;
+/**
+ * Write an error line to stderr with a red ERROR badge.
+ * Replaces console.error.
+ */
+export declare function error(message: string): void;
+export declare const symbols: {
+    readonly success: string;
+    readonly error: string;
+    readonly warning: string;
+    readonly info: string;
+    readonly sparkles: "✨";
+    readonly rocket: "🚀";
+    readonly bolt: "⚡";
+    readonly wave: "👋";
+    readonly branch: "🌿";
+    readonly key: "🔑";
+    readonly package: "📦";
+    readonly globe: "🌐";
+};
+export declare function spinner(text: string): Ora;
+export declare function withSpinner<T>(text: string, fn: (s: Ora) => Promise<T>, opts?: {
+    successText?: string | ((result: T) => string);
+    failText?: string;
+}): Promise<T>;
+export declare function success(msg: string): void;
+export declare function step(msg: string): void;
+export declare function header(title: string, subtitle?: string): void;
+export declare function dim(msg: string): void;
+export declare function gap(): void;
+export declare function box(content: string, opts?: Partial<BoxenOptions> & {
+    title?: string;
+}): void;
+/** Green box for final success/completion messages. */
+export declare function successBox(content: string, opts?: {
+    title?: string;
+}): void;
+/** Gray/dim box for contextual info (ID, branch, version). */
+export declare function infoBox(content: string): void;
+export declare function separator(): void;
+export declare function timer(): () => string;
+export declare function fileTree(root: string, entries: string[]): void;
+export declare function kvRow(pairs: [string, string][]): void;
+export declare function kvBlock(pairs: [string, string][]): void;
+export declare function randomMessage(pool: string): string;
+//# sourceMappingURL=stdout.d.ts.map

package/dist/stdout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdout.d.ts","sourceRoot":"","sources":["../src/stdout.ts"],"names":[],"mappings":"AACA,OAAY,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAEnC,OAAc,EAAE,KAAK,OAAO,IAAI,YAAY,EAAE,MAAM,OAAO,CAAA;AAI3D,mFAAmF;AACnF,wBAAgB,IAAI,IAAI,IAAI,CAE3B;AAED,wBAAgB,MAAM,IAAI,IAAI,CAE7B;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,OAAO,SAAK,GAAG,IAAI,CAGxC;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C;AAID,eAAO,MAAM,OAAO;;;;;;;;;;;;;CAaV,CAAA;AAIV,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAEzC;AAED,wBAAsB,WAAW,CAAC,CAAC,EACjC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1B,IAAI,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3E,OAAO,CAAC,CAAC,CAAC,CAeZ;AAID,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEtC;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAK7D;AAED,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGrC;AAED,wBAAgB,GAAG,IAAI,IAAI,CAE1B;AAED,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAU5F;AAED,uDAAuD;AACvD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAE3E;AAED,8DAA8D;AAC9D,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAM7C;AAED,wBAAgB,SAAS,IAAI,IAAI,CAGhC;AAID,wBAAgB,KAAK,IAAI,MAAM,MAAM,CAMpC;AAID,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAO9D;AAID,wBAAgB,KAAK,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,IAAI,CAGrD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,IAAI,CAMvD;AAWD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD"}

package/dist/stdout.js

@@ -0,0 +1,163 @@
+import pc from 'picocolors';
+import ora from 'ora';
+import logSymbols from 'log-symbols';
+import boxen from 'boxen';
+let _muted = false;
+/** Suppress all print/dim/step output. Used to silence verbose compiler output. */
+export function mute() {
+    _muted = true;
+}
+export function unmute() {
+    _muted = false;
+}
+/**
+ * Write a line to stdout. Use this for all user-facing CLI terminal output.
+ * Replaces console.log so that user-facing output and observability logging
+ * (logger.info → Sentry) are clearly distinct in the code.
+ */
+export function print(message = '') {
+    if (_muted)
+        return;
+    process.stdout.write(message + '\n');
+}
+/**
+ * Write a warning line to stdout with a yellow WARN badge.
+ * Replaces console.warn.
+ */
+export function warn(message) {
+    process.stdout.write(`${logSymbols.warning} ${pc.yellow(message)}\n`);
+}
+/**
+ * Write an error line to stderr with a red ERROR badge.
+ * Replaces console.error.
+ */
+export function error(message) {
+    process.stderr.write(`${logSymbols.error} ${pc.red(message)}\n`);
+}
+// ─── Symbols ────────────────────────────────────────────────────────────────
+export const symbols = {
+    success: logSymbols.success,
+    error: logSymbols.error,
+    warning: logSymbols.warning,
+    info: logSymbols.info,
+    sparkles: '✨',
+    rocket: '🚀',
+    bolt: '⚡',
+    wave: '👋',
+    branch: '🌿',
+    key: '🔑',
+    package: '📦',
+    globe: '🌐',
+};
+// ─── Spinners ───────────────────────────────────────────────────────────────
+export function spinner(text) {
+    return ora({ text, spinner: 'dots' }).start();
+}
+export async function withSpinner(text, fn, opts) {
+    const s = spinner(text);
+    try {
+        const result = await fn(s);
+        const successMsg = opts?.successText
+            ? typeof opts.successText === 'function'
+                ? opts.successText(result)
+                : opts.successText
+            : text;
+        s.succeed(successMsg);
+        return result;
+    }
+    catch (err) {
+        s.fail(opts?.failText ?? (err instanceof Error ? err.message : String(err)));
+        throw err;
+    }
+}
+// ─── Output helpers ─────────────────────────────────────────────────────────
+export function success(msg) {
+    print(`${logSymbols.success} ${msg}`);
+}
+export function step(msg) {
+    print(`${logSymbols.info} ${msg}`);
+}
+export function header(title, subtitle) {
+    print('');
+    print(`  ${pc.bold(pc.cyan(title))}`);
+    if (subtitle)
+        print(`  ${pc.gray(subtitle)}`);
+    print('');
+}
+export function dim(msg) {
+    if (_muted)
+        return;
+    print(pc.gray(msg));
+}
+export function gap() {
+    print('');
+}
+export function box(content, opts) {
+    const defaults = {
+        padding: { top: 0, bottom: 0, left: 1, right: 1 },
+        margin: { top: 0, bottom: 0, left: 1, right: 1 },
+        borderStyle: 'round',
+        borderColor: 'cyan',
+        ...(opts?.title ? { title: opts.title, titleAlignment: 'left' } : {}),
+    };
+    const merged = { ...defaults, ...opts };
+    print(boxen(content, merged));
+}
+/** Green box for final success/completion messages. */
+export function successBox(content, opts) {
+    box(content, { borderColor: 'green', title: opts?.title, ...opts });
+}
+/** Gray/dim box for contextual info (ID, branch, version). */
+export function infoBox(content) {
+    box(content, {
+        borderColor: 'gray',
+        padding: { top: 0, bottom: 0, left: 1, right: 1 },
+        margin: { top: 0, bottom: 0, left: 1, right: 1 },
+    });
+}
+export function separator() {
+    const width = Math.min(process.stdout.columns || 60, 60);
+    print(pc.cyan('━'.repeat(width)));
+}
+// ─── Timer ──────────────────────────────────────────────────────────────────
+export function timer() {
+    const start = performance.now();
+    return () => {
+        const ms = performance.now() - start;
+        return ms >= 1000 ? `${(ms / 1000).toFixed(1)}s` : `${Math.round(ms)}ms`;
+    };
+}
+// ─── File tree ──────────────────────────────────────────────────────────────
+export function fileTree(root, entries) {
+    print(pc.bold(root));
+    for (let i = 0; i < entries.length; i++) {
+        const isLast = i === entries.length - 1;
+        const prefix = isLast ? '└── ' : '├── ';
+        print(pc.gray(`${prefix}${entries[i]}`));
+    }
+}
+// ─── Key-value display ──────────────────────────────────────────────────────
+export function kvRow(pairs) {
+    const parts = pairs.map(([k, v]) => `${pc.gray(k + ':')} ${pc.white(v)}`);
+    print(parts.join(pc.gray('  ·  ')));
+}
+export function kvBlock(pairs) {
+    const maxKeyLen = Math.max(...pairs.map(([k]) => k.length));
+    for (const [k, v] of pairs) {
+        const paddedKey = k.padStart(maxKeyLen);
+        print(`  ${pc.gray(paddedKey + ':')} ${pc.white(v)}`);
+    }
+}
+// ─── Whimsical messages ─────────────────────────────────────────────────────
+const MESSAGE_POOLS = {
+    build: ['Looking good!', 'Nailed it.', 'Compiled to perfection.'],
+    save: ['Saved and sealed.', 'Shipped it!', 'Up in the cloud where it belongs.'],
+    pull: ['Fresh code, who dis?', 'Hot off the server.', 'Synced up and ready.'],
+    login: ['Welcome back!', "You're in!", 'Authenticated and ready to roll.'],
+};
+export function randomMessage(pool) {
+    const messages = MESSAGE_POOLS[pool];
+    if (!messages || messages.length === 0)
+        return '';
+    return messages[Math.floor(Math.random() * messages.length)];
+}