@wix/auto-patterns 1.23.0 → 1.24.0

package/dist/docs/app_config_structure.md

@@ -17,6 +17,13 @@
 - Not designating exactly one page as `appMainPage: true`
 - Missing or inconsistent page relationships (parentPageId/entityPageId)
 - Setting `stickyColumns` to invalid values (negative, zero, or exceeding column count)
+- **Missing custom property**: When `entityTypeSource: 'custom'`, forgetting to include the required `custom: { id: "..." }` property will cause TypeScript errors
+- **Using incorrect field types**: Mismatching page type with configuration object (e.g., `type: 'entityPage'` with `collectionPage` field)
+- **Including fields from wrong page type**: Adding both `collectionPage` and `entityPage` fields in the same page configuration
+- **Missing action layout properties**: Not including `action` property when `type: 'action'` or `menu` property when `type: 'menu'`
+- **Missing action type properties**: Not including `create`, `update`, `delete`, or `bulkDelete` properties when required by the action type
+- **Including wrong action properties**: Adding properties from different action types in the same action configuration
+- **Action type mismatches**: Using action cell types in collection actions, or bulk action types in regular actions
 
 ```ts
 export interface AppConfig {
@@ -46,6 +53,9 @@ export interface AppConfig {
               collection: {
                 collectionId: string; // ID of the Wix Data collection
                 entityTypeSource: 'cms' | 'custom'; // Data source type.
+                custom?: { // REQUIRED when entityTypeSource is 'custom'
+                  id: string; // ID matching your custom data source identifier
+                };
               };
               create?: { // Required when type is 'create'
                 mode: 'page'; // Create mode
@@ -73,8 +83,8 @@ export interface AppConfig {
           collection: {
             collectionId: string; // ID of the Wix Data collection
             entityTypeSource: 'cms' | 'custom'; // Data source type.
-            custom?: {
-              id: string;
+            custom?: { // REQUIRED when entityTypeSource is 'custom'
+              id: string; // ID matching your custom data source identifier
             };
             reflectQueryInUrl?: boolean; // Reflects query state (search, filters, sorting) in the browser URL. Default: false
             selectAllScope?: 'page' | 'all'; // Controls "Select All" scope. 'all' selects entire collection, 'page' selects only visible items. Default: 'all'
@@ -295,6 +305,7 @@ export interface AppConfig {
       ]; // End of components array
     };
     entityPage?: {
+      mode?: 'edit' | 'view'; // Entity page mode. Default: 'edit'
       route: {
         path: string; // Route path for the entity page (e.g., '/product/:entityId')
         params: {
@@ -307,6 +318,40 @@ export interface AppConfig {
       subtitle?: {
         text: string; // Entity page subtitle
       };
+      actions?: { // Action configuration varies by mode
+        // Edit mode: only moreActions supported
+        // View mode: primaryActions, secondaryActions, and moreActions supported
+        primaryActions?: { // View mode only
+          type: 'action' | 'menu';
+          action?: {
+            item: {
+              id: string;
+              type: 'create' | 'custom';
+              label?: string;
+              create?: { // Required when type is 'create'
+                mode: 'page';
+                page: {
+                  id: string; // Entity page ID to navigate to
+                };
+              };
+            };
+          };
+          menu?: {
+            label: string;
+            items: {}[]; // Array of action configurations, same structure as action.item, can include dividers
+          };
+        };
+        secondaryActions?: { // View mode only - same structure as primaryActions
+          type: 'action' | 'menu';
+          action?: {}; // Same structure as primaryActions.action
+          menu?: {}; // Same structure as primaryActions.menu
+        };
+        moreActions?: { // Both modes
+          id: string;
+          type: 'custom';
+          label?: string;
+        }[];
+      };
       parentPageId?: string; // ID of the parent collection page
       layout?: {
         // Main layout section
@@ -338,8 +383,8 @@ export interface AppConfig {
       };
       collectionId: string; // Related collection ID
       entityTypeSource: 'cms' | 'custom'; // Data source type.
-      custom?: {
-        id: string;
+      custom?: { // REQUIRED when entityTypeSource is 'custom'
+        id: string; // ID matching your custom data source identifier
       };
     };
   }[];

package/dist/docs/auto-patterns-guide.md

@@ -95,6 +95,13 @@ It is configured using a TypeScript file conforming to the `AppConfig` interface
 - Not designating exactly one page as `appMainPage: true`
 - Missing or inconsistent page relationships (parentPageId/entityPageId)
 - Setting `stickyColumns` to invalid values (negative, zero, or exceeding column count)
+- **Missing custom property**: When `entityTypeSource: 'custom'`, forgetting to include the required `custom: { id: "..." }` property will cause TypeScript errors
+- **Using incorrect field types**: Mismatching page type with configuration object (e.g., `type: 'entityPage'` with `collectionPage` field)
+- **Including fields from wrong page type**: Adding both `collectionPage` and `entityPage` fields in the same page configuration
+- **Missing action layout properties**: Not including `action` property when `type: 'action'` or `menu` property when `type: 'menu'`
+- **Missing action type properties**: Not including `create`, `update`, `delete`, or `bulkDelete` properties when required by the action type
+- **Including wrong action properties**: Adding properties from different action types in the same action configuration
+- **Action type mismatches**: Using action cell types in collection actions, or bulk action types in regular actions
 
 ```ts
 export interface AppConfig {
@@ -124,6 +131,9 @@ export interface AppConfig {
               collection: {
                 collectionId: string; // ID of the Wix Data collection
                 entityTypeSource: 'cms' | 'custom'; // Data source type.
+                custom?: { // REQUIRED when entityTypeSource is 'custom'
+                  id: string; // ID matching your custom data source identifier
+                };
               };
               create?: { // Required when type is 'create'
                 mode: 'page'; // Create mode
@@ -151,8 +161,8 @@ export interface AppConfig {
           collection: {
             collectionId: string; // ID of the Wix Data collection
             entityTypeSource: 'cms' | 'custom'; // Data source type.
-            custom?: {
-              id: string;
+            custom?: { // REQUIRED when entityTypeSource is 'custom'
+              id: string; // ID matching your custom data source identifier
             };
             reflectQueryInUrl?: boolean; // Reflects query state (search, filters, sorting) in the browser URL. Default: false
             selectAllScope?: 'page' | 'all'; // Controls "Select All" scope. 'all' selects entire collection, 'page' selects only visible items. Default: 'all'
@@ -373,6 +383,7 @@ export interface AppConfig {
       ]; // End of components array
     };
     entityPage?: {
+      mode?: 'edit' | 'view'; // Entity page mode. Default: 'edit'
       route: {
         path: string; // Route path for the entity page (e.g., '/product/:entityId')
         params: {
@@ -385,6 +396,40 @@ export interface AppConfig {
       subtitle?: {
         text: string; // Entity page subtitle
       };
+      actions?: { // Action configuration varies by mode
+        // Edit mode: only moreActions supported
+        // View mode: primaryActions, secondaryActions, and moreActions supported
+        primaryActions?: { // View mode only
+          type: 'action' | 'menu';
+          action?: {
+            item: {
+              id: string;
+              type: 'create' | 'custom';
+              label?: string;
+              create?: { // Required when type is 'create'
+                mode: 'page';
+                page: {
+                  id: string; // Entity page ID to navigate to
+                };
+              };
+            };
+          };
+          menu?: {
+            label: string;
+            items: {}[]; // Array of action configurations, same structure as action.item, can include dividers
+          };
+        };
+        secondaryActions?: { // View mode only - same structure as primaryActions
+          type: 'action' | 'menu';
+          action?: {}; // Same structure as primaryActions.action
+          menu?: {}; // Same structure as primaryActions.menu
+        };
+        moreActions?: { // Both modes
+          id: string;
+          type: 'custom';
+          label?: string;
+        }[];
+      };
       parentPageId?: string; // ID of the parent collection page
       layout?: {
         // Main layout section
@@ -416,8 +461,8 @@ export interface AppConfig {
       };
       collectionId: string; // Related collection ID
       entityTypeSource: 'cms' | 'custom'; // Data source type.
-      custom?: {
-        id: string;
+      custom?: { // REQUIRED when entityTypeSource is 'custom'
+        id: string; // ID matching your custom data source identifier
       };
     };
   }[];
@@ -516,7 +561,6 @@ Notice how the `label` is derived from the `value` by capitalizing the first let
 - **Pages array must contain exactly two pages** - one collectionPage and one entityPage
 - **Exactly one page must have `appMainPage: true`** to designate it as the main page
 - **All page IDs referenced in relationships must exist in the configuration** - validate all `parentPageId` and `entityPageId` references
-- **Bind `type` strictly to matching fields** - if `type: 'collectionPage'`, only `collectionPage` field exists (no `entityPage` field), and vice versa
 
 ## Default Generation
 
@@ -529,12 +573,6 @@ Notice how the `label` is derived from the `value` by capitalizing the first let
     * The route path **must** include a descriptive segment (e.g., `/product/:entityId`, `/pet/:entityId`)
     * **Never use just `/:entityId`** - this conflicts with the collection page route and breaks routing
 
-## Type and Structure Binding
-
-* If `type: 'collectionPage'`, then **only** `collectionPage` field exists (no `entityPage` field).
-* If `type: 'entityPage'`, then **only** `entityPage` field exists (no `collectionPage` field).
-* **No cross-mixing** allowed.
-
 ## Page Connection Configuration
 
 ### Main Page Designation
@@ -599,11 +637,8 @@ A two-way connection must be established between collection pages and entity pag
 * **Route Structure**: Entity pages must use `/[segment]/:entityId` format (e.g., `/product/:entityId` or `/pets/:entityId`), never just `/:entityId`
 * **Route Parameters Configuration**: All entity pages must have both a dynamic parameter in `route.path` and a matching configuration in `route.params`
 
-## ⚠️ Common Type and Route Mistakes to Avoid
+## ⚠️ Common Route and Configuration Mistakes to Avoid
 
-- Using incorrect field types
-- Missing required fields
-- Including fields from wrong page type
 - Missing route.params for entity pages
 - Using `/:entityId` instead of `/segment/:entityId` for entity page routes (causes routing conflicts)
 
@@ -787,11 +822,15 @@ Custom collection page actions execute JavaScript code that you define for colle
                // Your collection export logic here
                console.log(`Exporting collection: ${collectionId}`);
                // Export and update all items on server
-               return await schema.actions.bulkUpdate({ lastExported: new Date() });
+               // Handle potential undefined schema
+               if (schema) {
+                 return await schema.actions.bulkUpdate({ lastExported: new Date() });
+               }
+               return Promise.resolve(); // fallback when schema is unavailable
              },
              successToast: 'Collection exported successfully',
              errorToast: (err, {retry}) => ({
-               text: 'Export failed',
+               message: 'Export failed',
                action: { text: 'Retry', onClick: retry }
              })
            }
@@ -1014,10 +1053,16 @@ export const quickToggle: CustomActionCollectionPageActionOnRowClickResolver = (
       const updatedItem = { ...item, isActive: !item.isActive };
 
       optimisticActions.updateOne(updatedItem, {
-        submit: async (items) => schema.actions.update(items[0]),
+        submit: async (items) => {
+          // Handle potential undefined schema
+          if (schema) {
+            return await schema.actions.update(items[0]);
+          }
+          return items[0]; // fallback when schema is unavailable
+        },
         successToast: `${item.name} toggled successfully`,
         errorToast: (err, {retry}) => ({
-          text: 'Toggle failed',
+          message: 'Toggle failed',
           action: { text: 'Retry', onClick: retry }
         })
       });
@@ -1120,9 +1165,15 @@ const optimisticActions = sdk.getOptimisticActions(sdk.collectionId);
 const schema = sdk.getSchema(sdk.collectionId);
 
 optimisticActions.operation(items, {
-  submit: async (items) => schema.actions.serverMethod(items),
+  submit: async (items) => {
+    // Handle potential undefined schema
+    if (schema) {
+      return await schema.actions.serverMethod(items);
+    }
+    return items; // fallback when schema is unavailable
+  },
   successToast: 'Success message',
-  errorToast: (err, {retry}) => ({ text: 'Error message', action: { text: 'Retry', onClick: retry }})
+  errorToast: (err, {retry}) => ({ message: 'Error message', action: { text: 'Retry', onClick: retry }})
 });
 ```
 
@@ -1153,7 +1204,7 @@ interface OptimisticParams<T> {
 }
 
 interface ToastConfig {
-  text: string;
+  message: string; // Note: Use 'message' property, not 'text'
   action?: { text: string; onClick: () => void };
 }
 ```
@@ -1162,9 +1213,10 @@ interface ToastConfig {
 
 **Before using optimistic actions:**
 - Verify `sdk.getOptimisticActions(collectionId)` returns valid instance
-- Verify `sdk.getSchema(collectionId)` returns valid schema
+- **Always check for undefined schema**: `sdk.getSchema(collectionId)` can return `undefined` - handle this case in your submit functions
 - For delete operations: `showUndoToast: true` is mandatory
 - All `submit` functions must return a Promise
+- **Toast property**: Use `message` property in ToastConfig, not `text`
 
 **SDK Parameter:** Available in custom actions and modals. See SDK Utilities section for complete interface.
 
@@ -1480,11 +1532,15 @@ Custom actions execute JavaScript code that you define. These actions receive pa
          optimisticActions.updateOne(updatedItem, {
            submit: async (items) => {
              // Your download logic here + update server
-             return await schema.actions.update(items[0]);
+             // Handle potential undefined schema
+             if (schema) {
+               return await schema.actions.update(items[0]);
+             }
+             return items[0]; // fallback when schema is unavailable
            },
            successToast: 'Pet details downloaded',
            errorToast: (err, {retry}) => ({
-             text: 'Download failed',
+             message: 'Download failed',
              action: { text: 'Retry', onClick: retry }
            })
          });
@@ -1714,11 +1770,15 @@ Custom bulk actions execute JavaScript code that you define for bulk operations.
              a.click();
 
              // Update server with export timestamp
-             return await schema.actions.update(items);
+             // Handle potential undefined schema
+             if (schema) {
+               return await schema.actions.update(items);
+             }
+             return items; // fallback when schema is unavailable
            },
            successToast: `${selectedValues.length} pets exported`,
            errorToast: (err, {retry}) => ({
-             text: 'Export failed',
+             message: 'Export failed',
              action: { text: 'Retry', onClick: retry }
            })
          });
@@ -1898,8 +1958,72 @@ All entity pages must have:
 
 * Displays details for a **single entity**.
 * Always tied to a single Wix collection.
+* Supports **two distinct modes**: **view mode** and **edit mode** with separate page configurations.
+
+## Entity Page Modes
+
+AutoPatterns supports two entity page modes that can be configured as separate pages:
+
+### Edit Mode (Default)
+- **Purpose**: Allows users to modify entity data
+- **UI**: Uses `@wix/patterns` `EntityPage` component with built-in Save/Cancel actions
+- **Actions**: Only supports `moreActions` (custom actions in the "more" menu)
+- **Default Mode**: When `mode` is not specified, defaults to edit mode
+
+### View Mode
+- **Purpose**: Displays entity data in read-only format with rich action capabilities
+- **Actions**: Supports `primaryActions`, `secondaryActions`, and `moreActions` (collection-style actions)
+- **Mode**: Must be explicitly set with `mode: 'view'`
 
-> The custom actions must be defined inside the `moreActions` array.
+
+## Routing Patterns
+
+When implementing both view and edit modes for the same entity, use these routing patterns:
+
+- **View Mode**: `/entity/:entityId` (e.g., `/product/:productId`)
+- **Edit Mode**: `/entity/edit/:entityId` (e.g., `/product/edit/:productId`)
+
+This pattern allows:
+- Clear distinction between view and edit URLs
+- Natural navigation flow between modes
+
+## View Mode: Purpose and API
+
+### Purpose of View Mode
+View mode is primarily intended for **read-only entity presentation** with rich action capabilities by default; however, it also supports interactive or editable custom components if needed:
+
+- **Data Display**: Present entity information in a clean, read-only format
+- **Action Hub**: Provide primary, secondary, and more actions for entity operations
+- **Navigation Center**: Enable seamless transitions to edit mode and other workflows
+- **Rich Content**: Display images, rich text, and complex data types optimally
+
+
+See [Entity Page View Actions](./entity_page_view_actions.md) for detailed action configuration.
+
+#### Out-of-the-Box Features
+
+**Automatic Edit Navigation**: When a corresponding edit mode page exists, view mode automatically adds an "Edit [EntityName]" action to the more actions menu.
+
+**Back Navigation**: Automatic "Back" button that navigates to the parent collection page.
+
+## Action Configuration
+
+Entity page action configuration depends on the mode:
+
+- **Edit Mode**: Supports only `moreActions`. See [Entity Page Actions](./entity_page_actions.md)
+- **View Mode**: Supports full action API (`primaryActions`, `secondaryActions`, `moreActions`). See [Entity Page View Actions](./entity_page_view_actions.md)
+
+### Edit Mode Actions
+- **Supported**: `moreActions` only
+- **Built-in**: Save and Cancel actions are automatically provided
+- **Custom Actions**: Must be defined in the `moreActions` array
+
+### View Mode Actions
+- **Supported**: `primaryActions`, `secondaryActions`, and `moreActions`
+- **Pattern**: Follows collection page action patterns
+- **Flexibility**: Full control over all action areas
+
+> The custom actions must be defined inside the `moreActions` array for edit mode, but view mode supports actions in all areas.
 
 > Note: You do not need to define a custom action to navigate to the entity page. This behavior is built-in — clicking on a row in the collection table automatically navigates to the corresponding entity page.
 
@@ -1991,11 +2115,13 @@ All entity pages must have:
 
 ---
 
-## Entity Page Actions: `moreActions` Support
+## Entity Page Edit Mode Actions: `moreActions` Support
 
-Entity pages in AutoPatternsApp support not only a primary action (such as "Save" or "Delete") but also a flexible set of **more actions** (sometimes called "secondary actions" or `moreActions`). These allow you to provide additional contextual actions for the entity, such as custom logic, or grouped actions.
+Entity pages in **edit mode** support not only built-in actions (such as "Save" and "Cancel") but also a flexible set of **more actions** (sometimes called "secondary actions" or `moreActions`). These allow you to provide additional contextual actions for the entity, such as custom logic, or grouped actions.
 
-> **Note:** All custom actions for entity pages must be placed in the `moreActions` array. Do not place custom actions as primary actions on entity pages. The `moreActions` array is the only supported location for custom actions on entity pages.
+> **Note:** This documentation covers **edit mode** entity pages only. Edit mode supports only `moreActions`. For **view mode** entity pages that support `primaryActions`, `secondaryActions`, and `moreActions`, see [Entity Page View Actions](./entity_page_view_actions.md).
+
+> **Edit Mode Limitation:** All custom actions for edit mode entity pages must be placed in the `moreActions` array. Do not place custom actions as primary actions on edit mode entity pages. The `moreActions` array is the only supported location for custom actions on edit mode entity pages.
 
 ### Configuration Structure
 
@@ -2032,16 +2158,16 @@ Entity pages in AutoPatternsApp support not only a primary action (such as "Save
 
 ---
 
-### CustomEntityPageMoreActionsActionResolver
+### CustomEntityPageActionResolver
 
-The `CustomEntityPageMoreActionsActionResolver` type is used to implement custom actions for the `moreActions` menu on entity pages in AutoPatternsApp. Each action in the `moreActions` array must have a corresponding resolver function registered in your overrides.
+The `CustomEntityPageActionResolver` type is used to implement custom actions for the `moreActions` menu on entity pages in AutoPatternsApp. Each action in the `moreActions` array must have a corresponding resolver function registered in your overrides.
 
 #### Function Signature
 
 ```typescript
-import { CustomEntityPageMoreActionsActionResolver } from '@wix/auto-patterns/types';
+import { CustomEntityPageActionResolver } from '@wix/auto-patterns/types';
 
-export const myMoreAction: CustomEntityPageMoreActionsActionResolver = (params) => {
+export const myMoreAction: CustomEntityPageActionResolver = (params) => {
   const { actionParams: { entity, form } , sdk } = params;
 
   return {
@@ -2060,10 +2186,10 @@ export const myMoreAction: CustomEntityPageMoreActionsActionResolver = (params)
 
 ---
 
-#### Key Points for CustomEntityPageMoreActionsActionResolver
+#### Key Points for CustomEntityPageActionResolver
 
 - The action `id` in the configuration MUST exactly match the function name exported from your actions folder.
-- The implementation must use the `CustomEntityPageMoreActionsActionResolver` type.
+- The implementation must use the `CustomEntityPageActionResolver` type.
 - The implementation must be exported as a named export (not default export).
 - The function receives `{ actionParams, sdk }` as parameters.
 - The returned object must include at least a `label` and an `onClick` handler (optionally an `icon`).
@@ -2076,13 +2202,153 @@ export const myMoreAction: CustomEntityPageMoreActionsActionResolver = (params)
 ✓ 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 function signature matches `CustomEntityPageMoreActionsActionResolver`
+✓ The function signature matches `CustomEntityPageActionResolver`
 ✓ The returned object includes `label`, `onClick`, and optionally `icon`
 
 ---
 
 **Summary:**
-The `CustomEntityPageMoreActionsActionResolver` enables you to add custom, contextual actions to the "More Actions" menu on your entity pages. Implement the resolver, export it, and reference it by `id` in your config for seamless integration.
+The `CustomEntityPageActionResolver` enables you to add custom, contextual actions to the "More Actions" menu on your entity pages. Implement the resolver, export it, and reference it by `id` in your config for seamless integration.
+
+---
+
+# Entity Page View Mode Actions
+
+View mode supports the complete collection-style actions API, providing maximum flexibility for entity operations.
+
+## Supported Action Types
+
+### Primary Actions
+The main call-to-action, typically for the most common operation:
+
+```typescript
+primaryActions: {
+  type: 'action',
+  action: {
+    item: {
+      id: 'createEntity',
+      label: 'Create New',
+      type: 'create',
+      create: {
+        mode: 'page',
+        page: { id: 'EntityEditPageId' }
+      }
+    }
+  }
+}
+```
+
+### Secondary Actions
+Supporting actions displayed alongside primary actions:
+
+```typescript
+secondaryActions: {
+  type: 'action',
+  action: {
+    item: {
+      id: 'duplicateEntity',
+      label: 'Duplicate',
+      type: 'custom',
+    }
+  }
+}
+```
+
+### More Actions
+Additional contextual actions in dropdown menu:
+
+```typescript
+moreActions: [
+  {
+    id: 'shareEntity',
+    type: 'custom',
+    label: 'Share',
+  }
+]
+```
+
+## Action Menu Support
+
+View mode also supports menu-style actions for grouping related operations:
+
+```typescript
+primaryActions: {
+  type: 'menu',
+  menu: {
+    label: 'Actions',
+    items: [
+      {
+        id: 'duplicateProduct',
+        label: 'Duplicate',
+        type: 'custom',
+      },
+      { type: 'divider' },
+      {
+        id: 'shareProduct',
+        type: 'custom',
+        label: 'Share'
+      }
+    ]
+  }
+}
+```
+
+## Automatic Edit Action
+
+View mode automatically provides an "Edit [EntityName]" action in the more actions menu when:
+- An edit mode page exists for the same collection
+- The edit page has no explicit mode or `mode: 'edit'`
+- The view page has `mode: 'view'`
+
+This action is automatically added and doesn't need to be configured manually.
+
+## Action Resolvers
+
+View mode actions follow the same resolver patterns as collection page actions:
+
+### For Standard Actions (create)
+These actions are handled automatically by the AutoPatterns framework using the configuration provided.
+
+### For Custom Actions
+Custom actions require resolver implementations:
+
+```typescript
+import { CustomEntityPageActionResolver } from '@wix/auto-patterns/types';
+
+export const duplicateProduct: CustomEntityPageActionResolver = (params) => {
+  const { actionParams: { entity }, sdk } = params;
+
+  const schema = sdk.getSchema(sdk.collectionId);
+  return {
+    label: 'Duplicate Product',
+    icon: <DuplicateIcon />, // optional
+    onClick: async () => {
+      // Your custom duplication logic here
+      await schema.actions.create({
+        ...entity,
+        name: `${entity.name} (Copy)`
+      });
+    },
+  };
+};
+```
+
+## Best Practices
+
+### When to Use Each Action Type
+
+**Primary Actions**: Use for the most common user action (typically "Create" or main workflow action)
+
+**Secondary Actions**: Use for supporting workflows like "Duplicate"
+
+**More Actions**: Use for:
+- Less common operations
+- Administrative functions
+- Actions that need confirmation
+
+### Navigation Patterns
+
+1. **View → Create**: Use primary actions with `type: 'create'`
 
 ---
 

package/dist/docs/bulk_actions.md

@@ -106,11 +106,15 @@ Custom bulk actions execute JavaScript code that you define for bulk operations.
              a.click();
 
              // Update server with export timestamp
-             return await schema.actions.update(items);
+             // Handle potential undefined schema
+             if (schema) {
+               return await schema.actions.update(items);
+             }
+             return items; // fallback when schema is unavailable
            },
            successToast: `${selectedValues.length} pets exported`,
            errorToast: (err, {retry}) => ({
-             text: 'Export failed',
+             message: 'Export failed',
              action: { text: 'Retry', onClick: retry }
            })
          });

package/dist/docs/collection_page_actions.md

@@ -87,11 +87,15 @@ Custom collection page actions execute JavaScript code that you define for colle
                // Your collection export logic here
                console.log(`Exporting collection: ${collectionId}`);
                // Export and update all items on server
-               return await schema.actions.bulkUpdate({ lastExported: new Date() });
+               // Handle potential undefined schema
+               if (schema) {
+                 return await schema.actions.bulkUpdate({ lastExported: new Date() });
+               }
+               return Promise.resolve(); // fallback when schema is unavailable
              },
              successToast: 'Collection exported successfully',
              errorToast: (err, {retry}) => ({
-               text: 'Export failed',
+               message: 'Export failed',
                action: { text: 'Retry', onClick: retry }
              })
            }
@@ -314,10 +318,16 @@ export const quickToggle: CustomActionCollectionPageActionOnRowClickResolver = (
       const updatedItem = { ...item, isActive: !item.isActive };
 
       optimisticActions.updateOne(updatedItem, {
-        submit: async (items) => schema.actions.update(items[0]),
+        submit: async (items) => {
+          // Handle potential undefined schema
+          if (schema) {
+            return await schema.actions.update(items[0]);
+          }
+          return items[0]; // fallback when schema is unavailable
+        },
         successToast: `${item.name} toggled successfully`,
         errorToast: (err, {retry}) => ({
-          text: 'Toggle failed',
+          message: 'Toggle failed',
           action: { text: 'Retry', onClick: retry }
         })
       });