@jay-framework/wix-data 0.15.0

package/dist/index.d.ts

@@ -0,0 +1,633 @@
+import { WixClient } from '@wix/sdk';
+import * as _jay_framework_fullstack_component from '@jay-framework/fullstack-component';
+import { PageProps, DynamicContractProps, UrlParams } from '@jay-framework/fullstack-component';
+import { items, collections } from '@wix/data';
+import { DataCollection } from '@wix/auto_sdk_data_collections';
+import { BuildDescriptors } from '@wix/sdk-types';
+import * as _jay_framework_runtime from '@jay-framework/runtime';
+import * as _jay_framework_component from '@jay-framework/component';
+import { WixDataItem } from '@wix/wix-data-items-sdk';
+import { PluginSetupContext, PluginSetupResult, PluginReferencesContext, PluginReferencesResult } from '@jay-framework/stack-server-runtime';
+
+/**
+ * Wix Data Plugin Configuration Types
+ *
+ * Defines the structure for wix-data.config.yaml
+ */
+interface WixDataConfig {
+    collections: CollectionConfig[];
+}
+interface CollectionConfig {
+    /** Wix Data collection ID */
+    collectionId: string;
+    /**
+     * Whether this collection is visible (generates contracts).
+     * Default: false (hidden) - must be explicitly enabled.
+     */
+    visible?: boolean;
+    /** URL path prefix (e.g., "/blog" for blog posts) */
+    pathPrefix: string;
+    /** Field to use as URL slug (required for routing) */
+    slugField: string;
+    /** Reference field configurations */
+    references?: ReferenceConfig[];
+    /** Category configuration (for category pages) */
+    category?: CategoryConfig;
+    /** Components to generate with optional field whitelists */
+    components: ComponentsConfig;
+}
+interface ReferenceConfig {
+    /** Reference field name in the collection */
+    fieldName: string;
+    /**
+     * How to handle the reference:
+     * - 'embed': Fetch referenced item(s) and include full data
+     * - 'link': Include only the reference ID (default)
+     */
+    mode: 'embed' | 'link';
+    /**
+     * Nested reference configurations for multi-level embeds.
+     * Only applicable when mode is 'embed'.
+     * Allows embedding references within the referenced collection.
+     */
+    references?: ReferenceConfig[];
+}
+interface CategoryConfig {
+    /** Multi-reference field that links to category collection */
+    referenceField: string;
+    /** Field in category collection to use as slug for URLs */
+    categorySlugField: string;
+}
+/**
+ * Component configuration - either a boolean or an object with field whitelist.
+ * - `true`: Generate component with all applicable fields
+ * - `false` or omitted: Don't generate component
+ * - `{ fields: [...] }`: Generate component with only whitelisted fields
+ */
+type ComponentConfig = boolean | {
+    /** Whitelist of field keys to include. If omitted, all fields included. */
+    fields?: string[];
+};
+interface ComponentsConfig {
+    /** Generate item page component */
+    itemPage?: ComponentConfig;
+    /** Generate index page component (list all items) */
+    indexPage?: ComponentConfig;
+    /** Generate category page component (items by category) */
+    categoryPage?: ComponentConfig;
+    /** Generate table widget component */
+    tableWidget?: ComponentConfig;
+    /** Generate card widget component */
+    cardWidget?: ComponentConfig;
+}
+/**
+ * Validated configuration with collection schemas loaded
+ */
+interface ResolvedWixDataConfig extends WixDataConfig {
+    /** Collection schemas fetched from Wix Data API */
+    schemas: Map<string, CollectionSchema>;
+}
+/**
+ * Collection schema from Wix Data API
+ */
+interface CollectionSchema {
+    _id: string;
+    displayName?: string;
+    fields: FieldSchema[];
+}
+/**
+ * Field schema from Wix Data API
+ */
+interface FieldSchema {
+    key: string;
+    displayName?: string;
+    type: WixDataFieldType;
+    required?: boolean;
+}
+/**
+ * Wix Data field types
+ * @see https://dev.wix.com/docs/sdk/backend-modules/data/collections/data-types-in-wix-data
+ */
+type WixDataFieldType = 'TEXT' | 'NUMBER' | 'BOOLEAN' | 'DATE' | 'DATETIME' | 'TIME' | 'RICH_TEXT' | 'URL' | 'IMAGE' | 'VIDEO' | 'AUDIO' | 'DOCUMENT' | 'REFERENCE' | 'MULTI_REFERENCE' | 'ARRAY' | 'OBJECT' | 'TAGS' | 'ADDRESS' | 'RICH_CONTENT';
+
+/**
+ * Configuration Loader for Wix Data Plugin
+ *
+ * Loads wix-data config from /config/wix-data.yaml.
+ * If no config exists, generates a default config from the Wix Data API and saves it.
+ */
+
+/**
+ * Load the wix-data configuration.
+ *
+ * - If config file exists: load and parse it
+ * - If config file doesn't exist: generate default config from Wix API and save it
+ *
+ * @param wixClient - Authenticated Wix client for fetching collections
+ */
+declare function loadConfig(wixClient: WixClient): Promise<WixDataConfig>;
+/**
+ * Validate a collection configuration
+ */
+declare function validateCollectionConfig(config: CollectionConfig): string[];
+/**
+ * Validate the entire configuration
+ */
+declare function validateConfig(config: WixDataConfig): string[];
+/**
+ * Get visible collections from config
+ */
+declare function getVisibleCollections(config: WixDataConfig): CollectionConfig[];
+
+/**
+ * Processed Schema
+ *
+ * Intermediate representation of a collection schema with processed fields.
+ * Created once from Wix Data API response and reused by all contract generators.
+ */
+
+/**
+ * Processed field with normalized types
+ */
+interface ProcessedField {
+    key: string;
+    displayName?: string;
+    jayType: string;
+    wixType: string;
+    /** Field category for filtering */
+    category: 'simple' | 'image' | 'media' | 'address' | 'reference' | 'multiReference' | 'richContent' | 'system';
+    /** Whether this reference should be embedded (full data fetched) */
+    embedded?: boolean;
+    /**
+     * For embedded references: the processed schema of the referenced collection.
+     * Enables generating full sub-contracts from the referenced collection's fields.
+     */
+    embeddedSchema?: ProcessedSchema;
+    /** Reference configuration (for embedded refs, includes nested references) */
+    referenceConfig?: ReferenceConfig;
+}
+/**
+ * Processed schema ready for contract generation
+ */
+interface ProcessedSchema {
+    collectionId: string;
+    displayName?: string;
+    config: CollectionConfig;
+    /** All fields with processed metadata */
+    fields: ProcessedField[];
+    /** Whether this collection has category support */
+    hasCategory: boolean;
+    /** Category configuration if present */
+    category?: {
+        referenceField: string;
+        categorySlugField: string;
+    };
+}
+/**
+ * Collection fetcher function type - used for fetching referenced collections
+ */
+type CollectionFetcher = (collectionId: string) => Promise<DataCollection | null>;
+/**
+ * Process a DataCollection from Wix Data API into our intermediate representation.
+ *
+ * @param collection - DataCollection from Wix Data API
+ * @param config - Collection configuration
+ * @param collectionFetcher - Optional function to fetch collections for embedded references
+ */
+declare function processSchema(collection: DataCollection, config: CollectionConfig, collectionFetcher?: CollectionFetcher): Promise<ProcessedSchema>;
+
+type ItemsClient = BuildDescriptors<typeof items, {}>;
+type CollectionsClient = BuildDescriptors<typeof collections, {}>;
+/**
+ * Wix Data Service interface
+ *
+ * Provides access to Wix Data APIs, configuration, and cached schemas.
+ */
+interface WixDataService {
+    /** Wix Data Items API client */
+    items: ItemsClient;
+    /** Wix Data Collections API client */
+    collections: CollectionsClient;
+    /** Plugin configuration */
+    config: WixDataConfig;
+    /**
+     * Get configuration for a specific collection
+     */
+    getCollectionConfig(collectionId: string): CollectionConfig | undefined;
+    /**
+     * Get DataCollection from Wix API (cached)
+     */
+    getCollection(collectionId: string): Promise<DataCollection | null>;
+    /**
+     * Get processed schema for a collection (cached)
+     * Returns null if collection not found
+     */
+    getProcessedSchema(collectionId: string): Promise<ProcessedSchema | null>;
+    /**
+     * Get all processed schemas for collections matching a filter
+     */
+    getProcessedSchemas(filter: (config: CollectionConfig) => boolean): Promise<ProcessedSchema[]>;
+}
+/**
+ * Server service marker for Wix Data.
+ * Use with `.withServices(WIX_DATA_SERVICE_MARKER)` in component definitions.
+ */
+declare const WIX_DATA_SERVICE_MARKER: _jay_framework_fullstack_component.ServiceMarker<WixDataService>;
+/**
+ * Creates, registers, and returns a Wix Data service instance.
+ * Called during server initialization.
+ *
+ * @param wixClient - Authenticated Wix SDK client
+ * @param config - Plugin configuration
+ */
+declare function provideWixDataService(wixClient: WixClient, config: WixDataConfig): WixDataService;
+
+/**
+ * Data passed from server to client during initialization
+ */
+interface WixDataInitData {
+    /** Collection IDs that are configured */
+    collections: string[];
+}
+/**
+ * Client-side Wix Data context interface
+ * Exposes the Wix Data items API directly
+ */
+interface WixDataContext {
+    /** Wix Data Items API client */
+    items: typeof items;
+}
+/**
+ * Client context marker for Wix Data
+ */
+declare const WIX_DATA_CONTEXT: _jay_framework_runtime.ContextMarker<WixDataContext>;
+
+/**
+ * URL parameters for item page routes
+ * Supports dynamic routing like /blog/[slug]
+ */
+interface ItemPageParams extends UrlParams {
+    slug: string;
+}
+/**
+ * Data carried forward from slow to fast rendering
+ */
+interface ItemSlowCarryForward {
+    itemId: string;
+    collectionId: string;
+}
+/**
+ * Metadata from dynamic contract generator
+ */
+interface WixDataMetadata$3 {
+    collectionId: string;
+}
+/**
+ * Collection Item Full-Stack Component
+ *
+ * A shared headless component for item pages.
+ * Used by all collections that have itemPage: true in config.
+ *
+ * The component receives contract info via props (DynamicContractProps)
+ * to determine which collection to query.
+ */
+declare const collectionItem: _jay_framework_fullstack_component.JayStackComponentDefinition<object, object, object, object, [ItemSlowCarryForward, WixDataService], [], PageProps & DynamicContractProps<WixDataMetadata$3> & ItemPageParams, ItemPageParams, _jay_framework_component.JayComponentCore<PageProps & DynamicContractProps<WixDataMetadata$3> & ItemPageParams, object>> & {
+    withFastRender<NewCarryForward extends object>(fastRender: _jay_framework_fullstack_component.RenderFast<[ItemSlowCarryForward, WixDataService], PageProps & DynamicContractProps<WixDataMetadata$3> & ItemPageParams, object, NewCarryForward>): _jay_framework_fullstack_component.JayStackComponentDefinition<object, object, object, object, [ItemSlowCarryForward, WixDataService], [object, NewCarryForward], PageProps & DynamicContractProps<WixDataMetadata$3> & ItemPageParams, ItemPageParams, _jay_framework_component.JayComponentCore<PageProps & DynamicContractProps<WixDataMetadata$3> & ItemPageParams, object>> & {
+        withClientDefaults(fn: (props: PageProps & DynamicContractProps<WixDataMetadata$3> & ItemPageParams) => {
+            viewState: object;
+            carryForward?: any;
+        }): _jay_framework_fullstack_component.JayStackComponentDefinition<object, object, object, object, [ItemSlowCarryForward, WixDataService], [object, NewCarryForward], PageProps & DynamicContractProps<WixDataMetadata$3> & ItemPageParams, ItemPageParams, _jay_framework_component.JayComponentCore<PageProps & DynamicContractProps<WixDataMetadata$3> & ItemPageParams, object>> & /*elided*/ any;
+        withInteractive(comp: _jay_framework_component.ComponentConstructor<PageProps & DynamicContractProps<WixDataMetadata$3> & ItemPageParams, object, object, [object, NewCarryForward], _jay_framework_component.JayComponentCore<PageProps & DynamicContractProps<WixDataMetadata$3> & ItemPageParams, object>>): _jay_framework_fullstack_component.JayStackComponentDefinition<object, object, object, object, [ItemSlowCarryForward, WixDataService], [object, NewCarryForward], PageProps & DynamicContractProps<WixDataMetadata$3> & ItemPageParams, ItemPageParams, _jay_framework_component.JayComponentCore<PageProps & DynamicContractProps<WixDataMetadata$3> & ItemPageParams, object>>;
+    };
+    withInteractive(comp: _jay_framework_component.ComponentConstructor<PageProps & DynamicContractProps<WixDataMetadata$3> & ItemPageParams, object, object, [], _jay_framework_component.JayComponentCore<PageProps & DynamicContractProps<WixDataMetadata$3> & ItemPageParams, object>>): _jay_framework_fullstack_component.JayStackComponentDefinition<object, object, object, object, [ItemSlowCarryForward, WixDataService], [], PageProps & DynamicContractProps<WixDataMetadata$3> & ItemPageParams, ItemPageParams, _jay_framework_component.JayComponentCore<PageProps & DynamicContractProps<WixDataMetadata$3> & ItemPageParams, object>>;
+};
+
+/**
+ * URL parameters for list page routes
+ * Optional category slug for category pages
+ */
+interface ListPageParams extends UrlParams {
+    category?: string;
+}
+/**
+ * Data carried forward from slow to fast rendering
+ */
+interface ListSlowCarryForward {
+    collectionId: string;
+    categoryId?: string;
+    categoryField?: string;
+    /** Current offset (number of items already loaded) */
+    offset: number;
+    totalCount: number;
+    pathPrefix: string;
+    slugField: string;
+    /** Field whitelist - undefined means all fields */
+    fieldWhitelist?: string[];
+}
+/**
+ * Data carried forward from fast to interactive
+ */
+interface ListFastCarryForward {
+    collectionId: string;
+    categoryId?: string;
+    categoryField?: string;
+    /** Current offset (number of items already loaded) */
+    offset: number;
+    totalCount: number;
+    pathPrefix: string;
+    slugField: string;
+    /** Field whitelist - undefined means all fields */
+    fieldWhitelist?: string[];
+}
+/**
+ * Metadata from dynamic contract generator
+ */
+interface WixDataMetadata$2 {
+    collectionId: string;
+}
+/**
+ * Collection List Full-Stack Component
+ *
+ * A shared headless component for list pages (index and category).
+ * Used by all collections that have indexPage or categoryPage: true in config.
+ *
+ * Uses queryItems action for client-side "load more" functionality.
+ */
+declare const collectionList: _jay_framework_fullstack_component.JayStackComponentDefinition<object, object, object, object, [ListSlowCarryForward, WixDataService], [object, ListFastCarryForward], PageProps & DynamicContractProps<WixDataMetadata$2> & ListPageParams, ListPageParams, _jay_framework_component.JayComponentCore<PageProps & DynamicContractProps<WixDataMetadata$2> & ListPageParams, object>>;
+
+/**
+ * Props for table widget
+ */
+interface TableWidgetProps extends PageProps {
+    pageSize?: number;
+}
+/**
+ * Data carried forward from slow to fast rendering
+ */
+interface TableSlowCarryForward {
+    collectionId: string;
+    columns: string[];
+    pageSize: number;
+    totalCount: number;
+}
+/**
+ * Data carried forward from fast to interactive
+ */
+interface TableFastCarryForward {
+    collectionId: string;
+    columns: string[];
+    pageSize: number;
+    totalCount: number;
+}
+/**
+ * Metadata from dynamic contract generator
+ */
+interface WixDataMetadata$1 {
+    collectionId: string;
+}
+/**
+ * Collection Table Full-Stack Component
+ *
+ * A shared headless component for table widgets.
+ * Provides sortable columns and pagination.
+ */
+declare const collectionTable: _jay_framework_fullstack_component.JayStackComponentDefinition<object, object, object, object, [TableSlowCarryForward, WixDataService], [object, TableFastCarryForward, WixDataContext], TableWidgetProps & DynamicContractProps<WixDataMetadata$1>, {}, _jay_framework_component.JayComponentCore<TableWidgetProps & DynamicContractProps<WixDataMetadata$1>, object>>;
+
+/**
+ * Props for card widget
+ */
+interface CardWidgetProps extends PageProps {
+    /** Item ID to display */
+    itemId?: string;
+    /** Item slug to display (alternative to itemId) */
+    slug?: string;
+}
+/**
+ * Data carried forward
+ */
+interface CardCarryForward {
+    itemId: string;
+}
+/**
+ * Metadata from dynamic contract generator
+ */
+interface WixDataMetadata {
+    collectionId: string;
+}
+/**
+ * Collection Card Full-Stack Component
+ *
+ * A shared headless component for card widgets.
+ * Displays a single item from a collection in a card format.
+ *
+ * Usage:
+ * ```html
+ * <script type="application/jay-headless"
+ *         plugin="@jay-framework/wix-data"
+ *         contract="card/BlogPostsCard"
+ *         key="featuredPost"
+ *         itemId="abc123"
+ * ></script>
+ * ```
+ */
+declare const collectionCard: _jay_framework_fullstack_component.JayStackComponentDefinition<object, object, object, object, [CardCarryForward, WixDataService], [], CardWidgetProps & DynamicContractProps<WixDataMetadata>, {}, _jay_framework_component.JayComponentCore<CardWidgetProps & DynamicContractProps<WixDataMetadata>, object>> & {
+    withFastRender<NewCarryForward extends object>(fastRender: _jay_framework_fullstack_component.RenderFast<[CardCarryForward, WixDataService], CardWidgetProps & DynamicContractProps<WixDataMetadata>, object, NewCarryForward>): _jay_framework_fullstack_component.JayStackComponentDefinition<object, object, object, object, [CardCarryForward, WixDataService], [object, NewCarryForward], CardWidgetProps & DynamicContractProps<WixDataMetadata>, {}, _jay_framework_component.JayComponentCore<CardWidgetProps & DynamicContractProps<WixDataMetadata>, object>> & {
+        withClientDefaults(fn: (props: CardWidgetProps & DynamicContractProps<WixDataMetadata>) => {
+            viewState: object;
+            carryForward?: any;
+        }): _jay_framework_fullstack_component.JayStackComponentDefinition<object, object, object, object, [CardCarryForward, WixDataService], [object, NewCarryForward], CardWidgetProps & DynamicContractProps<WixDataMetadata>, {}, _jay_framework_component.JayComponentCore<CardWidgetProps & DynamicContractProps<WixDataMetadata>, object>> & /*elided*/ any;
+        withInteractive(comp: _jay_framework_component.ComponentConstructor<CardWidgetProps & DynamicContractProps<WixDataMetadata>, object, object, [object, NewCarryForward], _jay_framework_component.JayComponentCore<CardWidgetProps & DynamicContractProps<WixDataMetadata>, object>>): _jay_framework_fullstack_component.JayStackComponentDefinition<object, object, object, object, [CardCarryForward, WixDataService], [object, NewCarryForward], CardWidgetProps & DynamicContractProps<WixDataMetadata>, {}, _jay_framework_component.JayComponentCore<CardWidgetProps & DynamicContractProps<WixDataMetadata>, object>>;
+    };
+    withInteractive(comp: _jay_framework_component.ComponentConstructor<CardWidgetProps & DynamicContractProps<WixDataMetadata>, object, object, [], _jay_framework_component.JayComponentCore<CardWidgetProps & DynamicContractProps<WixDataMetadata>, object>>): _jay_framework_fullstack_component.JayStackComponentDefinition<object, object, object, object, [CardCarryForward, WixDataService], [], CardWidgetProps & DynamicContractProps<WixDataMetadata>, {}, _jay_framework_component.JayComponentCore<CardWidgetProps & DynamicContractProps<WixDataMetadata>, object>>;
+};
+
+/**
+ * Input for queryItems action
+ */
+interface QueryItemsInput {
+    /** Collection ID to query */
+    collectionId: string;
+    /** Maximum number of items to return (default: 20) */
+    limit?: number;
+    /** Number of items to skip (for pagination) */
+    offset?: number;
+    /** Field to sort by */
+    sortField?: string;
+    /** Sort direction */
+    sortDirection?: 'ASC' | 'DESC';
+    /** Filter conditions (field -> value) */
+    filter?: Record<string, unknown>;
+    /** Filter by category ID (for hasSome query on category field) */
+    categoryId?: string;
+    /** Category reference field name (required if categoryId is provided) */
+    categoryField?: string;
+}
+/**
+ * Output for queryItems action
+ */
+interface QueryItemsOutput {
+    /** List of items */
+    items: WixDataItem[];
+    /** Total number of items matching query */
+    totalCount: number;
+    /** Current offset */
+    offset: number;
+    /** Whether there are more results */
+    hasMore: boolean;
+}
+/**
+ * Input for getItemBySlug action
+ */
+interface GetItemBySlugInput {
+    /** Collection ID */
+    collectionId: string;
+    /** Item slug value */
+    slug: string;
+}
+/**
+ * Output for getItemBySlug action
+ */
+interface GetItemBySlugOutput {
+    /** Item data (flat object with _id and all fields), or null if not found */
+    item: WixDataItem | null;
+}
+/**
+ * Input for getCategories action
+ */
+interface GetCategoriesInput {
+    /** Collection ID that has category references */
+    collectionId: string;
+}
+/**
+ * Category item
+ */
+interface CategoryItem {
+    _id: string;
+    slug: string;
+    title: string;
+    itemCount: number;
+}
+/**
+ * Output for getCategories action
+ */
+interface GetCategoriesOutput {
+    /** List of categories */
+    categories: CategoryItem[];
+}
+/**
+ * Query items from a collection.
+ *
+ * Supports pagination, sorting, and filtering.
+ *
+ * @example
+ * ```typescript
+ * const results = await queryItems({
+ *     collectionId: 'BlogPosts',
+ *     limit: 20,
+ *     sortField: 'publishDate',
+ *     sortDirection: 'DESC',
+ *     filter: { status: 'published' }
+ * });
+ * ```
+ */
+declare const queryItems: _jay_framework_fullstack_component.JayAction<QueryItemsInput, QueryItemsOutput> & _jay_framework_fullstack_component.JayActionDefinition<QueryItemsInput, QueryItemsOutput, [WixDataService]>;
+/**
+ * Get a single item by its slug.
+ *
+ * Uses the slugField configured for the collection.
+ *
+ * @example
+ * ```typescript
+ * const result = await getItemBySlug({
+ *     collectionId: 'BlogPosts',
+ *     slug: 'my-first-post'
+ * });
+ * ```
+ */
+declare const getItemBySlug: _jay_framework_fullstack_component.JayAction<GetItemBySlugInput, GetItemBySlugOutput> & _jay_framework_fullstack_component.JayActionDefinition<GetItemBySlugInput, GetItemBySlugOutput, [WixDataService]>;
+/**
+ * Get categories for a collection.
+ *
+ * Returns distinct category values from the configured category reference field.
+ *
+ * @example
+ * ```typescript
+ * const result = await getCategories({
+ *     collectionId: 'BlogPosts'
+ * });
+ * // Returns: { categories: [{ _id: '...', slug: 'tech', title: 'Technology', itemCount: 15 }, ...] }
+ * ```
+ */
+declare const getCategories: _jay_framework_fullstack_component.JayAction<GetCategoriesInput, GetCategoriesOutput> & _jay_framework_fullstack_component.JayActionDefinition<GetCategoriesInput, GetCategoriesOutput, [WixDataService]>;
+
+/**
+ * Contract Generation Utilities
+ *
+ * Shared building blocks for contract YAML generation.
+ */
+
+/** Filter for fields suitable for card/list display (excludes system, references, rich content) */
+declare function isCardField(f: ProcessedField): boolean;
+/** Filter for simple fields suitable for table display */
+declare function isTableField(f: ProcessedField): boolean;
+/** Filter for non-system fields */
+declare function isContentField(f: ProcessedField): boolean;
+declare function toPascalCase(str: string): string;
+
+declare const init: _jay_framework_fullstack_component.JayInit<WixDataInitData>;
+
+/**
+ * Setup and references handlers for wix-data plugin (Design Log #87).
+ *
+ * Setup: Validates wix-server-client is configured; config auto-generated during init.
+ * References: Generates collection schema data for agent discovery.
+ */
+
+declare function setupWixData(ctx: PluginSetupContext): Promise<PluginSetupResult>;
+declare function generateWixDataReferences(ctx: PluginReferencesContext): Promise<PluginReferencesResult>;
+
+/**
+ * Item Contract Generator
+ *
+ * Generates contracts for item pages from Wix Data collection schemas.
+ */
+/**
+ * Generator for item page contracts.
+ * Creates one contract per visible collection that has itemPage: true in config.
+ */
+declare const generator$3: _jay_framework_fullstack_component.DynamicContractGenerator<[WixDataService]>;
+
+/**
+ * List Contract Generator
+ *
+ * Generates contracts for list pages (index and category) from Wix Data collection schemas.
+ */
+/**
+ * Generator for list page contracts.
+ * Creates one contract per visible collection that has indexPage or categoryPage enabled.
+ */
+declare const generator$2: _jay_framework_fullstack_component.DynamicContractGenerator<[WixDataService]>;
+
+/**
+ * Table Contract Generator
+ *
+ * Generates contracts for table widgets from Wix Data collection schemas.
+ */
+/**
+ * Generator for table widget contracts.
+ * Creates one contract per visible collection that has tableWidget: true in config.
+ */
+declare const generator$1: _jay_framework_fullstack_component.DynamicContractGenerator<[WixDataService]>;
+
+/**
+ * Card Contract Generator
+ *
+ * Generates contracts for card widgets from Wix Data collection schemas.
+ */
+/**
+ * Generator for card widget contracts.
+ * Creates one contract per visible collection that has cardWidget: true in config.
+ */
+declare const generator: _jay_framework_fullstack_component.DynamicContractGenerator<[WixDataService]>;
+
+export { type CategoryConfig, type CategoryItem, type CollectionConfig, type CollectionFetcher, type CollectionSchema, type ComponentsConfig, type FieldSchema, type GetCategoriesInput, type GetCategoriesOutput, type GetItemBySlugInput, type GetItemBySlugOutput, type ProcessedField, type ProcessedSchema, type QueryItemsInput, type QueryItemsOutput, type ReferenceConfig, type ResolvedWixDataConfig, WIX_DATA_CONTEXT, WIX_DATA_SERVICE_MARKER, type WixDataConfig, type WixDataContext, type WixDataFieldType, type WixDataInitData, type WixDataService, generator as cardContractGenerator, collectionCard, collectionItem, collectionList, collectionTable, generateWixDataReferences, getCategories, getItemBySlug, getVisibleCollections, init, isCardField, isContentField, isTableField, generator$3 as itemContractGenerator, generator$2 as listContractGenerator, loadConfig, processSchema, provideWixDataService, queryItems, setupWixData, generator$1 as tableContractGenerator, toPascalCase, validateCollectionConfig, validateConfig };