@salesforce/b2c-cli 1.0.1 → 1.1.0

package/dist/commands/sandbox/realm/usages.d.ts

@@ -0,0 +1,23 @@
+import { OdsCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { type OdsComponents } from '@salesforce/b2c-tooling-sdk';
+type MultiRealmUsageModel = OdsComponents['schemas']['MultiRealmUsageModel'];
+type MultiRealmUsageResponse = OdsComponents['schemas']['MultiRealmUsageResponse'];
+/**
+ * Show usage information for multiple realms.
+ */
+export default class SandboxRealmUsages extends OdsCommand<typeof SandboxRealmUsages> {
+    static aliases: string[];
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        readonly realm: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly from: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly to: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly 'detailed-report': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<MultiRealmUsageModel[] | MultiRealmUsageResponse | undefined>;
+    private printUsage;
+    private resolveRealms;
+}
+export {};

package/dist/commands/sandbox/realm/usages.js

@@ -0,0 +1,105 @@
+/*
+ * 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 { OdsCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { getApiErrorMessage } from '@salesforce/b2c-tooling-sdk';
+import { t, withDocs } from '../../../i18n/index.js';
+/**
+ * Show usage information for multiple realms.
+ */
+export default class SandboxRealmUsages extends OdsCommand {
+    static aliases = ['ods:realm:usages'];
+    static description = withDocs(t('commands.realm.usages.description', 'Show usage information for multiple realms'), '/cli/realm.html#b2c-realm-usages');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --realm zzzz --realm yyyy',
+        '<%= config.bin %> <%= command.id %> --realm zzzz,yyyy --from 2026-02-08 --to 2026-02-11',
+        '<%= config.bin %> <%= command.id %> --detailed-report --json',
+    ];
+    static flags = {
+        realm: Flags.string({
+            description: 'Realm ID(s). Repeat flag or provide comma-separated values',
+            multiple: true,
+            multipleNonGreedy: true,
+            delimiter: ',',
+        }),
+        from: Flags.string({
+            description: 'Earliest date to include in usage (ISO 8601)',
+        }),
+        to: Flags.string({
+            description: 'Latest date to include in usage (ISO 8601)',
+        }),
+        'detailed-report': Flags.boolean({
+            description: 'Include detailed usage information in the response',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SandboxRealmUsages);
+        const realms = await this.resolveRealms(flags.realm);
+        if (realms.length === 0) {
+            this.log(t('commands.realm.usages.noRealms', 'No realms found for the current user.'));
+            return undefined;
+        }
+        const result = await this.odsClient.POST('/realms/usages', {
+            body: {
+                from: flags.from,
+                to: flags.to,
+                realms,
+                detailedReport: flags['detailed-report'],
+            },
+        });
+        if (result.error) {
+            this.error(t('commands.realm.usages.error', 'Failed to fetch multi-realm usage: {{message}}', {
+                message: getApiErrorMessage(result.error, result.response),
+            }));
+        }
+        const data = result.data?.data;
+        if (!data || data.length === 0) {
+            this.log(t('commands.realm.usages.noData', 'No usage data was returned for the requested realms.'));
+            return undefined;
+        }
+        if (this.jsonEnabled()) {
+            return result.data;
+        }
+        this.printUsage(data);
+        return data;
+    }
+    printUsage(items) {
+        console.log('Realm  Active  Created  Deleted  Minutes Up  Minutes Down  Sandbox Seconds');
+        console.log('─────  ──────  ───────  ───────  ──────────  ────────────  ───────────────');
+        for (const item of items) {
+            const usage = item.realmUsage;
+            const row = [
+                String(item.realmName ?? '-').padEnd(5),
+                String(usage?.activeSandboxes ?? '-').padStart(6),
+                String(usage?.createdSandboxes ?? '-').padStart(7),
+                String(usage?.deletedSandboxes ?? '-').padStart(7),
+                String(usage?.minutesUp ?? '-').padStart(10),
+                String(usage?.minutesDown ?? '-').padStart(12),
+                String(usage?.sandboxSeconds ?? '-').padStart(15),
+            ];
+            console.log(row.join('  '));
+            if (item.error) {
+                console.log(`  ! ${item.error}`);
+            }
+        }
+    }
+    async resolveRealms(inputRealms) {
+        if (inputRealms && inputRealms.length > 0) {
+            return inputRealms;
+        }
+        const meResult = await this.odsClient.GET('/me', {});
+        if (meResult.error || !meResult.data?.data?.realms) {
+            this.error(t('commands.realm.usages.realmsError', 'Failed to resolve realms from current user: {{message}}', {
+                message: getApiErrorMessage(meResult.error, meResult.response),
+            }));
+        }
+        return meResult.data.data.realms ?? [];
+    }
+}
+//# sourceMappingURL=usages.js.map

package/dist/commands/sandbox/realm/usages.js.map

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

package/dist/commands/sandbox/settings.d.ts

@@ -0,0 +1,19 @@
+import { OdsCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { type OdsComponents } from '@salesforce/b2c-tooling-sdk';
+type SandboxSettings = OdsComponents['schemas']['SandboxSettings'];
+type SandboxSettingsResponse = OdsComponents['schemas']['SandboxSettingsResponse'];
+/**
+ * Show sandbox settings.
+ */
+export default class SandboxSettingsCommand extends OdsCommand<typeof SandboxSettingsCommand> {
+    static aliases: string[];
+    static args: {
+        sandboxId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    run(): Promise<SandboxSettings | SandboxSettingsResponse | undefined>;
+    private printSettings;
+}
+export {};

package/dist/commands/sandbox/settings.js

@@ -0,0 +1,76 @@
+/*
+ * 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 } from '@oclif/core';
+import { OdsCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { getApiErrorMessage } from '@salesforce/b2c-tooling-sdk';
+import { t, withDocs } from '../../i18n/index.js';
+/**
+ * Show sandbox settings.
+ */
+export default class SandboxSettingsCommand extends OdsCommand {
+    static aliases = ['ods:settings'];
+    static args = {
+        sandboxId: Args.string({
+            description: 'Sandbox ID (UUID or realm-instance, e.g., zzzz-001)',
+            required: true,
+        }),
+    };
+    static description = withDocs(t('commands.sandbox.settings.description', 'Show settings for a specific sandbox'), '/cli/sandbox.html#b2c-sandbox-settings');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> zzzz-001',
+        '<%= config.bin %> <%= command.id %> zzzz-001 --json',
+    ];
+    async run() {
+        const { args } = await this.parse(SandboxSettingsCommand);
+        const sandboxId = await this.resolveSandboxId(args.sandboxId);
+        const result = await this.odsClient.GET('/sandboxes/{sandboxId}/settings', {
+            params: {
+                path: { sandboxId },
+            },
+        });
+        if (result.error) {
+            this.error(t('commands.sandbox.settings.error', 'Failed to fetch sandbox settings: {{message}}', {
+                message: getApiErrorMessage(result.error, result.response),
+            }));
+        }
+        const data = result.data?.data;
+        if (!data) {
+            this.log(t('commands.sandbox.settings.noData', 'No settings were returned for this sandbox.'));
+            return undefined;
+        }
+        if (this.jsonEnabled()) {
+            return result.data;
+        }
+        this.printSettings(data);
+        return data;
+    }
+    printSettings(settings) {
+        const ocapi = settings.ocapi ?? [];
+        const webdav = settings.webdav ?? [];
+        console.log('Sandbox Settings');
+        console.log('────────────────');
+        console.log(`OCAPI client entries: ${ocapi.length}`);
+        console.log(`WebDAV client entries: ${webdav.length}`);
+        if (ocapi.length > 0) {
+            console.log();
+            console.log('OCAPI');
+            for (const entry of ocapi) {
+                const resources = entry.resources?.length ?? 0;
+                console.log(`  - ${entry.client_id ?? 'unknown-client'} (${resources} resource rules)`);
+            }
+        }
+        if (webdav.length > 0) {
+            console.log();
+            console.log('WebDAV');
+            for (const entry of webdav) {
+                const permissions = entry.permissions?.length ?? 0;
+                console.log(`  - ${entry.client_id ?? 'unknown-client'} (${permissions} permission rules)`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=settings.js.map

package/dist/commands/sandbox/settings.js.map

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

package/dist/commands/sandbox/storage.d.ts

@@ -0,0 +1,19 @@
+import { OdsCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { type OdsComponents } from '@salesforce/b2c-tooling-sdk';
+type SandboxStorageModel = OdsComponents['schemas']['SandboxStorageModel'];
+type SandboxStorageResponse = OdsComponents['schemas']['SandboxStorageResponse'];
+/**
+ * Show sandbox storage details.
+ */
+export default class SandboxStorage extends OdsCommand<typeof SandboxStorage> {
+    static aliases: string[];
+    static args: {
+        sandboxId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    run(): Promise<SandboxStorageModel | SandboxStorageResponse | undefined>;
+    private printStorage;
+}
+export {};

package/dist/commands/sandbox/storage.js

@@ -0,0 +1,64 @@
+/*
+ * 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 } from '@oclif/core';
+import { OdsCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { getApiErrorMessage } from '@salesforce/b2c-tooling-sdk';
+import { t, withDocs } from '../../i18n/index.js';
+/**
+ * Show sandbox storage details.
+ */
+export default class SandboxStorage extends OdsCommand {
+    static aliases = ['ods:storage'];
+    static args = {
+        sandboxId: Args.string({
+            description: 'Sandbox ID (UUID or realm-instance, e.g., zzzz-001)',
+            required: true,
+        }),
+    };
+    static description = withDocs(t('commands.sandbox.storage.description', 'Show storage details for a specific sandbox'), '/cli/sandbox.html#b2c-sandbox-storage');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> zzzz-001',
+        '<%= config.bin %> <%= command.id %> zzzz-001 --json',
+    ];
+    async run() {
+        const { args } = await this.parse(SandboxStorage);
+        const sandboxId = await this.resolveSandboxId(args.sandboxId);
+        const result = await this.odsClient.GET('/sandboxes/{sandboxId}/storage', {
+            params: {
+                path: { sandboxId },
+            },
+        });
+        if (result.error) {
+            this.error(t('commands.sandbox.storage.error', 'Failed to fetch sandbox storage: {{message}}', {
+                message: getApiErrorMessage(result.error, result.response),
+            }));
+        }
+        const data = result.data?.data;
+        if (!data || Object.keys(data).length === 0) {
+            this.log(t('commands.sandbox.storage.noData', 'No storage data was returned for this sandbox.'));
+            return undefined;
+        }
+        if (this.jsonEnabled()) {
+            return result.data;
+        }
+        this.printStorage(data);
+        return data;
+    }
+    printStorage(storage) {
+        console.log('Sandbox Storage');
+        console.log('───────────────');
+        console.log('Filesystem                Total (MB)  Used (MB)  Used (%)');
+        console.log('────────────────────────  ──────────  ─────────  ────────');
+        for (const [name, usage] of Object.entries(storage)) {
+            const total = usage?.spaceTotal ?? '-';
+            const used = usage?.spaceUsed ?? '-';
+            const percentage = usage?.percentageUsed ?? '-';
+            console.log(`${name.padEnd(24)}  ${String(total).padStart(10)}  ${String(used).padStart(9)}  ${String(percentage).padStart(8)}`);
+        }
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/commands/sandbox/storage.js.map

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