@carbonorm/carbonnode 1.3.0 → 1.4.1

package/README.md

@@ -1,10 +1,72 @@
-# 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. 
+![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 (Alpha Release)
 
+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.
 
+## Alpha Release
+
+This is an alpha release. The code is not yet ready for production. We are looking for feedback on the API and any bugs.
+Some features are not yet implemented. We are working on the documentation and will be adding more examples. Please 
+check out [any issue](https://github.com/CarbonORM/CarbonWordPress/issues) we have open and feel free to contribute.
+
+## 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.ts.handlebars](https://github.com/CarbonORM/CarbonNode/blob/main/scripts/assets/handlebars/C6.ts.handlebars)
+2) [Table.ts.handlebars](https://github.com/CarbonORM/CarbonNode/blob/main/scripts/assets/handlebars/Table.ts.handlebars)
+3) [Websocket.ts.handlebars](https://github.com/CarbonORM/CarbonNode/blob/main/scripts/assets/handlebars/WsLiveUpdates.ts.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.3.0",
+  "version": "1.4.1",
   "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/generateRestBindings.cjs

@@ -290,15 +290,15 @@ var tableData = parseSQLToTypeScript(sql);
 // write to file
 fs.writeFileSync(path.join(process.cwd(), 'C6MySqlDump.json'), JSON.stringify(tableData));
 // import this file  src/assets/handlebars/C6.tsx.handlebars for a mustache template
-var c6Template = fs.readFileSync(path.resolve(__dirname, 'assets/handlebars/C6.tsx.handlebars'), 'utf-8');
-fs.writeFileSync(path.join(MySQLDump.OUTPUT_DIR, 'C6.tsx'), Handlebars.compile(c6Template)(tableData));
-var wsLiveUpdatesTemplate = fs.readFileSync(path.resolve(__dirname, 'assets/handlebars/WsLiveUpdates.tsx.handlebars'), 'utf-8');
-fs.writeFileSync(path.join(MySQLDump.OUTPUT_DIR, 'WsLiveUpdates.tsx'), Handlebars.compile(wsLiveUpdatesTemplate)(tableData));
-var template = fs.readFileSync(path.resolve(__dirname, 'assets/handlebars/Table.tsx.handlebars'), 'utf-8');
-var testTemplate = fs.readFileSync(path.resolve(__dirname, 'assets/handlebars/Table.test.tsx.handlebars'), 'utf-8');
+var c6Template = fs.readFileSync(path.resolve(__dirname, 'assets/handlebars/C6.ts.handlebars'), 'utf-8');
+fs.writeFileSync(path.join(MySQLDump.OUTPUT_DIR, 'C6.ts'), Handlebars.compile(c6Template)(tableData));
+var wsLiveUpdatesTemplate = fs.readFileSync(path.resolve(__dirname, 'assets/handlebars/WsLiveUpdates.ts.handlebars'), 'utf-8');
+fs.writeFileSync(path.join(MySQLDump.OUTPUT_DIR, 'WsLiveUpdates.ts'), Handlebars.compile(wsLiveUpdatesTemplate)(tableData));
+var template = fs.readFileSync(path.resolve(__dirname, 'assets/handlebars/Table.ts.handlebars'), 'utf-8');
+var testTemplate = fs.readFileSync(path.resolve(__dirname, 'assets/handlebars/Table.test.ts.handlebars'), 'utf-8');
 Object.values(tableData.TABLES).map(function (tableData, key) {
     var 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 + '.test.tsx'), Handlebars.compile(testTemplate)(tableData));
+    fs.writeFileSync(path.join(MySQLDump.OUTPUT_DIR, tableName + '.ts'), Handlebars.compile(template)(tableData));
+    fs.writeFileSync(path.join(MySQLDump.OUTPUT_DIR, tableName + '.test.ts'), Handlebars.compile(testTemplate)(tableData));
 });
 console.log('Successfully created CarbonORM bindings!');

package/scripts/generateRestBindings.ts

@@ -377,30 +377,27 @@ const tableData = parseSQLToTypeScript(sql);
 // write to file
 fs.writeFileSync(path.join(process.cwd(), 'C6MySqlDump.json'), JSON.stringify(tableData));
 
-
 // import this file  src/assets/handlebars/C6.tsx.handlebars for a mustache template
+const c6Template = fs.readFileSync(path.resolve(__dirname, 'assets/handlebars/C6.ts.handlebars'), 'utf-8');
 
-const c6Template = fs.readFileSync(path.resolve(__dirname, 'assets/handlebars/C6.tsx.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));
 
 })
 
 console.log('Successfully created CarbonORM bindings!')
-