@pagamio/frontend-commons-lib 0.8.341 → 0.8.342

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/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.342",
   "publishConfig": {
     "access": "public",
     "provenance": false