@wix/auto-patterns 1.27.0 → 1.29.0

package/dist/docs/bulk_actions.md

@@ -119,6 +119,7 @@ Custom bulk actions execute JavaScript code that you define for bulk operations.
            })
          });
        },
+       biName: 'bulk-export-pets-action'  // MANDATORY: For analytics tracking
      };
    };
    ```
@@ -141,10 +142,11 @@ Custom bulk actions execute JavaScript code that you define for bulk operations.
      "id": "bulkExportPets",        // MUST match the function name exactly
      "type": "custom",              // REQUIRED: Must be exactly "custom"
      "label": "Export Selected",    // Optional: Displayed text
+     "biName": "bulk-export-pets-action"  // MANDATORY: Analytics tracking identifier
    }
    ```
 
-5. Register your action in the `PatternsWizardOverridesProvider`:
+5. Register your action in the `AutoPatternsOverridesProvider`:
    ```typescript
    import { useActions } from '../components/actions';
 
@@ -152,9 +154,9 @@ Custom bulk actions execute JavaScript code that you define for bulk operations.
      const actions = useActions();
 
      return (
-       <PatternsWizardOverridesProvider value={{ actions }}>
+       <AutoPatternsOverridesProvider value={{ actions }}>
          <AutoPatternsApp configuration={config} />
-       </PatternsWizardOverridesProvider>
+       </AutoPatternsOverridesProvider>
      );
    }
    ```
@@ -171,7 +173,7 @@ Custom bulk actions execute JavaScript code that you define for bulk operations.
 
 1. `id` must:
    - Match exactly the function name of the custom bulk action implementation
-   - Be registered in the `actions` property of your `PatternsWizardOverridesProvider`
+   - Be registered in the `actions` property of your `AutoPatternsOverridesProvider`
    - Follow JavaScript identifier naming rules (camelCase recommended)
 
 2. The implementation must return a `ResolvedAction`:
@@ -261,7 +263,7 @@ Follow this decision process when implementing Bulk Action Toolbar:
    - Less common bulk operations → Place in `secondaryActions` array
 
 3. **Custom Implementation**:
-   - For `custom` bulk actions, you must provide implementations in your code and register them with `PatternsWizardOverridesProvider`
+   - For `custom` bulk actions, you must provide implementations in your code and register them with `AutoPatternsOverridesProvider`
 
 ### Bulk Action Toolbar Validation Checklist
 
@@ -276,3 +278,6 @@ AI agents should verify these requirements before generating Bulk Action Toolbar
 ✓ Primary actions use `action`/`menu` structure with proper `action` or `menu` properties
 ✓ Secondary actions are an array that can include dividers
 ✓ Menu items within primary actions is array that can include dividers
+✓ **MANDATORY**: Every action configuration MUST include a `biName` property for analytics tracking
+✓ **MANDATORY**: `biName` must use descriptive, kebab-case naming (e.g., "bulk-export-pets-action")
+✓ **MANDATORY**: `biName` must be unique across the application and follow the pattern `bulk-{action}-action`

package/dist/docs/collection_page.md

@@ -26,7 +26,7 @@ The `layout` array contains the rendering components for the collection. Each la
 1. **Table Layout Item** (`type: 'Table'`):
    * `table` field contains table-specific configuration
    * Used for displaying collection in a **table view**
-   * Includes columns, actionCell, bulkActionToolbar, etc.
+   * Includes columns, bulkActionToolbar, etc.
 
 2. **Grid Layout Item** (`type: 'Grid'`):
    * `grid` field contains grid-specific configuration

package/dist/docs/collection_page_actions.md

@@ -34,7 +34,7 @@ In addition to these common properties, each action item must specify a `type` w
 ### 2. `type: "custom"`
 *   **Purpose**: Executes custom JavaScript logic defined in your application's overrides.
 *   **Details**:
-    *   The `custom` object in the configuration is typically empty. The functionality is determined by a custom action resolver function that you implement and register in the `actions` section of your `PatternsWizardOverridesProvider`. The `id` of this action item must exactly match the name (key) of the registered custom action resolver. The resolver will receive parameters including `collectionId`.
+    *   The `custom` object in the configuration is typically empty. The functionality is determined by a custom action resolver function that you implement and register in the `actions` section of your `AutoPatternsOverridesProvider`. The `id` of this action item must exactly match the name (key) of the registered custom action resolver. The resolver will receive parameters including `collectionId`.
 
 ### 3. `type: "divider"`
 *   **Purpose**: Creates a visual separator between action groups in menus and lists.
@@ -123,6 +123,7 @@ Custom collection page actions execute JavaScript code that you define for colle
      "id": "exportCollection",        // MUST match the function name exactly
      "type": "custom",                // REQUIRED: Must be exactly "custom"
      "label": "Export Collection",    // Optional: Displayed text
+     "biName": "export-collection-action",  // MANDATORY: Analytics tracking identifier
      "collection": {
        "collectionId": "WixPets",
        "entityTypeSource": "cms"
@@ -130,7 +131,7 @@ Custom collection page actions execute JavaScript code that you define for colle
    }
    ```
 
-5. Register your action in the `PatternsWizardOverridesProvider`:
+5. Register your action in the `AutoPatternsOverridesProvider`:
    ```typescript
    import { useActions } from '../components/actions';
 
@@ -138,9 +139,9 @@ Custom collection page actions execute JavaScript code that you define for colle
      const actions = useActions();
 
      return (
-       <PatternsWizardOverridesProvider value={{ actions }}>
+       <AutoPatternsOverridesProvider value={{ actions }}>
          <AutoPatternsApp configuration={config} />
-       </PatternsWizardOverridesProvider>
+       </AutoPatternsOverridesProvider>
      );
    }
    ```
@@ -212,6 +213,7 @@ export const handleRowClick: CustomActionCollectionPageActionOnRowClickResolver
 
       // Your custom logic...
     },
+    biName: 'view-details-action'    // MANDATORY: For analytics tracking
   };
 };
 ```
@@ -247,6 +249,7 @@ export const openSidePanel: CustomActionCollectionPageActionOnRowClickResolver =
       // Or use a modal service/context that you've set up
       // modalService.openSidePanel(item);
     },
+    biName: 'open-side-panel-action'  // MANDATORY: For analytics tracking
   };
 };
 ```
@@ -276,7 +279,7 @@ export const useActions = () => {
 }
 ```
 
-**Step 4: Register in `PatternsWizardOverridesProvider`**:
+**Step 4: Register in `AutoPatternsOverridesProvider`**:
 ```typescript
 import { useActions } from '../components/actions';
 
@@ -284,9 +287,9 @@ export default function YourPage() {
   const actions = useActions();
 
   return (
-    <PatternsWizardOverridesProvider value={{ actions }}>
+    <AutoPatternsOverridesProvider value={{ actions }}>
       <AutoPatternsApp configuration={config} />
-    </PatternsWizardOverridesProvider>
+    </AutoPatternsOverridesProvider>
   );
 }
 ```
@@ -323,6 +326,7 @@ export const quickToggle: CustomActionCollectionPageActionOnRowClickResolver = (
         })
       });
     },
+    biName: 'quick-toggle-action'     // MANDATORY: For analytics tracking
   };
 };
 ```
@@ -346,7 +350,7 @@ export const quickToggle: CustomActionCollectionPageActionOnRowClickResolver = (
 - The implementation must use the `CustomActionCollectionPageActionOnRowClickResolver` type
 - **Required Return Object**: Must return a `ResolvedAction` object - see [ResolvedAction Reference](./resolved_action.md)
 - Access the clicked item's data through `actionParams.item`
-- The implementation must be exported as a named export and registered in your `PatternsWizardOverridesProvider`
+- The implementation must be exported as a named export and registered in your `AutoPatternsOverridesProvider`
 - When `onRowClick` is configured, the default navigation to entity page is completely disabled
 - **Complete Setup Required**: You need to create the action file, export it in the index, and register it in the provider - missing any step will cause errors
 
@@ -364,7 +368,10 @@ export const quickToggle: CustomActionCollectionPageActionOnRowClickResolver = (
 ✓ Divider actions use `{ "type": "divider" }` format and require no additional properties.
 ✓ If `onRowClick` is configured in table layout, it must have a valid `id` and `type: "custom"`.
 ✓ **CRITICAL**: Custom row click actions must have corresponding implementations registered in the `actions` override - configuration without implementation will cause errors.
-✓ Custom row click action implementations must return an object with `label`, `icon`, and `onClick` properties - all are required.
+✓ Custom row click action implementations must return a `ResolvedAction` object with `label`, `icon`, `onClick`, and `biName` properties - all are required. See [ResolvedAction Reference](./resolved_action.md) for complete field documentation.
 ✓ Custom row click action implementations must be exported as named exports and included in the actions index file.
 ✓ `onRowClick` is optional - when not configured, rows navigate to entity page by default.
 ✓ **IMPORTANT**: Configuring `onRowClick` completely disables default navigation - you must handle all row click logic in your custom implementation.
+✓ **MANDATORY**: Every action configuration MUST include a `biName` property for analytics tracking.
+✓ **MANDATORY**: `biName` must use descriptive, kebab-case naming (e.g., "export-collection-action").
+✓ **MANDATORY**: `biName` must be unique across the application and follow the pattern `{action-purpose}-action`.

package/dist/docs/custom_overrides.md

@@ -3,9 +3,10 @@
 ## Override Rules
 
 - **Custom overrides are restricted to the defined areas only** - attempting to override or modify any other aspect of `AutoPatternsApp` is prohibited and can cause unexpected behavior
-- **Always verify override implementation** - when implementing custom overrides, you MUST ensure they are correctly imported and passed to the `PatternsWizardOverridesProvider`
+- **Always verify override implementation** - when implementing custom overrides, you MUST ensure they are correctly imported and passed to the `AutoPatternsOverridesProvider`
+- **CRITICAL: Error handling for custom actions** - Custom actions that make external API calls (using `fetch()`, `axios`, etc.) should NOT use `errorHandler.withErrorHandler`. Only Wix HTTP requests (httpClient from @wix/essentials, Wix APIs like wix/data and wix/stores, and httpClient.fetchWithAuth()) require errorHandler wrapping. See the "Error Handling for HTTP Requests" section for details.
 
-The `PatternsWizardOverridesProvider` allows you to inject custom code to override default behaviors or add additional functionality. Below are the areas where overrides can be applied:
+The `AutoPatternsOverridesProvider` allows you to inject custom code to override default behaviors or add additional functionality. Below are the areas where overrides can be applied:
 
 > **Note:** These are the only areas where overrides are supported. Avoid attempting to override or modify other parts of the system, as this is not supported and may lead to unexpected behavior.
 
@@ -80,9 +81,9 @@ export default function YourPage() {
   const entityPageHeaderBadges = useEntityPageHeaderBadges();
 
   return (
-    <PatternsWizardOverridesProvider value={{ actions, columns, slots, sections, components, modals, customDataSources, entityPageHeaderSubtitle, entityPageHeaderBadges }}>
+    <AutoPatternsOverridesProvider value={{ actions, columns, slots, sections, components, modals, customDataSources, entityPageHeaderSubtitle, entityPageHeaderBadges }}>
       <AutoPatternsApp configuration={config} />
-    </PatternsWizardOverridesProvider>
+    </AutoPatternsOverridesProvider>
   );
 }
 ```
@@ -102,7 +103,7 @@ For example:
 - Adding a new subtitle override → Update `../components/entityPageHeaderSubtitle/index.tsx` to include the new subtitle in the `useEntityPageHeaderSubtitle` hook
 - Adding a new badges override → Update `../components/entityPageHeaderBadges/index.tsx` to include the new badges in the `useEntityPageHeaderBadges` hook
 
-Without updating the hook index files, your implementations won't be available to the `PatternsWizardOverridesProvider`.
+Without updating the hook index files, your implementations won't be available to the `AutoPatternsOverridesProvider`.
 
 ## Common Override Mistakes to Avoid
 
@@ -347,9 +348,9 @@ export default function YourPage() {
   const columns = useColumns();
 
   return (
-    <PatternsWizardOverridesProvider value={{ columns }}>
+    <AutoPatternsOverridesProvider value={{ columns }}>
       <AutoPatternsApp configuration={config} />
-    </PatternsWizardOverridesProvider>
+    </AutoPatternsOverridesProvider>
   );
 }
 ```
@@ -367,7 +368,7 @@ your-page/
         ├── fullName.tsx  // Calculated column
         └── date.tsx      // Enhanced formatting with row context
 
-PatternsWizardOverridesProvider
+AutoPatternsOverridesProvider
  └── value.columns (from useColumns hook)
       ├── name
       ├── petInfo
@@ -524,9 +525,9 @@ export default function YourPage() {
   const components = useComponents();
 
   return (
-    <PatternsWizardOverridesProvider value={{ components }}>
+    <AutoPatternsOverridesProvider value={{ components }}>
       <AutoPatternsApp configuration={config} />
-    </PatternsWizardOverridesProvider>
+    </AutoPatternsOverridesProvider>
   );
 }
 ```
@@ -655,7 +656,7 @@ your-page/
     │   ├── combinedNameFields.tsx // Multiple fields override
     │   └── infoCard.tsx          // Standalone component
 
-PatternsWizardOverridesProvider
+AutoPatternsOverridesProvider
  └── value.components (from useComponents hook)
       ├── customNameField
       ├── combinedNameFields
@@ -725,7 +726,7 @@ To enable sections, add the `sections` configuration to your table configuration
 
 ### Custom Data Source Hook Structure
 
-Custom data sources are implemented through the `useCustomDataSources` hook in your `PatternsWizardOverridesProvider`:
+Custom data sources are implemented through the `useCustomDataSources` hook in your `AutoPatternsOverridesProvider`:
 
 ```tsx
 import { useCustomDataSources } from '../components/customDataSources';
@@ -734,9 +735,9 @@ export default function YourPage() {
   const customDataSources = useCustomDataSources();
 
   return (
-    <PatternsWizardOverridesProvider value={{ customDataSources }}>
+    <AutoPatternsOverridesProvider value={{ customDataSources }}>
       <AutoPatternsApp configuration={config} />
-    </PatternsWizardOverridesProvider>
+    </AutoPatternsOverridesProvider>
   );
 }
 ```
@@ -810,22 +811,7 @@ When implementing custom data sources, you need to map your data source field ty
 - **Reference fields** → `'REFERENCE'`
 - **URL fields** → `'URL'`
 
-### Error Handling
 
-Custom data sources should include proper error handling:
-
-```tsx
-actions: {
-  get: async (entityId: string) => {
-    try {
-      const result = await yourDataSourceCall(entityId);
-      return result;
-    } catch (error) {
-      throw new Error(`Failed to fetch entity: ${error.message}`);
-    }
-  }
-}
-```
 
 ### Validation Requirements
 
@@ -867,9 +853,9 @@ export default function YourPage() {
   const customDataSources = useCustomDataSources();
 
   return (
-    <PatternsWizardOverridesProvider value={{ customDataSources }}>
+    <AutoPatternsOverridesProvider value={{ customDataSources }}>
       <AutoPatternsApp configuration={config} />
-    </PatternsWizardOverridesProvider>
+    </AutoPatternsOverridesProvider>
   );
 }
 ```
@@ -878,7 +864,7 @@ export default function YourPage() {
 
 ### Creating Section Renderers
 
-Section renderers are functions that determine how to group items and what information to display in section headers. They must be provided through the `PatternsWizardOverridesProvider`.
+Section renderers are functions that determine how to group items and what information to display in section headers. They must be provided through the `AutoPatternsOverridesProvider`.
 
 #### Function Signature
 
@@ -1004,9 +990,9 @@ import * as sections from './components/sections';
 import * as columns from './components/columns';
 import * as actions from './components/actions';
 
-<PatternsWizardOverridesProvider value={{ sections, columns, actions }}>
+<AutoPatternsOverridesProvider value={{ sections, columns, actions }}>
   <AutoPatternsApp configuration={config} />
-</PatternsWizardOverridesProvider>
+</AutoPatternsOverridesProvider>
 ```
 
 ### Important Notes
@@ -1152,9 +1138,9 @@ export default function YourPage() {
   const slots = useSlots();
 
   return (
-    <PatternsWizardOverridesProvider value={{ slots }}>
+    <AutoPatternsOverridesProvider value={{ slots }}>
       <AutoPatternsApp configuration={config} />
-    </PatternsWizardOverridesProvider>
+    </AutoPatternsOverridesProvider>
   );
 }
 ```

package/dist/docs/entity_page.md

@@ -22,7 +22,7 @@ When a user asks to "add badges to the entity page", understand that they want:
 1. **Custom component overrides** - NOT direct configuration in JSON
 2. **Function that returns badge objects** - NOT JSX components
 3. **Badge properties** like `text`, `skin`, `prefixIcon`, etc.
-4. **Registration in PatternsWizardOverridesProvider** under `entityPageHeaderBadges`
+4. **Registration in AutoPatternsOverridesProvider** under `entityPageHeaderBadges`
 
 **Example Request**: "Add 2 badges with random skins and text 'wow'"
 **Correct Implementation**: Create a function that returns `[{text: 'wow', skin: 'success'}, {text: 'wow', skin: 'premium'}]`
@@ -116,7 +116,7 @@ const Index: FC = () => {
   const entityPageHeaderSubtitle = useEntityPageHeaderSubtitle();
 
   return (
-    <PatternsWizardOverridesProvider
+    <AutoPatternsOverridesProvider
       value={{
         // ... other overrides
         entityPageHeaderSubtitle: {
@@ -125,7 +125,7 @@ const Index: FC = () => {
       }}
     >
       <WixPetsPage />
-    </PatternsWizardOverridesProvider>
+    </AutoPatternsOverridesProvider>
   );
 };
 ```
@@ -176,16 +176,16 @@ export const myFunction = (entity) => { ... }
 
 ### Integration
 
-Register your subtitle override in the `PatternsWizardOverridesProvider`:
+Register your subtitle override in the `AutoPatternsOverridesProvider`:
 
 ```typescript
-<PatternsWizardOverridesProvider value={{
+<AutoPatternsOverridesProvider value={{
   entityPageHeaderSubtitle: {
     mySubtitleOverride,
   },
 }}>
   <AutoPatternsApp configuration={config} />
-</PatternsWizardOverridesProvider>
+</AutoPatternsOverridesProvider>
 ```
 
 ## Entity Page Dynamic Badges
@@ -218,7 +218,7 @@ When implementing badges for entity pages, understand these key points:
 1. **Badges are CUSTOM COMPONENT OVERRIDES** - NOT direct configuration
 2. **Badge function returns an ARRAY of badge objects** - NOT JSX components
 3. **Each badge object has properties** like `text`, `skin`, `prefixIcon`, etc.
-4. **Must be registered in PatternsWizardOverridesProvider** under `entityPageHeaderBadges`
+4. **Must be registered in AutoPatternsOverridesProvider** under `entityPageHeaderBadges`
 
 ### Complete Implementation Guide
 
@@ -273,7 +273,7 @@ const Index: FC = () => {
   const entityPageHeaderBadges = useEntityPageHeaderBadges();
 
   return (
-    <PatternsWizardOverridesProvider
+    <AutoPatternsOverridesProvider
       value={{
         // ... other overrides
         entityPageHeaderSubtitle: {
@@ -285,7 +285,7 @@ const Index: FC = () => {
       }}
     >
       <WixPetsPage />
-    </PatternsWizardOverridesProvider>
+    </AutoPatternsOverridesProvider>
   );
 };
 ```
@@ -327,7 +327,7 @@ src/dashboard/
 
 1. **❌ DON'T return JSX components** - Return badge objects instead
 2. **❌ DON'T use direct configuration** - Use custom component overrides
-3. **❌ DON'T forget to register in PatternsWizardOverridesProvider**
+3. **❌ DON'T forget to register in AutoPatternsOverridesProvider**
 5. **❌ DON'T forget to export from index.ts** - Must export the function
 
 

package/dist/docs/entity_page_actions.md

@@ -21,18 +21,21 @@ Entity pages in **edit mode** support not only built-in actions (such as "Save"
       {
         "id": "sendEmail",
         "type": "custom",
-        "label": "Send Email"
+        "label": "Send Email",
+        "biName": "send-email-action"
       },
       {
         "id": "exportData",
         "type": "custom",
-        "label": "Export Data"
+        "label": "Export Data",
+        "biName": "export-data-action"
       },
       { "type": "divider" },
       {
         "id": "archiveEntity",
         "type": "custom",
-        "label": "Archive"
+        "label": "Archive",
+        "biName": "archive-entity-action"
       }
     ]
   }
@@ -59,6 +62,7 @@ export const myMoreAction: CustomEntityPageActionResolver = (params) => {
     onClick: () => {
       // Your custom logic here
     },
+    biName: 'my-more-action'  // MANDATORY: For analytics tracking
   };
 };
 ```
@@ -84,9 +88,12 @@ export const myMoreAction: CustomEntityPageActionResolver = (params) => {
 ✓ Each action in `moreActions` has a unique `id` and correct `type` value
 ✓ Each action type only includes its required field(s)
 ✓ Custom actions match implementations in overrides
-✓ The resolver is exported and registered in the `actions` property of your `PatternsWizardOverridesProvider`
+✓ The resolver is exported and registered in the `actions` property of your `AutoPatternsOverridesProvider`
 ✓ The function signature matches `CustomEntityPageActionResolver`
 ✓ The returned object is a `ResolvedAction` (see [ResolvedAction Reference](./resolved_action.md))
+✓ **MANDATORY**: Every action configuration MUST include a `biName` property for analytics tracking
+✓ **MANDATORY**: `biName` must use descriptive, kebab-case naming (e.g., "send-email-action")
+✓ **MANDATORY**: `biName` must be unique across the application and follow the pattern `{action-purpose}-action`
 
 ---
 

package/dist/docs/error_handling.md

@@ -0,0 +1,135 @@
+# Error Handling for HTTP Requests
+
+**⚠️ CRITICAL**: When implementing custom data sources that make HTTP requests, you **MUST** wrap specific HTTP calls with proper error handling. This ensures consistent error management, prevents unhandled promise rejections, and provides better user experience.
+
+## What Requires Error Handling
+
+**ONLY the following HTTP requests** in your custom data source actions must be wrapped with `errorHandler`:
+
+- **httpClient from @wix/essentials** (e.g., `httpClient.request(getDummyEntity(...))`)
+- **Wix APIs** (e.g., `wix/data`, `wix/stores`, `items.get()`, `items.insert()`, `collections.getDataCollection()`)
+- **httpClient.fetchWithAuth()** calls
+
+**DO NOT use errorHandler with:**
+
+- **External API calls** using `fetch()`, `axios.get()`, or other HTTP libraries
+- **Custom HTTP clients** (e.g., any non-Wix HTTP request library)
+- **Third-party API calls** using non-Wix HTTP methods
+
+**EXCEPTION**: SDK actions that you get from the AutoPatterns SDK (e.g., `sdk.getOptimisticActions()`, `sdk.getSchema()`) do NOT need error handling as they are already handled internally.
+
+## Why Error Handling is Required
+
+Custom data sources often make HTTP requests to Wix APIs and services. Without proper error handling:
+
+- **Unhandled Promise Rejections**: HTTP failures can crash your application
+- **Poor User Experience**: Users don't get meaningful error messages
+- **Inconsistent Error Management**: Different parts of your app handle errors differently
+- **Debugging Difficulties**: Hard to trace and diagnose API failures
+
+## Using @wix/essentials errorHandler
+
+The recommended approach is to use the `errorHandler` from `@wix/essentials` package, which provides consistent error handling patterns across Wix applications.
+
+### Installation
+
+First, ensure `@wix/essentials` is installed in your project:
+
+```bash
+npm install @wix/essentials
+```
+
+### Basic Error Handling Pattern
+
+Wrap Wix HTTP requests in your custom data source actions with `errorHandler.withErrorHandler`:
+
+```typescript
+import { errorHandler } from '@wix/essentials';
+
+// In your custom data source actions
+actions: {
+  get: async (entityId: string) => {
+    return errorHandler.withErrorHandler(
+      async () => {
+        const response = await httpClient.request(
+          getDummyEntity({ dummyEntityId: entityId })
+        );
+        return response.data.dummyEntity;
+      },
+      {}
+    );
+  },
+}
+```
+
+### Examples of HTTP Requests That Need Error Handling
+
+**httpClient from @wix/essentials:**
+
+```typescript
+return errorHandler.withErrorHandler(async () => {
+  const response = await httpClient.request(
+    getDummyEntity({ dummyEntityId: entityId })
+  );
+  return response.data.dummyEntity;
+}, {});
+```
+
+**Wix APIs (wix/data, wix/stores):**
+
+```typescript
+return errorHandler.withErrorHandler(async () => {
+  return await items.get(collectionId, entityId);
+}, {});
+```
+
+**httpClient.fetchWithAuth() calls:**
+
+```typescript
+return errorHandler.withErrorHandler(async () => {
+  const response = await httpClient.fetchWithAuth("/api/data");
+  return await response.json();
+}, {});
+```
+
+### Examples of HTTP Requests That Do NOT Need Error Handling
+
+**External API calls (using fetch, axios, etc.):**
+
+```typescript
+// ✅ CORRECT - No error handling needed for external APIs
+const response = await fetch("https://api.example.com/data");
+return await response.json();
+
+// ✅ CORRECT - No error handling needed for axios
+const response = await axios.get("https://api.example.com/data");
+return response.data;
+```
+
+**Third-party HTTP libraries:**
+
+```typescript
+// ✅ CORRECT - No error handling needed for third-party HTTP clients
+const response = await someThirdPartyHttpClient.get("/data");
+return response.data;
+```
+
+## Integration with AutoPatterns Error Handling
+
+The error handling in your custom data source integrates seamlessly with AutoPatterns' built-in error handling:
+
+1. **User-Friendly Messages**: Errors are displayed to users in a consistent format
+2. **Retry Mechanisms**: Users can retry failed operations
+3. **Loading States**: Proper loading states during HTTP requests
+4. **Error Boundaries**: Errors are caught and handled gracefully
+
+## Validation Checklist
+
+Before deploying your custom data source, ensure:
+
+✅ **httpClient from @wix/essentials** is wrapped with `errorHandler.withErrorHandler`
+✅ **Wix APIs (wix/data, wix/stores, etc)** are wrapped with `errorHandler.withErrorHandler`
+✅ **httpClient.fetchWithAuth()** calls are wrapped with `errorHandler.withErrorHandler`
+✅ **External API calls are NOT wrapped** with errorHandler (e.g., fetch(), axios, third-party HTTP clients)
+✅ **SDK actions are used directly** without error handling (e.g., `sdk.getOptimisticActions()`, `sdk.getSchema()`)
+✅ **@wix/essentials** is installed as a dependency

package/dist/docs/index.md

@@ -66,6 +66,10 @@ This index maps user requests to the appropriate section IDs for fetching releva
 **Topics**: Package installation, setup process, component integration, provider setup
 **Keywords**: installation, setup, getting started, initial setup, package installation, dependencies, component integration, provider setup
 
+### ID: `app_context`
+**Topics**: AppContext feature, accessing collection data, useAppContext hook, children components, modals, side panels
+**Keywords**: AppContext, useAppContext, collection data access, children, modals, side panels, overlay components, outside main interface
+
 ### ID: `custom_overrides`
 **Topics**: Customization, overrides, custom components, column customization, folder structure
 **Keywords**: customization, custom functionality, overrides, extending functionality, custom components, custom rendering, column overrides, folder structure, organization, row data access
@@ -74,6 +78,10 @@ This index maps user requests to the appropriate section IDs for fetching releva
 **Topics**: FQDN-based custom data sources, Wix Business API integration, schema mapping, custom data source implementation
 **Keywords**: FQDN, Wix Business API, custom data source, schema mapping, client library, field type mapping, custom implementation, entityTypeSource custom, Business API integration, schema extraction
 
+### ID: `error_handling`
+**Topics**: HTTP request error handling, errorHandler usage, custom data source error management, API error handling
+**Keywords**: error handling, HTTP errors, API errors, errorHandler, @wix/essentials, custom data source errors, error management, promise rejections, user experience, error messages
+
 ---
 
 ## Recipe Section IDs (Step-by-Step Guides)

package/dist/docs/installation.md

@@ -56,7 +56,7 @@ import React, { type FC } from 'react';
 import { WixDesignSystemProvider } from '@wix/design-system';
 import '@wix/design-system/styles.global.css';
 import { WixPatternsProvider } from '@wix/patterns/provider';
-import { PatternsWizardOverridesProvider, AutoPatternsApp } from '@wix/auto-patterns';
+import { AutoPatternsOverridesProvider, AutoPatternsApp } from '@wix/auto-patterns';
 import { withDashboard } from '@wix/patterns';
 
 import { config } from './MyCollectionConfig.patterns';
@@ -65,9 +65,9 @@ const Index: FC = () => {
   return (
     <WixDesignSystemProvider features={{ newColorsBranding: true }}>
       <WixPatternsProvider>
-        <PatternsWizardOverridesProvider value={{ }}>
+        <AutoPatternsOverridesProvider value={{ }}>
           <AutoPatternsApp configuration={config} />
-        </PatternsWizardOverridesProvider>
+        </AutoPatternsOverridesProvider>
       </WixPatternsProvider>
     </WixDesignSystemProvider>
   );