@salesforce/b2c-tooling-sdk 2.2.0 → 2.4.0

package/dist/esm/ux/confirm.d.ts

@@ -1,14 +1,41 @@
 export interface ConfirmOptions {
     /** Default to yes when the user presses Enter without typing. Defaults to false (no). */
     defaultYes?: boolean;
+    /**
+     * Behavior when prompting is not possible (no TTY on stdin, or an AI agent
+     * is driving the process):
+     *
+     * - `'error'` (default): throw {@link ConfirmationRequiredError} so the
+     *   command fails fast with a non-zero exit instead of hanging
+     * - `'default'`: resolve to the default answer (`defaultYes`) without prompting
+     */
+    nonInteractive?: 'default' | 'error';
+}
+/**
+ * Thrown by {@link confirm} when a confirmation is required but cannot be
+ * prompted for. Callers should skip the prompt with an explicit flag
+ * (typically `--force` or `--yes`).
+ */
+export declare class ConfirmationRequiredError extends Error {
+    /** The confirmation message that could not be prompted. */
+    readonly prompt: string;
+    readonly code = "CONFIRMATION_REQUIRED";
+    constructor(
+    /** The confirmation message that could not be prompted. */
+    prompt: string);
 }
 /**
  * Simple yes/no confirmation prompt.
  *
  * Output goes to stderr so it doesn't interfere with structured stdout output.
  *
+ * When prompting is not possible (stdin is not a TTY, or an AI agent is
+ * detected), this throws {@link ConfirmationRequiredError} by default rather
+ * than waiting on input that will never arrive. See {@link ConfirmOptions.nonInteractive}.
+ *
  * @param message - Prompt message (the hint is appended automatically)
  * @param options - Options to control default behavior
  * @returns true if user confirmed, false otherwise
+ * @throws ConfirmationRequiredError when prompting is not possible and `nonInteractive` is `'error'`
  */
 export declare function confirm(message: string, options?: ConfirmOptions): Promise<boolean>;

package/dist/esm/ux/confirm.js

@@ -4,17 +4,49 @@
  * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
  */
 import * as readline from 'node:readline';
+import { getAgentContext, isInteractive } from './agent-context.js';
+/**
+ * Thrown by {@link confirm} when a confirmation is required but cannot be
+ * prompted for. Callers should skip the prompt with an explicit flag
+ * (typically `--force` or `--yes`).
+ */
+export class ConfirmationRequiredError extends Error {
+    prompt;
+    code = 'CONFIRMATION_REQUIRED';
+    constructor(
+    /** The confirmation message that could not be prompted. */
+    prompt) {
+        const agent = getAgentContext().harness;
+        const reason = agent
+            ? `running under an AI agent (${agent.name}), so interactive prompts are disabled`
+            : 'no interactive terminal is available';
+        super(`Confirmation required but ${reason}:\n  ${prompt.trim()}\n` +
+            `Re-run with the command's --force (or --yes) flag to proceed without prompting.`);
+        this.prompt = prompt;
+        this.name = 'ConfirmationRequiredError';
+    }
+}
 /**
  * Simple yes/no confirmation prompt.
  *
  * Output goes to stderr so it doesn't interfere with structured stdout output.
  *
+ * When prompting is not possible (stdin is not a TTY, or an AI agent is
+ * detected), this throws {@link ConfirmationRequiredError} by default rather
+ * than waiting on input that will never arrive. See {@link ConfirmOptions.nonInteractive}.
+ *
  * @param message - Prompt message (the hint is appended automatically)
  * @param options - Options to control default behavior
  * @returns true if user confirmed, false otherwise
+ * @throws ConfirmationRequiredError when prompting is not possible and `nonInteractive` is `'error'`
  */
 export async function confirm(message, options) {
     const defaultYes = options?.defaultYes ?? false;
+    if (!isInteractive()) {
+        if (options?.nonInteractive === 'default')
+            return defaultYes;
+        throw new ConfirmationRequiredError(message);
+    }
     const hint = defaultYes ? '(Y/n)' : '(y/N)';
     const rl = readline.createInterface({
         input: process.stdin,

package/dist/esm/ux/confirm.js.map

@@ -1 +1 @@
-{"version":3,"file":"confirm.js","sourceRoot":"","sources":["../../../src/ux/confirm.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAO1C;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAe,EAAE,OAAwB;IACrE,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,KAAK,CAAC;IAChD,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAE5C,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,EAAE,CAAC,QAAQ,CAAC,GAAG,OAAO,IAAI,IAAI,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE;YAC5C,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC/C,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;gBACtB,OAAO,CAAC,UAAU,CAAC,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,KAAK,CAAC,CAAC;YACtD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"confirm.js","sourceRoot":"","sources":["../../../src/ux/confirm.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAC,eAAe,EAAE,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAgBlE;;;;GAIG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAKvC;IAJF,IAAI,GAAG,uBAAuB,CAAC;IAExC;IACE,2DAA2D;IAClD,MAAc;QAEvB,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC,OAAO,CAAC;QACxC,MAAM,MAAM,GAAG,KAAK;YAClB,CAAC,CAAC,8BAA8B,KAAK,CAAC,IAAI,wCAAwC;YAClF,CAAC,CAAC,sCAAsC,CAAC;QAC3C,KAAK,CACH,6BAA6B,MAAM,QAAQ,MAAM,CAAC,IAAI,EAAE,IAAI;YAC1D,iFAAiF,CACpF,CAAC;QATO,WAAM,GAAN,MAAM,CAAQ;QAUvB,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAe,EAAE,OAAwB;IACrE,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,KAAK,CAAC;IAEhD,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;QACrB,IAAI,OAAO,EAAE,cAAc,KAAK,SAAS;YAAE,OAAO,UAAU,CAAC;QAC7D,MAAM,IAAI,yBAAyB,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAE5C,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,EAAE,CAAC,QAAQ,CAAC,GAAG,OAAO,IAAI,IAAI,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE;YAC5C,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC/C,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;gBACtB,OAAO,CAAC,UAAU,CAAC,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,KAAK,CAAC,CAAC;YACtD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/ux/index.d.ts

@@ -1 +1,2 @@
-export { confirm, type ConfirmOptions } from './confirm.js';
+export { confirm, ConfirmationRequiredError, type ConfirmOptions } from './confirm.js';
+export { agentDetectors, detectAgentContext, getAgentContext, isInteractive, resetAgentContext, type AgentContext, type AgentDetector, type AgentEnvironment, type AgentHarness, type AgentMatch, } from './agent-context.js';

package/dist/esm/ux/index.js

@@ -3,5 +3,6 @@
  * 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
  */
-export { confirm } from './confirm.js';
+export { confirm, ConfirmationRequiredError } from './confirm.js';
+export { agentDetectors, detectAgentContext, getAgentContext, isInteractive, resetAgentContext, } from './agent-context.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/ux/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ux/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,OAAO,EAAsB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ux/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,OAAO,EAAE,yBAAyB,EAAsB,MAAM,cAAc,CAAC;AACrF,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,iBAAiB,GAMlB,MAAM,oBAAoB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/b2c-tooling-sdk",
   "description": "Core tooling library for Salesforce B2C Commerce CLI",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "author": "Charles Lavery",
   "license": "Apache-2.0",
   "repository": "SalesforceCommerceCloud/b2c-developer-tooling",
@@ -28,6 +28,7 @@
       "default": "./dist/esm/scapi/index.js"
     },
     "./package.json": "./package.json",
+    "./schemas/dw.schema.json": "./data/schemas/dw.schema.json",
     ".": {
       "types": "./dist/esm/index.d.ts",
       "default": "./dist/esm/index.js"
@@ -64,6 +65,10 @@
       "types": "./dist/esm/schemas/index.d.ts",
       "default": "./dist/esm/schemas/index.js"
     },
+    "./openshell": {
+      "types": "./dist/esm/openshell/index.d.ts",
+      "default": "./dist/esm/openshell/index.js"
+    },
     "./operations/logs": {
       "types": "./dist/esm/operations/logs/index.d.ts",
       "default": "./dist/esm/operations/logs/index.js"
@@ -294,6 +299,8 @@
     "check:guides-links": "tsx scripts/check-guides-links.ts",
     "generate:tooling-index": "tsx scripts/generate-tooling-index.ts",
     "check:tooling-index": "tsx scripts/generate-tooling-index.ts --check",
+    "generate:dw-json-schema": "tsx scripts/generate-dw-json-schema.ts",
+    "check:dw-json-schema": "tsx scripts/generate-dw-json-schema.ts --check",
     "generate:help-corpus": "tsx scripts/generate-help-corpus.ts",
     "enrich:docs": "tsx scripts/enrich-docs.ts"
   }

package/specs/slas-shopper-v1.yaml

@@ -42,12 +42,13 @@ paths:
               type: object
               required: [grant_type, channel_id]
               properties:
-                grant_type: {type: string, enum: [client_credentials, authorization_code_pkce]}
+                grant_type: {type: string, enum: [client_credentials, authorization_code_pkce, refresh_token]}
                 channel_id: {type: string}
                 client_id: {type: string}
                 code: {type: string}
                 code_verifier: {type: string}
                 redirect_uri: {type: string}
+                refresh_token: {type: string}
                 usid: {type: string}
       responses:
         '200':