@swell/cli 2.6.0 → 2.7.1

package/dist/commands/app/frontend/dev.js

@@ -182,6 +182,24 @@ export default class AppFrontendDev extends PushAppCommand {
                     }
                     break;
                 }
+                case 'react':
+                case 'react-storefront': {
+                    // Vite emits the Local URL as its ready signal — no separate
+                    // detector needed.
+                    if (/➜\s+local:\s+http:\/\//i.test(string) ||
+                        /➜\s+network:/i.test(string)) {
+                        if (!serverReadyDetected) {
+                            serverReadyDetected = true;
+                            this.log(`Started ${projectType.name} dev server on port ${serverPort}.\n`);
+                            setTimeout(() => this.logLocalPreviewUrl(), 100);
+                            if (!isAppDev) {
+                                this.watchForChanges();
+                            }
+                        }
+                        return false;
+                    }
+                    break;
+                }
                 case 'nuxt': {
                     // 2. URL FILTER: Hide localhost/network URLs (confusing - users should use Swell tunnel)
                     if (/➜ local:\s+http:\/\//i.test(string) ||

package/dist/commands/inspect/content.d.ts

@@ -1,25 +1,36 @@
-import { SwellCommand } from '../../swell-command.js';
-export default class Content extends SwellCommand {
+import { InspectResourceCommand, InspectResourceCommandParsed } from '../../inspect-resource-command.js';
+import { InspectScope } from '../../lib/apps/inspect-scope.js';
+import { GroupInfo } from '../../lib/inspect/table.js';
+interface ContentView {
+    id: string;
+    name: string;
+    app_id?: string;
+    collection?: string;
+    fields?: any[];
+    source_id?: string;
+    source_type?: string;
+    views?: any[];
+}
+export default class Content extends InspectResourceCommand {
     static summary: string;
     static description: string;
     static args: {
-        'content-id': import("@oclif/core/lib/interfaces/parser.js").Arg<string | undefined, Record<string, unknown>>;
+        identifier: import("@oclif/core/lib/interfaces/parser.js").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
+        app: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
         live: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        json: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
         yes: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
     };
     static examples: string[];
+    protected resourceLabel: string;
+    protected resourceLabelSingular: string;
+    protected adminPath: string;
+    protected commandName: string;
     run(): Promise<void>;
-    protected catch(error: Error): Promise<any>;
-    private listContent;
-    private showContentViews;
-    private showContentView;
-    private resolveContentId;
-    private showContentDetail;
-    private reverseResolveContentId;
-    private getAppBySlug;
-    private getAppSlugId;
-    private throwContentNotFound;
-    private showContent;
+    protected keyFor(record: ContentView, appSlugById: Record<string, string>): string;
+    protected groupForRecord(record: ContentView, appSlugById: Record<string, string>): GroupInfo;
+    protected showDetail(identifier: string, scope: InspectScope, flags: InspectResourceCommandParsed['flags']): Promise<void>;
 }
+export {};

package/dist/commands/inspect/content.js

@@ -1,159 +1,49 @@
-import { Args, Flags } from '@oclif/core';
-import { FetchError } from 'node-fetch';
-import { default as localConfig } from '../../lib/config.js';
-import { SwellCommand } from '../../swell-command.js';
-export default class Content extends SwellCommand {
-    static summary = 'Inspect content view extensions deployed in your store.';
-    static description = `
-View content view extensions available in your Swell store.
+import { InspectResourceCommand, inspectResourceBaseArgs, inspectResourceBaseFlags, } from '../../inspect-resource-command.js';
+import { resolveAppId } from '../../lib/apps/resolve.js';
+import { groupContentRecord, resolveContentKey, reverseResolveContentId, } from '../../lib/inspect/content.js';
+export default class Content extends InspectResourceCommand {
+    static summary = 'App and platform content views.';
+    static description = `Lists content view extensions across all apps plus platform 'custom' sources, grouped by owner. Pass --app=<slug> or --app=. (current swell.json) to scope.
 
-Without a content ID, this command lists all available content views.
-With a content ID, it retrieves the configuration for that specific content view in JSON format.
+Pass an identifier to view a single record as JSON.
+
+Identifier forms:
+  app.<app>.<name>         — app-owned view (list column 1)
+  custom.<source>.<name>   — platform custom view (e.g. custom.admin.products)
+  <name>                   — requires --app= scope
 `;
-    static args = {
-        'content-id': Args.string({
-            description: 'Optional content view ID. Example: custom.admin.products, app.myapp.products',
-            required: false,
-        }),
-    };
-    static flags = {
-        live: Flags.boolean({
-            description: 'Use the live environment instead of test (default: test).',
-            default: false,
-        }),
-        yes: Flags.boolean({
-            char: 'y',
-            description: 'Accept all prompts automatically (for agent compatibility; no functional effect).',
-            default: false,
-        }),
-    };
+    static args = { ...inspectResourceBaseArgs };
+    static flags = { ...inspectResourceBaseFlags };
     static examples = [
         'swell inspect content',
-        'swell inspect content custom.admin.products',
+        'swell inspect content --app=my-app',
         'swell inspect content app.honest_reviews.reviews',
-        'swell inspect content app.myapp.products --live',
+        'swell inspect content custom.admin.products',
+        'swell inspect content reviews --app=honest_reviews',
+        'swell inspect content --live',
     ];
+    resourceLabel = 'Content views';
+    resourceLabelSingular = 'content view';
+    adminPath = '/data/:content';
+    commandName = 'content';
     async run() {
         const { args, flags } = await this.parse(Content);
-        const { 'content-id': contentId } = args;
-        const { live } = flags;
-        if (!live) {
-            await this.api.setEnv('test');
-        }
-        // Detail mode: show configuration for a specific content view
-        if (contentId) {
-            await this.showContentDetail(contentId);
-            return;
-        }
-        const store = localConfig.getDefaultStore();
-        // List mode: show all content views
-        await this.listContent(store, live);
-    }
-    async catch(error) {
-        if (error instanceof FetchError) {
-            const message = `Could not connect to Swell API. Please try again later: ${error.message}`;
-            return this.error(message, { exit: 2, code: error.code });
-        }
-        return this.error(error.message, { exit: 1 });
-    }
-    async listContent(store, live) {
-        const { results: apps } = await this.api.get({
-            adminPath: '/apps',
-        });
-        const appsById = Object.fromEntries(apps.map((app) => [app.id, app]));
-        const { results: contentViews } = await this.api.getAll({
-            adminPath: '/data/:content',
-        });
-        // Sort by resolved ID in reverse order (custom.* first)
-        const sortedContentViews = [...contentViews].sort((a, b) => {
-            const resolvedA = this.resolveContentId(a, appsById);
-            const resolvedB = this.resolveContentId(b, appsById);
-            return resolvedB.localeCompare(resolvedA);
-        });
-        this.log(`Content views extensions available in '${store}' ${live ? '[live]' : '[test]'}:`);
-        this.log();
-        this.showContentViews(sortedContentViews, appsById);
-        // Show next step hints
-        this.log();
-        this.log('Examples:');
-        this.log('  swell inspect content custom.admin.products');
-        this.log('  swell inspect content app.honest_reviews.accounts');
-    }
-    showContentViews(contentViews, appsById) {
-        const maxNameWidth = Math.max(...contentViews.map((cv) => cv.name.length), 15);
-        for (const cv of contentViews) {
-            this.showContentView(cv, maxNameWidth, appsById);
-        }
+        await this.runInspect({ args, flags });
     }
-    showContentView(contentView, nameWidth, appsById) {
-        const resolvedId = this.resolveContentId(contentView, appsById);
-        const paddedName = contentView.name.padEnd(nameWidth + 2);
-        this.log(`${paddedName}${resolvedId}`);
+    keyFor(record, appSlugById) {
+        return resolveContentKey(record.id, appSlugById);
     }
-    resolveContentId(contentView, appsById) {
-        const { id, name } = contentView;
-        // Parse ID: app.{appId}.{name} or custom.{source}.{name}
-        const match = id.match(/^(app|custom)\.([^.]+)\.(.+)$/);
-        if (!match)
-            return id; // fallback to original
-        const [, type, identifier] = match;
-        if (type === 'custom') {
-            return id; // custom IDs are already resolved
-        }
-        // type === 'app': resolve app ID to slug
-        const appId = identifier;
-        const app = appsById[appId];
-        if (!app) {
-            return id; // fallback if app not found
-        }
-        const appSlug = this.getAppSlugId(app);
-        return `app.${appSlug}.${name}`;
+    groupForRecord(record, appSlugById) {
+        return groupContentRecord(record, appSlugById);
     }
-    async showContentDetail(resolvedId) {
-        // Reverse resolve to get unresolved ID for API
-        const unresolvedId = await this.reverseResolveContentId(resolvedId);
-        // Fetch content view
-        const content = await this.api.get({
-            adminPath: `/data/:content/${unresolvedId}`,
+    async showDetail(identifier, scope, flags) {
+        const unresolved = await reverseResolveContentId(identifier, scope, (slug) => resolveAppId(this.api, slug));
+        const record = await this.api.get({
+            adminPath: `${this.adminPath}/${unresolved}`,
         });
-        if (!content) {
-            this.throwContentNotFound(resolvedId);
-        }
-        this.showContent(content);
-    }
-    async reverseResolveContentId(resolvedId) {
-        // Parse ID: app.{slug}.{name} or custom.{source}.{name}
-        const match = resolvedId.match(/^(app|custom)\.([^.]+)\.(.+)$/);
-        if (!match) {
-            throw new Error(`Invalid content ID format: ${resolvedId}`);
-        }
-        const [, type, identifier, name] = match;
-        if (type === 'custom') {
-            return resolvedId; // custom IDs don't need reverse resolution
+        if (!record) {
+            this.throwNotFound(identifier);
         }
-        // Check if identifier is already an app ID (ObjectID format)
-        if (/^[\da-f]{24}$/.test(identifier)) {
-            return resolvedId; // already unresolved format
-        }
-        // type === 'app': resolve slug to app ID
-        const appSlug = identifier;
-        const app = await this.getAppBySlug(appSlug);
-        return `app.${app.id}.${name}`;
-    }
-    async getAppBySlug(slug) {
-        const app = await this.api.get({ adminPath: `/apps/${slug}` });
-        if (!app) {
-            throw new Error(`App '${slug}' not found.\nList available content: swell inspect content`);
-        }
-        return app;
-    }
-    getAppSlugId(app) {
-        return app.public_id || app.private_id.replace(/^_/, '');
-    }
-    throwContentNotFound(id) {
-        throw new Error(`No content view found for '${id}'.\nList available content: swell inspect content`);
-    }
-    showContent(content) {
-        this.log(JSON.stringify(content, null, 2));
+        this.emitDetail(record, flags);
     }
 }

package/dist/commands/inspect/extensions.d.ts

@@ -0,0 +1,49 @@
+import { SwellCommand } from '../../swell-command.js';
+export default class Extensions extends SwellCommand {
+    static summary: string;
+    static description: string;
+    static args: {
+        identifier: import("@oclif/core/lib/interfaces/parser.js").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        app: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        live: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        json: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        yes: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    static examples: string[];
+    run(): Promise<void>;
+    protected catch(error: Error): Promise<any>;
+    /**
+     * List mode is bounded to two parallel round-trip phases regardless of app
+     * count: phase 1 fans `/client/apps`, the three settings singletons, and a
+     * single `/data/:functions` filter; phase 2 fans `/apps/<id>/configs?type=component`
+     * only for apps with a non-empty `extensions[]`.
+     *
+     * `include` / `aggregate` are NOT used here — the CLI's `node-fetch`
+     * transport cannot transmit GET-with-body, and URL-form transmission of
+     * those payloads is silently dropped server-side. Verified empirically
+     * against the live admin API. Don't reach for those primitives.
+     */
+    private showList;
+    /**
+     * Detail mode is bounded to one round-trip's worth of latency: the install
+     * record (or `/apps/<id>` fallback), the relevant settings singleton(s),
+     * `/data/:functions?where[app_id]=<id>&where[extension]=<extId>`, and
+     * `/apps/<id>/configs?type=component` — all in parallel.
+     */
+    private showDetail;
+    /**
+     * `extensions` emits a synthesized envelope rather than a raw API record —
+     * other inspect subcommands print one upstream record, but here the JSON
+     * nests `manifest`, `native_bindings[].record`, `bound.functions[]`, and
+     * `bound.components[]` under shared status fields.
+     *
+     * The `Next steps:` footer mixes runnable shell commands and merchant-UI
+     * lines (prefixed `(merchant)`). The structured `action` and `action_owner`
+     * fields above give an agent a parseable signal independent of the footer.
+     */
+    private emitDetail;
+    private fetchSafe;
+    private printPreamble;
+}