w-web-sso 1.0.76 → 1.0.78

package/docs/WWebSso.html

@@ -82,7 +82,7 @@ token發放/驗證/更新, 後台使用者/金鑰/IP管理與統計資訊, 以
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="server_WWebSso.mjs.html">server/WWebSso.mjs</a>, <a href="server_WWebSso.mjs.html#line99">line 99</a>
+        <a href="server_WWebSso.mjs.html">server/WWebSso.mjs</a>, <a href="server_WWebSso.mjs.html#line102">line 102</a>
     </li></ul></dd>
     
 
@@ -2207,6 +2207,126 @@ token發放/驗證/更新, 後台使用者/金鑰/IP管理與統計資訊, 以
 
     
 
+        <tr>
+            
+                <td class="name"><code>userRegistrationVerifySuccess</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Object</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>{}</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入註冊驗證結果頁「驗證成功」訊息物件，逐語系鍵(eng、cht)各自給文字或檔案路徑(檔案存在即讀檔作為文字)，代入verifyEmailResultContent之{message}，未給之語系採內建語系文字，預設{}</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>verifyEmailAlreadyVerified</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Object</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>{}</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入註冊驗證結果頁「帳號已完成驗證」訊息物件，逐語系鍵(eng、cht)各自給文字或檔案路徑，代入{message}，未給之語系採內建語系文字，預設{}</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>verifyEmailInvalidToken</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Object</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>{}</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入註冊驗證結果頁「驗證連結無效或已失效」訊息物件，逐語系鍵(eng、cht)各自給文字或檔案路徑，代入{message}，未給之語系採內建語系文字，預設{}</p></td>
+        </tr>
+
+    
+
         <tr>
             
                 <td class="name"><code>verifyEmailResultContent</code></td>
@@ -2334,7 +2454,7 @@ token發放/驗證/更新, 後台使用者/金鑰/IP管理與統計資訊, 以
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Sep 14 2026 20:15:23 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 16 2026 15:00:43 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/global.html

@@ -311,7 +311,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Sep 14 2026 20:15:23 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 16 2026 15:00:43 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/index.html

@@ -71,7 +71,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Sep 14 2026 20:15:23 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 16 2026 15:00:43 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/server_WWebSso.mjs.html

@@ -140,6 +140,9 @@ import { defaultPasswordPolicy } from './defaultPasswordPolicy.mjs'
  * @param {Object} [optExt.regVerifyEmContent={}] 輸入註冊驗證信內容物件，逐語系鍵(eng、cht)各自給HTML字串或檔案路徑(檔案存在即讀檔作為內容)，支援{sender}、{name}與{verifyUrl}置換符，未給之語系採內建語系文字，預設{}
  * @param {Object} [optExt.resetPwEmTitle={}] 輸入重設密碼通知信標題物件，逐語系鍵(eng、cht)各自給文字或檔案路徑(檔案存在即讀檔作為文字)，未給之語系採內建語系文字，預設{}
  * @param {Object} [optExt.resetPwEmContent={}] 輸入重設密碼通知信內容物件，逐語系鍵(eng、cht)各自給HTML字串或檔案路徑(檔案存在即讀檔作為內容)，支援{sender}、{name}、{account}與{newPassword}置換符，未給之語系採內建語系文字，預設{}
+ * @param {Object} [optExt.userRegistrationVerifySuccess={}] 輸入註冊驗證結果頁「驗證成功」訊息物件，逐語系鍵(eng、cht)各自給文字或檔案路徑(檔案存在即讀檔作為文字)，代入verifyEmailResultContent之{message}，未給之語系採內建語系文字，預設{}
+ * @param {Object} [optExt.verifyEmailAlreadyVerified={}] 輸入註冊驗證結果頁「帳號已完成驗證」訊息物件，逐語系鍵(eng、cht)各自給文字或檔案路徑，代入{message}，未給之語系採內建語系文字，預設{}
+ * @param {Object} [optExt.verifyEmailInvalidToken={}] 輸入註冊驗證結果頁「驗證連結無效或已失效」訊息物件，逐語系鍵(eng、cht)各自給文字或檔案路徑，代入{message}，未給之語系採內建語系文字，預設{}
  * @param {String} [optExt.verifyEmailResultContent=''] 輸入註冊驗證結果頁HTML字串或檔案路徑(檔案存在即讀檔作為內容)，支援{title}與{message}置換符({message}依請求lang代入對應語系文字故單一模板即可)，未給採pathTemplate之verifyEmailResult.html(缺檔回退套件內建模板)，預設''
  * @returns {Object} 回傳物件，其內server為hapi伺服器實體，wsrv為w-converhp的伺服器事件物件，wsds為w-serv-webdata的伺服器事件物件，可監聽error事件
  */
@@ -459,13 +462,18 @@ function WWebSso(WOrm, url, db, pathSettings, optExt = {}) {
         return r
     }
 
-    //kpLangExtEmail, 信件文字 settings 鍵(逐語系物件), 為安裝方於設定檔客製信件之正式介面;
-    //讀到才逐語系覆寫 kpLang 內建同名鍵, 其後 kpLangExt 仍可全面覆寫(最終覆寫層, 供測試/CI)
+    //kpLangExtEmail, 後端專用文字之 settings 鍵(逐語系物件), 為安裝方於設定檔客製信件與註冊驗證結果頁文字之正式介面;
+    //讀到才逐語系覆寫 kpLang 內建同名鍵(未給之語系回退內建), 其後 kpLangExt 仍可全面覆寫(最終覆寫層, 整鍵取代, 供測試/CI)
     //chpwEmTitle/chpwEmContent: 變更密碼通知信({sender}/{name} 置換)
     //regVerifyEmTitle/regVerifyEmContent: 註冊驗證信({sender}/{name}/{verifyUrl} 置換)
     //resetPwEmTitle/resetPwEmContent: 重設密碼通知信({sender}/{name}/{account}/{newPassword} 置換)
+    //userRegistrationVerifySuccess/verifyEmailAlreadyVerified/verifyEmailInvalidToken: 註冊驗證結果頁(server-rendered)之三則訊息, 代入 verifyEmailResultContent 之 {message}
+    //  (2026-09-15 部署方需求: 訊息須點名部署系統, 不宜改內建預設; 沿用本機制得逐語系回退與檔案路徑支援, kpLangExt 雖亦可覆寫但為整鍵取代須兩語系皆給)
     let kpLangExtEmail = {}
-    let emTextKeys = ['chpwEmTitle', 'chpwEmContent', 'regVerifyEmTitle', 'regVerifyEmContent', 'resetPwEmTitle', 'resetPwEmContent']
+    let emTextKeys = [
+        'chpwEmTitle', 'chpwEmContent', 'regVerifyEmTitle', 'regVerifyEmContent', 'resetPwEmTitle', 'resetPwEmContent',
+        'userRegistrationVerifySuccess', 'verifyEmailAlreadyVerified', 'verifyEmailInvalidToken',
+    ]
     emTextKeys.forEach((k) => {
         let kp = getEmText(k)
         if (size(kp) > 0) {
@@ -476,7 +484,7 @@ function WWebSso(WOrm, url, db, pathSettings, optExt = {}) {
     //kpLang, 語系字典: 內建(procLang) → settings 信件文字鍵(逐語系覆寫) → kpLangExt(整鍵覆寫, 最終層)
     let kpLang = procLang({ kpLangExtEmail, kpLangExt, webName, webDescription })
 
-    //kpLangWeb, 傳送前端之語系字典: 剔除僅後端寄信使用之信件文字鍵(前端零使用, 避免外洩後端內部文字與增肥前端酬載)
+    //kpLangWeb, 傳送前端之語系字典: 剔除僅後端使用之文字鍵(信件文字與 server-rendered 結果頁訊息; 前端零使用, 避免外洩後端內部文字與增肥前端酬載)
     let kpLangWeb = {}
     Object.keys(kpLang).forEach((lang) => {
         let kp = { ...kpLang[lang] }
@@ -1436,7 +1444,7 @@ export default WWebSso
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Sep 14 2026 20:15:23 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 16 2026 15:00:43 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/src_components_Common_CheckYesNo.vue.html

@@ -182,7 +182,7 @@ export default {
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Sep 14 2026 20:15:23 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 16 2026 15:00:43 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/src_httpGetJson.mjs.html

@@ -98,7 +98,7 @@ export default httpGetJson
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Sep 14 2026 20:15:23 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 16 2026 15:00:43 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "w-web-sso",
-  "version": "1.0.76",
+  "version": "1.0.78",
   "main": "dist/w-web-sso.umd.js",
   "dependencies": {
     "json5": "^2.2.3",
-    "w-aggrid-vue": "^2.0.86",
+    "w-aggrid-vue": "^2.0.87",
     "w-component-vue": "^2.5.15",
     "w-data-collector": "^1.0.37",
     "w-echarts-vue": "^1.0.11",

package/server/WWebSso.mjs

@@ -93,6 +93,9 @@ import { defaultPasswordPolicy } from './defaultPasswordPolicy.mjs'
  * @param {Object} [optExt.regVerifyEmContent={}] 輸入註冊驗證信內容物件，逐語系鍵(eng、cht)各自給HTML字串或檔案路徑(檔案存在即讀檔作為內容)，支援{sender}、{name}與{verifyUrl}置換符，未給之語系採內建語系文字，預設{}
  * @param {Object} [optExt.resetPwEmTitle={}] 輸入重設密碼通知信標題物件，逐語系鍵(eng、cht)各自給文字或檔案路徑(檔案存在即讀檔作為文字)，未給之語系採內建語系文字，預設{}
  * @param {Object} [optExt.resetPwEmContent={}] 輸入重設密碼通知信內容物件，逐語系鍵(eng、cht)各自給HTML字串或檔案路徑(檔案存在即讀檔作為內容)，支援{sender}、{name}、{account}與{newPassword}置換符，未給之語系採內建語系文字，預設{}
+ * @param {Object} [optExt.userRegistrationVerifySuccess={}] 輸入註冊驗證結果頁「驗證成功」訊息物件，逐語系鍵(eng、cht)各自給文字或檔案路徑(檔案存在即讀檔作為文字)，代入verifyEmailResultContent之{message}，未給之語系採內建語系文字，預設{}
+ * @param {Object} [optExt.verifyEmailAlreadyVerified={}] 輸入註冊驗證結果頁「帳號已完成驗證」訊息物件，逐語系鍵(eng、cht)各自給文字或檔案路徑，代入{message}，未給之語系採內建語系文字，預設{}
+ * @param {Object} [optExt.verifyEmailInvalidToken={}] 輸入註冊驗證結果頁「驗證連結無效或已失效」訊息物件，逐語系鍵(eng、cht)各自給文字或檔案路徑，代入{message}，未給之語系採內建語系文字，預設{}
  * @param {String} [optExt.verifyEmailResultContent=''] 輸入註冊驗證結果頁HTML字串或檔案路徑(檔案存在即讀檔作為內容)，支援{title}與{message}置換符({message}依請求lang代入對應語系文字故單一模板即可)，未給採pathTemplate之verifyEmailResult.html(缺檔回退套件內建模板)，預設''
  * @returns {Object} 回傳物件，其內server為hapi伺服器實體，wsrv為w-converhp的伺服器事件物件，wsds為w-serv-webdata的伺服器事件物件，可監聽error事件
  */
@@ -412,13 +415,18 @@ function WWebSso(WOrm, url, db, pathSettings, optExt = {}) {
         return r
     }
 
-    //kpLangExtEmail, 信件文字 settings 鍵(逐語系物件), 為安裝方於設定檔客製信件之正式介面;
-    //讀到才逐語系覆寫 kpLang 內建同名鍵, 其後 kpLangExt 仍可全面覆寫(最終覆寫層, 供測試/CI)
+    //kpLangExtEmail, 後端專用文字之 settings 鍵(逐語系物件), 為安裝方於設定檔客製信件與註冊驗證結果頁文字之正式介面;
+    //讀到才逐語系覆寫 kpLang 內建同名鍵(未給之語系回退內建), 其後 kpLangExt 仍可全面覆寫(最終覆寫層, 整鍵取代, 供測試/CI)
     //chpwEmTitle/chpwEmContent: 變更密碼通知信({sender}/{name} 置換)
     //regVerifyEmTitle/regVerifyEmContent: 註冊驗證信({sender}/{name}/{verifyUrl} 置換)
     //resetPwEmTitle/resetPwEmContent: 重設密碼通知信({sender}/{name}/{account}/{newPassword} 置換)
+    //userRegistrationVerifySuccess/verifyEmailAlreadyVerified/verifyEmailInvalidToken: 註冊驗證結果頁(server-rendered)之三則訊息, 代入 verifyEmailResultContent 之 {message}
+    //  (2026-09-15 部署方需求: 訊息須點名部署系統, 不宜改內建預設; 沿用本機制得逐語系回退與檔案路徑支援, kpLangExt 雖亦可覆寫但為整鍵取代須兩語系皆給)
     let kpLangExtEmail = {}
-    let emTextKeys = ['chpwEmTitle', 'chpwEmContent', 'regVerifyEmTitle', 'regVerifyEmContent', 'resetPwEmTitle', 'resetPwEmContent']
+    let emTextKeys = [
+        'chpwEmTitle', 'chpwEmContent', 'regVerifyEmTitle', 'regVerifyEmContent', 'resetPwEmTitle', 'resetPwEmContent',
+        'userRegistrationVerifySuccess', 'verifyEmailAlreadyVerified', 'verifyEmailInvalidToken',
+    ]
     emTextKeys.forEach((k) => {
         let kp = getEmText(k)
         if (size(kp) > 0) {
@@ -429,7 +437,7 @@ function WWebSso(WOrm, url, db, pathSettings, optExt = {}) {
     //kpLang, 語系字典: 內建(procLang) → settings 信件文字鍵(逐語系覆寫) → kpLangExt(整鍵覆寫, 最終層)
     let kpLang = procLang({ kpLangExtEmail, kpLangExt, webName, webDescription })
 
-    //kpLangWeb, 傳送前端之語系字典: 剔除僅後端寄信使用之信件文字鍵(前端零使用, 避免外洩後端內部文字與增肥前端酬載)
+    //kpLangWeb, 傳送前端之語系字典: 剔除僅後端使用之文字鍵(信件文字與 server-rendered 結果頁訊息; 前端零使用, 避免外洩後端內部文字與增肥前端酬載)
     let kpLangWeb = {}
     Object.keys(kpLang).forEach((lang) => {
         let kp = { ...kpLang[lang] }

package/settings.json

@@ -80,6 +80,19 @@
         eng: 'Dear {name},<br><br>The administrator has reset the password for your {sender} account.<br><br>Account: {account}<br>New password: <strong>{newPassword}</strong><br><br>Please log in with this password and immediately set your own new password upon login.<br><br>If you did not expect this change, please contact the administrator.<br><br>This is an automated notification.',
         cht: '使用者 {name} 您好：<br><br>管理員已重設您於「{sender}」的密碼。<br><br>帳號：{account}<br>新密碼：<strong>{newPassword}</strong><br><br>請以此密碼登入後，立即變更為您自己的新密碼。<br><br>若非您預期之操作，請聯繫管理員。<br><br>此為系統自動通知信件。',
     },
+    //註冊驗證結果頁之三則訊息(逐語系, 代入結果頁之 {message}), 各值可給文字或檔案路徑; 未給採內建語系文字. 部署方須點名系統時於此覆寫, 不改套件內建
+    userRegistrationVerifySuccess: { //驗證成功
+        eng: 'Email verified successfully. Please log in.',
+        cht: '電子郵件驗證成功，請登入。',
+    },
+    verifyEmailAlreadyVerified: { //帳號已完成驗證(重複點驗證連結)
+        eng: 'This account has already been verified.',
+        cht: '此帳號已完成驗證。',
+    },
+    verifyEmailInvalidToken: { //驗證連結無效或已失效
+        eng: 'Invalid or expired verification link.',
+        cht: '驗證連結無效或已失效。',
+    },
     //驗證結果頁, 可給HTML文字或檔案路徑(支援 {title}/{message} 置換); 未給採 pathTemplate 之 verifyEmailResult.html(缺檔回退套件內建)
     verifyEmailResultContent: '',
     pathTemplate: '', //自訂結果頁模板資料夾, 內放 verifyEmailResult.html 即覆寫內建