@wix/auto-patterns 1.27.0 → 1.28.0

package/dist/cjs/types/CollectionPageConfig.js.map

@@ -1 +1 @@
-{"version":3,"names":["ComponentTypeEnum","exports"],"sources":["../../../src/types/CollectionPageConfig.ts"],"sourcesContent":["import { CollectionToolbarFiltersProps } from '@wix/patterns';\nimport { DateRangeFilterMode, DateRangeOptions } from '@wix/patterns/core';\nimport { BaseCollectionConfig } from './types';\nimport {\n  ActionCellConfig,\n  BulkActionsConfig,\n  CollectionPageOnRowClickActionConfig,\n  CollectionPagePrimaryActions,\n  CollectionPageSecondaryActions,\n} from './actions';\n\nexport interface CollectionPageTitle {\n  text: string;\n  hideTotal?: boolean;\n}\n\nexport interface CollectionPageSubtitle {\n  text: string;\n  learnMore?: {\n    url: string;\n    label?: string;\n  };\n}\n\nexport interface CollectionPageConfig {\n  route: {\n    path: string;\n  };\n  title: CollectionPageTitle;\n  subtitle?: CollectionPageSubtitle;\n  actions?: {\n    primaryActions?: CollectionPagePrimaryActions;\n    secondaryActions?: CollectionPageSecondaryActions;\n  };\n  components: ComponentConfig[];\n}\n\nexport interface CollectionComponentConfig\n  extends BaseCollectionComponentConfig {\n  type: 'collection';\n  layout: LayoutItemConfig[];\n}\n\nexport interface CustomComponentConfig {\n  type: 'custom';\n  id: string;\n}\n\nexport type ComponentConfig = CollectionComponentConfig | CustomComponentConfig;\n\nexport interface LayoutItemConfig {\n  type: 'Table' | 'Grid';\n  table?: TableSpecificConfig;\n  grid?: GridSpecificConfig;\n}\n\nexport type ColumnsConfig = Column[];\n\nexport interface TableSpecificConfig {\n  columns: ColumnsConfig;\n  customColumns?: {\n    enabled: boolean;\n  };\n  stickyColumns?: number;\n  onRowClick?: CollectionPageOnRowClickActionConfig;\n  showTitleBar?: boolean;\n  sections?: {\n    id: string;\n  };\n}\n\nexport interface GridSpecificConfig {\n  item: GridItem;\n}\n\nexport interface TableConfig\n  extends BaseCollectionComponentConfig,\n    TableSpecificConfig {}\nexport interface GridConfig\n  extends BaseCollectionComponentConfig,\n    GridSpecificConfig {}\nexport interface TableGridSwitchConfig\n  extends BaseCollectionComponentConfig,\n    TableSpecificConfig,\n    GridSpecificConfig {}\n\nexport type CollectionConfig = BaseCollectionConfig & {\n  limit?: number;\n  reflectQueryInUrl?: boolean;\n  selectAllScope?: 'page' | 'all';\n  selectionUpdateMode?: 'preserve' | 'clear';\n};\n\nexport interface BaseCollectionComponentConfig {\n  collection: CollectionConfig;\n  entityPageId?: string;\n  search?: { shown?: boolean };\n  toolbarTitle?: ToolbarTitle;\n  actionCell?: ActionCellConfig;\n  emptyState?: EmptyState;\n  filters?: FiltersConfig;\n  bulkActionToolbar?: BulkActionsConfig;\n}\n\nexport interface ToolbarTitle {\n  title: string;\n  subtitle?: {\n    text: string;\n    info?: {\n      content: {\n        text: string;\n        link?: {\n          url: string;\n          label: string;\n        };\n      };\n    };\n    learnMore?: {\n      url: string;\n      label?: string;\n    };\n  };\n  showTotal?: boolean;\n  itemsLimit?: number;\n}\n\nexport interface Column {\n  id: string;\n  name: string;\n  width: string;\n  sortable?: boolean;\n  defaultSortOrder?: 'asc' | 'desc';\n  sortMode?: 'asc' | 'desc';\n  defaultHidden?: boolean;\n  hiddenFromCustomColumnsSelection?: boolean;\n  hideable?: boolean;\n  reorderDisabled?: boolean;\n}\n\nexport interface GridItem {\n  titleFieldId: string;\n  subtitleFieldId?: string;\n  imageFieldId?: string;\n  cardContentMode?: 'full' | 'title' | 'empty'; // Footer is not supported in auto-patterns\n  imagePlacement?: 'top' | 'side';\n}\n\nexport interface EmptyState {\n  title?: string;\n  subtitle?: string;\n  image?: {\n    id: string;\n  };\n  addNewCta?: {\n    id?: string;\n    text?: string;\n  };\n  customCta?: {\n    id?: string;\n  };\n}\n\nexport interface FilterOption {\n  value: string;\n  label: string;\n}\n\nexport type FilterSelectionMode = 'single' | 'multiple';\nexport type FilterOptionType =\n  | 'checkbox'\n  | 'inlineCheckbox'\n  | 'radio'\n  | 'select';\n\nexport enum ComponentTypeEnum {\n  SINGLE = 'single',\n  MULTI_SELECT = 'multi-select',\n  RADIO_GROUP = 'radio-group',\n  NUMBER = 'number',\n  DATE_RANGE = 'date-range',\n}\n\nexport type FilterItems = Filter[];\nexport interface FiltersConfig {\n  items: FilterItems;\n  maxInlineFilters?: CollectionToolbarFiltersProps['inline'];\n  panelTitle?: string;\n}\n\nexport interface BaseOptionsFilterConfig {\n  selectionMode: FilterSelectionMode;\n}\n\nexport interface DateFilterConfig {\n  mode?: DateRangeFilterMode;\n  presets?: DateRangeOptions;\n  includeTime?: boolean;\n}\n\nexport interface NumberFilterConfig {\n  min?: number;\n  max?: number;\n  allowedDecimals?: boolean;\n}\n\nexport interface BooleanFilterConfig {\n  trueLabel?: string;\n  falseLabel?: string;\n}\n\nexport interface EnumFilterConfig extends BaseOptionsFilterConfig {\n  options: FilterOption[];\n  optionType?: FilterOptionType;\n}\n\nexport interface DynamicOptionsFilterConfig extends BaseOptionsFilterConfig {}\n\nexport interface Filter {\n  id: string;\n  fieldId: string;\n  displayName?: string;\n  sectionTitle?: string;\n  openByDefault?: boolean;\n  tagLabel?: string;\n  numberConfig?: NumberFilterConfig;\n  dateConfig?: DateFilterConfig;\n  booleanConfig?: BooleanFilterConfig;\n  enumConfig?: EnumFilterConfig;\n  dynamicOptionsConfig?: DynamicOptionsFilterConfig;\n}\n"],"mappings":";;;;IA8KYA,iBAAiB,GAAAC,OAAA,CAAAD,iBAAA,0BAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAA,OAAjBA,iBAAiB;AAAA","ignoreList":[]}
+{"version":3,"names":["ComponentTypeEnum","exports"],"sources":["../../../src/types/CollectionPageConfig.ts"],"sourcesContent":["import { CollectionToolbarFiltersProps } from '@wix/patterns';\nimport { DateRangeFilterMode, DateRangeOptions } from '@wix/patterns/core';\nimport { BaseCollectionConfig } from './types';\nimport {\n  ActionCellConfig,\n  BulkActionsConfig,\n  CollectionPageOnRowClickActionConfig,\n  CollectionPagePrimaryActions,\n  CollectionPageSecondaryActions,\n} from './actions';\n\nexport interface CollectionPageTitle {\n  text: string;\n  hideTotal?: boolean;\n}\n\nexport interface CollectionPageSubtitle {\n  text: string;\n  learnMore?: {\n    url: string;\n    label?: string;\n  };\n}\n\nexport interface CollectionPageConfig {\n  route: {\n    path: string;\n  };\n  title: CollectionPageTitle;\n  subtitle?: CollectionPageSubtitle;\n  actions?: {\n    primaryActions?: CollectionPagePrimaryActions;\n    secondaryActions?: CollectionPageSecondaryActions;\n  };\n  components: ComponentConfig[];\n}\n\nexport interface CollectionComponentConfig\n  extends BaseCollectionComponentConfig {\n  type: 'collection';\n  layout: LayoutItemConfig[];\n}\n\nexport interface CustomComponentConfig {\n  type: 'custom';\n  id: string;\n}\n\nexport type ComponentConfig = CollectionComponentConfig | CustomComponentConfig;\n\nexport interface LayoutItemConfig {\n  type: 'Table' | 'Grid';\n  table?: TableSpecificConfig;\n  grid?: GridSpecificConfig;\n}\n\nexport type ColumnsConfig = Column[];\n\nexport interface TableSpecificConfig {\n  columns: ColumnsConfig;\n  customColumns?: {\n    enabled: boolean;\n  };\n  stickyColumns?: number;\n  onRowClick?: CollectionPageOnRowClickActionConfig;\n  showTitleBar?: boolean;\n  sections?: {\n    id: string;\n  };\n}\n\nexport interface GridSpecificConfig {\n  item: GridItem;\n}\n\nexport interface TableConfig\n  extends BaseCollectionComponentConfig,\n    TableSpecificConfig {}\nexport interface GridConfig\n  extends BaseCollectionComponentConfig,\n    GridSpecificConfig {}\nexport interface TableGridSwitchConfig\n  extends BaseCollectionComponentConfig,\n    TableSpecificConfig,\n    GridSpecificConfig {}\n\nexport type CollectionConfig = BaseCollectionConfig & {\n  limit?: number;\n  reflectQueryInUrl?: boolean;\n  selectAllScope?: 'page' | 'all';\n  selectionUpdateMode?: 'preserve' | 'clear';\n  optimisticActions?: {\n    id: string;\n  };\n  paginationMode?: 'cursor' | 'offset';\n};\n\nexport interface BaseCollectionComponentConfig {\n  collection: CollectionConfig;\n  entityPageId?: string;\n  search?: { shown?: boolean };\n  toolbarTitle?: ToolbarTitle;\n  actionCell?: ActionCellConfig;\n  emptyState?: EmptyState;\n  filters?: FiltersConfig;\n  bulkActionToolbar?: BulkActionsConfig;\n}\n\nexport interface ToolbarTitle {\n  title: string;\n  subtitle?: {\n    text: string;\n    info?: {\n      content: {\n        text: string;\n        link?: {\n          url: string;\n          label: string;\n        };\n      };\n    };\n    learnMore?: {\n      url: string;\n      label?: string;\n    };\n  };\n  showTotal?: boolean;\n  itemsLimit?: number;\n}\n\nexport interface Column {\n  id: string;\n  name: string;\n  width: string;\n  sortable?: boolean;\n  defaultSortOrder?: 'asc' | 'desc';\n  sortMode?: 'asc' | 'desc';\n  defaultHidden?: boolean;\n  hiddenFromCustomColumnsSelection?: boolean;\n  hideable?: boolean;\n  reorderDisabled?: boolean;\n}\n\nexport interface GridItem {\n  titleFieldId: string;\n  subtitleFieldId?: string;\n  imageFieldId?: string;\n  cardContentMode?: 'full' | 'title' | 'empty'; // Footer is not supported in auto-patterns\n  imagePlacement?: 'top' | 'side';\n}\n\nexport interface EmptyState {\n  title?: string;\n  subtitle?: string;\n  image?: {\n    id: string;\n  };\n  addNewCta?: {\n    id?: string;\n    text?: string;\n  };\n  customCta?: {\n    id?: string;\n  };\n}\n\nexport interface FilterOption {\n  value: string;\n  label: string;\n}\n\nexport type FilterSelectionMode = 'single' | 'multiple';\nexport type FilterOptionType =\n  | 'checkbox'\n  | 'inlineCheckbox'\n  | 'radio'\n  | 'select';\n\nexport enum ComponentTypeEnum {\n  SINGLE = 'single',\n  MULTI_SELECT = 'multi-select',\n  RADIO_GROUP = 'radio-group',\n  NUMBER = 'number',\n  DATE_RANGE = 'date-range',\n}\n\nexport type FilterItems = Filter[];\nexport interface FiltersConfig {\n  items: FilterItems;\n  maxInlineFilters?: CollectionToolbarFiltersProps['inline'];\n  panelTitle?: string;\n}\n\nexport interface BaseOptionsFilterConfig {\n  selectionMode: FilterSelectionMode;\n}\n\nexport interface DateFilterConfig {\n  mode?: DateRangeFilterMode;\n  presets?: DateRangeOptions;\n  includeTime?: boolean;\n}\n\nexport interface NumberFilterConfig {\n  min?: number;\n  max?: number;\n  allowedDecimals?: boolean;\n}\n\nexport interface BooleanFilterConfig {\n  trueLabel?: string;\n  falseLabel?: string;\n}\n\nexport interface EnumFilterConfig extends BaseOptionsFilterConfig {\n  options: FilterOption[];\n  optionType?: FilterOptionType;\n}\n\nexport interface DynamicOptionsFilterConfig extends BaseOptionsFilterConfig {}\n\nexport interface Filter {\n  id: string;\n  fieldId: string;\n  displayName?: string;\n  sectionTitle?: string;\n  openByDefault?: boolean;\n  tagLabel?: string;\n  numberConfig?: NumberFilterConfig;\n  dateConfig?: DateFilterConfig;\n  booleanConfig?: BooleanFilterConfig;\n  enumConfig?: EnumFilterConfig;\n  dynamicOptionsConfig?: DynamicOptionsFilterConfig;\n}\n"],"mappings":";;;;IAkLYA,iBAAiB,GAAAC,OAAA,CAAAD,iBAAA,0BAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAA,OAAjBA,iBAAiB;AAAA","ignoreList":[]}

package/dist/cjs/types/fetchData.js

@@ -0,0 +1,4 @@
+"use strict";
+
+exports.__esModule = true;
+//# sourceMappingURL=fetchData.js.map

package/dist/cjs/types/fetchData.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../../src/types/fetchData.ts"],"sourcesContent":["import { CursorQuery, OffsetQuery } from '@wix/patterns';\n\nexport type Mode = 'cursor' | 'offset';\n\nexport type UseFetchDataProps<M extends Mode> = {\n  searchableFieldIds?: string[];\n  filterFieldMapping?: Record<string, { fieldId: string }>;\n  paginationMode?: M;\n};\n\nexport interface CursorQueryResult {\n  items: any[];\n  cursor?: string | undefined | null;\n  total?: number | null;\n}\n\nexport interface OffsetQueryResult {\n  items: any[];\n  total?: number | null;\n  hasNext?: boolean;\n}\n\nexport type FetchDataFn<M extends Mode> = M extends 'cursor'\n  ? (q: CursorQuery<any>) => Promise<CursorQueryResult>\n  : (q: OffsetQuery<any>) => Promise<OffsetQueryResult>;\n"],"mappings":"","ignoreList":[]}

package/dist/cjs/types/index.js

@@ -43,4 +43,10 @@ Object.keys(_BaseSDK).forEach(function (key) {
   if (key in exports && exports[key] === _BaseSDK[key]) return;
   exports[key] = _BaseSDK[key];
 });
+var _fetchData = require("./fetchData");
+Object.keys(_fetchData).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _fetchData[key]) return;
+  exports[key] = _fetchData[key];
+});
 //# sourceMappingURL=index.js.map

package/dist/cjs/types/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_types","require","Object","keys","forEach","key","exports","_CollectionPageConfig","_EntityPageConfig","_providers","_actions","_types2","_BaseSDK"],"sources":["../../../src/types/index.ts"],"sourcesContent":["export * from './types';\nexport * from './CollectionPageConfig';\nexport * from './EntityPageConfig';\nexport * from './providers';\nexport * from './actions';\nexport * from '../utils/actions/types';\nexport * from './BaseSDK';\n"],"mappings":";;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,MAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,MAAA,CAAAK,GAAA;EAAAC,OAAA,CAAAD,GAAA,IAAAL,MAAA,CAAAK,GAAA;AAAA;AACA,IAAAE,qBAAA,GAAAN,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAI,qBAAA,EAAAH,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAE,qBAAA,CAAAF,GAAA;EAAAC,OAAA,CAAAD,GAAA,IAAAE,qBAAA,CAAAF,GAAA;AAAA;AACA,IAAAG,iBAAA,GAAAP,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAK,iBAAA,EAAAJ,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAG,iBAAA,CAAAH,GAAA;EAAAC,OAAA,CAAAD,GAAA,IAAAG,iBAAA,CAAAH,GAAA;AAAA;AACA,IAAAI,UAAA,GAAAR,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAM,UAAA,EAAAL,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAI,UAAA,CAAAJ,GAAA;EAAAC,OAAA,CAAAD,GAAA,IAAAI,UAAA,CAAAJ,GAAA;AAAA;AACA,IAAAK,QAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,QAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,QAAA,CAAAL,GAAA;EAAAC,OAAA,CAAAD,GAAA,IAAAK,QAAA,CAAAL,GAAA;AAAA;AACA,IAAAM,OAAA,GAAAV,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAQ,OAAA,EAAAP,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAM,OAAA,CAAAN,GAAA;EAAAC,OAAA,CAAAD,GAAA,IAAAM,OAAA,CAAAN,GAAA;AAAA;AACA,IAAAO,QAAA,GAAAX,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAS,QAAA,EAAAR,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAO,QAAA,CAAAP,GAAA;EAAAC,OAAA,CAAAD,GAAA,IAAAO,QAAA,CAAAP,GAAA;AAAA","ignoreList":[]}
+{"version":3,"names":["_types","require","Object","keys","forEach","key","exports","_CollectionPageConfig","_EntityPageConfig","_providers","_actions","_types2","_BaseSDK","_fetchData"],"sources":["../../../src/types/index.ts"],"sourcesContent":["export * from './types';\nexport * from './CollectionPageConfig';\nexport * from './EntityPageConfig';\nexport * from './providers';\nexport * from './actions';\nexport * from '../utils/actions/types';\nexport * from './BaseSDK';\nexport * from './fetchData';\n"],"mappings":";;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,MAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,MAAA,CAAAK,GAAA;EAAAC,OAAA,CAAAD,GAAA,IAAAL,MAAA,CAAAK,GAAA;AAAA;AACA,IAAAE,qBAAA,GAAAN,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAI,qBAAA,EAAAH,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAE,qBAAA,CAAAF,GAAA;EAAAC,OAAA,CAAAD,GAAA,IAAAE,qBAAA,CAAAF,GAAA;AAAA;AACA,IAAAG,iBAAA,GAAAP,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAK,iBAAA,EAAAJ,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAG,iBAAA,CAAAH,GAAA;EAAAC,OAAA,CAAAD,GAAA,IAAAG,iBAAA,CAAAH,GAAA;AAAA;AACA,IAAAI,UAAA,GAAAR,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAM,UAAA,EAAAL,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAI,UAAA,CAAAJ,GAAA;EAAAC,OAAA,CAAAD,GAAA,IAAAI,UAAA,CAAAJ,GAAA;AAAA;AACA,IAAAK,QAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,QAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,QAAA,CAAAL,GAAA;EAAAC,OAAA,CAAAD,GAAA,IAAAK,QAAA,CAAAL,GAAA;AAAA;AACA,IAAAM,OAAA,GAAAV,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAQ,OAAA,EAAAP,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAM,OAAA,CAAAN,GAAA;EAAAC,OAAA,CAAAD,GAAA,IAAAM,OAAA,CAAAN,GAAA;AAAA;AACA,IAAAO,QAAA,GAAAX,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAS,QAAA,EAAAR,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAO,QAAA,CAAAP,GAAA;EAAAC,OAAA,CAAAD,GAAA,IAAAO,QAAA,CAAAP,GAAA;AAAA;AACA,IAAAQ,UAAA,GAAAZ,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAU,UAAA,EAAAT,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAQ,UAAA,CAAAR,GAAA;EAAAC,OAAA,CAAAD,GAAA,IAAAQ,UAAA,CAAAR,GAAA;AAAA","ignoreList":[]}

package/dist/cjs/types/types.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["../../../src/types/types.ts"],"sourcesContent":["import { EntityPageConfig } from './EntityPageConfig';\nimport { CollectionPageConfig } from './CollectionPageConfig';\n\ninterface BaseCollectionConfigCommon {\n  collectionId: string;\n}\n\ninterface CMSCollectionConfig extends BaseCollectionConfigCommon {\n  entityTypeSource: 'cms';\n  custom?: never;\n}\n\ninterface CustomCollectionConfig extends BaseCollectionConfigCommon {\n  entityTypeSource: 'custom';\n  custom: {\n    id: string;\n  };\n}\n\nexport type BaseCollectionConfig = CMSCollectionConfig | CustomCollectionConfig;\n\nexport type PatternsFieldType =\n  | 'SHORT_TEXT'\n  | 'LONG_TEXT'\n  | 'NUMBER'\n  | 'BOOLEAN'\n  | 'DATE'\n  | 'DATETIME'\n  | 'URL'\n  | 'ARRAY'\n  | 'REFERENCE'\n  | 'IMAGE';\n\nexport interface AppConfig {\n  pages: PageConfig[];\n  layout?: 'panel';\n}\n\nexport interface BasePageConfig {\n  id: string;\n  appMainPage?: boolean;\n}\n\nexport interface CollectionPageConfigType extends BasePageConfig {\n  type: 'collectionPage';\n  collectionPage: CollectionPageConfig;\n  entityPage?: never;\n}\n\nexport interface EntityPageConfigType extends BasePageConfig {\n  type: 'entityPage';\n  entityPage: EntityPageConfig;\n  collectionPage?: never;\n}\n\nexport type PageConfig = CollectionPageConfigType | EntityPageConfigType;\n\nexport type EntityProps = { [key: string]: any };\n\nexport interface IMenuItem<T extends EntityProps = any> {\n  item: T;\n}\nexport interface IColumnValue<T> {\n  value: T;\n  row: Record<string, any>;\n}\n\nexport type QueryOperator =\n  | 'CONTAINS'\n  | 'ENDS_WITH'\n  | 'EQ'\n  | 'EXISTS'\n  | 'GT'\n  | 'GTE'\n  | 'HAS_ALL'\n  | 'HAS_SOME'\n  | 'LT'\n  | 'LTE'\n  | 'NE'\n  | 'STARTS_WITH'\n  | 'URLIZED';\n\ninterface BaseField {\n  id: string;\n  displayName: string;\n  validation?: {\n    numberRange?: NumberRange;\n    stringLengthRange?: StringLengthRange;\n    required: boolean;\n  };\n  capabilities: {\n    supportedQueryOperators: QueryOperator[];\n    sortable: boolean;\n  };\n}\n\nexport interface ReferenceField extends BaseField {\n  type: 'REFERENCE';\n  referenceMetadata: {\n    referencedCollectionId: string;\n  };\n}\n\nexport interface NonReferenceField extends BaseField {\n  type: Exclude<PatternsFieldType, 'REFERENCE'>;\n}\n\nexport type Field = ReferenceField | NonReferenceField;\n\nexport interface NumberRange {\n  min?: number;\n  max?: number;\n}\nexport interface StringLengthRange {\n  minLength?: number;\n  maxLength?: number;\n}\n\nexport interface Query {\n  limit: number;\n  offset: number;\n  page: number;\n  search?: string;\n  cursor?: string | null;\n  filters: Record<string, any>;\n  sort?: {\n    fieldName: string;\n    order: 'asc' | 'desc';\n  }[];\n}\n\nexport interface SchemaConfig {\n  id: string;\n  fields: Record<string, Field | undefined>;\n  displayField: string;\n  idField: string;\n  actions: {\n    get: (entityId: string) => Promise<any>;\n    create: (newEntity: Partial<any>) => Promise<any>;\n    update: (updatedEntity: any) => Promise<any>;\n    delete: (entityId: string) => Promise<any>;\n    bulkDelete: (entityIds: string[]) => Promise<any>;\n    find: (\n      query: Query,\n      options?: {\n        searchableFieldIds?: string[];\n        filterFieldMapping?: Record<string, { fieldId: string }>;\n      },\n    ) => Promise<{ items: any[]; total: number }>;\n  };\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"names":[],"sources":["../../../src/types/types.ts"],"sourcesContent":["import { EntityPageConfig } from './EntityPageConfig';\nimport { CollectionPageConfig } from './CollectionPageConfig';\nimport { useOptimisticActions } from '@wix/patterns';\nimport { CursorQueryResult, OffsetQueryResult } from './fetchData';\n\ninterface BaseCollectionConfigCommon {\n  collectionId: string;\n}\n\ninterface CMSCollectionConfig extends BaseCollectionConfigCommon {\n  entityTypeSource: 'cms';\n  custom?: never;\n}\n\ninterface CustomCollectionConfig extends BaseCollectionConfigCommon {\n  entityTypeSource: 'custom';\n  custom: {\n    id: string;\n  };\n}\n\nexport type BaseCollectionConfig = CMSCollectionConfig | CustomCollectionConfig;\n\nexport type PatternsFieldType =\n  | 'SHORT_TEXT'\n  | 'LONG_TEXT'\n  | 'NUMBER'\n  | 'BOOLEAN'\n  | 'DATE'\n  | 'DATETIME'\n  | 'URL'\n  | 'ARRAY'\n  | 'REFERENCE'\n  | 'IMAGE';\n\nexport interface AppConfig {\n  pages: PageConfig[];\n  layout?: 'panel';\n}\n\nexport interface BasePageConfig {\n  id: string;\n  appMainPage?: boolean;\n}\n\nexport interface CollectionPageConfigType extends BasePageConfig {\n  type: 'collectionPage';\n  collectionPage: CollectionPageConfig;\n  entityPage?: never;\n}\n\nexport interface EntityPageConfigType extends BasePageConfig {\n  type: 'entityPage';\n  entityPage: EntityPageConfig;\n  collectionPage?: never;\n}\n\nexport type PageConfig = CollectionPageConfigType | EntityPageConfigType;\n\nexport type EntityProps = { [key: string]: any };\n\nexport interface IMenuItem<T extends EntityProps = any> {\n  item: T;\n}\nexport interface IColumnValue<T> {\n  value: T;\n  row: Record<string, any>;\n}\n\nexport type QueryOperator =\n  | 'CONTAINS'\n  | 'ENDS_WITH'\n  | 'EQ'\n  | 'EXISTS'\n  | 'GT'\n  | 'GTE'\n  | 'HAS_ALL'\n  | 'HAS_SOME'\n  | 'LT'\n  | 'LTE'\n  | 'NE'\n  | 'STARTS_WITH'\n  | 'URLIZED';\n\ninterface BaseField {\n  id: string;\n  displayName: string;\n  validation?: {\n    numberRange?: NumberRange;\n    stringLengthRange?: StringLengthRange;\n    required: boolean;\n  };\n  capabilities: {\n    supportedQueryOperators: QueryOperator[];\n    sortable: boolean;\n  };\n}\n\nexport interface ReferenceField extends BaseField {\n  type: 'REFERENCE';\n  referenceMetadata: {\n    referencedCollectionId: string;\n  };\n}\n\nexport interface NonReferenceField extends BaseField {\n  type: Exclude<PatternsFieldType, 'REFERENCE'>;\n}\n\nexport type Field = ReferenceField | NonReferenceField;\n\nexport interface NumberRange {\n  min?: number;\n  max?: number;\n}\nexport interface StringLengthRange {\n  minLength?: number;\n  maxLength?: number;\n}\n\nexport interface Query {\n  limit: number;\n  offset?: number;\n  page: number;\n  search?: string;\n  cursor?: string | null;\n  filters: Record<string, any>;\n  sort?: {\n    fieldName: string;\n    order: 'asc' | 'desc';\n  }[];\n}\nexport interface SchemaConfig {\n  id: string;\n  fields: Record<string, Field | undefined>;\n  displayField: string;\n  idField: string;\n  actions: {\n    get: (entityId: string) => Promise<any>;\n    create: (newEntity: Partial<any>) => Promise<any>;\n    update: (updatedEntity: any) => Promise<any>;\n    delete: (entityId: string) => Promise<any>;\n    bulkDelete: (entityIds: string[]) => Promise<any>;\n    find: (\n      query: Query,\n      options?: {\n        searchableFieldIds?: string[];\n        filterFieldMapping?: Record<string, { fieldId: string }>;\n      },\n    ) => Promise<CursorQueryResult | OffsetQueryResult>;\n  };\n}\n\nexport type OptimisticActionsParams = Parameters<\n  typeof useOptimisticActions\n>[1];\n"],"mappings":"","ignoreList":[]}

package/dist/docs/app_config_structure.md

@@ -89,6 +89,7 @@ export interface AppConfig {
             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'
             selectionUpdateMode?: 'preserve' | 'clear'; // Controls selection behavior when data changes. 'preserve' maintains selections, 'clear' clears them. Default: 'clear'
+            paginationMode?: 'cursor' | 'offset'; // Controls pagination strategy and expected find() return shape. 'cursor' => { items, cursor, total? }, 'offset' (default) => { items, hasNext, total? }
           };
           filters?: {
             panelTitle?: string; // Title of the filters panel

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

@@ -167,6 +167,7 @@ export interface AppConfig {
             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'
             selectionUpdateMode?: 'preserve' | 'clear'; // Controls selection behavior when data changes. 'preserve' maintains selections, 'clear' clears them. Default: 'clear'
+            paginationMode?: 'cursor' | 'offset'; // Controls pagination strategy and expected find() return shape. 'cursor' => { items, cursor, total? }, 'offset' (default) => { items, hasNext, total? }
           };
           filters?: {
             panelTitle?: string; // Title of the filters panel
@@ -1235,19 +1236,25 @@ export interface SchemaConfig {
     update: (updatedEntity: any) => Promise<any>;
     delete: (entityId: string) => Promise<any>;
     bulkDelete: (entityIds: string[]) => Promise<any>;
+    // The return shape depends on pagination mode (see AppConfig.collection.paginationMode)
+    // - Cursor mode: { items, cursor, total? }
+    // - Offset mode (default): { items, hasNext, total? }
     find: (
       query: Query,
       options?: {
         searchableFieldIds?: string[];
         filterFieldMapping?: Record<string, { fieldId: string }>;
       },
-    ) => Promise<{ items: any[]; total: number }>;
+    ) => Promise<
+      | { items: any[]; cursor?: string | null; total?: number | null }
+      | { items: any[]; hasNext?: boolean; total?: number | null }
+    >;
   };
 }
 
 export interface Query {
   limit: number;                    // Maximum number of items to return per request (controls page size)
-  offset: number;                   // Number of items to skip from the beginning (for pagination)
+  offset?: number;                   // Number of items to skip from the beginning (for pagination)
   page: number;                     // Current page number (1-based, works with limit for pagination)
   search?: string;                  // Text search query applied to searchable fields
   cursor?: string | null;           // Cursor-based pagination token (alternative to offset-based pagination)
@@ -1346,7 +1353,9 @@ export type Field = ReferenceField | NonReferenceField;
   - `query`: Query object with pagination, filtering, sorting, and search criteria (see Query Interface section)
   - `options.searchableFieldIds`: Array of field IDs that support text search
   - `options.filterFieldMapping`: Maps filter IDs to actual field IDs for complex filtering
-  - Returns: `{ items: any[], total: number }`
+  - Returns (depends on pagination mode):
+    - Cursor mode: `{ items: any[]; cursor?: string | null; total?: number | null }`
+    - Offset mode (default): `{ items: any[]; hasNext?: boolean; total?: number | null }`
 
 ### Field Type Information
 
@@ -2833,6 +2842,7 @@ export default withDashboard(Index);
 
 - **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`
+- **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:
 
@@ -3639,22 +3649,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
 
@@ -4001,3 +3996,141 @@ export default function YourPage() {
 Slots provide a powerful way to enhance collection pages with custom functionality while maintaining the structure and features of the AutoPatterns system.
 
 ---
+
+# 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/custom_overrides.md

@@ -4,6 +4,7 @@
 
 - **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`
+- **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:
 
@@ -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
 

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

@@ -74,6 +74,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/schema_config.md

@@ -16,19 +16,25 @@ export interface SchemaConfig {
     update: (updatedEntity: any) => Promise<any>;
     delete: (entityId: string) => Promise<any>;
     bulkDelete: (entityIds: string[]) => Promise<any>;
+    // The return shape depends on pagination mode (see AppConfig.collection.paginationMode)
+    // - Cursor mode: { items, cursor, total? }
+    // - Offset mode (default): { items, hasNext, total? }
     find: (
       query: Query,
       options?: {
         searchableFieldIds?: string[];
         filterFieldMapping?: Record<string, { fieldId: string }>;
       },
-    ) => Promise<{ items: any[]; total: number }>;
+    ) => Promise<
+      | { items: any[]; cursor?: string | null; total?: number | null }
+      | { items: any[]; hasNext?: boolean; total?: number | null }
+    >;
   };
 }
 
 export interface Query {
   limit: number;                    // Maximum number of items to return per request (controls page size)
-  offset: number;                   // Number of items to skip from the beginning (for pagination)
+  offset?: number;                   // Number of items to skip from the beginning (for pagination)
   page: number;                     // Current page number (1-based, works with limit for pagination)
   search?: string;                  // Text search query applied to searchable fields
   cursor?: string | null;           // Cursor-based pagination token (alternative to offset-based pagination)
@@ -127,7 +133,9 @@ export type Field = ReferenceField | NonReferenceField;
   - `query`: Query object with pagination, filtering, sorting, and search criteria (see Query Interface section)
   - `options.searchableFieldIds`: Array of field IDs that support text search
   - `options.filterFieldMapping`: Maps filter IDs to actual field IDs for complex filtering
-  - Returns: `{ items: any[], total: number }`
+  - Returns (depends on pagination mode):
+    - Cursor mode: `{ items: any[]; cursor?: string | null; total?: number | null }`
+    - Offset mode (default): `{ items: any[]; hasNext?: boolean; total?: number | null }`
 
 ### Field Type Information
 

package/dist/docs/wix_fqdn_custom_data_source.md

@@ -114,6 +114,7 @@ Follow the complete custom data source implementation guide in the "Custom Overr
 1. **Import the client library** identified in Step 2
 2. **Use the field mappings** from Step 3 in your SchemaConfig
 3. **⚠️ CRITICAL: DO NOT IMPLEMENT THE ACTIONS** - Instead, add guidance comments explaining how to use the imported client library for each CRUD operation, then throw an "unimplemented exception" error
+4. **⚠️ CRITICAL: Add Error Handling** - When implementing the actions, you MUST wrap all HTTP requests with proper error handling using `errorHandler` from `@wix/essentials` (see "Error Handling for HTTP Requests" section)
 
 **Important**: The schema actions should contain helpful comments but NOT actual implementations. Each action should throw an error indicating it's unimplemented and needs to be implemented by the user.
 
@@ -123,6 +124,8 @@ Create your custom data source with the hook pattern:
 
 In `components/customDataSources/myCustomDataSource.ts`:
 ```typescript
+import { errorHandler } from '@wix/essentials';
+
 export const myCustomDataSource = async (collectionId: string, context: any) => {
   return {
     id: 'myCustomCollection',
@@ -134,37 +137,76 @@ export const myCustomDataSource = async (collectionId: string, context: any) =>
     actions: {
       get: async (entityId: string) => {
         // TODO: Implement using your FQDN client library
-        // Example: const result = await yourFQDNClient.getEntity(entityId);
+        // Example:
+        // return errorHandler.withErrorHandler(
+        //   async () => {
+        //     return yourFQDNClient.getEntity(entityId);
+        //   },
+        //   {}
+        // );
         // Remember to map the response fields from snake_case to camelCase
         throw new Error('get action not implemented - user must implement this method');
       },
       create: async (newEntity: any) => {
         // TODO: Implement using your FQDN client library
-        // Example: const result = await yourFQDNClient.createEntity(newEntity);
+        // Example:
+        // return errorHandler.withErrorHandler(
+        //   async () => {
+        //     return yourFQDNClient.createEntity(newEntity);
+        //   },
+        //   {}
+        // );
         // Remember to map the request fields from camelCase to snake_case
         throw new Error('create action not implemented - user must implement this method');
       },
       update: async (updatedEntity: any) => {
         // TODO: Implement using your FQDN client library
-        // Example: const result = await yourFQDNClient.updateEntity(updatedEntity);
+        // Example:
+        // return errorHandler.withErrorHandler(
+        //   async () => {
+        //     return yourFQDNClient.updateEntity(updatedEntity);
+        //   },
+        //   {}
+        // );
         // Remember to map the request fields from camelCase to snake_case
         throw new Error('update action not implemented - user must implement this method');
       },
       delete: async (entityId: string) => {
         // TODO: Implement using your FQDN client library
-        // Example: await yourFQDNClient.deleteEntity(entityId);
+        // Example:
+        // return errorHandler.withErrorHandler(
+        //   async () => {
+        //     return yourFQDNClient.deleteEntity(entityId);
+        //   },
+        //   {}
+        // );
         throw new Error('delete action not implemented - user must implement this method');
       },
       bulkDelete: async (entityIds: string[]) => {
         // TODO: Implement using your FQDN client library
-        // Example: await yourFQDNClient.bulkDeleteEntities(entityIds);
+        // Example:
+        // return errorHandler.withErrorHandler(
+        //   async () => {
+        //     return yourFQDNClient.bulkDeleteEntities(entityIds);
+        //   },
+        //   {}
+        // );
         throw new Error('bulkDelete action not implemented - user must implement this method');
       },
       find: async (query: Query, options?: any) => {
         // TODO: Implement using your FQDN client library
-        // Example: const result = await yourFQDNClient.queryEntities(query, options);
+        // Example:
+        // return errorHandler.withErrorHandler(
+        //   async () => {
+        //     return yourFQDNClient.queryEntities(query, options);
+        //   },
+        //   {}
+        // );
         // Remember to map the response fields from snake_case to camelCase
-        // Must return: { items: any[], total: number }
+        // IMPORTANT: Return shape depends on pagination mode.
+        // Detect by presence of query.cursor (cursor mode) vs. query.offset/page (offset mode):
+        // - Cursor mode: return { items, cursor, total? }
+        // - Offset mode (default): return { items, hasNext, total? }
         throw new Error('find action not implemented - user must implement this method');
       }
     }

package/dist/esm/dataSourceAdapters/cms/fetchCmsData.js

@@ -31,7 +31,7 @@ export async function fetchCmsData(collectionId, query, fields, options) {
   if (referenceFieldIds.length > 0) {
     dataQuery = dataQuery.include(...referenceFieldIds);
   }
-  const res = await dataQuery.skip(query.offset).limit(query.limit).find({
+  const res = await dataQuery.skip(query.offset ?? 0).limit(query.limit).find({
     returnTotalCount: true
   });
   return {