@salesforce/b2c-cli 1.19.0 → 1.20.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../../src/commands/preferences/global/update.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAC,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,kBAAkB,GAGnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAC,CAAC,EAAE,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAEnD,MAAM,CAAC,OAAO,OAAO,uBAAwB,SAAQ,kBAAkD;IACrG,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,gDAAgD,EAChD,6KAA6K,CAC9K,EACD,qCAAqC,CACtC,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG;QAChB,2GAA2G;QAC3G,8FAA8F;QAC9F,gFAAgF;QAChF,0FAA0F;KAC3F,CAAC;IAEF,MAAM,CAAC,KAAK,GAAG;QACb,eAAe,EAAE,gBAAgB;QACjC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,yEAAyE;YACtF,SAAS,EAAE,CAAC,MAAM,CAAC;SACpB,CAAC;QACF,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,WAAW,EAAE,2EAA2E;YACxF,SAAS,EAAE,CAAC,MAAM,CAAC;SACpB,CAAC;QACF,gBAAgB,EAAE,iBAAiB;KACpC,CAAC;IAEF,qEAAqE;IACrE,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;IAEtB,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,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,aAAa,EAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QAChG,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEhD,6EAA6E;QAC7E,MAAM,EAAC,IAAI,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QACzD,MAAM,WAAW,GAAI,IAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAChD,MAAM,eAAe,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;QAE/C,IAAI,eAAe,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,KAAK,CACR,CAAC,CACC,kDAAkD,EAClD,kEAAkE,CACnE,CACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,eAAe,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACvC,IAAI,CAAC,KAAK,CACR,CAAC,CACC,mCAAmC,EACnC,gFAAgF,CACjF,CACF,CAAC;QACJ,CAAC;QAED,IAAI,WAAoC,CAAC;QACzC,IAAI,eAAe,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,WAAW,GAAG,kBAAkB,CAAC,WAAW,CAA4B,CAAC;YAC3E,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,KAAK,CAAE,KAAe,CAAC,OAAO,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,GAAW,CAAC;YAChB,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;oBACzB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,mCAAmC,EAAE,0BAA0B,EAAE,EAAC,IAAI,EAAC,CAAC,CAAC,CAAC;gBACzF,CAAC;gBACD,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACN,GAAG,GAAG,IAAK,CAAC;YACd,CAAC;YACD,IAAI,CAAC;gBACH,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;YAC3D,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,iCAAiC,EAAE,2BAA2B,CAAC,CAAC,CAAC;YAChF,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,KAAK,CACjD,mFAAmF,EACnF;YACE,MAAM,EAAE;gBACN,IAAI,EAAE,EAAC,cAAc,EAAE,OAAO,EAAE,YAAY,EAAE,YAAsC,EAAC;gBACrF,KAAK,EAAE,EAAC,aAAa,EAAC;aACvB;YACD,IAAI,EAAE,WAAW;SAClB,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,0CAA0C,EAAE,uDAAuD,EAAE;gBACrG,OAAO;aACR,CAAC,CACH,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/site/get.d.ts

@@ -0,0 +1,16 @@
+import { PreferencesCommand } from '../../../utils/preferences.js';
+import { type SitePreferences } from '@salesforce/b2c-tooling-sdk';
+export default class PreferencesSiteGet extends PreferencesCommand<typeof PreferencesSiteGet> {
+    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>;
+        'site-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'mask-passwords': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<SitePreferences>;
+}

package/dist/commands/preferences/site/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 PreferencesSiteGet extends PreferencesCommand {
+    static args = {
+        'group-id': Args.string({
+            description: 'Preference group ID',
+            required: true,
+        }),
+    };
+    static description = withDocs(t('commands.preferences.site.get.description', 'Read custom preferences in a site preference group for a given instance type'), '/cli/preferences.html#get-site');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> CustomGroupId --site-id RefArch --tenant-id zzxy_prd',
+        '<%= config.bin %> <%= command.id %> CustomGroupId --instance-type staging --site-id RefArch --tenant-id zzxy_prd',
+    ];
+    static flags = {
+        'instance-type': instanceTypeFlag,
+        'site-id': Flags.string({
+            char: 's',
+            description: 'Site ID',
+            required: true,
+        }),
+        'mask-passwords': maskPasswordsFlag,
+    };
+    async run() {
+        this.requireOAuthCredentials();
+        const { 'group-id': groupId } = this.args;
+        const { 'instance-type': instanceType, 'site-id': siteId, 'mask-passwords': maskPasswords } = this.flags;
+        const organizationId = this.getOrganizationId();
+        const result = await this.preferencesClient.GET('/organizations/{organizationId}/site-preference-groups/{groupId}/{instanceType}', {
+            params: {
+                path: { organizationId, groupId, instanceType: instanceType },
+                query: { siteId, maskPasswords },
+            },
+        });
+        if (!result.data) {
+            const message = getApiErrorMessage(result.error, result.response);
+            this.error(t('commands.preferences.site.get.error', 'Failed to read site 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/site/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../../src/commands/preferences/site/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,EAAC,kBAAkB,EAAoD,MAAM,6BAA6B,CAAC;AAClH,OAAO,EAAC,CAAC,EAAE,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAEnD,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,kBAA6C;IAC3F,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,2CAA2C,EAC3C,8EAA8E,CAC/E,EACD,gCAAgC,CACjC,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG;QAChB,0FAA0F;QAC1F,kHAAkH;KACnH,CAAC;IAEF,MAAM,CAAC,KAAK,GAAG;QACb,eAAe,EAAE,gBAAgB;QACjC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC;YACtB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,SAAS;YACtB,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,gBAAgB,EAAE,iBAAiB;KACpC,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,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,aAAa,EAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QACvG,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEhD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAC7C,iFAAiF,EACjF;YACE,MAAM,EAAE;gBACN,IAAI,EAAE,EAAC,cAAc,EAAE,OAAO,EAAE,YAAY,EAAE,YAAsC,EAAC;gBACrF,KAAK,EAAE,EAAC,MAAM,EAAE,aAAa,EAAC;aAC/B;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,qCAAqC,EAAE,mDAAmD,EAAE,EAAC,OAAO,EAAC,CAAC,CACzG,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/site/list.d.ts

@@ -0,0 +1,16 @@
+import { PreferencesCommand } from '../../../utils/preferences.js';
+import { type CustomPreferenceList } from '@salesforce/b2c-tooling-sdk';
+export default class PreferencesSiteList extends PreferencesCommand<typeof PreferencesSiteList> {
+    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>;
+        'site-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        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/site/list.js

@@ -0,0 +1,84 @@
+/*
+ * 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 PreferencesSiteList extends PreferencesCommand {
+    static description = withDocs(t('commands.preferences.site.list.description', 'List custom preferences for a site'), '/cli/preferences.html#list-site');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --site-id RefArch --tenant-id zzxy_prd',
+        '<%= config.bin %> <%= command.id %> --site-id RefArch --limit 50 --tenant-id zzxy_prd',
+        '<%= config.bin %> <%= command.id %> --site-id RefArch --tenant-id zzxy_prd --extended',
+    ];
+    static flags = {
+        'site-id': Flags.string({
+            char: 's',
+            description: 'Site ID to list preferences for',
+            required: true,
+        }),
+        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 { 'site-id': siteId, limit, offset, 'mask-password': maskPassword } = this.flags;
+        const organizationId = this.getOrganizationId();
+        const result = await this.preferencesClient.GET('/organizations/{organizationId}/site-custom-preferences', {
+            params: {
+                path: { organizationId },
+                query: { siteId, limit, offset, maskPassword },
+            },
+        });
+        if (!result.data) {
+            const message = getApiErrorMessage(result.error, result.response);
+            this.error(t('commands.preferences.site.list.error', 'Failed to list site 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.site.list.total', '\nTotal: {{total}} preferences\n', {
+            total: result.data.total ?? data.length,
+        }));
+        return result.data;
+    }
+}
+//# sourceMappingURL=list.js.map

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

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

package/dist/commands/preferences/site/preference/get.d.ts

@@ -0,0 +1,16 @@
+import { PreferencesCommand } from '../../../../utils/preferences.js';
+import { type PreferenceValue } from '@salesforce/b2c-tooling-sdk';
+export default class PreferencesSitePreferenceGet extends PreferencesCommand<typeof PreferencesSitePreferenceGet> {
+    static args: {
+        'group-id': import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        'preference-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>;
+    };
+    run(): Promise<PreferenceValue>;
+}

package/dist/commands/preferences/site/preference/get.js

@@ -0,0 +1,52 @@
+/*
+ * 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, 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 PreferencesSitePreferenceGet extends PreferencesCommand {
+    static args = {
+        'group-id': Args.string({
+            description: 'Preference group ID',
+            required: true,
+        }),
+        'preference-id': Args.string({
+            description: 'Preference attribute ID',
+            required: true,
+        }),
+    };
+    static description = withDocs(t('commands.preferences.site.preference.get.description', 'Read a single preference value across sites in a site preference group'), '/cli/preferences.html#get-site-preference');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> CustomGroupId WapiStringAttr --tenant-id zzxy_prd',
+        '<%= config.bin %> <%= command.id %> CustomGroupId WapiStringAttr --instance-type staging --tenant-id zzxy_prd',
+    ];
+    static flags = {
+        'instance-type': instanceTypeFlag,
+        'mask-passwords': maskPasswordsFlag,
+    };
+    async run() {
+        this.requireOAuthCredentials();
+        const { 'group-id': groupId, 'preference-id': preferenceId } = this.args;
+        const { 'instance-type': instanceType, 'mask-passwords': maskPasswords } = this.flags;
+        const organizationId = this.getOrganizationId();
+        const result = await this.preferencesClient.GET('/organizations/{organizationId}/site-preference-groups/{groupId}/{instanceType}/preferences/{preferenceId}', {
+            params: {
+                path: { organizationId, groupId, instanceType: instanceType, preferenceId },
+                query: { maskPasswords },
+            },
+        });
+        if (!result.data) {
+            const message = getApiErrorMessage(result.error, result.response);
+            this.error(t('commands.preferences.site.preference.get.error', 'Failed to read site preference: {{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/site/preference/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../../../src/commands/preferences/site/preference/get.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,IAAI,EAAE,EAAE,EAAC,MAAM,aAAa,CAAC;AACrC,OAAO,EAAC,kBAAkB,EAAE,gBAAgB,EAAE,iBAAiB,EAAC,MAAM,kCAAkC,CAAC;AACzG,OAAO,EAAC,kBAAkB,EAAoD,MAAM,6BAA6B,CAAC;AAClH,OAAO,EAAC,CAAC,EAAE,QAAQ,EAAC,MAAM,2BAA2B,CAAC;AAEtD,MAAM,CAAC,OAAO,OAAO,4BAA6B,SAAQ,kBAAuD;IAC/G,MAAM,CAAC,IAAI,GAAG;QACZ,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;YACtB,WAAW,EAAE,qBAAqB;YAClC,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC;YAC3B,WAAW,EAAE,yBAAyB;YACtC,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAC;IAEF,MAAM,CAAC,WAAW,GAAG,QAAQ,CAC3B,CAAC,CACC,sDAAsD,EACtD,wEAAwE,CACzE,EACD,2CAA2C,CAC5C,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG;QAChB,uFAAuF;QACvF,+GAA+G;KAChH,CAAC;IAEF,MAAM,CAAC,KAAK,GAAG;QACb,eAAe,EAAE,gBAAgB;QACjC,gBAAgB,EAAE,iBAAiB;KACpC,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAE/B,MAAM,EAAC,UAAU,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QACvE,MAAM,EAAC,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QACpF,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEhD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAC7C,4GAA4G,EAC5G;YACE,MAAM,EAAE;gBACN,IAAI,EAAE,EAAC,cAAc,EAAE,OAAO,EAAE,YAAY,EAAE,YAAsC,EAAE,YAAY,EAAC;gBACnG,KAAK,EAAE,EAAC,aAAa,EAAC;aACvB;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,gDAAgD,EAAE,6CAA6C,EAAE,EAAC,OAAO,EAAC,CAAC,CAC9G,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/site/preference/update.d.ts

@@ -0,0 +1,19 @@
+import { PreferencesCommand } from '../../../../utils/preferences.js';
+import { type PreferenceValue } from '@salesforce/b2c-tooling-sdk';
+export default class PreferencesSitePreferenceUpdate extends PreferencesCommand<typeof PreferencesSitePreferenceUpdate> {
+    static args: {
+        'group-id': import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        'preference-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>;
+        'site-value': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, 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>;
+    };
+    run(): Promise<PreferenceValue>;
+}

package/dist/commands/preferences/site/preference/update.js

@@ -0,0 +1,107 @@
+/*
+ * 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 PreferencesSitePreferenceUpdate extends PreferencesCommand {
+    static args = {
+        'group-id': Args.string({
+            description: 'Preference group ID',
+            required: true,
+        }),
+        'preference-id': Args.string({
+            description: 'Preference attribute ID',
+            required: true,
+        }),
+    };
+    static description = withDocs(t('commands.preferences.site.preference.update.description', 'Update a single preference value across sites in a site preference group. Use repeatable --site-value SITE=val (operators: =, :=, =@file, :=@file, =) or --file/--body for bulk edits.'), '/cli/preferences.html#update-site-preference');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> CustomGroupId WapiStringAttr --site-value RefArch=hello --tenant-id zzxy_prd',
+        '<%= config.bin %> <%= command.id %> CustomGroupId c_count --site-value RefArch:=5 --site-value RefArchGlobal:=42 --tenant-id zzxy_prd',
+        '<%= config.bin %> <%= command.id %> CustomGroupId WapiStringAttr -I staging --file pref.json --tenant-id zzxy_prd',
+    ];
+    static flags = {
+        'instance-type': instanceTypeFlag,
+        'site-value': Flags.string({
+            description: 'Per-site assignment SITE=val (repeatable). Operators: =, :=, =@file, :=@file, = (null).',
+            multiple: true,
+        }),
+        file: Flags.string({
+            char: 'f',
+            description: 'JSON file with PreferenceValue body (use siteValues map keyed by site ID)',
+            exclusive: ['body'],
+        }),
+        body: Flags.string({
+            description: 'Inline JSON PreferenceValue body (use siteValues map keyed by site ID)',
+            exclusive: ['file'],
+        }),
+        'mask-passwords': maskPasswordsFlag,
+    };
+    async run() {
+        this.requireOAuthCredentials();
+        const { 'group-id': groupId, 'preference-id': preferenceId } = this.args;
+        const { 'instance-type': instanceType, 'site-value': siteValueExprs, file, body, 'mask-passwords': maskPasswords, } = this.flags;
+        const organizationId = this.getOrganizationId();
+        const haveSiteValues = Array.isArray(siteValueExprs) && siteValueExprs.length > 0;
+        if (haveSiteValues && (file || body)) {
+            this.error(t('commands.preferences.siteValueAndBodyExclusive', 'Provide either --site-value flags or --file/--body, not both.'));
+        }
+        if (!haveSiteValues && !file && !body) {
+            this.error(t('commands.preferences.bodyRequired', 'Provide --site-value flags or --file/--body with the preferences to update.'));
+        }
+        let requestBody;
+        if (haveSiteValues) {
+            try {
+                requestBody = {
+                    id: preferenceId,
+                    siteValues: buildAssignmentMap(siteValueExprs),
+                };
+            }
+            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}/site-preference-groups/{groupId}/{instanceType}/preferences/{preferenceId}', {
+            params: {
+                path: { organizationId, groupId, instanceType: instanceType, preferenceId },
+                query: { maskPasswords },
+            },
+            body: requestBody,
+        });
+        if (!result.data) {
+            const message = getApiErrorMessage(result.error, result.response);
+            this.error(t('commands.preferences.site.preference.update.error', 'Failed to update site preference: {{message}}', {
+                message,
+            }));
+        }
+        if (this.jsonEnabled())
+            return result.data;
+        ux.stdout(JSON.stringify(result.data, null, 2) + '\n');
+        return result.data;
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/preferences/site/preference/update.js.map

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

package/dist/commands/preferences/site/search.d.ts

@@ -0,0 +1,28 @@
+import { PreferencesCommand } from '../../../utils/preferences.js';
+import { type PreferenceValueSearchResult } from '@salesforce/b2c-tooling-sdk';
+export default class PreferencesSiteSearch extends PreferencesCommand<typeof PreferencesSiteSearch> {
+    static args: {
+        'group-id': import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    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>;
+        'instance-type': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'search-phrase': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'value-type': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        query: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'query-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'sort-by': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'sort-order': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        offset: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        expand: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'mask-passwords': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<PreferenceValueSearchResult>;
+    private buildSearchRequest;
+    private readFile;
+}

package/dist/commands/preferences/site/search.js

@@ -0,0 +1,177 @@
+/*
+ * 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, instanceTypeFlag, maskPasswordsFlag } 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 SEARCHABLE_FIELDS = ['id', 'displayName', 'description'];
+const VALUE_TYPE_FIELD = 'valueType';
+const SORTABLE_FIELDS = [...SEARCHABLE_FIELDS, VALUE_TYPE_FIELD];
+const COLUMNS = {
+    id: { header: 'ID', get: (p) => p.id || '-' },
+    valueType: { header: 'Type', get: (p) => p.valueType || '-' },
+    displayName: {
+        header: 'Display Name',
+        get: (p) => p.displayName?.default || Object.values(p.displayName ?? {})[0] || '-',
+    },
+    siteValues: {
+        header: 'Site Values',
+        get: (p) => (p.siteValues ? JSON.stringify(p.siteValues) : '-'),
+        extended: true,
+    },
+};
+const DEFAULT_COLUMNS = ['id', 'valueType', 'displayName'];
+const tableRenderer = new TableRenderer(COLUMNS);
+export default class PreferencesSiteSearch extends PreferencesCommand {
+    static args = {
+        'group-id': Args.string({
+            description: 'Preference group ID',
+            required: true,
+        }),
+    };
+    static description = withDocs(t('commands.preferences.site.search.description', 'Search preferences across sites in a site preference group for a given instance type'), '/cli/preferences.html#search-site');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> CustomGroupId --tenant-id zzxy_prd',
+        '<%= config.bin %> <%= command.id %> CustomGroupId --instance-type staging --search-phrase Wapi --tenant-id zzxy_prd',
+        '<%= config.bin %> <%= command.id %> CustomGroupId --value-type string --sort-by id --tenant-id zzxy_prd',
+        '<%= config.bin %> <%= command.id %> CustomGroupId --query-file query.json --tenant-id zzxy_prd',
+        '<%= config.bin %> <%= command.id %> CustomGroupId --query \'{"matchAllQuery":{}}\' --expand value --tenant-id zzxy_prd',
+    ];
+    static flags = {
+        'instance-type': instanceTypeFlag,
+        'search-phrase': Flags.string({
+            description: 'Free-text phrase searched across id, displayName, description',
+            exclusive: ['query', 'query-file'],
+        }),
+        'value-type': Flags.string({
+            description: 'Filter by valueType (combined with --search-phrase via AND)',
+            exclusive: ['query', 'query-file'],
+        }),
+        query: Flags.string({
+            description: 'Inline JSON Query body (overrides convenience flags)',
+            exclusive: ['query-file', 'search-phrase', 'value-type'],
+        }),
+        'query-file': Flags.string({
+            description: 'JSON file containing a Query body (overrides convenience flags)',
+            exclusive: ['query', 'search-phrase', 'value-type'],
+        }),
+        'sort-by': Flags.string({
+            description: 'Sort field',
+            options: SORTABLE_FIELDS,
+        }),
+        'sort-order': Flags.string({
+            description: 'Sort order',
+            options: ['asc', 'desc'],
+            default: 'asc',
+        }),
+        limit: Flags.integer({
+            char: 'l',
+            description: 'Maximum number of results (1-200)',
+            default: 25,
+            min: 1,
+            max: 200,
+        }),
+        offset: Flags.integer({
+            char: 'o',
+            description: 'Result offset for pagination',
+            default: 0,
+            min: 0,
+        }),
+        expand: Flags.string({
+            description: 'Expand option ("value" returns attribute value definitions)',
+            options: ['value'],
+        }),
+        'mask-passwords': maskPasswordsFlag,
+        ...columnFlagsFor(COLUMNS),
+    };
+    async run() {
+        this.requireOAuthCredentials();
+        const { 'group-id': groupId } = this.args;
+        const { 'instance-type': instanceType, 'search-phrase': searchPhrase, 'value-type': valueType, query: queryFlag, 'query-file': queryFile, 'sort-by': sortBy, 'sort-order': sortOrder, limit, offset, expand, 'mask-passwords': maskPasswords, } = this.flags;
+        const organizationId = this.getOrganizationId();
+        const requestBody = this.buildSearchRequest({
+            searchPhrase,
+            valueType,
+            queryFlag,
+            queryFile,
+            sortBy,
+            sortOrder,
+            limit,
+            offset,
+        });
+        const result = await this.preferencesClient.POST('/organizations/{organizationId}/site-preference-groups/{groupId}/{instanceType}/preference-search', {
+            params: {
+                path: { organizationId, groupId, instanceType: instanceType },
+                query: { maskPasswords, expand: expand ? [expand] : undefined },
+            },
+            body: requestBody,
+        });
+        if (!result.data) {
+            const message = getApiErrorMessage(result.error, result.response);
+            this.error(t('commands.preferences.site.search.error', 'Failed to search site preferences: {{message}}', { message }));
+        }
+        if (this.jsonEnabled())
+            return result.data;
+        const hits = result.data.hits || [];
+        ux.stdout('\n');
+        tableRenderer.render(hits, selectColumns(this.flags, tableRenderer, DEFAULT_COLUMNS, this.warn.bind(this)));
+        ux.stdout(t('commands.preferences.site.search.total', '\nTotal: {{total}} preferences\n', {
+            total: result.data.total ?? hits.length,
+        }));
+        return result.data;
+    }
+    buildSearchRequest(opts) {
+        const { searchPhrase, valueType, queryFlag, queryFile, sortBy, sortOrder, limit, offset } = opts;
+        let query;
+        if (queryFile || queryFlag) {
+            const raw = queryFile ? this.readFile(queryFile) : queryFlag;
+            try {
+                query = JSON.parse(raw);
+            }
+            catch {
+                this.error(t('commands.preferences.parseError', 'Failed to parse JSON body'));
+            }
+        }
+        else if (searchPhrase && valueType) {
+            query = {
+                boolQuery: {
+                    must: [
+                        { textQuery: { fields: SEARCHABLE_FIELDS, searchPhrase } },
+                        { termQuery: { fields: [VALUE_TYPE_FIELD], operator: 'is', values: [valueType] } },
+                    ],
+                },
+            };
+        }
+        else if (searchPhrase) {
+            query = {
+                textQuery: { fields: SEARCHABLE_FIELDS, searchPhrase },
+            };
+        }
+        else if (valueType) {
+            query = {
+                termQuery: { fields: [VALUE_TYPE_FIELD], operator: 'is', values: [valueType] },
+            };
+        }
+        else {
+            query = { matchAllQuery: {} };
+        }
+        const request = { query, limit, offset };
+        if (sortBy) {
+            request.sorts = [{ field: sortBy, sortOrder: sortOrder }];
+        }
+        return request;
+    }
+    readFile(path) {
+        if (!fs.existsSync(path)) {
+            this.error(t('commands.preferences.fileNotFound', 'File not found: {{file}}', { file: path }));
+        }
+        return fs.readFileSync(path, 'utf8');
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/commands/preferences/site/search.js.map

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