feeef 0.12.3 → 0.12.5

package/build/src/core/entities/product.d.ts

@@ -1,6 +1,6 @@
 import { EmbaddedCategory } from '../embadded/category.js';
 import { ShippingMethodEntity } from './shipping_method.js';
-import { GoogleSheetsColumn, StoreEntity } from './store.js';
+import { GoogleSheetsColumn, PixelStatusRule, StoreEntity } from './store.js';
 import { CategoryEntity } from './category.js';
 export interface ProductEntity {
     id: string;
@@ -29,6 +29,17 @@ export interface ProductEntity {
     dislikes: number;
     variant?: ProductVariant | null;
     offers?: ProductOffer[] | null;
+    /**
+     * When true, the customer must keep an offer selected.
+     * If [defaultOfferCode] also resolves to a valid offer, that offer is locked
+     * (cannot switch or deselect). Independent of [defaultOfferCode] being set.
+     */
+    forceOffer?: boolean | null;
+    /**
+     * Offer code to preselect on the storefront. Cleared (synced to null) when the
+     * code is missing from [offers] — callers should treat a stale code as unset.
+     */
+    defaultOfferCode?: string | null;
     metadata: Record<string, any>;
     status: ProductStatus;
     type: ProductType;
@@ -65,9 +76,17 @@ export declare enum MetaPixelEvent {
     initiateCheckout = "InitiateCheckout"
 }
 export interface MetaPixelData {
+    /** When false, ignore product override and use store defaults. */
+    enabled?: boolean | null;
     ids: string[] | null;
     objective: MetaPixelEvent | null;
     draftObjective: MetaPixelEvent | null;
+    /**
+     * Optional product-level status transition rules (server CAPI).
+     * When non-empty on a single-product order, overrides store `statusRules`.
+     * Never exposed on public product JSON.
+     */
+    statusRules?: PixelStatusRule[] | null;
 }
 export declare enum TiktokPixelEvent {
     none = "none",
@@ -82,9 +101,17 @@ export declare enum TiktokPixelEvent {
     purchase = "Purchase"
 }
 export interface TiktokPixelData {
+    /** When false, ignore product override and use store defaults. */
+    enabled?: boolean | null;
     ids: string[] | null;
     objective: TiktokPixelEvent | null;
     draftObjective: TiktokPixelEvent | null;
+    /**
+     * Optional product-level status transition rules (server Events API).
+     * When non-empty on a single-product order, overrides store `statusRules`.
+     * Never exposed on public product JSON.
+     */
+    statusRules?: PixelStatusRule[] | null;
 }
 export interface GoogleAnalyticsData {
 }
@@ -215,6 +242,10 @@ export interface ProductCreateInput {
     stock?: number;
     variant?: ProductVariant;
     offers?: ProductOffer[];
+    /** See [ProductEntity.forceOffer]. */
+    forceOffer?: boolean | null;
+    /** See [ProductEntity.defaultOfferCode]. */
+    defaultOfferCode?: string | null;
     addons?: ProductAddon[];
     metadata?: Record<string, any>;
     status?: ProductStatus;
@@ -244,6 +275,10 @@ export interface ProductUpdateInput {
     stock?: number;
     variant?: ProductVariant;
     offers?: ProductOffer[];
+    /** See [ProductEntity.forceOffer]. */
+    forceOffer?: boolean | null;
+    /** See [ProductEntity.defaultOfferCode]. */
+    defaultOfferCode?: string | null;
     addons?: ProductAddon[];
     metadata?: Record<string, any>;
     status?: ProductStatus;

package/build/src/core/entities/product_offer_policy.d.ts

@@ -0,0 +1,27 @@
+import type { ProductEntity, ProductOffer } from './product.js';
+/** Minimal product shape needed to resolve default / forced offer policy. */
+export type ProductOfferPolicySource = Pick<ProductEntity, 'offers' | 'forceOffer' | 'defaultOfferCode'>;
+/**
+ * Returns [defaultOfferCode] only when it exists in [offers]; otherwise null.
+ * Use whenever persisting or applying a default so stale codes never leak.
+ */
+export declare function syncDefaultOfferCode(offers: ProductOffer[] | null | undefined, defaultOfferCode: string | null | undefined): string | null;
+/**
+ * Offer that should be preselected for a product (if any).
+ * Respects synced [defaultOfferCode] only — does not invent a "first offer".
+ */
+export declare function resolveInitialProductOffer(product: ProductOfferPolicySource): ProductOffer | undefined;
+/**
+ * True when the product requires an offer to remain selected (cannot deselect).
+ * Independent of whether a specific default code is set.
+ */
+export declare function isProductOfferRequired(product: ProductOfferPolicySource): boolean;
+/**
+ * True when offer selection is locked to the synced default code
+ * (`forceOffer` + valid `defaultOfferCode`). Customer cannot switch offers.
+ */
+export declare function isProductOfferLocked(product: ProductOfferPolicySource): boolean;
+/**
+ * Offer that must be applied when locked; otherwise undefined.
+ */
+export declare function resolveForcedProductOffer(product: ProductOfferPolicySource): ProductOffer | undefined;

package/build/src/feeef/services/cart.d.ts

@@ -77,9 +77,17 @@ export declare class CartService extends NotifiableService {
     private findItemIndex;
     /**
      * Sets the current item to be managed in the cart.
+     * Applies product [defaultOfferCode] when the item has no offer yet, and
+     * re-applies a forced offer when [forceOffer] locks selection.
      * @param item - The item to be set as current.
      */
     setCurrentItem(item: CartItem, notify?: boolean): void;
+    /**
+     * Hydrates / locks offer from product policy without mutating unrelated fields.
+     * - Default: preselect when item has no offer
+     * - Forced+default: always keep the forced offer
+     */
+    private applyProductOfferPolicy;
     /**
      * Clamps the quantity to be within the offer's min/max range
      * @param offer - The offer containing quantity constraints
@@ -198,6 +206,11 @@ export declare class CartService extends NotifiableService {
      * @param offer - The offer to apply, or undefined to remove the offer
      */
     updateCurrentItemOffer(offer?: ProductOffer): void;
+    /**
+     * Enforces product offer policy for a requested offer change.
+     * Returns `'blocked'` when the change is not allowed.
+     */
+    private resolveOfferUpdate;
     /**
      * Sets the shipping method.
      * @param method - Either a store or a shipping method.

package/build/src/index.d.ts

@@ -5,6 +5,7 @@ export * from './delivery/delivery_carrier_client.js';
 export * from './core/entities/order.js';
 export * from './core/entities/store.js';
 export * from './core/entities/product.js';
+export * from './core/entities/product_offer_policy.js';
 export * from './core/entities/product_landing_page.js';
 export * from './core/entities/product_landing_page_template.js';
 export * from './core/entities/attachment.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "feeef",
   "description": "feeef sdk for javascript",
-  "version": "0.12.3",
+  "version": "0.12.5",
   "main": "build/index.js",
   "type": "module",
   "files": [