@salesforce/b2c-cli 1.19.0 → 1.20.0

package/dist/commands/{setup/ide/prophet.d.ts → docs/cache.d.ts}

@@ -1,21 +1,20 @@
 import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
-/**
- * JSON output structure for setup ide prophet command.
- */
-interface SetupIdeProphetResponse {
-    overwritten: boolean;
-    path: string;
+interface CacheResult {
+    /** The action taken: reported stats only, or cleared the cache. */
+    action: 'clear' | 'status';
+    /** Cache directory. */
+    dir: string;
+    /** Number of cached files (before clearing, when `--clear`). */
+    files: number;
+    /** Total bytes (before clearing, when `--clear`). */
+    bytes: number;
 }
-/**
- * Create dw.js integration script for Prophet VS Code extension.
- */
-export default class SetupIdeProphet extends BaseCommand<typeof SetupIdeProphet> {
+export default class DocsCache extends BaseCommand<typeof DocsCache> {
     static description: string;
     static enableJsonFlag: boolean;
     static examples: string[];
     static flags: {
-        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        clear: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         '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>;
@@ -28,11 +27,6 @@ export default class SetupIdeProphet extends BaseCommand<typeof SetupIdeProphet>
         '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<SetupIdeProphetResponse>;
-    /**
-     * Build setup inspect arguments for the generated script.
-     * Includes setup context flags so runtime resolution matches command intent.
-     */
-    private buildInspectArgs;
+    run(): Promise<CacheResult>;
 }
 export {};

package/dist/commands/docs/cache.js

@@ -0,0 +1,55 @@
+/*
+ * 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 { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { getContentCacheStats, purgeContentCache } from '@salesforce/b2c-tooling-sdk/docs';
+import { t } from '../../i18n/index.js';
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+export default class DocsCache extends BaseCommand {
+    static description = t('commands.docs.cache.description', 'Show or clear the local documentation content cache (online docs cached after first read)');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --clear',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        clear: Flags.boolean({
+            description: 'Delete all cached documentation content (memory + on-disk)',
+            default: false,
+        }),
+    };
+    async run() {
+        const { clear } = this.flags;
+        if (clear) {
+            const purged = purgeContentCache();
+            if (!this.jsonEnabled()) {
+                this.log(t('commands.docs.cache.cleared', 'Cleared documentation cache: removed {{files}} file(s) ({{size}}) from {{dir}}', { files: purged.files, size: formatBytes(purged.bytes), dir: purged.dir }));
+            }
+            return { action: 'clear', dir: purged.dir, files: purged.files, bytes: purged.bytes };
+        }
+        const stats = getContentCacheStats();
+        if (!this.jsonEnabled()) {
+            this.log(t('commands.docs.cache.status', 'Documentation cache: {{files}} file(s), {{size}} at {{dir}}', {
+                files: stats.files,
+                size: formatBytes(stats.bytes),
+                dir: stats.dir,
+            }));
+            if (stats.files > 0) {
+                this.log(t('commands.docs.cache.clearHint', 'Run with --clear to empty it.'));
+            }
+        }
+        return { action: 'status', dir: stats.dir, files: stats.files, bytes: stats.bytes };
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/commands/docs/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/commands/docs/cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,KAAK,EAAC,MAAM,aAAa,CAAC;AAClC,OAAO,EAAC,WAAW,EAAC,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAC,oBAAoB,EAAE,iBAAiB,EAAyB,MAAM,kCAAkC,CAAC;AACjH,OAAO,EAAC,CAAC,EAAC,MAAM,qBAAqB,CAAC;AAatC,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,IAAI,CAAC;IACtC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAClE,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAA6B;IAClE,MAAM,CAAC,WAAW,GAAG,CAAC,CACpB,iCAAiC,EACjC,2FAA2F,CAC5F,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG;QAChB,qCAAqC;QACrC,6CAA6C;QAC7C,4CAA4C;KAC7C,CAAC;IAEF,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,WAAW,CAAC,SAAS;QACxB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;YACnB,WAAW,EAAE,4DAA4D;YACzE,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAC,KAAK,EAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QAE3B,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,MAAM,GAAsB,iBAAiB,EAAE,CAAC;YACtD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,CAAC,GAAG,CACN,CAAC,CACC,6BAA6B,EAC7B,gFAAgF,EAChF,EAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAC,CACxE,CACF,CAAC;YACJ,CAAC;YACD,OAAO,EAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAC,CAAC;QACtF,CAAC;QAED,MAAM,KAAK,GAAG,oBAAoB,EAAE,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CACN,CAAC,CAAC,4BAA4B,EAAE,6DAA6D,EAAE;gBAC7F,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC;gBAC9B,GAAG,EAAE,KAAK,CAAC,GAAG;aACf,CAAC,CACH,CAAC;YACF,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,+BAA+B,EAAE,+BAA+B,CAAC,CAAC,CAAC;YAChF,CAAC;QACH,CAAC;QACD,OAAO,EAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAC,CAAC;IACpF,CAAC"}

package/dist/commands/docs/read.d.ts

@@ -1,5 +1,6 @@
 import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
 import { readDocByQuery, type DocEntry } from '@salesforce/b2c-tooling-sdk/docs';
+import { detectWorkspaceType } from '@salesforce/b2c-tooling-sdk/discovery';
 interface ReadDocsResult {
     entry: DocEntry;
     content: string;
@@ -14,6 +15,7 @@ export default class DocsRead extends BaseCommand<typeof DocsRead> {
     static flags: {
         raw: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         topics: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        workspace: 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>;
@@ -28,6 +30,7 @@ export default class DocsRead extends BaseCommand<typeof DocsRead> {
     };
     protected operations: {
         readDocByQuery: typeof readDocByQuery;
+        detectWorkspaceType: typeof detectWorkspaceType;
     };
     run(): Promise<ReadDocsResult>;
 }

package/dist/commands/docs/read.js

@@ -8,7 +8,9 @@ import { marked } from 'marked';
 import { markedTerminal } from 'marked-terminal';
 import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
 import { readDocByQuery, resolveEnabledCategories } from '@salesforce/b2c-tooling-sdk/docs';
+import { detectWorkspaceType, PROJECT_TYPES } from '@salesforce/b2c-tooling-sdk/discovery';
 import { t } from '../../i18n/index.js';
+import { resolveDocsWorkspace } from '../../utils/docs/workspace.js';
 // Configure marked with terminal renderer
 marked.use(markedTerminal({
     width: 80,
@@ -46,17 +48,31 @@ export default class DocsRead extends BaseCommand {
                 'corpus). Unknown names are ignored with a warning.',
             env: 'SFCC_DOCS_TOPICS',
         }),
+        workspace: Flags.string({
+            // No oclif `options`: it validates the whole value, so it would reject a
+            // comma-separated list. Validation happens in resolveDocsWorkspace.
+            description: `Favor docs for a workspace type (auto|all|${PROJECT_TYPES.join('|')}) when resolving a fuzzy query, ` +
+                'matching `docs search` ranking. Defaults to auto-detecting; "all" applies no preference. ' +
+                'Ignored for an exact id match.',
+        }),
     };
     operations = {
         readDocByQuery,
+        detectWorkspaceType,
     };
     async run() {
         const { query } = this.args;
         const { raw } = this.flags;
-        const enabledCategories = resolveEnabledCategories(this.flags.topics, (invalid) => this.warn(t('commands.docs.read.invalidTopics', 'Ignoring unknown documentation topic(s): {{topics}}', {
+        // Flag first (--topics / SFCC_DOCS_TOPICS), else config `docsCategories`.
+        const topicsInput = this.flags.topics ?? this.resolvedConfig?.values.docsCategories;
+        const enabledCategories = resolveEnabledCategories(topicsInput, (invalid) => this.warn(t('commands.docs.read.invalidTopics', 'Ignoring unknown documentation topic(s): {{topics}}', {
             topics: invalid.join(', '),
         })));
-        const result = await this.operations.readDocByQuery(query, { enabledCategories });
+        // Resolve workspace the same way `docs search` does, so a fuzzy `docs read`
+        // picks the same top hit search ranks first (exact id matches ignore it —
+        // readDocByQuery short-circuits on an exact id before searching).
+        const workspace = await resolveDocsWorkspace(this.flags.workspace, this.operations.detectWorkspaceType, this.logger, this.warn.bind(this));
+        const result = await this.operations.readDocByQuery(query, { enabledCategories, workspace });
         if (!result) {
             this.error(t('commands.docs.read.notFound', 'No documentation found matching: {{query}}', { query }), {
                 suggestions: ['Try a broader search term', 'Use "b2c docs search <query>" to see available matches'],

package/dist/commands/docs/read.js.map

@@ -1 +1 @@
-{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/commands/docs/read.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,IAAI,EAAE,KAAK,EAAC,MAAM,aAAa,CAAC;AACxC,OAAO,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAC;AAE9B,OAAO,EAAC,cAAc,EAAC,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAC,WAAW,EAAC,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAC,cAAc,EAAE,wBAAwB,EAAgB,MAAM,kCAAkC,CAAC;AACzG,OAAO,EAAC,CAAC,EAAC,MAAM,qBAAqB,CAAC;AAOtC,0CAA0C;AAC1C,MAAM,CAAC,GAAG,CACR,cAAc,CAAC;IACb,KAAK,EAAE,EAAE;IACT,UAAU,EAAE,IAAI;IAChB,YAAY,EAAE;QACZ,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;KACpB;CACF,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAA4B;IAChE,MAAM,CAAC,IAAI,GAAG;QACZ,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC;YACjB,WAAW,EAAE,4EAA4E;YACzF,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAC;IAEF,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,gCAAgC,EAAE,qDAAqD,CAAC,CAAC;IAEhH,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG;QAChB,gDAAgD;QAChD,2DAA2D;QAC3D,wDAAwD;QACxD,sDAAsD;QACtD,uDAAuD;KACxD,CAAC;IAEF,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,WAAW,CAAC,SAAS;QACxB,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC;YACjB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,iDAAiD;YAC9D,OAAO,EAAE,KAAK;SACf,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,WAAW,EACT,oGAAoG;gBACpG,oDAAoD;YACtD,GAAG,EAAE,kBAAkB;SACxB,CAAC;KACH,CAAC;IAEQ,UAAU,GAAG;QACrB,cAAc;KACf,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAC,KAAK,EAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QAC1B,MAAM,EAAC,GAAG,EAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAChF,IAAI,CAAC,IAAI,CACP,CAAC,CAAC,kCAAkC,EAAE,qDAAqD,EAAE;YAC3F,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;SAC3B,CAAC,CACH,CACF,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,KAAK,EAAE,EAAC,iBAAiB,EAAC,CAAC,CAAC;QAEhF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,6BAA6B,EAAE,4CAA4C,EAAE,EAAC,KAAK,EAAC,CAAC,EAAE;gBAClG,WAAW,EAAE,CAAC,2BAA2B,EAAE,wDAAwD,CAAC;aACrG,CAAC,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,sDAAsD;QACtD,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAE5C,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC9C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAkB,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC"}
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/commands/docs/read.ts"],"names":[],"mappings":"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"}

package/dist/commands/docs/search.d.ts

@@ -44,12 +44,9 @@ export default class DocsSearch extends BaseCommand<typeof DocsSearch> {
     };
     run(): Promise<ListDocsResponse | SearchDocsResponse>;
     /**
-     * Resolves the --workspace flag to concrete project type(s).
-     *
-     * Workspace awareness is ON by default (matching the MCP docs tools): when
-     * the flag is unset — or explicitly `auto` — workspace detection runs and its
-     * result favors the detected workspace's docs. `all` opts out (no
-     * preference); an explicit type (or comma-separated list) is used verbatim without detection.
+     * Resolves the --workspace flag to concrete project type(s). Shared with
+     * `docs read` via {@link resolveDocsWorkspace} so both apply the same
+     * workspace-aware ranking.
      */
     private resolveWorkspace;
 }

package/dist/commands/docs/search.js

@@ -8,6 +8,7 @@ import { BaseCommand, TableRenderer, columnFlagsFor, selectColumns, } from '@sal
 import { searchDocs, listDocs, categoriesForWorkspace, resolveEnabledCategories, DOC_CATEGORIES, } from '@salesforce/b2c-tooling-sdk/docs';
 import { detectWorkspaceType, PROJECT_TYPES } from '@salesforce/b2c-tooling-sdk/discovery';
 import { t } from '../../i18n/index.js';
+import { resolveDocsWorkspace } from '../../utils/docs/workspace.js';
 /**
  * The `--workspace` sentinels plus every concrete workspace marker (from the
  * SDK's canonical {@link PROJECT_TYPES}). `auto` forces detection, `all` opts
@@ -113,8 +114,11 @@ export default class DocsSearch extends BaseCommand {
     async run() {
         const { query } = this.args;
         const { limit, list, category } = this.flags;
-        // Launch-time allowlist that bounds the whole corpus (from --topics / SFCC_DOCS_TOPICS).
-        const enabledCategories = resolveEnabledCategories(this.flags.topics, (invalid) => this.warn(t('commands.docs.search.invalidTopics', 'Ignoring unknown documentation topic(s): {{topics}}', {
+        // Allowlist that bounds the whole corpus. Precedence: --topics /
+        // SFCC_DOCS_TOPICS flag first, else the resolved config's `docsCategories`
+        // (dw.json `docs-categories`, SFCC_DOCS_CATEGORIES, package.json).
+        const topicsInput = this.flags.topics ?? this.resolvedConfig?.values.docsCategories;
+        const enabledCategories = resolveEnabledCategories(topicsInput, (invalid) => this.warn(t('commands.docs.search.invalidTopics', 'Ignoring unknown documentation topic(s): {{topics}}', {
             topics: invalid.join(', '),
         })));
         // List mode
@@ -177,53 +181,12 @@ export default class DocsSearch extends BaseCommand {
         return response;
     }
     /**
-     * Resolves the --workspace flag to concrete project type(s).
-     *
-     * Workspace awareness is ON by default (matching the MCP docs tools): when
-     * the flag is unset — or explicitly `auto` — workspace detection runs and its
-     * result favors the detected workspace's docs. `all` opts out (no
-     * preference); an explicit type (or comma-separated list) is used verbatim without detection.
+     * Resolves the --workspace flag to concrete project type(s). Shared with
+     * `docs read` via {@link resolveDocsWorkspace} so both apply the same
+     * workspace-aware ranking.
      */
-    async resolveWorkspace(value) {
-        if (value === 'all') {
-            this.logger.debug('Workspace preference disabled (--workspace all); no detection run');
-            return undefined;
-        }
-        if (!value || value === 'auto') {
-            const cwd = process.cwd();
-            const detection = await this.operations.detectWorkspaceType(cwd);
-            const resolved = detection.projectTypes.length > 0 ? detection.projectTypes : undefined;
-            this.logger.debug({
-                cwd,
-                workspaceFlag: value ?? '(unset, defaults to auto)',
-                matchedPatterns: detection.matchedPatterns,
-                projectTypes: detection.projectTypes,
-                resolved: resolved ?? null,
-            }, resolved
-                ? `Auto-detected workspace: ${resolved.join(', ')}`
-                : 'No workspace detected; searching with no workspace preference');
-            return resolved;
-        }
-        // Handle one or more comma-separated explicit types. Validate against the
-        // canonical PROJECT_TYPES; warn on (and drop) anything unrecognized.
-        const known = new Set(PROJECT_TYPES);
-        const requested = value
-            .split(',')
-            .map((t) => t.trim().toLowerCase())
-            .filter((t) => t.length > 0);
-        const valid = requested.filter((t) => known.has(t));
-        const invalid = requested.filter((t) => !known.has(t));
-        if (invalid.length > 0) {
-            this.warn(t('commands.docs.search.invalidWorkspace', 'Ignoring unknown workspace type(s): {{types}}', {
-                types: invalid.join(', '),
-            }));
-        }
-        if (valid.length === 0) {
-            this.logger.debug({ requested }, 'No valid workspace types specified; searching with no workspace preference');
-            return undefined;
-        }
-        this.logger.debug({ workspace: valid }, 'Using explicitly specified workspace type(s)');
-        return [...new Set(valid)];
+    resolveWorkspace(value) {
+        return resolveDocsWorkspace(value, this.operations.detectWorkspaceType, this.logger, this.warn.bind(this));
     }
 }
 //# sourceMappingURL=search.js.map

package/dist/commands/docs/search.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/commands/docs/search.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/commands/docs/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAC,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,WAAW,EACX,aAAa,EACb,cAAc,EACd,aAAa,GAEd,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,UAAU,EACV,QAAQ,EACR,sBAAsB,EACtB,wBAAwB,EACxB,cAAc,GAIf,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAC,mBAAmB,EAAE,aAAa,EAAmB,MAAM,uCAAuC,CAAC;AAC3G,OAAO,EAAC,CAAC,EAAC,MAAM,qBAAqB,CAAC;AACtC,OAAO,EAAC,oBAAoB,EAAC,MAAM,+BAA+B,CAAC;AAanE;;;;;;GAMG;AACH,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,aAAa,CAAU,CAAC;AAEzE;;;GAGG;AACH,MAAM,gBAAgB,GAA2B,cAAc,CAAC;AAEhE,MAAM,OAAO,GAA4C;IACvD,EAAE,EAAE;QACF,MAAM,EAAE,IAAI;QACZ,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE;KACvB;IACD,KAAK,EAAE;QACL,MAAM,EAAE,OAAO;QACf,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK;KAC1B;IACD,QAAQ,EAAE;QACR,MAAM,EAAE,UAAU;QAClB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE;KACnC;IACD,OAAO,EAAE;QACP,MAAM,EAAE,SAAS;QACjB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE;KACrD;IACD,QAAQ,EAAE;QACR,MAAM,EAAE,UAAU;QAClB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;KAChD;IACD,GAAG,EAAE;QACH,MAAM,EAAE,KAAK;QACb,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE;KAC9B;IACD,SAAS,EAAE;QACT,MAAM,EAAE,YAAY;QACpB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE;KACpC;IACD,KAAK,EAAE;QACL,MAAM,EAAE,OAAO;QACf,uEAAuE;QACvE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;KAC/B;CACF,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAE7D,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;AAEjD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAA8B;IACpE,MAAM,CAAC,IAAI,GAAG;QACZ,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC;YACjB,WAAW,EAAE,mFAAmF;YAChG,QAAQ,EAAE,KAAK;SAChB,CAAC;KACH,CAAC;IAEF,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,kCAAkC,EAAE,mCAAmC,CAAC,CAAC;IAEhG,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG;QAChB,gDAAgD;QAChD,kFAAkF;QAClF,yFAAyF;QACzF,sDAAsD;QACtD,+DAA+D;KAChE,CAAC;IAEF,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,WAAW,CAAC,SAAS;QACxB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;YACnB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,sCAAsC;YACnD,OAAO,EAAE,EAAE;SACZ,CAAC;QACF,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC;YAClB,WAAW,EAAE,0CAA0C;YACvD,OAAO,EAAE,KAAK;SACf,CAAC;QACF,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC;YACrB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,8CAA8C;YAC3D,OAAO,EAAE,CAAC,GAAG,gBAAgB,CAAC;SAC/B,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,WAAW,EACT,mGAAmG;gBACnG,uGAAuG;YACzG,GAAG,EAAE,kBAAkB;SACxB,CAAC;QACF,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC;YACtB,4EAA4E;YAC5E,uEAAuE;YACvE,gEAAgE;YAChE,WAAW,EACT,oCAAoC,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,iCAAiC;gBACpG,oGAAoG;SACvG,CAAC;QACF,iFAAiF;QACjF,GAAG,cAAc,CAAC,OAAO,EAAE,EAAC,WAAW,EAAE,KAAK,EAAC,CAAC;KACjD,CAAC;IAEQ,UAAU,GAAG;QACrB,mBAAmB;QACnB,QAAQ;QACR,UAAU;KACX,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAC,KAAK,EAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QAC1B,MAAM,EAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QAC3C,iEAAiE;QACjE,2EAA2E;QAC3E,mEAAmE;QACnE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC;QACpF,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,EAAE,CAC1E,IAAI,CAAC,IAAI,CACP,CAAC,CAAC,oCAAoC,EAAE,qDAAqD,EAAE;YAC7F,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;SAC3B,CAAC,CACH,CACF,CAAC;QAEF,YAAY;QACZ,IAAI,IAAI,EAAE,CAAC;YACT,0EAA0E;YAC1E,0EAA0E;YAC1E,sEAAsE;YACtE,MAAM,aAAa,GACjB,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,KAAK,KAAK;gBACpD,CAAC,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;gBACnD,CAAC,CAAC,SAAS,CAAC;YAChB,MAAM,UAAU,GACb,QAAoC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAC/G,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;YAExE,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvB,OAAO,EAAC,OAAO,EAAC,CAAC;YACnB,CAAC;YAED,gDAAgD;YAChD,MAAM,OAAO,GAAmB,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACtD,KAAK;gBACL,KAAK,EAAE,CAAC;aACT,CAAC,CAAC,CAAC;YAEJ,MAAM,WAAW,GAA4C;gBAC3D,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;aACrB,CAAC;YAEF,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;YAE5E,IAAI,CAAC,GAAG,CACN,CAAC,CAAC,iCAAiC,EAAE,2CAA2C,EAAE,EAAC,KAAK,EAAE,OAAO,CAAC,MAAM,EAAC,CAAC,CAC3G,CAAC;YAEF,OAAO,EAAC,OAAO,EAAC,CAAC;QACnB,CAAC;QAED,6BAA6B;QAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,KAAK,CACR,CAAC,CAAC,oCAAoC,EAAE,8DAA8D,CAAC,CACxG,CAAC;QACJ,CAAC;QAED,0EAA0E;QAC1E,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAEpE,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,EAAE;YAChD,KAAK;YACL,QAAQ,EAAE,QAAmC;YAC7C,SAAS;YACT,iBAAiB;SAClB,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAuB;YACnC,KAAK;YACL,GAAG,CAAC,QAAQ,IAAI,EAAC,QAAQ,EAAC,CAAC;YAC3B,GAAG,CAAC,SAAS,IAAI,EAAC,SAAS,EAAC,CAAC;YAC7B,OAAO;SACR,CAAC;QAEF,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,gCAAgC,EAAE,4CAA4C,EAAE,EAAC,KAAK,EAAC,CAAC,CAAC,CAAC;YACtG,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAE/G,IAAI,CAAC,GAAG,CACN,CAAC,CAAC,kCAAkC,EAAE,yCAAyC,EAAE;YAC/E,KAAK,EAAE,OAAO,CAAC,MAAM;YACrB,KAAK;SACN,CAAC,CACH,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACK,gBAAgB,CAAC,KAAyB;QAChD,OAAO,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,mBAAmB,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7G,CAAC"}

package/dist/commands/preferences/global/get.d.ts

@@ -0,0 +1,16 @@
+import { PreferencesCommand } from '../../../utils/preferences.js';
+import { type OrganizationPreferences } from '@salesforce/b2c-tooling-sdk';
+export default class PreferencesGlobalGet extends PreferencesCommand<typeof PreferencesGlobalGet> {
+    static args: {
+        'group-id': import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'instance-type': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'mask-passwords': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        expand: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<OrganizationPreferences>;
+}

package/dist/commands/preferences/global/get.js

@@ -0,0 +1,53 @@
+/*
+ * 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, ux } from '@oclif/core';
+import { PreferencesCommand, instanceTypeFlag, maskPasswordsFlag } from '../../../utils/preferences.js';
+import { getApiErrorMessage, } from '@salesforce/b2c-tooling-sdk';
+import { t, withDocs } from '../../../i18n/index.js';
+export default class PreferencesGlobalGet extends PreferencesCommand {
+    static args = {
+        'group-id': Args.string({
+            description: 'Preference group ID',
+            required: true,
+        }),
+    };
+    static description = withDocs(t('commands.preferences.global.get.description', 'Read custom preferences in a global preference group for a given instance type'), '/cli/preferences.html#get-global');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> CustomGroupId --tenant-id zzxy_prd',
+        '<%= config.bin %> <%= command.id %> CustomGroupId --instance-type staging --tenant-id zzxy_prd',
+        '<%= config.bin %> <%= command.id %> CustomGroupId --tenant-id zzxy_prd --expand sites',
+    ];
+    static flags = {
+        'instance-type': instanceTypeFlag,
+        'mask-passwords': maskPasswordsFlag,
+        expand: Flags.string({
+            description: 'Expand option ("sites" returns site-specific values)',
+            options: ['sites'],
+        }),
+    };
+    async run() {
+        this.requireOAuthCredentials();
+        const { 'group-id': groupId } = this.args;
+        const { 'instance-type': instanceType, 'mask-passwords': maskPasswords, expand } = this.flags;
+        const organizationId = this.getOrganizationId();
+        const result = await this.preferencesClient.GET('/organizations/{organizationId}/global-preference-groups/{groupId}/{instanceType}', {
+            params: {
+                path: { organizationId, groupId, instanceType: instanceType },
+                query: { maskPasswords, expand: expand ? [expand] : undefined },
+            },
+        });
+        if (!result.data) {
+            const message = getApiErrorMessage(result.error, result.response);
+            this.error(t('commands.preferences.global.get.error', 'Failed to read global preference group: {{message}}', { message }));
+        }
+        if (this.jsonEnabled())
+            return result.data;
+        ux.stdout(JSON.stringify(result.data, null, 2) + '\n');
+        return result.data;
+    }
+}
+//# sourceMappingURL=get.js.map

package/dist/commands/preferences/global/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../../src/commands/preferences/global/get.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAC,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAC,kBAAkB,EAAE,gBAAgB,EAAE,iBAAiB,EAAC,MAAM,+BAA+B,CAAC;AACtG,OAAO,EACL,kBAAkB,GAGnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAC,CAAC,EAAE,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAEnD,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,kBAA+C;IAC/F,MAAM,CAAC,IAAI,GAAG;QACZ,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;YACtB,WAAW,EAAE,qBAAqB;YAClC,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAC;IAEF,MAAM,CAAC,WAAW,GAAG,QAAQ,CAC3B,CAAC,CACC,6CAA6C,EAC7C,gFAAgF,CACjF,EACD,kCAAkC,CACnC,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG;QAChB,wEAAwE;QACxE,gGAAgG;QAChG,uFAAuF;KACxF,CAAC;IAEF,MAAM,CAAC,KAAK,GAAG;QACb,eAAe,EAAE,gBAAgB;QACjC,gBAAgB,EAAE,iBAAiB;QACnC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,WAAW,EAAE,sDAAsD;YACnE,OAAO,EAAE,CAAC,OAAO,CAAC;SACnB,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAE/B,MAAM,EAAC,UAAU,EAAE,OAAO,EAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QACxC,MAAM,EAAC,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,EAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QAC5F,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEhD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAC7C,mFAAmF,EACnF;YACE,MAAM,EAAE;gBACN,IAAI,EAAE,EAAC,cAAc,EAAE,OAAO,EAAE,YAAY,EAAE,YAAsC,EAAC;gBACrF,KAAK,EAAE,EAAC,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,EAAC;aACzE;SACF,CACF,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YAClE,IAAI,CAAC,KAAK,CACR,CAAC,CAAC,uCAAuC,EAAE,qDAAqD,EAAE,EAAC,OAAO,EAAC,CAAC,CAC7G,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC;QAE3C,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACvD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC"}

package/dist/commands/preferences/global/list.d.ts

@@ -0,0 +1,15 @@
+import { PreferencesCommand } from '../../../utils/preferences.js';
+import { type CustomPreferenceList } from '@salesforce/b2c-tooling-sdk';
+export default class PreferencesGlobalList extends PreferencesCommand<typeof PreferencesGlobalList> {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        columns: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        extended: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        offset: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'mask-password': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<CustomPreferenceList>;
+}

package/dist/commands/preferences/global/list.js

@@ -0,0 +1,80 @@
+/*
+ * 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, ux } from '@oclif/core';
+import { PreferencesCommand } from '../../../utils/preferences.js';
+import { TableRenderer, columnFlagsFor, selectColumns } from '@salesforce/b2c-tooling-sdk/cli';
+import { getApiErrorMessage } from '@salesforce/b2c-tooling-sdk';
+import { t, withDocs } from '../../../i18n/index.js';
+const COLUMNS = {
+    id: { header: 'ID', get: (p) => p.id || '-' },
+    value: { header: 'Value', get: (p) => formatValue(p.value) },
+    groupId: { header: 'Group ID', get: (p) => p.groupId || '-', extended: true },
+};
+const DEFAULT_COLUMNS = ['id', 'value'];
+const tableRenderer = new TableRenderer(COLUMNS);
+function formatValue(value) {
+    if (value === null || value === undefined)
+        return '-';
+    if (typeof value === 'object')
+        return JSON.stringify(value);
+    return String(value);
+}
+export default class PreferencesGlobalList extends PreferencesCommand {
+    static description = withDocs(t('commands.preferences.global.list.description', 'List global custom preferences for the organization'), '/cli/preferences.html#list-global');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --tenant-id zzxy_prd',
+        '<%= config.bin %> <%= command.id %> --tenant-id zzxy_prd --limit 50',
+        '<%= config.bin %> <%= command.id %> --tenant-id zzxy_prd --extended',
+        '<%= config.bin %> <%= command.id %> --tenant-id zzxy_prd --json',
+    ];
+    static flags = {
+        limit: Flags.integer({
+            char: 'l',
+            description: 'Maximum number of results (1-200)',
+            default: 200,
+            min: 1,
+            max: 200,
+        }),
+        offset: Flags.integer({
+            char: 'o',
+            description: 'Result offset for pagination',
+            default: 0,
+            min: 0,
+        }),
+        'mask-password': Flags.boolean({
+            description: 'Mask values of type password',
+            default: false,
+            allowNo: true,
+        }),
+        ...columnFlagsFor(COLUMNS),
+    };
+    async run() {
+        this.requireOAuthCredentials();
+        const { limit, offset, 'mask-password': maskPassword } = this.flags;
+        const organizationId = this.getOrganizationId();
+        const result = await this.preferencesClient.GET('/organizations/{organizationId}/global-custom-preferences', {
+            params: {
+                path: { organizationId },
+                query: { limit, offset, maskPassword },
+            },
+        });
+        if (!result.data) {
+            const message = getApiErrorMessage(result.error, result.response);
+            this.error(t('commands.preferences.global.list.error', 'Failed to list global custom preferences: {{message}}', { message }));
+        }
+        if (this.jsonEnabled())
+            return result.data;
+        const data = result.data.data || [];
+        ux.stdout('\n');
+        tableRenderer.render(data, selectColumns(this.flags, tableRenderer, DEFAULT_COLUMNS, this.warn.bind(this)));
+        ux.stdout(t('commands.preferences.global.list.total', '\nTotal: {{total}} preferences\n', {
+            total: result.data.total ?? data.length,
+        }));
+        return result.data;
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/preferences/global/list.js.map

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

package/dist/commands/preferences/global/update.d.ts

@@ -0,0 +1,18 @@
+import { PreferencesCommand } from '../../../utils/preferences.js';
+import { type OrganizationPreferences } from '@salesforce/b2c-tooling-sdk';
+export default class PreferencesGlobalUpdate extends PreferencesCommand<typeof PreferencesGlobalUpdate> {
+    static args: {
+        'group-id': import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'instance-type': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        body: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'mask-passwords': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    static strict: boolean;
+    run(): Promise<OrganizationPreferences>;
+}

package/dist/commands/preferences/global/update.js

@@ -0,0 +1,102 @@
+/*
+ * 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 fs from 'node:fs';
+import { Args, Flags, ux } from '@oclif/core';
+import { PreferencesCommand, buildAssignmentMap, instanceTypeFlag, maskPasswordsFlag, } from '../../../utils/preferences.js';
+import { getApiErrorMessage, } from '@salesforce/b2c-tooling-sdk';
+import { t, withDocs } from '../../../i18n/index.js';
+export default class PreferencesGlobalUpdate extends PreferencesCommand {
+    static args = {
+        'group-id': Args.string({
+            description: 'Preference group ID',
+            required: true,
+        }),
+    };
+    static description = withDocs(t('commands.preferences.global.update.description', 'Update custom preferences in a global preference group. Pass attribute assignments (KEY=value, KEY:=json, KEY=@file, KEY:=@file, KEY=) or use --file/--body for bulk edits.'), '/cli/preferences.html#update-global');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> CustomGroupId c_name=hello c_count:=5 c_on:=true --tenant-id zzxy_prd',
+        '<%= config.bin %> <%= command.id %> CustomGroupId -I staging c_count:=5 --tenant-id zzxy_prd',
+        '<%= config.bin %> <%= command.id %> CustomGroupId c_temp= --tenant-id zzxy_prd',
+        '<%= config.bin %> <%= command.id %> CustomGroupId --file prefs.json --tenant-id zzxy_prd',
+    ];
+    static flags = {
+        'instance-type': instanceTypeFlag,
+        file: Flags.string({
+            char: 'f',
+            description: 'JSON file with preferences body. Custom attributes use the "c_" prefix.',
+            exclusive: ['body'],
+        }),
+        body: Flags.string({
+            description: 'Inline JSON body with preferences. Custom attributes use the "c_" prefix.',
+            exclusive: ['file'],
+        }),
+        'mask-passwords': maskPasswordsFlag,
+    };
+    // Allow variadic KEY=value / KEY:=json assignments after <group-id>.
+    static strict = false;
+    async run() {
+        this.requireOAuthCredentials();
+        const { 'group-id': groupId } = this.args;
+        const { 'instance-type': instanceType, file, body, 'mask-passwords': maskPasswords } = this.flags;
+        const organizationId = this.getOrganizationId();
+        // Variadic assignments are everything in argv after the group-id positional.
+        const { argv } = await this.parse(PreferencesGlobalUpdate);
+        const assignments = argv.slice(1);
+        const haveAssignments = assignments.length > 0;
+        if (haveAssignments && (file || body)) {
+            this.error(t('commands.preferences.assignmentsAndBodyExclusive', 'Provide either KEY=value assignments or --file/--body, not both.'));
+        }
+        if (!haveAssignments && !file && !body) {
+            this.error(t('commands.preferences.bodyRequired', 'Provide KEY=value assignments or --file/--body with the preferences to update.'));
+        }
+        let requestBody;
+        if (haveAssignments) {
+            try {
+                requestBody = buildAssignmentMap(assignments);
+            }
+            catch (error) {
+                this.error(error.message);
+            }
+        }
+        else {
+            let raw;
+            if (file) {
+                if (!fs.existsSync(file)) {
+                    this.error(t('commands.preferences.fileNotFound', 'File not found: {{file}}', { file }));
+                }
+                raw = fs.readFileSync(file, 'utf8');
+            }
+            else {
+                raw = body;
+            }
+            try {
+                requestBody = JSON.parse(raw);
+            }
+            catch {
+                this.error(t('commands.preferences.parseError', 'Failed to parse JSON body'));
+            }
+        }
+        const result = await this.preferencesRwClient.PATCH('/organizations/{organizationId}/global-preference-groups/{groupId}/{instanceType}', {
+            params: {
+                path: { organizationId, groupId, instanceType: instanceType },
+                query: { maskPasswords },
+            },
+            body: requestBody,
+        });
+        if (!result.data) {
+            const message = getApiErrorMessage(result.error, result.response);
+            this.error(t('commands.preferences.global.update.error', 'Failed to update global preference group: {{message}}', {
+                message,
+            }));
+        }
+        if (this.jsonEnabled())
+            return result.data;
+        ux.stdout(JSON.stringify(result.data, null, 2) + '\n');
+        return result.data;
+    }
+}
+//# sourceMappingURL=update.js.map