@repobit/dex-store 0.3.0 → 1.1.1

package/CHANGELOG.md

@@ -3,6 +3,38 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.1.1](https://github.com/bitdefender/dex-core/compare/@repobit/dex-store@1.1.0...@repobit/dex-store@1.1.1) (2025-10-10)
+
+
+### Bug Fixes
+
+* **DEX-21811:** now adaptor know new id ([2fefad1](https://github.com/bitdefender/dex-core/commit/2fefad1f60c3a2d3caa1f997245599aee43e4284))
+
+
+
+## [1.1.0](https://github.com/bitdefender/dex-core/compare/@repobit/dex-store@0.3.0...@repobit/dex-store@1.1.0) (2025-10-08)
+
+
+### Features
+
+* **DEX-21811:** add bundled options to the bundle item ([5e0ac67](https://github.com/bitdefender/dex-core/commit/5e0ac67709096278e1993188e524ab5ea2009248))
+* **DEX-21811:** add derrived eta ctx ([e05f1da](https://github.com/bitdefender/dex-core/commit/e05f1da32aa29d36ebaea86ae6fe0fa852b18a4b))
+* **DEX-21811:** add fallback ([ce1fe67](https://github.com/bitdefender/dex-core/commit/ce1fe676ef7101f97fe777b6cb5ee83b35ad5dce))
+* **DEX-21811:** add parsers and renders ([0d52ebc](https://github.com/bitdefender/dex-core/commit/0d52ebcd3f73024cd2076406adbc8002a601264f))
+* **DEX-21811:** add trial links ([209c577](https://github.com/bitdefender/dex-core/commit/209c577f6809023b2d73dc2783a4699453e6466f))
+* **DEX-21811:** change overrides and trialinks ([db527b4](https://github.com/bitdefender/dex-core/commit/db527b495601d46857e9362f79dba8c033ffd665))
+* **DEX-21811:** working click events ([9f1538f](https://github.com/bitdefender/dex-core/commit/9f1538f17d639381580eecfc1954bb16654a10d8))
+* **DEX-2181:** add renders ([5175d15](https://github.com/bitdefender/dex-core/commit/5175d15772607be0afc2e8d6504417988e7dc5cf))
+
+
+### Bug Fixes
+
+* **DEX-21811:** change state compute to transiztion bundles ([45dd085](https://github.com/bitdefender/dex-core/commit/45dd0858cf8a751236a29cad88dad6a5c1a16aa8))
+* **DEX-21811:** fix bundle computing ([4f06ca4](https://github.com/bitdefender/dex-core/commit/4f06ca430ccd3d2e90ed69fdd57f600f31c77b6b))
+* **DEX-21811:** fix bundle empty array ([79187b7](https://github.com/bitdefender/dex-core/commit/79187b73d68a124244e947eb60bf1a58549365c1))
+
+
+
 ## [0.3.0](https://github.com/bitdefender/dex-core/compare/@repobit/dex-store@0.2.1...@repobit/dex-store@0.3.0) (2025-05-29)
 
 

package/README.md

@@ -1,11 +1,244 @@
-# `@bitdefender/dex-store`
+# @repobit/dex-store
 
-> TODO: description
+Typed, framework‑agnostic pricing/store core with pluggable providers, rich product/option models, and convenient helpers for formatting, overrides, and experimentation.
 
-## Usage
+- Fetch products/options via built‑in providers (init, vlaicu) or your own
+- Strongly typed `Product` and `ProductOption` APIs
+- Locale/currency formatting with overrideable formatter
+- Option overrides and campaign resolver hooks
+- Trial link mapping and buy‑link transformers
 
+## Install
+
+```bash
+npm i @repobit/dex-store
+```
+
+## At a glance
+
+```ts
+import { Store } from '@repobit/dex-store';
+
+const store = new Store({
+  locale  : 'en-us',
+  provider: { name: 'vlaicu' },
+
+  // Optional async campaign resolver per product id
+  campaign: async ({ id, campaign }) => campaign,
+
+  // Optional per-variation overrides (keyed as `${devices}-${subscription}`)
+  overrides: {
+    'com.bitdefender.tsmd.v2': {
+      campaign: 'WINTER2025',
+      options : {
+        '5-12': { discountedPrice: 49.99 },
+        // delete a variation by setting null
+        '1-1' : null
+      }
+    }
+  },
+
+  // Optional mapping of trial links per variation
+  trialLinks: {
+    '5-12': 'https://example.test/trial?devices=5&months=12'
+  },
+
+  // Optional buy-link transformer for A/B, UTM, etc.
+  transformers: {
+    option: {
+      buyLink: async (href) => new URL(href).toString()
+    }
+  },
+
+  // Optional number -> string formatter (defaults to Intl currency)
+  formatter: ({ price, currency, locale }) => {
+    if (!currency) return price; // return number when currency missing
+    return new Intl.NumberFormat(locale ?? 'en-us', { style: 'currency', currency }).format(price);
+  }
+});
+
+const product = await store.getProduct({ id: 'com.bitdefender.tsmd.v2' });
+const option  = await product?.getOption({ devices: 5, subscription: 12 });
+
+console.log({
+  price          : option?.getPrice(),                 // "$109.99"
+  discounted     : option?.getDiscountedPrice(),       // "$59.99"
+  discount       : option?.getDiscount(),              // "$50"
+  buyLink        : option?.getBuyLink(),
+  trialLink      : option?.getTrialLink(),
+  devices        : option?.getDevices(),               // 5
+  subscription   : option?.getSubscription()           // 12
+});
 ```
-import dexStore from '@bitdefender/dex-store';
 
-// TODO: DEMONSTRATE API
+## Store
+
+```ts
+new Store(config: {
+  provider   : { name: 'init' | 'vlaicu' } | new (...args) => Provider,
+  locale     : `${string}-${string}`,
+  campaign?  : ({ id, campaign }: { id: string; campaign?: string }) => Promise<string | undefined>,
+  overrides? : {
+    [productId: string]: {
+      campaign?: string,
+      options  : { [variation: `${string}-${string}`]: Partial<UnboundProductOptionData> | null | undefined }
+    }
+  },
+  trialLinks?: { [variation: `${string}-${string}`]: string },
+  transformers?: { option?: { buyLink: (href: string) => Promise<string> } },
+  formatter?  : (p: { price: number; currency?: string; locale?: Intl.UnicodeBCP47LocaleIdentifier }) => string | number
+})
 ```
+
+- `getProduct(selector)` returns a `Product | undefined` (or an array if you pass an array of selectors).
+- Built‑in providers:
+  - `init`: legacy Init Selector
+  - `vlaicu`: platform API v1
+- The store caches by adapted product id + campaign. If you ask for the same product id with different raw ids that adapt to the same platform id, options are aggregated.
+
+### Price formatting
+- The store exposes a `formatter` hook. Defaults to Intl currency via `formatPrice`.
+- All string price/discount getters (`getPrice()`, `getDiscountedPrice()`, `getDiscount()`) call `store.formatPrice` under the hood when returning strings.
+- If you pass `{ currency: false }`/`{ symbol: false }`, the numeric variants are returned.
+
+## Product
+
+Represents a product with many options (variations). Computes min/max aggregates for price and discount across all options (including monthly breakdowns).
+
+Key methods:
+
+```ts
+product.getId(): string
+product.getName(): string
+product.getCampaign(): string | undefined
+product.getCurrency(): string
+product.getOption(): Promise<ProductOption[]>                 // all options
+product.getOption({ devices, subscription }): Promise<ProductOption | undefined>
+product.getPrice({ monthly?: boolean, currency?: boolean }): { min: string|number, max: string|number }
+product.getDiscountedPrice({ monthly?: boolean, currency?: boolean }): { min: string|number, max: string|number }
+product.getDiscount({ percentage?: boolean, symbol?: boolean }): { min: string|number, max: string|number }
+product.getDevices(): { min: number, max: number, values: number[] }
+product.getSubscriptions(): { min: number, max: number, values: number[] }
+```
+
+## ProductOption
+
+A single product variation.
+
+```ts
+option.getVariation(): `${devices}-${subscription}`
+option.getDevices(): number
+option.getSubscription(): number
+
+// Price
+option.getPrice({ monthly?: boolean, currency?: boolean }): string | number
+option.getDiscountedPrice({ monthly?: boolean, currency?: boolean }): string | number
+option.getDiscount({ percentage?: boolean, symbol?: boolean, monthly?: boolean }): string | number
+
+// Links
+option.getBuyLink(): string
+option.getTrialLink(): string
+
+// Navigate
+option.getOption({ devices?: number; subscription?: number }): Promise<ProductOption | undefined>
+option.nextOption({ devices?: 'prev' | 'next' | number; subscription?: 'prev' | 'next' | number }): Promise<ProductOption | undefined>
+
+// Bundling
+option.toogleBundle({ option: ProductBundleOption; devicesFixed?: boolean; subscriptionFixed?: boolean }): Promise<ProductOption | undefined>
+```
+
+Notes:
+- String getters use the store’s formatter; numeric variants are returned when asked via `{ currency: false }` or `{ symbol: false }`.
+- `nextOption` accepts deltas per dimension. `'next'/'prev'` move by one index. Numeric deltas are relative.
+
+## Overrides and trial links
+
+- `overrides` mutate/patch individual options before instantiation. Set a variation to `null` to drop it.
+- `trialLinks` inject per‑variation trial links as plain strings. Providers can still supply a trial link; the mapping overwrites it when present.
+- `transformers.option.buyLink` lets you rewrite buy links uniformly (e.g., add UTM, swap host).
+
+## Custom providers
+
+Implement your own by extending the abstract `Provider`:
+
+```ts
+import { Provider } from '@repobit/dex-store/src/providers/provider.base';
+import type { UnboundProductData } from '@repobit/dex-store/src/products/product.base';
+
+class MyProvider extends Provider {
+  async fetch({ id, campaign }): Promise<UnboundProductData | undefined> {
+    // call your API, adapt { devices, subscription } using this.adaptTo(...)
+    return {
+      id,
+      name: 'My Product',
+      currency: 'USD',
+      campaign,
+      campaignType: '',
+      platformId: 'P123',
+      options: new Map([
+        ['5-12', {
+          devices: 5,
+          subscription: 12,
+          price: 109.99,
+          discountedPrice: 59.99,
+          buyLink: 'https://example/order',
+          trialLink: 'https://example/trial',
+          bundle: []
+        }]
+      ])
+    };
+  }
+}
+
+const store = new Store({ locale: 'en-us', provider: MyProvider });
+```
+
+## Formatting helper
+
+`formatPrice({ price, currency, locale })` is exported for convenience. It uses `Intl.NumberFormat` and returns a string when `currency` is provided, otherwise the raw number.
+
+## Caching and aggregation
+
+- The store caches results per adapted product id + campaign. The adapter can normalize/alias ids before the fetch.
+- If you request the same logical product using multiple raw ids that adapt to the same platform id, the store aggregates options:
+  - First fetch stores a base Product instance in the cache.
+  - Later fetches for the same cache key merge their options into the base via `SET_OPTION`, so you see a superset of options.
+- This is helpful when product variations are delivered under multiple source ids that map to a single platform product.
+
+## Built‑in providers
+
+- `init` (Init Selector)
+  - Posts a small JSON payload to Bitdefender’s selector endpoint, returns a nested map of variations.
+  - Computes buy links, adapts `{ devices, subscription }`, and extracts discounted price when available.
+  - Respects the `campaign` resolver and an internal ignore list (to disable promotions).
+
+- `vlaicu` (Platform API v1)
+  - Fetches a flat list of options with `{ slots, months, price, discountedPrice, buyLink }`.
+  - Adapts `{ devices, subscription }` using the store adapter.
+  - Uses store locale for currency formatting.
+
+Both providers:
+- Respect `overrides`, `trialLinks` and `transformers.option.buyLink`.
+- Use the store’s adapter for id/variation normalization.
+
+## Troubleshooting
+
+- Price shows as a number instead of a formatted string
+  - Ensure the product provides a currency, or pass a `formatter` in Store config.
+
+- `getOption`/`nextOption` returns `undefined`
+  - The requested `{ devices, subscription }` is outside the product’s min/max or not present in the values list.
+
+- Overrides had no effect
+  - Check the `overrides` key matches the product id returned by the provider (after adaptation).
+  - Ensure variation keys are `${devices}-${subscription}` strings.
+
+- Trial link isn’t set
+  - Confirm `trialLinks` has an entry for the variation and not overwritten later by the provider.
+
+- Different ids return a single product
+  - That’s expected when ids adapt to the same platform id; options are aggregated into one Product instance.
+
+## License
+
+ISC

package/dist/src/adaptors/adaptor.base.d.ts

@@ -4,6 +4,7 @@ export type OptionsMapping = Record<number, Record<number, {
 }>>;
 export type ProductsMapping = Map<string, {
     id: string;
+    sourceId: string;
     options?: Promise<OptionsMapping | null>;
 }>;
 export type Product = {

package/dist/src/adaptors/adaptor.base.js

@@ -9,23 +9,23 @@ export class Adaptor {
     }
     async adaptTo(param) {
         const { id, devices, subscription } = param;
-        const product = { id };
+        const product = { id, devices, subscription };
         if (!this.mapper) {
-            product.devices = devices;
-            product.subscription = subscription;
             return product;
         }
         const mappedProduct = this.mapper.get(id);
         if (mappedProduct) {
+            // Use the canonical adapted id for providers/consumers
             product.id = mappedProduct.id;
         }
         else {
-            product.devices = devices;
-            product.subscription = subscription;
+            // No id mapping known; return as-is
             return product;
         }
-        if (mappedProduct && !mappedProduct?.options) {
-            mappedProduct.options = this.getMappingForId(id);
+        // Ensure variation mapping is loaded using the source id (original mapping key)
+        if (!mappedProduct.options) {
+            const sheetId = mappedProduct.sourceId || id;
+            mappedProduct.options = this.getMappingForId(sheetId);
         }
         if (devices && subscription) {
             const options = await mappedProduct.options;
@@ -50,7 +50,9 @@ export class Adaptor {
             const products = new Map();
             for (const product of sheet.data) {
                 const { from, to } = product;
-                products.set(from, { id: to });
+                // Map both the old id and the new id to the same canonical id and source sheet
+                products.set(from, { id: to, sourceId: from });
+                products.set(to, { id: to, sourceId: from });
             }
             return products;
         }

package/dist/src/adaptors/adaptor.base.js.map

@@ -1 +1 @@
-{"version":3,"file":"adaptor.base.js","sourceRoot":"","sources":["../../../src/adaptors/adaptor.base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"adaptor.base.js","sourceRoot":"","sources":["../../../src/adaptors/adaptor.base.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -1,4 +1,5 @@
-import { ProductOption } from "./product-options/option.base.js";
+import { ProductBundleOption, ProductOption } from "./product-options/option.base.js";
 import { Product } from "./products/product.base.js";
 import { Store } from "./store.js";
 export { Product, ProductOption, Store };
+export type { ProductBundleOption };

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EACL,OAAO,EACP,aAAa,EACb,KAAK,EACN,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EACL,OAAO,EAAE,aAAa,EAAE,KAAK,EAC9B,CAAC"}

package/dist/src/product-options/option.base.d.ts

@@ -1,4 +1,6 @@
 import { Product } from "../products/product.base.js";
+import { ProductSelector } from "../store.js";
+type GetOption = number | "prev" | "next";
 export type ProductOptionData = {
     product: Product;
     price: number;
@@ -6,6 +8,13 @@ export type ProductOptionData = {
     devices: number;
     subscription: number;
     buyLink: string;
+    trialLink?: string;
+    bundle?: ProductBundleOption[];
+};
+export type ProductBundleOption = {
+    option: ProductOption;
+    devicesFixed?: boolean;
+    subscriptionFixed?: boolean;
 };
 export declare class ProductOption {
     private product;
@@ -15,38 +24,61 @@ export declare class ProductOption {
     private subscription;
     private currency?;
     private buyLink;
+    private trialLink?;
     private discount;
+    private bundle;
     constructor(option: ProductOptionData);
     getProduct(): Product;
     getVariation(): string;
     getPrice(): string;
     getPrice(param: {
         monthly?: boolean;
-        currency: true;
+        currency?: true;
     }): string;
     getPrice(param: {
         monthly?: boolean;
-        currency?: false;
+        currency: false;
     }): number;
     getDiscountedPrice(): string;
     getDiscountedPrice(param: {
         monthly?: boolean;
-        currency: true;
+        currency?: true;
     }): string;
     getDiscountedPrice(param: {
         monthly?: boolean;
-        currency?: false;
+        currency: false;
     }): number;
-    getDiscount(): number;
+    getDiscount(): string;
     getDiscount(param: {
         percentage?: boolean;
-        symbol: true;
+        symbol?: true;
+        monthly?: boolean;
     }): string;
     getDiscount(param: {
         percentage?: boolean;
-        symbol?: false;
+        symbol: false;
+        monthly?: boolean;
     }): number;
     getBuyLink(): string;
     getDevices(): number;
     getSubscription(): number;
+    getBundle(): ProductBundleOption[];
+    getTrialLink(): string | undefined;
+    getOption(option: {
+        devices?: number;
+        subscription?: number;
+    }): Promise<ProductOption | undefined>;
+    nextOption(option: {
+        devices: GetOption;
+        subscription?: GetOption;
+    } | {
+        devices?: GetOption;
+        subscription: GetOption;
+    } | {
+        devices: GetOption;
+        subscription: GetOption;
+    }): Promise<ProductOption | undefined>;
+    toogleBundle(bundle: ProductBundleOption): Promise<ProductOption | undefined>;
+    switchProduct(productSelector: ProductSelector): Promise<ProductOption | undefined>;
 }
+export {};

package/dist/src/product-options/option.base.js

@@ -1,4 +1,3 @@
-import { formatPrice } from "../format-price.js";
 export class ProductOption {
     product;
     price;
@@ -7,7 +6,9 @@ export class ProductOption {
     subscription;
     currency;
     buyLink;
+    trialLink;
     discount;
+    bundle;
     constructor(option) {
         this.product = option.product;
         this.price = {
@@ -22,10 +23,16 @@ export class ProductOption {
         this.subscription = option.subscription;
         this.currency = option.product.getCurrency();
         this.buyLink = option.buyLink;
+        this.trialLink = option.trialLink;
         this.discount = {
             value: Math.round((option.price - option.discountedPrice + Number.EPSILON) * 100) / 100,
-            percentage: Math.round(((option.price - option.discountedPrice) / option.price * 100))
+            percentage: Math.round(((option.price - option.discountedPrice) / option.price * 100)),
+            monthly: {
+                value: Math.round((option.price - option.discountedPrice + Number.EPSILON) * 100 / option.subscription) / 100,
+                percentage: Math.round(((option.price - option.discountedPrice) / option.price * 100 / option.subscription))
+            }
         };
+        this.bundle = option.bundle || [];
     }
     getProduct() {
         return this.product;
@@ -37,7 +44,7 @@ export class ProductOption {
         const { monthly = false, currency = true } = param ?? {};
         const rawPrice = monthly ? this.price.monthly : this.price.value;
         if (currency) {
-            return formatPrice({ price: rawPrice, currency: this.currency });
+            return this.product.getStore().formatPrice({ price: rawPrice, currency: this.currency });
         }
         return rawPrice;
     }
@@ -45,17 +52,18 @@ export class ProductOption {
         const { monthly = false, currency = true } = param ?? {};
         const rawPrice = monthly ? this.discountedPrice.monthly : this.discountedPrice.value;
         if (currency) {
-            return formatPrice({ price: rawPrice, currency: this.currency });
+            return this.product.getStore().formatPrice({ price: rawPrice, currency: this.currency });
         }
         return rawPrice;
     }
     getDiscount(param) {
-        const { percentage = false, symbol = true } = param ?? {};
-        const rawValue = percentage ? this.discount.percentage : this.discount.value;
+        const { percentage = false, symbol = true, monthly = false } = param ?? {};
+        const discount = monthly ? this.discount.monthly : this.discount;
+        const rawValue = percentage ? discount.percentage : discount.value;
         if (symbol) {
             return percentage
                 ? `${rawValue}%`
-                : formatPrice({ price: rawValue, currency: this.currency });
+                : this.product.getStore().formatPrice({ price: rawValue, currency: this.currency });
         }
         return rawValue;
     }
@@ -68,5 +76,136 @@ export class ProductOption {
     getSubscription() {
         return this.subscription;
     }
+    getBundle() {
+        return this.bundle;
+    }
+    getTrialLink() {
+        return this.trialLink;
+    }
+    async getOption(option) {
+        if (!option) {
+            return undefined;
+        }
+        const devices = this.product.getDevices();
+        const subscriptions = this.product.getSubscriptions();
+        // Determine target indices for devices and subscriptions
+        const computeIndex = (currentIndex, values, opt) => {
+            if (opt === undefined) {
+                // no change requested
+                return currentIndex;
+            }
+            else {
+                // numeric means absolute index value
+                const numeric = Number(opt);
+                return values.findIndex(v => v === numeric);
+            }
+        };
+        // Current indices
+        const idxDevice = devices.values.findIndex(v => v === this.devices);
+        const idxSubscription = subscriptions.values.findIndex(v => v === this.subscription);
+        // Next indices
+        const targetDeviceIdx = computeIndex(idxDevice, devices.values, option.devices);
+        const targetSubscriptionIdx = computeIndex(idxSubscription, subscriptions.values, option.subscription);
+        // Calculate new values
+        const newDevice = devices.values[targetDeviceIdx];
+        const newSubscription = subscriptions.values[targetSubscriptionIdx];
+        // Bail out if out of range
+        if (targetDeviceIdx < 0 ||
+            targetSubscriptionIdx < 0 ||
+            newDevice > devices.max ||
+            newSubscription > subscriptions.max ||
+            newDevice < devices.min ||
+            newSubscription < devices.min) {
+            return undefined;
+        }
+        // Build new bundle, mapping fixed options and fetching new ones
+        const newBundle = await Promise.all(this.bundle.map(async (b) => {
+            const nextOption = await b.option.getOption({
+                devices: b.devicesFixed ? b.option.getDevices() : option.devices,
+                subscription: b.subscriptionFixed ? b.option.getSubscription() : option.subscription
+            });
+            return { ...b, option: nextOption };
+        }));
+        // Ensure all bundle options are defined
+        const isDefinedBundle = (b) => b.option != null;
+        if (!newBundle.every(isDefinedBundle)) {
+            return undefined;
+        }
+        // Return the new ProductOption
+        return this.product.getOption({
+            devices: newDevice,
+            subscription: newSubscription,
+            bundle: newBundle
+        });
+    }
+    async nextOption(option) {
+        if (!option) {
+            return undefined;
+        }
+        const devices = this.product.getDevices();
+        const subscriptions = this.product.getSubscriptions();
+        // Determine target indices for devices and subscriptions
+        const computeIndex = (currentIndex, values, opt) => {
+            if (opt === undefined) {
+                // no change requested
+                return currentIndex;
+            }
+            else if (opt === 'next') {
+                return currentIndex + 1;
+            }
+            else if (opt === 'prev') {
+                return currentIndex - 1;
+            }
+            else {
+                const numeric = currentIndex + Number(opt);
+                return values.findIndex(v => v === numeric);
+            }
+        };
+        // Current indices
+        const idxDevice = devices.values.findIndex(v => v === this.devices);
+        const idxSubscription = subscriptions.values.findIndex(v => v === this.subscription);
+        // Next indices
+        const targetDeviceIdx = computeIndex(idxDevice, devices.values, option.devices);
+        const targetSubscriptionIdx = computeIndex(idxSubscription, subscriptions.values, option.subscription);
+        // Calculate new values
+        const newDevice = devices.values[targetDeviceIdx];
+        const newSubscription = subscriptions.values[targetSubscriptionIdx];
+        // Bail out if out of range
+        if (targetDeviceIdx < 0 ||
+            targetSubscriptionIdx < 0 ||
+            newDevice > devices.max ||
+            newSubscription > subscriptions.max ||
+            newDevice < devices.min ||
+            newSubscription < devices.min) {
+            return undefined;
+        }
+        return this.getOption({ devices: newDevice, subscription: newSubscription });
+    }
+    async toogleBundle(bundle) {
+        const getKey = (option) => {
+            return `${option.getProduct().getId()}${option.getProduct().getCampaign()}${option.getDevices()}${option.getSubscription()}`;
+        };
+        const idx = this.bundle.findIndex(b => getKey(b.option) === getKey(bundle.option));
+        let newBundle;
+        if (idx !== -1) {
+            newBundle = this.bundle.toSpliced(idx, 1);
+        }
+        else {
+            newBundle = this.bundle.toSpliced(0, 0, bundle);
+        }
+        return this.product.getOption({
+            devices: this.devices,
+            subscription: this.subscription,
+            bundle: newBundle
+        });
+    }
+    async switchProduct(productSelector) {
+        const product = await this.product.getStore().getProduct(productSelector);
+        return product?.getOption({
+            devices: this.devices,
+            subscription: this.subscription,
+            bundle: this.bundle
+        });
+    }
 }
 //# sourceMappingURL=option.base.js.map