w-web-perm 1.1.11 → 1.1.13

package/src/js/externalRows.mjs

@@ -0,0 +1,266 @@
+//外部列受保護(F-23; R-PRINCIPLE-00 原則 5「開了外部同步就以外部為主」、原則 3; 規則帳本 R-EXT-OWN-01; ADR-037): 後台整表寫入對「外部列」之守門, 純函數(不依賴 Vue／DOM／ORM),
+//伺服端(server/procCore.mjs)為強制者, 前端(清單頁唯讀、複製、刪除過濾)共用同一份判定, 不各自重寫.
+//
+//判別(定案 D1): from 為非空字串者為「外部列」(外部同步 syncAndReplaceTabs 只收非空字串 from, 故非空 from 必曾由外部同步寫入或後台誤植);
+//from 為 ''、缺欄、或非字串(null／數字／布林)者為「後台列」——非字串 from 必為後台寫入(同步入口 isestr 把關), 遷移工具正規化為 ''(g_fixFromType.mjs), 後台寫入起拒收非字串 from.
+//Lv1 鎖定層級: 外部列之身分／結構欄(指派欄、順序、伺服器管理欄以外之全部欄位)後台不得改, 不得刪除, 不得改 from; 指派欄(users.cgrups／grups.cpemis／pemis.crules)後台可寫
+//  (改指派須附載入基準, 見 rowDigest.mjs; 無基準無從證明快照新舊, 依原則 3 收嚴拒收); 外部列之 order 由外部擁有(後台儲存不重編, 還原為庫內值).
+
+
+//SERVER_FIELDS: 伺服器管理欄(procOrm 寫入時覆寫), 不納入內容比對
+let SERVER_FIELDS = ['userId', 'timeCreate', 'userIdUpdate', 'timeUpdate']
+
+
+//ASSIGN_FIELD: 各表之授權指派欄(後台可寫); targets 無指派欄
+let ASSIGN_FIELD = { users: 'cgrups', grups: 'cpemis', pemis: 'crules', targets: null }
+
+
+let isStr = (v) => typeof v === 'string'
+let hasOwn = (o, k) => Object.prototype.hasOwnProperty.call(o, k)
+let isObj = (v) => v !== null && typeof v === 'object'
+
+
+//normV: 比對用正規化(缺欄與 '' 視為同一; 其餘以 JSON 字串比對, 值為資料庫與前端同源之純量／字串)
+let normV = (v) => JSON.stringify(v === undefined ? '' : v)
+
+
+/**
+ * 判斷是否為外部列(from 為非空字串)
+ *
+ * @param {Object} row 輸入列物件
+ * @returns {Boolean} 回傳是否為外部列
+ * @example
+ *
+ * isExternalRow({ id: '1', from: 'pd' })
+ * // => true
+ * isExternalRow({ id: '1', from: '' })
+ * // => false
+ * isExternalRow({ id: '1', from: null })
+ * // => false
+ *
+ */
+function isExternalRow(row) {
+    return isObj(row) && isStr(row.from) && row.from !== ''
+}
+
+
+/**
+ * 取得外部列之鎖定欄位(身分／結構欄): schema 全部欄位扣除 id、from、order、指派欄、伺服器管理欄
+ *
+ * @param {String} keyTable 輸入表名(targets／pemis／grups／users)
+ * @param {Array} keys 輸入該表 schema 之欄位名陣列(ds[keyTable].keys)
+ * @returns {Array} 回傳鎖定欄位名陣列
+ */
+function getLockFields(keyTable, keys) {
+    let ka = hasOwn(ASSIGN_FIELD, keyTable) ? ASSIGN_FIELD[keyTable] : null
+    return (Array.isArray(keys) ? keys : []).filter((k) => k !== 'id' && k !== 'from' && k !== 'order' && k !== ka && SERVER_FIELDS.indexOf(k) < 0)
+}
+
+
+/**
+ * 外部列之 order 由外部擁有: 把送入列中「庫內為外部列者」之 order 還原為庫內值(後台儲存重編 order=k+1 不得改外部列之順序), 回傳新陣列(不改輸入)
+ *
+ * @param {Array} rows 輸入送入之整表列(已重給 order)
+ * @param {Array} ltdtOld 輸入該表庫內全部列(select 結果)
+ * @returns {Array} 回傳 order 已還原之列陣列
+ */
+function restoreExternalOrder(rows, ltdtOld) {
+    let oldById = new Map()
+    ;(Array.isArray(ltdtOld) ? ltdtOld : []).forEach((o) => {
+        if (isObj(o) && isStr(o.id)) {
+            oldById.set(o.id, o)
+        }
+    })
+    return rows.map((row) => {
+        let o = isObj(row) && isStr(row.id) ? oldById.get(row.id) : undefined
+        if (o !== undefined && isExternalRow(o) && hasOwn(o, 'order')) {
+            return { ...row, order: o.order }
+        }
+        return row
+    })
+}
+
+
+/**
+ * 將「外部列且僅伺服器管理欄(建立者／時間、更新者／時間)不同」之 diff 列移入 same(視為無變更, 不寫入)
+ *
+ * 外部同步每次整來源重寫, 使外部列之 timeUpdate／timeCreate／userId 隨之更新; 持舊快照之後台存檔若原樣送回該列, 其內容與庫內相同而僅伺服器管理欄較舊,
+ * 寫入會把建立者與建立時間回退為舊值(D2 設計稿 S2). 內容相同即無須寫入. 只處理外部列, 後台列之 diff 判定不變.
+ *
+ * @param {Object} p 輸入參數物件
+ * @param {Array} p.keys 輸入該表 schema 欄位名陣列
+ * @param {Object} p.r 輸入 ltdtDiffByKey 結果 { add, del, diff, same }
+ * @param {Array} p.ltdtOld 輸入該表庫內全部列
+ * @returns {Object} 回傳新之 { add, del, diff, same }
+ */
+function dropServerOnlyDiff({ keys, r, ltdtOld }) {
+    let oldById = new Map()
+    ltdtOld.forEach((o) => {
+        if (isObj(o) && isStr(o.id)) {
+            oldById.set(o.id, o)
+        }
+    })
+    let fields = (Array.isArray(keys) ? keys : []).filter((k) => SERVER_FIELDS.indexOf(k) < 0)
+    let diff = []
+    let same = [...r.same]
+    r.diff.forEach((row) => {
+        let o = isObj(row) && isStr(row.id) ? oldById.get(row.id) : undefined
+        if (o !== undefined && isExternalRow(o) && fields.every((k) => normV(row[k]) === normV(o[k]))) {
+            same.push(row)
+        }
+        else {
+            diff.push(row)
+        }
+    })
+    return { add: r.add, del: r.del, diff, same }
+}
+
+
+/**
+ * 外部列之 diff 列(內容確有改動, 例如指派欄)改帶庫內之伺服器管理欄(userId／timeCreate／userIdUpdate／timeUpdate)
+ *
+ * 伺服器管理欄由伺服器擁有(procOrm save 只覆寫 userIdUpdate／timeUpdate, 建立者與建立時間取自送入之列); 外部同步每次整來源重寫使外部列之建立者／建立時間更新,
+ * 持舊草稿(前端保留未存編輯, 見 draftSync)送回該列時, 基準因排除伺服器管理欄而通過(內容未變), 若原樣寫入就把較新之建立者與建立時間回退為舊值(R-EXT-OWN-01 S2 之同一缺陷, 外審 sol 第 3 點).
+ * 故改動之外部列一律以庫內之伺服器管理欄寫入. 只處理庫內為外部列者(後台列之寫入不變); 庫內無該欄者不補.
+ *
+ * @param {Object} p 輸入參數物件
+ * @param {Object} p.r 輸入 ltdtDiffByKey(及 dropServerOnlyDiff)結果 { add, del, diff, same }
+ * @param {Array} p.ltdtOld 輸入該表庫內全部列
+ * @returns {Object} 回傳新之 { add, del, diff, same }(不改輸入; 未改動之列為同一物件)
+ */
+function restoreServerFields({ r, ltdtOld }) {
+    let oldById = new Map()
+    ltdtOld.forEach((o) => {
+        if (isObj(o) && isStr(o.id)) {
+            oldById.set(o.id, o)
+        }
+    })
+    let diff = r.diff.map((row) => {
+        let o = isObj(row) && isStr(row.id) ? oldById.get(row.id) : undefined
+        if (o === undefined || !isExternalRow(o)) {
+            return row
+        }
+        let out = { ...row }
+        SERVER_FIELDS.forEach((k) => {
+            if (hasOwn(o, k)) {
+                out[k] = o[k]
+            }
+        })
+        return out
+    })
+    return { add: r.add, del: r.del, diff, same: r.same }
+}
+
+
+/**
+ * 後台整表寫入對外部列之守門(於 ltdtDiffByKey 與 dropServerOnlyDiff 之後、寫入之前; 違規整次拒收、零寫入, 不靜默忽略)
+ *
+ * from 型別(不論 lockExternalRows): 新增列之 from 須為字串(缺欄視為 ''), 修改列之 from 若改為非字串須與庫內值相同(歷史 null 原樣送回不拒, 否則已有歷史資料之庫無法儲存);
+ * lockExternalRows 為真時另有: ①新增列之 from 須為 ''(含復活他來源之列、複製繼承、手打); ②不得刪除外部列; ③修改列: 外部列不得改 from 與鎖定欄位(getLockFields), 後台列不得改成非空 from.
+ * 指派欄與 order／伺服器管理欄不在比對內.
+ *
+ * @param {Object} p 輸入參數物件
+ * @param {String} p.keyTable 輸入表名
+ * @param {Array} p.keys 輸入該表 schema 欄位名陣列
+ * @param {Object} p.r 輸入 { add, del, diff, same }
+ * @param {Array} p.ltdtOld 輸入該表庫內全部列
+ * @param {Boolean} [p.lockExternalRows=true] 輸入是否啟用外部列保護, 預設 true
+ * @returns {Object|null} 回傳 null 為通過; 否則 { key, reason, k, n, froms }: key 為語系鍵(saveFromNotAllowed／saveExternalRowChanged), reason 為原因(fromType／addFrom／del／fromChanged／fieldChanged), k 為 r 內該陣列之第一個違規索引, n 為違規列數, froms 為涉及之來源(至多 5 個)
+ */
+function checkExternalWrite({ keyTable, keys, r, ltdtOld, lockExternalRows = true }) {
+    let oldById = new Map()
+    ltdtOld.forEach((o) => {
+        if (isObj(o) && isStr(o.id)) {
+            oldById.set(o.id, o)
+        }
+    })
+    let normFrom = (v) => (v === undefined ? '' : v)
+    let lockFields = getLockFields(keyTable, keys)
+
+    let bad = [] //{ key, reason, k, from }
+    let push = (key, reason, k, from) => {
+        bad.push({ key, reason, k, from: isStr(from) ? from : '' })
+    }
+
+    //add
+    r.add.forEach((row, k) => {
+        let f = isObj(row) ? normFrom(row.from) : ''
+        if (!isStr(f)) {
+            push('saveFromNotAllowed', 'fromType', k, '')
+        }
+        else if (lockExternalRows && f !== '') {
+            push('saveFromNotAllowed', 'addFrom', k, f)
+        }
+    })
+
+    //del
+    if (lockExternalRows) {
+        r.del.forEach((row, k) => {
+            if (isExternalRow(row)) {
+                push('saveExternalRowChanged', 'del', k, row.from)
+            }
+        })
+    }
+
+    //diff
+    r.diff.forEach((row, k) => {
+        let o = isObj(row) && isStr(row.id) ? oldById.get(row.id) : undefined
+        let nf = isObj(row) ? normFrom(row.from) : ''
+        let of = o === undefined ? '' : normFrom(o.from)
+        if (!isStr(nf) && nf !== of) {
+            push('saveFromNotAllowed', 'fromType', k, '')
+            return
+        }
+        if (!lockExternalRows || o === undefined) {
+            return
+        }
+        if (isExternalRow(o)) {
+            if (nf !== o.from) {
+                push('saveExternalRowChanged', 'fromChanged', k, o.from)
+            }
+            else if (lockFields.some((f) => normV(row[f]) !== normV(o[f]))) {
+                push('saveExternalRowChanged', 'fieldChanged', k, o.from)
+            }
+        }
+        else if (isStr(nf) && nf !== '') {
+            push('saveFromNotAllowed', 'fromChanged', k, nf)
+        }
+    })
+
+    if (bad.length === 0) {
+        return null
+    }
+    let froms = []
+    bad.forEach((b) => {
+        if (b.from !== '' && froms.indexOf(b.from) < 0 && froms.length < 5) {
+            froms.push(b.from)
+        }
+    })
+    return { key: bad[0].key, reason: bad[0].reason, k: bad[0].k, n: bad.length, froms }
+}
+
+
+/**
+ * 本次寫入是否修改了外部列之指派欄(須附載入基準, 見 rowDigest.mjs checkBaseline)
+ *
+ * @param {Object} p 輸入參數物件
+ * @param {Object} p.r 輸入 { add, del, diff, same }(經 dropServerOnlyDiff 後)
+ * @param {Array} p.ltdtOld 輸入該表庫內全部列
+ * @returns {Boolean} 回傳是否有外部列之 diff
+ */
+function hasExternalDiff({ r, ltdtOld }) {
+    let oldById = new Map()
+    ltdtOld.forEach((o) => {
+        if (isObj(o) && isStr(o.id)) {
+            oldById.set(o.id, o)
+        }
+    })
+    return r.diff.some((row) => {
+        let o = isObj(row) && isStr(row.id) ? oldById.get(row.id) : undefined
+        return o !== undefined && isExternalRow(o)
+    })
+}
+
+
+export { SERVER_FIELDS, ASSIGN_FIELD, isExternalRow, getLockFields, restoreExternalOrder, dropServerOnlyDiff, restoreServerFields, checkExternalWrite, hasExternalDiff }
+export default isExternalRow

package/src/js/externalUi.mjs

@@ -0,0 +1,158 @@
+import { isExternalRow, getLockFields } from './externalRows.mjs'
+
+
+//清單頁(標的／權限／群組／使用者)之外部列(from 為非空字串者)前端輔助純函數(F-23; R-PRINCIPLE-00 原則 3、5; 規則帳本 R-EXT-OWN-01; ADR-037): 不依賴 Vue／DOM／語系檔,
+//判別外部列一律經 externalRows.isExternalRow(單一擁有者, 本檔不另寫判準); 伺服端為強制者, 本檔只供畫面提示與送出前擋下(不取代伺服端守門).
+
+
+let isStr = (v) => typeof v === 'string'
+let isObj = (v) => v !== null && typeof v === 'object'
+
+
+//normV: 比對用正規化, 同 externalRows 之 checkExternalWrite(缺欄與 '' 視為同一; 其餘以 JSON 字串比對)
+let normV = (v) => JSON.stringify(v === undefined ? '' : v)
+
+
+/**
+ * 把範本之 {key} 代入(單趟掃描: 代入之值不再解析, 名稱可含 {n}、{from} 等字樣原樣顯示; 未給之佔位符原樣保留)
+ *
+ * 與 getAuthWarn.fmtWarn 同設計, 但佔位符不限定名單(如 {from}、{name}); 值一律轉字串, 不特殊處理 $ 字樣.
+ *
+ * @param {String} tpl 輸入範本
+ * @param {Object} [vars={}] 輸入 { 佔位符名: 值 }
+ * @returns {String} 回傳代入後之文字
+ * @example
+ *
+ * console.log(fmtVars('{from}: {n}', { from: 'teamA', n: 3 }))
+ * // => 'teamA: 3'
+ *
+ */
+function fmtVars(tpl, vars = {}) {
+    let kp = Object.create(null)
+    Object.keys(isObj(vars) ? vars : {}).forEach((k) => {
+        kp[k] = String(vars[k])
+    })
+    return String(tpl).replace(/\{(\w+)\}/g, (hit, k) => (k in kp ? kp[k] : hit))
+}
+
+
+/**
+ * 計算外部列(from 為非空字串者)之列數
+ *
+ * @param {Array} rows 輸入列陣列(非陣列視為空)
+ * @returns {Number} 回傳外部列數
+ */
+function countExternalRows(rows) {
+    if (!Array.isArray(rows)) {
+        return 0
+    }
+    return rows.filter((r) => isExternalRow(r)).length
+}
+
+
+/**
+ * 取出屬於某表之外部同步警示(getWebInfor().syncWarns: [{ keyTable, from, n, time }]; 外部同步疑似 id 重編)
+ *
+ * 只取 keyTable 與本頁表名相符、from 為非空字串、n 為正數者; 輸出為 { from, n }(次序同輸入); 非陣列或元素格式不符者略過.
+ *
+ * @param {Array} syncWarns 輸入 webInfor.syncWarns
+ * @param {String} keyTable 輸入本頁表名(targets／pemis／grups／users)
+ * @returns {Array} 回傳 [{ from, n }]
+ */
+function getSyncWarnLines(syncWarns, keyTable) {
+    let rs = []
+    if (!Array.isArray(syncWarns)) {
+        return rs
+    }
+    syncWarns.forEach((w) => {
+        if (isObj(w) && w.keyTable === keyTable && isStr(w.from) && w.from !== '' && typeof w.n === 'number' && w.n > 0) {
+            rs.push({ from: w.from, n: w.n })
+        }
+    })
+    return rs
+}
+
+
+/**
+ * 產生清單上方橫幅之各行: 外部列提示(啟用外部列保護且外部列數 > 0 才有)＋本表之外部同步警示(每個來源一行); 皆無則回空陣列(頁面不渲染任何節點)
+ *
+ * 外部列提示用語系鍵 externalRowsNotice(群組／權限／使用者: 身分欄唯讀、不可刪除、指派可改)或 externalRowsNoticeTarget(標的無指派欄); 警示用 syncWarnIdRenumber({from}、{n}).
+ *
+ * @param {Object} p 輸入參數物件
+ * @param {String} p.keyTable 輸入本頁表名
+ * @param {String} p.kind 輸入頁面種類: 'Target'(標的頁)或其他
+ * @param {Array} p.rows 輸入本頁之基準列(store 之該表列, 已儲存者; 外部列只可能由外部同步寫入)
+ * @param {Boolean} p.lock 輸入是否啟用外部列保護(webInfor.lockExternalRows === 'y')
+ * @param {Array} p.syncWarns 輸入 webInfor.syncWarns
+ * @param {Function} p.$t 輸入語系函數(key → 文字)
+ * @returns {Array} 回傳 [{ kind: 'ext'|'warn', text }]
+ */
+function getBannerLines({ keyTable, kind, rows, lock, syncWarns, $t }) {
+    let rs = []
+    let n = lock === true ? countExternalRows(rows) : 0
+    if (n > 0) {
+        rs.push({ kind: 'ext', text: fmtVars($t(kind === 'Target' ? 'externalRowsNoticeTarget' : 'externalRowsNotice'), { n }) })
+    }
+    getSyncWarnLines(syncWarns, keyTable).forEach((w) => {
+        rs.push({ kind: 'warn', text: fmtVars($t('syncWarnIdRenumber'), { from: w.from, n: w.n }) })
+    })
+    return rs
+}
+
+
+/**
+ * 把勾選列依外部列保護切成「可處理」與「被擋下」: 啟用外部列保護時外部列不得刪除(伺服端 saveExternalRowChanged), 先於前端過濾並計數供提示
+ *
+ * @param {Array} items 輸入勾選之項目(清單頁 vo.itemsCheck, 每項之 data 為該列資料)
+ * @param {Boolean} lock 輸入是否啟用外部列保護
+ * @returns {Object} 回傳 { rows, nBlocked }: rows 為可處理之項目(未啟用保護時為全部), nBlocked 為被擋下之外部列數
+ */
+function splitCheckedRows(items, lock) {
+    let all = Array.isArray(items) ? items : []
+    if (lock !== true) {
+        return { rows: all, nBlocked: 0 }
+    }
+    let rows = all.filter((v) => !isExternalRow(isObj(v) ? v.data : undefined))
+    return { rows, nBlocked: all.length - rows.length }
+}
+
+
+/**
+ * 送出前檢查: 外部列(以基準列判定)是否被改動身分／結構欄、from 或被刪除(含改 id 致原 id 消失)——清單頁以逐列唯讀與刪除過濾擋下, 但貼上(Ctrl+V)等路徑可繞過逐列唯讀,
+ * 故送出前再比對一次(判準同 externalRows.checkExternalWrite: 鎖定欄位＝getLockFields, 另含 from; 指派欄與 order／伺服器管理欄不比對), 有違規即不送出並提示(伺服端同樣整次拒收)
+ *
+ * @param {Object} p 輸入參數物件
+ * @param {String} p.keyTable 輸入表名(targets／pemis／grups／users)
+ * @param {Array} p.keys 輸入該表 schema 欄位名陣列(ds[keyTable].keys)
+ * @param {Array} p.rowsNew 輸入欲送出之整表(清單目前之列)
+ * @param {Array} p.rowsOld 輸入基準列(store 之該表列)
+ * @returns {Object|null} 回傳 null 為無違規; 否則 { n, froms }: n 為違規之外部列數, froms 為涉及之來源(至多 5 個)
+ */
+function getExternalEdits({ keyTable, keys, rowsNew, rowsOld }) {
+    let fields = [...getLockFields(keyTable, keys), 'from']
+    let newById = new Map()
+    ;(Array.isArray(rowsNew) ? rowsNew : []).forEach((r) => {
+        if (isObj(r) && (isStr(r.id) || (typeof r.id === 'number' && Number.isFinite(r.id)))) {
+            newById.set(String(r.id), r)
+        }
+    })
+    let n = 0
+    let froms = []
+    ;(Array.isArray(rowsOld) ? rowsOld : []).forEach((o) => {
+        if (!isExternalRow(o) || !isStr(o.id)) {
+            return
+        }
+        let r = newById.get(o.id)
+        if (r === undefined || fields.some((f) => normV(r[f]) !== normV(o[f]))) {
+            n++
+            if (froms.indexOf(o.from) < 0 && froms.length < 5) {
+                froms.push(o.from)
+            }
+        }
+    })
+    return n > 0 ? { n, froms } : null
+}
+
+
+export { fmtVars, countExternalRows, getSyncWarnLines, getBannerLines, splitCheckedRows, getExternalEdits }
+export default fmtVars

package/src/js/findRefRows.mjs

@@ -0,0 +1,35 @@
+/**
+ * 取得「名稱為 name」之表列(群組表／權限表), 授權引用(使用者 cgrups、群組 cpemis)以名稱字串查找實體之唯一判準,
+ * 伺服端權限評估(src/plugins/mShare.mjs 之 getUserRules)與頁面提示(src/js/getAuthWarn.mjs)共用(規則帳本 R-AUTH-REF-01)
+ *
+ * 比對為精確 ===(不做大小寫／空白正規化); 列無 name 欄(undefined)視為空字串 '', 與引用名稱 '' 相符(沿用修正前 lodash get(row, 'name', '') 之行為).
+ * 回傳全部符合之列(依表中順序): 0 筆＝引用查無實體(懸空), 1 筆＝正常, ≥ 2 筆＝歷史同名(僅外部同步可造成; 授權取各筆之交集, R-PRINCIPLE-00 d).
+ *
+ * @param {Array} rows 輸入表列陣列(非陣列視為空)
+ * @param {*} name 輸入引用之名稱(以 === 比對, 不做型別轉換: 名稱與列名同為數字時相符,與修正前 arrFinder 相同; 實務上表列名稱為字串, 非字串名稱之引用視為懸空並由 getAuthWarn 提示 noName)
+ * @returns {Array} 回傳符合之列陣列
+ * @example
+ *
+ * console.log(findRefRows([{ name: 'A' }, { name: 'B' }, { name: 'A' }], 'A').length)
+ * // => 2
+ * console.log(findRefRows([{ name: 'A' }], 'X').length)
+ * // => 0
+ *
+ */
+function findRefRows(rows, name) {
+    let rs = []
+    if (!Array.isArray(rows)) {
+        return rs
+    }
+    for (let k = 0; k < rows.length; k++) {
+        let r = rows[k]
+        let n = (r === null || r === undefined || r.name === undefined) ? '' : r.name
+        if (n === name) {
+            rs.push(r)
+        }
+    }
+    return rs
+}
+
+
+export default findRefRows

package/src/js/findTouchedDup.mjs

@@ -0,0 +1,78 @@
+//後台整表寫入之「本次造成或觸及之同名」判準, 單一擁有者(規則帳本 R-NAME-UNIQ-02、R-DUP-UI-01, ADR-034/035):
+//伺服端(server/keyCheck.mjs 轉出, procCore.mjs:updateTabItems 呼叫)與前端清單頁(LayoutContentGrups／Pemis／Users 之 errItemsByName／errItemsByEmail)共用同一份, 兩端判準一致.
+//純函數, 不依賴 node 專屬模組. 比對一律精確 ===; 以 Map 計, 免原型鍵名(constructor、__proto__)誤判(規則帳本 R-KEY-01).
+
+
+let isStr = (v) => typeof v === 'string'
+
+
+/**
+ * 後台整表寫入(procCore.updateTabItems)用: 回傳 rowsNew 中第一個「本次寫入造成或觸及」之同名列索引, 無則 -1
+ *
+ * 寫入後之名稱集合即送入之整表(後台整表寫入, 含他 from 之外部同步列). 名稱於 rowsNew 出現 ≥ 2 次者為重複; 其中
+ * 「庫內該名稱已有 ≥ 2 列, 且 rowsNew 中該名稱之每一列皆為庫內同 id 同名之既有列, 且筆數不多於庫內」為歷史既有重複原樣送回(與本次無關), 不算;
+ * 其餘(新增第三個同名列、他列改名併入、重複中一列改成已被他列使用之名、以新 id 取代)皆為本次造成或觸及.
+ * why: 歷史重複(僅外部同步可造成)不得使後台所有存檔失敗, 否則已有重複之庫無法在後台修復; 但本次不得再造出新的重複.
+ *
+ * @param {Array} rowsNew 送入之整表(已 ltdtmapping、id 數字轉字串)
+ * @param {Array} rowsOld 庫內現有全部列(select 結果)
+ * @param {String} key 欄位名(name)
+ * @returns {Number} 造成或觸及重複之列索引(該名稱各列中第一個不是「庫內同 id 同名之既有列」者; 歷史原樣之組跳過; 多組取索引最小者), 無為 -1
+ */
+function findTouchedDup(rowsNew, rowsOld, key) {
+    if (!Array.isArray(rowsNew)) {
+        return -1
+    }
+    //庫內: id → 名稱, 名稱 → 筆數
+    let nameOfId = new Map()
+    let cntOld = new Map()
+    for (let r of (Array.isArray(rowsOld) ? rowsOld : [])) {
+        if (r === null || typeof r !== 'object') {
+            continue
+        }
+        if (isStr(r.id) && isStr(r[key])) {
+            nameOfId.set(r.id, r[key])
+        }
+        if (isStr(r[key])) {
+            cntOld.set(r[key], (cntOld.get(r[key]) || 0) + 1)
+        }
+    }
+    //送入: 名稱 → 該名稱各列之索引
+    let kpIdx = new Map()
+    for (let k = 0; k < rowsNew.length; k++) {
+        let r = rowsNew[k]
+        let v = (r === null || typeof r !== 'object') ? undefined : r[key]
+        if (!isStr(v)) {
+            continue
+        }
+        if (!kpIdx.has(v)) {
+            kpIdx.set(v, [])
+        }
+        kpIdx.get(v).push(k)
+    }
+    let kBad = -1
+    for (let [name, idxs] of kpIdx) {
+        if (idxs.length < 2) {
+            continue
+        }
+        let legacy = (cntOld.get(name) || 0) >= 2 &&
+            idxs.length <= cntOld.get(name) &&
+            idxs.every((k) => {
+                let id = rowsNew[k].id
+                return isStr(id) && nameOfId.get(id) === name
+            }) &&
+            new Set(idxs.map((k) => rowsNew[k].id)).size === idxs.length //同一 id 重送不算兩列
+        if (!legacy) {
+            //回「造成或觸及」之列: 該名稱各列中第一個不是「庫內同 id 同名之既有列」者(新增、或由他名改入); 無(僅同 id 重送等)則回第二次出現者
+            let kTouch = idxs.find((k) => !(isStr(rowsNew[k].id) && nameOfId.get(rowsNew[k].id) === name))
+            let k = (kTouch === undefined) ? idxs[1] : kTouch
+            if (kBad < 0 || k < kBad) {
+                kBad = k
+            }
+        }
+    }
+    return kBad
+}
+
+
+export default findTouchedDup

package/src/js/fmtLossyMsg.mjs

@@ -0,0 +1,23 @@
+import joinNames from './joinNames.mjs'
+
+
+/**
+ * 把拒存訊息範本(authLossyBlocked)之 {names} 代入受影響之名稱
+ *
+ * 名稱為使用者／外部應用寫入之資料, 可含 $&、$$、$' 等字樣; 以 split／join 代入(不用 String.replace, 其替換字串中的 $ 樣式會被展開), 名稱原樣顯示.
+ *
+ * @param {String} tpl 輸入訊息範本, 含 {names}
+ * @param {Array} names 輸入受影響之名稱陣列(至多列出 5 個, 超過加省略號, 見 joinNames)
+ * @returns {String} 回傳代入後之訊息
+ * @example
+ *
+ * console.log(fmtLossyMsg('Not saved: {names}', ['a', '$&']))
+ * // => 'Not saved: a, $&'
+ *
+ */
+function fmtLossyMsg(tpl, names) {
+    return String(tpl).split('{names}').join(joinNames(names))
+}
+
+
+export default fmtLossyMsg