partnermax 0.2.0

package/resources/dealers/nlt/offers.d.mts

@@ -0,0 +1,303 @@
+import { APIResource } from "../../../core/resource.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+export declare class Offers extends APIResource {
+    /**
+     * Full offer detail. Payload shape mirrors apimax MCP `get_nlt_offer_details`
+     * bit-for-bit (mcp_server.py:1546-1606).
+     */
+    retrieve(offerID: string, params: OfferRetrieveParams, options?: RequestOptions): APIPromise<OfferRetrieveResponse>;
+    /**
+     * Listing of NLT offers with monthly canon repriced for this dealer.
+     *
+     * Strategy:
+     *
+     * 1. Resolve + ACL the dealer.
+     * 2. Pull at most `limit + 1` offers from the catalog after the cursor. The extra
+     *    row lets us know if there's a next page without a second COUNT(\*) query.
+     * 3. Apply text/enum filters server-side via SQL where possible (brand, segment,
+     *    fuel) and the numeric `canone_max_eur` filter in Python after the pricing
+     *    pass (the DB has no "displayed canon" column; we synthesize it per dealer).
+     * 4. For each surviving offer, price the (duration, km) cells the caller filtered
+     *    to (if specified) or all 18, pick the cheapest cell as the headline.
+     */
+    list(dealerID: string, query?: OfferListParams | null | undefined, options?: RequestOptions): APIPromise<OfferListResponse>;
+}
+/**
+ * Single row in the offers list. Pricing is dealer-aware.
+ *
+ * Field names: American English snake_case. Values: Italian raw, apimax-aligned
+ * (`fuel_type: "Benzina"`, `segment: "SUV piccoli"`). No enum normalization —
+ * apimax labels are surfaced verbatim, exactly as the detail endpoint does, so the
+ * partner client sees the same string in both listing and detail.
+ */
+export interface NltOfferSummary {
+    brand: string;
+    dealer_id: string;
+    duration_months: number;
+    km_per_year_at_quote: number;
+    model: string;
+    monthly_canon_from_eur: number;
+    offer_id: string;
+    slug: string;
+    vat_treatment: 'private' | 'business';
+    canonical_url?: string | null;
+    fuel_type?: string | null;
+    has_promo?: boolean;
+    image_url?: string | null;
+    segment?: string | null;
+    trim?: string | null;
+    vehicle_type?: 'auto' | 'vcom';
+}
+/**
+ * Full offer detail.
+ *
+ * Shape mirrors `_tool_get_nlt_offer_details` (apimax MCP) with all field names
+ * translated to American English snake_case for the partner SDK contract. VALUES
+ * stay Italian raw (apimax-aligned). The dict `technical_details` keeps Italian
+ * KEYS because they are `mnet_dettagli` column names (raw DB).
+ */
+export interface OfferRetrieveResponse {
+    found: boolean;
+    network_dealer_count: number;
+    offer_id: string;
+    slug: string;
+    title: string;
+    vat_included: boolean;
+    /**
+     * Container for optional add-ons (apimax: `addons_disponibili`).
+     */
+    available_addons?: OfferRetrieveResponse.AvailableAddons;
+    brand?: string | null;
+    description_full?: string | null;
+    description_short?: string | null;
+    /**
+     * Three down-payment scenarios in EUR (whole amounts).
+     *
+     * apimax: `anticipo_scenari_eur` (keys remapped to American English snake_case for
+     * partnermax SDK: `zero/medium/standard`).
+     */
+    down_payment_scenarios_eur?: OfferRetrieveResponse.DownPaymentScenariosEur | null;
+    /**
+     * Italian labels paired 1:1 with `NltDownPaymentScenariosEur`.
+     *
+     * apimax: `anticipo_scenari_labels` — used by Custom GPT to render the three
+     * options in conversation. Values stay in Italian raw ("Senza anticipo" /
+     * "Anticipo 12,5%" / "Anticipo 25%").
+     */
+    down_payment_scenarios_labels?: OfferRetrieveResponse.DownPaymentScenariosLabels | null;
+    faqs?: Array<OfferRetrieveResponse.Faq>;
+    fuel_type?: string | null;
+    gallery?: Array<OfferRetrieveResponse.Gallery>;
+    image_url?: string | null;
+    included_accessories?: Array<OfferRetrieveResponse.IncludedAccessory>;
+    included_services?: Array<OfferRetrieveResponse.IncludedService>;
+    last_modified?: string | null;
+    min_monthly_canon_eur?: number | null;
+    model?: string | null;
+    network_offers?: Array<OfferRetrieveResponse.NetworkOffer>;
+    primary_dealer_city?: string | null;
+    primary_dealer_name?: string | null;
+    primary_dealer_province?: string | null;
+    private_only?: boolean | null;
+    quotations?: Array<OfferRetrieveResponse.Quotation>;
+    schema_org?: {
+        [key: string]: unknown;
+    } | null;
+    segment?: string | null;
+    standard_equipment?: Array<string>;
+    tags?: Array<OfferRetrieveResponse.Tag>;
+    technical_details?: {
+        [key: string]: unknown;
+    };
+    total_price_eur?: number | null;
+    transmission?: string | null;
+    trim?: string | null;
+    vehicle_type?: 'auto' | 'vcom';
+}
+export declare namespace OfferRetrieveResponse {
+    /**
+     * Container for optional add-ons (apimax: `addons_disponibili`).
+     */
+    interface AvailableAddons {
+        /**
+         * Replacement-vehicle add-on lookup (apimax:
+         * `addons_disponibili.auto_sostitutiva`).
+         *
+         * Always category B (utilitaria) per founder decision — the spoken "average
+         * customer" segment.
+         */
+        replacement_vehicle?: AvailableAddons.ReplacementVehicle | null;
+        /**
+         * Tyre-replacement add-on lookup (apimax: `addons_disponibili.pneumatici`).
+         *
+         * Populated when `mnet_dettagli.pneumatici_anteriori` matches `R\d+` and a row
+         * exists in `nlt_pneumatici` for that diameter. Null otherwise. Replacement rule
+         * (founder decision 2026-05-12): 1 set of 4 tyres every 30 000 km, rounded up.
+         */
+        tires?: AvailableAddons.Tires | null;
+    }
+    namespace AvailableAddons {
+        /**
+         * Replacement-vehicle add-on lookup (apimax:
+         * `addons_disponibili.auto_sostitutiva`).
+         *
+         * Always category B (utilitaria) per founder decision — the spoken "average
+         * customer" segment.
+         */
+        interface ReplacementVehicle {
+            category_description: string;
+            default_category: string;
+            monthly_cost_eur: number;
+        }
+        /**
+         * Tyre-replacement add-on lookup (apimax: `addons_disponibili.pneumatici`).
+         *
+         * Populated when `mnet_dettagli.pneumatici_anteriori` matches `R\d+` and a row
+         * exists in `nlt_pneumatici` for that diameter. Null otherwise. Replacement rule
+         * (founder decision 2026-05-12): 1 set of 4 tyres every 30 000 km, rounded up.
+         */
+        interface Tires {
+            diameter_in: number;
+            replacement_rule: string;
+            set_cost_eur: number;
+        }
+    }
+    /**
+     * Three down-payment scenarios in EUR (whole amounts).
+     *
+     * apimax: `anticipo_scenari_eur` (keys remapped to American English snake_case for
+     * partnermax SDK: `zero/medium/standard`).
+     */
+    interface DownPaymentScenariosEur {
+        medium: number;
+        standard: number;
+        zero: number;
+    }
+    /**
+     * Italian labels paired 1:1 with `NltDownPaymentScenariosEur`.
+     *
+     * apimax: `anticipo_scenari_labels` — used by Custom GPT to render the three
+     * options in conversation. Values stay in Italian raw ("Senza anticipo" /
+     * "Anticipo 12,5%" / "Anticipo 25%").
+     */
+    interface DownPaymentScenariosLabels {
+        medium: string;
+        standard: string;
+        zero: string;
+    }
+    /**
+     * One Italian Q&A entry derived per-offer.
+     *
+     * apimax: `build_offer_faqs` in `seo_engine/nlt_faq_builder.py` — generates up to
+     * ~11 Q&A pairs (dimensions, fuel, transmission, CO2, monthly canon at preset
+     * combo, available durations, VAT inclusion, down-payment tiers, etc.). Partnermax
+     * surfaces them all, 1:1.
+     */
+    interface Faq {
+        answer: string;
+        question: string;
+    }
+    /**
+     * One image in the offer gallery (apimax: `gallery[]`).
+     */
+    interface Gallery {
+        is_cover: boolean;
+        url: string;
+    }
+    /**
+     * One accessory bundled with the offer (apimax: `accessori_inclusi[]`).
+     */
+    interface IncludedAccessory {
+        code: string;
+        description: string;
+        extra_price_eur: number;
+    }
+    /**
+     * One NLT service normally included in the canone.
+     *
+     * apimax: `_get_services_included` (`nlt_resolver.py:719`). Source is the global
+     * `nlt_services` table (active rows only). Same set of services across the network
+     * (Assicurazione RCA / Kasco / Incendio-Furto, Manutenzione, Assistenza Stradale,
+     * Bollo, Pneumatici, Veicolo in anticipo, Vettura sostitutiva). Not per-offer.
+     */
+    interface IncludedService {
+        name: string;
+        description?: string | null;
+    }
+    /**
+     * One network dealer's quote for this offer (apimax: `network_offers[]`).
+     *
+     * Sorted by `min_monthly_canon_eur ASC`. In partnermax this list is scoped to
+     * dealers owned by the calling partner (`utenti.parent_id = partner.user_id`) —
+     * same shape as the apimax cross-network list, partner-scoped to avoid data
+     * leakage.
+     */
+    interface NetworkOffer {
+        dealer_id: number;
+        dealer_name: string;
+        min_monthly_canon_eur: number;
+        city?: string | null;
+        contact_url?: string | null;
+        google_maps_url?: string | null;
+        phone?: string | null;
+        province?: string | null;
+        rating_value?: number | null;
+        review_count?: number | null;
+    }
+    /**
+     * One priced cell of the 18-combination matrix.
+     *
+     * apimax: `quotazioni[]` entry — `_compute_quotazioni_dealer_aware`
+     * (mcp_server.py:180). Reflects the dealer's vetrina formula applied to each
+     * (durata, km) combo; cells with implausible canon (<€50) are dropped upstream, so
+     * the list may contain fewer than 18 rows.
+     */
+    interface Quotation {
+        duration_months: number;
+        km_per_year: number;
+        monthly_canon_eur: number;
+    }
+    /**
+     * Category tag for an offer (apimax: `tags[]`).
+     *
+     * Populated from `nlt_offerta_tag` ⋈ `nlt_offerte_tag`. Examples in production:
+     * "Promo", "Stock pronto", "GreenChoice".
+     */
+    interface Tag {
+        name: string;
+        color?: string | null;
+        icon?: string | null;
+    }
+}
+/**
+ * Cursor-paginated list of offer summaries.
+ */
+export interface OfferListResponse {
+    data: Array<NltOfferSummary>;
+    has_more: boolean;
+    next_cursor?: string | null;
+}
+export interface OfferRetrieveParams {
+    dealer_id: string;
+}
+export interface OfferListParams {
+    brand?: string | null;
+    canone_max_eur?: number | null;
+    cursor?: string | null;
+    duration_months?: number | null;
+    fuel_type?: string | null;
+    km_per_year?: number | null;
+    limit?: number;
+    segment?: string | null;
+    /**
+     * Macro discriminator: 'auto' (passenger vehicles) or 'vcom' (light commercial ≤35
+     * q.li: vans, panel trucks, multispace, pickups, minibuses). Omit to return the
+     * mixed catalog.
+     */
+    vehicle_type?: string | null;
+}
+export declare namespace Offers {
+    export { type NltOfferSummary as NltOfferSummary, type OfferRetrieveResponse as OfferRetrieveResponse, type OfferListResponse as OfferListResponse, type OfferRetrieveParams as OfferRetrieveParams, type OfferListParams as OfferListParams, };
+}
+//# sourceMappingURL=offers.d.mts.map

package/resources/dealers/nlt/offers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offers.d.mts","sourceRoot":"","sources":["../../../src/resources/dealers/nlt/offers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,mCAA+B;AACrD,OAAO,EAAE,UAAU,EAAE,sCAAkC;AACvD,OAAO,EAAE,cAAc,EAAE,8CAA0C;AAGnE,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;OAGG;IACH,QAAQ,CACN,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qBAAqB,CAAC;IAKpC;;;;;;;;;;;;;OAaG;IACH,IAAI,CACF,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,eAAe,GAAG,IAAI,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,iBAAiB,CAAC;CAGjC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IAEd,SAAS,EAAE,MAAM,CAAC;IAElB,eAAe,EAAE,MAAM,CAAC;IAExB,oBAAoB,EAAE,MAAM,CAAC;IAE7B,KAAK,EAAE,MAAM,CAAC;IAEd,sBAAsB,EAAE,MAAM,CAAC;IAE/B,QAAQ,EAAE,MAAM,CAAC;IAEjB,IAAI,EAAE,MAAM,CAAC;IAEb,aAAa,EAAE,SAAS,GAAG,UAAU,CAAC;IAEtC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,CAAC;IAEf,oBAAoB,EAAE,MAAM,CAAC;IAE7B,QAAQ,EAAE,MAAM,CAAC;IAEjB,IAAI,EAAE,MAAM,CAAC;IAEb,KAAK,EAAE,MAAM,CAAC;IAEd,YAAY,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,gBAAgB,CAAC,EAAE,qBAAqB,CAAC,eAAe,CAAC;IAEzD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC;;;;;OAKG;IACH,0BAA0B,CAAC,EAAE,qBAAqB,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAElF;;;;;;OAMG;IACH,6BAA6B,CAAC,EAAE,qBAAqB,CAAC,0BAA0B,GAAG,IAAI,CAAC;IAExF,IAAI,CAAC,EAAE,KAAK,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAExC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,OAAO,CAAC,EAAE,KAAK,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAE/C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,oBAAoB,CAAC,EAAE,KAAK,CAAC,qBAAqB,CAAC,iBAAiB,CAAC,CAAC;IAEtE,iBAAiB,CAAC,EAAE,KAAK,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC;IAEjE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB,cAAc,CAAC,EAAE,KAAK,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAC;IAE3D,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExC,YAAY,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAE9B,UAAU,CAAC,EAAE,KAAK,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAEpD,UAAU,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAE/C,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,kBAAkB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEnC,IAAI,CAAC,EAAE,KAAK,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAExC,iBAAiB,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAE/C,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAED,yBAAiB,qBAAqB,CAAC;IACrC;;OAEG;IACH,UAAiB,eAAe;QAC9B;;;;;;WAMG;QACH,mBAAmB,CAAC,EAAE,eAAe,CAAC,kBAAkB,GAAG,IAAI,CAAC;QAEhE;;;;;;WAMG;QACH,KAAK,CAAC,EAAE,eAAe,CAAC,KAAK,GAAG,IAAI,CAAC;KACtC;IAED,UAAiB,eAAe,CAAC;QAC/B;;;;;;WAMG;QACH,UAAiB,kBAAkB;YACjC,oBAAoB,EAAE,MAAM,CAAC;YAE7B,gBAAgB,EAAE,MAAM,CAAC;YAEzB,gBAAgB,EAAE,MAAM,CAAC;SAC1B;QAED;;;;;;WAMG;QACH,UAAiB,KAAK;YACpB,WAAW,EAAE,MAAM,CAAC;YAEpB,gBAAgB,EAAE,MAAM,CAAC;YAEzB,YAAY,EAAE,MAAM,CAAC;SACtB;KACF;IAED;;;;;OAKG;IACH,UAAiB,uBAAuB;QACtC,MAAM,EAAE,MAAM,CAAC;QAEf,QAAQ,EAAE,MAAM,CAAC;QAEjB,IAAI,EAAE,MAAM,CAAC;KACd;IAED;;;;;;OAMG;IACH,UAAiB,0BAA0B;QACzC,MAAM,EAAE,MAAM,CAAC;QAEf,QAAQ,EAAE,MAAM,CAAC;QAEjB,IAAI,EAAE,MAAM,CAAC;KACd;IAED;;;;;;;OAOG;IACH,UAAiB,GAAG;QAClB,MAAM,EAAE,MAAM,CAAC;QAEf,QAAQ,EAAE,MAAM,CAAC;KAClB;IAED;;OAEG;IACH,UAAiB,OAAO;QACtB,QAAQ,EAAE,OAAO,CAAC;QAElB,GAAG,EAAE,MAAM,CAAC;KACb;IAED;;OAEG;IACH,UAAiB,iBAAiB;QAChC,IAAI,EAAE,MAAM,CAAC;QAEb,WAAW,EAAE,MAAM,CAAC;QAEpB,eAAe,EAAE,MAAM,CAAC;KACzB;IAED;;;;;;;OAOG;IACH,UAAiB,eAAe;QAC9B,IAAI,EAAE,MAAM,CAAC;QAEb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B;IAED;;;;;;;OAOG;IACH,UAAiB,YAAY;QAC3B,SAAS,EAAE,MAAM,CAAC;QAElB,WAAW,EAAE,MAAM,CAAC;QAEpB,qBAAqB,EAAE,MAAM,CAAC;QAE9B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAErB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE5B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEhC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEzB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B;IAED;;;;;;;OAOG;IACH,UAAiB,SAAS;QACxB,eAAe,EAAE,MAAM,CAAC;QAExB,WAAW,EAAE,MAAM,CAAC;QAEpB,iBAAiB,EAAE,MAAM,CAAC;KAC3B;IAED;;;;;OAKG;IACH,UAAiB,GAAG;QAClB,IAAI,EAAE,MAAM,CAAC;QAEb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEtB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACtB;CACF;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;IAE7B,QAAQ,EAAE,OAAO,CAAC;IAElB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;CACH"}

package/resources/dealers/nlt/offers.d.ts

@@ -0,0 +1,303 @@
+import { APIResource } from "../../../core/resource.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+export declare class Offers extends APIResource {
+    /**
+     * Full offer detail. Payload shape mirrors apimax MCP `get_nlt_offer_details`
+     * bit-for-bit (mcp_server.py:1546-1606).
+     */
+    retrieve(offerID: string, params: OfferRetrieveParams, options?: RequestOptions): APIPromise<OfferRetrieveResponse>;
+    /**
+     * Listing of NLT offers with monthly canon repriced for this dealer.
+     *
+     * Strategy:
+     *
+     * 1. Resolve + ACL the dealer.
+     * 2. Pull at most `limit + 1` offers from the catalog after the cursor. The extra
+     *    row lets us know if there's a next page without a second COUNT(\*) query.
+     * 3. Apply text/enum filters server-side via SQL where possible (brand, segment,
+     *    fuel) and the numeric `canone_max_eur` filter in Python after the pricing
+     *    pass (the DB has no "displayed canon" column; we synthesize it per dealer).
+     * 4. For each surviving offer, price the (duration, km) cells the caller filtered
+     *    to (if specified) or all 18, pick the cheapest cell as the headline.
+     */
+    list(dealerID: string, query?: OfferListParams | null | undefined, options?: RequestOptions): APIPromise<OfferListResponse>;
+}
+/**
+ * Single row in the offers list. Pricing is dealer-aware.
+ *
+ * Field names: American English snake_case. Values: Italian raw, apimax-aligned
+ * (`fuel_type: "Benzina"`, `segment: "SUV piccoli"`). No enum normalization —
+ * apimax labels are surfaced verbatim, exactly as the detail endpoint does, so the
+ * partner client sees the same string in both listing and detail.
+ */
+export interface NltOfferSummary {
+    brand: string;
+    dealer_id: string;
+    duration_months: number;
+    km_per_year_at_quote: number;
+    model: string;
+    monthly_canon_from_eur: number;
+    offer_id: string;
+    slug: string;
+    vat_treatment: 'private' | 'business';
+    canonical_url?: string | null;
+    fuel_type?: string | null;
+    has_promo?: boolean;
+    image_url?: string | null;
+    segment?: string | null;
+    trim?: string | null;
+    vehicle_type?: 'auto' | 'vcom';
+}
+/**
+ * Full offer detail.
+ *
+ * Shape mirrors `_tool_get_nlt_offer_details` (apimax MCP) with all field names
+ * translated to American English snake_case for the partner SDK contract. VALUES
+ * stay Italian raw (apimax-aligned). The dict `technical_details` keeps Italian
+ * KEYS because they are `mnet_dettagli` column names (raw DB).
+ */
+export interface OfferRetrieveResponse {
+    found: boolean;
+    network_dealer_count: number;
+    offer_id: string;
+    slug: string;
+    title: string;
+    vat_included: boolean;
+    /**
+     * Container for optional add-ons (apimax: `addons_disponibili`).
+     */
+    available_addons?: OfferRetrieveResponse.AvailableAddons;
+    brand?: string | null;
+    description_full?: string | null;
+    description_short?: string | null;
+    /**
+     * Three down-payment scenarios in EUR (whole amounts).
+     *
+     * apimax: `anticipo_scenari_eur` (keys remapped to American English snake_case for
+     * partnermax SDK: `zero/medium/standard`).
+     */
+    down_payment_scenarios_eur?: OfferRetrieveResponse.DownPaymentScenariosEur | null;
+    /**
+     * Italian labels paired 1:1 with `NltDownPaymentScenariosEur`.
+     *
+     * apimax: `anticipo_scenari_labels` — used by Custom GPT to render the three
+     * options in conversation. Values stay in Italian raw ("Senza anticipo" /
+     * "Anticipo 12,5%" / "Anticipo 25%").
+     */
+    down_payment_scenarios_labels?: OfferRetrieveResponse.DownPaymentScenariosLabels | null;
+    faqs?: Array<OfferRetrieveResponse.Faq>;
+    fuel_type?: string | null;
+    gallery?: Array<OfferRetrieveResponse.Gallery>;
+    image_url?: string | null;
+    included_accessories?: Array<OfferRetrieveResponse.IncludedAccessory>;
+    included_services?: Array<OfferRetrieveResponse.IncludedService>;
+    last_modified?: string | null;
+    min_monthly_canon_eur?: number | null;
+    model?: string | null;
+    network_offers?: Array<OfferRetrieveResponse.NetworkOffer>;
+    primary_dealer_city?: string | null;
+    primary_dealer_name?: string | null;
+    primary_dealer_province?: string | null;
+    private_only?: boolean | null;
+    quotations?: Array<OfferRetrieveResponse.Quotation>;
+    schema_org?: {
+        [key: string]: unknown;
+    } | null;
+    segment?: string | null;
+    standard_equipment?: Array<string>;
+    tags?: Array<OfferRetrieveResponse.Tag>;
+    technical_details?: {
+        [key: string]: unknown;
+    };
+    total_price_eur?: number | null;
+    transmission?: string | null;
+    trim?: string | null;
+    vehicle_type?: 'auto' | 'vcom';
+}
+export declare namespace OfferRetrieveResponse {
+    /**
+     * Container for optional add-ons (apimax: `addons_disponibili`).
+     */
+    interface AvailableAddons {
+        /**
+         * Replacement-vehicle add-on lookup (apimax:
+         * `addons_disponibili.auto_sostitutiva`).
+         *
+         * Always category B (utilitaria) per founder decision — the spoken "average
+         * customer" segment.
+         */
+        replacement_vehicle?: AvailableAddons.ReplacementVehicle | null;
+        /**
+         * Tyre-replacement add-on lookup (apimax: `addons_disponibili.pneumatici`).
+         *
+         * Populated when `mnet_dettagli.pneumatici_anteriori` matches `R\d+` and a row
+         * exists in `nlt_pneumatici` for that diameter. Null otherwise. Replacement rule
+         * (founder decision 2026-05-12): 1 set of 4 tyres every 30 000 km, rounded up.
+         */
+        tires?: AvailableAddons.Tires | null;
+    }
+    namespace AvailableAddons {
+        /**
+         * Replacement-vehicle add-on lookup (apimax:
+         * `addons_disponibili.auto_sostitutiva`).
+         *
+         * Always category B (utilitaria) per founder decision — the spoken "average
+         * customer" segment.
+         */
+        interface ReplacementVehicle {
+            category_description: string;
+            default_category: string;
+            monthly_cost_eur: number;
+        }
+        /**
+         * Tyre-replacement add-on lookup (apimax: `addons_disponibili.pneumatici`).
+         *
+         * Populated when `mnet_dettagli.pneumatici_anteriori` matches `R\d+` and a row
+         * exists in `nlt_pneumatici` for that diameter. Null otherwise. Replacement rule
+         * (founder decision 2026-05-12): 1 set of 4 tyres every 30 000 km, rounded up.
+         */
+        interface Tires {
+            diameter_in: number;
+            replacement_rule: string;
+            set_cost_eur: number;
+        }
+    }
+    /**
+     * Three down-payment scenarios in EUR (whole amounts).
+     *
+     * apimax: `anticipo_scenari_eur` (keys remapped to American English snake_case for
+     * partnermax SDK: `zero/medium/standard`).
+     */
+    interface DownPaymentScenariosEur {
+        medium: number;
+        standard: number;
+        zero: number;
+    }
+    /**
+     * Italian labels paired 1:1 with `NltDownPaymentScenariosEur`.
+     *
+     * apimax: `anticipo_scenari_labels` — used by Custom GPT to render the three
+     * options in conversation. Values stay in Italian raw ("Senza anticipo" /
+     * "Anticipo 12,5%" / "Anticipo 25%").
+     */
+    interface DownPaymentScenariosLabels {
+        medium: string;
+        standard: string;
+        zero: string;
+    }
+    /**
+     * One Italian Q&A entry derived per-offer.
+     *
+     * apimax: `build_offer_faqs` in `seo_engine/nlt_faq_builder.py` — generates up to
+     * ~11 Q&A pairs (dimensions, fuel, transmission, CO2, monthly canon at preset
+     * combo, available durations, VAT inclusion, down-payment tiers, etc.). Partnermax
+     * surfaces them all, 1:1.
+     */
+    interface Faq {
+        answer: string;
+        question: string;
+    }
+    /**
+     * One image in the offer gallery (apimax: `gallery[]`).
+     */
+    interface Gallery {
+        is_cover: boolean;
+        url: string;
+    }
+    /**
+     * One accessory bundled with the offer (apimax: `accessori_inclusi[]`).
+     */
+    interface IncludedAccessory {
+        code: string;
+        description: string;
+        extra_price_eur: number;
+    }
+    /**
+     * One NLT service normally included in the canone.
+     *
+     * apimax: `_get_services_included` (`nlt_resolver.py:719`). Source is the global
+     * `nlt_services` table (active rows only). Same set of services across the network
+     * (Assicurazione RCA / Kasco / Incendio-Furto, Manutenzione, Assistenza Stradale,
+     * Bollo, Pneumatici, Veicolo in anticipo, Vettura sostitutiva). Not per-offer.
+     */
+    interface IncludedService {
+        name: string;
+        description?: string | null;
+    }
+    /**
+     * One network dealer's quote for this offer (apimax: `network_offers[]`).
+     *
+     * Sorted by `min_monthly_canon_eur ASC`. In partnermax this list is scoped to
+     * dealers owned by the calling partner (`utenti.parent_id = partner.user_id`) —
+     * same shape as the apimax cross-network list, partner-scoped to avoid data
+     * leakage.
+     */
+    interface NetworkOffer {
+        dealer_id: number;
+        dealer_name: string;
+        min_monthly_canon_eur: number;
+        city?: string | null;
+        contact_url?: string | null;
+        google_maps_url?: string | null;
+        phone?: string | null;
+        province?: string | null;
+        rating_value?: number | null;
+        review_count?: number | null;
+    }
+    /**
+     * One priced cell of the 18-combination matrix.
+     *
+     * apimax: `quotazioni[]` entry — `_compute_quotazioni_dealer_aware`
+     * (mcp_server.py:180). Reflects the dealer's vetrina formula applied to each
+     * (durata, km) combo; cells with implausible canon (<€50) are dropped upstream, so
+     * the list may contain fewer than 18 rows.
+     */
+    interface Quotation {
+        duration_months: number;
+        km_per_year: number;
+        monthly_canon_eur: number;
+    }
+    /**
+     * Category tag for an offer (apimax: `tags[]`).
+     *
+     * Populated from `nlt_offerta_tag` ⋈ `nlt_offerte_tag`. Examples in production:
+     * "Promo", "Stock pronto", "GreenChoice".
+     */
+    interface Tag {
+        name: string;
+        color?: string | null;
+        icon?: string | null;
+    }
+}
+/**
+ * Cursor-paginated list of offer summaries.
+ */
+export interface OfferListResponse {
+    data: Array<NltOfferSummary>;
+    has_more: boolean;
+    next_cursor?: string | null;
+}
+export interface OfferRetrieveParams {
+    dealer_id: string;
+}
+export interface OfferListParams {
+    brand?: string | null;
+    canone_max_eur?: number | null;
+    cursor?: string | null;
+    duration_months?: number | null;
+    fuel_type?: string | null;
+    km_per_year?: number | null;
+    limit?: number;
+    segment?: string | null;
+    /**
+     * Macro discriminator: 'auto' (passenger vehicles) or 'vcom' (light commercial ≤35
+     * q.li: vans, panel trucks, multispace, pickups, minibuses). Omit to return the
+     * mixed catalog.
+     */
+    vehicle_type?: string | null;
+}
+export declare namespace Offers {
+    export { type NltOfferSummary as NltOfferSummary, type OfferRetrieveResponse as OfferRetrieveResponse, type OfferListResponse as OfferListResponse, type OfferRetrieveParams as OfferRetrieveParams, type OfferListParams as OfferListParams, };
+}
+//# sourceMappingURL=offers.d.ts.map

package/resources/dealers/nlt/offers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offers.d.ts","sourceRoot":"","sources":["../../../src/resources/dealers/nlt/offers.ts"],"names":[],"mappings":"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"}

package/resources/dealers/nlt/offers.js

@@ -0,0 +1,35 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Offers = void 0;
+const resource_1 = require("../../../core/resource.js");
+const path_1 = require("../../../internal/utils/path.js");
+class Offers extends resource_1.APIResource {
+    /**
+     * Full offer detail. Payload shape mirrors apimax MCP `get_nlt_offer_details`
+     * bit-for-bit (mcp_server.py:1546-1606).
+     */
+    retrieve(offerID, params, options) {
+        const { dealer_id } = params;
+        return this._client.get((0, path_1.path) `/v1/dealers/${dealer_id}/nlt/offers/${offerID}`, options);
+    }
+    /**
+     * Listing of NLT offers with monthly canon repriced for this dealer.
+     *
+     * Strategy:
+     *
+     * 1. Resolve + ACL the dealer.
+     * 2. Pull at most `limit + 1` offers from the catalog after the cursor. The extra
+     *    row lets us know if there's a next page without a second COUNT(\*) query.
+     * 3. Apply text/enum filters server-side via SQL where possible (brand, segment,
+     *    fuel) and the numeric `canone_max_eur` filter in Python after the pricing
+     *    pass (the DB has no "displayed canon" column; we synthesize it per dealer).
+     * 4. For each surviving offer, price the (duration, km) cells the caller filtered
+     *    to (if specified) or all 18, pick the cheapest cell as the headline.
+     */
+    list(dealerID, query = {}, options) {
+        return this._client.get((0, path_1.path) `/v1/dealers/${dealerID}/nlt/offers`, { query, ...options });
+    }
+}
+exports.Offers = Offers;
+//# sourceMappingURL=offers.js.map

package/resources/dealers/nlt/offers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offers.js","sourceRoot":"","sources":["../../../src/resources/dealers/nlt/offers.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAGrD,0DAAoD;AAEpD,MAAa,MAAO,SAAQ,sBAAW;IACrC;;;OAGG;IACH,QAAQ,CACN,OAAe,EACf,MAA2B,EAC3B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,eAAe,SAAS,eAAe,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,IAAI,CACF,QAAgB,EAChB,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,eAAe,QAAQ,aAAa,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;CACF;AAnCD,wBAmCC"}