@wayke-se/components-react 5.2.0-beta.0 → 6.0.0-beta.0

package/dist/types/src/@types/filter.d.ts

@@ -1,5 +1,11 @@
-export type SearchFilterNameTypes = 'manufacturer' | 'modelSeries' | 'fuelType' | 'gearboxType' | 'branch' | 'color' | 'environmentClass' | 'properties.segment' | 'drivingWheel' | 'price' | 'mileage' | 'odometerValueAsKm' | 'modelYear' | 'leasingPrice' | 'businessLeasingPrice';
+/** The filters the panel can show, named as their URL keys (see Gql/searchParams.ts). */
+export type SearchFilterNameTypes = 'manufacturer' | 'model' | 'modelSeries' | 'fuelType' | 'gearboxType' | 'branchDisplayName' | 'branchCity' | 'colorName' | 'environmentClass' | 'segment' | 'bodyStyle' | 'trimLevel' | 'inventoryStatus' | 'drivetrainType' | 'engineBaseType' | 'price' | 'odometer' | 'modelYear' | 'privateLease' | 'businessLease';
 export type SearchFilterTypes = {
     filterName: SearchFilterNameTypes;
     displayName?: string;
 };
+/** Filter names from before 6.0 → their name now. */
+export declare const LEGACY_FILTER_NAMES: Record<string, SearchFilterNameTypes>;
+export declare const DEFAULT_FILTER_LIST: SearchFilterTypes[];
+/** The filter list with old names translated and duplicates (mileage + odometerValueAsKm) dropped. */
+export declare const resolveFilterList: (filterList?: SearchFilterTypes[]) => SearchFilterTypes[];

package/dist/types/src/Gql/ad/legacyWaykeId.d.ts

@@ -0,0 +1 @@
+export declare const legacyWaykeIdFromIterationId: (iterationId: string | null | undefined, fallback: string) => string;

package/dist/types/src/Gql/ad/propertyTree.d.ts

@@ -0,0 +1,5 @@
+import { TFunction } from 'i18next';
+import { Tree } from '../../@types/vehicle-properties';
+import { Ad } from './types';
+declare const propertyTree: (ad: Ad, t: TFunction) => Tree;
+export default propertyTree;

package/dist/types/src/Gql/ad/queries.d.ts

@@ -0,0 +1,9 @@
+export declare const AD_QUERY = "\nquery Ad($id: ID!) {\n  ads {\n    byAdId(ID: $id) {\n      id\n      branchId\n      createdAt\n      salesDescription { title enriched }\n      packaging {\n        isDemoVersion\n        certifiedPreOwned\n        selectedPackaging { id title description imageUrl ctaUrl ctaName }\n      }\n      channels {\n        __typename\n        ... on PlatformChannel {\n          status\n          inventoryStatus\n          publishedAt\n          soldAt\n          deliveryTime { __typename ... on DeliveryDate { date } ... on DeliveryInterval { from to unit } }\n        }\n      }\n      pricing {\n        primaryPriceType\n        cash { price { amount } oldPrice { amount } deductibleVat }\n        leasing { issuer leasingMonthlyPayment { amount } contractMonthsRemaining contractKilometersRemaining }\n        companyLeasing { issuer leasingMonthlyPayment { amount } contractMonthsRemaining contractKilometersRemaining }\n      }\n      leasingPromos { id title description image periodMonths mileagePerYear isBusinessLeasing link { url name } }\n      media(limit: 60) {\n        totalCount\n        items {\n          __typename\n          ... on AdImage { id url sortOrder mediaType formats { format url } }\n          ... on Ad360ImageGroup { id sortOrder images { id url } }\n          ... on AdEmbeddedVideo { id externalUrl sortOrder }\n        }\n      }\n      equipment { items { name } }\n      accessories {\n        id name price salePrice assemblyPrice shortDescription longDescription logoUrl\n        productPageLink productPageLinkText articleNumber manufacturer model\n        media { url sortOrder }\n      }\n      warrantyInfo { content { __typename ... on AdSpecificText { text } ... on StandardText { text } ... on StructuredWarranty { text } } }\n      offerings {\n        warranties {\n          included\n          text\n          definition { id name description logoUrl externalUrl usps }\n        }\n      }\n      exchangePolicy { enabled }\n      contactOption {\n        __typename\n        ... on Branch { id displayName }\n        ... on AdDefaultContactOptions { displayName telephone email title }\n        ... on AssignedUser { displayName telephone email title }\n      }\n      branch {\n        id displayName description street zip city latitude longitude homePage logo market\n        contactInformation { telephone email }\n        adDefaultContactOptions { displayName telephone email title avatarUrl }\n        weekOpeningHours { openingHours { dayOfWeek openFrom openTo } }\n        isAutomotiveAssociationVerified\n        promos { id title description image link { url name } }\n      }\n      authorizedResellerForManufacturer\n      iteration {\n        id\n        displayName\n        item {\n          __typename\n          ... on Vehicle {\n            displayName\n            registrationNumber { stringValue }\n            vin { formattedValue }\n            manufacturer { stringValue }\n            modelSeries { stringValue }\n            modelName { stringValue }\n            modelYear { intValue }\n            manufactureYear { intValue }\n            salesName { stringValue }\n            driveline { fuelTypesString { stringValue } }\n            attributes {\n              transmission { formattedValue }\n              enginePower { intValue formattedValue }\n              byCategory {\n                categoryId displayName\n                values { __typename key label formattedValue }\n                categories { categoryId displayName values { __typename key label formattedValue } }\n              }\n            }\n          }\n        }\n        logistics { odometerReading { value unit } }\n        commerce {\n          enabled disabledOnWayke allowTradeIn homeDelivery reserved\n          insuranceProvider {\n            institute identifier logo title description longDescription url\n            insuranceHeader ecomInsuranceText requiresPersonalNumber requiresDistance\n          }\n          paymentDetailsList {\n            financialOptionId name description financialInstitution monthlyCost interest effectiveInterest\n            setupFee administrationFee totalCreditCost totalResidualValue loanAmount imageUrl link linkText\n            duration { min max step default current }\n            downPayment { min max step default current }\n            residual { min max step default current }\n          }\n        }\n        documents { public { id name contentType uri category sortOrder } }\n      }\n    }\n  }\n}\n";
+/**
+ * Older ads carry a legacy id that differs from ad.id. ads.byIterationId accepts a
+ * bare GUID and resolves it to the ad, with the same visibility rules as byAdId.
+ */
+export declare const AD_ID_BY_LEGACY_ID_QUERY = "\nquery AdIdByLegacyId($id: ID!) {\n  ads { byIterationId(iterationId: $id) { ads { id } } }\n}\n";
+export declare const CALCULATE_PAYMENT_QUERY = "\nquery CalculatePayment($id: ID!, $config: PaymentDetailsInput!) {\n  ads {\n    byAdId(ID: $id) {\n      iteration {\n        commerce {\n          calculatePayment(config: $config) {\n            financialOptionId monthlyCost interest effectiveInterest setupFee administrationFee\n            totalCreditCost totalResidualValue loanAmount\n            duration { min max step default current }\n            downPayment { min max step default current }\n            residual { min max step default current }\n          }\n        }\n      }\n    }\n  }\n}\n";
+export declare const INSURANCE_INQUIRY_QUERY = "\nquery InsuranceInquiry($id: ID!, $socialId: String!, $drivingDistance: DrivingDistance!) {\n  ads {\n    byAdId(ID: $id) {\n      iteration {\n        commerce {\n          insuranceInquiry(socialId: $socialId, drivingDistance: $drivingDistance) {\n            insurances {\n              name price unit description branding legalUrl legalDescription\n              details { institute logo terms }\n              insuranceItems { name description }\n              addons { id title price description exclude }\n            }\n          }\n        }\n      }\n    }\n  }\n}\n";
+export declare const RELATED_ADS_QUERY = "\nquery RelatedAds($market: [String], $branchGroupId: String, $manufacturer: [String], $perPage: Int) {\n  search {\n    ads(market: $market, branchGroupId: $branchGroupId, manufacturer: $manufacturer, perPage: $perPage, soldWithinDays: 0, sort: { field: publishedAt, direction: desc }) {\n      found\n      hits { \n  ad {\n    id\n    salesDescription { title }\n    pricing {\n      cash { price { amount } oldPrice { amount } deductibleVat }\n      leasing { leasingMonthlyPayment { amount } }\n      companyLeasing { leasingMonthlyPayment { amount } }\n    }\n    media(limit: 1) { items { ... on AdImage { id url formats { format url } } } }\n    branch { id displayName }\n    channels { ... on PlatformChannel { status soldAt } }\n  }\n  iteration {\n    logistics { odometerReading { value unit } }\n    item {\n      ... on Vehicle {\n        displayName\n        manufacturer { stringValue }\n        modelSeries { stringValue }\n        modelYear { intValue }\n        registrationNumber { stringValue }\n        driveline { fuelTypesString { stringValue } }\n        attributes { transmission { formattedValue } }\n      }\n    }\n  }\n }\n    }\n  }\n}\n";

package/dist/types/src/Gql/ad/types.d.ts

@@ -0,0 +1,378 @@
+interface Money {
+    amount: string;
+}
+export interface AdTextContent {
+    content: {
+        __typename: string;
+        text?: string | null;
+    }[] | null;
+}
+export interface AdWarranty {
+    included: boolean;
+    text: string;
+    definition: {
+        id: string;
+        name: string;
+        description: string | null;
+        logoUrl: string | null;
+        externalUrl: string | null;
+        usps: string[];
+    };
+}
+export interface PaymentRange {
+    min: string | number;
+    max: string | number;
+    step: string | number;
+    default: string | number;
+    current: string | number;
+}
+export interface PaymentResponse {
+    financialOptionId: string;
+    name?: string | null;
+    description?: string | null;
+    financialInstitution?: string;
+    monthlyCost: string | number;
+    interest: string | number;
+    effectiveInterest: string | number;
+    setupFee: string | number;
+    administrationFee: string | number;
+    totalCreditCost: string | number;
+    totalResidualValue: string | number;
+    loanAmount: string | number;
+    imageUrl?: string | null;
+    link?: string | null;
+    linkText?: string | null;
+    duration: PaymentRange;
+    downPayment: PaymentRange;
+    residual: PaymentRange | null;
+}
+export interface InsuranceProvider {
+    institute: string;
+    identifier: string;
+    logo: string | null;
+    title: string;
+    description: string;
+    longDescription: string;
+    url: string;
+    insuranceHeader: string | null;
+    ecomInsuranceText: string | null;
+    requiresPersonalNumber: boolean;
+    requiresDistance: boolean;
+}
+export interface AdMediaItem {
+    __typename: 'AdImage' | 'Ad360ImageGroup' | 'AdEmbeddedVideo';
+    id: string;
+    sortOrder: number;
+    url?: string;
+    /** SPHERE for a panorama image */
+    mediaType?: string | null;
+    formats?: {
+        format: string;
+        url: string;
+    }[];
+    images?: {
+        id: string;
+        url: string;
+    }[];
+    externalUrl?: string;
+}
+export interface AttributeValue {
+    __typename?: string;
+    key: string;
+    label: string;
+    formattedValue: string;
+}
+export interface AttributeCategory {
+    categoryId: string;
+    displayName: string;
+    values: AttributeValue[];
+    categories?: AttributeCategory[];
+}
+export interface AdDocument {
+    id: string;
+    name: string;
+    contentType: string;
+    uri: string;
+    category: string | null;
+    sortOrder: number | null;
+}
+export interface Ad {
+    id: string;
+    branchId: string;
+    createdAt: string;
+    salesDescription: {
+        title: string;
+        enriched: string;
+    } | null;
+    packaging: {
+        isDemoVersion: boolean;
+        certifiedPreOwned: boolean;
+        selectedPackaging: {
+            id: string;
+            title: string;
+            description: string;
+            imageUrl: string;
+            ctaUrl: string;
+            ctaName: string;
+        }[];
+    };
+    channels: {
+        __typename: string;
+        status?: string;
+        inventoryStatus?: string;
+        publishedAt?: string | null;
+        soldAt?: string | null;
+        deliveryTime?: {
+            __typename: string;
+            date?: string;
+            from?: string;
+            to?: string;
+            unit?: string;
+        } | null;
+    }[];
+    pricing: {
+        primaryPriceType: string | null;
+        cash: {
+            price: Money;
+            oldPrice: Money | null;
+            deductibleVat: boolean;
+        } | null;
+        leasing: LeasingPrice | null;
+        companyLeasing: LeasingPrice | null;
+    } | null;
+    leasingPromos: {
+        id: string;
+        title: string | null;
+        description: string | null;
+        image: string | null;
+        periodMonths: number;
+        mileagePerYear: number;
+        isBusinessLeasing: boolean;
+        link: {
+            url: string;
+            name: string;
+        } | null;
+    }[];
+    media: {
+        totalCount: number;
+        items: AdMediaItem[];
+    };
+    equipment: {
+        items: {
+            name: string;
+        }[];
+    } | null;
+    accessories: {
+        id: string;
+        name: string;
+        price: number | null;
+        salePrice: number | null;
+        assemblyPrice: number | null;
+        shortDescription: string;
+        longDescription: string;
+        logoUrl: string;
+        productPageLink: string | null;
+        productPageLinkText: string | null;
+        articleNumber: string;
+        manufacturer: string | null;
+        model: string | null;
+        media: {
+            url: string;
+            sortOrder: number;
+        }[];
+    }[];
+    warrantyInfo: AdTextContent;
+    offerings: {
+        warranties: AdWarranty[];
+    };
+    exchangePolicy: {
+        enabled: boolean;
+    };
+    contactOption: {
+        __typename: 'Branch' | 'AdDefaultContactOptions' | 'AssignedUser' | string;
+        id?: string;
+        displayName?: string | null;
+        telephone?: string | null;
+        email?: string | null;
+        title?: string | null;
+    };
+    branch: {
+        id: string;
+        displayName: string | null;
+        description: string | null;
+        street: string | null;
+        zip: string | null;
+        city: string | null;
+        latitude: number | null;
+        longitude: number | null;
+        homePage: string | null;
+        logo: string | null;
+        market: string;
+        contactInformation: {
+            telephone: string | null;
+            email: string | null;
+        } | null;
+        adDefaultContactOptions: {
+            displayName: string | null;
+            telephone: string | null;
+            email: string | null;
+            title: string | null;
+            avatarUrl: string | null;
+        } | null;
+        weekOpeningHours: {
+            openingHours: ({
+                dayOfWeek: string;
+                openFrom: string | null;
+                openTo: string | null;
+            } | null)[] | null;
+        } | null;
+        isAutomotiveAssociationVerified: boolean | null;
+        promos: {
+            id: string;
+            title: string | null;
+            description: string | null;
+            image: string | null;
+            link: {
+                url: string;
+                name: string;
+            } | null;
+        }[];
+    };
+    authorizedResellerForManufacturer: boolean;
+    iteration: {
+        id: string;
+        displayName: string;
+        item: {
+            __typename: string;
+            displayName?: string;
+            registrationNumber?: {
+                stringValue: string;
+            } | null;
+            vin?: {
+                formattedValue: string;
+            } | null;
+            manufacturer?: {
+                stringValue: string;
+            } | null;
+            modelSeries?: {
+                stringValue: string;
+            } | null;
+            modelName?: {
+                stringValue: string;
+            } | null;
+            modelYear?: {
+                intValue: number;
+            } | null;
+            manufactureYear?: {
+                intValue: number;
+            } | null;
+            salesName?: {
+                stringValue: string;
+            } | null;
+            driveline?: {
+                fuelTypesString: {
+                    stringValue: string;
+                } | null;
+            } | null;
+            attributes?: {
+                transmission: {
+                    formattedValue: string;
+                } | null;
+                enginePower: {
+                    intValue: number;
+                    formattedValue: string;
+                } | null;
+                byCategory: AttributeCategory[];
+            } | null;
+        } | null;
+        logistics: {
+            odometerReading: {
+                value: number;
+                unit: 'KILOMETER' | 'SCANDINAVIAN_MILE';
+            } | null;
+        } | null;
+        commerce: {
+            enabled: boolean;
+            disabledOnWayke: boolean;
+            allowTradeIn: boolean;
+            homeDelivery: boolean;
+            reserved: boolean;
+            insuranceProvider: InsuranceProvider | null;
+            paymentDetailsList: PaymentResponse[];
+        };
+        documents: {
+            public: AdDocument[] | null;
+        };
+    } | null;
+}
+export interface LeasingPrice {
+    issuer: string;
+    leasingMonthlyPayment: Money | null;
+    contractMonthsRemaining: number | null;
+    contractKilometersRemaining: number | null;
+}
+export interface AdData {
+    ads: {
+        byAdId: Ad | null;
+    } | null;
+}
+export interface AdIdByLegacyIdData {
+    ads: {
+        byIterationId: {
+            ads: {
+                id: string;
+            }[] | null;
+        } | null;
+    } | null;
+}
+export interface CalculatePaymentData {
+    ads: {
+        byAdId: {
+            iteration: {
+                commerce: {
+                    calculatePayment: PaymentResponse | null;
+                };
+            } | null;
+        } | null;
+    } | null;
+}
+export interface InsuranceInquiryInsurance {
+    name: string;
+    price: number;
+    unit: string;
+    description: string;
+    branding: string;
+    legalUrl: string;
+    legalDescription: string;
+    details: {
+        institute: string;
+        logo: string | null;
+        terms: string | null;
+    };
+    insuranceItems: {
+        name: string;
+        description: string;
+    }[];
+    addons: {
+        id: string;
+        title: string;
+        price: number;
+        description: string;
+        exclude: string[];
+    }[] | null;
+}
+export interface InsuranceInquiryData {
+    ads: {
+        byAdId: {
+            iteration: {
+                commerce: {
+                    insuranceInquiry: {
+                        insurances: (InsuranceInquiryInsurance | null)[] | null;
+                    };
+                };
+            } | null;
+        } | null;
+    } | null;
+}
+export type AdAccessory = Ad['accessories'][number];
+export {};

package/dist/types/src/Gql/ad/useAd.d.ts

@@ -0,0 +1,8 @@
+import { PublicApiSettings } from '../config';
+import { Ad } from './types';
+declare const useAd: (id: string, settings: PublicApiSettings) => {
+    loading: boolean;
+    error: boolean;
+    ad: Ad | undefined;
+};
+export default useAd;

package/dist/types/src/Gql/ad/useInsuranceInquiry.d.ts

@@ -0,0 +1,11 @@
+import { PublicApiSettings } from '../config';
+import { InsuranceInquiryInsurance } from './types';
+/** Yearly driving distance in Swedish mil, as the public API's DrivingDistance enum. */
+export type DrivingDistance = 'BETWEEN_0_AND_1000' | 'BETWEEN_1000_AND_1500' | 'BETWEEN_1500_AND_2000' | 'BETWEEN_2000_AND_2500' | 'OVER_2500';
+/** Insurance quotes through iteration.commerce.insuranceInquiry. */
+declare const useInsuranceInquiry: (settings: PublicApiSettings, adId: string, personalNumber?: string, drivingDistance?: DrivingDistance) => {
+    loading: boolean;
+    error: boolean;
+    insurances: InsuranceInquiryInsurance[] | undefined;
+};
+export default useInsuranceInquiry;

package/dist/types/src/Gql/ad/useLoanCalculation.d.ts

@@ -0,0 +1,14 @@
+import { PublicApiSettings } from '../config';
+import { PaymentResponse } from './types';
+export interface LoanVariables {
+    financialOptionId?: string | null;
+    duration?: number;
+    downPayment?: number;
+    residual?: number;
+}
+/** A recalculated loan through iteration.commerce.calculatePayment. */
+declare const useLoanCalculation: (settings: PublicApiSettings, adId: string, { financialOptionId, duration, downPayment, residual }: LoanVariables) => {
+    loading: boolean;
+    payment: PaymentResponse | undefined;
+};
+export default useLoanCalculation;

package/dist/types/src/Gql/ad/useRelatedAds.d.ts

@@ -0,0 +1,12 @@
+import { PublicApiSettings } from '../config';
+import { SearchHit } from '../types';
+/**
+ * "Fler bilar" on the ad page: the latest cars of the same make, the current
+ * ad excluded. There is no more-like-this in the public API; this is what
+ * web-ui-v2 does too.
+ */
+declare const useRelatedAds: (settings: PublicApiSettings, adId: string, manufacturer?: string, limit?: number) => {
+    loading: boolean;
+    hits: SearchHit[] | undefined;
+};
+export default useRelatedAds;

package/dist/types/src/Gql/ad/view.d.ts

@@ -0,0 +1,94 @@
+import { Ad, AdAccessory, AdMediaItem, PaymentRange } from './types';
+/** A number from the API, which sends some amounts as strings. */
+export declare const num: (value: string | number | null | undefined) => number | undefined;
+export declare const str: (value: string | null | undefined) => string | undefined;
+/** What every ad page event carries. */
+export declare const adEvent: (ad: Ad) => {
+    id: string;
+    branchId: string;
+    branchName: string | undefined;
+};
+/** Ecom and ev-calculation are keyed on the legacy waykeId, not on ad.id. */
+export declare const waykeId: (ad: Ad) => string;
+export declare const platformChannel: (ad: Ad) => {
+    __typename: string;
+    status?: string;
+    inventoryStatus?: string;
+    publishedAt?: string | null;
+    soldAt?: string | null;
+    deliveryTime?: {
+        __typename: string;
+        date?: string;
+        from?: string;
+        to?: string;
+        unit?: string;
+    } | null;
+} | undefined;
+export declare const price: (ad: Ad) => number;
+/** How much the price was lowered, when it was. */
+export declare const discount: (ad: Ad) => number | undefined;
+/** The delivery date of a car that is not in stock yet. */
+export declare const availableFrom: (ad: Ad) => Date | undefined;
+export declare const publishedAt: (ad: Ad) => Date | undefined;
+/** Buy online is offered when the branch has it, unless it is switched off for Wayke. */
+export declare const ecom: (ad: Ad) => {
+    enabled: boolean;
+    reserved: boolean;
+};
+export interface ContactPerson {
+    name?: string;
+    email?: string;
+    phone?: string;
+    avatar?: string;
+}
+/** The person to contact about the ad: the assigned salesperson, else the branch's default. */
+export declare const contactPerson: (ad: Ad) => ContactPerson | undefined;
+export type DayKey = 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
+export type WeekOpeningHours = Partial<Record<DayKey, {
+    from: string;
+    until: string;
+} | null>>;
+export declare const openingHours: (branch: Ad['branch']) => WeekOpeningHours | undefined;
+export declare const position: (branch: Ad['branch']) => {
+    latitude: number;
+    longitude: number;
+} | undefined;
+export type MediaType = 'image' | 'sphere' | 'threesixty' | 'embedded';
+/** One slide of the gallery: an image, a panorama, a 360 spin of several images, or a video. */
+export interface GalleryMedia {
+    type: MediaType;
+    urls: string[];
+}
+export declare const galleryMedia: (items: AdMediaItem[]) => GalleryMedia[];
+export interface Range {
+    current: number;
+    min: number;
+    max: number;
+    step: number;
+}
+export declare const range: (r: PaymentRange | null | undefined) => Range | undefined;
+export interface LeasingOffer {
+    business: boolean;
+    monthlyCost: number;
+    months?: number;
+    mileagePerYear?: number;
+    name?: string;
+    description?: string;
+    image?: string;
+}
+/** Private and business leasing, with the dealer's promo text when there is one. */
+export declare const leasingOffers: (ad: Ad) => LeasingOffer[];
+export interface PackageOffer {
+    title: string;
+    description?: string;
+    image?: string;
+    link?: {
+        url: string;
+        title?: string;
+    };
+}
+export declare const packageOffers: (ad: Ad) => PackageOffer[];
+/** The manufacturer's warranty package of a certified pre-owned car. */
+export declare const manufacturerPackage: (ad: Ad) => PackageOffer | undefined;
+/** An accessory's images, in their order. */
+export declare const accessoryImages: (accessory: AdAccessory) => string[];

package/dist/types/src/Gql/client.d.ts

@@ -0,0 +1,11 @@
+export interface PublicApiConfig {
+    url: string;
+    apiKey?: string;
+}
+export type GqlErrorKind = 'unauthorized' | 'rate-limited' | 'graphql' | 'network';
+export declare class GqlError extends Error {
+    readonly kind: GqlErrorKind;
+    readonly retryAfter?: number;
+    constructor(kind: GqlErrorKind, message: string, retryAfter?: number);
+}
+export declare const gqlQuery: <T>(config: PublicApiConfig, query: string, variables: Record<string, unknown>) => Promise<T>;

package/dist/types/src/Gql/config.d.ts

@@ -0,0 +1,9 @@
+import { MarketCode } from '../@types/market';
+import { PublicApiConfig } from './client';
+/** What every request to the public API needs, resolved once by the provider. */
+export interface PublicApiSettings {
+    api: PublicApiConfig;
+    /** Narrows the search to a group of branches; without it the key's own scope applies */
+    branchGroupId?: string;
+    market: MarketCode;
+}

package/dist/types/src/Gql/facets.d.ts

@@ -0,0 +1,19 @@
+import { MarketCode } from '../@types/market';
+import { RangeFilter } from './searchParams';
+import { AdsResult, Facet } from './types';
+export interface FacetOption {
+    value: string;
+    count: number;
+    selected: boolean;
+}
+/**
+ * The values of a list filter, with counts from the filtered result (where a
+ * selected filter's own facet is counted without it, see useAdsSearch). A
+ * selected value is always listed, so it can be unticked.
+ */
+export declare const listOptions: (field: string, params: URLSearchParams, facets: Facet[] | undefined) => FacetOption[];
+export declare const isRangeFilter: (key: string) => key is RangeFilter;
+/** The bucket start values of a slider, ascending, from the unfiltered search. */
+export declare const rangeValues: (key: RangeFilter, unfiltered: AdsResult | undefined, market: MarketCode) => number[];
+/** How many values of a filter are picked: list values, or 1 for a set range. */
+export declare const selectedCount: (key: string, params: URLSearchParams) => number;

package/dist/types/src/Gql/hit.d.ts

@@ -0,0 +1,5 @@
+import { Money, SearchHit } from './types';
+/** An amount from the API, or undefined when it is missing or not above zero. */
+export declare const toAmount: (money?: Money | null) => number | undefined;
+/** The first image of a hit, if any. */
+export declare const hitImage: (hit: SearchHit) => string | undefined;

package/dist/types/src/Gql/legacyParams.d.ts

@@ -0,0 +1,7 @@
+/** True when the params carry anything that is not already in the new grammar. */
+export declare const hasLegacyParams: (params: URLSearchParams) => boolean;
+/**
+ * Legacy params → canonical new-grammar params. Idempotent: params already in
+ * the new grammar come back unchanged (apart from canonical ordering).
+ */
+export declare const migrateLegacyParams: (input: URLSearchParams) => URLSearchParams;

package/dist/types/src/Gql/queries.d.ts

@@ -0,0 +1,17 @@
+export declare const SEARCH_HIT_FIELDS = "\n  ad {\n    id\n    salesDescription { title }\n    pricing {\n      cash { price { amount } oldPrice { amount } deductibleVat }\n      leasing { leasingMonthlyPayment { amount } }\n      companyLeasing { leasingMonthlyPayment { amount } }\n    }\n    media(limit: 1) { items { ... on AdImage { id url formats { format url } } } }\n    branch { id displayName }\n    channels { ... on PlatformChannel { status soldAt } }\n  }\n  iteration {\n    logistics { odometerReading { value unit } }\n    item {\n      ... on Vehicle {\n        displayName\n        manufacturer { stringValue }\n        modelSeries { stringValue }\n        modelYear { intValue }\n        registrationNumber { stringValue }\n        driveline { fuelTypesString { stringValue } }\n        attributes { transmission { formattedValue } }\n      }\n    }\n  }\n";
+export declare const ADS_ARGUMENTS = "\n  market: $market\n  q: $q\n  branchGroupId: $branchGroupId\n  page: $page\n  perPage: $perPage\n  sort: $sort\n  soldWithinDays: 0\n  manufacturer: $manufacturer\n  model: $model\n  modelSeries: $modelSeries\n  fuelType: $fuelType\n  gearboxType: $gearboxType\n  branchDisplayName: $branchDisplayName\n  colorName: $colorName\n  environmentClass: $environmentClass\n  segment: $segment\n  drivetrainType: $drivetrainType\n  bodyStyle: $bodyStyle\n  engineBaseType: $engineBaseType\n  trimLevel: $trimLevel\n  inventoryStatus: $inventoryStatus\n  branchCity: $branchCity\n  certifiedPreOwned: $certifiedPreOwned\n  isDemoVersion: $isDemoVersion\n  deductibleVat: $deductibleVat\n  ecom: $ecom\n  leasing: $leasing\n  businessLeasing: $businessLeasing\n  cashPriceMin: $cashPriceMin\n  cashPriceMax: $cashPriceMax\n  odometerReadingMin: $odometerReadingMin\n  odometerReadingMax: $odometerReadingMax\n  modelYearMin: $modelYearMin\n  modelYearMax: $modelYearMax\n  leasingPriceMin: $leasingPriceMin\n  leasingPriceMax: $leasingPriceMax\n  companyLeasingPriceMin: $companyLeasingPriceMin\n  companyLeasingPriceMax: $companyLeasingPriceMax\n";
+export declare const ADS_VARIABLE_DEFINITIONS = "\n  $market: [String]\n  $q: String\n  $branchGroupId: String\n  $page: Int\n  $perPage: Int\n  $sort: AdsSort\n  $manufacturer: [String]\n  $model: [String]\n  $modelSeries: [String]\n  $fuelType: [String]\n  $gearboxType: [String]\n  $branchDisplayName: [String]\n  $colorName: [String]\n  $environmentClass: [String]\n  $segment: [String]\n  $drivetrainType: [String]\n  $bodyStyle: [String]\n  $engineBaseType: [String]\n  $trimLevel: [String]\n  $inventoryStatus: [String]\n  $branchCity: [String]\n  $certifiedPreOwned: Boolean\n  $isDemoVersion: Boolean\n  $deductibleVat: Boolean\n  $ecom: Boolean\n  $leasing: Boolean\n  $businessLeasing: Boolean\n  $cashPriceMin: Float\n  $cashPriceMax: Float\n  $odometerReadingMin: Int\n  $odometerReadingMax: Int\n  $modelYearMin: Int\n  $modelYearMax: Int\n  $leasingPriceMin: Float\n  $leasingPriceMax: Float\n  $companyLeasingPriceMin: Float\n  $companyLeasingPriceMax: Float\n";
+/** Alias of the facet-only search for one selected list filter, see buildSearchQuery. */
+export declare const multiSelectFacetAlias: (field: string) => string;
+/**
+ * One request for the search page: the filtered list with its facets and, for
+ * every list filter that has a selection, that facet counted WITHOUT its own
+ * filter. The legacy search counted facets that way ("multi-select"), so the
+ * other makes stay listed with their counts after picking one; the public API
+ * counts facets on the filtered result, where only the picked make remains.
+ */
+export declare const buildSearchQuery: (selectedListFilters: string[]) => string;
+export declare const SEARCH_QUERY: string;
+/** Unfiltered facets and histograms: the filter panel's full value lists and slider domains. */
+export declare const FACETS_QUERY = "\nquery SearchFacets($market: [String], $branchGroupId: String) {\n  search {\n    ads(market: $market, branchGroupId: $branchGroupId, perPage: 0, soldWithinDays: 0) {\n      found\n      facets { field counts { value count } }\n      histograms {\n        price { value count }\n        odometerReading { value count }\n        leasingPrice { value count }\n        businessLeasingPrice { value count }\n      }\n    }\n  }\n}\n";
+export declare const SUGGEST_QUERY = "\nquery Suggest($market: [String], $branchGroupId: String, $q: String!, $limit: Int) {\n  search {\n    ads(market: $market, branchGroupId: $branchGroupId, q: $q, perPage: 0, soldWithinDays: 0) {\n      suggest(limit: $limit) { label count dimension filters { field value } }\n    }\n  }\n}\n";