@salesforce/b2c-cli 1.15.0 → 1.16.1

package/dist/commands/cip/report/search-query-performance.d.ts

@@ -1,10 +1,12 @@
 import { CipReportCommand } from '../../../utils/cip/report-command.js';
+/**
+ * `b2c cip report search-query-performance` — flags are auto-derived from the catalog
+ * definition; param parsing/validation lives in {@link CipReportCommand} and the SDK.
+ */
 export default class CipReportSearchQueryPerformance extends CipReportCommand<typeof CipReportSearchQueryPerformance> {
     static description: string;
     static enableJsonFlag: boolean;
     static flags: {
-        'has-results': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'site-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         describe: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         sql: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'cip-host': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
@@ -37,5 +39,4 @@ export default class CipReportSearchQueryPerformance extends CipReportCommand<ty
         'extra-headers': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     protected readonly reportName = "search-query-performance";
-    protected getReportParams(): Record<string, string>;
 }

package/dist/commands/cip/report/search-query-performance.js

@@ -3,33 +3,22 @@
  * 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 { withDocs } from '../../../i18n/index.js';
 import { CipReportCommand } from '../../../utils/cip/report-command.js';
-import { createSiteIdFlag } from '../../../utils/cip/report-flags.js';
+import { buildReportFlags, requireReport } from '../../../utils/cip/report-flags.js';
+const REPORT_NAME = 'search-query-performance';
+/**
+ * `b2c cip report search-query-performance` — flags are auto-derived from the catalog
+ * definition; param parsing/validation lives in {@link CipReportCommand} and the SDK.
+ */
 export default class CipReportSearchQueryPerformance extends CipReportCommand {
     static description = withDocs('Identify search terms driving revenue and conversion', '/cli/cip.html#b2c-cip-report-search-query-performance');
     static enableJsonFlag = true;
     static flags = {
         ...CipReportCommand.baseFlags,
         ...CipReportCommand.reportFlags,
-        'has-results': Flags.string({
-            description: 'Filter by result-bearing searches',
-            helpGroup: 'QUERY',
-            options: ['false', 'true'],
-            required: false,
-        }),
-        'site-id': createSiteIdFlag(),
+        ...buildReportFlags(requireReport(REPORT_NAME)),
     };
-    reportName = 'search-query-performance';
-    getReportParams() {
-        if (!this.flags['has-results']) {
-            this.error('--has-results is required for this report. Use true or false.');
-        }
-        return {
-            ...this.getBaseReportParams(),
-            hasResults: this.flags['has-results'],
-        };
-    }
+    reportName = REPORT_NAME;
 }
 //# sourceMappingURL=search-query-performance.js.map

package/dist/commands/cip/report/search-query-performance.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-query-performance.js","sourceRoot":"","sources":["../../../../src/commands/cip/report/search-query-performance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,KAAK,EAAC,MAAM,aAAa,CAAC;AAClC,OAAO,EAAC,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAC,gBAAgB,EAAC,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAC,gBAAgB,EAAC,MAAM,oCAAoC,CAAC;AAEpE,MAAM,CAAC,OAAO,OAAO,+BAAgC,SAAQ,gBAAwD;IACnH,MAAM,CAAC,WAAW,GAAG,QAAQ,CAC3B,sDAAsD,EACtD,uDAAuD,CACxD,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,gBAAgB,CAAC,SAAS;QAC7B,GAAG,gBAAgB,CAAC,WAAW;QAC/B,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC;YAC1B,WAAW,EAAE,mCAAmC;YAChD,SAAS,EAAE,OAAO;YAClB,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;YAC1B,QAAQ,EAAE,KAAK;SAChB,CAAC;QACF,SAAS,EAAE,gBAAgB,EAAE;KAC9B,CAAC;IAEiB,UAAU,GAAG,0BAA0B,CAAC;IAEjD,eAAe;QACvB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;QAC9E,CAAC;QAED,OAAO;YACL,GAAG,IAAI,CAAC,mBAAmB,EAAE;YAC7B,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC;SACtC,CAAC;IACJ,CAAC"}
+{"version":3,"file":"search-query-performance.js","sourceRoot":"","sources":["../../../../src/commands/cip/report/search-query-performance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAC,gBAAgB,EAAC,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAC,gBAAgB,EAAE,aAAa,EAAC,MAAM,oCAAoC,CAAC;AAEnF,MAAM,WAAW,GAAG,0BAA0B,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,+BAAgC,SAAQ,gBAAwD;IACnH,MAAM,CAAC,WAAW,GAAG,QAAQ,CAC3B,sDAAsD,EACtD,uDAAuD,CACxD,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,gBAAgB,CAAC,SAAS;QAC7B,GAAG,gBAAgB,CAAC,WAAW;QAC/B,GAAG,gBAAgB,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;KAChD,CAAC;IAEiB,UAAU,GAAG,WAAW,CAAC"}

package/dist/commands/cip/report/top-referrers.d.ts

@@ -1,10 +1,12 @@
 import { CipReportCommand } from '../../../utils/cip/report-command.js';
+/**
+ * `b2c cip report top-referrers` — flags are auto-derived from the catalog
+ * definition; param parsing/validation lives in {@link CipReportCommand} and the SDK.
+ */
 export default class CipReportTopReferrers extends CipReportCommand<typeof CipReportTopReferrers> {
     static description: string;
     static enableJsonFlag: boolean;
     static flags: {
-        limit: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'site-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         describe: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         sql: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'cip-host': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
@@ -37,5 +39,4 @@ export default class CipReportTopReferrers extends CipReportCommand<typeof CipRe
         'extra-headers': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     protected readonly reportName = "top-referrers";
-    protected getReportParams(): Record<string, string>;
 }

package/dist/commands/cip/report/top-referrers.js

@@ -5,19 +5,20 @@
  */
 import { withDocs } from '../../../i18n/index.js';
 import { CipReportCommand } from '../../../utils/cip/report-command.js';
-import { createLimitFlag, createSiteIdFlag } from '../../../utils/cip/report-flags.js';
+import { buildReportFlags, requireReport } from '../../../utils/cip/report-flags.js';
+const REPORT_NAME = 'top-referrers';
+/**
+ * `b2c cip report top-referrers` — flags are auto-derived from the catalog
+ * definition; param parsing/validation lives in {@link CipReportCommand} and the SDK.
+ */
 export default class CipReportTopReferrers extends CipReportCommand {
     static description = withDocs('Identify top traffic referrers and visit share', '/cli/cip.html#b2c-cip-report-top-referrers');
     static enableJsonFlag = true;
     static flags = {
         ...CipReportCommand.baseFlags,
         ...CipReportCommand.reportFlags,
-        limit: createLimitFlag(),
-        'site-id': createSiteIdFlag(),
+        ...buildReportFlags(requireReport(REPORT_NAME)),
     };
-    reportName = 'top-referrers';
-    getReportParams() {
-        return this.getBaseReportParams();
-    }
+    reportName = REPORT_NAME;
 }
 //# sourceMappingURL=top-referrers.js.map

package/dist/commands/cip/report/top-referrers.js.map

@@ -1 +1 @@
-{"version":3,"file":"top-referrers.js","sourceRoot":"","sources":["../../../../src/commands/cip/report/top-referrers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAC,gBAAgB,EAAC,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAC,eAAe,EAAE,gBAAgB,EAAC,MAAM,oCAAoC,CAAC;AAErF,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,gBAA8C;IAC/F,MAAM,CAAC,WAAW,GAAG,QAAQ,CAC3B,gDAAgD,EAChD,4CAA4C,CAC7C,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,gBAAgB,CAAC,SAAS;QAC7B,GAAG,gBAAgB,CAAC,WAAW;QAC/B,KAAK,EAAE,eAAe,EAAE;QACxB,SAAS,EAAE,gBAAgB,EAAE;KAC9B,CAAC;IAEiB,UAAU,GAAG,eAAe,CAAC;IAEtC,eAAe;QACvB,OAAO,IAAI,CAAC,mBAAmB,EAAE,CAAC;IACpC,CAAC"}
+{"version":3,"file":"top-referrers.js","sourceRoot":"","sources":["../../../../src/commands/cip/report/top-referrers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAC,gBAAgB,EAAC,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAC,gBAAgB,EAAE,aAAa,EAAC,MAAM,oCAAoC,CAAC;AAEnF,MAAM,WAAW,GAAG,eAAe,CAAC;AAEpC;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,gBAA8C;IAC/F,MAAM,CAAC,WAAW,GAAG,QAAQ,CAC3B,gDAAgD,EAChD,4CAA4C,CAC7C,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,gBAAgB,CAAC,SAAS;QAC7B,GAAG,gBAAgB,CAAC,WAAW;QAC/B,GAAG,gBAAgB,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;KAChD,CAAC;IAEiB,UAAU,GAAG,WAAW,CAAC"}

package/dist/commands/cip/report/top-selling-products.d.ts

@@ -1,9 +1,12 @@
 import { CipReportCommand } from '../../../utils/cip/report-command.js';
+/**
+ * `b2c cip report top-selling-products` — flags are auto-derived from the catalog
+ * definition; param parsing/validation lives in {@link CipReportCommand} and the SDK.
+ */
 export default class CipReportTopSellingProducts extends CipReportCommand<typeof CipReportTopSellingProducts> {
     static description: string;
     static enableJsonFlag: boolean;
     static flags: {
-        'site-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         describe: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         sql: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'cip-host': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
@@ -36,5 +39,4 @@ export default class CipReportTopSellingProducts extends CipReportCommand<typeof
         'extra-headers': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     protected readonly reportName = "top-selling-products";
-    protected getReportParams(): Record<string, string>;
 }

package/dist/commands/cip/report/top-selling-products.js

@@ -5,18 +5,20 @@
  */
 import { withDocs } from '../../../i18n/index.js';
 import { CipReportCommand } from '../../../utils/cip/report-command.js';
-import { createSiteIdFlag } from '../../../utils/cip/report-flags.js';
+import { buildReportFlags, requireReport } from '../../../utils/cip/report-flags.js';
+const REPORT_NAME = 'top-selling-products';
+/**
+ * `b2c cip report top-selling-products` — flags are auto-derived from the catalog
+ * definition; param parsing/validation lives in {@link CipReportCommand} and the SDK.
+ */
 export default class CipReportTopSellingProducts extends CipReportCommand {
     static description = withDocs('Identify top selling products across channels', '/cli/cip.html#b2c-cip-report-top-selling-products');
     static enableJsonFlag = true;
     static flags = {
         ...CipReportCommand.baseFlags,
         ...CipReportCommand.reportFlags,
-        'site-id': createSiteIdFlag(),
+        ...buildReportFlags(requireReport(REPORT_NAME)),
     };
-    reportName = 'top-selling-products';
-    getReportParams() {
-        return this.getBaseReportParams();
-    }
+    reportName = REPORT_NAME;
 }
 //# sourceMappingURL=top-selling-products.js.map

package/dist/commands/cip/report/top-selling-products.js.map

@@ -1 +1 @@
-{"version":3,"file":"top-selling-products.js","sourceRoot":"","sources":["../../../../src/commands/cip/report/top-selling-products.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAC,gBAAgB,EAAC,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAC,gBAAgB,EAAC,MAAM,oCAAoC,CAAC;AAEpE,MAAM,CAAC,OAAO,OAAO,2BAA4B,SAAQ,gBAAoD;IAC3G,MAAM,CAAC,WAAW,GAAG,QAAQ,CAC3B,+CAA+C,EAC/C,mDAAmD,CACpD,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,gBAAgB,CAAC,SAAS;QAC7B,GAAG,gBAAgB,CAAC,WAAW;QAC/B,SAAS,EAAE,gBAAgB,EAAE;KAC9B,CAAC;IAEiB,UAAU,GAAG,sBAAsB,CAAC;IAE7C,eAAe;QACvB,OAAO,IAAI,CAAC,mBAAmB,EAAE,CAAC;IACpC,CAAC"}
+{"version":3,"file":"top-selling-products.js","sourceRoot":"","sources":["../../../../src/commands/cip/report/top-selling-products.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAC,gBAAgB,EAAC,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAC,gBAAgB,EAAE,aAAa,EAAC,MAAM,oCAAoC,CAAC;AAEnF,MAAM,WAAW,GAAG,sBAAsB,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,2BAA4B,SAAQ,gBAAoD;IAC3G,MAAM,CAAC,WAAW,GAAG,QAAQ,CAC3B,+CAA+C,EAC/C,mDAAmD,CACpD,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,gBAAgB,CAAC,SAAS;QAC7B,GAAG,gBAAgB,CAAC,WAAW;QAC/B,GAAG,gBAAgB,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;KAChD,CAAC;IAEiB,UAAU,GAAG,WAAW,CAAC"}

package/dist/commands/cip/report/zero-result-searches.d.ts

@@ -0,0 +1,42 @@
+import { CipReportCommand } from '../../../utils/cip/report-command.js';
+/**
+ * `b2c cip report zero-result-searches` — flags are auto-derived from the catalog
+ * definition; param parsing/validation lives in {@link CipReportCommand} and the SDK.
+ */
+export default class CipReportZeroResultSearches extends CipReportCommand<typeof CipReportZeroResultSearches> {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static flags: {
+        describe: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        sql: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'cip-host': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        staging: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        from: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        to: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'fetch-size': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'client-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'client-secret': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'auth-scope': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'short-code': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'tenant-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'auth-methods': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'user-auth': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'account-manager-host': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'jwt-cert': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'jwt-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'jwt-passphrase': 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>;
+        jsonl: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        instance: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'project-directory': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-query': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-body': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-headers': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    protected readonly reportName = "zero-result-searches";
+}

package/dist/commands/cip/report/zero-result-searches.js

@@ -0,0 +1,24 @@
+/*
+ * 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 { withDocs } from '../../../i18n/index.js';
+import { CipReportCommand } from '../../../utils/cip/report-command.js';
+import { buildReportFlags, requireReport } from '../../../utils/cip/report-flags.js';
+const REPORT_NAME = 'zero-result-searches';
+/**
+ * `b2c cip report zero-result-searches` — flags are auto-derived from the catalog
+ * definition; param parsing/validation lives in {@link CipReportCommand} and the SDK.
+ */
+export default class CipReportZeroResultSearches extends CipReportCommand {
+    static description = withDocs('Surface search terms that most often return zero results and the demand lost to them', '/cli/cip.html#b2c-cip-report-zero-result-searches');
+    static enableJsonFlag = true;
+    static flags = {
+        ...CipReportCommand.baseFlags,
+        ...CipReportCommand.reportFlags,
+        ...buildReportFlags(requireReport(REPORT_NAME)),
+    };
+    reportName = REPORT_NAME;
+}
+//# sourceMappingURL=zero-result-searches.js.map

package/dist/commands/cip/report/zero-result-searches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zero-result-searches.js","sourceRoot":"","sources":["../../../../src/commands/cip/report/zero-result-searches.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAC,gBAAgB,EAAC,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAC,gBAAgB,EAAE,aAAa,EAAC,MAAM,oCAAoC,CAAC;AAEnF,MAAM,WAAW,GAAG,sBAAsB,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,2BAA4B,SAAQ,gBAAoD;IAC3G,MAAM,CAAC,WAAW,GAAG,QAAQ,CAC3B,sFAAsF,EACtF,mDAAmD,CACpD,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,gBAAgB,CAAC,SAAS;QAC7B,GAAG,gBAAgB,CAAC,WAAW;QAC/B,GAAG,gBAAgB,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;KAChD,CAAC;IAEiB,UAAU,GAAG,WAAW,CAAC"}

package/dist/utils/cip/report-command.d.ts

@@ -24,7 +24,13 @@ export declare abstract class CipReportCommand<T extends typeof Command> extends
     };
     protected abstract readonly reportName: string;
     protected getBaseReportParams(): Record<string, string>;
-    protected abstract getReportParams(): Record<string, string>;
+    /**
+     * Derives report params generically from the report's catalog definition by
+     * reading each parameter's kebab-cased flag. Subclasses normally do not need to
+     * override this; the SDK validates and escapes the values when building SQL.
+     * `from`/`to`/`siteId`/`limit` are handled by {@link getBaseReportParams}.
+     */
+    protected getReportParams(): Record<string, string>;
     run(): Promise<CipReportDescribeOutput | CipReportQueryOutput | CipReportSqlOutput>;
     private describeReport;
     private getReportDefinition;

package/dist/utils/cip/report-command.js

@@ -7,6 +7,7 @@ import { Command, Flags } from '@oclif/core';
 import { buildCipReportSql, executeCipReport, getCipReportByName, } from '@salesforce/b2c-tooling-sdk';
 import { CipCommand } from './command.js';
 import { renderTable, writeCsv, writeJson } from './format.js';
+import { paramNameToFlag } from './report-flags.js';
 import { ux } from '@oclif/core';
 function camelToKebab(str) {
     return str.replaceAll(/[A-Z]/gu, (match) => `-${match.toLowerCase()}`);
@@ -44,6 +45,41 @@ export class CipReportCommand extends CipCommand {
         }
         return params;
     }
+    /**
+     * Derives report params generically from the report's catalog definition by
+     * reading each parameter's kebab-cased flag. Subclasses normally do not need to
+     * override this; the SDK validates and escapes the values when building SQL.
+     * `from`/`to`/`siteId`/`limit` are handled by {@link getBaseReportParams}.
+     */
+    getReportParams() {
+        const params = this.getBaseReportParams();
+        const report = getCipReportByName(this.reportName);
+        if (!report) {
+            return params;
+        }
+        const flags = this.flags;
+        for (const parameter of report.parameters) {
+            if (['from', 'limit', 'siteId', 'to'].includes(parameter.name)) {
+                continue;
+            }
+            const value = flags[paramNameToFlag(parameter.name)];
+            if (Array.isArray(value)) {
+                if (value.length > 0) {
+                    params[parameter.name] = value.map(String).join(',');
+                }
+            }
+            else if (typeof value === 'number') {
+                params[parameter.name] = String(value);
+            }
+            else if (typeof value === 'string' && value.length > 0) {
+                params[parameter.name] = value;
+            }
+            else if (typeof value === 'boolean') {
+                params[parameter.name] = String(value);
+            }
+        }
+        return params;
+    }
     async run() {
         this.validateCipAuthMethods();
         const report = this.getReportDefinition();

package/dist/utils/cip/report-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"report-command.js","sourceRoot":"","sources":["../../../src/utils/cip/report-command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"report-command.js","sourceRoot":"","sources":["../../../src/utils/cip/report-command.ts"],"names":[],"mappings":"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"}

package/dist/utils/cip/report-flags.d.ts

@@ -1,3 +1,5 @@
+import { type Interfaces } from '@oclif/core';
+import { type CipReportDefinition } from '@salesforce/b2c-tooling-sdk';
 interface SiteIdFlagOptions {
     required?: boolean;
 }
@@ -5,6 +7,19 @@ interface LimitFlagOptions {
     max?: number;
     min?: number;
 }
-export declare function createSiteIdFlag(options?: SiteIdFlagOptions): import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-export declare function createLimitFlag(options?: LimitFlagOptions): import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+/** Converts a camelCase report parameter name to its kebab-case CLI flag name. */
+export declare function paramNameToFlag(name: string): string;
+export declare function createSiteIdFlag(options?: SiteIdFlagOptions): Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+export declare function createLimitFlag(options?: LimitFlagOptions): Interfaces.OptionFlag<number | undefined, Interfaces.CustomOptions>;
+/**
+ * Builds the oclif flag map for a report's own parameters from its catalog
+ * definition, excluding `from`/`to` which are handled by the base command. `siteId`
+ * is mapped to the shared `--site-id` flag. Returns flags keyed by kebab-cased name.
+ */
+export declare function buildReportFlags(report: CipReportDefinition): Interfaces.FlagInput;
+/**
+ * Resolves a report definition by name or throws — used by per-command files at
+ * module load to fail loudly if a report name does not exist in the catalog.
+ */
+export declare function requireReport(reportName: string): CipReportDefinition;
 export {};

package/dist/utils/cip/report-flags.js

@@ -4,6 +4,11 @@
  * 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 { getCipReportByName } from '@salesforce/b2c-tooling-sdk';
+/** Converts a camelCase report parameter name to its kebab-case CLI flag name. */
+export function paramNameToFlag(name) {
+    return name.replaceAll(/[A-Z]/gu, (match) => `-${match.toLowerCase()}`);
+}
 export function createSiteIdFlag(options = {}) {
     return Flags.string({
         description: 'Site ID parameter for CIP report filters',
@@ -20,4 +25,69 @@ export function createLimitFlag(options = {}) {
         required: false,
     });
 }
+/**
+ * Maps a single report parameter definition to an oclif flag.
+ *
+ * `from`/`to` are intentionally skipped because they are already provided by
+ * {@link CipCommand.baseFlags}; callers should exclude them. Number params become
+ * range-checked integer flags, enum params become string flags with `options`, and
+ * `multiple` params accept repeated values.
+ */
+function paramToFlag(parameter) {
+    // Report params are intentionally NOT marked oclif-required even when the catalog
+    // marks them required: the SDK's validateReportParams enforces required-ness when
+    // building SQL, and `--describe` / metadata flows must run without supplying them.
+    // Making them oclif-required would break `cip report <name> --describe`.
+    const common = {
+        description: parameter.description,
+        helpGroup: 'QUERY',
+        required: false,
+    };
+    if (parameter.type === 'number') {
+        return Flags.integer({
+            ...common,
+            ...(parameter.min === undefined ? {} : { min: parameter.min }),
+            ...(parameter.max === undefined ? {} : { max: parameter.max }),
+        });
+    }
+    // string / boolean / date all surface as string flags; the SDK validates and
+    // escapes the value when building SQL. Enum params constrain to their options.
+    const options = parameter.options && parameter.options.length > 0 ? parameter.options : undefined;
+    if (parameter.multiple) {
+        return Flags.string({ ...common, multiple: true, ...(options ? { options } : {}) });
+    }
+    return Flags.string({ ...common, ...(options ? { options } : {}) });
+}
+/**
+ * Builds the oclif flag map for a report's own parameters from its catalog
+ * definition, excluding `from`/`to` which are handled by the base command. `siteId`
+ * is mapped to the shared `--site-id` flag. Returns flags keyed by kebab-cased name.
+ */
+export function buildReportFlags(report) {
+    const flags = {};
+    for (const parameter of report.parameters) {
+        if (parameter.name === 'from' || parameter.name === 'to') {
+            continue;
+        }
+        if (parameter.name === 'siteId') {
+            // Not oclif-required; the SDK validates required-ness at SQL-build time so
+            // `--describe` works without a site id (matches the historical behavior).
+            flags['site-id'] = createSiteIdFlag({ required: false });
+            continue;
+        }
+        flags[paramNameToFlag(parameter.name)] = paramToFlag(parameter);
+    }
+    return flags;
+}
+/**
+ * Resolves a report definition by name or throws — used by per-command files at
+ * module load to fail loudly if a report name does not exist in the catalog.
+ */
+export function requireReport(reportName) {
+    const report = getCipReportByName(reportName);
+    if (!report) {
+        throw new Error(`Unknown CIP report referenced by command: ${reportName}`);
+    }
+    return report;
+}
 //# sourceMappingURL=report-flags.js.map

package/dist/utils/cip/report-flags.js.map

@@ -1 +1 @@
-{"version":3,"file":"report-flags.js","sourceRoot":"","sources":["../../../src/utils/cip/report-flags.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,KAAK,EAAC,MAAM,aAAa,CAAC;AAWlC,MAAM,UAAU,gBAAgB,CAAC,UAA6B,EAAE;IAC9D,OAAO,KAAK,CAAC,MAAM,CAAC;QAClB,WAAW,EAAE,0CAA0C;QACvD,SAAS,EAAE,OAAO;QAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;KACpC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,UAA4B,EAAE;IAC5D,OAAO,KAAK,CAAC,OAAO,CAAC;QACnB,WAAW,EAAE,wBAAwB;QACrC,SAAS,EAAE,OAAO;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG;QACvB,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QACrB,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"report-flags.js","sourceRoot":"","sources":["../../../src/utils/cip/report-flags.ts"],"names":[],"mappings":"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"}