Add fraud domain and additional folders within the UI extensions directory

jbisaSF · jbisaSF · commit 8be093923dec · 2026-03-26T13:22:16.000-04:00
diff --git a/.claude/skills/extract-and-inspect/SKILL.md b/.claude/skills/extract-and-inspect/SKILL.md
@@ -110,7 +110,15 @@ commerce-<appName>-app-v<version>/
 │   └── bm_cartridges/<bm_cartridge_name>/
 ├── storefront-next/src/extensions/<app-name>/
 │   ├── target-config.json
-│   └── components/
+│   ├── components/
+│   ├── context/
+│   ├── hooks/
+│   ├── locales/
+│   ├── middlewares/
+│   ├── providers/
+│   ├── routes/
+│   ├── stores/
+│   └── tests/
 ├── impex/
 │   ├── install/
 │   │   ├── services.xml
diff --git a/.claude/skills/generate-commerce-app/SKILL.md b/.claude/skills/generate-commerce-app/SKILL.md
@@ -22,7 +22,7 @@ Gather from the user (or infer from context):
 |-------|---------|----------|
 | App name (kebab-case) | `avalara-tax` | Yes |
 | Display name | `Avalara Tax` | Yes |
-| Domain | `tax` | Yes (one of: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`) |
+| Domain | `tax` | Yes (one of: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`, `fraud`) |
 | Version | `0.2.8` | Yes |
 | Description | `Automated tax compliance by Avalara` | Yes |
 | Publisher name | `Avalara` | Yes |
@@ -50,7 +50,15 @@ commerce-<appName>-app-v<version>/
 │   └── bm_cartridges/<bm_cartridge_name>/     # BM extensions (can be empty)
 ├── storefront-next/src/extensions/<app-name>/
 │   ├── target-config.json                     # Extension target mappings
-│   └── components/                            # React components
+│   ├── components/                            # React components
+│   ├── context/                               # React context providers
+│   ├── hooks/                                 # Custom React hooks
+│   ├── locales/                               # i18n translation files
+│   ├── middlewares/                            # Middleware functions
+│   ├── providers/                             # Data/service providers
+│   ├── routes/                                # Route definitions
+│   ├── stores/                                # State management stores
+│   └── tests/                                 # Extension tests
 ├── impex/
 │   ├── install/
 │   │   ├── services.xml                       # Service credential, profile, definition
@@ -145,7 +153,7 @@ Find the entry for your app in the appropriate domain array (e.g., `tax`, `payme
 }
 ```
 
-Valid domains: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`.
+Valid domains: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`, `fraud`.
 
 **For new apps:** Add a new entry to the appropriate domain array.
 **For updates:** Update the existing entry's `version`, `zip`, and `sha256` fields.
diff --git a/.claude/skills/scaffold-commerce-app/SKILL.md b/.claude/skills/scaffold-commerce-app/SKILL.md
@@ -16,7 +16,7 @@ Gather the following information from the user:
 
 | Input | Example | Notes |
 |-------|---------|-------|
-| Domain | `tax` | One of: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts` |
+| Domain | `tax` | One of: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`, `fraud` |
 | ISV/Vendor name | `avalara` | Your company name (lowercase, hyphens) |
 | App name (kebab-case) | `avalara-tax` | Unique app identifier |
 | Display name | `Avalara Tax` | Human-readable name with vendor |
@@ -47,6 +47,7 @@ Gather the following information from the user:
 - `address-verification` - Address validation and standardization
 - `analytics` - Analytics and reporting
 - `approaching-discounts` - Approaching discount notifications
+- `fraud` - Fraud detection and prevention
 
 ## Step 2: Create domain and ISV directories
 
@@ -82,7 +83,7 @@ mkdir -p cartridges/site_cartridges/<cartridgeName>/test/{mocks,unit}
 mkdir -p cartridges/bm_cartridges/bm_<appName>
 
 # Storefront Next extensions
-mkdir -p storefront-next/src/extensions/<appName>/components
+mkdir -p storefront-next/src/extensions/<appName>/{components,context,hooks,locales,middlewares,providers,routes,stores,tests}
 
 # Impex structure
 mkdir -p impex/install/meta
diff --git a/.claude/skills/validate-commerce-app/SKILL.md b/.claude/skills/validate-commerce-app/SKILL.md
@@ -14,7 +14,7 @@ Run comprehensive validation checks on a commerce app before submitting a PR.
 ## Step 1: Identify the app to validate
 
 Gather or infer:
-- Domain (one of: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`)
+- Domain (one of: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`, `fraud`)
 - App name (e.g., `avalara-tax`)
 - Version to validate (or use latest ZIP in directory)
 
@@ -46,7 +46,7 @@ Check that the app entry in `commerce-apps-manifest/manifest.json` contains all
 - `name` - human-readable display name
 - `description` - app description
 - `iconName` - icon filename (e.g., `avalara.png`)
-- `domain` - must be one of: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`
+- `domain` - must be one of: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`, `fraud`
 - `type` - must be `"app"`
 - `provider` - must be `"thirdParty"`
 - `version` - semantic version (e.g., `0.2.8`)
diff --git a/.cursor/skills/extract-and-inspect/SKILL.md b/.cursor/skills/extract-and-inspect/SKILL.md
@@ -110,7 +110,15 @@ commerce-<appName>-app-v<version>/
 │   └── bm_cartridges/<bm_cartridge_name>/
 ├── storefront-next/src/extensions/<app-name>/
 │   ├── target-config.json
-│   └── components/
+│   ├── components/
+│   ├── context/
+│   ├── hooks/
+│   ├── locales/
+│   ├── middlewares/
+│   ├── providers/
+│   ├── routes/
+│   ├── stores/
+│   └── tests/
 ├── impex/
 │   ├── install/
 │   │   ├── services.xml
diff --git a/.cursor/skills/generate-commerce-app/SKILL.md b/.cursor/skills/generate-commerce-app/SKILL.md
@@ -22,7 +22,7 @@ Gather from the user (or infer from context):
 |-------|---------|----------|
 | App name (kebab-case) | `avalara-tax` | Yes |
 | Display name | `Avalara Tax` | Yes |
-| Domain | `tax` | Yes (one of: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`) |
+| Domain | `tax` | Yes (one of: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`, `fraud`) |
 | Version | `0.2.8` | Yes |
 | Description | `Automated tax compliance by Avalara` | Yes |
 | Publisher name | `Avalara` | Yes |
@@ -50,7 +50,15 @@ commerce-<appName>-app-v<version>/
 │   └── bm_cartridges/<bm_cartridge_name>/     # BM extensions (can be empty)
 ├── storefront-next/src/extensions/<app-name>/
 │   ├── target-config.json                     # Extension target mappings
-│   └── components/                            # React components
+│   ├── components/                            # React components
+│   ├── context/                               # React context providers
+│   ├── hooks/                                 # Custom React hooks
+│   ├── locales/                               # i18n translation files
+│   ├── middlewares/                            # Middleware functions
+│   ├── providers/                             # Data/service providers
+│   ├── routes/                                # Route definitions
+│   ├── stores/                                # State management stores
+│   └── tests/                                 # Extension tests
 ├── impex/
 │   ├── install/
 │   │   ├── services.xml                       # Service credential, profile, definition
@@ -128,7 +136,7 @@ Copy the hex digest (the long string before the filename).
 
 **CRITICAL:** Update the root manifest at `commerce-apps-manifest/manifest.json`:
 
-Find the entry for your app in the appropriate domain array (`tax`, `shipping`, `payment`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`) and update it:
+Find the entry for your app in the appropriate domain array (`tax`, `shipping`, `payment`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`, `fraud`) and update it:
 
 ```json
 {
diff --git a/.cursor/skills/scaffold-commerce-app/SKILL.md b/.cursor/skills/scaffold-commerce-app/SKILL.md
@@ -16,7 +16,7 @@ Gather the following information from the user:
 
 | Input | Example | Notes |
 |-------|---------|-------|
-| Domain | `tax` | One of: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts` |
+| Domain | `tax` | One of: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`, `fraud` |
 | ISV/Vendor name | `avalara` | Your company name (lowercase, hyphens) |
 | App name (kebab-case) | `avalara-tax` | Unique app identifier |
 | Display name | `Avalara Tax` | Human-readable name with vendor |
@@ -47,6 +47,7 @@ Gather the following information from the user:
 - `address-verification` - Address validation and standardization
 - `analytics` - Analytics and reporting
 - `approaching-discounts` - Approaching discount notifications
+- `fraud` - Fraud detection and prevention
 
 ## Step 2: Create domain and ISV directories
 
@@ -82,7 +83,7 @@ mkdir -p cartridges/site_cartridges/<cartridgeName>/test/{mocks,unit}
 mkdir -p cartridges/bm_cartridges/bm_<appName>
 
 # Storefront Next extensions
-mkdir -p storefront-next/src/extensions/<appName>/components
+mkdir -p storefront-next/src/extensions/<appName>/{components,context,hooks,locales,middlewares,providers,routes,stores,tests}
 
 # Impex structure
 mkdir -p impex/install/meta
diff --git a/.cursor/skills/update-app-version/SKILL.md b/.cursor/skills/update-app-version/SKILL.md
@@ -119,7 +119,7 @@ Copy the hex digest (the long string before the filename).
 
 **CRITICAL:** Update the root manifest at `commerce-apps-manifest/manifest.json`:
 
-Find your app's entry in the appropriate domain array (`tax`, `shipping`, `payment`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`) and update:
+Find your app's entry in the appropriate domain array (`tax`, `shipping`, `payment`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`, `fraud`) and update:
 
 ```json
 {
diff --git a/.cursor/skills/validate-commerce-app/SKILL.md b/.cursor/skills/validate-commerce-app/SKILL.md
@@ -14,7 +14,7 @@ Run comprehensive validation checks on a commerce app before submitting a PR.
 ## Step 1: Identify the app to validate
 
 Gather or infer:
-- Domain (one of: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`)
+- Domain (one of: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`, `fraud`)
 - App name (e.g., `avalara-tax`)
 - Version to validate (or use latest ZIP in directory)
 
@@ -31,7 +31,7 @@ Check that ZIP file exists at `<domain>/<isv-name>/<appName>-v<version>.zip`
 
 2. Read the root manifest at `commerce-apps-manifest/manifest.json`
 
-3. Find your app's entry in the appropriate domain array (`tax`, `shipping`, `payment`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`)
+3. Find your app's entry in the appropriate domain array (`tax`, `shipping`, `payment`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`, `fraud`)
 
 4. Compare computed hash with `sha256` field in the manifest entry
 
@@ -46,7 +46,7 @@ Check that the app entry in `commerce-apps-manifest/manifest.json` contains all
 - `name` - human-readable display name
 - `description` - app description
 - `iconName` - icon filename (e.g., `avalara.png`)
-- `domain` - must be one of: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`
+- `domain` - must be one of: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`, `fraud`
 - `type` - must be `"app"`
 - `provider` - must be `"thirdParty"`
 - `version` - semantic version (e.g., `0.2.8`)
diff --git a/.github/ISSUE_TEMPLATE/new_app.yml b/.github/ISSUE_TEMPLATE/new_app.yml
@@ -44,6 +44,7 @@ body:
         - address-verification
         - analytics
         - approaching-discounts
+        - fraud
     validations:
       required: true
 
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
@@ -2,7 +2,7 @@
 
 **App Name:**
 **Display Name:**
-**Domain:** <!-- tax, payment, shipping, gift-cards, ratings-and-reviews, loyalty, search, address-verification, analytics, approaching-discounts -->
+**Domain:** <!-- tax, payment, shipping, gift-cards, ratings-and-reviews, loyalty, search, address-verification, analytics, approaching-discounts, fraud -->
 **ISV/Vendor Name:**
 **Version:**
 
diff --git a/AGENTS.md b/AGENTS.md
@@ -10,7 +10,7 @@ This is a **Commerce App Registry** for Salesforce Commerce Cloud B2C Commerce.
 
 **Key Concepts:**
 - **Commerce App Package (CAP):** A ZIP file containing cartridges, UI extensions, impex configs, and documentation
-- **Domain:** Functional category for the app. Can be a provider domain (`tax`, `payment`, `shipping`) or a feature domain (`gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`)
+- **Domain:** Functional category for the app. Can be a provider domain (`tax`, `payment`, `shipping`) or a feature domain (`gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`, `fraud`)
 - **ISV:** Independent Software Vendor (the company publishing the app)
 - **Impex:** XML configuration files for SFCC (services, site preferences, custom objects)
 
@@ -377,6 +377,7 @@ The `domain` field in manifest entries and `commerce-app.json` must be one of th
 | `address-verification` | Address validation and standardization | |
 | `analytics` | Analytics and reporting | |
 | `approaching-discounts` | Approaching discount notifications | Salesforce Approaching Discounts |
+| `fraud` | Fraud detection and prevention | |
 
 ### Common App Patterns
 | Type | What It Does | Typical Components |
@@ -545,7 +546,7 @@ A: Depends on what you're doing:
 - Anything else: NO - CI manages it
 
 **Q: "Where does my app go in the registry?"**
-A: `{domain}/{isv-name}/` where domain is one of: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, or `approaching-discounts`. The domain uses hyphen-case and is specified directly in the manifest.
+A: `{domain}/{isv-name}/` where domain is one of: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`, or `fraud`. The domain uses hyphen-case and is specified directly in the manifest.
 
 ## Key Files to Reference
 
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -137,7 +137,7 @@ Find your app’s entry in the appropriate domain array (e.g., `tax`, `shipping`
 - `name` - Display name
 - `description` - App description
 - `iconName` - Icon filename (e.g., `avalara.png`)
-- `domain` - One of: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`
+- `domain` - One of: `tax`, `payment`, `shipping`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`, `fraud`
 - `type` - Always `"app"` for commerce apps
 - `provider` - Always `"thirdParty"` for ISV apps
 - `version` - Semantic version (e.g., `"1.0.0"`)
diff --git a/README.md b/README.md
@@ -80,9 +80,17 @@ commerce-{app-name}-app-v{version}/
 │   │   │   └── services/          # Service framework wrappers
 │   │   └── test/                  # Unit tests
 │   └── bm_cartridges/             # Business Manager extensions (optional)
-├── storefront-next/src/extensions/{name}/  # React components for UI Targets
+├── storefront-next/src/extensions/{name}/  # UI extension module
 │   ├── target-config.json         # Maps components → storefront extension points
-│   └── components/
+│   ├── components/                # React components
+│   ├── context/                   # React context providers
+│   ├── hooks/                     # Custom React hooks
+│   ├── locales/                   # i18n translation files
+│   ├── middlewares/               # Middleware functions
+│   ├── providers/                 # Data/service providers
+│   ├── routes/                    # Route definitions
+│   ├── stores/                    # State management stores
+│   └── tests/                     # Extension tests
 ├── impex/
 │   ├── install/                   # Service configs, custom attributes, preferences
 │   │   ├── services.xml
@@ -141,6 +149,7 @@ Every app's `domain` field must be one of these. Domains use hyphen-case. Provid
 | `address-verification` | Additional Setup | Address validation and standardization | |
 | `analytics` | Additional Setup | Analytics and reporting | |
 | `approaching-discounts` | Additional Setup | Approaching discount notifications | Salesforce Approaching Discounts |
+| `fraud` | Additional Setup | Fraud detection and prevention | |
 
 ## Tech Stack
 
diff --git a/commerce-apps-manifest/manifest.json b/commerce-apps-manifest/manifest.json
@@ -64,5 +64,6 @@
             "type": "custom",
             "provider": "custom"
         }
-    ]
+    ],
+    "fraud": []
 }

Original file line number	Diff line number	Diff line change
`@@ -119,7 +119,7 @@ Copy the hex digest (the long string before the filename).`
`119`	`119`
`120`	`120`	CRITICAL: Update the root manifest at `commerce-apps-manifest/manifest.json`:
`121`	`121`
`122`		-Find your app's entry in the appropriate domain array (`tax`, `shipping`, `payment`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`) and update:
	`122`	+Find your app's entry in the appropriate domain array (`tax`, `shipping`, `payment`, `gift-cards`, `ratings-and-reviews`, `loyalty`, `search`, `address-verification`, `analytics`, `approaching-discounts`, `fraud`) and update:
`123`	`123`
`124`	`124`	```json
`125`	`125`	`{`