@embeddables/cli 0.7.8 → 0.7.9

package/dist/cli.js

@@ -109,13 +109,17 @@ program
     .description('Pull an embeddable from the cloud')
     .option('-i, --id <id>', 'Embeddable ID to pull (interactive selection if not provided)')
     .option('-o, --out <path>', 'Output json path')
+    .option('--version <version>', 'Version to pull (number or "latest"); if omitted, choose from 100 most recent')
     .option('-b, --branch <branch_id>', 'Embeddable branch ID')
     .option('-f, --fix', 'Fix by removing components missing required props (warn instead of error)')
     .option('-p, --preserve', 'Preserve component order in config for forward compile')
     .action(async (opts) => {
     await requireLogin('pull');
     await setSentryContextForCommand();
-    await runPull(opts);
+    await runPull({
+        ...opts,
+        version: opts.version,
+    });
 });
 program
     .command('save')

package/dist/commands/pull.d.ts

@@ -3,6 +3,8 @@ export type RunPullOptions = {
     out?: string;
     branch?: string;
     branchName?: string;
+    /** Version to pull (number or "latest"). If omitted and embeddable is known, prompt from 100 most recent. */
+    version?: string | number;
     /** When true, pull main and clear saved branch (e.g. when user explicitly selects "main" in branch switcher). */
     useMain?: boolean;
     fix?: boolean;

package/dist/commands/pull.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../src/commands/pull.ts"],"names":[],"mappings":"AAuHA,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iHAAiH;IACjH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,iBAgSjD"}
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../src/commands/pull.ts"],"names":[],"mappings":"AA6HA,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,6GAA6G;IAC7G,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACzB,iHAAiH;IACjH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,iBA+SjD"}

package/dist/commands/pull.js

@@ -5,7 +5,7 @@ import prompts from 'prompts';
 import { reverseCompile } from '../compiler/reverse.js';
 import { getAccessToken, isLoggedIn } from '../auth/index.js';
 import { getProjectId, writeProjectConfig } from '../config/index.js';
-import { promptForProject, promptForEmbeddable, fetchEmbeddableMetadata } from '../prompts/index.js';
+import { promptForProject, promptForEmbeddable, fetchEmbeddableMetadata, fetchRecentVersions, promptForVersion, } from '../prompts/index.js';
 import { captureException, createLogger, exit } from '../logger.js';
 import { getSentryContextFromEmbeddableConfig, getSentryContextFromProjectConfig, setSentryContext, } from '../sentry-context.js';
 import * as stdout from '../stdout.js';
@@ -175,10 +175,6 @@ export async function runPull(opts) {
     const currentFromConfig = opts.useMain || opts.branch != null ? null : getCurrentBranchFromConfig(embeddableId);
     const effectiveBranch = opts.useMain ? undefined : (opts.branch ?? currentFromConfig?.branchId);
     const effectiveBranchName = opts.useMain ? undefined : (opts.branchName ?? currentFromConfig?.branchName);
-    let url = `https://engine.embeddables.com/${embeddableId}?version=latest`;
-    if (effectiveBranch) {
-        url += `&embeddable_branch=${effectiveBranch}`;
-    }
     const outPath = opts.out || path.join('embeddables', embeddableId, '.generated', 'embeddable.json');
     const branchLabel = effectiveBranch
         ? effectiveBranchName
@@ -188,6 +184,24 @@ export async function runPull(opts) {
     if (effectiveBranch) {
         setSentryContext({ branch: { id: effectiveBranch, name: effectiveBranchName ?? null } });
     }
+    // Resolve version: explicit --version, or interactive choice from 100 most recent
+    let versionParam;
+    if (opts.version !== undefined && opts.version !== '') {
+        const v = String(opts.version).toLowerCase();
+        versionParam = v === 'latest' ? 'latest' : v;
+    }
+    else {
+        stdout.print(pc.cyan('Fetching recent versions...'));
+        const recentVersions = await fetchRecentVersions(embeddableId, effectiveBranch ?? null);
+        const selected = await promptForVersion(recentVersions, {
+            message: 'Select a version to pull:',
+        });
+        versionParam = selected === null ? 'latest' : String(selected);
+        stdout.print('');
+    }
+    let url = `https://engine.embeddables.com/${embeddableId}?version=${versionParam}`;
+    if (effectiveBranch)
+        url += `&embeddable_branch=${effectiveBranch}`;
     logger.info('pull started');
     stdout.print(pc.cyan(`Pulling branch: ${pc.bold(branchLabel)}`));
     stdout.print(`Fetching embeddable from ${url}...`);

package/dist/prompts/index.d.ts

@@ -4,6 +4,8 @@ export { fetchProjectEmbeddables, fetchEmbeddableMetadata, promptForEmbeddable,
 export type { EmbeddableInfo, EmbeddableMetadata, LocalEmbeddable, PromptForEmbeddableOptions, } from './embeddables.js';
 export { fetchBranches, promptForBranch } from './branches.js';
 export type { BranchInfo } from './branches.js';
+export { fetchRecentVersions, promptForVersion } from './versions.js';
+export type { VersionInfo } from './versions.js';
 export { fetchProjectExperiments, promptForExperiment, } from './experiments.js';
 export type { ExperimentInfo, PromptForExperimentOptions } from './experiments.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAC/D,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAEzE,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,0BAA0B,GAC3B,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC9D,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C,OAAO,EACL,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAC/D,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAEzE,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,0BAA0B,GAC3B,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC9D,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACrE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,OAAO,EACL,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/prompts/index.js

@@ -2,4 +2,5 @@
 export { fetchProjects, promptForProject } from './projects.js';
 export { fetchProjectEmbeddables, fetchEmbeddableMetadata, promptForEmbeddable, discoverLocalEmbeddables, promptForLocalEmbeddable, } from './embeddables.js';
 export { fetchBranches, promptForBranch } from './branches.js';
+export { fetchRecentVersions, promptForVersion } from './versions.js';
 export { fetchProjectExperiments, promptForExperiment, } from './experiments.js';

package/dist/prompts/versions.d.ts

@@ -0,0 +1,18 @@
+export interface VersionInfo {
+    version_number: number;
+    created_at: string | null;
+}
+/**
+ * Fetch up to 100 most recent version numbers for an embeddable (flow).
+ * Uses flow_versions for the given flow_id and branch (null = main).
+ * Returns unique version numbers in descending order.
+ */
+export declare function fetchRecentVersions(flowId: string, branchId: string | null): Promise<VersionInfo[]>;
+/**
+ * Prompt the user to select a version from the list.
+ * Returns the selected version number, or null for "Latest".
+ */
+export declare function promptForVersion(versions: VersionInfo[], options?: {
+    message?: string;
+}): Promise<number | null>;
+//# sourceMappingURL=versions.d.ts.map

package/dist/prompts/versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../../src/prompts/versions.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAID;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,OAAO,CAAC,WAAW,EAAE,CAAC,CA8CxB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACjC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkDxB"}

package/dist/prompts/versions.js

@@ -0,0 +1,99 @@
+import pc from 'picocolors';
+import prompts from 'prompts';
+import { getAuthenticatedSupabaseClient } from '../auth/index.js';
+import * as stdout from '../stdout.js';
+import { formatDate } from '../helpers/dates.js';
+const RECENT_VERSIONS_LIMIT = 100;
+/**
+ * Fetch up to 100 most recent version numbers for an embeddable (flow).
+ * Uses flow_versions for the given flow_id and branch (null = main).
+ * Returns unique version numbers in descending order.
+ */
+export async function fetchRecentVersions(flowId, branchId) {
+    const supabase = await getAuthenticatedSupabaseClient();
+    if (!supabase) {
+        return [];
+    }
+    try {
+        let query = supabase
+            .from('flow_versions')
+            .select('version_number, created_at')
+            .eq('flow_id', flowId)
+            .order('version_number', { ascending: false })
+            .limit(RECENT_VERSIONS_LIMIT * 2); // fetch extra then dedupe
+        if (branchId === null) {
+            query = query.is('branch_id', null);
+        }
+        else {
+            query = query.eq('branch_id', branchId);
+        }
+        const { data, error } = await query;
+        if (error) {
+            stdout.warn(pc.yellow(`Could not fetch versions: ${error.message}`));
+            return [];
+        }
+        // Dedupe by version_number, preserving order (most recent first)
+        const seen = new Set();
+        const versions = [];
+        for (const row of data || []) {
+            const v = row.version_number;
+            if (typeof v !== 'number' || seen.has(v))
+                continue;
+            seen.add(v);
+            versions.push({
+                version_number: v,
+                created_at: row.created_at ?? null,
+            });
+            if (versions.length >= RECENT_VERSIONS_LIMIT)
+                break;
+        }
+        return versions;
+    }
+    catch (err) {
+        stdout.warn(pc.yellow(`Could not fetch versions: ${err}`));
+        return [];
+    }
+}
+/**
+ * Prompt the user to select a version from the list.
+ * Returns the selected version number, or null for "Latest".
+ */
+export async function promptForVersion(versions, options = {}) {
+    const choices = [];
+    if (versions.length === 0) {
+        choices.push({
+            title: pc.bold('Latest'),
+            value: 'latest',
+            description: 'Current published version',
+        });
+    }
+    else {
+        for (let i = 0; i < versions.length; i++) {
+            const v = versions[i];
+            const date = v.created_at ? formatDate(v.created_at) : '';
+            const isLatest = i === 0;
+            choices.push({
+                title: isLatest ? `Version ${v.version_number} (Latest)` : `Version ${v.version_number}`,
+                value: isLatest ? 'latest' : v.version_number,
+                description: date || undefined,
+            });
+        }
+    }
+    const response = await prompts({
+        type: 'autocomplete',
+        name: 'version',
+        message: options.message ?? 'Select a version to pull:',
+        choices,
+        suggest: (input, choicesList) => Promise.resolve(choicesList.filter((c) => c.value === 'latest' ||
+            String(c.value).includes(input) ||
+            (typeof c.title === 'string' && c.title.toLowerCase().includes(input.toLowerCase())))),
+    }, {
+        onCancel: () => {
+            process.exit(0);
+        },
+    });
+    if (response.version === 'latest' || response.version === undefined) {
+        return null;
+    }
+    return typeof response.version === 'number' ? response.version : null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@embeddables/cli",
-  "version": "0.7.8",
+  "version": "0.7.9",
   "type": "module",
   "bin": {
     "embeddables": "./bin/embeddables.mjs"