@grupolapa/desarrollos-sdk 0.1.0 → 0.3.1

package/dist/query-state.js

@@ -1,6 +1,7 @@
-import { clampToRange, getDefaultDownPaymentPctForScheme, getResolvedSchemeForUnit, isInstallmentScheme, } from "./payment-schemes.js";
+import { clampToRange, getDefaultDownPaymentPctForScheme, getResolvedSchemeForUnit, isUondrBundleFlexiblePlanEligible, getUondrResolvedSchemeForUnit, isUondrFlexiblePaymentScheme, isUondrLocalCategory, isInstallmentScheme, } from "./payment-schemes.js";
 import { clampUondrCashbackDownPaymentPct } from "./social-quote.js";
 import { clampInstallmentDownPaymentPct, clampInstallmentMonthlyPct, INSTALLMENT_DEFAULT_DOWN_PAYMENT_PCT, INSTALLMENT_DEFAULT_MONTHLY_PCT, } from "./installment-allocation.js";
+import { CASHBACK_PAYMENT_OPTION_DIRECT, UONDR_CASHBACK_DIRECT_DOWN_PAYMENT_PCT, normalizeCashbackPaymentOptionId, } from "./cashback-payment-options.js";
 function parseNumberParam(value, fallback) {
     if (value === null) {
         return fallback;
@@ -65,6 +66,21 @@ function pickNumericParam(...values) {
 function isCategory(value) {
     return typeof value === "string" && value.trim().length > 0;
 }
+function parseUnitIdsParam(value, units) {
+    if (!value) {
+        return [];
+    }
+    const knownUnitsById = new Map(units.map((unit) => [unit.id, unit]));
+    const parsedUnits = [];
+    for (const rawUnitId of value.split(",")) {
+        const unitId = rawUnitId.trim();
+        const unit = knownUnitsById.get(unitId);
+        if (unit && !parsedUnits.some((item) => item.id === unit.id)) {
+            parsedUnits.push(unit);
+        }
+    }
+    return parsedUnits;
+}
 export function normalizeQuoteUrlState(search, units, rules, paymentSchemes) {
     const requestedUnitId = pickStringParam(search.unitId, search.unit);
     const requestedCategoryParam = getStringParam(search.category);
@@ -94,6 +110,7 @@ export function normalizeQuoteUrlState(search, units, rules, paymentSchemes) {
             paymentSchemes.find((scheme) => scheme.active) ??
             null);
     const defaultDownPaymentPct = getDefaultDownPaymentPctForScheme(resolvedScheme, rules);
+    const cashbackPaymentOption = normalizeCashbackPaymentOptionId(pickStringParam(search.cashbackPaymentOption, search.cashbackPlan, search.cashbackOption));
     return {
         category: resolvedCategory,
         unitId: selectedUnit?.id ?? "",
@@ -102,6 +119,7 @@ export function normalizeQuoteUrlState(search, units, rules, paymentSchemes) {
         downPaymentPct: resolvedScheme?.type === "cashback"
             ? clampToRange(parseNumberParam(pickNumericParam(search.downPaymentPct, search.enganche), defaultDownPaymentPct), resolvedScheme.downPaymentRange)
             : defaultDownPaymentPct,
+        cashbackPaymentOption,
         installmentDownPaymentPct: (() => {
             const value = clampInstallmentDownPaymentPct(parseNumberParam(pickNumericParam(search.installmentDownPaymentPct, search.iEng), INSTALLMENT_DEFAULT_DOWN_PAYMENT_PCT));
             return value;
@@ -125,19 +143,35 @@ export function normalizeSocialQuoteUrlState(search, units, rules, paymentScheme
         downPaymentPct: resolvedScheme && isInstallmentScheme(resolvedScheme)
             ? resolvedScheme.downPaymentPct
             : getDefaultDownPaymentPctForScheme(resolvedScheme, rules),
+        cashbackPaymentOption: CASHBACK_PAYMENT_OPTION_DIRECT,
         includeIva: false,
     };
 }
-export function normalizeUondrQuoteUrlState(search, units, rules, paymentSchemes) {
+export function normalizeUondrQuoteUrlState(search, units, rules, paymentSchemes, siteCategories = []) {
     const state = normalizeQuoteUrlState(search, units, rules, paymentSchemes);
     const selectedUnit = units.find((unit) => unit.id === state.unitId) ?? null;
+    const bundleUnits = parseUnitIdsParam(getStringParam(search.units), units);
+    const includeLocalFlexiblePlan = (parseBooleanParam(search.bundle, false) || bundleUnits.length > 0) &&
+        isUondrBundleFlexiblePlanEligible(bundleUnits, siteCategories);
+    const isLocalCategory = isUondrLocalCategory(state.category, siteCategories);
+    const isAllowedUondrScheme = (scheme) => scheme.active &&
+        (!isLocalCategory ||
+            includeLocalFlexiblePlan ||
+            !isUondrFlexiblePaymentScheme(scheme));
     const resolvedScheme = selectedUnit
-        ? getResolvedSchemeForUnit(selectedUnit, paymentSchemes, state.scheme)
-        : (paymentSchemes.find((scheme) => scheme.id === state.scheme && scheme.active) ?? null);
+        ? getUondrResolvedSchemeForUnit(selectedUnit, paymentSchemes, state.scheme, siteCategories, { includeLocalFlexiblePlan })
+        : (paymentSchemes.find((scheme) => scheme.id === state.scheme && isAllowedUondrScheme(scheme)) ??
+            paymentSchemes.find((scheme) => scheme.id === rules.defaults.schemeId && isAllowedUondrScheme(scheme)) ??
+            paymentSchemes.find(isAllowedUondrScheme) ??
+            null);
     return {
         ...state,
+        scheme: resolvedScheme?.id ?? state.scheme,
         postDeliveryYears: rules.defaults.postDeliveryYears,
-        downPaymentPct: clampUondrCashbackDownPaymentPct(resolvedScheme, state.downPaymentPct),
+        downPaymentPct: resolvedScheme?.type === "cashback"
+            ? clampUondrCashbackDownPaymentPct(resolvedScheme, parseNumberParam(pickNumericParam(search.downPaymentPct, search.enganche), UONDR_CASHBACK_DIRECT_DOWN_PAYMENT_PCT))
+            : state.downPaymentPct,
+        cashbackPaymentOption: normalizeCashbackPaymentOptionId(state.cashbackPaymentOption),
         includeIva: false,
     };
 }
@@ -150,6 +184,7 @@ export function buildQuoteSearch(state) {
     params.set("scheme", state.scheme);
     params.set("years", String(state.postDeliveryYears));
     params.set("enganche", String(state.downPaymentPct));
+    params.set("cashbackPlan", normalizeCashbackPaymentOptionId(state.cashbackPaymentOption));
     params.set("iEng", String(state.installmentDownPaymentPct));
     params.set("iMens", String(state.installmentMonthlyPct));
     params.set("iva", state.includeIva ? "1" : "0");

package/dist/quote.d.ts

@@ -1,5 +1,6 @@
 export * from "./bundle-payment-schedule.calc.js";
 export * from "./calculate-quote.js";
+export * from "./cashback-payment-options.js";
 export * from "./corporate-actions.js";
 export * from "./corporate-rent.js";
 export * from "./delivery-date.js";

package/dist/quote.js

@@ -1,5 +1,6 @@
 export * from "./bundle-payment-schedule.calc.js";
 export * from "./calculate-quote.js";
+export * from "./cashback-payment-options.js";
 export * from "./corporate-actions.js";
 export * from "./corporate-rent.js";
 export * from "./delivery-date.js";

package/dist/selection-state.d.ts

@@ -1,4 +1,7 @@
-import type { AppContent, InventoryCategory, QuoteUrlState } from "./types.js";
+import type { AppContent, CashbackPaymentOptionId, InventoryCategory, QuoteUrlState } from "./types.js";
+export type CotizadorSelectionOptions = {
+    includeLocalFlexiblePlan?: boolean;
+};
 export type CotizadorSurface = "default" | "social" | "uondr" | "a-uondr" | "ud" | "entrada";
 export type CotizadorSelectionState = QuoteUrlState;
 export type CotizadorSelectionAction = {
@@ -7,28 +10,40 @@ export type CotizadorSelectionAction = {
 } | {
     type: "selectCategory";
     category: InventoryCategory;
+    options?: CotizadorSelectionOptions;
 } | {
     type: "selectUnit";
     unitId: string;
+    options?: CotizadorSelectionOptions;
 } | {
     type: "selectScheme";
     schemeId: string;
+    options?: CotizadorSelectionOptions;
 } | {
     type: "setPostDeliveryYears";
     value: number;
+    options?: CotizadorSelectionOptions;
 } | {
     type: "setDownPaymentPct";
     value: number;
+    options?: CotizadorSelectionOptions;
+} | {
+    type: "setCashbackPaymentOption";
+    value: CashbackPaymentOptionId;
+    options?: CotizadorSelectionOptions;
 } | {
     type: "setInstallmentDownPaymentPct";
     value: number;
+    options?: CotizadorSelectionOptions;
 } | {
     type: "setInstallmentMonthlyPct";
     value: number;
+    options?: CotizadorSelectionOptions;
 } | {
     type: "setIncludeIva";
     value: boolean;
+    options?: CotizadorSelectionOptions;
 };
-export declare function normalizeSelectionState(requestedState: CotizadorSelectionState, content: AppContent, surface: CotizadorSurface): CotizadorSelectionState;
+export declare function normalizeSelectionState(requestedState: CotizadorSelectionState, content: AppContent, surface: CotizadorSurface, options?: CotizadorSelectionOptions): CotizadorSelectionState;
 export declare function createInitialSelectionState(content: AppContent, surface: CotizadorSurface): QuoteUrlState;
 export declare function reduceSelectionState(state: CotizadorSelectionState, action: CotizadorSelectionAction, content: AppContent, surface: CotizadorSurface): QuoteUrlState;

package/dist/selection-state.js

@@ -1,5 +1,6 @@
-import { clampToRange, getDefaultDownPaymentPctForScheme, getPaymentSchemeById, getResolvedSchemeForUnit, } from "./payment-schemes.js";
+import { clampToRange, getDefaultDownPaymentPctForScheme, getPaymentSchemeById, getResolvedSchemeForUnit, getUondrResolvedSchemeForUnit, isUondrFlexiblePaymentScheme, isUondrLocalCategory, } from "./payment-schemes.js";
 import { clampUondrCashbackDownPaymentPct, getSocialDefaultDownPaymentPct, SOCIAL_INCLUDE_IVA, } from "./social-quote.js";
+import { CASHBACK_PAYMENT_OPTION_DIRECT, UONDR_CASHBACK_DIRECT_DOWN_PAYMENT_PCT, normalizeCashbackPaymentOptionId, } from "./cashback-payment-options.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;
@@ -30,22 +31,39 @@ function getDefaultUnitForCategory(units, defaultUnitId, category) {
         units.find((unit) => unit.category === category) ??
         null);
 }
-function getFallbackScheme(content, requestedSchemeId, category) {
+function getFallbackScheme(content, requestedSchemeId, category, surface, options) {
     const defaultUnitForCategory = getDefaultUnitForCategory(content.inventory, content.financeRules.defaults.unitId, category);
     if (defaultUnitForCategory) {
+        if (surface === "uondr" || surface === "a-uondr") {
+            return getUondrResolvedSchemeForUnit(defaultUnitForCategory, content.paymentSchemes, requestedSchemeId, content.siteContent.categories, {
+                includeLocalFlexiblePlan: options.includeLocalFlexiblePlan,
+            });
+        }
         return getResolvedSchemeForUnit(defaultUnitForCategory, content.paymentSchemes, requestedSchemeId);
     }
+    const disallowUondrFlexibleScheme = (surface === "uondr" || surface === "a-uondr") &&
+        isUondrLocalCategory(category, content.siteContent.categories) &&
+        !options.includeLocalFlexiblePlan;
     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) ??
+    const isAllowedFallbackScheme = (scheme) => scheme.active &&
+        (!disallowUondrFlexibleScheme || !isUondrFlexiblePaymentScheme(scheme));
+    return (content.paymentSchemes.find((scheme) => scheme.id === requestedSchemeId && isAllowedFallbackScheme(scheme)) ??
+        (defaultScheme && isAllowedFallbackScheme(defaultScheme)
+            ? defaultScheme
+            : null) ??
+        content.paymentSchemes.find(isAllowedFallbackScheme) ??
         null);
 }
-function resolveScheme(content, unit, requestedSchemeId, category) {
+function resolveScheme(content, unit, requestedSchemeId, category, surface, options) {
     if (unit) {
+        if (surface === "uondr" || surface === "a-uondr") {
+            return getUondrResolvedSchemeForUnit(unit, content.paymentSchemes, requestedSchemeId, content.siteContent.categories, {
+                includeLocalFlexiblePlan: options.includeLocalFlexiblePlan,
+            });
+        }
         return getResolvedSchemeForUnit(unit, content.paymentSchemes, requestedSchemeId);
     }
-    return getFallbackScheme(content, requestedSchemeId, category);
+    return getFallbackScheme(content, requestedSchemeId, category, surface, options);
 }
 function getResolvedDownPaymentPct(surface, requestedState, scheme, content) {
     if (scheme?.type === "cashback" &&
@@ -60,7 +78,7 @@ function getResolvedDownPaymentPct(surface, requestedState, scheme, content) {
     }
     return getDefaultDownPaymentPctForScheme(scheme, content.financeRules);
 }
-export function normalizeSelectionState(requestedState, content, surface) {
+export function normalizeSelectionState(requestedState, content, surface, options = {}) {
     const availableCategories = getAvailableCategories(content);
     const requestedUnit = getUnitById(content.inventory, requestedState.unitId);
     const resolvedCategory = availableCategories.includes(requestedState.category)
@@ -69,7 +87,7 @@ export function normalizeSelectionState(requestedState, content, surface) {
     const resolvedUnit = requestedUnit && requestedUnit.category === resolvedCategory
         ? requestedUnit
         : null;
-    const resolvedScheme = resolveScheme(content, resolvedUnit, requestedState.scheme, resolvedCategory);
+    const resolvedScheme = resolveScheme(content, resolvedUnit, requestedState.scheme, resolvedCategory, surface, options);
     const installmentDownPaymentPct = clampInstallmentDownPaymentPct(requestedState.installmentDownPaymentPct ??
         INSTALLMENT_DEFAULT_DOWN_PAYMENT_PCT);
     const installmentMonthlyPct = clampInstallmentMonthlyPct(requestedState.installmentMonthlyPct ?? INSTALLMENT_DEFAULT_MONTHLY_PCT, installmentDownPaymentPct);
@@ -81,6 +99,9 @@ export function normalizeSelectionState(requestedState, content, surface) {
             ? clampToRange(requestedState.postDeliveryYears, content.financeRules.ranges.postDeliveryYears)
             : content.financeRules.defaults.postDeliveryYears,
         downPaymentPct: getResolvedDownPaymentPct(surface, requestedState, resolvedScheme, content),
+        cashbackPaymentOption: resolvedScheme?.type === "cashback"
+            ? normalizeCashbackPaymentOptionId(requestedState.cashbackPaymentOption)
+            : CASHBACK_PAYMENT_OPTION_DIRECT,
         installmentDownPaymentPct,
         installmentMonthlyPct,
         includeIva: surface === "default" ? requestedState.includeIva : SOCIAL_INCLUDE_IVA,
@@ -92,7 +113,10 @@ export function createInitialSelectionState(content, surface) {
         unitId: content.financeRules.defaults.unitId,
         scheme: content.financeRules.defaults.schemeId,
         postDeliveryYears: content.financeRules.defaults.postDeliveryYears,
-        downPaymentPct: content.financeRules.defaults.downPaymentPct,
+        downPaymentPct: surface === "uondr" || surface === "a-uondr"
+            ? UONDR_CASHBACK_DIRECT_DOWN_PAYMENT_PCT
+            : content.financeRules.defaults.downPaymentPct,
+        cashbackPaymentOption: CASHBACK_PAYMENT_OPTION_DIRECT,
         installmentDownPaymentPct: INSTALLMENT_DEFAULT_DOWN_PAYMENT_PCT,
         installmentMonthlyPct: INSTALLMENT_DEFAULT_MONTHLY_PCT,
         includeIva: false,
@@ -109,7 +133,7 @@ export function reduceSelectionState(state, action, content, surface) {
                 ...state,
                 category: action.category,
                 unitId: nextUnitId,
-            }, content, surface);
+            }, content, surface, action.options);
         }
         case "selectUnit": {
             const selectedUnit = getUnitById(content.inventory, action.unitId);
@@ -120,37 +144,42 @@ export function reduceSelectionState(state, action, content, surface) {
                 ...state,
                 category: selectedUnit.category,
                 unitId: selectedUnit.id,
-            }, content, surface);
+            }, content, surface, action.options);
         }
         case "selectScheme":
             return normalizeSelectionState({
                 ...state,
                 scheme: action.schemeId,
-            }, content, surface);
+            }, content, surface, action.options);
         case "setPostDeliveryYears":
             return normalizeSelectionState({
                 ...state,
                 postDeliveryYears: action.value,
-            }, content, surface);
+            }, content, surface, action.options);
         case "setDownPaymentPct":
             return normalizeSelectionState({
                 ...state,
                 downPaymentPct: action.value,
-            }, content, surface);
+            }, content, surface, action.options);
+        case "setCashbackPaymentOption":
+            return normalizeSelectionState({
+                ...state,
+                cashbackPaymentOption: action.value,
+            }, content, surface, action.options);
         case "setInstallmentDownPaymentPct":
             return normalizeSelectionState({
                 ...state,
                 installmentDownPaymentPct: action.value,
-            }, content, surface);
+            }, content, surface, action.options);
         case "setInstallmentMonthlyPct":
             return normalizeSelectionState({
                 ...state,
                 installmentMonthlyPct: action.value,
-            }, content, surface);
+            }, content, surface, action.options);
         case "setIncludeIva":
             return normalizeSelectionState({
                 ...state,
                 includeIva: action.value,
-            }, content, surface);
+            }, content, surface, action.options);
     }
 }

package/dist/social-quote.d.ts

@@ -1,8 +1,8 @@
-import type { FinanceRules, InventoryUnit, PaymentSchemeDefinition, QuoteInput, QuoteUrlState } from "./types.js";
+import type { CashbackPaymentOptionId, 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 getSocialQuoteInputWithCashbackPaymentOption(unit: InventoryUnit, scheme: PaymentSchemeDefinition, financeRules: FinanceRules, optionId: CashbackPaymentOptionId | undefined, downPaymentPct?: number): QuoteInput;
 export declare function clampUondrCashbackDownPaymentPct(scheme: PaymentSchemeDefinition | null, downPaymentPct: number): number;

package/dist/social-quote.js

@@ -1,13 +1,15 @@
 import { clampToRange, getDefaultDownPaymentPctForScheme, isCashbackScheme, isInstallmentScheme, } from "./payment-schemes.js";
 import { INSTALLMENT_DEFAULT_DOWN_PAYMENT_PCT, INSTALLMENT_DEFAULT_MONTHLY_PCT, } from "./installment-allocation.js";
+import { CASHBACK_PAYMENT_OPTION_DIRECT, getUondrCashbackDirectDownPaymentRange, getUondrCashbackOptionDownPaymentPct, normalizeCashbackPaymentOptionId, } from "./cashback-payment-options.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 &&
+        normalizeCashbackPaymentOptionId(left.cashbackPaymentOption) ===
+            normalizeCashbackPaymentOptionId(right.cashbackPaymentOption) &&
         left.installmentDownPaymentPct === right.installmentDownPaymentPct &&
         left.installmentMonthlyPct === right.installmentMonthlyPct &&
         left.includeIva === right.includeIva);
@@ -25,6 +27,7 @@ export function getSocialQuoteInput(unit, scheme, financeRules) {
         plusvaliaAnnualPct: financeRules.defaults.plusvaliaAnnualPct,
         postDeliveryYears: financeRules.defaults.postDeliveryYears,
         downPaymentPct: getSocialDefaultDownPaymentPct(scheme, financeRules),
+        cashbackPaymentOption: CASHBACK_PAYMENT_OPTION_DIRECT,
         installmentDownPaymentPct: INSTALLMENT_DEFAULT_DOWN_PAYMENT_PCT,
         installmentMonthlyPct: INSTALLMENT_DEFAULT_MONTHLY_PCT,
         includeIva: SOCIAL_INCLUDE_IVA,
@@ -40,12 +43,24 @@ export function getSocialQuoteInputWithCashbackDownPayment(unit, scheme, finance
         downPaymentPct: clampToRange(downPaymentPct, scheme.downPaymentRange),
     };
 }
+export function getSocialQuoteInputWithCashbackPaymentOption(unit, scheme, financeRules, optionId, downPaymentPct) {
+    const input = getSocialQuoteInput(unit, scheme, financeRules);
+    if (!isCashbackScheme(scheme)) {
+        return input;
+    }
+    const cashbackPaymentOption = normalizeCashbackPaymentOptionId(optionId);
+    return {
+        ...input,
+        cashbackPaymentOption,
+        downPaymentPct: getUondrCashbackOptionDownPaymentPct(scheme, cashbackPaymentOption, downPaymentPct),
+    };
+}
+// The stored enganche always tracks the direct-option range, even while the
+// staged option is selected (staged math fixes its own 30%), so the slider
+// value survives toggling between options and URL round-trips.
 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),
-    });
+    return clampToRange(downPaymentPct, getUondrCashbackDirectDownPaymentRange(scheme));
 }

package/dist/types.d.ts

@@ -1,4 +1,5 @@
 export type PaymentSchemeType = "cashback" | "installment";
+export type CashbackPaymentOptionId = "direct" | "staged";
 export type PaymentProvider = "mercado_pago" | "stripe";
 export type InventoryStatus = "available" | "reserved" | "sold" | "unavailable";
 export type InventoryStatusLabels = {
@@ -147,6 +148,7 @@ export interface SiteContent {
     heroEyebrow: string;
     heroTitle: string;
     heroDescription: string;
+    salesWhatsappPhone?: string;
     splash: SplashScreenContent;
     favicon?: UploadedImageAsset;
     uondrHeaderIcon?: UploadedImageAsset;
@@ -195,6 +197,7 @@ export interface QuoteInput {
     plusvaliaAnnualPct: number;
     postDeliveryYears: number;
     downPaymentPct: number;
+    cashbackPaymentOption?: CashbackPaymentOptionId;
     installmentDownPaymentPct?: number;
     installmentMonthlyPct?: number;
     includeIva: boolean;
@@ -279,6 +282,7 @@ export interface QuoteUrlState {
     scheme: string;
     postDeliveryYears: number;
     downPaymentPct: number;
+    cashbackPaymentOption?: CashbackPaymentOptionId;
     installmentDownPaymentPct?: number;
     installmentMonthlyPct?: number;
     includeIva: boolean;
@@ -417,6 +421,146 @@ export interface PublicSessionResponse {
     token: string;
     tokenType: "Bearer";
 }
+export type JourneyErrorCode = "origin_denied" | "mapping_not_found" | "configuration_required" | "configuration_invalid" | "quote_expired" | "unit_unavailable" | "hold_conflict" | "payment_conflict" | "rate_limited" | "session_expired";
+export type JourneyStatus = "active" | "payment_pending" | "operation_pending" | "completed" | "paid_conflict" | "expired";
+export type JourneyConfigurationStatus = "required" | "completed" | "invalid" | "superseded";
+export type JourneyQuoteStatus = "active" | "expired" | "superseded" | "consumed";
+export type JourneyHoldStatus = "acquiring" | "active" | "confirmed" | "released" | "expired" | "conflict";
+export type JourneyCheckoutStatus = "not_started" | "pending" | "requires_action" | "paid" | "failed";
+export type JourneyOperationStatus = "not_started" | "pending" | "draft_created";
+export interface JourneyApiErrorBody extends DesarrollosApiErrorBody {
+    code: JourneyErrorCode;
+}
+export interface PublicJourneySelection {
+    selectedAt: string;
+    unit: InventoryUnit;
+}
+export interface PublicJourneyConfiguration {
+    completedAt: string | null;
+    configurationId: string | null;
+    hash: string | null;
+    revision: number | null;
+    status: JourneyConfigurationStatus;
+}
+export interface PublicJourneyQuote {
+    bookingAmountMXN: number;
+    configurationAdjustmentMXN: 0;
+    createdAt: string;
+    currency: "MXN";
+    expiresAt: string;
+    id: string;
+    revision: number;
+    status: JourneyQuoteStatus;
+    totalPriceMXN: number;
+    unitPriceMXN: number;
+}
+export interface PublicJourneyHold {
+    expiresAt: string | null;
+    id: string;
+    status: JourneyHoldStatus;
+    unitId: string;
+    updatedAt: string;
+}
+export interface PublicJourneyCheckout {
+    checkoutUrl: string | null;
+    externalReference: string | null;
+    provider: PaymentProvider;
+    providerStatus: string | null;
+    status: JourneyCheckoutStatus;
+    updatedAt: string;
+}
+export interface PublicJourneyConflict {
+    code: "payment_conflict";
+    createdAt: string;
+    id: string;
+    status: "open" | "resolved";
+}
+export interface PublicJourneyOperation {
+    id: string | null;
+    status: JourneyOperationStatus;
+    updatedAt: string | null;
+}
+export interface PublicJourneyStatus {
+    checkout: PublicJourneyCheckout | null;
+    configuration: PublicJourneyConfiguration;
+    conflict: PublicJourneyConflict | null;
+    createdAt: string;
+    expiresAt: string;
+    hold: PublicJourneyHold | null;
+    id: string;
+    leadStatus: "required" | "completed";
+    operation: PublicJourneyOperation;
+    quote: PublicJourneyQuote | null;
+    selection: PublicJourneySelection | null;
+    status: JourneyStatus;
+    updatedAt: string;
+}
+export interface CreateJourneyResponse {
+    eligibleUnitIds: string[];
+    journey: PublicJourneyStatus;
+    journeyToken: string;
+    tokenType: "Bearer";
+    turnstileSiteKey: string;
+}
+export interface CreateJourneyRequest {
+    integrationKey: string;
+    journeyToken?: string;
+}
+export interface JourneyRequest {
+    journeyId: string;
+    journeyToken: string;
+}
+export type GetJourneyRequest = JourneyRequest;
+export type GetJourneyResponse = PublicJourneyStatus;
+export interface UpdateJourneySelectionRequest extends JourneyRequest {
+    selection: {
+        unitId: string;
+    };
+}
+export interface PublicJourneyConfiguratorSession {
+    allowedDesignIds: string[];
+    embedUrl: string;
+    expiresAt: string;
+    protocolVersion: "1.0";
+    restoreConfiguration: {
+        configurationId: string;
+        hash: string;
+        revision: number;
+    } | null;
+    sessionId: string;
+}
+export interface CreateJourneyConfiguratorSessionResponse {
+    journey: PublicJourneyStatus;
+    session: PublicJourneyConfiguratorSession;
+}
+export type CreateJourneyConfiguratorSessionRequest = JourneyRequest;
+export interface CompleteJourneyConfigurationRequest extends JourneyRequest {
+    configuration: {
+        configurationId: string;
+        hash: string;
+        revision: number;
+    };
+}
+export interface UpdateJourneyLeadRequest extends JourneyRequest {
+    lead: {
+        email: string;
+        name: string;
+        phone: string;
+    };
+}
+export interface CreateJourneyCheckoutRequest extends JourneyRequest {
+    checkout: {
+        idempotencyKey: string;
+        payment: PublicReservationPaymentRequest;
+        turnstileToken: string;
+    };
+}
+export type UpdateJourneySelectionResponse = PublicJourneyStatus;
+export type CompleteJourneyConfigurationResponse = PublicJourneyStatus;
+export type CreateJourneyQuoteRequest = JourneyRequest;
+export type CreateJourneyQuoteResponse = PublicJourneyStatus;
+export type UpdateJourneyLeadResponse = PublicJourneyStatus;
+export type CreateJourneyCheckoutResponse = PublicJourneyStatus;
 export interface PublicReservationItemRequest {
     productKind?: ReservationProductKind;
     productLabel?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grupolapa/desarrollos-sdk",
-  "version": "0.1.0",
+  "version": "0.3.1",
   "description": "Framework-agnostic TypeScript SDK for Grupo LAPA public desarrollo integrations.",
   "type": "module",
   "license": "UNLICENSED",
@@ -23,6 +23,11 @@
       "import": "./dist/server.js",
       "default": "./dist/server.js"
     },
+    "./embed": {
+      "types": "./dist/embed-protocol.d.ts",
+      "import": "./dist/embed-protocol.js",
+      "default": "./dist/embed-protocol.js"
+    },
     "./quote": {
       "types": "./dist/quote.d.ts",
       "import": "./dist/quote.js",
@@ -45,7 +50,7 @@
   },
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.build.json && node scripts/add-js-extensions.mjs",
-    "prepack": "pnpm run build",
+    "test": "node --import tsx --test \"src/**/*.test.ts\"",
     "typecheck": "tsc --noEmit"
   }
-}
+}