@swell/cli 2.6.0 → 2.7.0

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/functions.d.ts

@@ -0,0 +1,48 @@
+import { InspectResourceCommand } from '../../inspect-resource-command.js';
+interface FunctionRecord {
+    id?: string;
+    name?: string;
+    enabled?: boolean;
+    cron?: {
+        schedule?: string;
+    };
+    route?: {
+        headers?: string[];
+        methods?: string[];
+        public?: boolean;
+    };
+    model?: {
+        events?: string[];
+    };
+    date_cron_scheduled?: string;
+    date_final_attempt?: string;
+    app_id?: string;
+}
+export default class Functions extends InspectResourceCommand {
+    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[];
+    protected resourceLabel: string;
+    protected resourceLabelSingular: string;
+    protected adminPath: string;
+    protected commandName: string;
+    run(): Promise<void>;
+    protected metaFor(r: FunctionRecord): string | undefined;
+    /**
+     * Model-triggered functions emit `/events:webhooks` rows on each invocation.
+     * Route and cron functions do not — pointing the agent at an empty query
+     * would teach them their function isn't running. The logs hint always
+     * applies as long as we have a function name.
+     */
+    protected hints(record: FunctionRecord): string[];
+}
+export {};

package/dist/commands/inspect/functions.js

@@ -0,0 +1,83 @@
+import { InspectResourceCommand, inspectResourceBaseArgs, inspectResourceBaseFlags, } from '../../inspect-resource-command.js';
+function deriveTrigger(r) {
+    if (r.cron?.schedule) {
+        return `cron (${r.cron.schedule})`;
+    }
+    if (r.model?.events?.length) {
+        const n = r.model.events.length;
+        return `model (${n} event${n === 1 ? '' : 's'})`;
+    }
+    if (r.route) {
+        const { methods } = r.route;
+        if (!methods?.length)
+            return 'route';
+        return methods.length <= 2
+            ? `route (${methods.join(',')})`
+            : `route (${methods.length} methods)`;
+    }
+    return undefined;
+}
+export default class Functions extends InspectResourceCommand {
+    static summary = 'Functions with scheduling and trigger state.';
+    static description = `Lists functions across all apps, grouped by app. Pass --app=<slug> or --app=. (current swell.json) to scope.
+
+List output: paste-back key + status (disabled, trigger, next cron run, last failure).
+
+Pass an identifier to view a single record as JSON.
+
+Identifier forms:
+  app.<app>.<name>     — full paste-back key (list column 1)
+  <name>               — requires --app= scope
+  <24-char id>         — any scope
+`;
+    static args = { ...inspectResourceBaseArgs };
+    static flags = { ...inspectResourceBaseFlags };
+    static examples = [
+        'swell inspect functions',
+        'swell inspect functions --app=my-app',
+        'swell inspect functions app.my-app.payment-sync',
+        'swell inspect functions payment-sync --app=my-app',
+        'swell inspect functions --live',
+    ];
+    resourceLabel = 'Functions';
+    resourceLabelSingular = 'function';
+    adminPath = '/data/:functions';
+    commandName = 'functions';
+    async run() {
+        const { args, flags } = await this.parse(Functions);
+        await this.runInspect({ args, flags });
+    }
+    metaFor(r) {
+        const parts = [];
+        if (!r.enabled) {
+            parts.push('disabled');
+        }
+        const trigger = deriveTrigger(r);
+        if (trigger) {
+            parts.push(trigger);
+        }
+        if (r.date_cron_scheduled) {
+            parts.push(`next ${r.date_cron_scheduled}`);
+        }
+        if (r.date_final_attempt) {
+            parts.push(`last fail ${r.date_final_attempt}`);
+        }
+        return parts.length > 0 ? parts.join(' · ') : undefined;
+    }
+    /**
+     * Model-triggered functions emit `/events:webhooks` rows on each invocation.
+     * Route and cron functions do not — pointing the agent at an empty query
+     * would teach them their function isn't running. The logs hint always
+     * applies as long as we have a function name.
+     */
+    hints(record) {
+        const lines = [];
+        if (record.model?.events?.length && record.id) {
+            lines.push(`swell api get '/events:webhooks?where[function_id]=${record.id}&limit=10'`);
+        }
+        if (record.name) {
+            lines.push(`swell logs --type function -s '${record.name}'`);
+        }
+        return lines;
+    }
+}

package/dist/commands/inspect/index.js

@@ -1,16 +1,17 @@
 import { Command } from '@oclif/core';
 export default class Inspect extends Command {
     static summary = 'Inspect deployed artifacts in your store.';
-    static description = `View configuration and data for deployed resources.
-
-Inspect models, content views, and other deployed artifacts in your Swell store.`;
+    static description = `Subcommands list globally and group by app. Pass --app=<slug> or --app=. (current swell.json) to scope. Pass an identifier to print the full record as JSON, followed by a "Next steps" footer of related commands. Use --json to omit the footer for piping.
+`;
     static examples = [
-        'swell inspect models',
         'swell inspect models /products',
-        'swell inspect models /apps/myapp/orders',
+        'swell inspect content app.honest_reviews.reviews',
+        'swell inspect webhooks --app=my-app',
+        'swell inspect functions app.my-app.payment-sync',
+        'swell inspect notifications com.orders.receipt.v2',
+        'swell inspect settings app.my-app',
     ];
     async run() {
-        this.log('Use "swell inspect models" to inspect deployed artifacts.');
-        this.log('Run "swell inspect --help" for more information.');
+        this.log('Run "swell inspect --help" to see available subcommands.');
     }
 }

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

@@ -6,7 +6,9 @@ export default class Models extends SwellCommand {
         'collection-path': 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[];
@@ -17,10 +19,23 @@ export default class Models extends SwellCommand {
     private showAppModels;
     private showModels;
     private getModelPath;
-    private getAppSlugId;
     private showModelDetail;
     private resolveModelPath;
     private resolveAppModelPath;
     private throwModelNotFound;
-    private showModel;
+    private emitModel;
+    /**
+     * Detail-mode hints for a model record. Mirrors `InspectResourceCommand.hints`
+     * but lives here because `models` doesn't extend that base.
+     *
+     * Two hints: the records collection at the model's runtime address, and the
+     * mutation event stream filtered by canonical model string. Both interpolate
+     * from the record's own fields — `app_id`, `namespace`, `name` — so we stay
+     * consistent with column 1 if the platform renames anything.
+     *
+     * Canonical model string: `accounts` (system), `content/blogs` (namespaced
+     * system), `apps/<hex>/<col>` (app). The records path mirrors that with a
+     * leading slash.
+     */
+    private modelHints;
 }