@jay-framework/wix-stores 0.15.4 → 0.15.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/wix-stores",
-  "version": "0.15.4",
+  "version": "0.15.6",
   "type": "module",
   "description": "Wix Stores API client for Jay Framework",
   "license": "Apache-2.0",
@@ -18,11 +18,13 @@
     "./category-list.jay-contract": "./dist/contracts/category-list.jay-contract",
     "./search-products.jay-action": "./dist/actions/search-products.jay-action",
     "./get-product-by-slug.jay-action": "./dist/actions/get-product-by-slug.jay-action",
-    "./get-categories.jay-action": "./dist/actions/get-categories.jay-action"
+    "./get-categories.jay-action": "./dist/actions/get-categories.jay-action",
+    "./get-variant-stock.jay-action": "./dist/actions/get-variant-stock.jay-action"
   },
   "scripts": {
-    "build": "npm run clean && npm run definitions && npm run build:client && npm run build:server && npm run build:copy-contract && npm run build:types",
+    "build": "npm run clean && npm run definitions && npm run build:client && npm run build:server && npm run build:copy-contract && npm run build:types && npm run validate",
     "definitions": "jay-cli definitions lib",
+    "validate": "jay-stack-cli validate-plugin",
     "build:client": "vite build",
     "build:server": "vite build --ssr",
     "build:copy-contract": "mkdir -p dist/contracts && cp lib/contracts/*.jay-contract* dist/contracts/ && mkdir -p dist/actions && cp lib/actions/*.jay-action dist/actions/",
@@ -33,28 +35,30 @@
     "test": ":"
   },
   "dependencies": {
-    "@jay-framework/component": "^0.15.4",
-    "@jay-framework/fullstack-component": "^0.15.4",
-    "@jay-framework/reactive": "^0.15.4",
-    "@jay-framework/runtime": "^0.15.4",
-    "@jay-framework/secure": "^0.15.4",
-    "@jay-framework/stack-client-runtime": "^0.15.4",
-    "@jay-framework/stack-server-runtime": "^0.15.4",
-    "@jay-framework/wix-cart": "^0.15.4",
-    "@jay-framework/wix-server-client": "^0.15.4",
-    "@jay-framework/wix-utils": "^0.15.4",
+    "@jay-framework/component": "^0.15.6",
+    "@jay-framework/fullstack-component": "^0.15.6",
+    "@jay-framework/reactive": "^0.15.6",
+    "@jay-framework/runtime": "^0.15.6",
+    "@jay-framework/secure": "^0.15.6",
+    "@jay-framework/stack-client-runtime": "^0.15.6",
+    "@jay-framework/stack-server-runtime": "^0.15.6",
+    "@jay-framework/wix-cart": "^0.15.6",
+    "@jay-framework/wix-server-client": "^0.15.6",
+    "@jay-framework/wix-utils": "^0.15.6",
     "@wix/categories": "^1.0.185",
     "@wix/sdk": "^1.21.5",
-    "@wix/stores": "^1.0.723",
+    "@wix/sdk-runtime": "^1.0.11",
+    "@wix/stores": "^1.0.742",
     "js-yaml": "^4.1.0"
   },
   "devDependencies": {
     "@babel/core": "^7.23.7",
     "@babel/preset-env": "^7.23.8",
     "@babel/preset-typescript": "^7.23.3",
-    "@jay-framework/compiler-jay-stack": "^0.15.4",
-    "@jay-framework/jay-cli": "^0.15.4",
-    "@jay-framework/vite-plugin": "^0.15.4",
+    "@jay-framework/compiler-jay-stack": "^0.15.6",
+    "@jay-framework/jay-cli": "^0.15.6",
+    "@jay-framework/jay-stack-cli": "^0.15.6",
+    "@jay-framework/vite-plugin": "^0.15.6",
     "nodemon": "^3.0.3",
     "rimraf": "^5.0.5",
     "tslib": "^2.6.2",

package/plugin.yaml

@@ -24,9 +24,18 @@ actions:
     action: get-product-by-slug.jay-action
   - name: getCategories
     action: get-categories.jay-action
+  - name: getVariantStock
+    action: get-variant-stock.jay-action
 
-# Plugin initialization uses makeJayInit pattern in lib/init.ts
-# Export name defaults to 'init'
+services:
+  - name: wix-stores
+    marker: WIX_STORES_SERVICE_MARKER
+    description: Wix Stores Catalog V3 API (products, categories, inventory, customizations) with lazy-loaded caching
+
+contexts:
+  - name: wix-stores
+    marker: WIX_STORES_CONTEXT
+    description: Client-side stores access with product variant resolution and delegated cart operations
 
 setup:
   handler: setupWixStores

package/dist/contracts/category-page.jay-contract

@@ -1,193 +0,0 @@
-name: category-page
-tags:
-  # Category/Collection information (from Wix Stores Collection API)
-  - tag: _id
-    type: data
-    dataType: string
-    description: Collection GUID
-    
-  - tag: name
-    type: data
-    dataType: string
-    required: true
-    description: Collection name
-    
-  - tag: description
-    type: data
-    dataType: string
-    description: Collection description
-    
-  - tag: slug
-    type: data
-    dataType: string
-    description: Collection slug
-    
-  - tag: visible
-    type: data
-    dataType: boolean
-    description: Collection visibility (impacts dynamic pages only)
-    
-  - tag: numberOfProducts
-    type: data
-    dataType: number
-    description: Number of products in the collection
-    
-  # Media (from Wix Stores Collection API)
-  - tag: media
-    type: sub-contract
-    description: Media items associated with this collection
-    tags:
-      - tag: mainMedia
-        type: sub-contract
-        description: Primary media for the collection
-        tags:
-          - tag: _id
-            type: data
-            dataType: string
-            description: Media GUID
-            
-          - tag: url
-            type: data
-            dataType: string
-            description: Media URL
-            
-          - tag: altText
-            type: data
-            dataType: string
-            description: Media alt text
-            
-          - tag: mediaType
-            type: data
-            dataType: enum (IMAGE | VIDEO | AUDIO | DOCUMENT | ZIP)
-            description: Media item type
-            
-      - tag: items
-        type: sub-contract
-        repeated: true
-        trackBy: _id
-        description: All media items
-        tags:
-          - tag: _id
-            type: data
-            dataType: string
-            description: Media GUID
-            
-          - tag: url
-            type: data
-            dataType: string
-            description: Media URL
-            
-          - tag: altText
-            type: data
-            dataType: string
-            description: Media alt text
-            
-          - tag: title
-            type: data
-            dataType: string
-            description: Media item title
-            
-          - tag: mediaType
-            type: data
-            dataType: enum (IMAGE | VIDEO | AUDIO | DOCUMENT | ZIP)
-            description: Media item type
-            
-          - tag: thumbnail
-            type: sub-contract
-            description: Media thumbnail
-            tags:
-              - tag: url
-                type: data
-                dataType: string
-                description: Thumbnail URL
-                
-              - tag: width
-                type: data
-                dataType: number
-                description: Thumbnail width in pixels
-                
-              - tag: height
-                type: data
-                dataType: number
-                description: Thumbnail height in pixels
-                
-              - tag: format
-                type: data
-                dataType: string
-                description: Media format (mp4, png, etc.)
-    
-  # Breadcrumbs navigation
-  - tag: breadcrumbs
-    type: sub-contract
-    repeated: true
-    trackBy: categoryId
-    description: Breadcrumb navigation path
-    tags:
-      - tag: categoryId
-        type: data
-        dataType: string
-        description: Category GUID
-        
-      - tag: categoryName
-        type: data
-        dataType: string
-        description: Category name in breadcrumb
-        
-      - tag: categorySlug
-        type: data
-        dataType: string
-        description: Category slug for link
-        
-      - tag: categoryLink
-        type: interactive
-        elementType: HTMLAnchorElement
-        description: Link to category
-  
-  # Initial products (SSR - loaded in slow phase)
-  - tag: products
-    type: sub-contract
-    repeated: true
-    trackBy: _id
-    description: Initial products in this category (rendered server-side)
-    link: ./product-card
-    
-  # Additional products (loaded on client via "load more")
-  - tag: loadedProducts
-    type: sub-contract
-    repeated: true
-    trackBy: _id
-    phase: fast+interactive
-    description: Additional products loaded on the client
-    link: ./product-card
-    
-  # Load more functionality
-  - tag: hasMore
-    type: variant
-    dataType: boolean
-    phase: fast+interactive
-    description: Whether there are more products to load
-    
-  - tag: loadMoreButton
-    type: interactive
-    elementType: HTMLButtonElement
-    description: Button to load more products
-    
-  - tag: loadedCount
-    type: data
-    dataType: number
-    phase: fast+interactive
-    description: Number of products currently loaded
-  
-  # Loading state
-  - tag: isLoading
-    type: variant
-    dataType: boolean
-    phase: fast+interactive
-    description: Whether products are currently loading
-    
-  # Empty state
-  - tag: hasProducts
-    type: variant
-    dataType: boolean
-    phase: fast+interactive
-    description: Whether category has any products

package/dist/contracts/category-page.jay-contract.d.ts

@@ -1,133 +0,0 @@
-import {HTMLElementCollectionProxy, HTMLElementProxy, JayContract} from "@jay-framework/runtime";
-import {ProductCardViewState, ProductCardRefs, ProductCardRepeatedRefs} from "./product-card.jay-contract";
-
-export enum MediaType {
-  IMAGE,
-  VIDEO,
-  AUDIO,
-  DOCUMENT,
-  ZIP
-}
-
-export interface MainMediaOfMediaOfCategoryPageViewState {
-  _id: string,
-  url: string,
-  altText: string,
-  mediaType: MediaType
-}
-
-export enum MediaType {
-  IMAGE,
-  VIDEO,
-  AUDIO,
-  DOCUMENT,
-  ZIP
-}
-
-export interface ThumbnailOfItemOfMediaOfCategoryPageViewState {
-  url: string,
-  width: number,
-  height: number,
-  format: string
-}
-
-export interface ItemOfMediaOfCategoryPageViewState {
-  _id: string,
-  url: string,
-  altText: string,
-  title: string,
-  mediaType: MediaType,
-  thumbnail: ThumbnailOfItemOfMediaOfCategoryPageViewState
-}
-
-export interface MediaOfCategoryPageViewState {
-  mainMedia: MainMediaOfMediaOfCategoryPageViewState,
-  items: Array<ItemOfMediaOfCategoryPageViewState>
-}
-
-export interface BreadcrumbOfCategoryPageViewState {
-  categoryId: string,
-  categoryName: string,
-  categorySlug: string
-}
-
-export interface CategoryPageViewState {
-  _id: string,
-  name: string,
-  description: string,
-  slug: string,
-  visible: boolean,
-  numberOfProducts: number,
-  media: MediaOfCategoryPageViewState,
-  breadcrumbs: Array<BreadcrumbOfCategoryPageViewState>,
-  products: Array<ProductCardViewState>,
-  loadedProducts: Array<ProductCardViewState>,
-  hasMore: boolean,
-  loadedCount: number,
-  isLoading: boolean,
-  hasProducts: boolean
-}
-
-export type CategoryPageSlowViewState = Pick<CategoryPageViewState, '_id' | 'name' | 'description' | 'slug' | 'visible' | 'numberOfProducts'> & {
-    media: CategoryPageViewState['media'];
-    breadcrumbs: Array<CategoryPageViewState['breadcrumbs'][number]>;
-    products: Array<Pick<CategoryPageViewState['products'][number], '_id' | 'name' | 'slug' | 'productUrl' | 'categoryPrefix' | 'hasDiscount' | 'hasRibbon' | 'productType' | 'quickAddType'> & {
-    mainMedia: CategoryPageViewState['products'][number]['mainMedia'];
-    thumbnail: CategoryPageViewState['products'][number]['thumbnail'];
-    inventory: CategoryPageViewState['products'][number]['inventory'];
-    ribbon: CategoryPageViewState['products'][number]['ribbon'];
-    brand: CategoryPageViewState['products'][number]['brand'];
-    quickOption: Pick<CategoryPageViewState['products'][number]['quickOption'], '_id' | 'name' | 'optionRenderType'> & {
-    choices: Array<Pick<CategoryPageViewState['products'][number]['quickOption']['choices'][number], 'choiceId' | 'name' | 'choiceType' | 'colorCode'>>;
-};
-    secondQuickOption: Pick<CategoryPageViewState['products'][number]['secondQuickOption'], '_id' | 'name' | 'optionRenderType'> & {
-    choices: Array<Pick<CategoryPageViewState['products'][number]['secondQuickOption']['choices'][number], 'choiceId' | 'name' | 'choiceType' | 'colorCode'>>;
-};
-}>;
-};
-
-export type CategoryPageFastViewState = Pick<CategoryPageViewState, 'hasMore' | 'loadedCount' | 'isLoading' | 'hasProducts'> & {
-    products: Array<Pick<CategoryPageViewState['products'][number], '_id' | 'price' | 'strikethroughPrice' | 'isAddingToCart'> & {
-    quickOption: {
-    choices: Array<Pick<CategoryPageViewState['products'][number]['quickOption']['choices'][number], 'choiceId' | 'inStock' | 'isSelected'>>;
-};
-    secondQuickOption: {
-    choices: Array<Pick<CategoryPageViewState['products'][number]['secondQuickOption']['choices'][number], 'choiceId' | 'inStock' | 'isSelected'>>;
-};
-}>;
-    loadedProducts: Array<CategoryPageViewState['loadedProducts'][number]>;
-};
-
-export type CategoryPageInteractiveViewState = Pick<CategoryPageViewState, 'hasMore' | 'loadedCount' | 'isLoading' | 'hasProducts'> & {
-    products: Array<Pick<CategoryPageViewState['products'][number], '_id' | 'price' | 'strikethroughPrice' | 'isAddingToCart'> & {
-    quickOption: {
-    choices: Array<Pick<CategoryPageViewState['products'][number]['quickOption']['choices'][number], 'choiceId' | 'inStock' | 'isSelected'>>;
-};
-    secondQuickOption: {
-    choices: Array<Pick<CategoryPageViewState['products'][number]['secondQuickOption']['choices'][number], 'choiceId' | 'inStock' | 'isSelected'>>;
-};
-}>;
-    loadedProducts: Array<CategoryPageViewState['loadedProducts'][number]>;
-};
-
-
-export interface CategoryPageRefs {
-  loadMoreButton: HTMLElementProxy<CategoryPageViewState, HTMLButtonElement>,
-  breadcrumbs: {
-    categoryLink: HTMLElementCollectionProxy<BreadcrumbOfCategoryPageViewState, HTMLAnchorElement>
-  },
-  products: ProductCardRepeatedRefs,
-  loadedProducts: ProductCardRepeatedRefs
-}
-
-
-export interface CategoryPageRepeatedRefs {
-  loadMoreButton: HTMLElementCollectionProxy<CategoryPageViewState, HTMLButtonElement>,
-  breadcrumbs: {
-    categoryLink: HTMLElementCollectionProxy<BreadcrumbOfCategoryPageViewState, HTMLAnchorElement>
-  },
-  products: ProductCardRepeatedRefs,
-  loadedProducts: ProductCardRepeatedRefs
-}
-
-export type CategoryPageContract = JayContract<CategoryPageViewState, CategoryPageRefs, CategoryPageSlowViewState, CategoryPageFastViewState, CategoryPageInteractiveViewState>