@embeddables/cli 0.1.0 → 0.3.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,11 +1,14 @@
 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';
+import { runSave } from './commands/save.js';
 // Make all console.warn output yellow
 const originalWarn = console.warn.bind(console);
 console.warn = (...args) => {
@@ -17,6 +20,14 @@ 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('--project-id <id>', 'Embeddables project ID')
+    .option('-y, --yes', 'Skip prompts and use defaults')
+    .action(async (opts) => {
+    await runInit({ projectId: opts.projectId, yes: opts.yes });
+});
 program
     .command('build')
     .requiredOption('--id <id>', 'Embeddable ID')
@@ -31,15 +42,15 @@ program
     .option('--id <id>', 'Embeddable ID (will prompt if not provided)')
     .option('--pages <glob>', 'Pages glob')
     .option('--out <path>', 'Output json path')
-    .option('--remote', 'Use remote engine (https://engine.embeddables.com)')
-    .option('--engine <url>', 'Engine origin', 'http://localhost:8787')
+    .option('--local', 'Use local engine (http://localhost:8787)')
+    .option('--engine <url>', 'Engine origin', 'https://engine.embeddables.com')
     .option('--port <n>', 'Dev proxy port', '3000')
     .option('--overrideRoute <path>', 'Route to override in proxy (exact match, no wildcards yet)', '/init')
     .option('--pageKeyFrom <mode>', 'filename|export', 'filename')
     .action(async (opts) => {
-    // --remote flag overrides --engine to use production engine
-    if (opts.remote) {
-        opts.engine = 'https://engine.embeddables.com';
+    // --local flag overrides --engine to use local engine
+    if (opts.local) {
+        opts.engine = 'http://localhost:8787';
     }
     await runDev(opts);
 });
@@ -57,13 +68,38 @@ 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('save')
+    .description('Build and save an embeddable to the cloud')
+    .option('--id <id>', 'Embeddable ID (will prompt if not provided)')
+    .option('--label <label>', 'Human-readable label for this version')
+    .option('--branch <branch_id>', 'Branch ID to save to')
+    .option('--skip-build', 'Skip the build step and use existing compiled JSON')
+    .option('--from-version <number>', 'Base version number (auto-detected from local files if not provided)')
+    .action(async (opts) => {
+    await runSave({
+        id: opts.id,
+        label: opts.label,
+        branch: opts.branch,
+        skipBuild: opts.skipBuild,
+        fromVersion: opts.fromVersion,
+    });
+});
+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.d.ts

@@ -2,7 +2,7 @@ export declare function runDev(opts: {
     id?: string;
     pages?: string;
     out?: string;
-    remote?: boolean;
+    local?: boolean;
     engine: string;
     port: string;
     overrideRoute: string;

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

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAoFA,wBAAsB,MAAM,CAAC,IAAI,EAAE;IACjC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,UAAU,GAAG,QAAQ,CAAA;CACnC,iBAgGA"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAmHA,wBAAsB,MAAM,CAAC,IAAI,EAAE;IACjC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,UAAU,GAAG,QAAQ,CAAA;CACnC,iBA4GA"}

package/dist/commands/dev.js

@@ -1,4 +1,5 @@
 import fs from 'node:fs';
+import net from 'node:net';
 import path from 'node:path';
 import chokidar from 'chokidar';
 import pc from 'picocolors';
@@ -6,6 +7,32 @@ import prompts from 'prompts';
 import { compileAllPages } from '../compiler/index.js';
 import { startProxyServer } from '../proxy/server.js';
 import { formatError } from '../compiler/errors.js';
+/**
+ * Check whether a port is available by attempting to listen on it.
+ */
+function isPortAvailable(port) {
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once('error', () => resolve(false));
+        server.once('listening', () => {
+            server.close(() => resolve(true));
+        });
+        server.listen(port);
+    });
+}
+/**
+ * Starting from `startPort`, find the first available port.
+ * Tries up to `maxAttempts` consecutive ports.
+ */
+async function getAvailablePort(startPort, maxAttempts = 20) {
+    for (let i = 0; i < maxAttempts; i++) {
+        const port = startPort + i;
+        if (await isPortAvailable(port)) {
+            return port;
+        }
+    }
+    throw new Error(`Could not find an available port (tried ${startPort}–${startPort + maxAttempts - 1})`);
+}
 async function discoverEmbeddables() {
     const embeddablesDir = 'embeddables';
     if (!fs.existsSync(embeddablesDir)) {
@@ -17,12 +44,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
@@ -96,8 +123,20 @@ export async function runDev(opts) {
         console.error(formatError(e));
         process.exit(1);
     }
-    // Start proxy
-    const port = Number(opts.port);
+    // Start proxy — find an available port if the requested one is taken
+    const requestedPort = Number(opts.port);
+    let port;
+    try {
+        port = await getAvailablePort(requestedPort);
+    }
+    catch (e) {
+        console.error(pc.red(e.message));
+        process.exit(1);
+    }
+    if (port !== requestedPort) {
+        console.warn(`Port ${requestedPort} is in use, using ${port} instead.`);
+        console.log('');
+    }
     const proxy = await startProxyServer({
         port,
         engineOrigin: opts.engine,
@@ -139,11 +178,11 @@ export async function runDev(opts) {
     const separator = '━'.repeat(terminalWidth);
     console.log(`${pc.bold(pc.cyan(separator))}`);
     console.log('');
-    if (opts.remote) {
-        console.log(`${pc.bold(pc.yellow('Mode:'))} ${pc.yellow('Remote')} (using ${opts.engine})`);
+    if (opts.local) {
+        console.log(`${pc.bold(pc.blue('Mode:'))} ${pc.blue('Local')} (using ${opts.engine})`);
     }
     else {
-        console.log(`${pc.bold(pc.blue('Mode:'))} ${pc.blue('Local')} (using ${opts.engine})`);
+        console.log(`${pc.bold(pc.yellow('Mode:'))} ${pc.yellow('Remote')} (using ${opts.engine})`);
     }
     console.log('');
     console.log(`${pc.bold(pc.green('Preview URL:'))} ${pc.underline(pc.cyan(`http://localhost:${port}?id=${embeddableId}&version=latest`))}`);

package/dist/commands/init.d.ts

@@ -0,0 +1,5 @@
+export declare function runInit(opts: {
+    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":"AAuGA,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,iBA0KxE"}

package/dist/commands/init.js

@@ -0,0 +1,245 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+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';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/** Recursively copy a directory, creating target dirs as needed. */
+function copyDirSync(src, dest) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDirSync(srcPath, destPath);
+        }
+        else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+/**
+ * Generate type declaration stubs in embeddables/.types/ so the editor
+ * can resolve imports in generated TSX files without npm install.
+ */
+function writeTypeStubs(embeddablesDir) {
+    const typesDir = path.join(embeddablesDir, '.types');
+    fs.mkdirSync(typesDir, { recursive: true });
+    // React JSX runtime types (needed for "jsx": "react-jsx" in tsconfig)
+    fs.writeFileSync(path.join(typesDir, 'react-jsx-runtime.d.ts'), `export namespace JSX {
+  type Element = any
+  interface IntrinsicElements {
+    [elemName: string]: any
+  }
+}
+export function jsx(type: any, props: any, key?: string): JSX.Element
+export function jsxs(type: any, props: any, key?: string): JSX.Element
+export const Fragment: unique symbol
+`, 'utf8');
+    // Component primitives
+    const componentNames = [
+        'BookMeeting',
+        'Chart',
+        'Container',
+        'CustomButton',
+        'CustomHTML',
+        'FileUpload',
+        'InputBox',
+        'Lottie',
+        'MediaEmbed',
+        'MediaImage',
+        'OptionSelector',
+        'PaypalCheckout',
+        'PlainText',
+        'ProgressBar',
+        'RichText',
+        'RichTextMarkdown',
+        'Rive',
+        'StripeCheckout',
+        'StripeCheckout2',
+    ];
+    const componentExports = componentNames
+        .map((name) => `export function ${name}(props: Record<string, any>): any`)
+        .join('\n');
+    fs.writeFileSync(path.join(typesDir, 'components.d.ts'), componentExports + '\n', 'utf8');
+    // Embeddables types (OptionSelectorButton, etc.)
+    fs.writeFileSync(path.join(typesDir, 'types.d.ts'), `export interface OptionSelectorButton {
+  id?: string
+  key: string
+  text?: string
+  description?: string
+  icon?: string
+  emojiIcon?: string
+  imageUrl?: string
+  imageAltText?: string
+  conditions?: Record<string, any>[]
+  triggerEvent?: 'no-action' | 'next-page' | 'open-url'
+  openUrlInNewTab?: boolean
+  url?: string
+  single_select?: boolean
+  hide?: boolean
+  is_repeatable_button?: boolean
+  [key: string]: any
+}
+`, 'utf8');
+}
+export async function runInit(opts) {
+    const cwd = process.cwd();
+    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('');
+    const existingConfig = readProjectConfig();
+    // Step 1: Get Embeddables project
+    let projectId = opts.projectId;
+    let selectedProjectTitle;
+    let selectedOrgId;
+    let selectedOrgTitle;
+    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;
+            selectedOrgId = existingConfig.org_id || undefined;
+            selectedOrgTitle = existingConfig.org_title || 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;
+                selectedOrgId = selectedProject.org_id || undefined;
+                selectedOrgTitle = selectedProject.org_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;
+        }
+    }
+    // Write embeddables.json config
+    if (projectId) {
+        writeProjectConfig({
+            org_id: selectedOrgId,
+            org_title: selectedOrgTitle,
+            project_id: projectId,
+            project_name: selectedProjectTitle,
+        });
+        console.log(pc.green('  ✓ Created embeddables.json'));
+    }
+    // Create or update .gitignore
+    const gitignoreEntries = ['**/.generated/', '**/.types/', '.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'));
+    }
+    // Copy .cursor/ folder with Cursor rules
+    const packageRoot = path.resolve(__dirname, '..', '..');
+    const sourceCursorDir = path.join(packageRoot, '.cursor');
+    const targetCursorDir = path.join(cwd, '.cursor');
+    if (fs.existsSync(sourceCursorDir)) {
+        copyDirSync(sourceCursorDir, targetCursorDir);
+        console.log(pc.green('  ✓ Injected .cursor/ rules'));
+    }
+    // Create tsconfig.json for editor support (JSX, type checking)
+    const tsconfigPath = path.join(cwd, 'tsconfig.json');
+    if (!fs.existsSync(tsconfigPath)) {
+        const tsconfig = {
+            compilerOptions: {
+                target: 'esnext',
+                module: 'esnext',
+                moduleResolution: 'bundler',
+                jsx: 'react-jsx',
+                noEmit: true,
+                strict: false,
+                skipLibCheck: true,
+                esModuleInterop: true,
+                baseUrl: '.',
+                paths: {
+                    'react/jsx-runtime': ['./embeddables/.types/react-jsx-runtime'],
+                    '@embeddables/cli/components': ['./embeddables/.types/components'],
+                    '@embeddables/cli/types': ['./embeddables/.types/types'],
+                },
+            },
+            include: ['embeddables'],
+        };
+        fs.writeFileSync(tsconfigPath, JSON.stringify(tsconfig, null, 2) + '\n', 'utf8');
+        console.log(pc.green('  ✓ Created tsconfig.json'));
+    }
+    else {
+        console.log(pc.gray('  ✓ tsconfig.json already exists'));
+    }
+    // Generate type declaration stubs for editor support (no npm install needed)
+    writeTypeStubs(embeddablesDir);
+    console.log(pc.green('  ✓ Generated type declarations'));
+    // Remind user to install dependencies
+    console.log('');
+    console.log(pc.yellow('  → Run `npm install` to install dependencies'));
+    // Print next steps
+    console.log('');
+    console.log(pc.bold('  Next steps:'));
+    console.log('');
+    console.log(pc.cyan('    1. Login to Embeddables:'));
+    console.log(pc.white('       embeddables login'));
+    console.log('');
+    if (projectId) {
+        console.log(pc.cyan('    2. Pull an embeddable:'));
+        console.log(pc.white('       embeddables pull'));
+        console.log(pc.gray('       (will show a list of embeddables in your project)'));
+    }
+    else {
+        console.log(pc.cyan('    2. Pull an existing embeddable:'));
+        console.log(pc.white('       embeddables pull --id <embeddable-id>'));
+    }
+    console.log('');
+    console.log(pc.cyan('    3. Start developing:'));
+    console.log(pc.white('       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,iBAwNhG"}