@pagamio/frontend-commons-lib 0.8.341 → 0.8.343

package/lib/auth/components/LoginPage.d.ts

@@ -66,9 +66,10 @@ export interface PhonePinLoginConfig {
 }
 /**
  * Configuration for the username + PIN login tab.
- * When provided, a "Login Number + PIN" tab is displayed alongside the other
- * tabs. Login numbers are admin-assigned 10-digit numeric identifiers (there
- * is no self-service signup for this method).
+ * When provided, an "Operator ID + PIN" tab is displayed alongside the other
+ * tabs. Operator IDs are admin-assigned 10-digit numeric identifiers (the
+ * underlying API field stays `loginNumber`; only the user-facing copy has
+ * been renamed to align with the mobile Welcome Back screen).
  */
 export interface UsernamePinLoginConfig {
     /** Login with login number and PIN. Should throw on error. */
@@ -77,7 +78,7 @@ export interface UsernamePinLoginConfig {
      * Optional callback called instead of onLoginSuccess when mustChangePIN is true.
      */
     onMustChangePIN?: (loginNumber: string, response: any) => void;
-    /** Optional label for the username-PIN tab (default: 'Login Number + PIN') */
+    /** Optional label for the username-PIN tab (default: 'Operator ID') */
     tabLabel?: string;
     /** Optional label for the password tab (default: 'Email & Password') */
     passwordTabLabel?: string;
@@ -164,8 +165,9 @@ interface PagamioLoginPageProps<T extends CustomAuthConfig> extends BaseAuthPage
      */
     phonePinConfig?: PhonePinLoginConfig;
     /**
-     * When provided, adds a "Login Number + PIN" tab alongside the standard login
-     * form. The tab handles the 2-step login-number + PIN flow internally.
+     * When provided, adds an "Operator ID" tab alongside the standard login
+     * form. The tab handles the 2-step Operator ID + PIN flow internally.
+     * (Underlying API field name stays `loginNumber`.)
      */
     usernamePinConfig?: UsernamePinLoginConfig;
 }

package/lib/auth/components/LoginPage.js

@@ -53,7 +53,18 @@ export function PagamioLoginPage({ logo, text = loginPageDefaultText, appLabel,
     const [isLoading, setIsLoading] = useState(false);
     const [error, setError] = useState(null);
     const formRef = useRef(null);
-    const [activeTab, setActiveTab] = useState('password');
+    // Default-active tab follows the "phone-first" hierarchy from the
+    // commerce-os mobile Welcome Back screen: Phone → Operator ID → Email.
+    // Falls back to whichever tab is actually configured when the others
+    // aren't enabled, so single-tab consumers keep working unchanged.
+    const showPhoneTabInitial = Boolean(phoneOtpConfig || phonePinConfig);
+    const showUsernameTabInitial = Boolean(usernamePinConfig);
+    const defaultActiveTab = showPhoneTabInitial
+        ? 'phone'
+        : showUsernameTabInitial
+            ? 'username'
+            : 'password';
+    const [activeTab, setActiveTab] = useState(defaultActiveTab);
     const [phoneStep, setPhoneStep] = useState('enterPhone');
     const [phoneNumber, setPhoneNumber] = useState('');
     const [phoneOtpValue, setPhoneOtpValue] = useState('');
@@ -98,16 +109,19 @@ export function PagamioLoginPage({ logo, text = loginPageDefaultText, appLabel,
     ];
     const loginNumberField = [
         {
+            // Internal field name stays `loginNumber` to match the auth API
+            // payload; only the user-facing strings change to "Operator ID" to
+            // align with the mobile Welcome Back screen.
             name: 'loginNumber',
-            label: 'Login Number',
+            label: 'Operator ID',
             type: 'text',
-            placeholder: '1230000001',
+            placeholder: 'Enter Operator ID',
             gridSpan: 12,
             validation: {
-                required: 'Login number is required',
+                required: 'Operator ID is required',
                 pattern: {
                     value: /^\d{10}$/,
-                    message: 'Login number must be exactly 10 digits',
+                    message: 'Operator ID must be exactly 10 digits',
                 },
             },
         },
@@ -308,10 +322,10 @@ export function PagamioLoginPage({ logo, text = loginPageDefaultText, appLabel,
         usernamePinConfig?.passwordTabLabel ??
         'Email';
     const phoneTabLabel = phoneOtpConfig?.tabLabel ?? phonePinConfig?.tabLabel ?? 'Phone';
-    const usernameTabLabel = usernamePinConfig?.tabLabel ?? 'Login Number';
-    return (_jsx(AuthPageLayout, { appLabel: appLabel, title: text.welcomeTitle, subtitle: text.welcomeSubtitle, errorMessage: activeTab === 'password' ? (error ?? authError?.message) : undefined, logo: logo, className: className, horizontal: false, sideContent: features && features.length > 0 ? _jsx(FeatureCarousel, { features: features }) : undefined, sideContentClass: sideContentClass, footer: footer, children: _jsxs("div", { className: "mt-8", children: [showTabs && (_jsxs("div", { className: "mb-6 flex divide-x divide-border overflow-hidden rounded-lg border border-border", role: "tablist", "aria-label": "Login method", children: [_jsx("button", { type: "button", role: "tab", "aria-selected": activeTab === 'password', onClick: () => setActiveTab('password'), className: `flex-1 whitespace-nowrap px-3 py-2.5 text-center text-sm font-medium transition-colors ${activeTab === 'password'
-                                ? 'bg-primary text-primary-foreground'
-                                : 'bg-background text-foreground/70 hover:bg-muted'}`, children: passwordTabLabel }), showPhoneTab && (_jsx("button", { type: "button", role: "tab", "aria-selected": activeTab === 'phone', onClick: () => {
+    // "Operator ID" aligns the web tab label with the mobile Welcome Back
+    // screen. Consumers can still override via usernamePinConfig.tabLabel.
+    const usernameTabLabel = usernamePinConfig?.tabLabel ?? 'Operator ID';
+    return (_jsx(AuthPageLayout, { appLabel: appLabel, title: text.welcomeTitle, subtitle: text.welcomeSubtitle, errorMessage: activeTab === 'password' ? (error ?? authError?.message) : undefined, logo: logo, className: className, horizontal: false, sideContent: features && features.length > 0 ? _jsx(FeatureCarousel, { features: features }) : undefined, sideContentClass: sideContentClass, footer: footer, children: _jsxs("div", { className: "mt-8", children: [showTabs && (_jsxs("div", { className: "mb-6 flex divide-x divide-border overflow-hidden rounded-lg border border-border", role: "tablist", "aria-label": "Login method", children: [showPhoneTab && (_jsx("button", { type: "button", role: "tab", "aria-selected": activeTab === 'phone', onClick: () => {
                                 setActiveTab('phone');
                                 setPhoneStep('enterPhone');
                                 setPhoneOtpValue('');
@@ -326,7 +340,9 @@ export function PagamioLoginPage({ logo, text = loginPageDefaultText, appLabel,
                                 setUsernameError(null);
                             }, className: `flex-1 whitespace-nowrap px-3 py-2.5 text-center text-sm font-medium transition-colors ${activeTab === 'username'
                                 ? 'bg-primary text-primary-foreground'
-                                : 'bg-background text-foreground/70 hover:bg-muted'}`, children: usernameTabLabel }))] })), activeTab === 'password' && (_jsxs(_Fragment, { children: [_jsx(FormEngine, { fields: loginFields, onSubmit: handleSubmit, layout: "vertical", className: "mb-0 px-0", submitButtonClass: "w-full", submitButtonText: isLoading ? text.loadingButtonLabel : text.loginButtonLabel, onCancel: () => { }, showCancelButton: false, showSubmittingText: false, formRef: formRef, initialValues: {
+                                : 'bg-background text-foreground/70 hover:bg-muted'}`, children: usernameTabLabel })), _jsx("button", { type: "button", role: "tab", "aria-selected": activeTab === 'password', onClick: () => setActiveTab('password'), className: `flex-1 whitespace-nowrap px-3 py-2.5 text-center text-sm font-medium transition-colors ${activeTab === 'password'
+                                ? 'bg-primary text-primary-foreground'
+                                : 'bg-background text-foreground/70 hover:bg-muted'}`, children: passwordTabLabel })] })), activeTab === 'password' && (_jsxs(_Fragment, { children: [_jsx(FormEngine, { fields: loginFields, onSubmit: handleSubmit, layout: "vertical", className: "mb-0 px-0", submitButtonClass: "w-full", submitButtonText: isLoading ? text.loadingButtonLabel : text.loginButtonLabel, onCancel: () => { }, showCancelButton: false, showSubmittingText: false, formRef: formRef, initialValues: {
                                 ...(loginFieldType === 'email' ? { email: '' } : { username: '' }),
                                 password: '',
                                 rememberMe: false,
@@ -351,6 +367,6 @@ export function PagamioLoginPage({ logo, text = loginPageDefaultText, appLabel,
                                         setUsernameStep('enterLoginNumber');
                                         setLoginNumberPinValue('');
                                         setUsernameError(null);
-                                    }, className: "w-full text-sm text-foreground/70", children: "\u2190 Change login number" })] }))] }))] }) }));
+                                    }, className: "w-full text-sm text-foreground/70", children: "\u2190 Change Operator ID" })] }))] }))] }) }));
 }
 export default PagamioLoginPage;

package/lib/pagamio-drawer/components/DrawerContent.d.ts

@@ -22,6 +22,12 @@ interface DrawerContentProps {
     processingDependencyRef?: React.MutableRefObject<boolean>;
     pendingUpdatesRef?: React.MutableRefObject<Map<string, unknown>>;
     persistenceKey?: string;
+    /**
+     * When true, persisted form data is wiped whenever the drawer transitions
+     * from open → closed. Use for one-shot create/register flows where the
+     * next open should start blank.
+     */
+    clearOnClose?: boolean;
     /** Ref updated every render with current dirty state — read by FormEngineDrawer for X-button check. */
     isDirtyRef?: React.MutableRefObject<boolean>;
     /** Ref updated every render with handleCancel — call from outside (e.g. X button) to show the same unsaved-changes modal. */

package/lib/pagamio-drawer/components/DrawerContent.js

@@ -5,7 +5,7 @@ import { Button, NotificationModal } from '../../components';
 import { useToast } from '../../context';
 import { FieldWrapper } from '../../form-engine';
 import { useFormPersistence } from '../../form-engine/hooks/useFormPersistence';
-const DrawerContent = ({ fields, onSubmit, isOpen, initialValues, submitButtonText = 'Submit', cancelButtonText = 'Cancel', showForm = true, showDrawerButtons = true, handleCloseDrawer, onFieldUpdate, onFieldChange, children, updateFieldOptions, updateFieldLabel, setFieldHidden, addField, updateFieldValidation, processInitialFieldUpdates, processingDependencyRef, pendingUpdatesRef, persistenceKey, isDirtyRef, cancelRef, }) => {
+const DrawerContent = ({ fields, onSubmit, isOpen, initialValues, submitButtonText = 'Submit', cancelButtonText = 'Cancel', showForm = true, showDrawerButtons = true, handleCloseDrawer, onFieldUpdate, onFieldChange, children, updateFieldOptions, updateFieldLabel, setFieldHidden, addField, updateFieldValidation, processInitialFieldUpdates, processingDependencyRef, pendingUpdatesRef, persistenceKey, clearOnClose = false, isDirtyRef, cancelRef, }) => {
     const { saveFormData, restoreFormData, clearPersistedData, hasPersistedData } = useFormPersistence(persistenceKey);
     const { addToast } = useToast();
     // Determine initial values: initialValues take precedence over persisted data
@@ -39,6 +39,21 @@ const DrawerContent = ({ fields, onSubmit, isOpen, initialValues, submitButtonTe
         mountInitialValuesRef.current = initialValues || {};
     }
     wasOpenRef.current = !!isOpen;
+    // Clear persisted data on every open → close transition when the consumer
+    // opts in. Covers cancel, X, ESC, programmatic close, and post-submit close
+    // — all routes the user can take out of the drawer.
+    const clearOnCloseRef = useRef(clearOnClose);
+    clearOnCloseRef.current = clearOnClose;
+    const clearPersistedDataRef = useRef(clearPersistedData);
+    clearPersistedDataRef.current = clearPersistedData;
+    const previousIsOpenRef = useRef(!!isOpen);
+    useEffect(() => {
+        const wasOpen = previousIsOpenRef.current;
+        previousIsOpenRef.current = !!isOpen;
+        if (wasOpen && !isOpen && clearOnCloseRef.current) {
+            clearPersistedDataRef.current();
+        }
+    }, [isOpen]);
     const password = watch('password');
     const allFields = watch();
     // Function to check if there are unsaved changes

package/lib/pagamio-drawer/index.d.ts

@@ -16,6 +16,14 @@ interface FormEngineDrawerProps {
     onFieldUpdate?: Record<string, DependentFieldUpdate[]>;
     onFieldChange?: (fieldName: string, value: unknown) => void;
     persistenceKey?: string;
+    /**
+     * When true, persisted form data is wiped whenever the drawer transitions
+     * from open → closed (cancel, X, ESC, programmatic close, successful submit).
+     * Default `false` preserves the original "resume a half-filled form" behaviour.
+     * Set to `true` for one-shot create/register flows where the next open should
+     * start blank — e.g. a "register device" or "deploy terminal" drawer.
+     */
+    clearOnClose?: boolean;
 }
 declare const FormEngineDrawer: React.FC<FormEngineDrawerProps>;
 export default FormEngineDrawer;

package/lib/pagamio-drawer/index.js

@@ -2,7 +2,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { useEffect, useRef, useState } from 'react';
 import BaseDrawer from './components/BaseDrawer';
 import DrawerContent from './components/DrawerContent';
-const FormEngineDrawer = ({ title, cancelButtonText = 'Cancel', submitButtonText = 'Submit', showForm = true, showDrawerButtons = true, isOpen, fields: initialFields, initialValues, children, marginTop = '0px', onClose, onSubmit, onFieldUpdate, onFieldChange, persistenceKey, }) => {
+const FormEngineDrawer = ({ title, cancelButtonText = 'Cancel', submitButtonText = 'Submit', showForm = true, showDrawerButtons = true, isOpen, fields: initialFields, initialValues, children, marginTop = '0px', onClose, onSubmit, onFieldUpdate, onFieldChange, persistenceKey, clearOnClose = false, }) => {
     const [fields, setFields] = useState(initialFields);
     const initializedRef = useRef(false);
     const processingDependencyRef = useRef(false);
@@ -133,6 +133,6 @@ const FormEngineDrawer = ({ title, cancelButtonText = 'Cancel', submitButtonText
             processingDependencyRef.current = false;
         }
     };
-    return (_jsx(BaseDrawer, { title: title, isOpen: isOpen, marginTop: marginTop, onClose: onClose, onCloseAttempt: () => cancelRef.current(), children: _jsx(DrawerContent, { isOpen: isOpen, fields: fields, onSubmit: onSubmit, handleCloseDrawer: onClose, initialValues: initialValues, showForm: showForm, showDrawerButtons: showDrawerButtons, cancelButtonText: cancelButtonText, submitButtonText: submitButtonText, onFieldUpdate: onFieldUpdate, onFieldChange: onFieldChange, updateFieldOptions: updateFieldOptions, updateFieldLabel: updateFieldLabel, setFieldHidden: setFieldHidden, addField: addField, updateFieldValidation: updateFieldValidation, processInitialFieldUpdates: processInitialFieldUpdates, processingDependencyRef: processingDependencyRef, pendingUpdatesRef: pendingUpdatesRef, persistenceKey: persistenceKey, cancelRef: cancelRef, children: children }, persistenceKey || 'drawer-content') }));
+    return (_jsx(BaseDrawer, { title: title, isOpen: isOpen, marginTop: marginTop, onClose: onClose, onCloseAttempt: () => cancelRef.current(), children: _jsx(DrawerContent, { isOpen: isOpen, fields: fields, onSubmit: onSubmit, handleCloseDrawer: onClose, initialValues: initialValues, showForm: showForm, showDrawerButtons: showDrawerButtons, cancelButtonText: cancelButtonText, submitButtonText: submitButtonText, onFieldUpdate: onFieldUpdate, onFieldChange: onFieldChange, updateFieldOptions: updateFieldOptions, updateFieldLabel: updateFieldLabel, setFieldHidden: setFieldHidden, addField: addField, updateFieldValidation: updateFieldValidation, processInitialFieldUpdates: processInitialFieldUpdates, processingDependencyRef: processingDependencyRef, pendingUpdatesRef: pendingUpdatesRef, persistenceKey: persistenceKey, clearOnClose: clearOnClose, cancelRef: cancelRef, children: children }, persistenceKey || 'drawer-content') }));
 };
 export default FormEngineDrawer;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pagamio/frontend-commons-lib",
   "description": "Pagamio library for Frontend reusable components like the form engine and table container",
-  "version": "0.8.341",
+  "version": "0.8.343",
   "publishConfig": {
     "access": "public",
     "provenance": false