@lystech/core 3.0.142 → 3.0.144

package/dist/index.d.ts

@@ -12,6 +12,28 @@ import { RefetchOptions } from '@tanstack/react-query';
 import { RefetchQueryFilters } from '@tanstack/react-query';
 import { UseQueryResult } from '@tanstack/react-query';
 
+export declare type ActivePromotion = {
+    campaignUID: string;
+    name: string;
+    description: string | null;
+    discountLabel: string;
+    startsAt: string | null;
+    endsAt: string | null;
+    banner: boolean;
+    bannerText: string | null;
+    countdown: boolean;
+    badge: string | null;
+    scope: "all" | "selection";
+    collections: string[];
+};
+
+export declare type ActivePromotions = {
+    now: string;
+    campaigns: ActivePromotion[];
+    /** Par UID de produit : le prix promotionnel décidé par le serveur. */
+    products: Record<string, ProductPromotion>;
+};
+
 export declare type AppliedPromoCodeType = {
     promoCodeObject: PromoCodeType;
     finalTotalPrice: number;
@@ -197,6 +219,9 @@ declare type AuthUserProfileProps = {
 
 export declare const axiosInstance: AxiosInstance;
 
+/** Les campagnes à annoncer en bannière, pour cette collection (ou toute la boutique). */
+export declare function bannersFor(data: ActivePromotions | null | undefined, collectionUID?: string | null): ActivePromotion[];
+
 export declare function BecomeMember({ title, intro, successUrl, cancelUrl, renderAction, onChoosePlan, onLoginRequired, }: BecomeMemberProps): JSX.Element | null;
 
 export declare type BecomeMemberProps = {
@@ -257,12 +282,28 @@ declare type BillProduct = {
     lastOrderedOn: string;
 };
 
-export declare function BirthdayForm({ title }: BirthdayFormProps): JSX.Element | null;
+export declare function BirthdayForm({ title, onRequestChange }: BirthdayFormProps): JSX.Element | null;
 
 export declare type BirthdayFormProps = {
     title?: string;
+    /**
+     * « Demander une correction » (date déjà enregistrée). Défaut : ouvre le
+     * formulaire d'aide de la boutique, message pré-rempli (`openSupport`).
+     */
+    onRequestChange?: (current: {
+        day: number;
+        month: number;
+        year: number | null;
+    }) => void;
 };
 
+/** « 17 avril 1992 », « 17 avril » sans année. */
+export declare function birthdayText(d: {
+    day?: number;
+    month?: number;
+    year?: number | null;
+} | null | undefined): string;
+
 declare interface CardItem {
     label: default_2.ReactNode;
     labelIcon?: default_2.ReactNode;
@@ -549,6 +590,8 @@ declare interface GenericCardProps {
     pending?: boolean;
 }
 
+export declare function getActivePromotions(): Promise<ActivePromotions>;
+
 export declare function getFeaturedImages(): Promise<ImageType[]>;
 
 export declare function getLoyaltyRewards(): Promise<LoyaltyRewards>;
@@ -654,7 +697,7 @@ export declare type LoyaltyPlan = {
     stripePriceId: string | null;
 };
 
-export declare function LoyaltyPoints({ title, showRewards, historyPreview }: LoyaltyPointsProps): JSX.Element | null;
+export declare function LoyaltyPoints({ title, showRewards, historyPreview, showHistory }: LoyaltyPointsProps): JSX.Element | null;
 
 export declare type LoyaltyPointsProps = {
     title?: string;
@@ -662,6 +705,12 @@ export declare type LoyaltyPointsProps = {
     showRewards?: boolean;
     /** Lignes d'historique visibles avant « Voir tout » (défaut : 8). */
     historyPreview?: number;
+    /**
+     * Montrer la liste « Historique » des mouvements (défaut : oui). Une boutique
+     * qui montre les points PAR COMMANDE dans l'historique de commandes
+     * (`OrderLoyaltyPoints`) peut la retirer : le solde et les récompenses restent.
+     */
+    showHistory?: boolean;
 };
 
 export declare type LoyaltyPointsSummary = {
@@ -711,7 +760,7 @@ export declare const LYSTECH_CORE_VERSION: any;
 
 export declare function lystechAuthRoutes(): JSX.Element[];
 
-declare function LystechCoreProvider({ children, organization, shouldRedirectAfterLogin, loginRedirectRoute, queryClient, usePushNotifications, useProgressiveWebAppFeatures, useThemeProvider, quickGoogleLoginButtonStyle, enableGoogleQuickLoginButton, showGoogleQuickLoginButton, useGoogleAutoSelect, debugMode, showAskPermissionsButtons, hideSupportButton, supportButtonVariant, onPackageUpdated, triggerOnFirstInstallPackageCallback, packageVersionStorageKey, }: Props): JSX.Element;
+declare function LystechCoreProvider({ children, organization, shouldRedirectAfterLogin, loginRedirectRoute, queryClient, usePushNotifications, useProgressiveWebAppFeatures, useThemeProvider, quickGoogleLoginButtonStyle, enableGoogleQuickLoginButton, showGoogleQuickLoginButton, useGoogleAutoSelect, debugMode, showAskPermissionsButtons, hideSupportButton, supportButtonVariant, supportButtonPaths, onPackageUpdated, triggerOnFirstInstallPackageCallback, packageVersionStorageKey, }: Props): JSX.Element;
 export default LystechCoreProvider;
 
 export declare function LystechNotFoundPage({ homePath, homeLabel, }?: {
@@ -814,7 +863,10 @@ export declare type MyBirthday = {
     month?: number;
     day?: number;
     source: string | null;
+    /** Toujours null depuis la règle « saisie unique » (gardé pour compatibilité). */
     changeAllowedOn: string | null;
+    /** Une date existe : le client ne peut plus la changer (demande à l'aide). */
+    locked?: boolean;
 };
 
 export declare type MyLoyalty = {
@@ -838,16 +890,44 @@ export declare type MyLoyalty = {
     points: LoyaltyPointsSummary | null;
 };
 
+export declare function openSupport(options?: OpenSupportOptions): boolean;
+
+export declare type OpenSupportOptions = {
+    /** Texte placé dans le champ « message » (le client peut le modifier). */
+    message?: string;
+};
+
 declare type OrderBreakdown = {
     products: {
         UID: string;
         name: string;
         productType: string;
         quantity: number;
+        /** Prix unitaire PAYÉ (promotionnel quand une campagne est retenue). */
         itemPrice: number;
         stackPrice: number;
+        /** Présents quand une campagne de promotion baisse le prix de la ligne. */
+        regularPrice?: number;
+        campaignUID?: string;
+        campaignName?: string;
+        campaignStacking?: "exclusive" | "stack";
     }[];
     totalPrice: number;
+    /** Campagnes de promotion retenues (déjà déduites du sous-total). */
+    appliedCampaigns?: {
+        campaignUID: string;
+        name: string;
+        savings: number;
+        stacking: "exclusive" | "stack";
+    }[];
+    campaignSavings?: number;
+    /** Un code ou un avantage plus avantageux a écarté la promotion (un seul rabais par commande). */
+    campaignNotApplied?: string;
+    /** Codes valides mais écartés, avec la raison. */
+    promoNotApplied?: {
+        code: string;
+        reason: string;
+    }[];
     totalItems: number;
     finalPriceWithoutShipping?: number;
     finalPriceIncludingShippingAndFees?: number;
@@ -882,6 +962,25 @@ declare type OrderBreakdown = {
     }[];
 };
 
+/** « +50 points · utilisables le 26 octobre » ; « 25 points retirés (commande remboursée) ». */
+export declare function OrderLoyaltyPoints({ billUID, className }: OrderLoyaltyPointsProps): JSX.Element | null;
+
+export declare type OrderLoyaltyPointsProps = {
+    billUID: string;
+    className?: string;
+};
+
+export declare type OrderPoints = {
+    /** Points gagnés par cette commande (somme des gains). */
+    earned: number;
+    /** Points retirés (remboursement, annulation), en positif. */
+    reversed: number;
+    /** earned − reversed. */
+    net: number;
+    /** Gain encore en attente (délai de retour) : date où il devient utilisable. */
+    pendingUntil: string | null;
+};
+
 export declare function OrderTrackingPage({ token: tokenProp, shopHref }: Props_4): JSX.Element;
 
 export declare type OrderTrackingStep = {
@@ -1056,6 +1155,17 @@ export declare type PostType = {
     fk_createdByAuthKey?: string;
 };
 
+declare type Priced = {
+    UID?: any;
+    itemPrice?: number;
+    itemRealCost?: number;
+    promo?: PromoInfo;
+    /** Prix d'origine gardé pour défaire la promotion (idempotence). */
+    promoBasePrice?: number;
+    promoBaseRealCost?: number;
+    [key: string]: any;
+};
+
 declare interface ProductPopupProps {
     product: CartProduct & {
         variants?: any[];
@@ -1071,6 +1181,19 @@ declare interface ProductPopupProps {
     onClose: () => void;
 }
 
+export declare type ProductPromotion = {
+    regularPrice: number;
+    promoPrice: number;
+    campaignUID: string;
+    campaignName: string;
+    /** Pastille (« -20 % ») ; null : la boutique n'en veut pas. */
+    badge: string | null;
+    /** Montrer le prix courant barré à côté du prix promotionnel. */
+    strikethrough: boolean;
+    endsAt: string | null;
+    stacking: "exclusive" | "stack";
+};
+
 declare type ProductProp = {
     prop_UID: string;
     prop_value_UID: string;
@@ -1098,6 +1221,29 @@ declare type ProgressiveWebAppContextType = {
     installProgressiveWebApp: () => Promise<void>;
 };
 
+/** La pastille d'un produit en promotion (« -20 % »). */
+export declare function PromoBadge({ label, className }: {
+    label?: string | null;
+    className?: string;
+}): JSX.Element | null;
+
+export declare function PromoBanner({ promotion, onElapsed, className }: PromoBannerProps): JSX.Element | null;
+
+export declare interface PromoBannerProps {
+    promotion: Pick<ActivePromotion, "campaignUID" | "name" | "bannerText" | "discountLabel" | "endsAt" | "countdown">;
+    onElapsed?: () => void;
+    className?: string;
+}
+
+/**
+ * Les bannières des campagnes actives (celles que la boutique a choisi
+ * d'annoncer), pour une collection ou toute la boutique. Rien sans campagne.
+ */
+export declare function PromoBanners({ collectionUID, className }: {
+    collectionUID?: string | null;
+    className?: string;
+}): JSX.Element | null;
+
 export declare function PromoCodeTag({ promoCode, showExpireInfo, onClick, isApplied, onRemove, }: Props_14): JSX.Element;
 
 export declare type PromoCodeType = {
@@ -1114,6 +1260,18 @@ export declare type PromoCodeType = {
     target: string;
 };
 
+export declare type PromoInfo = {
+    campaignUID: string;
+    campaignName: string;
+    badge: string | null;
+    endsAt: string | null;
+    regularPrice: number;
+};
+
+export declare const promotionKeys: {
+    active: (org: string, user: string) => readonly ["promotions-active", string, string];
+};
+
 declare type Props = {
     children: default_2.ReactNode;
     organization?: string;
@@ -1139,6 +1297,12 @@ declare type Props = {
      * droite). Meme paquet, meme rendu partout — sauf choix explicite.
      */
     supportButtonVariant?: SupportButtonVariant;
+    /**
+     * Pages ou le bouton d'aide est VISIBLE (prefixes d'adresse, ex.
+     * `["/compte", "/panier"]`). Absent = partout (defaut inchange).
+     * Ailleurs, `openSupport()` ouvre quand meme le formulaire.
+     */
+    supportButtonPaths?: string[];
     onPackageUpdated?: (event: PackageUpdateEvent) => void;
     triggerOnFirstInstallPackageCallback?: boolean;
     packageVersionStorageKey?: string;
@@ -1404,7 +1568,7 @@ export declare interface ShopCatalogCollection {
     [key: string]: any;
 }
 
-export declare function ShopCatalogPage({ collections, selectedCollection, soldoutProductUIDs, renderProductCard, renderBanner, primaryColor, secondaryColor, itemsPerPage, defaultShowFilters, onCollectionClick, filtersText, allText, }: ShopCatalogPageProps): JSX.Element;
+export declare function ShopCatalogPage({ collections, selectedCollection, soldoutProductUIDs, renderProductCard, renderBanner, primaryColor, secondaryColor, itemsPerPage, defaultShowFilters, onCollectionClick, filtersText, allText, promotions, }: ShopCatalogPageProps): JSX.Element;
 
 export declare interface ShopCatalogPageProps {
     collections: ShopCatalogCollection[];
@@ -1419,6 +1583,14 @@ export declare interface ShopCatalogPageProps {
     onCollectionClick?: (collection: ShopCatalogCollection) => void;
     filtersText?: string;
     allText?: string;
+    /**
+     * Campagnes de promotion (défaut : oui). Chaque produit passé à
+     * `renderProductCard` porte alors le prix décidé par le serveur
+     * (`itemPrice` = prix promotionnel, `itemRealCost` = prix barré,
+     * `promo.badge` = pastille), et les bannières s'affichent au-dessus.
+     * Sans campagne active : rien ne change.
+     */
+    promotions?: boolean;
 }
 
 export declare interface ShopCatalogProduct {
@@ -1472,6 +1644,8 @@ declare type ShopProductCardProps = {
             keyUID: string;
             name: string;
         }[];
+        /** Posé par withPromotion : campagne en cours (prix décidé par le serveur). */
+        promo?: PromoInfo;
     };
     onClick?: () => void;
 };
@@ -1611,8 +1785,16 @@ export declare type SubscriptionSubscriber = {
     isGifted: boolean;
 };
 
-export declare function SupportButton({ variant, }?: {
+export declare function summarizeOrderPoints(rows: LedgerRow[], now?: number): Map<string, OrderPoints>;
+
+export declare function SupportButton({ variant, showOnPaths, }?: {
     variant?: SupportButtonVariant;
+    /**
+     * Pages ou le declencheur est VISIBLE (prefixes d'adresse : `/compte`
+     * couvre `/compte/...`). Absent = partout (defaut inchange). Ailleurs, le
+     * formulaire reste joignable par `openSupport()`.
+     */
+    showOnPaths?: string[];
 }): JSX.Element | null;
 
 /**
@@ -1793,6 +1975,14 @@ export declare const useInvitedToOrders: (email: string, organization?: string)
 
 export declare function useLoyaltyLedger(enabled?: boolean): UseQueryResult<LedgerRow[], unknown>;
 
+/** Points par commande (billUID → résumé), pour tout l'historique du client. */
+export declare function useLoyaltyPointsByOrder(enabled?: boolean): {
+    enabled: boolean;
+    label: string;
+    byOrder: Map<string, OrderPoints>;
+    loading: boolean;
+};
+
 export declare function useLoyaltyRewards(enabled?: boolean): UseQueryResult<LoyaltyRewards, unknown>;
 
 export declare const useLystechPolitiqueAndConditions: () => UseQueryResult<PolitiqueAndConditionsType[], unknown>;
@@ -1844,6 +2034,13 @@ export declare const usePopup: () => ProviderType;
 
 export declare const useProgressiveWebApp: () => ProgressiveWebAppContextType;
 
+export declare function usePromotions(enabled?: boolean): {
+    data: ActivePromotions | undefined;
+    loading: boolean;
+    error: unknown;
+    refetch: () => void;
+};
+
 export declare const usePushNotifications: () => PushNotificationContextType;
 
 /**
@@ -1896,6 +2093,13 @@ export declare const useUserRoleDetails: (authKey: string, organizationSubdomain
 
 export declare function validatePromoCode(code: string, products: any[]): Promise<AppliedPromoCodeType>;
 
+export declare function withPromotion<T extends Priced>(product: T, promos?: Record<string, ProductPromotion> | null): T;
+
+/** Une collection (et les variantes de ses produits) aux prix de la promotion. */
+export declare function withPromotionsInCollection<C extends {
+    products?: any[];
+} | undefined | null>(collection: C, data?: ActivePromotions | null): C;
+
 
 export * from "@lystech/sections";