@grupolapa/cotizador-sdk 0.1.0

package/dist/selection-state.js

@@ -0,0 +1,156 @@
+import { clampToRange, getDefaultDownPaymentPctForScheme, getPaymentSchemeById, getResolvedSchemeForUnit, } from "./payment-schemes.js";
+import { clampUondrCashbackDownPaymentPct, getSocialDefaultDownPaymentPct, SOCIAL_INCLUDE_IVA, } from "./social-quote.js";
+import { clampInstallmentDownPaymentPct, clampInstallmentMonthlyPct, INSTALLMENT_DEFAULT_DOWN_PAYMENT_PCT, INSTALLMENT_DEFAULT_MONTHLY_PCT, } from "./installment-allocation.js";
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function getAvailableCategories(content) {
+    return Array.from(new Set([
+        ...content.siteContent.categories.map((category) => category.id),
+        ...content.inventory.map((unit) => unit.category),
+    ].filter(isNonEmptyString)));
+}
+function getUnitById(units, unitId) {
+    return units.find((unit) => unit.id === unitId) ?? null;
+}
+function getDefaultCategory(content) {
+    const availableCategories = getAvailableCategories(content);
+    if (isNonEmptyString(content.financeRules.defaults.category) &&
+        availableCategories.includes(content.financeRules.defaults.category)) {
+        return content.financeRules.defaults.category;
+    }
+    return (availableCategories[0] ??
+        getUnitById(content.inventory, content.financeRules.defaults.unitId)
+            ?.category ??
+        content.inventory[0]?.category ??
+        "");
+}
+function getDefaultUnitForCategory(units, defaultUnitId, category) {
+    return (units.find((unit) => unit.id === defaultUnitId && unit.category === category) ??
+        units.find((unit) => unit.category === category) ??
+        null);
+}
+function getFallbackScheme(content, requestedSchemeId, category) {
+    const defaultUnitForCategory = getDefaultUnitForCategory(content.inventory, content.financeRules.defaults.unitId, category);
+    if (defaultUnitForCategory) {
+        return getResolvedSchemeForUnit(defaultUnitForCategory, content.paymentSchemes, requestedSchemeId);
+    }
+    const defaultScheme = getPaymentSchemeById(content.paymentSchemes, content.financeRules.defaults.schemeId);
+    return (content.paymentSchemes.find((scheme) => scheme.id === requestedSchemeId && scheme.active) ??
+        (defaultScheme?.active ? defaultScheme : null) ??
+        content.paymentSchemes.find((scheme) => scheme.active) ??
+        null);
+}
+function resolveScheme(content, unit, requestedSchemeId, category) {
+    if (unit) {
+        return getResolvedSchemeForUnit(unit, content.paymentSchemes, requestedSchemeId);
+    }
+    return getFallbackScheme(content, requestedSchemeId, category);
+}
+function getResolvedDownPaymentPct(surface, requestedState, scheme, content) {
+    if (scheme?.type === "cashback" &&
+        (surface === "uondr" || surface === "a-uondr")) {
+        return clampUondrCashbackDownPaymentPct(scheme, requestedState.downPaymentPct);
+    }
+    if (scheme?.type === "cashback" && surface === "default") {
+        return clampToRange(requestedState.downPaymentPct, scheme.downPaymentRange);
+    }
+    if (surface !== "default") {
+        return getSocialDefaultDownPaymentPct(scheme, content.financeRules);
+    }
+    return getDefaultDownPaymentPctForScheme(scheme, content.financeRules);
+}
+export function normalizeSelectionState(requestedState, content, surface) {
+    const availableCategories = getAvailableCategories(content);
+    const requestedUnit = getUnitById(content.inventory, requestedState.unitId);
+    const resolvedCategory = availableCategories.includes(requestedState.category)
+        ? requestedState.category
+        : (requestedUnit?.category ?? getDefaultCategory(content));
+    const resolvedUnit = requestedUnit && requestedUnit.category === resolvedCategory
+        ? requestedUnit
+        : null;
+    const resolvedScheme = resolveScheme(content, resolvedUnit, requestedState.scheme, resolvedCategory);
+    const installmentDownPaymentPct = clampInstallmentDownPaymentPct(requestedState.installmentDownPaymentPct ??
+        INSTALLMENT_DEFAULT_DOWN_PAYMENT_PCT);
+    const installmentMonthlyPct = clampInstallmentMonthlyPct(requestedState.installmentMonthlyPct ?? INSTALLMENT_DEFAULT_MONTHLY_PCT, installmentDownPaymentPct);
+    return {
+        category: resolvedCategory,
+        unitId: resolvedUnit?.id ?? "",
+        scheme: resolvedScheme?.id ?? content.financeRules.defaults.schemeId,
+        postDeliveryYears: surface === "default"
+            ? clampToRange(requestedState.postDeliveryYears, content.financeRules.ranges.postDeliveryYears)
+            : content.financeRules.defaults.postDeliveryYears,
+        downPaymentPct: getResolvedDownPaymentPct(surface, requestedState, resolvedScheme, content),
+        installmentDownPaymentPct,
+        installmentMonthlyPct,
+        includeIva: surface === "default" ? requestedState.includeIva : SOCIAL_INCLUDE_IVA,
+    };
+}
+export function createInitialSelectionState(content, surface) {
+    return normalizeSelectionState({
+        category: content.financeRules.defaults.category,
+        unitId: content.financeRules.defaults.unitId,
+        scheme: content.financeRules.defaults.schemeId,
+        postDeliveryYears: content.financeRules.defaults.postDeliveryYears,
+        downPaymentPct: content.financeRules.defaults.downPaymentPct,
+        installmentDownPaymentPct: INSTALLMENT_DEFAULT_DOWN_PAYMENT_PCT,
+        installmentMonthlyPct: INSTALLMENT_DEFAULT_MONTHLY_PCT,
+        includeIva: false,
+    }, content, surface);
+}
+export function reduceSelectionState(state, action, content, surface) {
+    switch (action.type) {
+        case "reset":
+            return action.state;
+        case "selectCategory": {
+            const selectedUnit = getUnitById(content.inventory, state.unitId);
+            const nextUnitId = selectedUnit?.category === action.category ? selectedUnit.id : "";
+            return normalizeSelectionState({
+                ...state,
+                category: action.category,
+                unitId: nextUnitId,
+            }, content, surface);
+        }
+        case "selectUnit": {
+            const selectedUnit = getUnitById(content.inventory, action.unitId);
+            if (!selectedUnit) {
+                return state;
+            }
+            return normalizeSelectionState({
+                ...state,
+                category: selectedUnit.category,
+                unitId: selectedUnit.id,
+            }, content, surface);
+        }
+        case "selectScheme":
+            return normalizeSelectionState({
+                ...state,
+                scheme: action.schemeId,
+            }, content, surface);
+        case "setPostDeliveryYears":
+            return normalizeSelectionState({
+                ...state,
+                postDeliveryYears: action.value,
+            }, content, surface);
+        case "setDownPaymentPct":
+            return normalizeSelectionState({
+                ...state,
+                downPaymentPct: action.value,
+            }, content, surface);
+        case "setInstallmentDownPaymentPct":
+            return normalizeSelectionState({
+                ...state,
+                installmentDownPaymentPct: action.value,
+            }, content, surface);
+        case "setInstallmentMonthlyPct":
+            return normalizeSelectionState({
+                ...state,
+                installmentMonthlyPct: action.value,
+            }, content, surface);
+        case "setIncludeIva":
+            return normalizeSelectionState({
+                ...state,
+                includeIva: action.value,
+            }, content, surface);
+    }
+}

package/dist/server.d.ts

@@ -0,0 +1,16 @@
+import type { CotizadorApiBaseOptions, CreatePublicReservationRequest, CreatePublicSessionRequest, GetPublicReservationRequest } from "./types.js";
+export interface CotizadorServerClientOptions extends CotizadorApiBaseOptions {
+    apiKey: string;
+}
+export declare function createCotizadorServerClient(options: CotizadorServerClientOptions): {
+    createBrowserSession: (args: CreatePublicSessionRequest) => Promise<import("./types.js").PublicSessionResponse>;
+    createReservation: (args: CreatePublicReservationRequest) => Promise<import("./types.js").PublicReservationStatus>;
+    getAgentGuide: () => Promise<Record<string, unknown>>;
+    getInventory: (args: import("./types.js").CotizadorInventoryRequest) => Promise<import("./types.js").PublicInventoryResponse>;
+    getOpenApi: () => Promise<Record<string, unknown>>;
+    getPaymentMethods: (args: import("./types.js").CotizadorSiteRequest) => Promise<import("./types.js").PublicPaymentMethodsResponse>;
+    getReservation: (args: GetPublicReservationRequest) => Promise<import("./types.js").PublicReservationStatus>;
+    getSitemap: (args: import("./types.js").CotizadorSitemapRequest) => Promise<import("./types.js").PublicSitemapResponse>;
+    getSnapshot: (args: import("./types.js").CotizadorSiteRequest) => Promise<import("./types.js").PublicSnapshotResponse>;
+    listInstances: (args: Pick<import("./types.js").CotizadorSiteRequest, "lookup" | "siteKey">) => Promise<import("./types.js").PublicInstancesResponse>;
+};

package/dist/server.js

@@ -0,0 +1,17 @@
+import { createCotizadorApiRequester } from "./http.js";
+export function createCotizadorServerClient(options) {
+    const api = createCotizadorApiRequester(options);
+    const credential = { kind: "apiKey", value: options.apiKey };
+    return {
+        createBrowserSession: (args) => api.createSession(args, credential),
+        createReservation: (args) => api.createReservation(args, credential),
+        getAgentGuide: api.getAgentGuide,
+        getInventory: api.getInventory,
+        getOpenApi: api.getOpenApi,
+        getPaymentMethods: api.getPaymentMethods,
+        getReservation: (args) => api.getReservation(args, credential),
+        getSitemap: api.getSitemap,
+        getSnapshot: api.getSnapshot,
+        listInstances: api.listInstances,
+    };
+}

package/dist/sitemap.d.ts

@@ -0,0 +1,22 @@
+import type { PublicSitemapMap, PublicSitemapResponse, PublicSitemapShape, PublicSitemapUnitHotspot } from "./types.js";
+export type SelectablePublicSitemapUnitHotspot = PublicSitemapUnitHotspot & {
+    unitId: string;
+};
+export declare function getSitemapMapById(sitemap: PublicSitemapResponse, mapId: string): PublicSitemapMap | null;
+export declare function getRootSitemapMap(sitemap: PublicSitemapResponse): PublicSitemapMap | null;
+export declare function resolveInitialSitemapMap(sitemap: PublicSitemapResponse): PublicSitemapMap;
+export declare function getChildSitemapMaps(sitemap: PublicSitemapResponse, parentMapId: string): PublicSitemapMap[];
+export declare function getSelectableUnitHotspots(map: PublicSitemapMap): SelectablePublicSitemapUnitHotspot[];
+export declare function getUnitHotspotByUnitId(map: PublicSitemapMap, unitId: string): SelectablePublicSitemapUnitHotspot | null;
+export declare function getUnitHotspotsByUnitId(map: PublicSitemapMap): Map<string, SelectablePublicSitemapUnitHotspot>;
+export declare function getShapeByElementId(map: PublicSitemapMap, svgElementId: string): PublicSitemapShape | null;
+export declare function getShapesByElementId(map: PublicSitemapMap): Map<string, PublicSitemapShape>;
+export declare function getShapeForUnit(map: PublicSitemapMap, unitId: string): PublicSitemapShape | null;
+export declare function getShapeGeometryValue(shape: PublicSitemapShape | null | undefined, key: string): string | null;
+export declare function getSitemapMapAssetPlan(map: PublicSitemapMap): {
+    imageHeight: number | null;
+    imageUrl: string;
+    imageWidth: number | null;
+    overlayUrl: string;
+    overlayViewBox: string | null;
+};

package/dist/sitemap.js

@@ -0,0 +1,45 @@
+function isSelectableUnitHotspot(hotspot) {
+    return typeof hotspot.unitId === "string" && hotspot.unitId.trim().length > 0;
+}
+export function getSitemapMapById(sitemap, mapId) {
+    return sitemap.maps.find((map) => map.id === mapId) ?? null;
+}
+export function getRootSitemapMap(sitemap) {
+    return sitemap.maps.find((map) => map.kind === "root") ?? null;
+}
+export function resolveInitialSitemapMap(sitemap) {
+    return getRootSitemapMap(sitemap) ?? sitemap.maps[0] ?? null;
+}
+export function getChildSitemapMaps(sitemap, parentMapId) {
+    return sitemap.maps.filter((map) => map.parentMapId === parentMapId);
+}
+export function getSelectableUnitHotspots(map) {
+    return map.unitHotspots.filter(isSelectableUnitHotspot);
+}
+export function getUnitHotspotByUnitId(map, unitId) {
+    return (getSelectableUnitHotspots(map).find((hotspot) => hotspot.unitId === unitId) ?? null);
+}
+export function getUnitHotspotsByUnitId(map) {
+    return new Map(getSelectableUnitHotspots(map).map((hotspot) => [hotspot.unitId, hotspot]));
+}
+export function getShapeByElementId(map, svgElementId) {
+    return (map.shapes.find((shape) => shape.svgElementId === svgElementId) ?? null);
+}
+export function getShapesByElementId(map) {
+    return new Map(map.shapes.map((shape) => [shape.svgElementId, shape]));
+}
+export function getShapeForUnit(map, unitId) {
+    return getUnitHotspotByUnitId(map, unitId)?.shape ?? null;
+}
+export function getShapeGeometryValue(shape, key) {
+    return shape?.geometry[key] ?? null;
+}
+export function getSitemapMapAssetPlan(map) {
+    return {
+        imageHeight: map.assets.imageHeight ?? map.imageHeight,
+        imageUrl: map.assets.imageUrl || map.imageUrl,
+        imageWidth: map.assets.imageWidth ?? map.imageWidth,
+        overlayUrl: map.assets.overlayUrl || map.overlayUrl,
+        overlayViewBox: map.assets.overlayViewBox ?? map.overlayViewBox,
+    };
+}

package/dist/social-quote.d.ts

@@ -0,0 +1,8 @@
+import type { FinanceRules, InventoryUnit, PaymentSchemeDefinition, QuoteInput, QuoteUrlState } from "./types.js";
+export declare const SOCIAL_INCLUDE_IVA = false;
+export declare const UONDR_CASHBACK_MIN_DOWN_PAYMENT_PCT = 60;
+export declare function isSameQuoteState(left: QuoteUrlState, right: QuoteUrlState): boolean;
+export declare function getSocialDefaultDownPaymentPct(scheme: PaymentSchemeDefinition | null, financeRules: FinanceRules): number;
+export declare function getSocialQuoteInput(unit: InventoryUnit, scheme: PaymentSchemeDefinition, financeRules: FinanceRules): QuoteInput;
+export declare function getSocialQuoteInputWithCashbackDownPayment(unit: InventoryUnit, scheme: PaymentSchemeDefinition, financeRules: FinanceRules, downPaymentPct: number): QuoteInput;
+export declare function clampUondrCashbackDownPaymentPct(scheme: PaymentSchemeDefinition | null, downPaymentPct: number): number;

package/dist/social-quote.js

@@ -0,0 +1,51 @@
+import { clampToRange, getDefaultDownPaymentPctForScheme, isCashbackScheme, isInstallmentScheme, } from "./payment-schemes.js";
+import { INSTALLMENT_DEFAULT_DOWN_PAYMENT_PCT, INSTALLMENT_DEFAULT_MONTHLY_PCT, } from "./installment-allocation.js";
+export const SOCIAL_INCLUDE_IVA = false;
+export const UONDR_CASHBACK_MIN_DOWN_PAYMENT_PCT = 60;
+export function isSameQuoteState(left, right) {
+    return (left.category === right.category &&
+        left.unitId === right.unitId &&
+        left.scheme === right.scheme &&
+        left.postDeliveryYears === right.postDeliveryYears &&
+        left.downPaymentPct === right.downPaymentPct &&
+        left.installmentDownPaymentPct === right.installmentDownPaymentPct &&
+        left.installmentMonthlyPct === right.installmentMonthlyPct &&
+        left.includeIva === right.includeIva);
+}
+export function getSocialDefaultDownPaymentPct(scheme, financeRules) {
+    if (scheme && isInstallmentScheme(scheme)) {
+        return scheme.downPaymentPct;
+    }
+    return getDefaultDownPaymentPctForScheme(scheme, financeRules);
+}
+export function getSocialQuoteInput(unit, scheme, financeRules) {
+    return {
+        unitId: unit.id,
+        scheme: scheme.id,
+        plusvaliaAnnualPct: financeRules.defaults.plusvaliaAnnualPct,
+        postDeliveryYears: financeRules.defaults.postDeliveryYears,
+        downPaymentPct: getSocialDefaultDownPaymentPct(scheme, financeRules),
+        installmentDownPaymentPct: INSTALLMENT_DEFAULT_DOWN_PAYMENT_PCT,
+        installmentMonthlyPct: INSTALLMENT_DEFAULT_MONTHLY_PCT,
+        includeIva: SOCIAL_INCLUDE_IVA,
+    };
+}
+export function getSocialQuoteInputWithCashbackDownPayment(unit, scheme, financeRules, downPaymentPct) {
+    const input = getSocialQuoteInput(unit, scheme, financeRules);
+    if (!isCashbackScheme(scheme)) {
+        return input;
+    }
+    return {
+        ...input,
+        downPaymentPct: clampToRange(downPaymentPct, scheme.downPaymentRange),
+    };
+}
+export function clampUondrCashbackDownPaymentPct(scheme, downPaymentPct) {
+    if (!scheme || !isCashbackScheme(scheme)) {
+        return downPaymentPct;
+    }
+    return clampToRange(downPaymentPct, {
+        ...scheme.downPaymentRange,
+        min: Math.max(scheme.downPaymentRange.min, UONDR_CASHBACK_MIN_DOWN_PAYMENT_PCT),
+    });
+}

package/dist/tax.d.ts

@@ -0,0 +1,5 @@
+export declare const IVA_RATE = 0.13;
+export declare const IVA_RATE_PERCENT: number;
+export declare function applyIvaMXN(valueMXN: number): number;
+export declare function applyIvaModeMXN(valueMXN: number, includeIva: boolean): number;
+export declare function getIvaModeLabel(includeIva: boolean): "IVA incluido" | "+ IVA";

package/dist/tax.js

@@ -0,0 +1,11 @@
+export const IVA_RATE = 0.13;
+export const IVA_RATE_PERCENT = IVA_RATE * 100;
+export function applyIvaMXN(valueMXN) {
+    return valueMXN * (1 + IVA_RATE);
+}
+export function applyIvaModeMXN(valueMXN, includeIva) {
+    return includeIva ? applyIvaMXN(valueMXN) : valueMXN;
+}
+export function getIvaModeLabel(includeIva) {
+    return includeIva ? "IVA incluido" : "+ IVA";
+}