@salesforce/b2c-cli 0.0.0-nightly.20260119053920

package/dist/commands/scapi/schemas/get.js

@@ -0,0 +1,317 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { Args, Flags } from '@oclif/core';
+import { collapseOpenApiSchema, getPathKeys, getSchemaNames, getExampleNames, } from '@salesforce/b2c-tooling-sdk/operations/scapi-schemas';
+import { ScapiSchemasCommand, formatApiError } from '../../../utils/scapi/schemas.js';
+import { t } from '../../../i18n/index.js';
+/**
+ * Command to get a specific SCAPI schema.
+ *
+ * By default, outputs collapsed schema for context efficiency (ideal for agentic use).
+ * Use --expand-* flags to selectively expand specific paths, schemas, or examples.
+ * Use --expand-all to get the full, unmodified schema.
+ */
+export default class ScapiSchemasGet extends ScapiSchemasCommand {
+    static args = {
+        apiFamily: Args.string({
+            description: t('args.apiFamily.description', 'API family (e.g., shopper, admin)'),
+            required: true,
+        }),
+        apiName: Args.string({
+            description: t('args.apiName.description', 'API name (e.g., products, orders)'),
+            required: true,
+        }),
+        apiVersion: Args.string({
+            description: t('args.apiVersion.description', 'API version (e.g., v1)'),
+            required: true,
+        }),
+    };
+    static description = t('commands.scapi.schemas.get.description', 'Get a specific SCAPI schema with optional selective expansion');
+    static enableJsonFlag = true;
+    static examples = [
+        // Basic usage
+        '<%= config.bin %> <%= command.id %> shopper products v1 --tenant-id f_ecom_zzxy_prd',
+        // Full schema
+        '<%= config.bin %> <%= command.id %> shopper products v1 --tenant-id f_ecom_zzxy_prd --expand-all',
+        // Selective expansion
+        '<%= config.bin %> <%= command.id %> shopper products v1 --tenant-id f_ecom_zzxy_prd --expand-paths /products',
+        '<%= config.bin %> <%= command.id %> shopper products v1 --tenant-id f_ecom_zzxy_prd --expand-schemas Product,SearchResult',
+        // List available paths/schemas
+        '<%= config.bin %> <%= command.id %> shopper products v1 --tenant-id f_ecom_zzxy_prd --list-paths',
+        '<%= config.bin %> <%= command.id %> shopper products v1 --tenant-id f_ecom_zzxy_prd --list-schemas',
+        // YAML output
+        '<%= config.bin %> <%= command.id %> shopper products v1 --tenant-id f_ecom_zzxy_prd --yaml',
+        // JSON wrapped output
+        '<%= config.bin %> <%= command.id %> shopper products v1 --tenant-id f_ecom_zzxy_prd --json',
+    ];
+    static flags = {
+        ...ScapiSchemasCommand.baseFlags,
+        // Selective expansion flags
+        'expand-paths': Flags.string({
+            description: t('flags.expandPaths.description', 'Paths to fully expand (comma-separated, e.g., /products,/orders)'),
+            multiple: false,
+        }),
+        'expand-schemas': Flags.string({
+            description: t('flags.expandSchemas.description', 'Schema names to fully expand (comma-separated)'),
+            multiple: false,
+        }),
+        'expand-examples': Flags.string({
+            description: t('flags.expandExamples.description', 'Example names to fully expand (comma-separated)'),
+            multiple: false,
+        }),
+        'expand-custom-properties': Flags.boolean({
+            description: t('flags.expandCustomProperties.description', 'Expand custom properties'),
+            default: true,
+            allowNo: true,
+        }),
+        'expand-all': Flags.boolean({
+            description: t('flags.expandAll.description', 'Return full schema without collapsing (overrides selective expand)'),
+            default: false,
+        }),
+        // List available items flags
+        'list-paths': Flags.boolean({
+            description: t('flags.listPaths.description', 'List available paths in the schema and exit'),
+            default: false,
+            exclusive: ['list-schemas', 'list-examples'],
+        }),
+        'list-schemas': Flags.boolean({
+            description: t('flags.listSchemas.description', 'List available schema names and exit'),
+            default: false,
+            exclusive: ['list-paths', 'list-examples'],
+        }),
+        'list-examples': Flags.boolean({
+            description: t('flags.listExamples.description', 'List available example names and exit'),
+            default: false,
+            exclusive: ['list-paths', 'list-schemas'],
+        }),
+        // Output format flags
+        yaml: Flags.boolean({
+            description: t('flags.yaml.description', 'Output as YAML instead of JSON'),
+            default: false,
+        }),
+    };
+    async run() {
+        this.requireOAuthCredentials();
+        const { apiFamily, apiName, apiVersion } = this.args;
+        const { 'expand-paths': expandPathsRaw, 'expand-schemas': expandSchemasRaw, 'expand-examples': expandExamplesRaw, 'expand-custom-properties': expandCustomProperties, 'expand-all': expandAll, 'list-paths': listPaths, 'list-schemas': listSchemas, 'list-examples': listExamples, yaml: outputYaml, } = this.flags;
+        // Parse comma-separated values
+        const expandPaths = expandPathsRaw ? expandPathsRaw.split(',').map((p) => p.trim()) : [];
+        const expandSchemas = expandSchemasRaw ? expandSchemasRaw.split(',').map((s) => s.trim()) : [];
+        const expandExamples = expandExamplesRaw ? expandExamplesRaw.split(',').map((e) => e.trim()) : [];
+        if (!this.jsonEnabled()) {
+            // Build expansion info for the log message
+            const expansionInfo = this.getExpansionInfo(expandAll, expandPaths, expandSchemas, expandExamples);
+            this.log(t('commands.scapi.schemas.get.fetching', 'Fetching {{apiFamily}}/{{apiName}}/{{apiVersion}} schema{{expansionInfo}}...', {
+                apiFamily,
+                apiName,
+                apiVersion,
+                expansionInfo,
+            }));
+        }
+        const client = this.getSchemasClient();
+        const { data, error } = await client.GET('/organizations/{organizationId}/schemas/{apiFamily}/{apiName}/{apiVersion}', {
+            params: {
+                path: {
+                    organizationId: this.getOrganizationId(),
+                    apiFamily,
+                    apiName,
+                    apiVersion,
+                },
+                query: expandCustomProperties ? { expand: 'custom_properties' } : undefined,
+            },
+        });
+        if (error) {
+            this.error(t('commands.scapi.schemas.get.error', 'Failed to fetch schema: {{message}}', {
+                message: formatApiError(error),
+            }));
+        }
+        // Handle list-* flags - just output the available items
+        if (listPaths || listSchemas || listExamples) {
+            const fullSchema = data;
+            if (listPaths) {
+                const paths = getPathKeys(fullSchema);
+                return this.outputList(paths, 'paths');
+            }
+            if (listSchemas) {
+                const schemas = getSchemaNames(fullSchema);
+                return this.outputList(schemas, 'schemas');
+            }
+            if (listExamples) {
+                const examples = getExampleNames(fullSchema);
+                return this.outputList(examples, 'examples');
+            }
+        }
+        // Apply collapsing unless --expand-all is set
+        let schema;
+        if (expandAll) {
+            schema = data;
+        }
+        else {
+            const fullSchema = data;
+            schema = collapseOpenApiSchema(fullSchema, {
+                expandPaths,
+                expandSchemas,
+                expandExamples,
+            });
+        }
+        const output = { apiFamily, apiName, apiVersion, schema };
+        // For --json flag, oclif handles serialization (wrapped output)
+        if (this.jsonEnabled()) {
+            return output;
+        }
+        // Output to stdout (raw schema)
+        if (outputYaml) {
+            process.stdout.write(this.serializeToYaml(schema));
+            process.stdout.write('\n');
+        }
+        else {
+            process.stdout.write(JSON.stringify(schema, null, 2));
+            process.stdout.write('\n');
+        }
+        return output;
+    }
+    /**
+     * Build expansion info string for the log message.
+     */
+    getExpansionInfo(expandAll, expandPaths, expandSchemas, expandExamples) {
+        if (expandAll) {
+            return ' (expand=full)';
+        }
+        const parts = [];
+        if (expandPaths.length > 0) {
+            parts.push(`paths: ${expandPaths.join(', ')}`);
+        }
+        if (expandSchemas.length > 0) {
+            parts.push(`schemas: ${expandSchemas.join(', ')}`);
+        }
+        if (expandExamples.length > 0) {
+            parts.push(`examples: ${expandExamples.join(', ')}`);
+        }
+        if (parts.length > 0) {
+            return ` (expanding ${parts.join('; ')})`;
+        }
+        return ' (outline only - use --expand-paths, --expand-schemas, or --expand-all for details)';
+    }
+    /**
+     * Check if a value is a non-empty object (not an array).
+     */
+    isNonEmptyObject(value) {
+        return typeof value === 'object' && value !== null && !Array.isArray(value) && Object.keys(value).length > 0;
+    }
+    /**
+     * Output a list of items (paths, schemas, or examples).
+     */
+    outputList(items, type) {
+        if (this.jsonEnabled()) {
+            return items;
+        }
+        if (items.length === 0) {
+            this.log(t('commands.scapi.schemas.get.noItems', 'No {{type}} found.', { type }));
+        }
+        else {
+            this.log(t('commands.scapi.schemas.get.itemCount', 'Found {{count}} {{type}}:', { count: items.length, type }));
+            for (const item of items) {
+                this.log(`  ${item}`);
+            }
+        }
+        return items;
+    }
+    /**
+     * Serialize object to YAML format.
+     * Uses a simple JSON-to-YAML conversion for basic YAML output.
+     */
+    serializeToYaml(obj, indent = 0) {
+        if (obj === null || obj === undefined) {
+            return 'null';
+        }
+        if (typeof obj === 'string') {
+            return this.serializeYamlString(obj);
+        }
+        if (typeof obj === 'number' || typeof obj === 'boolean') {
+            return String(obj);
+        }
+        if (Array.isArray(obj)) {
+            return this.serializeYamlArray(obj, indent);
+        }
+        if (typeof obj === 'object') {
+            return this.serializeYamlObject(obj, indent);
+        }
+        return String(obj);
+    }
+    /**
+     * Serialize an array to YAML format.
+     */
+    serializeYamlArray(arr, indent) {
+        if (arr.length === 0) {
+            return '[]';
+        }
+        // For arrays of primitives, use inline format
+        if (arr.every((item) => typeof item !== 'object' || item === null)) {
+            return `[${arr.map((item) => this.serializeToYaml(item, 0)).join(', ')}]`;
+        }
+        // For arrays of objects, use block format
+        const indentStr = '  '.repeat(indent);
+        const lines = [];
+        for (const item of arr) {
+            const serialized = this.serializeToYaml(item, indent + 1);
+            if (typeof item === 'object' && item !== null && !Array.isArray(item)) {
+                // Object items - first line starts with -, rest are indented
+                const objLines = serialized.split('\n');
+                lines.push(`${indentStr}- ${objLines[0]}`);
+                for (let i = 1; i < objLines.length; i++) {
+                    lines.push(`${indentStr}  ${objLines[i]}`);
+                }
+            }
+            else {
+                lines.push(`${indentStr}- ${serialized}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Serialize an object to YAML format.
+     */
+    serializeYamlObject(obj, indent) {
+        const entries = Object.entries(obj);
+        if (entries.length === 0) {
+            return '{}';
+        }
+        const indentStr = '  '.repeat(indent);
+        const lines = [];
+        for (const [key, value] of entries) {
+            const serializedValue = this.serializeToYaml(value, indent + 1);
+            if (this.isNonEmptyObject(value)) {
+                // Nested object - put on next line
+                lines.push(`${indentStr}${key}:`);
+                for (const line of serializedValue.split('\n')) {
+                    lines.push(`${indentStr}  ${line}`);
+                }
+            }
+            else if (Array.isArray(value) && value.some((item) => typeof item === 'object')) {
+                // Array with objects - put on next line
+                lines.push(`${indentStr}${key}:`);
+                for (const line of serializedValue.split('\n')) {
+                    lines.push(line);
+                }
+            }
+            else {
+                // Simple value or empty object/array - inline
+                lines.push(`${indentStr}${key}: ${serializedValue}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Serialize a string value to YAML, quoting if necessary.
+     */
+    serializeYamlString(str) {
+        if (str.includes('\n') || str.includes(':') || str.includes('#') || str === '') {
+            return JSON.stringify(str);
+        }
+        return str;
+    }
+}
+//# sourceMappingURL=get.js.map

package/dist/commands/scapi/schemas/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../../src/commands/scapi/schemas/get.ts"],"names":[],"mappings":"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"}

package/dist/commands/scapi/schemas/list.d.ts

@@ -0,0 +1,48 @@
+import type { SchemaListItem } from '@salesforce/b2c-tooling-sdk/clients';
+import { ScapiSchemasCommand } from '../../../utils/scapi/schemas.js';
+/**
+ * Response type for the list command.
+ */
+interface ListOutput {
+    schemas: SchemaListItem[];
+    total: number;
+}
+/**
+ * Command to list available SCAPI schemas.
+ */
+export default class ScapiSchemasList extends ScapiSchemasCommand<typeof ScapiSchemasList> {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'api-family': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        status: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        columns: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        extended: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'tenant-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'client-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'client-secret': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        scope: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'short-code': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'auth-methods': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'account-manager-host': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'log-level': import("@oclif/core/interfaces").OptionFlag<"trace" | "debug" | "info" | "warn" | "error" | "silent" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        instance: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'working-directory': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-query': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-body': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-headers': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<ListOutput>;
+    /**
+     * Determines which columns to display based on flags.
+     */
+    private getSelectedColumns;
+}
+export {};

package/dist/commands/scapi/schemas/list.js

@@ -0,0 +1,148 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { Flags } from '@oclif/core';
+import { TableRenderer } from '@salesforce/b2c-tooling-sdk/cli';
+import { ScapiSchemasCommand, formatApiError } from '../../../utils/scapi/schemas.js';
+import { t } from '../../../i18n/index.js';
+const COLUMNS = {
+    apiFamily: {
+        header: 'API Family',
+        get: (s) => s.apiFamily || '-',
+    },
+    apiName: {
+        header: 'API Name',
+        get: (s) => s.apiName || '-',
+    },
+    apiVersion: {
+        header: 'Version',
+        get: (s) => s.apiVersion || '-',
+    },
+    status: {
+        header: 'Status',
+        get: (s) => s.status || '-',
+    },
+    schemaVersion: {
+        header: 'Schema Ver',
+        get: (s) => s.schemaVersion || '-',
+        extended: true,
+    },
+    link: {
+        header: 'Link',
+        get: (s) => s.link || '-',
+        extended: true,
+    },
+};
+/** Default columns shown without --extended */
+const DEFAULT_COLUMNS = ['apiFamily', 'apiName', 'apiVersion', 'status'];
+const tableRenderer = new TableRenderer(COLUMNS);
+/**
+ * Command to list available SCAPI schemas.
+ */
+export default class ScapiSchemasList extends ScapiSchemasCommand {
+    static description = t('commands.scapi.schemas.list.description', 'List available SCAPI schemas');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --tenant-id f_ecom_zzxy_prd',
+        '<%= config.bin %> <%= command.id %> --tenant-id f_ecom_zzxy_prd --api-family shopper',
+        '<%= config.bin %> <%= command.id %> --tenant-id f_ecom_zzxy_prd --api-name products',
+        '<%= config.bin %> <%= command.id %> --tenant-id f_ecom_zzxy_prd --status current',
+        '<%= config.bin %> <%= command.id %> --tenant-id f_ecom_zzxy_prd --extended',
+        '<%= config.bin %> <%= command.id %> --tenant-id f_ecom_zzxy_prd --json',
+    ];
+    static flags = {
+        ...ScapiSchemasCommand.baseFlags,
+        'api-family': Flags.string({
+            description: t('flags.apiFamily.description', 'Filter by API family (e.g., shopper, admin)'),
+        }),
+        'api-name': Flags.string({
+            description: t('flags.apiName.description', 'Filter by API name (e.g., products, orders)'),
+        }),
+        'api-version': Flags.string({
+            description: t('flags.apiVersion.description', 'Filter by API version (e.g., v1)'),
+        }),
+        status: Flags.string({
+            char: 's',
+            description: t('flags.status.description', 'Filter by schema status'),
+            options: ['current', 'deprecated'],
+        }),
+        columns: Flags.string({
+            char: 'c',
+            description: `Columns to display (comma-separated). Available: ${Object.keys(COLUMNS).join(', ')}`,
+        }),
+        extended: Flags.boolean({
+            char: 'x',
+            description: t('flags.extended.description', 'Show all columns including extended fields'),
+            default: false,
+        }),
+    };
+    async run() {
+        this.requireOAuthCredentials();
+        const { 'api-family': apiFamily, 'api-name': apiName, 'api-version': apiVersion, status } = this.flags;
+        if (!this.jsonEnabled()) {
+            this.log(t('commands.scapi.schemas.list.fetching', 'Fetching SCAPI schemas...'));
+        }
+        const client = this.getSchemasClient();
+        const { data, error } = await client.GET('/organizations/{organizationId}/schemas', {
+            params: {
+                path: { organizationId: this.getOrganizationId() },
+                query: {
+                    apiFamily: apiFamily || undefined,
+                    apiName: apiName || undefined,
+                    apiVersion: apiVersion || undefined,
+                    status: status,
+                },
+            },
+        });
+        if (error) {
+            this.error(t('commands.scapi.schemas.list.error', 'Failed to fetch SCAPI schemas: {{message}}', {
+                message: formatApiError(error),
+            }));
+        }
+        const schemas = data?.data ?? [];
+        const output = {
+            schemas,
+            total: data?.total ?? schemas.length,
+        };
+        if (this.jsonEnabled()) {
+            return output;
+        }
+        if (schemas.length === 0) {
+            this.log(t('commands.scapi.schemas.list.noSchemas', 'No schemas found.'));
+            return output;
+        }
+        this.log(t('commands.scapi.schemas.list.count', 'Found {{count}} schema(s):', {
+            count: schemas.length,
+        }));
+        this.log('');
+        const columns = this.getSelectedColumns();
+        tableRenderer.render(schemas, columns);
+        return output;
+    }
+    /**
+     * Determines which columns to display based on flags.
+     */
+    getSelectedColumns() {
+        const columnsFlag = this.flags.columns;
+        const extended = this.flags.extended;
+        if (columnsFlag) {
+            // User specified explicit columns
+            const requested = columnsFlag.split(',').map((c) => c.trim());
+            const valid = tableRenderer.validateColumnKeys(requested);
+            if (valid.length === 0) {
+                this.warn(`No valid columns specified. Available: ${tableRenderer.getColumnKeys().join(', ')}`);
+                return DEFAULT_COLUMNS;
+            }
+            return valid;
+        }
+        if (extended) {
+            // Show all columns
+            return tableRenderer.getColumnKeys();
+        }
+        // Default columns (non-extended)
+        return DEFAULT_COLUMNS;
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/scapi/schemas/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/commands/scapi/schemas/list.ts"],"names":[],"mappings":"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"}

package/dist/commands/sites/list.d.ts

@@ -0,0 +1,10 @@
+import { InstanceCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import type { OcapiComponents } from '@salesforce/b2c-tooling-sdk';
+type Sites = OcapiComponents['schemas']['sites'];
+export default class SitesList extends InstanceCommand<typeof SitesList> {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    run(): Promise<Sites>;
+}
+export {};

package/dist/commands/sites/list.js

@@ -0,0 +1,56 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { ux } from '@oclif/core';
+import { InstanceCommand, createTable } from '@salesforce/b2c-tooling-sdk/cli';
+import { t } from '../../i18n/index.js';
+const COLUMNS = {
+    id: {
+        header: 'ID',
+        get: (s) => s.id || '-',
+    },
+    displayName: {
+        header: 'Display Name',
+        get: (s) => s.display_name?.default || s.id || '-',
+    },
+    status: {
+        header: 'Status',
+        get: (s) => s.storefront_status || 'unknown',
+    },
+};
+const DEFAULT_COLUMNS = ['id', 'displayName', 'status'];
+export default class SitesList extends InstanceCommand {
+    static description = t('commands.sites.list.description', 'List sites on a B2C Commerce instance');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --server my-sandbox.demandware.net',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    async run() {
+        this.requireOAuthCredentials();
+        const hostname = this.resolvedConfig.values.hostname;
+        this.log(t('commands.sites.list.fetching', 'Fetching sites from {{hostname}}...', { hostname }));
+        const { data, error } = await this.instance.ocapi.GET('/sites', {
+            params: { query: { select: '(**)' } },
+        });
+        if (error) {
+            this.error(t('commands.sites.list.error', 'Failed to fetch sites: {{message}}', { message: String(error) }));
+        }
+        const sites = data;
+        // In JSON mode, just return the data - oclif handles output to stdout
+        if (this.jsonEnabled()) {
+            return sites;
+        }
+        // Human-readable table output to stdout
+        if (!sites || sites.count === 0) {
+            ux.stdout(t('commands.sites.list.noSites', 'No sites found.'));
+            return sites;
+        }
+        createTable(COLUMNS).render(sites.data ?? [], DEFAULT_COLUMNS);
+        return sites;
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/sites/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/sites/list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,EAAE,EAAC,MAAM,aAAa,CAAC;AAC/B,OAAO,EAAC,eAAe,EAAE,WAAW,EAAiB,MAAM,iCAAiC,CAAC;AAE7F,OAAO,EAAC,CAAC,EAAC,MAAM,qBAAqB,CAAC;AAKtC,MAAM,OAAO,GAAoC;IAC/C,EAAE,EAAE;QACF,MAAM,EAAE,IAAI;QACZ,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG;KACxB;IACD,WAAW,EAAE;QACX,MAAM,EAAE,cAAc;QACtB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,OAAO,IAAI,CAAC,CAAC,EAAE,IAAI,GAAG;KACnD;IACD,MAAM,EAAE;QACN,MAAM,EAAE,QAAQ;QAChB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB,IAAI,SAAS;KAC7C;CACF,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC;AAExD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,eAAiC;IACtE,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,iCAAiC,EAAE,uCAAuC,CAAC,CAAC;IAEnG,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG;QAChB,qCAAqC;QACrC,wEAAwE;QACxE,4CAA4C;KAC7C,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAE/B,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAS,CAAC;QAEtD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,8BAA8B,EAAE,qCAAqC,EAAE,EAAC,QAAQ,EAAC,CAAC,CAAC,CAAC;QAE/F,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE;YAC5D,MAAM,EAAE,EAAC,KAAK,EAAE,EAAC,MAAM,EAAE,MAAM,EAAC,EAAC;SAClC,CAAC,CAAC;QAEH,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,2BAA2B,EAAE,oCAAoC,EAAE,EAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAC,CAAC,CAAC,CAAC;QAC7G,CAAC;QAED,MAAM,KAAK,GAAG,IAAa,CAAC;QAE5B,sEAAsE;QACtE,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,wCAAwC;QACxC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;YAChC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,6BAA6B,EAAE,iBAAiB,CAAC,CAAC,CAAC;YAC/D,OAAO,KAAK,CAAC;QACf,CAAC;QAED,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,eAAe,CAAC,CAAC;QAE/D,OAAO,KAAK,CAAC;IACf,CAAC"}