db-crud-api 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -16,4 +16,9 @@
 
     Bug fix:
         - deleteById function crash 
-        - new function return undefined
+        - new function return undefined
+        ## v0.1.5 (2024-03-03)
+## v0.1.6 (2024-03-03)
+
+    Bug fix:
+        - update function crash with date value

package/README.md

@@ -1,94 +1,97 @@
-# db-crud-api 💡
-    CRUD api for database tables.
-
-## Installation
-    npm install db-crud-api
-
-# Usage
-```javascript
-    import dbCrudApi from "db-crud-api";
-    const apiFactory = dbCrudApi(mySchema);
-
-    const mySchema = {
-        servers: {
-            server1: {
-                realName: "server1.mydomain.com",
-                type: "ms-sql",
-                instance: "DEFAULT",
-                user: "User1",
-                password: "mypassword",
-                options: {
-                    appName: "myAppName",
-                    ...
-                },
-                databases: {
-                    db1: {
-                        realName: "db_orders",
-                        tables: {
-                            table1: {
-                                realName: "tb_orders_head",
-                                idField: "Id",
-                                autoId: true,
-                                fields: {
-                                    Id: { realName: "OrderId", type: "uuid", lengh: undefined, canBeNull: false, description: "Unique Id", defaultValue: undefined },
-                                    CustomerId: { type: "string", lengh: undefined, canBeNull: false, description: "Customer Id", defaultValue: undefined },
-                                    ...
-                                }
-                            },
-                            table2: {
-                                realName: "tb_orders_detail",
-                                idField: "Id",
-                                autoId: true,
-                                fields: {
-                                    Id: { realName: "OrderId", type: "uuid", lengh: undefined, canBeNull: false, description: "Unique Id", defaultValue: undefined },
-                                    OrderId: { type: "uuid", lengh: undefined, canBeNull: false, description: "Order Id", defaultValue: undefined },
-                                    RowSeq: { type: "numeric", lengh: undefined, canBeNull: false, description: "Row sequence", defaultValue: undefined },
-                                    ...
-                                }
-                            },
-                            ...
-                        }
-                    },
-                    ...
-                }
-            },
-            ...
-        }
-    };
-
-    const apiOrder = apiFactory.newROApi("server1.db1.table1");  // Read Only api
-    const apiOrderDetail = apiFactory.newFullApi("table2"); // full CRUD api
-
-    console.log(await apiOrder.getById("xxxxx-xxxxx-xxxxxxxxxxxx-xxxxxx"));
-    console.log(await apiOrderDetail.getByFilter({get: {filters: ["OrderType in ('P', 'A')", "and", "OrderDate > '2022-12-01'"]}}));   // get filterd rows
-    console.log(await apiOrderDetail.getByFilter());   // this get all rows
-    console.log(await apiOrderDetail.patchById("xxxxx-xxxxx-xxxxxxxxxxxx-xxxxxx", {patch: {sets: {ItemRef: "2024-TX-0001", ItemDate: "2024-01-31"}}}));   // change some fields
-    console.log(await apiOrderDetail.patchByFilter({patch: {sets: {LastUpdate: "2023-04-30"}, filters: ["OrderId: 'xxxxx-xxxxx-xxxxxxxxxxxx-xxxxxx'"]}}));   // change by filter
-    console.log(await apiOrderDetail.deleteById("xxxxx-xxxxx-xxxxxxxxxxxx-xxxxxx"));   // delete row by Id
-    console.log(await apiOrderDetail.deleteByFilter({delete: {filters: ["ItemType in ('X', 'W')", "and", "ItemDate > '2022-12-01'"]}}));   // delete filterd rows
-```
-
-License
--------
-
-    MIT License
-
-    Copyright (c) 2022
-
-    Permission is hereby granted, free of charge, to any person obtaining a copy
-    of this software and associated documentation files (the "Software"), to deal
-    in the Software without restriction, including without limitation the rights
-    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-    copies of the Software, and to permit persons to whom the Software is
-    furnished to do so, subject to the following conditions:
-
-    The above copyright notice and this permission notice shall be included in all
-    copies or substantial portions of the Software.
-
-    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# db-crud-api 💡
+    CRUD api for database tables.
+
+## Installation
+    npm install db-crud-api
+
+# Usage
+```javascript
+    import dbCrudApi from "db-crud-api";
+    const apiFactory = dbCrudApi(mySchema);
+
+    const mySchema = {
+        servers: {
+            server1: {
+                realName: "server1.mydomain.com",
+                type: "ms-sql",
+                instance: "DEFAULT",
+                user: "User1",
+                password: "mypassword",
+                options: {
+                    appName: "myAppName",
+                    ...
+                },
+                databases: {
+                    db1: {
+                        realName: "db_orders",
+                        tables: {
+                            table1: {
+                                realName: "tb_orders_head",
+                                idField: "Id",
+                                autoId: true,
+                                fields: {
+                                    Id: { realName: "OrderId", type: "uuid", lengh: undefined, canBeNull: false, description: "Unique Id", defaultValue: undefined },
+                                    CustomerId: { type: "string", lengh: undefined, canBeNull: false, description: "Customer Id", defaultValue: undefined },
+                                    ...
+                                }
+                            },
+                            table2: {
+                                realName: "tb_orders_detail",
+                                idField: "Id",
+                                autoId: true,
+                                fields: {
+                                    Id: { realName: "OrderId", type: "uuid", lengh: undefined, canBeNull: false, description: "Unique Id", defaultValue: undefined },
+                                    OrderId: { type: "uuid", lengh: undefined, canBeNull: false, description: "Order Id", defaultValue: undefined },
+                                    RowSeq: { type: "numeric", lengh: undefined, canBeNull: false, description: "Row sequence", defaultValue: undefined },
+                                    ...
+                                }
+                            },
+                            ...
+                        }
+                    },
+                    ...
+                }
+            },
+            ...
+        }
+    };
+
+    const apiOrder = apiFactory.newROApi("server1.db1.table1");  // Read Only api
+    const apiOrderDetail = apiFactory.newFullApi("table2"); // full CRUD api
+    const apiExecuteSP = apiFactory.newExecuteApi("my_storeproc @Company, @OrderNumber"); // execute my_storeproc
+
+    console.log(await apiOrder.getById("xxxxx-xxxxx-xxxxxxxxxxxx-xxxxxx"));
+    console.log(await apiOrder.getByFilter({get: {filters: ["OrderType in ('P', 'A')", "and", "OrderDate > '2022-12-01'"]}}));   // get filterd rows
+    console.log(await apiOrder.getByFilter());   // this get all rows
+    console.log(await apiOrderDetail.patchById("xxxxx-xxxxx-xxxxxxxxxxxx-xxxxxx", {patch: {sets: {ItemRef: "2024-TX-0001", ItemDate: "2024-01-31"}}}));   // change some fields
+    console.log(await apiOrderDetail.patchByFilter({patch: {sets: {LastUpdate: "2023-04-30"}, filters: ["OrderId: 'xxxxx-xxxxx-xxxxxxxxxxxx-xxxxxx'"]}}));   // change by filter
+    console.log(await apiOrderDetail.deleteById("xxxxx-xxxxx-xxxxxxxxxxxx-xxxxxx"));   // delete row by Id
+    console.log(await apiOrderDetail.deleteByFilter({delete: {filters: ["ItemType in ('X', 'W')", "and", "ItemDate > '2022-12-01'"]}}));   // delete filterd rows
+    console.log(await apiOrderDetail.deleteByFilter({delete: {filters: ["ItemType in ('X', 'W')", "and", "ItemDate > '2022-12-01'"]}}));   // delete filterd rows
+    console.log(await apiExecuteSP.execute({params: {Company: "XXX", OrderNumber: "12345"}}}));   // execute 
+```
+
+License
+-------
+
+    MIT License
+
+    Copyright (c) 2022
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
     SOFTWARE.

package/index.js

@@ -1,11 +1,11 @@
-"use strict";
-
-import schema from "./lib/schema.js";
-import * as apiFactory from "./lib/api-factory.js";
-
-export default function(customSchema) {
-    if (customSchema && customSchema.servers) {
-        schema.servers = customSchema.servers;
-    }
-    return apiFactory;
+"use strict";
+
+import schema from "./lib/schema.js";
+import * as apiFactory from "./lib/api-factory.js";
+
+export default function(customSchema) {
+    if (customSchema && customSchema.servers) {
+        schema.servers = customSchema.servers;
+    }
+    return apiFactory;
 }

package/lib/api-execute.js

@@ -0,0 +1,25 @@
+'use strict';
+
+// Import modules
+import * as dbOpe from './db-operations.js';
+
+export default class apiExecute {
+
+    #schema;
+    #connection;
+
+    constructor(command) {
+        this.#schema = dbOpe.prepareSchema(command, "SP");
+        this.#connection = dbOpe.prepareConnection(this.#schema);
+    }
+
+    get schema() { return this.#schema; }
+    get connection() { return this.#connection; }
+
+    // Post (any operation like get/put/patch/delete...)
+    async execute(reqOpe) {
+        const _dbOpe = dbOpe.prepareRun(this.#schema, reqOpe);
+        return await dbOpe.runQuery(this.#connection, _dbOpe);
+    }
+
+}

package/lib/api-factory.js

@@ -1,21 +1,22 @@
-"use strict";
-
-import * as dbOpe from "./db-operations.js" 
-import apiFull from "./api-full.js"
-import apiRO from "./api-ro.js"
-
-export function newFullApi(tablePath) {
-    return new apiFull(tablePath);
-}
-
-export function newApi(tablePath) {
-    return newFullApi(tablePath);
-}
-
-export function newROApi(tablePath) {
-    return new apiRO(tablePath);
-}
-
-export function closeAllDbConnections() {
-    return dbOpe.closeAllConnections();
+"use strict";
+
+import * as dbOpe from "./db-operations.js" 
+import apiFull from "./api-full.js"
+import apiRO from "./api-ro.js"
+import apiExecute from "./api-execute.js"
+
+export function newFullApi(tablePath) {
+    return new apiFull(tablePath);
+}
+
+export function newROApi(tablePath) {
+    return new apiRO(tablePath);
+}
+
+export function newExecuteXApi(command) {
+    return new apiExecute(command);
+}
+
+export function closeAllDbConnections() {
+    return dbOpe.closeAllConnections();
 }

package/lib/api-full.js

@@ -18,14 +18,14 @@ export default class apiFull {
     get connection() { return this.#connection; }
 
     // Run query
-    async runOpe(_dbOpe) {
-        return await dbOpe.runQuery(this.#connection, _dbOpe);
-    }
+//    async runOpe(_dbOpe) {
+//        return await dbOpe.runQuery(this.#connection, _dbOpe);
+//    }
 
     // Get by id
     async getById(id, reqOpe) {
         const _dbOpe = dbOpe.prepareGetById(this.#schema, id, reqOpe);
-        const result = await this.runOpe(_dbOpe);
+        const result = await dbOpe.runQuery(this.#connection, _dbOpe);
         return Array.isArray(result) ? result[0] : result;
         
     }
@@ -33,19 +33,19 @@ export default class apiFull {
     // Get by filter
     async getByFilter(reqOpe) {
         const _dbOpe = dbOpe.prepareGet(this.#schema, reqOpe);
-        return await this.runOpe(_dbOpe);
+        return await dbOpe.runQuery(this.#connection, _dbOpe);
     }
 
     // Post by id (any operation like get/put/patch/delete...)
     async postById(id, reqOpe) {
         const _dbOpe = dbOpe.prepareRunById(this.#schema, id, reqOpe);
-        return await this.runOpe(_dbOpe);
+        return await dbOpe.runQuery(this.#connection, _dbOpe);
     }
 
     // Post (any operation like get/put/patch/delete...)
     async post(reqOpe) {
         const _dbOpe = dbOpe.prepareRun(this.#schema, reqOpe);
-        return await this.runOpe(_dbOpe);
+        return await dbOpe.runQuery(this.#connection, _dbOpe);
     }
 
     // Add item
@@ -57,14 +57,14 @@ export default class apiFull {
                     _dbOpe.put.sets[dbOpe.idField(this.#schema)] = uuidv4();  // automatic Id via uuidv4
                 }
         }
-        await this.runOpe(_dbOpe);
+        await dbOpe.runQuery(this.#connection, _dbOpe);
         return _dbOpe.put.sets;
     }
 
     // Add by Id
     async putById(id, reqOpe) {
         const _dbOpe = dbOpe.preparePutById(this.#schema, id, reqOpe);
-        await this.runOpe(_dbOpe);
+        await dbOpe.runQuery(this.#connection, _dbOpe);
         return _dbOpe.put.sets;
     }
 
@@ -78,25 +78,25 @@ export default class apiFull {
     // Delete by id
     async delById(id) {
         const _dbOpe = dbOpe.prepareDeleteById(this.#schema, id);
-        return await this.runOpe(_dbOpe);
+        return await dbOpe.runQuery(this.#connection, _dbOpe);
     }
 
     // Delete by filters
     async delByFilter(reqOpe) {
         const _dbOpe = dbOpe.prepareDelete(this.#schema, reqOpe);
-        return await this.runOpe(_dbOpe);
+        return await dbOpe.runQuery(this.#connection, _dbOpe);
     }
 
     // Patch (update) by id
     async patchById(id, reqOpe) {
         const _dbOpe = dbOpe.preparePatchById(this.#schema, id, reqOpe);
-        return await this.runOpe(_dbOpe);
+        return await dbOpe.runQuery(this.#connection, _dbOpe);
     }
 
     // Patch (update) by filters
     async patchByFilter(reqOpe) {
         const _dbOpe = dbOpe.preparePatch(this.#schema, reqOpe);
-        return await this.runOpe(_dbOpe);
+        return await dbOpe.runQuery(this.#connection, _dbOpe);
     }
 
 }

package/lib/api-ro.js

@@ -17,14 +17,14 @@ export default class apiRO {
     get connection() { return this.#connection; }
 
     // Run query
-    async runOpe(_dbOpe) {
-        return await dbOpe.runQuery(this.#connection, _dbOpe);
-    }
+//    async runOpe(_dbOpe) {
+//        return await dbOpe.runQuery(this.#connection, _dbOpe);
+//    }
 
     // Get by id
     async getById(id, reqOpe) {
         const _dbOpe = dbOpe.prepareGetById(this.#schema, id, reqOpe);
-        const result = await this.runOpe(_dbOpe);
+        const result = await dbOpe.runQuery(this.#connection, _dbOpe);
         return Array.isArray(result) ? result[0] : result;
         
     }
@@ -32,7 +32,7 @@ export default class apiRO {
     // Get by filter
     async getByFilter(reqOpe) {
         const _dbOpe = dbOpe.prepareGet(this.#schema, reqOpe);
-        return await this.runOpe(_dbOpe);
+        return await dbOpe.runQuery(this.#connection, _dbOpe);
     }
 
 }