@embeddables/cli 0.1.0 → 0.2.0

package/README.md

@@ -11,21 +11,29 @@ A CLI for authoring and managing Embeddables locally using TypeScript/TSX.
 
 ## Installation
 
+Install the CLI globally:
+
 ```bash
-npm install @embeddables/cli
+npm install -g @embeddables/cli
 ```
 
 ## Quick Start
 
 ```bash
+# Initialize a new project (will ask for your Embeddables project ID)
+embeddables init
+
+# Install dependencies
+npm install
+
 # Login to your Embeddables account
-npx embeddables login
+embeddables login
 
-# Pull an existing embeddable
-npx embeddables pull --id <embeddable-id>
+# Pull an embeddable (shows a list to choose from)
+embeddables pull
 
 # Start dev server with hot reload
-npx embeddables dev --id <embeddable-id>
+embeddables dev
 ```
 
 This creates the following structure in your repo:
@@ -43,20 +51,42 @@ embeddables/
 
 ## Commands
 
+### `embeddables init`
+Initialize a new Embeddables project. Creates `package.json`, `embeddables.json`, `.gitignore`, and an `embeddables/` directory.
+
+If you're logged in, you'll see an interactive list of your projects to choose from. Otherwise, you can enter a project ID manually or skip.
+
+Options:
+- `--name <name>`: Project name (prompts if not provided)
+- `--project-id <id>`: Embeddables project ID (shows list if logged in)
+- `-y, --yes`: Skip prompts and use defaults
+
+The project ID is stored in `embeddables.json` and enables interactive embeddable selection when running `embeddables pull`.
+
 ### `embeddables login`
 Authenticate with your Embeddables account.
 
 ### `embeddables logout`
 Clear stored authentication.
 
-### `embeddables pull --id <id>`
+### `embeddables pull`
 Fetch an embeddable from the cloud and reverse-compile it into local TSX files.
 
+If you're logged in and run `embeddables pull` without arguments:
+1. If no project is configured, you'll be prompted to select one (saved to `embeddables.json`)
+2. Then you'll see an interactive list of embeddables to choose from
+
 Options:
-- `--id <id>` (required): Embeddable ID to pull
+- `--id <id>`: Embeddable ID to pull (skips interactive selection)
 - `--branch <branch_id>`: Pull a specific branch version
 - `--fix`: Remove components with missing required props instead of erroring
 
+### `embeddables branch`
+Switch to a different branch of a local embeddable. Shows an interactive list of branches to choose from.
+
+Options:
+- `--id <id>`: Embeddable ID (will prompt from local embeddables if not provided)
+
 ### `embeddables build --id <id>`
 Compile TSX pages into the canonical JSON format.
 

package/dist/auth/index.d.ts

@@ -35,7 +35,7 @@ export declare function getSupabaseClient(): SupabaseClient;
 /**
  * Get authenticated Supabase client (with stored session)
  */
-export declare function getAuthenticatedSupabaseClient(): SupabaseClient | null;
+export declare function getAuthenticatedSupabaseClient(): Promise<SupabaseClient | null>;
 /**
  * Get access token for authenticated requests
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAGpE,eAAO,MAAM,YAAY,6CAA6C,CAAA;AACtE,eAAO,MAAM,iBAAiB,mDAAmD,CAAA;AAEjF,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAKD;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,UAAU,GAAG,IAAI,CAUlD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAGxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAcpC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAWlD;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,cAAc,GAAG,IAAI,CActE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAM9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAGpE,eAAO,MAAM,YAAY,6CAA6C,CAAA;AACtE,eAAO,MAAM,iBAAiB,mDAAmD,CAAA;AAEjF,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAMD;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,UAAU,GAAG,IAAI,CAUlD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAGxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAcpC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAWlD;AAED;;GAEG;AACH,wBAAsB,8BAA8B,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAcrF;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAM9C"}

package/dist/auth/index.js

@@ -1,10 +1,12 @@
 import fs from 'node:fs';
+import os from 'node:os';
 import path from 'node:path';
 import { createClient } from '@supabase/supabase-js';
 // TODO: Move to environment variables
 export const SUPABASE_URL = 'https://ierxexdtyashuotcsjyo.supabase.co'; // Replace with actual Supabase URL
 export const SUPABASE_ANON_KEY = 'sb_publishable_Vt8-msWNtn2hhOY3AA6RsQ_ueTx79Vo'; // Replace with actual Supabase anon key
-const AUTH_DIR = path.join(process.cwd(), '.auth');
+// Store auth globally in user's home directory
+const AUTH_DIR = path.join(os.homedir(), '.embeddables');
 const AUTH_FILE = path.join(AUTH_DIR, 'auth.json');
 /**
  * Get the path to the auth config file
@@ -75,14 +77,14 @@ export function getSupabaseClient() {
 /**
  * Get authenticated Supabase client (with stored session)
  */
-export function getAuthenticatedSupabaseClient() {
+export async function getAuthenticatedSupabaseClient() {
     const config = readAuthConfig();
     if (!config || !isLoggedIn()) {
         return null;
     }
     const client = getSupabaseClient();
     // Set the session manually
-    client.auth.setSession({
+    await client.auth.setSession({
         access_token: config.access_token,
         refresh_token: config.refresh_token,
     });

package/dist/cli.js

@@ -1,8 +1,10 @@
 import { Command } from 'commander';
 import pc from 'picocolors';
+import { runBranch } from './commands/branch.js';
 import { runBuild } from './commands/build.js';
 import { runBuildWorkbench } from './commands/build-workbench.js';
 import { runDev } from './commands/dev.js';
+import { runInit } from './commands/init.js';
 import { runLogin } from './commands/login.js';
 import { runLogout } from './commands/logout.js';
 import { runPull } from './commands/pull.js';
@@ -17,6 +19,15 @@ console.error = (...args) => {
 };
 const program = new Command();
 program.name('embeddables').description('Embeddables CLI').version('0.1.0');
+program
+    .command('init')
+    .description('Initialize a new Embeddables project')
+    .option('--name <name>', 'Project name')
+    .option('--project-id <id>', 'Embeddables project ID')
+    .option('-y, --yes', 'Skip prompts and use defaults')
+    .action(async (opts) => {
+    await runInit({ name: opts.name, projectId: opts.projectId, yes: opts.yes });
+});
 program
     .command('build')
     .requiredOption('--id <id>', 'Embeddable ID')
@@ -57,13 +68,21 @@ program
 });
 program
     .command('pull')
-    .requiredOption('--id <id>', 'Embeddable ID to pull')
+    .description('Pull an embeddable from the cloud')
+    .option('--id <id>', 'Embeddable ID to pull (interactive selection if not provided)')
     .option('--out <path>', 'Output json path')
     .option('--branch <branch_id>', 'Embeddable branch ID')
     .option('--fix', 'Fix by removing components missing required props (warn instead of error)')
     .action(async (opts) => {
     await runPull(opts);
 });
+program
+    .command('branch')
+    .description('Switch to a different branch of an embeddable')
+    .option('--id <id>', 'Embeddable ID (will prompt if not provided)')
+    .action(async (opts) => {
+    await runBranch(opts);
+});
 program
     .command('build-workbench')
     .description('Build Workbench for CDN deployment')

package/dist/commands/branch.d.ts

@@ -0,0 +1,4 @@
+export declare function runBranch(opts: {
+    id?: string;
+}): Promise<void>;
+//# sourceMappingURL=branch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"branch.d.ts","sourceRoot":"","sources":["../../src/commands/branch.ts"],"names":[],"mappings":"AAKA,wBAAsB,SAAS,CAAC,IAAI,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,iBAgDpD"}

package/dist/commands/branch.js

@@ -0,0 +1,46 @@
+import pc from 'picocolors';
+import { isLoggedIn } from '../auth/index.js';
+import { runPull } from './pull.js';
+import { promptForLocalEmbeddable, fetchBranches, promptForBranch } from '../prompts/index.js';
+export async function runBranch(opts) {
+    // Check login status
+    if (!isLoggedIn()) {
+        console.error(pc.red('Not logged in.'));
+        console.log(pc.gray('Run "embeddables login" first.'));
+        process.exit(1);
+    }
+    // Get embeddable ID
+    let embeddableId = opts.id;
+    if (!embeddableId) {
+        const selected = await promptForLocalEmbeddable();
+        if (!selected) {
+            process.exit(1);
+        }
+        embeddableId = selected;
+    }
+    console.log('');
+    console.log(pc.cyan('Fetching branches...'));
+    // Fetch branches for this embeddable
+    const branches = await fetchBranches(embeddableId);
+    if (branches.length === 0) {
+        console.log(pc.yellow('No branches found for this embeddable.'));
+        console.log(pc.gray('Branches are created in the Embeddables Builder.'));
+        return;
+    }
+    console.log('');
+    // Prompt for branch selection
+    const selectedBranch = await promptForBranch(branches);
+    console.log('');
+    // Pull the selected branch
+    if (selectedBranch === null) {
+        // User selected "main" - pull without branch
+        console.log(pc.cyan('Switching to main (latest published version)...'));
+        console.log('');
+        await runPull({ id: embeddableId });
+    }
+    else {
+        console.log(pc.cyan(`Switching to branch: ${selectedBranch.name}...`));
+        console.log('');
+        await runPull({ id: embeddableId, branch: selectedBranch.id });
+    }
+}

package/dist/commands/dev.js

@@ -17,12 +17,12 @@ async function discoverEmbeddables() {
         if (!entry.isDirectory())
             continue;
         const id = entry.name;
-        const configPath = path.join(embeddablesDir, id, 'config.json');
+        const metadataPath = path.join(embeddablesDir, id, 'metadata.json');
         let title = null;
-        if (fs.existsSync(configPath)) {
+        if (fs.existsSync(metadataPath)) {
             try {
-                const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-                title = config.title || null;
+                const metadata = JSON.parse(fs.readFileSync(metadataPath, 'utf-8'));
+                title = metadata.title || null;
             }
             catch {
                 // Ignore JSON parse errors

package/dist/commands/init.d.ts

@@ -0,0 +1,6 @@
+export declare function runInit(opts: {
+    name?: string;
+    projectId?: string;
+    yes?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAiBA,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,iBAsMvF"}

package/dist/commands/init.js

@@ -0,0 +1,188 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import pc from 'picocolors';
+import prompts from 'prompts';
+import { writeProjectConfig, readProjectConfig } from '../config/index.js';
+import { isLoggedIn } from '../auth/index.js';
+import { promptForProject } from '../prompts/index.js';
+export async function runInit(opts) {
+    const cwd = process.cwd();
+    const packageJsonPath = path.join(cwd, 'package.json');
+    const gitignorePath = path.join(cwd, '.gitignore');
+    const embeddablesDir = path.join(cwd, 'embeddables');
+    console.log('');
+    console.log(pc.bold(pc.cyan('  Embeddables Project Setup')));
+    console.log('');
+    // Check if already initialized
+    let existingPackageJson = null;
+    if (fs.existsSync(packageJsonPath)) {
+        try {
+            existingPackageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+        }
+        catch {
+            // Invalid JSON, we'll overwrite
+        }
+    }
+    const existingConfig = readProjectConfig();
+    // Step 1: Get Embeddables project (this determines the default name)
+    let projectId = opts.projectId;
+    let selectedProjectTitle;
+    if (!projectId && !opts.yes) {
+        if (existingConfig?.project_id) {
+            console.log(pc.gray(`  Using existing project ID: ${existingConfig.project_id}`));
+            projectId = existingConfig.project_id;
+            selectedProjectTitle = existingConfig.project_name || undefined;
+        }
+        else if (isLoggedIn()) {
+            // Fetch and show project list
+            console.log(pc.gray('  Fetching projects...'));
+            const selectedProject = await promptForProject({
+                allowSkip: true,
+                message: 'Select your Embeddables project:',
+            });
+            if (selectedProject) {
+                projectId = selectedProject.id;
+                selectedProjectTitle = selectedProject.title || undefined;
+            }
+        }
+        else {
+            // Not logged in - offer manual entry or skip
+            console.log(pc.gray('  (Login with "embeddables login" to select from your projects)'));
+            const response = await prompts({
+                type: 'text',
+                name: 'projectId',
+                message: 'Embeddables project ID (optional):',
+                hint: 'e.g., proj_abc123 - leave empty to skip',
+            }, {
+                onCancel: () => {
+                    console.log(pc.gray('\n  Cancelled.'));
+                    process.exit(0);
+                },
+            });
+            projectId = response.projectId || undefined;
+        }
+    }
+    // Step 2: Get project name (default to selected project title, or existing, or directory name)
+    let projectName = opts.name;
+    if (!projectName) {
+        if (existingPackageJson?.name) {
+            projectName = existingPackageJson.name;
+            console.log(pc.gray(`  Using existing project name: ${projectName}`));
+        }
+        else if (opts.yes) {
+            // Use selected project title or directory name as default
+            projectName = selectedProjectTitle || path.basename(cwd);
+        }
+        else {
+            // Default to selected project title, then directory name
+            const defaultName = selectedProjectTitle || path.basename(cwd);
+            const response = await prompts({
+                type: 'text',
+                name: 'name',
+                message: 'Project name:',
+                initial: defaultName,
+            }, {
+                onCancel: () => {
+                    console.log(pc.gray('\n  Cancelled.'));
+                    process.exit(0);
+                },
+            });
+            projectName = response.name;
+        }
+    }
+    if (!projectName) {
+        console.error('Project name is required.');
+        process.exit(1);
+    }
+    // Create or update package.json
+    const packageJson = existingPackageJson || {
+        name: projectName,
+        version: '1.0.0',
+        type: 'module',
+    };
+    // Ensure name is set
+    if (!packageJson.name) {
+        packageJson.name = projectName;
+    }
+    // Ensure type is module
+    if (!packageJson.type) {
+        packageJson.type = 'module';
+    }
+    // Add @embeddables/cli as a dependency
+    if (!packageJson.dependencies) {
+        packageJson.dependencies = {};
+    }
+    if (!packageJson.dependencies['@embeddables/cli']) {
+        packageJson.dependencies['@embeddables/cli'] = '^0.1.0';
+    }
+    // Write package.json
+    fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n', 'utf8');
+    if (existingPackageJson) {
+        console.log(pc.green('  ✓ Updated package.json'));
+    }
+    else {
+        console.log(pc.green('  ✓ Created package.json'));
+    }
+    // Write embeddables.json config
+    if (projectId) {
+        writeProjectConfig({
+            project_id: projectId,
+            project_name: selectedProjectTitle || projectName,
+        });
+        console.log(pc.green('  ✓ Created embeddables.json'));
+    }
+    // Create or update .gitignore
+    const gitignoreEntries = ['node_modules/', '**/.generated/', '.DS_Store'];
+    let existingGitignore = '';
+    if (fs.existsSync(gitignorePath)) {
+        existingGitignore = fs.readFileSync(gitignorePath, 'utf8');
+    }
+    const newEntries = gitignoreEntries.filter((entry) => !existingGitignore.includes(entry.replace('/', '')));
+    if (newEntries.length > 0) {
+        const separator = existingGitignore && !existingGitignore.endsWith('\n') ? '\n' : '';
+        const embeddablesSection = existingGitignore
+            ? `${separator}\n# Embeddables\n${newEntries.join('\n')}\n`
+            : `# Embeddables\n${gitignoreEntries.join('\n')}\n`;
+        fs.writeFileSync(gitignorePath, existingGitignore + embeddablesSection, 'utf8');
+        if (existingGitignore) {
+            console.log(pc.green('  ✓ Updated .gitignore'));
+        }
+        else {
+            console.log(pc.green('  ✓ Created .gitignore'));
+        }
+    }
+    else {
+        console.log(pc.gray('  ✓ .gitignore already configured'));
+    }
+    // Create embeddables directory
+    if (!fs.existsSync(embeddablesDir)) {
+        fs.mkdirSync(embeddablesDir, { recursive: true });
+        console.log(pc.green('  ✓ Created embeddables/ directory'));
+    }
+    else {
+        console.log(pc.gray('  ✓ embeddables/ directory exists'));
+    }
+    // Print next steps
+    console.log('');
+    console.log(pc.bold('  Next steps:'));
+    console.log('');
+    console.log(pc.cyan('    1. Install dependencies:'));
+    console.log(pc.white('       npm install'));
+    console.log('');
+    console.log(pc.cyan('    2. Login to Embeddables:'));
+    console.log(pc.white('       npx embeddables login'));
+    console.log('');
+    if (projectId) {
+        console.log(pc.cyan('    3. Pull an embeddable:'));
+        console.log(pc.white('       npx embeddables pull'));
+        console.log(pc.gray('       (will show a list of embeddables in your project)'));
+    }
+    else {
+        console.log(pc.cyan('    3. Pull an existing embeddable:'));
+        console.log(pc.white('       npx embeddables pull --id <embeddable-id>'));
+    }
+    console.log('');
+    console.log(pc.cyan('    4. Start developing:'));
+    console.log(pc.white('       npx embeddables dev'));
+    console.log('');
+}

package/dist/commands/pull.d.ts

@@ -1,5 +1,5 @@
 export declare function runPull(opts: {
-    id: string;
+    id?: string;
     out?: string;
     branch?: string;
     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":"AAOA,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,iBA0G/F"}
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../src/commands/pull.ts"],"names":[],"mappings":"AAUA,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,iBAmMhG"}

package/dist/commands/pull.js

@@ -1,10 +1,50 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import pc from 'picocolors';
+import prompts from 'prompts';
 import { reverseCompile } from '../compiler/reverse.js';
-import { getAccessToken } from '../auth/index.js';
+import { getAccessToken, isLoggedIn } from '../auth/index.js';
+import { getProjectId, writeProjectConfig } from '../config/index.js';
+import { promptForProject, promptForEmbeddable, fetchEmbeddableMetadata } from '../prompts/index.js';
 export async function runPull(opts) {
-    const embeddableId = opts.id;
+    let embeddableId = opts.id;
+    // If no ID provided, try to get it interactively
+    if (!embeddableId) {
+        if (!isLoggedIn()) {
+            console.error(pc.red('No embeddable ID provided and not logged in.'));
+            console.log('');
+            console.log(pc.gray('Either:'));
+            console.log(pc.gray('  1. Use --id <embeddable-id> to specify an embeddable'));
+            console.log(pc.gray('  2. Run "embeddables login" first for interactive selection'));
+            process.exit(1);
+        }
+        let projectId = getProjectId();
+        // If no project ID configured, prompt for project selection
+        if (!projectId) {
+            console.log(pc.cyan('Fetching projects...'));
+            const selectedProject = await promptForProject();
+            if (!selectedProject) {
+                process.exit(1);
+            }
+            projectId = selectedProject.id;
+            // Save the selected project to config
+            writeProjectConfig({
+                project_id: projectId,
+                project_name: selectedProject.title || undefined,
+            });
+            console.log(pc.green(`✓ Saved project to embeddables.json`));
+            console.log('');
+        }
+        console.log(pc.cyan('Fetching embeddables from project...'));
+        const selected = await promptForEmbeddable(projectId, {
+            message: 'Select an embeddable to pull:',
+        });
+        if (!selected) {
+            process.exit(1);
+        }
+        embeddableId = selected;
+        console.log('');
+    }
     let url = `https://engine.embeddables.com/${embeddableId}?version=latest`;
     if (opts.branch) {
         url += `&embeddable_branch=${opts.branch}`;
@@ -44,6 +84,14 @@ export async function runPull(opts) {
             fs.writeFileSync(versionedPath, flowJson, 'utf8');
             console.log(pc.cyan(`✓ Saved embeddable JSON to ${versionedPath}`));
         }
+        // Fetch and save flow metadata from DB (title, archived, created_at)
+        const metadata = await fetchEmbeddableMetadata(embeddableId);
+        if (metadata) {
+            const metadataPath = path.join('embeddables', embeddableId, 'metadata.json');
+            fs.mkdirSync(path.dirname(metadataPath), { recursive: true });
+            fs.writeFileSync(metadataPath, JSON.stringify(metadata, null, 2) + '\n', 'utf8');
+            console.log(pc.cyan(`✓ Saved flow metadata to ${metadataPath}`));
+        }
         // Clear existing pages, styles, computed-fields, actions, and global-components before generating new ones
         const pagesDir = path.join('embeddables', embeddableId, 'pages');
         const stylesDir = path.join('embeddables', embeddableId, 'styles');
@@ -88,7 +136,40 @@ export async function runPull(opts) {
             console.log(`${pc.gray(`Cleared ${existingGlobalComponents.length} existing global component(s)`)}`);
         }
         // Run reverse compiler
-        await reverseCompile(flow, embeddableId, { fix: opts.fix });
+        try {
+            await reverseCompile(flow, embeddableId, { fix: opts.fix });
+        }
+        catch (compileError) {
+            // If fix mode wasn't already enabled, offer to retry with fix mode
+            if (!opts.fix && compileError instanceof Error) {
+                console.log('');
+                console.error(pc.red('Error during reverse compile:'));
+                console.error(pc.yellow(`  ${compileError.message}`));
+                console.log('');
+                const response = await prompts({
+                    type: 'confirm',
+                    name: 'fix',
+                    message: 'Would you like to retry with auto-fix enabled? (removes problematic components)',
+                    initial: true,
+                }, {
+                    onCancel: () => {
+                        process.exit(1);
+                    },
+                });
+                if (response.fix) {
+                    console.log('');
+                    console.log(pc.cyan('Retrying with auto-fix enabled...'));
+                    console.log('');
+                    await reverseCompile(flow, embeddableId, { fix: true });
+                }
+                else {
+                    process.exit(1);
+                }
+            }
+            else {
+                throw compileError;
+            }
+        }
     }
     catch (error) {
         console.error('Error pulling embeddable:', error);

package/dist/config/index.d.ts

@@ -0,0 +1,21 @@
+export interface ProjectConfig {
+    project_id?: string;
+    project_name?: string;
+}
+/**
+ * Get the path to the project config file
+ */
+export declare function getConfigFilePath(): string;
+/**
+ * Read project config from file
+ */
+export declare function readProjectConfig(): ProjectConfig | null;
+/**
+ * Write project config to file
+ */
+export declare function writeProjectConfig(config: ProjectConfig): void;
+/**
+ * Get the project ID from config
+ */
+export declare function getProjectId(): string | null;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAID;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,GAAG,IAAI,CAWxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAQ9D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAG5C"}

package/dist/config/index.js

@@ -0,0 +1,42 @@
+import fs from 'node:fs';
+import path from 'node:path';
+const CONFIG_FILE = 'embeddables.json';
+/**
+ * Get the path to the project config file
+ */
+export function getConfigFilePath() {
+    return path.join(process.cwd(), CONFIG_FILE);
+}
+/**
+ * Read project config from file
+ */
+export function readProjectConfig() {
+    const configPath = getConfigFilePath();
+    try {
+        if (!fs.existsSync(configPath)) {
+            return null;
+        }
+        const content = fs.readFileSync(configPath, 'utf8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write project config to file
+ */
+export function writeProjectConfig(config) {
+    const configPath = getConfigFilePath();
+    // Merge with existing config
+    const existing = readProjectConfig() || {};
+    const merged = { ...existing, ...config };
+    fs.writeFileSync(configPath, JSON.stringify(merged, null, 2) + '\n', 'utf8');
+}
+/**
+ * Get the project ID from config
+ */
+export function getProjectId() {
+    const config = readProjectConfig();
+    return config?.project_id || null;
+}

package/dist/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const BranchStatus: {
+    readonly ACTIVE: "ACTIVE";
+    readonly MERGED: "MERGED";
+};
+export type BranchStatus = (typeof BranchStatus)[keyof typeof BranchStatus];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY;;;CAGf,CAAA;AAEV,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAA"}

package/dist/constants.js

@@ -0,0 +1,4 @@
+export const BranchStatus = {
+    ACTIVE: 'ACTIVE',
+    MERGED: 'MERGED',
+};

package/dist/helpers/dates.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Format a date string or Date object as YYYY-MM-DD.
+ */
+export declare function formatDate(date: string | Date): string;
+//# sourceMappingURL=dates.d.ts.map

package/dist/helpers/dates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../../src/helpers/dates.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAGtD"}

package/dist/helpers/dates.js

@@ -0,0 +1,7 @@
+/**
+ * Format a date string or Date object as YYYY-MM-DD.
+ */
+export function formatDate(date) {
+    const d = typeof date === 'string' ? new Date(date) : date;
+    return d.toISOString().slice(0, 10);
+}

package/dist/prompts/branches.d.ts

@@ -0,0 +1,20 @@
+import { BranchStatus } from '../constants.js';
+export interface BranchInfo {
+    id: string;
+    name: string;
+    status: BranchStatus;
+    created_at: string;
+    origin_version: number | null;
+    origin_branch: string | null;
+}
+/**
+ * Fetch all branches for an embeddable from Supabase
+ */
+export declare function fetchBranches(flowId: string): Promise<BranchInfo[]>;
+/**
+ * Prompt the user to select a branch
+ * Returns null if user selects "main" or cancels
+ * The "main" option is always included at the top
+ */
+export declare function promptForBranch(branches: BranchInfo[]): Promise<BranchInfo | null>;
+//# sourceMappingURL=branches.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"branches.d.ts","sourceRoot":"","sources":["../../src/prompts/branches.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAG9C,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,YAAY,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CA8BzE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA8DxF"}

package/dist/prompts/branches.js

@@ -0,0 +1,89 @@
+import pc from 'picocolors';
+import prompts from 'prompts';
+import { getAuthenticatedSupabaseClient } from '../auth/index.js';
+import { BranchStatus } from '../constants.js';
+import { formatDate } from '../helpers/dates.js';
+/**
+ * Fetch all branches for an embeddable from Supabase
+ */
+export async function fetchBranches(flowId) {
+    const supabase = await getAuthenticatedSupabaseClient();
+    if (!supabase) {
+        return [];
+    }
+    try {
+        const { data, error } = await supabase
+            .from('branches')
+            .select('id, name, status, created_at, origin_version, origin_branch')
+            .eq('flow_id', flowId)
+            .order('created_at', { ascending: false });
+        if (error) {
+            console.warn(pc.yellow(`Could not fetch branches: ${error.message}`));
+            return [];
+        }
+        return (data || []).map((row) => ({
+            id: row.id,
+            name: row.name,
+            status: row.status,
+            created_at: row.created_at,
+            origin_version: row.origin_version,
+            origin_branch: row.origin_branch,
+        }));
+    }
+    catch (err) {
+        console.warn(pc.yellow(`Could not fetch branches: ${err}`));
+        return [];
+    }
+}
+/**
+ * Prompt the user to select a branch
+ * Returns null if user selects "main" or cancels
+ * The "main" option is always included at the top
+ */
+export async function promptForBranch(branches) {
+    // Separate active and merged branches
+    const activeBranches = branches.filter((b) => b.status === BranchStatus.ACTIVE);
+    const mergedBranches = branches.filter((b) => b.status === BranchStatus.MERGED);
+    const choices = [];
+    // Add "main" option first
+    choices.push({
+        title: pc.bold('main'),
+        value: 'main',
+        description: 'Latest published version',
+    });
+    // Add active branches
+    for (const branch of activeBranches) {
+        const date = formatDate(branch.created_at);
+        choices.push({
+            title: branch.name,
+            value: branch.id,
+            description: `Active · Created ${date}`,
+        });
+    }
+    // Add merged branches (dimmed)
+    for (const branch of mergedBranches) {
+        const date = formatDate(branch.created_at);
+        choices.push({
+            title: pc.dim(branch.name),
+            value: branch.id,
+            description: pc.dim(`Merged · Created ${date}`),
+        });
+    }
+    const response = await prompts({
+        type: 'autocomplete',
+        name: 'branchId',
+        message: 'Select a branch:',
+        choices,
+        suggest: (input, choices) => Promise.resolve(choices.filter((c) => c.value === 'main' ||
+            (c.title?.toLowerCase().includes(input.toLowerCase()) ?? false) ||
+            String(c.value).toLowerCase().includes(input.toLowerCase()))),
+    }, {
+        onCancel: () => {
+            process.exit(0);
+        },
+    });
+    if (!response.branchId || response.branchId === 'main') {
+        return null;
+    }
+    return branches.find((b) => b.id === response.branchId) || null;
+}

package/dist/prompts/embeddables.d.ts

@@ -0,0 +1,41 @@
+export interface EmbeddableInfo {
+    id: string;
+    title: string | null;
+}
+export interface EmbeddableMetadata {
+    title: string | null;
+    archived: boolean;
+    created_at: string | null;
+}
+export interface LocalEmbeddable {
+    id: string;
+    title: string | null;
+}
+export interface PromptForEmbeddableOptions {
+    /** Custom message for the prompt */
+    message?: string;
+}
+/**
+ * Fetch all embeddables for a project from Supabase
+ */
+export declare function fetchProjectEmbeddables(projectId: string): Promise<EmbeddableInfo[]>;
+/**
+ * Fetch metadata for a single embeddable from the flows table.
+ * Returns title, archived, and created_at from the DB (not from the version-specific embeddable.json).
+ */
+export declare function fetchEmbeddableMetadata(embeddableId: string): Promise<EmbeddableMetadata | null>;
+/**
+ * Prompt the user to select an embeddable from a project
+ * Returns null if no embeddables found or user cancels
+ */
+export declare function promptForEmbeddable(projectId: string, options?: PromptForEmbeddableOptions): Promise<string | null>;
+/**
+ * Discover embeddables in the local embeddables/ directory
+ */
+export declare function discoverLocalEmbeddables(): Promise<LocalEmbeddable[]>;
+/**
+ * Prompt the user to select a local embeddable
+ * Returns null if no embeddables found or user cancels
+ */
+export declare function promptForLocalEmbeddable(options?: PromptForEmbeddableOptions): Promise<string | null>;
+//# sourceMappingURL=embeddables.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"embeddables.d.ts","sourceRoot":"","sources":["../../src/prompts/embeddables.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CA0B1F;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA2BpC;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuCxB;AAED;;GAEG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAqC3E;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuCxB"}

package/dist/prompts/embeddables.js

@@ -0,0 +1,161 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import pc from 'picocolors';
+import prompts from 'prompts';
+import { getAuthenticatedSupabaseClient } from '../auth/index.js';
+/**
+ * Fetch all embeddables for a project from Supabase
+ */
+export async function fetchProjectEmbeddables(projectId) {
+    const supabase = await getAuthenticatedSupabaseClient();
+    if (!supabase) {
+        return [];
+    }
+    try {
+        const { data, error } = await supabase
+            .from('flows')
+            .select('id, title')
+            .eq('project_id', projectId)
+            .order('title', { ascending: true });
+        if (error) {
+            console.warn(pc.yellow(`Could not fetch embeddables: ${error.message}`));
+            return [];
+        }
+        return (data || []).map((row) => ({
+            id: row.id,
+            title: row.title || null,
+        }));
+    }
+    catch (err) {
+        console.warn(pc.yellow(`Could not fetch embeddables: ${err}`));
+        return [];
+    }
+}
+/**
+ * Fetch metadata for a single embeddable from the flows table.
+ * Returns title, archived, and created_at from the DB (not from the version-specific embeddable.json).
+ */
+export async function fetchEmbeddableMetadata(embeddableId) {
+    const supabase = await getAuthenticatedSupabaseClient();
+    if (!supabase) {
+        return null;
+    }
+    try {
+        const { data, error } = await supabase
+            .from('flows')
+            .select('title, archived, created_at')
+            .eq('id', embeddableId)
+            .single();
+        if (error) {
+            console.warn(pc.yellow(`Could not fetch embeddable metadata: ${error.message}`));
+            return null;
+        }
+        return {
+            title: data.title || null,
+            archived: data.archived ?? false,
+            created_at: data.created_at || null,
+        };
+    }
+    catch (err) {
+        console.warn(pc.yellow(`Could not fetch embeddable metadata: ${err}`));
+        return null;
+    }
+}
+/**
+ * Prompt the user to select an embeddable from a project
+ * Returns null if no embeddables found or user cancels
+ */
+export async function promptForEmbeddable(projectId, options = {}) {
+    const { message = 'Select an embeddable:' } = options;
+    const embeddables = await fetchProjectEmbeddables(projectId);
+    if (embeddables.length === 0) {
+        console.log(pc.yellow('No embeddables found in this project.'));
+        return null;
+    }
+    const choices = embeddables.map((e) => ({
+        title: e.title || e.id,
+        description: e.id,
+        value: e.id,
+    }));
+    const response = await prompts({
+        type: 'autocomplete',
+        name: 'id',
+        message,
+        choices,
+        suggest: (input, choices) => Promise.resolve(choices.filter((c) => (c.title?.toLowerCase().includes(input.toLowerCase()) ?? false) ||
+            String(c.value).toLowerCase().includes(input.toLowerCase()))),
+    }, {
+        onCancel: () => {
+            process.exit(0);
+        },
+    });
+    return response.id || null;
+}
+/**
+ * Discover embeddables in the local embeddables/ directory
+ */
+export async function discoverLocalEmbeddables() {
+    const embeddablesDir = 'embeddables';
+    if (!fs.existsSync(embeddablesDir)) {
+        return [];
+    }
+    const entries = fs.readdirSync(embeddablesDir, { withFileTypes: true });
+    const embeddables = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const id = entry.name;
+        const metadataPath = path.join(embeddablesDir, id, 'metadata.json');
+        let title = null;
+        if (fs.existsSync(metadataPath)) {
+            try {
+                const metadata = JSON.parse(fs.readFileSync(metadataPath, 'utf-8'));
+                title = metadata.title || null;
+            }
+            catch {
+                // Ignore JSON parse errors
+            }
+        }
+        embeddables.push({ id, title });
+    }
+    // Sort by title first, then by id
+    return embeddables.sort((a, b) => {
+        if (a.title && !b.title)
+            return -1;
+        if (!a.title && b.title)
+            return 1;
+        const aLabel = a.title || a.id;
+        const bLabel = b.title || b.id;
+        return aLabel.localeCompare(bLabel);
+    });
+}
+/**
+ * Prompt the user to select a local embeddable
+ * Returns null if no embeddables found or user cancels
+ */
+export async function promptForLocalEmbeddable(options = {}) {
+    const { message = 'Select an embeddable:' } = options;
+    const embeddables = await discoverLocalEmbeddables();
+    if (embeddables.length === 0) {
+        console.error(pc.red('No embeddables found in the embeddables/ directory.'));
+        console.log(pc.gray('Run `embeddables pull` to pull an embeddable first.'));
+        return null;
+    }
+    const choices = embeddables.map((e) => ({
+        title: e.title ? `${e.title} (${e.id})` : e.id,
+        value: e.id,
+    }));
+    const response = await prompts({
+        type: 'autocomplete',
+        name: 'id',
+        message,
+        choices,
+        suggest: (input, choices) => Promise.resolve(choices.filter((c) => (c.title?.toLowerCase().includes(input.toLowerCase()) ?? false) ||
+            String(c.value).toLowerCase().includes(input.toLowerCase()))),
+    }, {
+        onCancel: () => {
+            process.exit(0);
+        },
+    });
+    return response.id || null;
+}

package/dist/prompts/index.d.ts

@@ -0,0 +1,7 @@
+export { fetchProjects, promptForProject } from './projects.js';
+export type { ProjectInfo, PromptForProjectOptions } from './projects.js';
+export { fetchProjectEmbeddables, fetchEmbeddableMetadata, promptForEmbeddable, discoverLocalEmbeddables, promptForLocalEmbeddable, } from './embeddables.js';
+export type { EmbeddableInfo, EmbeddableMetadata, LocalEmbeddable, PromptForEmbeddableOptions, } from './embeddables.js';
+export { fetchBranches, promptForBranch } from './branches.js';
+export type { BranchInfo } from './branches.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/prompts/index.js

@@ -0,0 +1,4 @@
+// Centralized prompts for CLI commands
+export { fetchProjects, promptForProject } from './projects.js';
+export { fetchProjectEmbeddables, fetchEmbeddableMetadata, promptForEmbeddable, discoverLocalEmbeddables, promptForLocalEmbeddable, } from './embeddables.js';
+export { fetchBranches, promptForBranch } from './branches.js';

package/dist/prompts/projects.d.ts

@@ -0,0 +1,21 @@
+export interface ProjectInfo {
+    id: string;
+    title: string | null;
+    org_title: string | null;
+}
+export interface PromptForProjectOptions {
+    /** Include a "Skip for now" option (default: false) */
+    allowSkip?: boolean;
+    /** Custom message for the prompt (default: "Select a project:") */
+    message?: string;
+}
+/**
+ * Fetch all non-archived projects from Supabase
+ */
+export declare function fetchProjects(): Promise<ProjectInfo[]>;
+/**
+ * Prompt the user to select a project from the list
+ * Returns null if no projects found, user cancels, or user selects "skip"
+ */
+export declare function promptForProject(options?: PromptForProjectOptions): Promise<ProjectInfo | null>;
+//# sourceMappingURL=projects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/prompts/projects.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAuC5D;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAqD7B"}

package/dist/prompts/projects.js

@@ -0,0 +1,84 @@
+import pc from 'picocolors';
+import prompts from 'prompts';
+import { getAuthenticatedSupabaseClient } from '../auth/index.js';
+/**
+ * Fetch all non-archived projects from Supabase
+ */
+export async function fetchProjects() {
+    const supabase = await getAuthenticatedSupabaseClient();
+    if (!supabase) {
+        return [];
+    }
+    try {
+        const { data, error } = await supabase
+            .from('projects')
+            .select(`
+        id,
+        title,
+        group_id,
+        groups (
+          title
+        )
+      `)
+            .not('archived', 'is', 'true')
+            .order('title', { ascending: true });
+        if (error) {
+            console.warn(pc.yellow(`Could not fetch projects: ${error.message}`));
+            return [];
+        }
+        return (data || []).map((row) => ({
+            id: row.id,
+            title: row.title || null,
+            org_title: 
+            // For some reason, I can't get Supabase typings to return this as an object
+            // (not an array of objects) so I have to convert it manually
+            row.groups?.title || null,
+        }));
+    }
+    catch (err) {
+        console.warn(pc.yellow(`Could not fetch projects: ${err}`));
+        return [];
+    }
+}
+/**
+ * Prompt the user to select a project from the list
+ * Returns null if no projects found, user cancels, or user selects "skip"
+ */
+export async function promptForProject(options = {}) {
+    const { allowSkip = false, message = 'Select a project:' } = options;
+    const projects = await fetchProjects();
+    if (projects.length === 0) {
+        console.log(pc.yellow('No projects found.'));
+        return null;
+    }
+    const choices = projects.map((p) => ({
+        title: p.title || p.id,
+        description: p.org_title ? `${p.org_title} (${p.id})` : p.id,
+        value: p.id,
+    }));
+    if (allowSkip) {
+        choices.push({
+            title: pc.dim('Skip for now'),
+            description: 'You can set this later',
+            value: '__skip__',
+        });
+    }
+    const response = await prompts({
+        type: 'autocomplete',
+        name: 'id',
+        message,
+        choices,
+        suggest: (input, choices) => Promise.resolve(choices.filter((c) => c.value === '__skip__' ||
+            (c.title?.toLowerCase().includes(input.toLowerCase()) ?? false) ||
+            String(c.value).toLowerCase().includes(input.toLowerCase()) ||
+            c.description?.toLowerCase().includes(input.toLowerCase()))),
+    }, {
+        onCancel: () => {
+            process.exit(0);
+        },
+    });
+    if (!response.id || response.id === '__skip__') {
+        return null;
+    }
+    return projects.find((p) => p.id === response.id) || null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@embeddables/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "bin": {
     "embeddables": "./bin/embeddables.mjs"
@@ -47,19 +47,22 @@
     "@babel/parser": "^7.26.0",
     "@babel/traverse": "^7.26.0",
     "@supabase/supabase-js": "^2.39.0",
+    "@tailwindcss/postcss": "^4.1.18",
+    "autoprefixer": "^10.4.23",
     "chokidar": "^3.6.0",
     "commander": "^12.1.0",
     "cssjson": "^2.1.3",
+    "esbuild": "^0.25.0",
     "express": "^4.19.2",
     "fast-glob": "^3.3.2",
     "http-proxy-middleware": "^3.0.3",
     "picocolors": "^1.1.0",
+    "postcss": "^8.5.6",
     "prompts": "^2.4.2",
     "react": "^19.2.3",
     "react-dom": "^19.2.3"
   },
   "devDependencies": {
-    "@tailwindcss/postcss": "^4.1.18",
     "@types/babel__generator": "^7.27.0",
     "@types/babel__traverse": "^7.28.0",
     "@types/express": "^4.17.21",
@@ -67,9 +70,6 @@
     "@types/prompts": "^2.4.9",
     "@types/react": "^19.2.8",
     "@vitest/coverage-v8": "^2.1.8",
-    "autoprefixer": "^10.4.23",
-    "esbuild": "^0.25.0",
-    "postcss": "^8.5.6",
     "prettier": "^3.8.1",
     "tailwindcss": "^4.1.18",
     "tsx": "^4.19.2",