@salesforce/b2c-tooling-sdk 1.16.0 → 1.18.0

package/data/script-api/index.md

@@ -1,4 +1,4 @@
-# B2C Commerce Script API 26.2
+# B2C Commerce Script API 26.7
 
 ## Packages
 | Package | Description |
@@ -10,6 +10,7 @@
 | [dw.content](dw.content.md) | Contains classes that allow you to access content. |
 | [dw.crypto](dw.crypto.md) | Contains classes that allow you to perform cryptographic operations. |
 | [dw.customer](dw.customer.md) | Contains classes that allow you to interact with and manage Customer-related information. |
+| [dw.customer.consent](dw.customer.consent.md) |  |
 | [dw.customer.oauth](dw.customer.oauth.md) |  |
 | [dw.customer.shoppercontext](dw.customer.shoppercontext.md) |  |
 | [dw.experience](dw.experience.md) |  |

package/data/tooling/index.json

@@ -0,0 +1,222 @@
+{
+  "version": "2.0.0",
+  "generatedAt": "2026-07-08T01:12:00.365Z",
+  "entries": [
+    {
+      "id": "guide-account-manager",
+      "title": "Account Manager Guide",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/account-manager.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/account-manager.md",
+      "headings": "Authentication • Zero-Config (Default) • User Authentication (`--user-auth`) • Client Credentials • Authentication Order • Role Requirements • Setting Up Credentials • For Interactive Use • For CI/CD and Automation • Common Workflows • User Onboarding • User Offboarding • Auditing • API Client Provisioning • Bulk Operations with JSON Output • CI/CD Examples • GitHub Actions • Shell Script Automation • Troubleshooting • \"operation forbidden\" or \"authentication invalid\" • \"No valid auth method available\" • Redirect URL errors with `--user-auth` • Next Steps",
+      "preview": "Manage Account Manager users, roles, organizations, and API clients with the B2C CLI, including authentication options, CI/CD automation, and common workflows."
+    },
+    {
+      "id": "guide-agent-skills",
+      "title": "Agent Skills & Plugins",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/agent-skills.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/agent-skills.md",
+      "headings": "Quick Start • Available Plugins • Claude Code • Codex • Cursor • Skill Discovery Locations • Install with the B2C CLI • Reuse Claude Code Plugin Installs • Copilot • Copilot (VS Code) • Copilot CLI • B2C CLI • Agentforce Vibes • Other IDEs • Manual Installation • Usage Examples",
+      "preview": "Agentic B2C Developer Toolkit — AI agent skills and plugins that teach Agentforce Vibes, Claude Code, Codex, Cursor, and GitHub Copilot the full B2C Commerce stack."
+    },
+    {
+      "id": "guide-analytics-reports-cip-ccac",
+      "title": "Analytics Reports (CIP/CCAC)",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/analytics-reports-cip-ccac.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/analytics-reports-cip-ccac.md",
+      "headings": "Authentication and Access • Non-Production Support (26.1+) • Host Selection Behavior • Quick Start • Curated reports (`cip report`) • Raw SQL (`cip query`) • Metadata discovery (`cip tables`, `cip describe`) • Choosing Query vs Report • Rate Limits and Query Discipline • Site ID Parameter Note • JSON Output • SDK Support • Next Steps",
+      "preview": "User guide for running CIP/CCAC analytics reports and SQL queries with the B2C CLI."
+    },
+    {
+      "id": "guide-authentication",
+      "title": "Authentication Setup",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/authentication.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/authentication.md",
+      "headings": "Overview • Account Manager API Client • Authentication Methods • Creating an API Client • Assigning Roles • Understanding Roles and Tenant Filters • For Client Credentials (Roles on API Client) • For User Authentication (roles on User) • Configuring Scopes • Configuring Tenant Filter • Redirect URLs • JWT Authentication (Certificate-Based) • How It Works • Benefits • Setup Instructions • Step 1: Generate Certificate Pair • Step 2: Register Certificate in Account Manager • Step 3: Configure CLI • Authentication Priority • Troubleshooting • Security Best Practices • OCAPI Configuration • Configuring OCAPI in Business Manager • Example OCAPI Configuration • Minimal Configuration by Feature • SCAPI Authentication • Required Setup • Scopes by Command • Configuration • WebDAV Access • Option A: Basic Authentication (user access) • Option B: OAuth-based WebDAV (API client access) • Managed Runtime API Key • Getting an MRT API Key • Configuring the API Key • Quick Start Example • 1. Create API Client in Account Manager • 2. Configure OCAPI (for code list/activate/delete, jobs, sites) • 3. Configure WebDAV Access (for code deploy/watch, webdav commands) • 4. Set Environment Variables • 5. Test the Configuration • Troubleshooting • \"Unauthorized\" errors • \"Forbidden\" on WebDAV operations • \"Invalid scope\" errors • Next Steps",
+      "preview": "Set up authentication for the B2C CLI including Account Manager API clients, OCAPI permissions, and WebDAV access keys."
+    },
+    {
+      "id": "guide-ci-cd",
+      "title": "CI/CD with GitHub Actions",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/ci-cd.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/ci-cd.md",
+      "headings": "Overview • Authentication • Quick Start: Deploy Cartridges • Actions Reference • Root Action • Setup • Run • Code Deploy • Data Import • MRT Deploy • Job Run • WebDAV Upload • Staging Environments (Two-Factor mTLS) • CLI Flags • GitHub Actions • Patterns • Data Import Pipeline • MRT Release Deploy • Using Outputs • Version Pinning • Plugins • Logging • CI Defaults",
+      "preview": "Automate B2C Commerce code deployment, data import, MRT bundles, and job execution with the official B2C CLI GitHub Actions for CI/CD pipelines."
+    },
+    {
+      "id": "guide-commerce-apps",
+      "title": "Commerce Apps (CAPs)",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/commerce-apps.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/commerce-apps.md",
+      "headings": "Develop CAPs with AI Agent Skills • Claude Code • CLI Workflow • Creating a Storefront Pull Request • Inspecting Installed State • VS Code Extension Integration • Authentication Requirements • CI/CD Integration • Reference",
+      "preview": "Use the B2C CLI and agent skills to validate, package, install, uninstall, and pull Commerce App Packages (CAPs). Links to the official Commerce Apps ISV Developer Guide for the full specification."
+    },
+    {
+      "id": "guide-configuration",
+      "title": "Configuration",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/configuration.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/configuration.md",
+      "headings": "CLI Flags • OAuth (SCAPI/OCAPI) • Client Credentials • JWT Bearer • Implicit Flow • Basic Authentication (WebDAV) • Environment Variables • .env File • Configuration File • Single Instance • Multiple Instances • Managing Instances with the CLI • Quick Setup • Switching Instances • Listing and Removing • Supported Fields • Two-Factor Authentication (mTLS) • Project Configuration (package.json) • Allowed Fields • Content Libraries Example • Resolution Priority • Credential Grouping • MRT API Key • Overriding Authentication Behavior • Available Auth Methods • Specifying Auth Methods • Debugging Configuration • Next Steps",
+      "preview": "Configure the B2C CLI with environment variables, dw.json files, and multi-instance setups for different environments."
+    },
+    {
+      "id": "guide-extending",
+      "title": "Extending the CLI",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/extending.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/extending.md",
+      "headings": "Available Hooks • Plugin Architecture • Installing Plugins • Custom Configuration Sources • Hook: `b2c:config-sources` • Priority Ordering • Example: Custom Config Source Plugin • Plugin Structure • package.json • Hook Implementation • ConfigSource Implementation • Instance Management Methods • Credential Storage Methods • Error Handling • Plugin Configuration • NormalizedConfig Fields • HTTP Middleware • Hook: `b2c:http-middleware` • HttpMiddlewareProvider Interface • Example: Request Logging Middleware • SDK Usage (without CLI) • B2C Operation Lifecycle Hooks • Hook: `b2c:operation-lifecycle` • Supported Operations • B2COperationLifecycleProvider Interface • B2COperationContext • B2COperationResult • Example: Audit Logging Plugin • Example: Deployment Freeze Policy • Cartridge Providers • Hook: `b2c:cartridge-providers` • CartridgeProvider Interface • CartridgeTransformer Interface • CartridgeDiscoveryOptions • Example: Manifest-Based Discovery • Example: Environment-Based Filtering • Scaffold Providers • Hook: `b2c:scaffold-providers` • ScaffoldProvider Interface • ScaffoldTransformer Interface • SDK Usage (without CLI) • Adding Custom Commands • Base Command Classes • Testing Plugins • Next Steps",
+      "preview": "Extend the B2C CLI with custom plugins, configuration sources, HTTP middleware, and lifecycle hooks."
+    },
+    {
+      "id": "guide-ide-integration",
+      "title": "IDE Integration",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/ide-integration.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/ide-integration.md",
+      "headings": "Script API IntelliSense • B2C DX VS Code Extension (recommended) • Standalone VS Code, WebStorm, or IntelliJ Ultimate • Neovim, Helix, Zed, Sublime, or other LSP-based editors • Notes • Prophet VS Code Extension • Benefits • Setup • Switching Active Instances • Manual `dw.js` Example • Fields Written by `setup ide prophet` • Notes • IntelliJ SFCC Plugin • Setup",
+      "preview": "Configure IDE tooling like Prophet VS Code extension and IntelliJ SFCC plugin to consume resolved B2C CLI configuration, plus enable Script API IntelliSense via TypeScript definitions."
+    },
+    {
+      "id": "guide-installation",
+      "title": "Installation",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/installation.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/installation.md",
+      "headings": "Prerequisites • Install via npm (Recommended) • Verify Installation • Install the SDK (Optional) • Next Steps",
+      "preview": "Install the B2C CLI via npm or GitHub releases, and optionally install the SDK for programmatic use."
+    },
+    {
+      "id": "guide-mrt-utilities",
+      "title": "MRT Utilities",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/mrt-utilities.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/mrt-utilities.md",
+      "headings": "When to use • Prerequisites • Installation • Package exports • Basic setup • Middleware • createMRTCommonMiddleware() • createMRTRequestProcessorMiddleware(requestProcessorPath, proxyConfigs) • createMRTProxyMiddlewares(proxyConfigs) • createMRTStaticAssetServingMiddleware(staticAssetDir) • createMRTCleanUpMiddleware() • Environment detection • Streaming (Lambda) • Metrics • Data Store In Development • Related",
+      "preview": "Use the mrt-utilities package to simulate a deployed Managed Runtime environment locally with Express middleware and streaming adapters."
+    },
+    {
+      "id": "guide-safety",
+      "title": "Safety Mode",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/safety.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/safety.md",
+      "headings": "Quick Start • Safety Levels • Setting a Level • Safety Rules • Rule Actions • Rule Matchers • HTTP Method + Path • Job ID • CLI Command ID • Evaluation Order • Confirmation Mode • Per-Instance Configuration • Global Safety Config • Configuration Merge • Example • Environment Variables Reference • SDK Usage",
+      "preview": "Configure Safety Mode to prevent accidental destructive operations with safety levels, per-instance rules, confirmation mode, and global policies."
+    },
+    {
+      "id": "guide-scaffolding",
+      "title": "Scaffolding",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/scaffolding.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/scaffolding.md",
+      "headings": "Quick Start • Built-in Scaffolds • Using Scaffolds • Interactive Mode • Non-Interactive Mode • Providing Parameters • Preview Changes • Output Directory • Scaffold Details • cartridge • controller • hook • service • custom-api • job-step • page-designer-component • Creating Custom Scaffolds • Scaffold Locations • Initialize a New Scaffold • Scaffold Manifest • Parameter Types • Dynamic Sources • Conditional Parameters • Template Files • Template Helpers • File Mappings • File Modifications • Post Instructions • Validation • Scaffold Discovery Priority • Programmatic Usage (SDK) • Discovery and Generation • Parameter Schema Discovery • Validation",
+      "preview": "Generate B2C Commerce cartridges, controllers, hooks, custom APIs, and more from templates using the scaffolding framework."
+    },
+    {
+      "id": "guide-script-debugger",
+      "title": "Script Debugger",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/script-debugger.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/script-debugger.md",
+      "headings": "Requirements • Choosing an interface • Server affinity (hitting breakpoints) • See Also",
+      "preview": "Debug server-side B2C Commerce scripts (controllers, hooks, jobs, custom APIs) with the Script Debugger — via the VS Code extension, the CLI DAP debug adapter, or the MCP diagnostics tools."
+    },
+    {
+      "id": "guide-sdk-migration",
+      "title": "Migrating from sfcc-ci's JavaScript API",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/sdk-migration.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/sdk-migration.md",
+      "headings": "Key Paradigm Shifts • Callbacks to async/await • Token Passing to Config-Based Auth • Untyped Objects to Typed Clients • Quick Start: Replacing a Typical sfcc-ci Script • API Mapping by Module • Authentication (`sfcc.auth`) • Code Management (`sfcc.code`) • Job Execution (`sfcc.job`) • Instance / WebDAV (`sfcc.instance`, `sfcc.webdav`) • Account Manager Users (`sfcc.user`) • Account Manager & BM Roles (`sfcc.role`) • Organizations (`sfcc.org`) • Using Typed Clients Directly • SLAS Client Management • Direct OCAPI Access • Comprehensive Mapping Table • What the SDK Adds Beyond sfcc-ci • Error Handling • Next Steps",
+      "preview": "Migrate from sfcc-ci's programmatic JavaScript API to @salesforce/b2c-tooling-sdk with side-by-side code examples and API mapping."
+    },
+    {
+      "id": "guide-security",
+      "title": "Security",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/security.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/security.md",
+      "headings": "Supply Chain Security • Minimum Release Age • Trust Policy • Restricting Build Scripts • NPM Trusted Publishing • Operational Security: Safety Mode • Best Practices • For Contributors • For Users",
+      "preview": "Security practices for the B2C Developer Tooling project including supply chain protections and dependency management."
+    },
+    {
+      "id": "guide-sfcc-ci-migration",
+      "title": "Migrating from sfcc-ci",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/sfcc-ci-migration.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/sfcc-ci-migration.md",
+      "headings": "Authentication • Stateful Auth (sfcc-ci Compatible) • Stateless Auth (Recommended for CI/CD) • Command Mapping • Code Management • Instance / Data • Cartridge Path • Jobs • Sandbox • SLAS • User / Org / Role • Environment Variables • Configuration • CI/CD Migration • Before (sfcc-ci) • After (b2c-cli — stateless) • After (b2c-cli — stateful, sfcc-ci compatible) • GitHub Actions • Next Steps",
+      "preview": "Migrate from sfcc-ci to @salesforce/b2c-cli with command mappings, environment variable compatibility, and CI/CD pipeline updates."
+    },
+    {
+      "id": "guide-storefront-next",
+      "title": "Storefront Next",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/storefront-next.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/storefront-next.md",
+      "headings": "Prerequisites • Step 1: Create an On-Demand Sandbox (Optional) • Step 2: Create a SLAS Client • Step 3: Create an MRT Environment • Connect the B2C Commerce Instance • Step 4: Set Environment Variables • Variable Reference • Multi-Site Configuration • Step 5: Deploy • Step 6: Debugging with Log Tailing • Summary • Next Steps",
+      "preview": "Set up Storefront Next development environments using the B2C CLI to create sandboxes, SLAS clients, MRT environments, and deploy."
+    },
+    {
+      "id": "guide-third-party-plugins",
+      "title": "3rd Party Plugins",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/third-party-plugins.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/third-party-plugins.md",
+      "headings": "Installing Plugins • Available Plugins • IntelliJ SFCC Config Plugin • Installation • Features • Environment Variables • Usage • Password Store Plugin • Installation • Features • Storing Credentials • Environment Variables • Usage • macOS Keychain Plugin • Installation • Features • Storing Credentials • Environment Variables • Usage • Docs Viewer Plugin • Installation • Features • Usage • Catalog Reducer Plugin • Installation • Features • Usage • Pipeline Visualizer Plugin • Installation • Features • Usage • Creating Your Own Plugin • Submitting Plugins",
+      "preview": "Community plugins for the B2C CLI including IntelliJ SFCC config integration, credential storage, docs search, catalog reduction, and pipeline visualization."
+    },
+    {
+      "id": "mcp-configuration",
+      "title": "Configuration",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/mcp/configuration.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/mcp/configuration.md",
+      "headings": "Credentials • `dw.json` (Recommended) {#dw-json} • `.env` File {#env-file} • MRT Credentials (`~/.mobify`) {#mrt-credentials} • Configuration Priority • Toolset Selection • Auto-Discovery (Default) • Manual Selection • Individual Tool Selection • Logging • Telemetry • MCP Server Flags Reference {#mcp-server-flags} • Documentation Tools Restriction • Environment Variables Reference {#environment-variables-reference} • MCP Server Environment Variables {#mcp-server-environment-variables} • Next Steps",
+      "preview": "Configure the B2C DX MCP Server with credentials, flags, environment variables, and toolset selection."
+    },
+    {
+      "id": "mcp-figma-tools-setup",
+      "title": "Figma-to-Component Tools Setup",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/mcp/figma-tools-setup.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/mcp/figma-tools-setup.md",
+      "headings": "Overview • Figma MCP Setup • Figma Design File • Verification • Related Documentation",
+      "preview": "Prerequisites and setup for Figma-to-component tools (workflow orchestrator, generate component, map tokens)."
+    },
+    {
+      "id": "mcp-index",
+      "title": "MCP Server",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/mcp/index.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/mcp/index.md",
+      "headings": "Quick Start • Project Type Detection • Plugins • Next Steps",
+      "preview": "MCP Server for Salesforce B2C Commerce - AI-assisted development tools for Claude, Cursor, and other AI assistants."
+    },
+    {
+      "id": "mcp-installation",
+      "title": "Installation",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/mcp/installation.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/mcp/installation.md",
+      "headings": "Prerequisites • Claude Code • Plugin Marketplace • CLI • Cursor • Project-Level Configuration (Recommended) • Quick Install (User-Level) • GitHub Copilot • After Installation • Troubleshooting • Server Not Starting • `spawn npx ENOENT` Error • \"Could not determine executable to run\" Error (Windows) • Tools Not Available • Configuration Not Loading • Next Steps",
+      "preview": "Install and configure the B2C DX MCP Server for Claude Code, Cursor, GitHub Copilot, and other MCP clients."
+    },
+    {
+      "id": "mcp-toolsets",
+      "title": "Toolsets & Tools",
+      "category": "tooling",
+      "url": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/mcp/toolsets.html",
+      "sourceUrl": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/mcp/toolsets.md",
+      "headings": "CARTRIDGES • DIAGNOSTICS • MRT • PWAV3 • SCAPI • STOREFRONTNEXT • STOREFRONTNEXT_DEPRECATED • Next Steps",
+      "preview": "Available toolsets and tools in the B2C DX MCP Server for SCAPI, CARTRIDGES, DIAGNOSTICS, MRT, PWAV3, and STOREFRONTNEXT development."
+    }
+  ]
+}

package/data/xsd/commercefeaturestate.xsd

@@ -29,6 +29,7 @@
             <xsd:element name="unconfigured-at" type="xsd:dateTime" minOccurs="0" />
             <xsd:element name="config-tasks" type="simpleType.Generic.String" minOccurs="0" />
             <xsd:element name="installation-metadata" type="simpleType.Generic.String" minOccurs="0" />
+            <xsd:element name="admin-components" type="simpleType.Generic.String" minOccurs="0" />
         </xsd:sequence>
         <xsd:attribute name="site-id" type="simpleType.Generic.NonEmptyString.256" use="required" />
         <xsd:attribute name="feature-name" type="simpleType.Generic.NonEmptyString.256" use="required" />

package/data/xsd/customer.xsd

@@ -76,6 +76,17 @@
             <xsd:element name="company-name" type="simpleType.Generic.String.256" minOccurs="0" maxOccurs="1" />
             <xsd:element name="job-title" type="simpleType.Generic.String.256" minOccurs="0" maxOccurs="1" />
             <xsd:element name="email" type="simpleType.Email" minOccurs="0" maxOccurs="1" />
+            <xsd:element name="email-verified-flag" type="xsd:boolean" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>Indicates whether the customer's email has been verified. This field is read-only during import; the system ignores input values and determines the status as follows:
+                        * If the Email Verification Site Preference under LoginPreferences is not enabled: the value for this field will be NULL and not included in export.
+                        * If the Email Verification Site Preference under LoginPreferences is enabled:
+                            * If the incoming email value is the same as existing email and email was previously verified, the value for this field will remain unchanged as TRUE.
+                            * If the incoming email value is the same as existing email and email was not previously verified or NULL, the value for this field will remain unchanged.
+                            * If the incoming email value is not the same as existing email, the value for this field will be set to FALSE no matter the previous state.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
             <xsd:element name="phone-home" type="simpleType.PhoneNumber" minOccurs="0" maxOccurs="1" />
             <xsd:element name="phone-business" type="simpleType.PhoneNumber" minOccurs="0" maxOccurs="1" />
             <xsd:element name="phone-mobile" type="simpleType.PhoneNumber" minOccurs="0" maxOccurs="1" />

package/data/xsd/eventrouting.xsd

@@ -0,0 +1,257 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsd:schema
+        xmlns:xsd="http://www.w3.org/2001/XMLSchema"
+        targetNamespace="http://www.demandware.com/xml/impex/eventrouting/2026-04-16"
+        xmlns="http://www.demandware.com/xml/impex/eventrouting/2026-04-16"
+        elementFormDefault="qualified"
+        attributeFormDefault="unqualified">
+
+    <xsd:import namespace="http://www.w3.org/XML/1998/namespace" schemaLocation="xml.xsd" />
+
+    <!-- Root element -->
+    <xsd:element name="event-routing">
+        <xsd:annotation>
+            <xsd:documentation>
+                Root element for event routing configuration. Contains endpoint definitions and route mappings.
+                Endpoints define where events are sent (e.g., webhook URLs), and route mappings connect event types to endpoints.
+            </xsd:documentation>
+        </xsd:annotation>
+        <xsd:complexType mixed="false">
+            <xsd:sequence>
+                <xsd:element name="endpoint" type="complexType.Endpoint" minOccurs="0" maxOccurs="unbounded" />
+                <xsd:element name="route-mapping" type="complexType.RouteMapping" minOccurs="0" maxOccurs="unbounded" />
+            </xsd:sequence>
+        </xsd:complexType>
+    </xsd:element>
+
+    <!-- Global element declarations (required by StAX item reader for individual element unmarshalling) -->
+    <xsd:element name="endpoint" type="complexType.Endpoint" />
+    <xsd:element name="route-mapping" type="complexType.RouteMapping" />
+
+    <!-- Endpoint complex type -->
+    <xsd:complexType name="complexType.Endpoint">
+        <xsd:sequence>
+            <xsd:element name="endpoint-type" type="simpleType.Generic.NonEmptyString.256" minOccurs="1" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The type of endpoint. Currently supported values: "webhook".
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="url" type="simpleType.Generic.String.2048" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The endpoint URL (required for webhook endpoints). URLs are normalized during import: scheme and host are lowercased, path/query/fragment preserve original case.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="user" type="simpleType.Generic.String.256" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        Optional username for HTTP Basic Authentication.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="password" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        Optional password for HTTP Basic Authentication. Can be plain text or encrypted with common.export algorithm.
+                        If encrypted="true", the encryption-type attribute should be set to "common.export".
+                    </xsd:documentation>
+                </xsd:annotation>
+                <xsd:complexType>
+                    <xsd:simpleContent>
+                        <xsd:extension base="simpleType.Generic.String.4000">
+                            <xsd:attribute name="encrypted" type="xsd:boolean">
+                                <xsd:annotation>
+                                    <xsd:documentation>
+                                        Set to true if the password value is encrypted. If false or omitted, the value is treated as plain text.
+                                    </xsd:documentation>
+                                </xsd:annotation>
+                            </xsd:attribute>
+                            <xsd:attribute name="encryption-type" use="optional">
+                                <xsd:annotation>
+                                    <xsd:documentation>
+                                        The encryption algorithm used. Currently only "common.export" is supported. If encrypted="true" and this is omitted or set to an unknown value, an import error will occur.
+                                    </xsd:documentation>
+                                </xsd:annotation>
+                                <xsd:simpleType>
+                                    <xsd:restriction base="xsd:string">
+                                        <xsd:enumeration value="common.export" />
+                                    </xsd:restriction>
+                                </xsd:simpleType>
+                            </xsd:attribute>
+                        </xsd:extension>
+                    </xsd:simpleContent>
+                </xsd:complexType>
+            </xsd:element>
+            <xsd:element name="headers" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        Optional custom HTTP headers to send with webhook requests. Each header value is limited to 4000 characters.
+                    </xsd:documentation>
+                </xsd:annotation>
+                <xsd:complexType>
+                    <xsd:sequence>
+                        <xsd:element name="header" minOccurs="0" maxOccurs="unbounded">
+                            <xsd:complexType>
+                                <xsd:simpleContent>
+                                    <xsd:extension base="simpleType.Generic.String.4000">
+                                        <xsd:attribute name="name" type="simpleType.Generic.NonEmptyString.256" use="required">
+                                            <xsd:annotation>
+                                                <xsd:documentation>
+                                                    The HTTP header name.
+                                                </xsd:documentation>
+                                            </xsd:annotation>
+                                        </xsd:attribute>
+                                        <xsd:attribute name="encrypted" type="xsd:boolean">
+                                            <xsd:annotation>
+                                                <xsd:documentation>
+                                                    Set to true if the header value is encrypted. If false or omitted, the value is treated as plain text.
+                                                </xsd:documentation>
+                                            </xsd:annotation>
+                                        </xsd:attribute>
+                                        <xsd:attribute name="encryption-type" use="optional">
+                                            <xsd:annotation>
+                                                <xsd:documentation>
+                                                    The encryption algorithm used. Currently only "common.export" is supported. If encrypted="true" and this is omitted or set to an unknown value, an import error will occur.
+                                                </xsd:documentation>
+                                            </xsd:annotation>
+                                            <xsd:simpleType>
+                                                <xsd:restriction base="xsd:string">
+                                                    <xsd:enumeration value="common.export" />
+                                                </xsd:restriction>
+                                            </xsd:simpleType>
+                                        </xsd:attribute>
+                                    </xsd:extension>
+                                </xsd:simpleContent>
+                            </xsd:complexType>
+                        </xsd:element>
+                    </xsd:sequence>
+                </xsd:complexType>
+            </xsd:element>
+        </xsd:sequence>
+        <xsd:attribute name="endpoint-id" type="simpleType.Generic.NonEmptyString.256" use="required">
+            <xsd:annotation>
+                <xsd:documentation>
+                    Unique identifier for this endpoint. Used to reference the endpoint in route mappings.
+                </xsd:documentation>
+            </xsd:annotation>
+        </xsd:attribute>
+        <xsd:attribute name="mode" type="simpleType.ImportMode" use="optional">
+            <xsd:annotation>
+                <xsd:documentation>
+                    Import mode for this endpoint. If omitted, the endpoint is created if it doesn't exist or updated if it does.
+                    "delete" mode removes the endpoint.
+                </xsd:documentation>
+            </xsd:annotation>
+        </xsd:attribute>
+    </xsd:complexType>
+
+    <!-- Route Mapping complex type -->
+    <xsd:complexType name="complexType.RouteMapping">
+        <xsd:sequence>
+            <xsd:element name="event-id" type="simpleType.Generic.NonEmptyString.256" minOccurs="1" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The event type identifier. Must match a registered event type in the system.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="endpoint-id" type="simpleType.Generic.NonEmptyString.256" minOccurs="1" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        References an endpoint-id from an endpoint definition. The endpoint must exist before creating the route mapping.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="scope" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        Defines the scope for this route mapping. If omitted, defaults to organization scope (equivalent to type="organization").
+                        When type="organization", the route applies to all events organization-wide.
+                        When type="sites", the route applies only to events from the specified sites.
+                    </xsd:documentation>
+                </xsd:annotation>
+                <xsd:complexType>
+                    <xsd:sequence>
+                        <xsd:element name="site" minOccurs="0" maxOccurs="unbounded">
+                            <xsd:complexType>
+                                <xsd:attribute name="site-name" type="simpleType.Generic.NonEmptyString.256" use="required" />
+                            </xsd:complexType>
+                        </xsd:element>
+                    </xsd:sequence>
+                    <xsd:attribute name="type" use="required">
+                        <xsd:simpleType>
+                            <xsd:restriction base="xsd:string">
+                                <xsd:enumeration value="organization" />
+                                <xsd:enumeration value="sites" />
+                            </xsd:restriction>
+                        </xsd:simpleType>
+                    </xsd:attribute>
+                </xsd:complexType>
+            </xsd:element>
+        </xsd:sequence>
+        <xsd:attribute name="mode" type="simpleType.ImportMode" use="optional">
+            <xsd:annotation>
+                <xsd:documentation>
+                    Import mode for this route mapping. If omitted, the route mapping is created if it doesn't exist or updated if it does.
+                    "delete" mode removes the route mapping.
+                </xsd:documentation>
+            </xsd:annotation>
+        </xsd:attribute>
+    </xsd:complexType>
+
+    <!-- Simple types (reuse from services.xsd pattern) -->
+    <xsd:simpleType name="simpleType.Generic.String">
+        <xsd:restriction base="xsd:string" />
+    </xsd:simpleType>
+
+    <xsd:simpleType name="simpleType.Generic.String.256">
+        <xsd:restriction base="simpleType.Generic.String">
+            <xsd:minLength value="0" />
+            <xsd:maxLength value="256" />
+        </xsd:restriction>
+    </xsd:simpleType>
+
+    <xsd:simpleType name="simpleType.Generic.NonEmptyString.256">
+        <xsd:restriction base="simpleType.Generic.String">
+            <xsd:minLength value="0" />
+            <xsd:maxLength value="256" />
+            <xsd:pattern value="\S|(\S(.*)\S)" />
+        </xsd:restriction>
+    </xsd:simpleType>
+
+    <xsd:simpleType name="simpleType.Generic.String.2048">
+        <xsd:restriction base="simpleType.Generic.String">
+            <xsd:minLength value="0" />
+            <xsd:maxLength value="2048" />
+        </xsd:restriction>
+    </xsd:simpleType>
+
+    <xsd:simpleType name="simpleType.Generic.String.4000">
+        <xsd:restriction base="simpleType.Generic.String">
+            <xsd:minLength value="0" />
+            <xsd:maxLength value="4000" />
+        </xsd:restriction>
+    </xsd:simpleType>
+
+    <xsd:simpleType name="simpleType.ImportMode">
+        <xsd:annotation>
+            <xsd:documentation>
+                Import mode enumeration. Only "delete" is explicitly defined in the schema.
+                When omitted from an element's mode attribute, the import creates or updates the element.
+            </xsd:documentation>
+        </xsd:annotation>
+        <xsd:restriction base="xsd:string">
+            <xsd:enumeration value="delete">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        Delete mode removes the endpoint or route mapping if it exists.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:enumeration>
+        </xsd:restriction>
+    </xsd:simpleType>
+
+</xsd:schema>

package/data/xsd/index.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "generatedAt": "2026-04-21T18:00:00.000Z",
+  "generatedAt": "2026-07-02T15:36:28.098Z",
   "entries": [
     {
       "id": "abtest",
@@ -78,6 +78,10 @@
       "id": "dcext",
       "filePath": "dcext.xsd"
     },
+    {
+      "id": "eventrouting",
+      "filePath": "eventrouting.xsd"
+    },
     {
       "id": "feed",
       "filePath": "feed.xsd"
@@ -227,4 +231,4 @@
       "filePath": "xml.xsd"
     }
   ]
-}
+}