@carbonorm/carbonnode 1.2.18 → 1.4.0

package/README.md

@@ -1,10 +1,66 @@
+![npm](https://img.shields.io/npm/v/%40carbonorm%2Fcarbonnode)
+![License](https://img.shields.io/npm/l/%40carbonorm%2Fcarbonnode)
+![Size](https://img.shields.io/github/languages/code-size/carbonorm/carbonnode)
+![Documentation](https://img.shields.io/website?down_color=lightgrey&down_message=Offline&up_color=green&up_message=Online&url=https%3A%2F%2Fcarbonorm.dev)
+![Monthly Downloads](https://img.shields.io/npm/dm/%40carbonorm%2Fcarbonnode)
+![All Downloads](https://img.shields.io/npm/dt/%40carbonorm%2Fcarbonnode)
+![Star](https://img.shields.io/github/stars/carbonorm/carbonnode?style=social)
+
 # CarbonNode
-Initially this repository will host the node bindings for the Carbon API. 
-The Carbon API is a Cross Language ORM Syntax for querying SQL databases. 
-The Carbon Node is currently under development and is not yet ready for use. 
+
+CarbonNode is a part of the CarbonORM series. It is a NodeJS MySQL ORM that is designed to work with CarbonPHP. This langauge
+will implement the same ORM as CarbonPHP, but will be written in Typescript. Currently only C6 enabled request can be sent 
+using the bindings. Receiving API requests and handling it appropriately is not yet implemented. This is scheduled for 
+early 2023. This repository is in the early stages of development an any support is greatly appreciated.
+
+## Installation
+
+CarbonNode is available on [NPM](https://www.npmjs.com/). You'll need to have [NodeJS](https://nodejs.org/en/) installed 
+which comes prepackaged with npm (node package manager). 
+
+```bash
+npm install @carbonorm/carbonnode
+```
+
+## Generate Models
+
+The command below will generate the models for the database. The models will be generated in the output directory. We do
+recommend you keep this folder separate from other work. It is also best to track the output directory in your version 
+control system. All arguments are optional. If you do not provide them the defaults will be used. The example arguments
+below are the defaults.
+
+```bash
+npx generateRestBindings --user root --pass password --host 127.0.0.1 --port 3306 --dbname carbonPHP --prefix carbon_ --output /src/api/rest
+```
+
+You can view the [code generated](https://github.com/CarbonORM/CarbonORM.dev/blob/www/src/api/rest/Users.tsx) by 
+[this command](https://github.com/CarbonORM/CarbonNode/blob/main/scripts/generateRestBindings.ts) in 
+[this repository](git@github.com:CarbonORM/CarbonNode.git). We use [Handlebars templates](https://mustache.github.io/) 
+to generate the code.
+
+### Generated Tests
+
+Tests are generated for each table in the database. The tests are generated in the same directory as the models. 
+Our Jest tests are not designed to run immediately. You will need to edit the tests manually to change *xdescribe* with just
+*describe*. Once a test does not have xdescribe it will no longer be updated with new generation changes.
+
+Note - I prefer to keep tests nested in my IDE project viewer. See the documentation for 
+[IntelliJ](https://www.jetbrains.com/help/idea/file-nesting-dialog.html) or 
+[VSCode](https://code.visualstudio.com/updates/v1_67#_explorer-file-nesting).
+
+### Templates
+
+Three templates are used to generate the models. The output will be multiple files; two files for each table in the 
+database consisting of your GET PUT POST and DELETE methods and a Jest test file, a C6.tsx file which contains all 
+table information and TypeScript types, and finally a websocket file which contains references to methods that are 
+generate. Here are the templates used to generate the code:
+
+1) [C6.tsx.handlebars](https://github.com/CarbonORM/CarbonNode/blob/main/scripts/assets/handlebars/C6.tsx.handlebars)
+2) [Table.tsx.handlebars](https://github.com/CarbonORM/CarbonNode/blob/main/scripts/assets/handlebars/Table.tsx.handlebars)
+3) [Websocket.tsx.handlebars](https://github.com/CarbonORM/CarbonNode/blob/main/scripts/assets/handlebars/WsLiveUpdates.tsx.handlebars)
 
 
+# Support and Issues
 
+Any issues found should be reported on [GitHub](https://github.com/CarbonORM/CarbonNode/issues).
 
-## Links 
-https://saturncloud.io/blog/whats-the-difference-between-dependencies-devdependencies-and-peerdependencies-in-npm-packagejson-file/

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@carbonorm/carbonnode",
-  "version": "1.2.18",
+  "version": "1.4.0",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",
   "browser": "dist/index.umd.js",
   "types": "dist/index.d.ts",
   "type": "module",
+  "license": "MIT",
   "dependencies": {
     "axios": "^1.4.0",
     "qs": "^6.11.1",

package/scripts/assets/handlebars/{Table.test.tsx.handlebars → Table.test.ts.handlebars}

@@ -9,6 +9,8 @@ const randomString = Math.random().toString(36).substring(7);
 const randomInt = Math.floor(Math.random() * 1000000);
 const fillString = 'string' + randomString + randomInt;
 
+console.log('fillString', fillString);
+
 /**
 {{{TABLE_DEFINITION}}}
 **/

package/scripts/assets/handlebars/{Table.tsx.handlebars → Table.ts.handlebars}

@@ -25,7 +25,7 @@ type GetCustomAndRequiredFields = {}
 type GetRequestTableOverrides = {}
 
 // required parameters, optional parameters, parameter type overrides, response, and table names
-export const Get = restRequest<GetCustomAndRequiredFields, i{{TABLE_NAME_SHORT_PASCAL_CASE}}, GetRequestTableOverrides, iGetC6RestResponse<i{{TABLE_NAME_SHORT_PASCAL_CASE}}>, RestTableNames>({
+const Get = restRequest<GetCustomAndRequiredFields, i{{TABLE_NAME_SHORT_PASCAL_CASE}}, GetRequestTableOverrides, iGetC6RestResponse<i{{TABLE_NAME_SHORT_PASCAL_CASE}}>, RestTableNames>({
     C6: C6,
     tableName: {{TABLE_NAME_SHORT}}.TABLE_NAME,
     requestMethod: GET,
@@ -53,7 +53,7 @@ export function putState{{TABLE_NAME_SHORT_PASCAL_CASE}}(response : AxiosRespons
     ], "{{TABLE_NAME_SHORT}}", {{TABLE_NAME_SHORT}}.PRIMARY_SHORT as (keyof i{{TABLE_NAME_SHORT_PASCAL_CASE}})[])
 }
 
-export const Put = restRequest<PutCustomAndRequiredFields, i{{TABLE_NAME_SHORT_PASCAL_CASE}}, PutRequestTableOverrides, iPutC6RestResponse<i{{TABLE_NAME_SHORT_PASCAL_CASE}}>, RestTableNames>({
+const Put = restRequest<PutCustomAndRequiredFields, i{{TABLE_NAME_SHORT_PASCAL_CASE}}, PutRequestTableOverrides, iPutC6RestResponse<i{{TABLE_NAME_SHORT_PASCAL_CASE}}>, RestTableNames>({
     C6: C6,
     tableName: {{TABLE_NAME_SHORT}}.TABLE_NAME,
     requestMethod: PUT,
@@ -96,7 +96,7 @@ export function postState{{TABLE_NAME_SHORT_PASCAL_CASE}}(response : AxiosRespon
     )
 }
 
-export const Post = restRequest<PostCustomAndRequiredFields, i{{TABLE_NAME_SHORT_PASCAL_CASE}}, PostRequestTableOverrides, iPostC6RestResponse<i{{TABLE_NAME_SHORT_PASCAL_CASE}}>, RestTableNames>({
+const Post = restRequest<PostCustomAndRequiredFields, i{{TABLE_NAME_SHORT_PASCAL_CASE}}, PostRequestTableOverrides, iPostC6RestResponse<i{{TABLE_NAME_SHORT_PASCAL_CASE}}>, RestTableNames>({
     C6: C6,
     tableName: {{TABLE_NAME_SHORT}}.TABLE_NAME,
     requestMethod: POST,
@@ -118,7 +118,7 @@ export function deleteState{{TABLE_NAME_SHORT_PASCAL_CASE}}(_response : AxiosRes
     ], "{{TABLE_NAME_SHORT}}", {{TABLE_NAME_SHORT}}.PRIMARY_SHORT as (keyof i{{TABLE_NAME_SHORT_PASCAL_CASE}})[])
 }
 
-export const Delete = restRequest<DeleteCustomAndRequiredFields, i{{TABLE_NAME_SHORT_PASCAL_CASE}}, DeleteRequestTableOverrides, iDeleteC6RestResponse<i{{TABLE_NAME_SHORT_PASCAL_CASE}}>, RestTableNames>({
+const Delete = restRequest<DeleteCustomAndRequiredFields, i{{TABLE_NAME_SHORT_PASCAL_CASE}}, DeleteRequestTableOverrides, iDeleteC6RestResponse<i{{TABLE_NAME_SHORT_PASCAL_CASE}}>, RestTableNames>({
     C6: C6,
     tableName: {{TABLE_NAME_SHORT}}.TABLE_NAME,
     requestMethod: DELETE,

package/scripts/generateRestBindings.ts

@@ -380,25 +380,25 @@ fs.writeFileSync(path.join(process.cwd(), 'C6MySqlDump.json'), JSON.stringify(ta
 
 // import this file  src/assets/handlebars/C6.tsx.handlebars for a mustache template
 
-const c6Template = fs.readFileSync(path.resolve(__dirname, 'assets/handlebars/C6.tsx.handlebars'), 'utf-8');
+const c6Template = fs.readFileSync(path.resolve(__dirname, 'assets/handlebars/C6.ts.handlebars'), 'utf-8');
 
-fs.writeFileSync(path.join(MySQLDump.OUTPUT_DIR, 'C6.tsx'), Handlebars.compile(c6Template)(tableData));
+fs.writeFileSync(path.join(MySQLDump.OUTPUT_DIR, 'C6.ts'), Handlebars.compile(c6Template)(tableData));
 
-const wsLiveUpdatesTemplate = fs.readFileSync(path.resolve(__dirname, 'assets/handlebars/WsLiveUpdates.tsx.handlebars'), 'utf-8');
+const wsLiveUpdatesTemplate = fs.readFileSync(path.resolve(__dirname, 'assets/handlebars/WsLiveUpdates.ts.handlebars'), 'utf-8');
 
-fs.writeFileSync(path.join(MySQLDump.OUTPUT_DIR, 'WsLiveUpdates.tsx'), Handlebars.compile(wsLiveUpdatesTemplate)(tableData));
+fs.writeFileSync(path.join(MySQLDump.OUTPUT_DIR, 'WsLiveUpdates.ts'), Handlebars.compile(wsLiveUpdatesTemplate)(tableData));
 
-const template = fs.readFileSync(path.resolve(__dirname, 'assets/handlebars/Table.tsx.handlebars'), 'utf-8');
+const template = fs.readFileSync(path.resolve(__dirname, 'assets/handlebars/Table.ts.handlebars'), 'utf-8');
 
-const testTemplate = fs.readFileSync(path.resolve(__dirname, 'assets/handlebars/Table.test.tsx.handlebars'), 'utf-8');
+const testTemplate = fs.readFileSync(path.resolve(__dirname, 'assets/handlebars/Table.test.ts.handlebars'), 'utf-8');
 
 Object.values(tableData.TABLES).map((tableData, key) => {
 
     const tableName = tableData.TABLE_NAME_SHORT_PASCAL_CASE
 
-    fs.writeFileSync(path.join(MySQLDump.OUTPUT_DIR, tableName + '.tsx'), Handlebars.compile(template)(tableData));
+    fs.writeFileSync(path.join(MySQLDump.OUTPUT_DIR, tableName + '.ts'), Handlebars.compile(template)(tableData));
 
-    fs.writeFileSync(path.join(MySQLDump.OUTPUT_DIR, tableName + '.test.tsx'), Handlebars.compile(testTemplate)(tableData));
+    fs.writeFileSync(path.join(MySQLDump.OUTPUT_DIR, tableName + '.test.ts'), Handlebars.compile(testTemplate)(tableData));
 
 })