feedbackbasket-cli 0.9.3 → 0.10.0

package/README.md

@@ -129,12 +129,15 @@ feedbackbasket bugs stats --project myapp   # Per-project stats
 feedbackbasket widget settings myapp
 
 # Update widget configuration
+feedbackbasket widget settings myapp --capture-mode waitlist
+feedbackbasket widget settings myapp --capture-mode feedback
 feedbackbasket widget settings myapp --color "#22c55e" --label "Send Feedback"
 feedbackbasket widget settings myapp --position bottom-left --display modal
 feedbackbasket widget settings myapp --email-required --intro "How can we improve?"
 feedbackbasket widget settings myapp --button-radius 10 --button-size regular
 feedbackbasket widget settings myapp --show-email --allow-attachments
 feedbackbasket widget settings myapp --email-read-only --hide-email-when-prefilled
+feedbackbasket widget settings myapp --error-tracking --allow-console-errors
 
 # Configure guided feedback types and follow-up questions
 feedbackbasket widget flow myapp
@@ -146,6 +149,19 @@ feedbackbasket widget flow myapp --config ./feedback-flow.json
 feedbackbasket widget script myapp
 ```
 
+Waitlist mode uses the same project script. Add `data-feedbackbasket-waitlist` to your own form, with a required `email` field and optional `name` field. The CLI's `widget script` output shows a starter form when waitlist mode is active.
+
+### Waitlist
+
+```bash
+feedbackbasket waitlist list myapp
+feedbackbasket waitlist list myapp --search "@example.com" --limit 50 --offset 0
+feedbackbasket waitlist list myapp --agent
+feedbackbasket waitlist export myapp
+```
+
+Waitlist listing returns emails, optional names, source pages, total counts, the active capture mode, and pagination. Export prints the dashboard-compatible CSV to stdout.
+
 For inline trigger mode, load the widget once and call the public API from your own button:
 
 ```html
@@ -156,6 +172,8 @@ For inline trigger mode, load the widget once and call the public API from your
 
 Passing the trigger element lets popup mode open beside your custom button. Calling `window.FeedbackWidget.openFeedbackForm()` with no arguments still uses the configured widget position.
 
+Use only the public `openFeedbackForm()` API from the snippet. Do not call internal or undocumented methods such as `open()` or `openModal()`.
+
 Use `--email-read-only` and `--hide-email-when-prefilled` with runtime `userEmail` values from your app. These settings do not store visitor emails in FeedbackBasket widget settings.
 
 The default widget experience is a basic modal. Only switch to popup mode or enable guided feedback when you intentionally want that flow.

package/dist/src/cli.js

@@ -11,6 +11,7 @@ import { createDoctorCommand } from './commands/doctor.js';
 import { createSetupCommand } from './commands/setup.js';
 import { createWidgetCommand } from './commands/widget.js';
 import { createTeamCommand } from './commands/team.js';
+import { createWaitlistCommand } from './commands/waitlist.js';
 import { renderRootHelp } from './help.js';
 let writer;
 function resolveFormat(opts) {
@@ -62,6 +63,7 @@ export function run() {
     program.addCommand(createFeedbackCommand(getWriter));
     program.addCommand(createBugsCommand(getWriter));
     program.addCommand(createWidgetCommand(getWriter));
+    program.addCommand(createWaitlistCommand(getWriter));
     program.addCommand(createTeamCommand(getWriter));
     program.addCommand(createDoctorCommand(getWriter));
     program.addCommand(createSetupCommand(getWriter));

package/dist/src/client.d.ts

@@ -1,6 +1,7 @@
-import type { ProjectsResponse, FeedbackResponse, BugReportsResponse, FeedbackParams, FeedbackCreateInput, FeedbackCreateResponse, FeedbackReplyResponse, BugReportParams, UserProfile, Project, Feedback, WidgetSettings } from './types.js';
+import type { ProjectsResponse, FeedbackResponse, BugReportsResponse, FeedbackParams, FeedbackCreateInput, FeedbackCreateResponse, FeedbackReplyResponse, BugReportParams, UserProfile, Project, Feedback, WidgetSettings, WaitlistResponse } from './types.js';
 export declare class FeedbackBasketClient {
-    private http;
+    private readonly apiBaseUrl;
+    private readonly token;
     constructor(token: string, baseUrl: string);
     me(): Promise<UserProfile>;
     listProjects(): Promise<ProjectsResponse>;
@@ -48,9 +49,16 @@ export declare class FeedbackBasketClient {
     getWidgetScript(projectId: string): Promise<{
         projectId: string;
         projectName: string;
+        captureMode: 'feedback' | 'waitlist';
         embedCode: string;
         scriptUrl: string;
     }>;
+    getWaitlist(projectId: string, params?: {
+        search?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<WaitlistResponse>;
+    exportWaitlist(projectId: string): Promise<string>;
     updateFeedback(id: string, data: {
         status?: string;
         category?: string;
@@ -118,5 +126,4 @@ export declare class FeedbackBasketClient {
         email: string;
     }>;
     private request;
-    private handleError;
 }

package/dist/src/client.js

@@ -1,18 +1,11 @@
-import axios, { AxiosError } from 'axios';
 import { USER_AGENT } from './version.js';
-import { errAuth, errForbidden, errRateLimit, errNetwork, errAPI } from './output/errors.js';
+import { CLIError, errAuth, errForbidden, errRateLimit, errNetwork, errAPI } from './output/errors.js';
 export class FeedbackBasketClient {
-    http;
+    apiBaseUrl;
+    token;
     constructor(token, baseUrl) {
-        this.http = axios.create({
-            baseURL: `${baseUrl}/api/v1`,
-            timeout: 30_000,
-            headers: {
-                'Authorization': `Bearer ${token}`,
-                'Content-Type': 'application/json',
-                'User-Agent': USER_AGENT,
-            },
-        });
+        this.apiBaseUrl = `${baseUrl.replace(/\/$/, '')}/api/v1`;
+        this.token = token;
     }
     async me() {
         return this.request('GET', '/auth/me');
@@ -63,6 +56,14 @@ export class FeedbackBasketClient {
     async getWidgetScript(projectId) {
         return this.request('GET', `/projects/${encodeURIComponent(projectId)}/widget-script`);
     }
+    async getWaitlist(projectId, params = {}) {
+        const query = buildQuery(params);
+        return this.request('GET', `/projects/${encodeURIComponent(projectId)}/waitlist${query}`);
+    }
+    async exportWaitlist(projectId) {
+        const data = await this.request('GET', `/projects/${encodeURIComponent(projectId)}/waitlist/export`);
+        return typeof data === 'string' ? data : JSON.stringify(data, null, 2);
+    }
     // Write operations
     async updateFeedback(id, data) {
         return this.request('PATCH', `/feedback/${encodeURIComponent(id)}`, data);
@@ -95,8 +96,8 @@ export class FeedbackBasketClient {
         return this.request('DELETE', `/feedback/${encodeURIComponent(feedbackId)}/notes/${encodeURIComponent(noteId)}`);
     }
     async exportFeedback(projectId, format = 'csv') {
-        const response = await this.http.get(`/projects/${encodeURIComponent(projectId)}/export?format=${format}`);
-        return typeof response.data === 'string' ? response.data : JSON.stringify(response.data, null, 2);
+        const data = await this.request('GET', `/projects/${encodeURIComponent(projectId)}/export?format=${format}`);
+        return typeof data === 'string' ? data : JSON.stringify(data, null, 2);
     }
     // Team
     async listTeam() {
@@ -109,34 +110,58 @@ export class FeedbackBasketClient {
         return this.request('DELETE', `/team/${encodeURIComponent(memberId)}`);
     }
     async request(method, path, data) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 30_000);
         try {
-            const response = await this.http.request({ method, url: path, data });
-            return response.data;
+            const response = await fetch(`${this.apiBaseUrl}${path}`, {
+                method,
+                signal: controller.signal,
+                headers: {
+                    'Authorization': `Bearer ${this.token}`,
+                    'Content-Type': 'application/json',
+                    'User-Agent': USER_AGENT,
+                },
+                body: data === undefined ? undefined : JSON.stringify(data),
+            });
+            const contentType = response.headers.get('content-type') ?? '';
+            const payload = contentType.includes('application/json')
+                ? await response.json().catch(() => null)
+                : await response.text();
+            if (!response.ok) {
+                const message = getErrorMessage(payload, response.statusText);
+                switch (response.status) {
+                    case 401: throw errAuth(message);
+                    case 403: throw errForbidden(message);
+                    case 404: throw errAPI(404, message);
+                    case 429: throw errRateLimit();
+                    default: throw errAPI(response.status, message);
+                }
+            }
+            return payload;
         }
         catch (error) {
-            throw this.handleError(error);
+            if (error instanceof CLIError)
+                throw error;
+            const cause = error instanceof Error ? error : new Error(String(error));
+            throw errNetwork(cause);
         }
-    }
-    handleError(error) {
-        if (error instanceof AxiosError) {
-            const status = error.response?.status;
-            const message = error.response?.data?.error
-                ?? error.response?.data?.message
-                ?? error.message;
-            if (!error.response) {
-                return errNetwork(error);
-            }
-            switch (status) {
-                case 401: return errAuth(message);
-                case 403: return errForbidden(message);
-                case 404: return errAPI(404, message);
-                case 429: return errRateLimit();
-                default: return errAPI(status ?? 500, message);
-            }
+        finally {
+            clearTimeout(timeout);
         }
-        return error instanceof Error ? error : new Error(String(error));
     }
 }
+function getErrorMessage(payload, fallback) {
+    if (payload && typeof payload === 'object') {
+        const value = payload;
+        if (typeof value.error === 'string')
+            return value.error;
+        if (typeof value.message === 'string')
+            return value.message;
+    }
+    if (typeof payload === 'string' && payload.trim())
+        return payload;
+    return fallback || 'Request failed';
+}
 function buildQuery(params) {
     const parts = [];
     for (const [key, value] of Object.entries(params)) {

package/dist/src/commands/waitlist.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+import { type OutputWriter } from '../output/writer.js';
+export declare function createWaitlistCommand(getWriter: () => OutputWriter): Command;

package/dist/src/commands/waitlist.js

@@ -0,0 +1,99 @@
+import { Command } from 'commander';
+import { FeedbackBasketClient } from '../client.js';
+import { AuthManager } from '../auth/manager.js';
+import { loadConfig } from '../config/config.js';
+import { errAuth, errUsage } from '../output/errors.js';
+import { Format } from '../output/writer.js';
+import { brand, divider } from '../output/theme.js';
+import { resolveProject } from '../resolve.js';
+export function createWaitlistCommand(getWriter) {
+    const waitlist = new Command('waitlist')
+        .description('View and export waitlist signups');
+    waitlist
+        .command('list [project]')
+        .description('List waitlist signups with optional search')
+        .option('--search <query>', 'Search email addresses and names')
+        .option('--limit <n>', 'Max results (1-100)', '50')
+        .option('--offset <n>', 'Offset for pagination', '0')
+        .action(async (projectArg, opts) => {
+        const writer = getWriter();
+        const client = requireClient();
+        const projectId = await resolveProjectId(client, projectArg);
+        const limit = parseInteger(opts.limit, '--limit', 1, 100);
+        const offset = parseInteger(opts.offset, '--offset', 0);
+        const result = await client.getWaitlist(projectId, {
+            search: opts.search,
+            limit,
+            offset,
+        });
+        if (writer.effectiveFormat() === Format.Styled) {
+            renderWaitlist(result.project.name, result.project.captureMode, result.entries, result.totalSignups, result.pagination.totalCount);
+            if (result.pagination.hasMore) {
+                console.log(brand.muted(`  Next page: feedbackbasket waitlist list ${projectId} --offset ${offset + limit} --limit ${limit}`));
+                console.log();
+            }
+            return;
+        }
+        writer.ok(result, {
+            summary: `Showing ${result.entries.length} of ${result.pagination.totalCount} matching waitlist signups`,
+        });
+    });
+    waitlist
+        .command('export [project]')
+        .description('Export all waitlist signups as CSV')
+        .action(async (projectArg) => {
+        const client = requireClient();
+        const projectId = await resolveProjectId(client, projectArg);
+        console.log(await client.exportWaitlist(projectId));
+    });
+    return waitlist;
+}
+function requireClient() {
+    const manager = new AuthManager();
+    const token = manager.resolveToken();
+    if (!token)
+        throw errAuth();
+    const config = loadConfig();
+    return new FeedbackBasketClient(token, config.baseUrl);
+}
+async function resolveProjectId(client, projectArg) {
+    if (projectArg)
+        return (await resolveProject(client, projectArg)).id;
+    const config = loadConfig();
+    if (config.defaultProject)
+        return config.defaultProject;
+    throw errUsage('Project is required. Pass a project name/ID or set a default.', 'feedbackbasket waitlist list <project>');
+}
+function parseInteger(value, flag, minimum, maximum) {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) ||
+        parsed < minimum ||
+        (maximum !== undefined && parsed > maximum)) {
+        const range = maximum === undefined ? `${minimum} or greater` : `${minimum}-${maximum}`;
+        throw errUsage(`${flag} must be an integer in the range ${range}`);
+    }
+    return parsed;
+}
+function renderWaitlist(projectName, captureMode, entries, totalSignups, matchingSignups) {
+    console.log(brand.bold(`Waitlist — ${projectName}`));
+    console.log(divider(50));
+    console.log();
+    console.log(`  ${brand.label('Capture mode')}  ${captureMode}`);
+    console.log(`  ${brand.label('Total signups')} ${totalSignups}`);
+    if (matchingSignups !== totalSignups) {
+        console.log(`  ${brand.label('Matches')}       ${matchingSignups}`);
+    }
+    console.log();
+    if (entries.length === 0) {
+        console.log(`  ${brand.muted('No waitlist signups found')}`);
+        console.log();
+        return;
+    }
+    for (const entry of entries) {
+        console.log(`  ${brand.bold(entry.email)}${entry.name ? ` — ${entry.name}` : ''}`);
+        console.log(`    ${brand.muted(new Date(entry.updatedAt).toLocaleString())}`);
+        if (entry.pageUrl)
+            console.log(`    ${brand.muted(entry.pageUrl)}`);
+        console.log();
+    }
+}

package/dist/src/commands/widget.js

@@ -51,6 +51,7 @@ export function createWidgetCommand(getWriter) {
     widget
         .command('settings [project]')
         .description('View or update widget settings')
+        .option('--capture-mode <mode>', 'Capture mode (feedback, waitlist)')
         .option('--color <hex>', 'Button color (e.g. #22c55e)')
         .option('--label <text>', 'Button label')
         .option('--position <pos>', 'Widget position (bottom-right, bottom-left, middle-right-edge, middle-left-edge, bottom-right-edge, bottom-left-edge)')
@@ -77,6 +78,10 @@ export function createWidgetCommand(getWriter) {
         .option('--no-show-icon', 'Hide the icon')
         .option('--show-branding', 'Show FeedbackBasket branding')
         .option('--no-show-branding', 'Hide FeedbackBasket branding when plan allows it')
+        .option('--allow-console-errors', 'Let visitors include captured console errors with feedback')
+        .option('--no-allow-console-errors', 'Hide the console error sharing option')
+        .option('--error-tracking', 'Enable automatic browser error tracking')
+        .option('--no-error-tracking', 'Disable automatic browser error tracking')
         .option('--z-index <value>', 'Widget z-index')
         .option('--guided', 'Enable guided feedback types')
         .option('--disable-guided', 'Disable guided feedback types')
@@ -84,20 +89,26 @@ export function createWidgetCommand(getWriter) {
         const writer = getWriter();
         const client = requireClient();
         const projectId = await resolveProjectId(client, projectArg);
-        const hasUpdates = opts.color || opts.label || opts.position || opts.intro ||
+        const hasUpdates = opts.captureMode || opts.color || opts.label || opts.position || opts.intro ||
             opts.success || opts.trigger || opts.display ||
             opts.buttonRadius || opts.buttonSize || opts.icon ||
             opts.emailRequired !== undefined || opts.showEmail !== undefined ||
             opts.emailReadOnly !== undefined || opts.hideEmailWhenPrefilled !== undefined ||
             opts.allowAttachments !== undefined || opts.iconOnly !== undefined ||
             opts.showIcon !== undefined || opts.showBranding !== undefined ||
+            opts.allowConsoleErrors !== undefined || opts.errorTracking !== undefined ||
             opts.zIndex || opts.guided || opts.disableGuided;
         if (hasUpdates) {
             if (opts.guided && opts.disableGuided) {
                 throw errUsage('Choose either --guided or --disable-guided, not both');
             }
+            if (opts.captureMode && !['feedback', 'waitlist'].includes(opts.captureMode)) {
+                throw errUsage('Capture mode must be feedback or waitlist');
+            }
             // Update mode
             const settings = {};
+            if (opts.captureMode)
+                settings.captureMode = opts.captureMode;
             if (opts.color)
                 settings.buttonColor = opts.color;
             if (opts.label)
@@ -134,6 +145,10 @@ export function createWidgetCommand(getWriter) {
                 settings.showIcon = opts.showIcon;
             if (opts.showBranding !== undefined)
                 settings.showBranding = opts.showBranding;
+            if (opts.allowConsoleErrors !== undefined)
+                settings.allowConsoleErrors = opts.allowConsoleErrors;
+            if (opts.errorTracking !== undefined)
+                settings.errorTrackingEnabled = opts.errorTracking;
             if (opts.zIndex)
                 settings.zIndex = parseInt(opts.zIndex, 10);
             if (opts.guided || opts.disableGuided) {
@@ -253,9 +268,26 @@ export function createWidgetCommand(getWriter) {
             console.log();
             console.log(brand.muted(`  Script URL: ${result.scriptUrl}`));
             console.log();
-            renderInlineTriggerHelp(settingsResult.settings);
+            if (settingsResult.settings.captureMode === 'waitlist') {
+                renderWaitlistHelp();
+            }
+            else {
+                renderInlineTriggerHelp(settingsResult.settings);
+            }
         }
-        writer.ok(result, {
+        const output = result.captureMode === 'waitlist'
+            ? {
+                ...result,
+                waitlist: {
+                    formAttribute: 'data-feedbackbasket-waitlist',
+                    requiredField: 'email',
+                    optionalField: 'name',
+                    stateAttribute: 'data-feedbackbasket-state',
+                    events: ['feedbackbasket:waitlist:success', 'feedbackbasket:waitlist:error'],
+                },
+            }
+            : result;
+        writer.ok(output, {
             summary: `Embed code for "${result.projectName}"`,
             breadcrumbs: [
                 { action: 'Customize widget', cmd: `feedbackbasket widget settings ${projectId}` },
@@ -362,6 +394,23 @@ function renderInlineTriggerHelp(settings) {
         console.log(brand.muted('  Modal mode stays centered; passing the trigger is safe for future popup changes.'));
     }
     console.log(brand.muted('  Existing calls to window.FeedbackWidget.openFeedbackForm() still work.'));
+    console.log(brand.muted('  Do not call internal methods such as open() or openModal().'));
+    console.log();
+}
+function renderWaitlistHelp() {
+    console.log(brand.bold('Waitlist form setup'));
+    console.log(divider(50));
+    console.log();
+    console.log(brand.muted('  Keep the project script installed and annotate your own form:'));
+    console.log();
+    console.log(`  ${brand.primary('<form data-feedbackbasket-waitlist>')}`);
+    console.log(`  ${brand.primary('  <input name="name" autocomplete="name">')}`);
+    console.log(`  ${brand.primary('  <input name="email" type="email" autocomplete="email" required>')}`);
+    console.log(`  ${brand.primary('  <button type="submit">Join the waitlist</button>')}`);
+    console.log(`  ${brand.primary('</form>')}`);
+    console.log();
+    console.log(brand.muted('  Email is required; name is optional. The script handles submission without replacing your styling.'));
+    console.log(brand.muted('  Read data-feedbackbasket-state for loading, success, and error UI.'));
     console.log();
 }
 function renderWidgetSettings(projectName, settings) {
@@ -369,6 +418,7 @@ function renderWidgetSettings(projectName, settings) {
     console.log(divider(40));
     console.log();
     const display = [
+        ['Capture Mode', String(settings.captureMode ?? 'feedback')],
         ['Button Color', String(settings.buttonColor ?? '')],
         ['Button Label', String(settings.buttonLabel ?? '')],
         ['Button Radius', String(settings.buttonRadius ?? '')],
@@ -389,6 +439,8 @@ function renderWidgetSettings(projectName, settings) {
         ['Success Message', String(settings.successMessage ?? '')],
         ['Z-Index', String(settings.zIndex ?? '')],
         ['Show Branding', String(settings.showBranding ?? true)],
+        ['Share Console Errors', String(settings.allowConsoleErrors ?? false)],
+        ['Error Tracking', String(settings.errorTrackingEnabled ?? false)],
     ];
     for (const [label, value] of display) {
         console.log(`  ${brand.label(label.padEnd(18))} ${value}`);

package/dist/src/help.js

@@ -17,7 +17,7 @@ export function renderRootHelp() {
     lines.push(`  ${logo()} CLI ${brand.muted(`v${VERSION}`)}`);
     lines.push('');
     lines.push(`  ${brand.muted('The command-line interface for FeedbackBasket.')}`);
-    lines.push(`  ${brand.muted('Manage projects, feedback, widgets, and team from your terminal.')}`);
+    lines.push(`  ${brand.muted('Manage projects, feedback, waitlists, widgets, and team from your terminal.')}`);
     lines.push('');
     // Core Commands
     lines.push(section('  CORE COMMANDS'));
@@ -25,6 +25,7 @@ export function renderRootHelp() {
     lines.push(cmd('feedback', 'View and manage feedback'));
     lines.push(cmd('bugs', 'View bug reports with severity'));
     lines.push(cmd('widget', 'Manage feedback widget & get embed code'));
+    lines.push(cmd('waitlist', 'View and export waitlist signups'));
     lines.push(cmd('team', 'Manage organization members'));
     lines.push('');
     // Shortcuts
@@ -36,6 +37,7 @@ export function renderRootHelp() {
     lines.push(section('  SEARCH & EXPORT'));
     lines.push(cmd('feedback search', 'Search feedback across projects'));
     lines.push(cmd('feedback export', 'Export feedback to CSV, Markdown, or JSON'));
+    lines.push(cmd('waitlist export', 'Export waitlist signups to CSV'));
     lines.push(cmd('bugs stats', 'Bug statistics summary'));
     lines.push('');
     // Auth & Config
@@ -62,6 +64,8 @@ export function renderRootHelp() {
     lines.push(`${INDENT}${brand.muted('$')} feedbackbasket bugs list --severity high`);
     lines.push(`${INDENT}${brand.muted('$')} feedbackbasket widget script myapp`);
     lines.push(`${INDENT}${brand.muted('$')} feedbackbasket widget settings myapp --display modal`);
+    lines.push(`${INDENT}${brand.muted('$')} feedbackbasket widget settings myapp --capture-mode waitlist`);
+    lines.push(`${INDENT}${brand.muted('$')} feedbackbasket waitlist list myapp --search "@example.com"`);
     lines.push(`${INDENT}${brand.muted('$')} feedbackbasket projects create "My App" --url https://myapp.com`);
     lines.push('');
     // Learn More

package/dist/src/types.d.ts

@@ -24,6 +24,7 @@ export interface FeedbackFlowSettings {
     types: FeedbackFlowType[];
 }
 export interface WidgetSettings {
+    captureMode?: 'feedback' | 'waitlist';
     widgetType?: string;
     triggerMode?: 'floating' | 'inline';
     buttonColor?: string;
@@ -44,6 +45,8 @@ export interface WidgetSettings {
     displayMode?: 'modal' | 'popup';
     zIndex?: number;
     showBranding?: boolean;
+    allowConsoleErrors?: boolean;
+    errorTrackingEnabled?: boolean;
     feedbackFlow?: FeedbackFlowSettings;
 }
 export interface Project {
@@ -124,6 +127,25 @@ export interface Pagination {
     offset: number;
     hasMore: boolean;
 }
+export interface WaitlistEntry {
+    id: string;
+    email: string;
+    name?: string | null;
+    pageUrl?: string | null;
+    referrerUrl?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface WaitlistResponse {
+    project: {
+        id: string;
+        name: string;
+        captureMode: 'feedback' | 'waitlist';
+    };
+    entries: WaitlistEntry[];
+    totalSignups: number;
+    pagination: Pagination;
+}
 export interface FeedbackResponse {
     feedback: Feedback[];
     pagination: Pagination;

package/dist/src/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.9.3";
-export declare const USER_AGENT = "FeedbackBasket-CLI/0.9.3";
+export declare const VERSION = "0.10.0";
+export declare const USER_AGENT = "FeedbackBasket-CLI/0.10.0";

package/dist/src/version.js

@@ -1,2 +1,2 @@
-export const VERSION = '0.9.3';
+export const VERSION = '0.10.0';
 export const USER_AGENT = `FeedbackBasket-CLI/${VERSION}`;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "feedbackbasket-cli",
-  "version": "0.9.3",
-  "description": "Command-line interface for FeedbackBasket — manage feedback from your terminal",
+  "version": "0.10.0",
+  "description": "Command-line interface for FeedbackBasket — manage feedback and waitlists from your terminal",
   "type": "module",
   "main": "dist/src/cli.js",
   "bin": {
@@ -28,14 +28,13 @@
   },
   "homepage": "https://feedbackbasket.com",
   "dependencies": {
-    "axios": "1.7.0",
     "chalk": "^5.3.0",
     "commander": "^13.1.0",
     "open": "^10.1.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "tsx": "^4.0.0",
+    "tsx": "^4.23.0",
     "typescript": "^5.7.0"
   },
   "engines": {

package/skills/feedbackbasket/SKILL.md

@@ -1,21 +1,11 @@
 ---
-name: FeedbackBasket
-description: Manage FeedbackBasket projects, feedback, bugs, widgets, and team from the command line
-triggers:
-  - feedbackbasket
-  - feedback
-  - bugs
-  - bug reports
-  - user feedback
-  - widget
-  - feedback widget
-invocable: true
-argument-hint: "<command> [options]"
+name: feedbackbasket
+description: Manage FeedbackBasket projects, feedback, bugs, feedback widgets, waitlist capture, and teams from the command line. Use when an agent needs to configure FeedbackBasket, collect feedback or waitlist signups, query feedback, or manage a FeedbackBasket project.
 ---
 
 # FeedbackBasket CLI
 
-Full command-line interface for managing feedback, bug reports, projects, widgets, and team in FeedbackBasket. Works with any AI agent that can run shell commands.
+Full command-line interface for managing feedback, waitlist signups, bug reports, projects, widgets, and teams in FeedbackBasket. Works with any AI agent that can run shell commands.
 
 ## Authentication
 
@@ -63,6 +53,8 @@ All project commands accept **name or ID**. Names are matched case-insensitively
 
 **Project URL rule for agents:** confirm the real website URL before creating or updating a project. Never use `localhost`, `127.0.0.1`, `0.0.0.0`, `::1`, or a local dev server URL unless the user explicitly says the project is only for local testing. If the repo only exposes a local URL, ask for the production, staging, preview, or intended public URL. Do not guess a public domain from package names, git remotes, or environment variables. For an explicitly local-only test project, pass `--allow-local-url`.
 
+**Capture-mode decision:** if the user asks for feedback, a feedback bubble, bug reports, or feature requests, use `--capture-mode feedback`. If they ask for a waitlist, launch list, early access, or email capture, use `--capture-mode waitlist`. If they ask to set up FeedbackBasket without choosing, explain both options and ask which they want. Do not switch an existing project without confirmation because only one capture mode is active at a time.
+
 ### Feedback
 ```bash
 # Read
@@ -104,6 +96,8 @@ feedbackbasket widget script <project>
 
 # View settings
 feedbackbasket widget settings <project>
+feedbackbasket widget settings <project> --capture-mode waitlist
+feedbackbasket widget settings <project> --capture-mode feedback
 
 # Customize
 feedbackbasket widget settings <project> --color "#22c55e" --label "Send Feedback"
@@ -111,6 +105,7 @@ feedbackbasket widget settings <project> --position bottom-left --display modal
 feedbackbasket widget settings <project> --email-required --intro "How can we improve?"
 feedbackbasket widget settings <project> --show-email --allow-attachments
 feedbackbasket widget settings <project> --email-read-only --hide-email-when-prefilled
+feedbackbasket widget settings <project> --error-tracking --allow-console-errors
 
 # Guided feedback types and follow-up questions
 feedbackbasket widget flow <project>
@@ -119,6 +114,29 @@ feedbackbasket widget flow <project> --reset-default --enable  # only when the u
 feedbackbasket widget flow <project> --config ./feedback-flow.json
 ```
 
+Waitlist mode keeps the same project script and binds to the host app's own annotated form:
+
+```html
+<form data-feedbackbasket-waitlist>
+  <input name="name" autocomplete="name">
+  <input name="email" type="email" autocomplete="email" required>
+  <button type="submit">Join the waitlist</button>
+</form>
+```
+
+Email is required and name is optional. Use `data-feedbackbasket-state="loading|success|error"` for custom UI, or listen for the bubbling `feedbackbasket:waitlist:success` and `feedbackbasket:waitlist:error` events. Do not add a competing submit handler.
+
+### Waitlist Signups
+
+```bash
+feedbackbasket waitlist list <project>
+feedbackbasket waitlist list <project> --search "@example.com" --limit 50 --offset 0
+feedbackbasket waitlist list <project> --agent
+feedbackbasket waitlist export <project>
+```
+
+Agent output includes signup emails, optional names, captured/referrer pages, total counts, active capture mode, and pagination. Use `waitlist export` for the same CSV export available in the dashboard.
+
 For inline trigger mode, load the widget once and call the public API from the host app's custom button:
 
 ```html
@@ -137,6 +155,8 @@ In React:
 
 Passing the trigger element lets popup mode open beside the custom button. Calling `window.FeedbackWidget.openFeedbackForm()` with no arguments still uses the configured widget position.
 
+Use only the public `openFeedbackForm()` API from the snippet. Do not call internal or undocumented methods such as `open()`, `openModal()`, or direct modal element manipulation; those can exist in the widget bundle but are not stable integration points.
+
 `email-read-only` and `hide-email-when-prefilled` control behavior only when the host app passes a runtime `userEmail` value. Do not store visitor emails in widget settings.
 
 Use the basic widget experience by default: `displayMode` stays `modal`, and guided feedback stays disabled. Ask the user before switching to `popup` or enabling guided feedback. If the user does not care, keep modal + basic feedback.
@@ -168,6 +188,8 @@ feedbackbasket projects create "My App" --url https://myapp.com --agent
 feedbackbasket widget script "My App" --agent
 # Agent gets the embed code, adds it to the HTML
 feedbackbasket widget settings "My App" --color "#22c55e" --label "Feedback" --agent
+# Optional, when the user wants a waitlist instead of feedback capture
+# feedbackbasket widget settings "My App" --capture-mode waitlist --agent
 # Optional, only when requested: enable the guided wizard with Bug, Feature, and General templates
 # feedbackbasket widget flow "My App" --reset-default --enable --agent
 ```