feeef 0.8.11 → 0.9.0

package/README.md

@@ -2,6 +2,10 @@
 
 `feeefjs` is a TypeScript library for managing feeef e-commerce platforms for self-hosted stores. It provides a wrapper for feeef rest api such like send order..., also have frontend srvices like the `CartService` class for managing cart items, shipping methods, and calculating totals. The library also includes a `NotifiableService` base class for handling listeners that react to changes in the service state.
 
+## Delivery parcel types
+
+Canonical shipment shapes mirror the API domain in `feeefapps/backend/services/delivery/domain/parcel.ts`. In this package they live under `src/delivery/parcel.ts` and are exported from the main entry (`ParcelCreate`, `ParcelUpdate`, `DeliveryCarrierClient`, …). Keep them in sync when the backend parcel model changes; published npm `feeef` should re-export the same definitions after each release.
+
 ## Developer OAuth (third-party apps)
 
 Use `OAuthRepository.buildAuthorizeUrl` (point `baseUrl` at the **accounts** host, e.g. `https://accounts.feeef.org`) and `FeeeF` client `oauth.exchangeAuthorizationCode` / `revokeToken` / `introspectToken` against the **API** base (`.../v1`). Full flow, scopes, and troubleshooting: Feeef backend **`docs/OAUTH2_DEVELOPER.md`** (in the Adonis API repo).

package/build/index.js

@@ -167,6 +167,7 @@ var OrderRepository = class extends ModelRepository {
       if (options.shippingState) params.shippingState = options.shippingState;
       if (options.shippingCity) params.shippingCity = options.shippingCity;
       if (options.deliveryService) params.deliveryService = options.deliveryService;
+      if (options.references !== void 0) params.references = options.references;
     }
     return super.list({ params });
   }
@@ -321,6 +322,15 @@ var ProductRepository = class extends ModelRepository {
     const res = await this.client.get(`/stores/${storeId}/${this.resource}/${productId}/report`);
     return res.data;
   }
+  /**
+   * Lite orders report for a product in a store.
+   */
+  async liteOrdersReport(storeId, productId) {
+    const res = await this.client.get(
+      `/stores/${storeId}/${this.resource}/${productId}/analytics/lor`
+    );
+    return res.data;
+  }
 };
 
 // src/feeef/repositories/store_invites_repository.ts
@@ -329,6 +339,8 @@ var StoreInvitesRepository = class {
     this.client = client;
     this.resource = resource;
   }
+  client;
+  resource;
   /**
    * Lists invites for a store.
    * @param storeId - The store ID.
@@ -434,6 +446,13 @@ var StoreRepository = class extends ModelRepository {
     }
     return chartData;
   }
+  /**
+   * Lite orders report for the store (8 UTC days + total).
+   */
+  async liteOrdersReport(storeId) {
+    const res = await this.client.get(`/${this.resource}/${storeId}/analytics/lor`);
+    return res.data;
+  }
   /**
    * Adds a member to the store.
    * @param storeId - The store ID.
@@ -1160,6 +1179,7 @@ var PromoRepository = class {
   constructor(client) {
     this.client = client;
   }
+  client;
   /**
    * Lists promos with optional pagination and validNow filter.
    */
@@ -1815,6 +1835,15 @@ var ProductLandingPagesRepository = class extends ModelRepository {
     const params = { ...options?.params };
     return super.list({ params });
   }
+  /**
+   * Lite orders report for a product landing page in a store.
+   */
+  async liteOrdersReport(storeId, landingPageId) {
+    const res = await this.client.get(
+      `/stores/${storeId}/product_landing_pages/${landingPageId}/analytics/lor`
+    );
+    return res.data;
+  }
 };
 
 // src/core/entities/attachment.ts
@@ -2252,10 +2281,14 @@ var ShippingPriceStatus = /* @__PURE__ */ ((ShippingPriceStatus2) => {
   return ShippingPriceStatus2;
 })(ShippingPriceStatus || {});
 function getShippingPrice(prices, countryCode, stateCode, type) {
+  console.log("0 [getShippingPrice]", { prices, countryCode, stateCode, type });
   const countryRates = prices[countryCode];
+  console.log("1 [getShippingPrice] countryRates", countryRates);
   if (!countryRates) return null;
   const stateRates = countryRates[stateCode];
+  console.log("2 [getShippingPrice] stateRates", stateRates);
   if (!stateRates) return null;
+  console.log("3 [getShippingPrice] stateRates[type]", stateRates[type]);
   return stateRates[type] ?? null;
 }
 function isShippingAvailable(prices, countryCode, stateCode) {
@@ -4085,6 +4118,14 @@ var ProductType = /* @__PURE__ */ ((ProductType2) => {
   ProductType2["service"] = "service";
   return ProductType2;
 })(ProductType || {});
+function formatProductOrderReference(productId) {
+  return `product:${productId}`;
+}
+
+// src/core/entities/product_landing_page.ts
+function formatProductLandingPageOrderReference(landingPageId) {
+  return `product_landing_page:${landingPageId}`;
+}
 
 // src/core/entities/feedback.ts
 var FeedbackStatus = /* @__PURE__ */ ((FeedbackStatus2) => {
@@ -4144,6 +4185,8 @@ var FeeefTransmitHttpClient = class {
     this.options = options;
     this.getAuthorizationHeader = getAuthorizationHeader;
   }
+  options;
+  getAuthorizationHeader;
   send(request) {
     return fetch(request);
   }
@@ -4192,6 +4235,414 @@ function createFeeefTransmitFromAxios(client, options) {
   });
 }
 
+// src/ai/ai_calculator.ts
+var FALLBACK_AI_EXCHANGE_RATE = 260;
+var DEFAULT_TTS = {
+  whenScriptEmptyTokens: 200,
+  whenAttachmentsOnlyTokens: 400,
+  promptBaseTokens: 400,
+  promptPerAttachmentTokens: 300,
+  outputMinimumTokens: 300,
+  outputToTextTokenRatio: 2.5,
+  maxTotalTokens: 32e3
+};
+var DEFAULT_RESOLVED = {
+  retailMarkup: { multiplier: 2.5 },
+  referenceAttachmentSurcharge: {
+    perFileUsd: 0.1,
+    highResolutionExtraPerFileUsd: 0.05,
+    lowResolutionDiscountPerFileUsd: 0.05
+  },
+  imageGeneration: { fallbackProviderCostPerImageUsd: 0.131 },
+  textGeneration: {
+    freeTierMaxPromptTokens: 1e3,
+    estimatedPromptTokensDefault: 2e3,
+    estimatedOutputTokensDefault: 1e3
+  },
+  voiceGeneration: {
+    minimumChargeUsd: 50 / FALLBACK_AI_EXCHANGE_RATE,
+    scriptEnhancementAddonUsd: 25 / FALLBACK_AI_EXCHANGE_RATE,
+    ttsTokenEstimate: { ...DEFAULT_TTS }
+  },
+  landingPageImage: {
+    fixedChargeUsd: 100 / FALLBACK_AI_EXCHANGE_RATE
+  }
+};
+function mergeTts(base, partial) {
+  if (!partial) return { ...base };
+  return {
+    whenScriptEmptyTokens: partial.whenScriptEmptyTokens ?? base.whenScriptEmptyTokens,
+    whenAttachmentsOnlyTokens: partial.whenAttachmentsOnlyTokens ?? base.whenAttachmentsOnlyTokens,
+    promptBaseTokens: partial.promptBaseTokens ?? base.promptBaseTokens,
+    promptPerAttachmentTokens: partial.promptPerAttachmentTokens ?? base.promptPerAttachmentTokens,
+    outputMinimumTokens: partial.outputMinimumTokens ?? base.outputMinimumTokens,
+    outputToTextTokenRatio: partial.outputToTextTokenRatio ?? base.outputToTextTokenRatio,
+    maxTotalTokens: partial.maxTotalTokens ?? base.maxTotalTokens
+  };
+}
+function mergeAiModelsBilling(partial) {
+  const d = DEFAULT_RESOLVED;
+  if (!partial) return structuredClone(d);
+  const v = partial.voiceGeneration;
+  const tts = mergeTts(d.voiceGeneration.ttsTokenEstimate, v?.ttsTokenEstimate);
+  return {
+    retailMarkup: {
+      multiplier: partial.retailMarkup?.multiplier ?? d.retailMarkup.multiplier
+    },
+    referenceAttachmentSurcharge: {
+      perFileUsd: partial.referenceAttachmentSurcharge?.perFileUsd ?? d.referenceAttachmentSurcharge.perFileUsd,
+      highResolutionExtraPerFileUsd: partial.referenceAttachmentSurcharge?.highResolutionExtraPerFileUsd ?? d.referenceAttachmentSurcharge.highResolutionExtraPerFileUsd,
+      lowResolutionDiscountPerFileUsd: partial.referenceAttachmentSurcharge?.lowResolutionDiscountPerFileUsd ?? d.referenceAttachmentSurcharge.lowResolutionDiscountPerFileUsd
+    },
+    imageGeneration: {
+      fallbackProviderCostPerImageUsd: partial.imageGeneration?.fallbackProviderCostPerImageUsd ?? d.imageGeneration.fallbackProviderCostPerImageUsd
+    },
+    textGeneration: {
+      freeTierMaxPromptTokens: partial.textGeneration?.freeTierMaxPromptTokens ?? d.textGeneration.freeTierMaxPromptTokens,
+      estimatedPromptTokensDefault: partial.textGeneration?.estimatedPromptTokensDefault ?? d.textGeneration.estimatedPromptTokensDefault,
+      estimatedOutputTokensDefault: partial.textGeneration?.estimatedOutputTokensDefault ?? d.textGeneration.estimatedOutputTokensDefault
+    },
+    voiceGeneration: {
+      minimumChargeUsd: v?.minimumChargeUsd ?? d.voiceGeneration.minimumChargeUsd,
+      scriptEnhancementAddonUsd: v?.scriptEnhancementAddonUsd ?? d.voiceGeneration.scriptEnhancementAddonUsd,
+      ttsTokenEstimate: tts
+    },
+    landingPageImage: {
+      fixedChargeUsd: partial.landingPageImage?.fixedChargeUsd ?? d.landingPageImage.fixedChargeUsd
+    }
+  };
+}
+function roundMoney(amount, precision = 3) {
+  const factor = 10 ** precision;
+  return Math.round((amount + Number.EPSILON) * factor) / factor;
+}
+function getLegacyAiBillingFlat(exchangeRate, resolved = mergeAiModelsBilling(null)) {
+  const t = resolved.voiceGeneration.ttsTokenEstimate;
+  return {
+    MULTIPLIER: resolved.retailMarkup.multiplier,
+    FREE_TEXT_TOKENS_THRESHOLD: resolved.textGeneration.freeTierMaxPromptTokens,
+    DEFAULT_EXCHANGE_RATE: FALLBACK_AI_EXCHANGE_RATE,
+    DEFAULT_GOOGLE_IMAGE_COST_USD: resolved.imageGeneration.fallbackProviderCostPerImageUsd,
+    DEFAULT_ATTACHMENT_COST_USD: resolved.referenceAttachmentSurcharge.perFileUsd,
+    ATTACHMENT_HIGH_RES_EXTRA_USD: resolved.referenceAttachmentSurcharge.highResolutionExtraPerFileUsd,
+    ATTACHMENT_LOW_RES_DISCOUNT_USD: resolved.referenceAttachmentSurcharge.lowResolutionDiscountPerFileUsd,
+    VOICEOVER_FIXED_COST_DZD: roundMoney(
+      resolved.voiceGeneration.minimumChargeUsd * exchangeRate,
+      3
+    ),
+    VOICEOVER_ENHANCE_ADDON_DZD: roundMoney(
+      resolved.voiceGeneration.scriptEnhancementAddonUsd * exchangeRate,
+      3
+    ),
+    IMAGE_LANDING_PAGE_FIXED_COST_DZD: roundMoney(
+      resolved.landingPageImage.fixedChargeUsd * exchangeRate,
+      3
+    ),
+    DEFAULT_TEXT_PROMPT_TOKENS: resolved.textGeneration.estimatedPromptTokensDefault,
+    DEFAULT_TEXT_OUTPUT_TOKENS: resolved.textGeneration.estimatedOutputTokensDefault,
+    VOICE_TTS_EMPTY_SCRIPT_TEXT_TOKENS: t.whenScriptEmptyTokens,
+    VOICE_TTS_ATTACHMENT_ONLY_TEXT_TOKENS: t.whenAttachmentsOnlyTokens,
+    VOICE_TTS_PROMPT_BASE: t.promptBaseTokens,
+    VOICE_TTS_PROMPT_PER_ATTACHMENT: t.promptPerAttachmentTokens,
+    VOICE_TTS_OUTPUT_MIN: t.outputMinimumTokens,
+    VOICE_TTS_OUTPUT_TEXT_FACTOR: t.outputToTextTokenRatio,
+    VOICE_TTS_TOKEN_CAP: t.maxTotalTokens
+  };
+}
+var AI_BILLING = getLegacyAiBillingFlat(FALLBACK_AI_EXCHANGE_RATE);
+function findModel(models, modelId, fallbackId) {
+  return models.find((m) => m.id === modelId) || models.find((m) => m.id === fallbackId) || models[0];
+}
+function modelHasVoiceCapability(model) {
+  const caps = model?.capabilities;
+  if (!Array.isArray(caps)) return false;
+  return caps.some((c) => c === "voice" || c === "audio");
+}
+function findVoiceModel(models, modelId, fallbackId) {
+  return models.find((m) => m.id === modelId) || models.find((m) => m.id === fallbackId) || models.find((m) => modelHasVoiceCapability(m));
+}
+function pickTtsProviderOutputUsd(model) {
+  if (!model?.pricing?.length) return null;
+  const voiceLike = modelHasVoiceCapability(model);
+  for (const unit of ["audio", "voice"]) {
+    const row = model.pricing.find((p) => p.unit === unit);
+    if (row?.output == null) continue;
+    const usd = row.output;
+    if (usd > 0) return usd;
+  }
+  if (voiceLike) {
+    const row = model.pricing.find((p) => p.unit === "image");
+    if (row?.output == null) return null;
+    const usd = row.output;
+    if (usd > 0) return usd;
+  }
+  return null;
+}
+function ttsTokenEstimatesFromResolved(b, scriptCharLength, attachmentCount) {
+  const t = b.voiceGeneration.ttsTokenEstimate;
+  let textTok = Math.round(scriptCharLength / 4);
+  if (textTok <= 0) {
+    textTok = attachmentCount > 0 ? t.whenAttachmentsOnlyTokens : t.whenScriptEmptyTokens;
+  }
+  const rawPrompt = t.promptBaseTokens + textTok + attachmentCount * t.promptPerAttachmentTokens;
+  const promptTokens = Math.min(t.maxTotalTokens, Math.max(0, rawPrompt));
+  const rawOutput = Math.max(t.outputMinimumTokens, Math.round(textTok * t.outputToTextTokenRatio));
+  const outputTokens = Math.min(t.maxTotalTokens, rawOutput);
+  return { promptTokens, outputTokens };
+}
+function defaultVoiceTtsTokenEstimates(scriptCharLength, attachmentCount) {
+  return ttsTokenEstimatesFromResolved(
+    mergeAiModelsBilling(null),
+    scriptCharLength,
+    attachmentCount
+  );
+}
+function pickVoiceTokenPricing(model, totalTokens) {
+  const tokenPricings = (model?.pricing ?? []).filter((p) => p.unit === "tokens");
+  if (!tokenPricings.length) return null;
+  const isLargeContext = totalTokens > 2e5;
+  const preferred = tokenPricings.find(
+    (p) => isLargeContext ? String(p.contextThreshold ?? "").includes(">") : String(p.contextThreshold ?? "").includes("<=")
+  ) || tokenPricings[0];
+  const input = preferred.input ?? 0;
+  const output = preferred.output ?? 0;
+  if (input <= 0 && output <= 0) return null;
+  return { input, output };
+}
+var AiCalculator = class {
+  config;
+  constructor(config = {}) {
+    const exchangeRate = config.exchangeRate ?? FALLBACK_AI_EXCHANGE_RATE;
+    const billing = mergeAiModelsBilling(config.billing ?? null);
+    const fallbackDzd = billing.imageGeneration.fallbackProviderCostPerImageUsd * exchangeRate;
+    this.config = {
+      exchangeRate,
+      defaultImageCost: config.defaultImageCost ?? fallbackDzd,
+      referenceImageCost: config.referenceImageCost ?? 5,
+      resolutionCosts: config.resolutionCosts ?? {
+        MEDIA_RESOLUTION_LOW: 0,
+        MEDIA_RESOLUTION_MEDIUM: 5,
+        MEDIA_RESOLUTION_HIGH: 10
+      },
+      models: config.models ?? [],
+      billing
+    };
+  }
+  /** TTS base DZD: localCost → flat USD row → tokens (per 1M) × estimates × rate × multiplier → floor. */
+  _voiceoverBaseUserCostDzd(modelId, promptTokens, outputTokens) {
+    const { exchangeRate, billing, models } = this.config;
+    const b = billing;
+    const floorDzd = roundMoney(b.voiceGeneration.minimumChargeUsd * exchangeRate);
+    const model = findVoiceModel(models, modelId, "gemini-2.5-pro-preview-tts");
+    if (model?.localCost !== void 0 && model.localCost !== null) {
+      return { baseDzd: roundMoney(model.localCost), usedLocalCost: true };
+    }
+    const providerUsd = pickTtsProviderOutputUsd(model);
+    if (providerUsd != null) {
+      const providerDzd = providerUsd * exchangeRate;
+      return {
+        baseDzd: roundMoney(providerDzd * b.retailMarkup.multiplier),
+        usedLocalCost: false
+      };
+    }
+    const tokenPricing = pickVoiceTokenPricing(model, promptTokens + outputTokens);
+    if (tokenPricing) {
+      const providerCostUsd = promptTokens / 1e6 * tokenPricing.input + outputTokens / 1e6 * tokenPricing.output;
+      const providerDzd = providerCostUsd * exchangeRate;
+      return {
+        baseDzd: roundMoney(providerDzd * b.retailMarkup.multiplier),
+        usedLocalCost: false
+      };
+    }
+    return { baseDzd: floorDzd, usedLocalCost: false };
+  }
+  _attachmentExtraUserDzd(attachmentCount, attachmentResolution) {
+    if (attachmentCount <= 0) return 0;
+    const { exchangeRate, billing } = this.config;
+    const ref = billing.referenceAttachmentSurcharge;
+    const m = billing.retailMarkup.multiplier;
+    let attachCostUsd = attachmentCount * ref.perFileUsd;
+    if (attachmentResolution === "high") {
+      attachCostUsd += attachmentCount * ref.highResolutionExtraPerFileUsd;
+    } else if (attachmentResolution === "low") {
+      attachCostUsd -= attachmentCount * ref.lowResolutionDiscountPerFileUsd;
+    }
+    return roundMoney(attachCostUsd * exchangeRate * m);
+  }
+  /**
+   * Estimate the cost of an image generation action.
+   * Covers: image gen, logo gen, editOrGenerateSimpleImage.
+   */
+  estimateImageGeneration(options = {}) {
+    const {
+      modelId = "gemini-3.1-flash-image-preview",
+      attachmentCount = 0,
+      attachmentResolution = "medium",
+      resolution,
+      imageSize,
+      iterations = 1,
+      referenceImageCount = 0
+    } = options;
+    const model = findModel(this.config.models, modelId, "gemini-3.1-flash-image-preview");
+    const { exchangeRate, defaultImageCost, billing } = this.config;
+    const mult = billing.retailMarkup.multiplier;
+    const localCost = model?.localCost;
+    const imagePricing = model?.pricing?.find((p) => p.unit === "image");
+    const providerCostUsd = imagePricing?.output ? imagePricing.output : defaultImageCost / exchangeRate;
+    const providerCostDzd = imagePricing?.output ? providerCostUsd * exchangeRate : defaultImageCost;
+    const computedUserCostDzd = providerCostDzd * mult;
+    const usedLocalCost = localCost !== void 0 && localCost !== null;
+    const basePerIteration = usedLocalCost ? localCost : roundMoney(computedUserCostDzd);
+    const baseCostDzd = roundMoney(basePerIteration * iterations);
+    const refExtraDzd = roundMoney(referenceImageCount * this.config.referenceImageCost);
+    const attachExtraDzd = this._attachmentExtraUserDzd(attachmentCount, attachmentResolution);
+    const supportsImageSize = modelId === "gemini-3.1-flash-image-preview";
+    let outputResKey = "MEDIA_RESOLUTION_HIGH";
+    if (supportsImageSize && imageSize) {
+      outputResKey = imageSize === "4K" ? "MEDIA_RESOLUTION_HIGH" : imageSize === "2K" ? "MEDIA_RESOLUTION_MEDIUM" : "MEDIA_RESOLUTION_LOW";
+    } else if (resolution) {
+      outputResKey = resolution;
+    }
+    const outputResExtraDzd = supportsImageSize ? roundMoney(this.config.resolutionCosts[outputResKey] ?? 0) : 0;
+    let referenceResolutionExtraDzd = 0;
+    if (referenceImageCount > 0 && resolution) {
+      const low = this.config.resolutionCosts.MEDIA_RESOLUTION_LOW ?? 0;
+      const tier = this.config.resolutionCosts[resolution] ?? 0;
+      referenceResolutionExtraDzd = roundMoney(Math.max(0, tier - low));
+    }
+    const resExtraDzd = roundMoney(outputResExtraDzd + referenceResolutionExtraDzd);
+    const userCostDzd = roundMoney(baseCostDzd + refExtraDzd + attachExtraDzd + resExtraDzd);
+    return {
+      providerCostUsd: providerCostUsd * iterations,
+      providerCostDzd: providerCostDzd * iterations,
+      userCostDzd,
+      exchangeRate,
+      multiplier: mult,
+      usedLocalCost,
+      breakdown: {
+        baseCostDzd,
+        referenceImageExtraDzd: refExtraDzd,
+        attachmentExtraDzd: attachExtraDzd,
+        outputResolutionExtraDzd: outputResExtraDzd,
+        referenceResolutionExtraDzd,
+        resolutionExtraDzd: resExtraDzd,
+        iterations,
+        referenceImageCount,
+        attachmentCount
+      }
+    };
+  }
+  /**
+   * Estimate the cost of a text generation action.
+   * Covers: updateProductUsingAi, generateSimpleCode, generateCustomComponentCode.
+   * Uses estimated tokens (exact cost billed post-generation).
+   */
+  estimateTextGeneration(options = {}) {
+    const tg = this.config.billing.textGeneration;
+    const mult = this.config.billing.retailMarkup.multiplier;
+    const {
+      modelId = "gemini-3-flash-preview",
+      estimatedPromptTokens = tg.estimatedPromptTokensDefault,
+      estimatedOutputTokens = tg.estimatedOutputTokensDefault
+    } = options;
+    const totalTokens = estimatedPromptTokens + estimatedOutputTokens;
+    const { exchangeRate } = this.config;
+    const model = findModel(this.config.models, modelId, "gemini-3-flash-preview");
+    const tokenPricing = model?.pricing?.find((p) => p.unit === "tokens");
+    if (!tokenPricing || totalTokens < tg.freeTierMaxPromptTokens) {
+      return {
+        providerCostUsd: 0,
+        providerCostDzd: 0,
+        userCostDzd: 0,
+        exchangeRate,
+        multiplier: mult,
+        usedLocalCost: false,
+        breakdown: {
+          estimatedPromptTokens,
+          estimatedOutputTokens,
+          isFree: true
+        }
+      };
+    }
+    const inputPrice = tokenPricing.input ?? 0;
+    const outputPrice = tokenPricing.output ?? 0;
+    const providerCostUsd = estimatedPromptTokens / 1e6 * inputPrice + estimatedOutputTokens / 1e6 * outputPrice;
+    const providerCostDzd = providerCostUsd * exchangeRate;
+    const userCostDzd = roundMoney(providerCostDzd * mult);
+    return {
+      providerCostUsd,
+      providerCostDzd,
+      userCostDzd,
+      exchangeRate,
+      multiplier: mult,
+      usedLocalCost: false,
+      breakdown: {
+        estimatedPromptTokens,
+        estimatedOutputTokens,
+        isFree: false
+      }
+    };
+  }
+  /**
+   * Voiceover: base + attachment surcharge + optional script-enhancement add-on.
+   */
+  estimateVoiceover(options = {}) {
+    const modelId = options.modelId ?? "gemini-2.5-pro-preview-tts";
+    const attachmentCount = options.attachmentCount ?? 0;
+    const attachmentResolution = options.attachmentResolution ?? "medium";
+    const enhanceScript = options.enhanceScript !== false;
+    const charLen = options.scriptCharLength ?? 0;
+    const b = this.config.billing;
+    const cap = b.voiceGeneration.ttsTokenEstimate.maxTotalTokens;
+    const tokenEst = (
+      // eslint-disable-next-line eqeqeq
+      options.estimatedPromptTokens != null && options.estimatedOutputTokens != null ? {
+        promptTokens: Math.max(0, Math.min(cap, options.estimatedPromptTokens)),
+        outputTokens: Math.max(0, Math.min(cap, options.estimatedOutputTokens))
+      } : ttsTokenEstimatesFromResolved(b, charLen, attachmentCount)
+    );
+    const { exchangeRate } = this.config;
+    const { baseDzd, usedLocalCost } = this._voiceoverBaseUserCostDzd(
+      modelId,
+      tokenEst.promptTokens,
+      tokenEst.outputTokens
+    );
+    const attachExtra = this._attachmentExtraUserDzd(attachmentCount, attachmentResolution);
+    const enhanceExtra = enhanceScript ? roundMoney(b.voiceGeneration.scriptEnhancementAddonUsd * exchangeRate) : 0;
+    const userCostDzd = roundMoney(baseDzd + attachExtra + enhanceExtra);
+    return {
+      providerCostUsd: userCostDzd / exchangeRate,
+      providerCostDzd: userCostDzd,
+      userCostDzd,
+      exchangeRate,
+      multiplier: 1,
+      usedLocalCost,
+      breakdown: {
+        fixedCostDzd: baseDzd,
+        attachmentExtraDzd: attachExtra,
+        enhanceAddonDzd: enhanceExtra,
+        attachmentCount,
+        estimatedPromptTokens: tokenEst.promptTokens,
+        estimatedOutputTokens: tokenEst.outputTokens
+      }
+    };
+  }
+  /** Get the fixed cost for image landing page generation. */
+  estimateImageLandingPage() {
+    const { exchangeRate, billing } = this.config;
+    const costDzd = roundMoney(billing.landingPageImage.fixedChargeUsd * exchangeRate);
+    return {
+      providerCostUsd: costDzd / exchangeRate,
+      providerCostDzd: costDzd,
+      userCostDzd: costDzd,
+      exchangeRate,
+      multiplier: 1,
+      usedLocalCost: false,
+      breakdown: { fixedCostDzd: costDzd }
+    };
+  }
+};
+
 // src/utils.ts
 var convertDartColorToCssNumber = (dartColor) => {
   const alpha = dartColor >> 24 & 255;
@@ -4276,8 +4727,10 @@ function validatePhoneNumber(phone) {
   return null;
 }
 export {
+  AI_BILLING,
   ATTACHMENT_TYPES,
   ActionsService,
+  AiCalculator,
   AppRepository,
   CartService,
   CategoryRepository,
@@ -4290,6 +4743,7 @@ export {
   EcomanagerDeliveryIntegrationApi,
   EcotrackDeliveryIntegrationApi,
   EmbaddedContactType,
+  FALLBACK_AI_EXCHANGE_RATE,
   FeedbackPriority,
   FeedbackRepository,
   FeedbackStatus,
@@ -4346,6 +4800,9 @@ export {
   createImageGenerationFormData,
   cssColorToHslString,
   dartColorToCssColor,
+  defaultVoiceTtsTokenEstimates,
+  formatProductLandingPageOrderReference,
+  formatProductOrderReference,
   generatePublicIntegrationsData,
   generatePublicIntegrationsDataGoogleAnalytics,
   generatePublicIntegrationsDataGoogleSheets,
@@ -4366,9 +4823,11 @@ export {
   generatePublicStoreIntegrationWebhooks,
   generatePublicStoreIntegrations,
   getAvailableShippingTypes,
+  getLegacyAiBillingFlat,
   getShippingPrice,
   isAttachmentType,
   isShippingAvailable,
+  mergeAiModelsBilling,
   normalizeAttachmentPayload,
   normalizeAttachmentPayloads,
   normalizeImageGeneration,