Merge main into branch: resolved conflict in README.md by keeping both Prompting Tips and Configuration sections

Author: yhsieh1

.changeset/code-bugfix.md

@@ -57,13 +57,13 @@ jobs:
       - name: Run SDK tests
         id: sdk-test
         working-directory: packages/b2c-tooling-sdk
-        run: pnpm run test:ci && pnpm run lint
+        run: pnpm run pretest && pnpm run test:ci && pnpm run lint
 
       - name: Run CLI tests
         id: cli-test
         if: always() && steps.sdk-test.conclusion != 'cancelled'
         working-directory: packages/b2c-cli
-        run: pnpm run test:ci && pnpm run lint
+        run: pnpm run pretest && pnpm run test:ci && pnpm run lint
 
       - name: Test Report
         uses: dorny/test-reporter@fe45e9537387dac839af0d33ba56eed8e24189e8  # v2.3.0

.changeset/doc-improvements.md

@@ -1,12 +1,12 @@
 name: e2e tests
 
 on:
-  # Nightly workflow - Run at 2 AM UTC daily
+  # Scheduled workflow
+  # 13:00 UTC ~= 8:00 AM ET (EST)
+  # 01:00 UTC ~= 8:00 PM ET (EST)
   schedule:
-    - cron: '0 2 * * *'
-  # Post-merge - Run after changes are merged to main
-  push:
-    branches: [main]
+    - cron: '0 13 * * *'
+    - cron: '0 1 * * *'
   # Manual trigger - Support workflow_dispatch for on-demand runs
   workflow_dispatch:
     inputs:
@@ -32,9 +32,10 @@ on:
         type: string
 jobs:
   e2e-tests:
+    # E2E tests run only on the current LTS Node version for stability and speed.
     strategy:
       matrix:
-        node-version: [22.x, 24.x]
+        node-version: [22.x]
     runs-on: ubuntu-latest
     environment: e2e-dev
     timeout-minutes: 25
@@ -51,8 +52,10 @@ jobs:
           TEST_REALM: ${{ vars.TEST_REALM }}
           SFCC_ACCOUNT_MANAGER_HOST: ${{ vars.SFCC_ACCOUNT_MANAGER_HOST }}
           SFCC_SANDBOX_API_HOST: ${{ vars.SFCC_SANDBOX_API_HOST }}
+          SFCC_SHORTCODE: ${{ vars.SFCC_SHORTCODE }}
+          SFCC_EXTRA_HEADERS: ${{ secrets.SFCC_EXTRA_HEADERS }}
         run: |
-          if [ -n "$SFCC_CLIENT_ID" ] && [ -n "$SFCC_CLIENT_SECRET" ] && [ -n "$TEST_REALM" ] && [ -n "$SFCC_ACCOUNT_MANAGER_HOST" ] && [ -n "$SFCC_SANDBOX_API_HOST" ]; then
+          if [ -n "$SFCC_CLIENT_ID" ] && [ -n "$SFCC_CLIENT_SECRET" ] && [ -n "$TEST_REALM" ] && [ -n "$SFCC_ACCOUNT_MANAGER_HOST" ] && [ -n "$SFCC_SANDBOX_API_HOST" ] && [ -n "$SFCC_SHORTCODE" ]; then
             echo "has-secrets=true" >> $GITHUB_OUTPUT
           else
             echo "has-secrets=false" >> $GITHUB_OUTPUT
@@ -61,6 +64,7 @@ jobs:
             echo "  - TEST_REALM (var): ${TEST_REALM:+✓}" >> $GITHUB_STEP_SUMMARY
             echo "  - SFCC_ACCOUNT_MANAGER_HOST (var): ${SFCC_ACCOUNT_MANAGER_HOST:+✓}" >> $GITHUB_STEP_SUMMARY
             echo "  - SFCC_SANDBOX_API_HOST (var): ${SFCC_SANDBOX_API_HOST:+✓}" >> $GITHUB_STEP_SUMMARY
+            echo "  - SFCC_SHORTCODE (var): ${SFCC_SHORTCODE:+✓}" >> $GITHUB_STEP_SUMMARY
           fi
       - name: Setup pnpm
         uses: pnpm/action-setup@v4
@@ -97,6 +101,8 @@ jobs:
           SFCC_ACCOUNT_MANAGER_HOST: ${{ inputs.sfcc_account_manager_host || vars.SFCC_ACCOUNT_MANAGER_HOST }}
           SFCC_SANDBOX_API_HOST: ${{ inputs.sfcc_sandbox_api_host || vars.SFCC_SANDBOX_API_HOST }}
           TEST_REALM: ${{ inputs.test_realm || vars.TEST_REALM }}
+          SFCC_SHORTCODE: ${{ vars.SFCC_SHORTCODE }}
+          SFCC_EXTRA_HEADERS: ${{ secrets.SFCC_EXTRA_HEADERS }}
           # Test configuration
           NODE_ENV: test
           SFCC_LOG_LEVEL: silent
@@ -124,7 +130,7 @@ jobs:
           retention-days: 30
 
       - name: Notify on Failure
-        if: failure() && (github.event_name == 'schedule' || github.event_name == 'push') && steps.check-secrets.outputs.has-secrets == 'true'
+        if: failure() && github.event_name == 'schedule' && steps.check-secrets.outputs.has-secrets == 'true'
         uses: actions/github-script@v7
         with:
           script: |

.changeset/log-tailing-feature.md

@@ -52,6 +52,9 @@ export default defineConfig({
   description: 'Salesforce Commerce Cloud B2C Developer Experience - CLI, MCP Server, and SDK',
   base: '/b2c-developer-tooling/',
 
+  // Ignore dead links in api-readme.md (links are valid after TypeDoc generates the API docs)
+  ignoreDeadLinks: [/^\.\/clients\//],
+
   // Show deeper heading levels in the outline
   markdown: {
     toc: { level: [2, 3, 4] },

.changeset/mrt-warnings.md

@@ -4,68 +4,98 @@ description: API reference for the B2C Tooling SDK with typed WebDAV and OCAPI c
 
 # API Reference
 
-The `@salesforce/b2c-tooling-sdk` package provides a programmatic API for interacting with Salesforce B2C Commerce instances.
+The `@salesforce/b2c-tooling-sdk` package provides TypeScript APIs for B2C Commerce development, including instance clients (WebDAV, OCAPI), platform service clients (SCAPI, SLAS, MRT, ODS), high-level operations, and developer utilities.
 
 ## Installation
 
 ```bash
 npm install @salesforce/b2c-tooling-sdk
 ```
 
-## Quick Start
+## Package Structure
+
+The SDK is organized into focused submodules that can be imported individually:
 
-### From Configuration (Recommended)
+```
+@salesforce/b2c-tooling-sdk
+├── /config          # Configuration resolution (dw.json, env vars)
+├── /auth            # Authentication strategies (OAuth, Basic, API Key)
+├── /clients         # Low-level API clients (WebDAV, OCAPI, SLAS, ODS, MRT)
+├── /logging         # Pino-based logging configuration
+│
+├── /operations/code # Code deployment, cartridge management
+├── /operations/jobs # Job execution, site archive import/export
+├── /operations/logs # Log tailing and retrieval
+├── /operations/mrt  # Managed Runtime bundle operations
+├── /operations/ods  # On-demand sandbox utilities
+│
+├── /docs            # B2C Script API documentation search
+└── /schemas         # OpenAPI schema utilities
+```
 
-Use `resolveConfig()` to load configuration from project files (dw.json) and create a B2C instance:
+Import from specific submodules to access their functionality:
 
 ```typescript
 import { resolveConfig } from '@salesforce/b2c-tooling-sdk/config';
+import { findAndDeployCartridges } from '@salesforce/b2c-tooling-sdk/operations/code';
+import { tailLogs } from '@salesforce/b2c-tooling-sdk/operations/logs';
+```
 
-// Load configuration, override secrets from environment
-const config = resolveConfig({
-  clientId: process.env.SFCC_CLIENT_ID,
-  clientSecret: process.env.SFCC_CLIENT_SECRET,
-});
+## Quick Start
 
-// Validate configuration before use
-if (!config.hasB2CInstanceConfig()) {
-  throw new Error('Missing B2C instance configuration');
-}
+### B2C Instance Operations
 
-// Create instance from validated config
-const instance = config.createB2CInstance();
+```typescript
+import { B2CInstance } from '@salesforce/b2c-tooling-sdk';
 
-// Use typed WebDAV client
-await instance.webdav.mkcol('Cartridges/v1');
-await instance.webdav.put('Cartridges/v1/app.zip', zipBuffer);
+const instance = new B2CInstance(
+  { hostname: 'your-sandbox.demandware.net', codeVersion: 'v1' },
+  { oauth: { clientId: 'your-client-id', clientSecret: 'your-client-secret' } }
+);
 
-// Use typed OCAPI client (openapi-fetch)
-const { data, error } = await instance.ocapi.GET('/sites', {
-  params: { query: { select: '(**)' } },
-});
+// Typed WebDAV client
+await instance.webdav.put('Cartridges/v1/app.zip', zipBuffer);
 
-// Check for configuration warnings
-for (const warning of config.warnings) {
-  console.warn(warning.message);
-}
+// Typed OCAPI client (openapi-fetch)
+const { data } = await instance.ocapi.GET('/sites');
 ```
 
-### Direct Construction
+### Job Execution
+
+```typescript
+import { executeJob, waitForJob } from '@salesforce/b2c-tooling-sdk/operations/jobs';
+
+const execution = await executeJob(instance, 'MyCustomJob');
+const result = await waitForJob(instance, 'MyCustomJob', execution.id!);
+```
 
-For advanced use cases, you can construct a B2CInstance directly:
+### Platform Service Clients
 
 ```typescript
-import { B2CInstance } from '@salesforce/b2c-tooling-sdk';
+import { createSlasClient, OAuthStrategy } from '@salesforce/b2c-tooling-sdk';
 
-const instance = new B2CInstance(
-  { hostname: 'your-sandbox.demandware.net', codeVersion: 'v1' },
-  {
-    oauth: {
-      clientId: 'your-client-id',
-      clientSecret: 'your-client-secret'
-    }
-  }
-);
+const auth = new OAuthStrategy({
+  clientId: 'your-client-id',
+  clientSecret: 'your-client-secret',
+});
+
+const slasClient = createSlasClient({ shortCode: 'kv7kzm78' }, auth);
+const { data } = await slasClient.GET('/tenants/{tenantId}/clients', {
+  params: { path: { tenantId: 'your-tenant' } },
+});
+```
+
+### MRT Operations
+
+```typescript
+import { pushBundle, ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk';
+
+const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!);
+const result = await pushBundle({
+  projectSlug: 'my-storefront',
+  buildDirectory: './build',
+  target: 'staging',
+}, auth);
 ```
 
 ## Configuration Resolution
@@ -105,33 +135,14 @@ if (config.hasB2CInstanceConfig()) {
 
 // Check for MRT configuration
 if (config.hasMrtConfig()) {
-  const mrtClient = config.createMrtClient({ project: 'my-project' });
+  const mrtAuth = config.createMrtAuth();
 }
 
 // Other validation methods
 config.hasOAuthConfig();      // OAuth credentials available?
 config.hasBasicAuthConfig();  // Basic auth credentials available?
 ```
 
-### Configuration Warnings
-
-The config system detects potential issues and provides warnings:
-
-```typescript
-const config = resolveConfig({
-  hostname: 'staging.demandware.net', // Different from dw.json
-});
-
-// Check warnings
-for (const warning of config.warnings) {
-  console.warn(`[${warning.code}] ${warning.message}`);
-}
-```
-
-### Hostname Protection
-
-When you explicitly override the hostname with a value that differs from dw.json, the system protects against credential leakage by ignoring the dw.json credentials. This prevents accidentally using production credentials against a staging server.
-
 ## Authentication
 
 B2CInstance supports multiple authentication methods:
@@ -169,32 +180,48 @@ When both are configured, WebDAV uses Basic auth and OCAPI uses OAuth.
 
 ## Typed Clients
 
+The SDK provides typed clients for B2C Commerce APIs. All clients use [openapi-fetch](https://openapi-ts.dev/openapi-fetch/) for full TypeScript support with type-safe paths, parameters, and responses.
+
+### Instance Clients
+
+These clients are accessed via `B2CInstance` for operations on a specific B2C Commerce instance:
+
+| Client | Description | API Reference |
+|--------|-------------|---------------|
+| [WebDavClient](./clients/classes/WebDavClient.md) | File operations (upload, download, list) | WebDAV |
+| [OcapiClient](./clients/type-aliases/OcapiClient.md) | Data API operations (sites, jobs, code versions) | [OCAPI Data API](https://developer.salesforce.com/docs/commerce/b2c-commerce/references/b2c-commerce-ocapi/b2c-api-doc.html) |
+
+### Platform Service Clients
+
+These clients are created directly for platform-wide services:
+
+| Client | Description | API Reference |
+|--------|-------------|---------------|
+| [SlasClient](./clients/type-aliases/SlasClient.md) | SLAS tenant and client management | [SLAS Admin API](https://developer.salesforce.com/docs/commerce/commerce-api/references/slas-admin?meta=Summary) |
+| [OdsClient](./clients/type-aliases/OdsClient.md) | On-demand sandbox management | [ODS REST API](https://developer.salesforce.com/docs/commerce/b2c-commerce/references/ods-rest-api?meta=Summary) |
+| [MrtClient](./clients/type-aliases/MrtClient.md) | Managed Runtime projects and deployments | [MRT Admin API](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/references/mrt-admin?meta=Summary) |
+| [MrtB2CClient](./clients/type-aliases/MrtB2CClient.md) | MRT B2C Commerce integration | [MRT B2C Config API](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/references/mrt-b2c-config?meta=Summary) |
+| [CdnZonesClient](./clients/type-aliases/CdnZonesClient.md) | eCDN zone and cache management | [CDN Zones API](https://developer.salesforce.com/docs/commerce/commerce-api/references/cdn-api-process-apis?meta=Summary) |
+| [ScapiSchemasClient](./clients/type-aliases/ScapiSchemasClient.md) | SCAPI schema discovery | [SCAPI Schemas API](https://developer.salesforce.com/docs/commerce/commerce-api/references/scapi-schemas?meta=Summary) |
+| [CustomApisClient](./clients/type-aliases/CustomApisClient.md) | Custom SCAPI endpoint status | [Custom APIs](https://developer.salesforce.com/docs/commerce/commerce-api/references/custom-apis?meta=Summary) |
+
 ### WebDAV Client
 
 ```typescript
-// Create directories
-await instance.webdav.mkcol('Cartridges/v1');
-
 // Upload files
 await instance.webdav.put('Cartridges/v1/app.zip', buffer, 'application/zip');
 
-// Download files
-const content = await instance.webdav.get('Cartridges/v1/app.zip');
-
-// List directory
+// List directory contents
 const entries = await instance.webdav.propfind('Cartridges');
 
-// Check existence
-const exists = await instance.webdav.exists('Cartridges/v1');
+// Download files
+const content = await instance.webdav.get('Cartridges/v1/app.zip');
 
-// Delete
-await instance.webdav.delete('Cartridges/v1/old-file.zip');
+// Also supports: mkcol, exists, delete, unzip, request
 ```
 
 ### OCAPI Client
 
-The OCAPI client uses [openapi-fetch](https://openapi-ts.dev/openapi-fetch/) with full TypeScript support:
-
 ```typescript
 // List sites
 const { data, error } = await instance.ocapi.GET('/sites', {