w-serv-orm 1.0.0

package/src/getMapOrm.mjs

@@ -0,0 +1,298 @@
+import get from 'lodash/get'
+import each from 'lodash/each'
+import map from 'lodash/map'
+import size from 'lodash/size'
+import nowms2str from 'wsemi/src/nowms2str.mjs'
+import isarr from 'wsemi/src/isarr.mjs'
+import iseobj from 'wsemi/src/iseobj.mjs'
+import isestr from 'wsemi/src/isestr'
+
+
+let _ds = null
+let _woItems = null
+
+
+function adjustData(woName, userId, data, mode = 'save') { //mode: 'insert', 'save', 'insert+save'
+
+    //check
+    if (!iseobj(_ds)) {
+        throw new Error('invalid ds')
+    }
+
+    //keys
+    let keys = _ds[woName].keys
+
+    //one
+    let one = false
+    if (!isarr(data)) {
+        one = true
+        data = [data]
+    }
+
+    //t
+    let t = nowms2str()
+
+    //userId, timeCreate
+    if (mode.indexOf('insert') >= 0) {
+
+        //userId
+        if (keys.indexOf('userId') >= 0) {
+            each(data, (v, k) => {
+                data[k].userId = userId
+            })
+        }
+
+        //timeCreate
+        if (keys.indexOf('timeCreate') >= 0) {
+
+            each(data, (v, k) => {
+                data[k].timeCreate = t
+            })
+        }
+
+    }
+
+    //userIdUpdate, timeUpdate, 不能用else否則無法同時處理
+    if (mode.indexOf('insert') >= 0 || mode.indexOf('save') >= 0) {
+
+        //userIdUpdate
+        if (keys.indexOf('userIdUpdate') >= 0) {
+            each(data, (v, k) => {
+                data[k].userIdUpdate = userId
+            })
+        }
+
+        //timeUpdate
+        if (keys.indexOf('timeUpdate') >= 0) {
+            each(data, (v, k) => {
+                data[k].timeUpdate = t
+            })
+        }
+
+    }
+
+    //復原data型態, 若原本data為物件則取第0個回傳
+    data = one ? data[0] : data
+
+    return data
+}
+
+
+async function mapOrm(userId, woName, mode, input) {
+    //由woName自動綁定至woItems內的ORM物件
+    let err = null
+    let r
+
+    //check
+    if (!iseobj(_woItems)) {
+        return Promise.reject(`無有效woItems`)
+    }
+
+    //wo
+    let wo = get(_woItems, woName, null)
+
+    //check
+    if (wo === null) {
+        return Promise.reject(`ORM找不到表名稱: ${woName}`)
+    }
+
+    if (mode === 'select') {
+
+        //select
+        r = await wo.select(input)
+            .catch((msg) => {
+                console.log(`${woName}.select catch`, msg)
+                err = '取得資料失敗'
+            })
+
+        //check
+        if (isestr(err)) {
+            return Promise.reject(err)
+        }
+
+    }
+    else if (mode === 'insert' || mode === 'save') {
+
+        //adjustData
+        try {
+            input = adjustData(woName, userId, input, mode)
+        }
+        catch (e) {
+            console.log(`adjustData catch`, e.toString())
+            err = '調整資料失敗'
+            return Promise.reject(err)
+        }
+
+        //save
+        if (mode === 'insert') {
+            r = await wo.insert(input)
+                .catch((msg) => {
+                    console.log(`${woName}.save catch`, msg)
+                    err = '新增資料失敗'
+                })
+        }
+        else if (mode === 'save') {
+            r = await wo.save(input, { atomic: true })
+                .catch((msg) => {
+                    console.log(`${woName}.save catch`, msg)
+                    err = '儲存資料失敗'
+                })
+        }
+
+        //check
+        if (isestr(err)) {
+            return Promise.reject(err)
+        }
+
+        //僅回傳id避免大量數據時造成負擔
+        if (isarr(input)) {
+            r = map(input, (v) => {
+                return { id: v.id }
+            })
+        }
+        else {
+            r = { id: input.id }
+        }
+        //console.log(mode, ' r', r)
+
+    }
+    else if (mode === 'del') {
+
+        //del
+        r = await wo.del(input)
+            .catch((msg) => {
+                console.log(`${woName}.del catch`, msg)
+                err = '刪除資料失敗'
+            })
+
+    }
+    else if (mode === 'delAll') {
+
+        //delAll
+        r = await wo.delAll(input)
+            .catch((msg) => {
+                console.log(`${woName}.delAll catch`, msg)
+                err = '刪除資料失敗'
+            })
+
+    }
+    else if (mode === 'mix') {
+
+        //check
+        if (!iseobj(input)) {
+            return Promise.reject('mix僅支援輸入ltdtdiff結果物件')
+        }
+
+        //rt,r
+        let rt
+        r = [] //default to array
+
+        let add = get(input, 'add', [])
+        if (size(add) > 0) {
+
+            //adjustData
+            try {
+                add = adjustData(woName, userId, add, 'insert+save')
+            }
+            catch (e) {
+                console.log(`adjustData catch`, e.toString())
+                err = '調整資料失敗'
+                return Promise.reject(err)
+            }
+
+            //insert
+            await wo.insert(add)
+                .catch((msg) => {
+                    console.log(`${woName}.save catch`, msg)
+                    err = '新增資料失敗'
+                })
+
+            //check
+            if (isestr(err)) {
+                return Promise.reject(err)
+            }
+
+            //r
+            rt = map(add, (v) => {
+                return { id: v.id } //僅回傳id避免大量數據時造成負擔
+            })
+            r = [...r, ...rt]
+        }
+
+        let del = get(input, 'del', [])
+        if (size(del) > 0) {
+
+            //del
+            await wo.del(del)
+                .catch((msg) => {
+                    console.log(`${woName}.save catch`, msg)
+                    err = '刪除資料失敗'
+                })
+
+            //check
+            if (isestr(err)) {
+                return Promise.reject(err)
+            }
+
+            //r
+            rt = map(del, (v) => {
+                return { id: v.id } //僅回傳id避免大量數據時造成負擔
+            })
+            r = [...r, ...rt]
+        }
+
+        let diff = get(input, 'diff', [])
+        if (size(diff) > 0) {
+
+            //adjustData
+            try {
+                diff = adjustData(woName, userId, diff)
+            }
+            catch (e) {
+                console.log(`adjustData catch`, e.toString())
+                err = '調整資料失敗'
+                return Promise.reject(err)
+            }
+
+            //save
+            await wo.save(diff)
+                .catch((msg) => {
+                    console.log(`${woName}.save catch`, msg)
+                    err = '變更資料失敗'
+                })
+
+            //check
+            if (isestr(err)) {
+                return Promise.reject(err)
+            }
+
+            //r
+            rt = map(diff, (v) => {
+                return { id: v.id } //僅回傳id避免大量數據時造成負擔
+            })
+            r = [...r, ...rt]
+        }
+
+        //console.log('mix r', r)
+    }
+    else {
+        err = `invalid mode: ${mode}`
+    }
+
+    //check
+    if (isestr(err)) {
+        return Promise.reject(err)
+    }
+
+    return r
+}
+
+
+function getMapOrm(ds, woItems) {
+    _ds = ds
+    _woItems = woItems
+    return mapOrm
+}
+
+
+export default getMapOrm

package/src/getProc.mjs

@@ -0,0 +1,176 @@
+import get from 'lodash/get'
+import size from 'lodash/size'
+import filter from 'lodash/filter'
+import isarr from 'wsemi/src/isarr.mjs'
+import isestr from 'wsemi/src/isestr'
+import haskey from 'wsemi/src/haskey'
+import pmSeries from 'wsemi/src/pmSeries'
+import pmChain from 'wsemi/src/pmChain'
+import isfun from 'wsemi/src/isfun'
+import isbol from 'wsemi/src/isbol'
+
+
+let _funChecks = []
+let _funPreProcessing = []
+let _funPostProcessing = []
+let _mapOrm = null
+let _getUserById = null
+let bCheckUser = true
+let bExcludeWhenNotAdmin = true
+
+
+function addFunCheck(f) {
+    //由外部添加擴充檢查函數
+
+    setTimeout(() => { //因互相引用的關係會出現「Cannot access '_funChecks' before initialization」, 故通過timer脫勾成為動態引用, 避開執行mInitialTestData時會先編譯與偵測問題
+        _funChecks.push(f)
+    }, 1)
+
+}
+
+
+function addFunPreProcessing(f) {
+    //由外部添加擴充前處理函數
+
+    setTimeout(() => { //因互相引用的關係會出現「Cannot access '_funChecks' before initialization」, 故通過timer脫勾成為動態引用, 避開執行mInitialTestData時會先編譯與偵測問題
+        _funPreProcessing.push(f)
+    }, 1)
+
+}
+
+
+function addFunPostProcessing(f) {
+    //由外部添加擴充後置處理函數
+
+    setTimeout(() => { //因互相引用的關係會出現「Cannot access '_funChecks' before initialization」, 故通過timer脫勾成為動態引用, 避開執行mInitialTestData時會先編譯與偵測問題
+        _funPostProcessing.push(f)
+    }, 1)
+
+}
+
+
+async function procOrm(userId, woName, mode, input) {
+    //封裝mapOrm, 添加檢查userId功能
+
+    //check
+    if (!isfun(_mapOrm)) {
+        return Promise.reject(`invalid mapOrm`)
+    }
+
+    //check
+    if (!isestr(userId)) {
+        console.log(`找不到使用者主鍵: (${userId})`)
+        return Promise.reject(`找不到使用者主鍵`)
+    }
+
+    //isAdmin
+    let isAdmin = 'n'
+
+    //bCheckUser
+    if (bCheckUser) {
+
+        //check
+        if (!isfun(_getUserById)) {
+            return Promise.reject(`invalid getUserById`)
+        }
+
+        //oSelf
+        let oSelf = await _getUserById(userId)
+
+        //check
+        if (!oSelf) {
+            console.log(`找不到使用者資訊: (${userId})`)
+            return Promise.reject(`找不到使用者資訊`)
+        }
+
+        //isAdmin
+        isAdmin = get(oSelf, 'isAdmin')
+        if (isAdmin !== 'y' && isAdmin !== 'n') {
+            isAdmin = 'n'
+        }
+
+        //isActive
+        let isActive = get(oSelf, 'isActive')
+        if (isActive !== 'y' && isActive !== 'n') {
+            isActive = 'n'
+        }
+
+        //check
+        if (isActive !== 'y') {
+            console.log(`使用者被停權或無有效使用者資訊: (${userId})`)
+            return Promise.reject(`使用者被停權或無有效使用者資訊`)
+        }
+
+    }
+
+    //_funChecks, 擴充檢查, 提供給各 mOrm[OOO].mjs 檢查
+    await pmSeries(_funChecks, (v) => {
+        return v({ woName, userId, isAdmin, mode, input })
+    })
+
+    //_funPreProcessing, 擴充前處理input, 提供給各 mOrm[OOO].mjs 前處理
+    if (size(_funPreProcessing) > 0) {
+        let paramsIn = { woName, userId, isAdmin, mode, input } //將input與其他資訊一起封裝成params
+        let paramsOut = await pmChain(_funPreProcessing, paramsIn) //各非同步函數拿到輸入處理完皆輸出一樣結構數據params, 使各非同步函數都可拿到非input的重要資訊
+        input = paramsOut.input //由params提取input出來
+    }
+
+    //output
+    let output = await _mapOrm(userId, woName, mode, input)
+
+    //bExcludeWhenNotAdmin, 非管理者則要過濾掉已刪除之數據
+    if (bExcludeWhenNotAdmin && isAdmin === 'n') {
+        if (mode === 'select' && isarr(output)) { //有可能為錯誤物件
+            output = filter(output, (v) => {
+                if (haskey(v, 'isActive')) { //針對有isActive屬性
+                    return !(v.isActive === 'n') //過濾isActive='n'
+                }
+                return true
+            })
+        }
+    }
+
+    //_funPostProcessing, 擴充後處理output, 提供給各 mOrm[OOO].mjs 後處理
+    if (size(_funPostProcessing) > 0) {
+        output = await pmChain(_funPostProcessing, { woName, userId, isAdmin, mode, input, output })
+    }
+
+    return output
+}
+
+
+function getProc(mapOrm, opt = {}) {
+
+    //check
+    if (!isfun(mapOrm)) {
+        return Promise.reject(`invalid mapOrm`)
+    }
+
+    //save _mapOrm
+    _mapOrm = mapOrm
+
+    //save _getUserById, 不事先檢查, 因若bCheckUser=false可允許不給
+    _getUserById = get(opt, 'getUserById')
+
+    //bCheckUser
+    bCheckUser = get(opt, 'bCheckUser')
+    if (!isbol(bCheckUser)) {
+        bCheckUser = true
+    }
+
+    //bExcludeWhenNotAdmin
+    bExcludeWhenNotAdmin = get(opt, 'bExcludeWhenNotAdmin')
+    if (!isbol(bExcludeWhenNotAdmin)) {
+        bExcludeWhenNotAdmin = true
+    }
+
+    return {
+        addFunCheck,
+        addFunPreProcessing,
+        addFunPostProcessing,
+        procOrm,
+    }
+}
+
+
+export default getProc

package/src/getWoItems.mjs

@@ -0,0 +1,69 @@
+import get from 'lodash/get'
+import each from 'lodash/each'
+import keys from 'lodash/keys'
+import size from 'lodash/size'
+import isfun from 'wsemi/src/isfun'
+import iseobj from 'wsemi/src/iseobj'
+import isestr from 'wsemi/src/isestr'
+
+
+function getWoItems(ds, WOrm, opt = {}) {
+
+    //check ds
+    if (size(ds) === 0) {
+        console.log('ds', ds)
+        throw new Error('invalid ds')
+    }
+
+    //check WOrm
+    if (!isfun(WOrm)) {
+        console.log('WOrm', WOrm)
+        throw new Error('invalid WOrm')
+    }
+
+    //check opt
+    if (!iseobj(opt)) {
+        console.log('opt', opt)
+        throw new Error('invalid opt')
+    }
+
+    //url
+    let url = get(opt, 'url')
+    if (!isestr(url)) {
+        console.log('url', url)
+        throw new Error('invalid url')
+    }
+
+    //db
+    let db = get(opt, 'db')
+    if (!isestr(db)) {
+        console.log('db', db)
+        throw new Error('invalid db')
+    }
+
+    //woItems
+    let woItems = {}
+    each(keys(ds), (v) => {
+
+        //useOpt
+        let useOpt = { url, db, cl: v }
+
+        //wo
+        let wo = new WOrm(useOpt)
+
+        //save
+        woItems[v] = wo
+
+        // //change, 當數據有改變時清除快取
+        // wo.on('change', (mode) => {
+        //     //console.log(`${v} change`, mode)
+        //     cache.clear(`${v}.select`) //變更後會馬上重撈資料, 故需直接清除快取
+        // })
+
+    })
+
+    return woItems
+}
+
+
+export default getWoItems

package/test/all.test.mjs

@@ -0,0 +1,10 @@
+import assert from 'assert'
+
+
+describe('all', function() {
+
+    it('test in localhost', function() {
+        assert.strict.deepEqual(1, 1)
+    })
+
+})

package/toolg/addVersion.mjs

@@ -0,0 +1,4 @@
+import addVersion from 'w-package-tools/src/addVersion.mjs'
+
+
+addVersion()

package/toolg/cleanFolder.mjs

@@ -0,0 +1,4 @@
+import cleanFolder from 'w-package-tools/src/cleanFolder.mjs'
+
+
+cleanFolder('docs')

package/toolg/gDistRollup.mjs

@@ -0,0 +1,21 @@
+import rollupFiles from 'w-package-tools/src/rollupFiles.mjs'
+
+
+let fdSrc = './src'
+let fdTar = './dist'
+
+rollupFiles({
+    fns: ['WServOrm.mjs'],
+    fdSrc,
+    fdTar,
+    nameDistType: 'kebabCase',
+    globals: {
+        'path': 'path',
+        'fs': 'fs',
+    },
+    external: [
+        'path',
+        'fs',
+    ],
+})
+

package/toolg/modifyReadme.mjs

@@ -0,0 +1,4 @@
+import modifyReadme from 'w-package-tools/src/modifyReadme.mjs'
+
+
+modifyReadme()