@lystech/core 3.0.143 → 3.0.144

package/dist/index.d.ts

@@ -282,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;
@@ -681,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;
@@ -689,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 = {
@@ -738,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, }?: {
@@ -841,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 = {
@@ -865,6 +890,13 @@ 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;
@@ -930,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 = {
@@ -1246,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;
@@ -1728,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;
 
 /**
@@ -1910,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>;