feedbackbasket-cli 0.10.0 → 0.12.0

package/dist/src/cli.js

@@ -12,6 +12,7 @@ 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 { createMobileCommand } from './commands/mobile.js';
 import { renderRootHelp } from './help.js';
 let writer;
 function resolveFormat(opts) {
@@ -64,6 +65,7 @@ export function run() {
     program.addCommand(createBugsCommand(getWriter));
     program.addCommand(createWidgetCommand(getWriter));
     program.addCommand(createWaitlistCommand(getWriter));
+    program.addCommand(createMobileCommand(getWriter));
     program.addCommand(createTeamCommand(getWriter));
     program.addCommand(createDoctorCommand(getWriter));
     program.addCommand(createSetupCommand(getWriter));

package/dist/src/client.d.ts

@@ -1,4 +1,4 @@
-import type { ProjectsResponse, FeedbackResponse, BugReportsResponse, FeedbackParams, FeedbackCreateInput, FeedbackCreateResponse, FeedbackReplyResponse, BugReportParams, UserProfile, Project, Feedback, WidgetSettings, WaitlistResponse } from './types.js';
+import type { ProjectsResponse, FeedbackResponse, BugReportsResponse, FeedbackParams, FeedbackCreateInput, FeedbackCreateResponse, FeedbackReplyResponse, BugReportParams, UserProfile, Project, Feedback, WidgetSettings, WaitlistResponse, MobileIntegrationResponse } from './types.js';
 export declare class FeedbackBasketClient {
     private readonly apiBaseUrl;
     private readonly token;
@@ -53,6 +53,14 @@ export declare class FeedbackBasketClient {
         embedCode: string;
         scriptUrl: string;
     }>;
+    getMobileIntegration(projectId: string, includePublishableKey?: boolean): Promise<MobileIntegrationResponse>;
+    updateMobileIntegration(projectId: string, data: {
+        enabled?: boolean;
+        allowVisitorReplies?: boolean;
+        addBundleIds?: string[];
+        removeBundleIds?: string[];
+    }, includePublishableKey?: boolean): Promise<MobileIntegrationResponse>;
+    rotateMobileProjectKey(projectId: string, includePublishableKey?: boolean): Promise<MobileIntegrationResponse>;
     getWaitlist(projectId: string, params?: {
         search?: string;
         limit?: number;

package/dist/src/client.js

@@ -56,6 +56,19 @@ export class FeedbackBasketClient {
     async getWidgetScript(projectId) {
         return this.request('GET', `/projects/${encodeURIComponent(projectId)}/widget-script`);
     }
+    // Mobile feedback
+    async getMobileIntegration(projectId, includePublishableKey = false) {
+        const query = includePublishableKey ? '?includePublishableKey=true' : '';
+        return this.request('GET', `/projects/${encodeURIComponent(projectId)}/mobile${query}`);
+    }
+    async updateMobileIntegration(projectId, data, includePublishableKey = false) {
+        const query = includePublishableKey ? '?includePublishableKey=true' : '';
+        return this.request('PATCH', `/projects/${encodeURIComponent(projectId)}/mobile${query}`, data);
+    }
+    async rotateMobileProjectKey(projectId, includePublishableKey = false) {
+        const query = includePublishableKey ? '?includePublishableKey=true' : '';
+        return this.request('POST', `/projects/${encodeURIComponent(projectId)}/mobile/rotate-key${query}`);
+    }
     async getWaitlist(projectId, params = {}) {
         const query = buildQuery(params);
         return this.request('GET', `/projects/${encodeURIComponent(projectId)}/waitlist${query}`);

package/dist/src/commands/feedback-reply.d.ts

@@ -1,4 +1,6 @@
 import { Command } from 'commander';
 import type { OutputWriter } from '../output/writer.js';
+import type { ReplyDelivery } from '../types.js';
 export declare function createFeedbackReplyCommand(getWriter: () => OutputWriter): Command;
 export declare function createFeedbackRepliesCommand(getWriter: () => OutputWriter): Command;
+export declare function replyDestinations(delivery: ReplyDelivery): Array<'email' | 'widget'>;

package/dist/src/commands/feedback-reply.js

@@ -5,14 +5,14 @@ import { loadConfig } from '../config/config.js';
 import { errAuth, errUsage } from '../output/errors.js';
 import { brand } from '../output/theme.js';
 import { ask } from '../prompt.js';
-const deliveryOptions = new Set(['email', 'widget', 'both']);
+const deliveryOptions = new Set(['email', 'widget', 'in-app', 'both']);
 export function createFeedbackReplyCommand(getWriter) {
     return new Command('reply')
         .argument('<id>', 'Feedback ID to reply to')
         .argument('[content]', 'Reply content (or use --content)')
-        .description('Reply to feedback by email, widget thread, or both')
+        .description('Reply to feedback by email, widget/in-app thread, or both')
         .option('--content <text>', 'Reply content (alternative to positional argument)')
-        .option('--delivery <delivery>', 'Reply delivery (email, widget, both)', 'email')
+        .option('--delivery <delivery>', 'Reply delivery (email, widget, in-app, both)', 'email')
         .option('--reply-to <email>', 'Reply-to email for email delivery')
         .action(async (id, contentArg, opts) => {
         const writer = getWriter();
@@ -22,19 +22,22 @@ export function createFeedbackReplyCommand(getWriter) {
             throw errUsage('Reply content is required', 'Example: feedbackbasket feedback reply <id> "Thanks for reporting this!" --delivery widget');
         }
         if (!deliveryOptions.has(delivery)) {
-            throw errUsage('Delivery must be email, widget, or both', 'Example: feedbackbasket feedback reply <id> "Thanks!" --delivery both --reply-to support@example.com');
+            throw errUsage('Delivery must be email, widget, in-app, or both', 'Example: feedbackbasket feedback reply <id> "Thanks!" --delivery both --reply-to support@example.com');
         }
         const client = requireClient();
         const feedback = await client.getFeedbackById(id);
-        const destinations = delivery === 'both'
-            ? ['email', 'widget']
-            : [delivery];
+        if (delivery === 'in-app' && feedback.replyChannel !== 'in_app') {
+            throw errUsage('This feedback does not have an in-app reply thread.', 'Use --delivery widget for website-widget feedback or --delivery email when an email address is available.');
+        }
+        const destinations = replyDestinations(delivery);
         const sendsEmail = destinations.includes('email');
         const sendsWidget = destinations.includes('widget');
         let replyTo = opts.replyTo ?? feedback.project.replyToEmail ?? undefined;
         if (sendsEmail) {
             if (!feedback.email) {
-                throw errUsage('This feedback has no email address; use --delivery widget if it has a widget thread.');
+                throw errUsage(feedback.replyChannel === 'in_app'
+                    ? 'This feedback has no email address; use --delivery in-app.'
+                    : 'This feedback has no email address; use --delivery widget if it has a widget thread.');
             }
             if (!replyTo) {
                 const isInteractive = !writer.isMachineOutput() && process.stdin.isTTY;
@@ -56,7 +59,7 @@ export function createFeedbackReplyCommand(getWriter) {
             }
         }
         if (sendsWidget && !feedback.hasWidgetAccess) {
-            throw errUsage('This feedback is not connected to a widget thread.', 'Use --delivery email for feedback with an email address, or ask the human how they want to respond.');
+            throw errUsage('This feedback has no in-app or widget reply thread.', 'Use --delivery email for feedback with an email address, or ask the human how they want to respond.');
         }
         const result = await client.sendReply(id, content, {
             replyToEmail: replyTo,
@@ -71,16 +74,16 @@ export function createFeedbackReplyCommand(getWriter) {
                 }
             }
             if (result.message) {
-                console.log(`  ${brand.success('[OK]')} Widget reply posted`);
+                console.log(`  ${brand.success('[OK]')} ${feedback.replyChannel === 'in_app' ? 'In-app' : 'Widget'} reply posted`);
                 console.log(`    ${brand.muted('By:')}   ${result.message.sentByName ?? 'CLI'}`);
             }
             console.log();
         }
         writer.ok(result, {
             summary: delivery === 'both'
-                ? 'Reply sent by email and widget'
-                : delivery === 'widget'
-                    ? 'Widget reply posted'
+                ? `Reply sent by email and ${feedback.replyChannel === 'in_app' ? 'in-app' : 'widget'}`
+                : sendsWidget
+                    ? `${feedback.replyChannel === 'in_app' ? 'In-app' : 'Widget'} reply posted`
                     : `Reply sent to ${result.sentTo}`,
             breadcrumbs: [
                 { action: 'View replies', cmd: `feedbackbasket feedback replies ${id}` },
@@ -93,44 +96,53 @@ export function createFeedbackReplyCommand(getWriter) {
 export function createFeedbackRepliesCommand(getWriter) {
     return new Command('replies')
         .argument('<id>', 'Feedback ID')
-        .description('List all replies sent for a feedback item')
+        .description('List the complete feedback conversation')
         .action(async (id) => {
         const writer = getWriter();
         const client = requireClient();
         const result = await client.listReplies(id);
         const messages = result.messages ?? [];
-        const visibleWidgetMessages = messages.filter((item) => !item.replyId);
+        const linkedReplyIds = new Set(messages.map((item) => item.replyId).filter((replyId) => replyId !== null));
+        const visibleEmailReplies = result.replies.filter((item) => !linkedReplyIds.has(item.id));
+        const conversation = [
+            ...visibleEmailReplies.map((item) => ({ kind: 'email', item })),
+            ...messages.map((item) => ({ kind: 'thread', item })),
+        ].sort((left, right) => new Date(left.item.createdAt).getTime() - new Date(right.item.createdAt).getTime());
         if (!writer.isMachineOutput()) {
             if (result.total === 0) {
                 console.log(brand.muted('  No replies sent yet.'));
                 console.log();
             }
             else {
-                console.log(brand.bold(`${result.total} repl${result.total === 1 ? 'y' : 'ies'} for feedback ${id}`));
+                console.log(brand.bold(`${result.total} conversation message${result.total === 1 ? '' : 's'} for feedback ${id}`));
                 console.log();
-                for (const r of result.replies) {
-                    console.log(`  ${brand.success('->')} ${brand.bold(r.sentBy)} ${brand.muted(r.createdAt)}`);
-                    console.log(`    ${brand.muted('Delivery:')} email`);
-                    console.log(`    ${brand.muted('Reply-to:')} ${r.replyToEmail}`);
-                    console.log();
-                    for (const line of r.content.split('\n')) {
-                        console.log(`    ${line}`);
+                for (const entry of conversation) {
+                    if (entry.kind === 'email') {
+                        const emailReply = entry.item;
+                        console.log(`  ${brand.success('->')} ${brand.bold(emailReply.sentBy)} ${brand.muted(emailReply.createdAt)}`);
+                        console.log(`    ${brand.muted('Delivery:')} email`);
+                        console.log(`    ${brand.muted('Reply-to:')} ${emailReply.replyToEmail}`);
+                        console.log();
+                        for (const line of emailReply.content.split('\n')) {
+                            console.log(`    ${line}`);
+                        }
                     }
-                    console.log();
-                }
-                for (const message of visibleWidgetMessages) {
-                    console.log(`  ${brand.success('->')} ${brand.bold(message.sentByName ?? 'CLI')} ${brand.muted(message.createdAt)}`);
-                    console.log(`    ${brand.muted('Delivery:')} widget`);
-                    console.log();
-                    for (const line of message.content.split('\n')) {
-                        console.log(`    ${line}`);
+                    else {
+                        const message = entry.item;
+                        const visitor = message.senderType === 'VISITOR';
+                        console.log(`  ${visitor ? brand.primary('<-') : brand.success('->')} ${brand.bold(visitor ? 'User' : (message.sentByName ?? 'CLI'))} ${brand.muted(message.createdAt)}`);
+                        console.log(`    ${brand.muted('Delivery:')} ${visitor ? 'visitor follow-up' : message.delivery === 'BOTH' ? 'email + widget/in-app' : 'widget/in-app'}`);
+                        console.log();
+                        for (const line of message.content.split('\n')) {
+                            console.log(`    ${line}`);
+                        }
                     }
                     console.log();
                 }
             }
         }
         writer.ok({ replies: result.replies, messages }, {
-            summary: `${result.total} repl${result.total === 1 ? 'y' : 'ies'}`,
+            summary: `${result.total} conversation message${result.total === 1 ? '' : 's'}`,
             breadcrumbs: [
                 { action: 'Send an email reply', cmd: `feedbackbasket feedback reply ${id} "<content>" --delivery email` },
                 { action: 'Post a widget reply', cmd: `feedbackbasket feedback reply ${id} "<content>" --delivery widget` },
@@ -139,6 +151,13 @@ export function createFeedbackRepliesCommand(getWriter) {
         });
     });
 }
+export function replyDestinations(delivery) {
+    if (delivery === 'both')
+        return ['email', 'widget'];
+    if (delivery === 'in-app')
+        return ['widget'];
+    return [delivery];
+}
 function requireClient() {
     const manager = new AuthManager();
     const token = manager.resolveToken();

package/dist/src/commands/feedback.js

@@ -186,7 +186,8 @@ function renderFeedbackDetail(item) {
         ['OS', item.os],
         ['Device', item.device],
         ['Language', item.language],
-        ['Widget Thread', item.hasWidgetAccess ? 'Yes' : null],
+        ['Reply Channel', item.replyChannel === 'in_app' ? 'In-app' : item.hasWidgetAccess ? 'Widget' : null],
+        ['Conversation', item.awaitingOwnerReply ? 'User replied — team response needed' : null],
         ['Created', item.createdAt],
     ];
     for (const [label, value] of fields) {

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

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+import type { MobileIntegrationResponse } from '../types.js';
+import type { OutputWriter } from '../output/writer.js';
+export declare function createMobileCommand(getWriter: () => OutputWriter): Command;
+export declare function projectRef(projectArg: string | undefined, projectId: string): string;
+export declare function validateBundleIds(bundleIds: string[]): string[];
+export declare function isMobileConnectionVerified(result: MobileIntegrationResponse, expectedBundleId?: string): boolean;

package/dist/src/commands/mobile.js

@@ -0,0 +1,319 @@
+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 { brand, divider } from '../output/theme.js';
+import { confirm } from '../prompt.js';
+import { resolveProject } from '../resolve.js';
+const BUNDLE_ID_PATTERN = /^[A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)+$/;
+const SAFE_PROJECT_REF_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]*(?: [A-Za-z0-9][A-Za-z0-9._-]*)*$/;
+const VERIFY_POLL_INTERVAL_MS = 5_000;
+const MAX_VERIFY_WAIT_SECONDS = 300;
+export function createMobileCommand(getWriter) {
+    const mobile = new Command('mobile')
+        .description('Set up and verify mobile app feedback');
+    mobile
+        .command('status [project]')
+        .description('Show mobile feedback configuration and connection status')
+        .option('--include-publishable-key', 'Include the full publishable mobile project key')
+        .action(async (projectArg, opts) => {
+        const writer = getWriter();
+        const client = requireClient();
+        const projectId = await resolveProjectId(client, projectArg);
+        const ref = projectRef(projectArg, projectId);
+        const result = await client.getMobileIntegration(projectId, Boolean(opts.includePublishableKey));
+        if (!writer.isMachineOutput())
+            renderMobileStatus(result);
+        writer.ok(result, {
+            summary: `Mobile feedback for "${result.project.name}"`,
+            breadcrumbs: result.integration
+                ? [
+                    { action: 'Verify SDK connection', cmd: `feedbackbasket mobile verify ${ref}` },
+                    { action: 'Add a bundle ID', cmd: `feedbackbasket mobile bundle-ids ${ref} --add com.example.app` },
+                    { action: 'Configure conversations', cmd: `feedbackbasket mobile conversations ${ref} --enable` },
+                ]
+                : [
+                    { action: 'Enable mobile feedback', cmd: `feedbackbasket mobile setup ${ref}` },
+                ],
+        });
+    });
+    mobile
+        .command('setup [project]')
+        .description('Enable mobile feedback and add allowed bundle IDs')
+        .option('--bundle-id <bundle-id>', 'Allowed iOS bundle ID (repeatable)', collect, [])
+        .option('--include-publishable-key', 'Include the full publishable key required to configure the app')
+        .action(async (projectArg, opts) => {
+        const writer = getWriter();
+        const client = requireClient();
+        const projectId = await resolveProjectId(client, projectArg);
+        const bundleIds = validateBundleIds(opts.bundleId);
+        const result = await client.updateMobileIntegration(projectId, { enabled: true, addBundleIds: bundleIds }, Boolean(opts.includePublishableKey));
+        if (!writer.isMachineOutput()) {
+            console.log(`  ${brand.success('✓')} Mobile feedback enabled for ${brand.bold(result.project.name)}`);
+            if (!opts.includePublishableKey) {
+                console.log(`  ${brand.muted('The publishable key is masked. Re-run with --include-publishable-key when configuring the app.')}`);
+            }
+            console.log();
+        }
+        const ref = projectRef(projectArg, projectId);
+        writer.ok(withSetupGuidance(result), {
+            summary: `Mobile feedback ready for "${result.project.name}"`,
+            breadcrumbs: [
+                { action: 'Check connection', cmd: `feedbackbasket mobile verify ${ref}` },
+                { action: 'View mobile status', cmd: `feedbackbasket mobile status ${ref}` },
+            ],
+        });
+    });
+    mobile
+        .command('bundle-ids [project]')
+        .description('Add or remove allowed iOS bundle IDs')
+        .option('--add <bundle-id>', 'Bundle ID to add (repeatable)', collect, [])
+        .option('--remove <bundle-id>', 'Bundle ID to remove (repeatable)', collect, [])
+        .action(async (projectArg, opts) => {
+        const writer = getWriter();
+        const client = requireClient();
+        const additions = validateBundleIds(opts.add);
+        const removals = validateBundleIds(opts.remove);
+        if (additions.length === 0 && removals.length === 0) {
+            throw errUsage('Pass at least one --add or --remove bundle ID', 'Example: feedbackbasket mobile bundle-ids myapp --add com.example.app');
+        }
+        const overlap = additions.filter((bundleId) => removals.includes(bundleId));
+        if (overlap.length > 0) {
+            throw errUsage(`The same bundle ID cannot be added and removed: ${overlap.join(', ')}`);
+        }
+        const projectId = await resolveProjectId(client, projectArg);
+        const result = await client.updateMobileIntegration(projectId, {
+            addBundleIds: additions,
+            removeBundleIds: removals,
+        });
+        if (!writer.isMachineOutput()) {
+            console.log(`  ${brand.success('✓')} Allowed bundle IDs updated for ${brand.bold(result.project.name)}`);
+            console.log();
+        }
+        writer.ok(result, {
+            summary: `Updated mobile bundle IDs for "${result.project.name}"`,
+            breadcrumbs: [
+                { action: 'View mobile status', cmd: `feedbackbasket mobile status ${projectRef(projectArg, projectId)}` },
+            ],
+        });
+    });
+    mobile
+        .command('conversations [project]')
+        .description('Enable or disable in-app follow-up replies')
+        .option('--enable', 'Let users continue feedback conversations in the app')
+        .option('--disable', 'Keep in-app team replies read-only')
+        .action(async (projectArg, opts) => {
+        if (Boolean(opts.enable) === Boolean(opts.disable)) {
+            throw errUsage('Choose either --enable or --disable');
+        }
+        const writer = getWriter();
+        const client = requireClient();
+        const projectId = await resolveProjectId(client, projectArg);
+        const allowVisitorReplies = Boolean(opts.enable);
+        const result = await client.updateMobileIntegration(projectId, { allowVisitorReplies });
+        if (!writer.isMachineOutput()) {
+            console.log(`  ${brand.success('✓')} In-app conversations ${allowVisitorReplies ? 'enabled' : 'disabled'} for ${brand.bold(result.project.name)}`);
+            console.log();
+        }
+        writer.ok(result, {
+            summary: `${allowVisitorReplies ? 'Enabled' : 'Disabled'} in-app follow-up replies for "${result.project.name}"`,
+            breadcrumbs: [
+                { action: 'View mobile status', cmd: `feedbackbasket mobile status ${projectRef(projectArg, projectId)}` },
+            ],
+        });
+    });
+    mobile
+        .command('verify [project]')
+        .description('Verify that the SDK has connected from the expected app')
+        .option('--bundle-id <bundle-id>', 'Expected bundle ID')
+        .option('--wait <seconds>', 'Wait for the first matching heartbeat (maximum 300 seconds)', '0')
+        .action(async (projectArg, opts) => {
+        const writer = getWriter();
+        const client = requireClient();
+        const projectId = await resolveProjectId(client, projectArg);
+        const expectedBundleId = opts.bundleId
+            ? validateBundleIds([opts.bundleId])[0]
+            : undefined;
+        const waitSeconds = parseWaitSeconds(opts.wait);
+        const deadline = Date.now() + waitSeconds * 1_000;
+        let result = await client.getMobileIntegration(projectId);
+        while (!isMobileConnectionVerified(result, expectedBundleId) && Date.now() < deadline) {
+            await sleep(Math.min(VERIFY_POLL_INTERVAL_MS, deadline - Date.now()));
+            result = await client.getMobileIntegration(projectId);
+        }
+        const verified = isMobileConnectionVerified(result, expectedBundleId);
+        const verification = {
+            verified,
+            expectedBundleId: expectedBundleId ?? null,
+            project: result.project,
+            integration: result.integration,
+        };
+        if (!writer.isMachineOutput())
+            renderVerification(verification);
+        writer.ok(verification, {
+            summary: verified
+                ? `Verified mobile connection for "${result.project.name}"`
+                : `Mobile connection not yet verified for "${result.project.name}"`,
+            notice: verified
+                ? undefined
+                : 'Build and launch the app, then run this command again with --wait 120.',
+        });
+        if (!verified)
+            process.exitCode = 2;
+    });
+    mobile
+        .command('disable [project]')
+        .description('Disable mobile feedback without changing the website widget')
+        .option('--yes', 'Confirm disabling mobile feedback')
+        .action(async (projectArg, opts) => {
+        const writer = getWriter();
+        const client = requireClient();
+        const projectId = await resolveProjectId(client, projectArg);
+        await requireDestructiveConfirmation(writer, Boolean(opts.yes), 'Disable mobile feedback? Installed apps will stop submitting feedback.', '--yes is required to disable mobile feedback in agent mode');
+        const result = await client.updateMobileIntegration(projectId, { enabled: false });
+        if (!writer.isMachineOutput()) {
+            console.log(`  ${brand.success('✓')} Mobile feedback disabled for ${brand.bold(result.project.name)}`);
+            console.log();
+        }
+        writer.ok(result, {
+            summary: `Disabled mobile feedback for "${result.project.name}"`,
+            breadcrumbs: [
+                { action: 'Re-enable mobile feedback', cmd: `feedbackbasket mobile setup ${projectRef(projectArg, projectId)}` },
+            ],
+        });
+    });
+    mobile
+        .command('rotate-key [project]')
+        .description('Rotate the publishable mobile key (existing app builds will stop working)')
+        .option('--yes', 'Confirm key rotation')
+        .option('--include-publishable-key', 'Include the newly generated publishable key')
+        .action(async (projectArg, opts) => {
+        const writer = getWriter();
+        const client = requireClient();
+        const projectId = await resolveProjectId(client, projectArg);
+        await requireDestructiveConfirmation(writer, Boolean(opts.yes), 'Rotate the mobile project key? Existing app builds will stop submitting feedback.', '--yes is required to rotate a mobile project key in agent mode');
+        const result = await client.rotateMobileProjectKey(projectId, Boolean(opts.includePublishableKey));
+        if (!writer.isMachineOutput()) {
+            console.log(`  ${brand.warning('!')} Mobile project key rotated for ${brand.bold(result.project.name)}`);
+            console.log('  Update and release every installed app that used the previous key.');
+            console.log();
+        }
+        writer.ok(result, {
+            summary: `Rotated mobile project key for "${result.project.name}"`,
+            notice: 'Existing app builds using the previous key can no longer submit feedback.',
+        });
+    });
+    return mobile;
+}
+function requireClient() {
+    const manager = new AuthManager();
+    const token = manager.resolveToken();
+    if (!token)
+        throw errAuth();
+    return new FeedbackBasketClient(token, loadConfig().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 mobile status <project>');
+}
+function collect(value, previous) {
+    return [...previous, value];
+}
+export function projectRef(projectArg, projectId) {
+    const ref = projectArg?.trim();
+    if (!ref || !SAFE_PROJECT_REF_PATTERN.test(ref))
+        return projectId;
+    return ref.includes(' ') ? `"${ref}"` : ref;
+}
+export function validateBundleIds(bundleIds) {
+    const normalized = Array.from(new Set(bundleIds.map((value) => value.trim()).filter(Boolean)));
+    const invalid = normalized.find((bundleId) => !BUNDLE_ID_PATTERN.test(bundleId));
+    if (invalid) {
+        throw errUsage(`Invalid bundle ID "${invalid}"`, 'Bundle IDs must look like com.example.app');
+    }
+    if (normalized.length > 20)
+        throw errUsage('A project can have at most 20 bundle IDs');
+    return normalized;
+}
+export function isMobileConnectionVerified(result, expectedBundleId) {
+    const integration = result.integration;
+    if (!integration?.enabled || !integration.connection.connected)
+        return false;
+    return !expectedBundleId || integration.connection.bundleId === expectedBundleId;
+}
+function parseWaitSeconds(value) {
+    const seconds = Number(value);
+    if (!Number.isInteger(seconds) || seconds < 0 || seconds > MAX_VERIFY_WAIT_SECONDS) {
+        throw errUsage(`--wait must be a whole number between 0 and ${MAX_VERIFY_WAIT_SECONDS}`);
+    }
+    return seconds;
+}
+function sleep(milliseconds) {
+    return new Promise((resolve) => setTimeout(resolve, Math.max(0, milliseconds)));
+}
+async function requireDestructiveConfirmation(writer, confirmedByFlag, question, agentHint) {
+    if (confirmedByFlag)
+        return;
+    if (writer.isMachineOutput() || !process.stdin.isTTY) {
+        throw errUsage(agentHint);
+    }
+    if (!(await confirm(`  ${question}`, false))) {
+        throw errUsage('Action cancelled');
+    }
+}
+function withSetupGuidance(result) {
+    return {
+        ...result,
+        setup: {
+            publishableKeyIncluded: result.integration?.publishableKeyIncluded ?? false,
+            supportedIntegrations: ['swiftui', 'uikit', 'react-native', 'flutter', 'hosted-form'],
+            nextSteps: result.integration?.publishableKeyIncluded
+                ? [
+                    'Detect the mobile framework and minimum supported platform version.',
+                    'Configure the app with the returned publishable mobile project key.',
+                    'Add an accessible Send feedback action to an existing Settings, Help, or Support screen.',
+                    'Build and launch the app, then verify its SDK heartbeat.',
+                ]
+                : [
+                    'Re-run setup with --include-publishable-key when you are ready to configure the app.',
+                ],
+        },
+    };
+}
+function renderMobileStatus(result) {
+    console.log(brand.bold(`Mobile feedback — ${result.project.name}`));
+    console.log(divider(54));
+    if (!result.integration) {
+        console.log(brand.muted('  Mobile feedback is not enabled.'));
+        console.log();
+        return;
+    }
+    const integration = result.integration;
+    console.log(`  ${brand.label('Status'.padEnd(18))} ${integration.enabled ? 'Enabled' : 'Disabled'}`);
+    console.log(`  ${brand.label('Conversations'.padEnd(18))} ${integration.allowVisitorReplies ? 'Enabled' : 'Read-only'}`);
+    console.log(`  ${brand.label('Publishable key'.padEnd(18))} ${integration.publishableKey}`);
+    console.log(`  ${brand.label('Bundle IDs'.padEnd(18))} ${integration.bundleIds.join(', ') || 'Any bundle ID'}`);
+    console.log(`  ${brand.label('Connection'.padEnd(18))} ${integration.connection.connected ? 'Connected' : 'Waiting for first heartbeat'}`);
+    if (integration.connection.lastSeenAt) {
+        console.log(`  ${brand.label('Last seen'.padEnd(18))} ${integration.connection.lastSeenAt}`);
+    }
+    if (integration.connection.bundleId) {
+        console.log(`  ${brand.label('Last bundle'.padEnd(18))} ${integration.connection.bundleId}`);
+    }
+    console.log();
+}
+function renderVerification(result) {
+    const icon = result.verified ? brand.success('✓') : brand.warning('!');
+    console.log(`  ${icon} ${result.verified ? 'Mobile SDK connection verified' : 'Mobile SDK connection not yet verified'}`);
+    if (result.expectedBundleId)
+        console.log(`  ${brand.muted(`Expected bundle: ${result.expectedBundleId}`)}`);
+    if (result.integration?.connection.lastSeenAt) {
+        console.log(`  ${brand.muted(`Last heartbeat: ${result.integration.connection.lastSeenAt}`)}`);
+    }
+    console.log();
+}

package/dist/src/commands/widget.js

@@ -72,6 +72,8 @@ export function createWidgetCommand(getWriter) {
         .option('--no-hide-email-when-prefilled', 'Show the email field even when userEmail is prefilled')
         .option('--allow-attachments', 'Allow image attachments')
         .option('--no-allow-attachments', 'Disable image attachments')
+        .option('--allow-visitor-replies', 'Let visitors continue feedback conversations')
+        .option('--no-allow-visitor-replies', 'Keep widget replies read-only for visitors')
         .option('--icon-only', 'Show only the icon, no label')
         .option('--no-icon-only', 'Show both icon and label')
         .option('--show-icon', 'Show an icon next to the label')
@@ -94,7 +96,7 @@ export function createWidgetCommand(getWriter) {
             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.allowAttachments !== undefined || opts.allowVisitorReplies !== undefined || opts.iconOnly !== undefined ||
             opts.showIcon !== undefined || opts.showBranding !== undefined ||
             opts.allowConsoleErrors !== undefined || opts.errorTracking !== undefined ||
             opts.zIndex || opts.guided || opts.disableGuided;
@@ -139,6 +141,8 @@ export function createWidgetCommand(getWriter) {
                 settings.hideEmailFieldWhenPrefilled = opts.hideEmailWhenPrefilled;
             if (opts.allowAttachments !== undefined)
                 settings.allowAttachments = opts.allowAttachments;
+            if (opts.allowVisitorReplies !== undefined)
+                settings.allowVisitorReplies = opts.allowVisitorReplies;
             if (opts.iconOnly !== undefined)
                 settings.iconOnly = opts.iconOnly;
             if (opts.showIcon !== undefined)
@@ -434,6 +438,7 @@ function renderWidgetSettings(projectName, settings) {
         ['Email Read Only', String(settings.emailReadOnly ?? false)],
         ['Hide Prefilled Email', String(settings.hideEmailFieldWhenPrefilled ?? false)],
         ['Attachments', String(settings.allowAttachments ?? true)],
+        ['Follow-up Replies', String(settings.allowVisitorReplies ?? false)],
         ['Guided Flow', String(settings.feedbackFlow?.enabled ?? false)],
         ['Intro Message', String(settings.introMessage ?? '')],
         ['Success Message', String(settings.successMessage ?? '')],

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, waitlists, widgets, and team from your terminal.')}`);
+    lines.push(`  ${brand.muted('Manage projects, feedback, mobile apps, waitlists, widgets, and team from your terminal.')}`);
     lines.push('');
     // Core Commands
     lines.push(section('  CORE COMMANDS'));
@@ -26,6 +26,7 @@ export function renderRootHelp() {
     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('mobile', 'Set up and verify mobile app feedback'));
     lines.push(cmd('team', 'Manage organization members'));
     lines.push('');
     // Shortcuts
@@ -66,6 +67,8 @@ export function renderRootHelp() {
     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 mobile setup myapp --bundle-id com.example.app`);
+    lines.push(`${INDENT}${brand.muted('$')} feedbackbasket mobile verify myapp --bundle-id com.example.app --wait 120`);
     lines.push(`${INDENT}${brand.muted('$')} feedbackbasket projects create "My App" --url https://myapp.com`);
     lines.push('');
     // Learn More