implement jsonObject dialect (#101)

* implement jsonObject dialect

* fix lint errors

* validate json objects

* add before and after execute events

* update readme

* 2.9.0

.npmignore

@@ -10,6 +10,9 @@ jsconfig.json
 .gitpod.yml
 .gitpod.dockerfile
 
+# docs
+docs
+
 #github
 .github
 

README.md

@@ -6,7 +6,6 @@
 ![GitHub last commit](https://img.shields.io/github/last-commit/themost-framework/sqlite)
 ![GitHub Release Date](https://img.shields.io/github/release-date/themost-framework/sqlite)
 [![npm](https://img.shields.io/npm/dw/@themost/sqlite)](https://www.npmjs.com/package/@themost%2Fsqlite)
-![Snyk Vulnerabilities for npm package](https://img.shields.io/snyk/vulnerabilities/npm/@themost/sqlite)
 
 ![MOST Web Framework Logo](https://github.com/themost-framework/common/raw/master/docs/img/themost_framework_v3_128.png)
 
@@ -40,16 +39,32 @@ Register SQLite adapter on app.json as follows:
     ]
 }
 
+or create a new instance of `SqliteAdapter` class for connecting to SQLite database.
 
-#### Post Installation Note:
-SQLite Data Adapter comes with a regular expression extension for SQLite (regexp.c). You have to compile this extension as follows:
+```javascript
+const { SqliteAdapter } = require('@themost/sqlite');
+const { QueryExpression } = require('@themost/query');
+const db = new SqliteAdapter({
+    database: 'db/local.db'
+});
+const query = new QueryExpression()
+    .select(({ id, name, category, model, price }) => ({
+        id,
+        name,
+        category,
+        model,
+        price,
+    })).from('ProductData')
+    .where((x) => {
+        return x.price > 500 && x.category === "Laptops";
+    })
+    .orderByDescending((x) => x.price)
+    .take(10);
+```
 
-##### Using GCC/MinGW on Windows and Linux
-gcc -shared -fPIC -Isqlite3 -o regexp.0.dylib regexp.c
+Read more about [MOST Web Framework query language provided by @themost/query](https://github.com/themost-framework/query?#themostquery)
 
-##### Using GCC on Mac OSX
-gcc -dynamiclib -fPIC -Isqlite3 -o regexp.0.dylib regexp.c
+Use [query playground project at codesanbox.io](https://codesandbox.io/p/devbox/query-playground-zc8fg9) to learn more about the query language specification of [@themost-framework](https://github.com/themost-framework)
 
-##### Microsoft Tools on Windows
-cl /Gd regexp.c /I sqlite3 /DDLL /LD /link /export:sqlite3_extension_init /out:regexp.0.dylib
+![codesandbox.io_query-playground-1.png](docs/img/codesandbox.io_query-playground-1.png)
 

babel.config.js

@@ -9,4 +9,12 @@ module.exports = {
             }
         ]
     ],
+    plugins: [
+        [
+            '@babel/plugin-proposal-decorators',
+            {
+                'legacy': true
+            }
+        ]
+    ]
 };

jest.config.js

@@ -19,7 +19,7 @@ const config = {
   // clearMocks: false,
 
   // Indicates whether the coverage information should be collected while executing the test
-  // collectCoverage: false,
+  collectCoverage: true,
 
   // An array of glob patterns indicating a set of files for which coverage information should be collected
   // collectCoverageFrom: undefined,

jest.setup.js

@@ -1,3 +1,7 @@
-process.env.NODE_ENV='development';
+require('dotenv').config();
+const { JsonLogger } = require('@themost/json-logger');
+const { TraceUtils } = require('@themost/common');
+process.env.NODE_ENV = 'development';
+TraceUtils.useLogger(new JsonLogger());
 /* global jest */
 jest.setTimeout(30000);

jsconfig.json

@@ -1,6 +1,7 @@
 {
   "compilerOptions": {
     "baseUrl": ".",
+    "experimentalDecorators": true,
     "paths": {
       "@themost/sqlite": [
         "src/index"

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@themost/sqlite",
-  "version": "2.8.4",
+  "version": "2.9.0",
   "description": "MOST Web Framework SQLite Adapter",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -28,6 +28,7 @@
     "sqleanVersion": "0.27.1"
   },
   "dependencies": {
+    "@themost/events": "^1.5.0",
     "async": "^2.6.4",
     "sprintf-js": "^1.1.2",
     "sqlite3": "^5.1.7",
@@ -41,15 +42,16 @@
     "@babel/core": "^7.26.0",
     "@babel/eslint-parser": "^7.25.9",
     "@babel/eslint-plugin": "^7.25.1",
+    "@babel/plugin-proposal-decorators": "^7.25.9",
     "@babel/preset-env": "^7.26.0",
     "@babel/register": "^7.25.9",
     "@rollup/plugin-babel": "^5.3.1",
     "@rollup/plugin-commonjs": "^22.0.0",
     "@themost/common": "^2.11.0",
-    "@themost/data": "^2.14.2",
-    "@themost/events": "^1.3.0",
+    "@themost/data": "^2.18.1",
+    "@themost/json-logger": "^1.1.0",
     "@themost/peers": "^1.0.2",
-    "@themost/query": "^2.14.5",
+    "@themost/query": "^2.14.7",
     "@themost/xml": "^2.5.2",
     "@types/jasmine": "^5.1.4",
     "dotenv": "^16.0.0",

rollup.config.js

@@ -1,5 +1,4 @@
 import { babel } from '@rollup/plugin-babel';
-import commonjs from '@rollup/plugin-commonjs';
 import * as pkg from './package.json';
 import dts from 'rollup-plugin-dts';
 
@@ -13,7 +12,6 @@ export default [
         },
         external: Object.keys(pkg.dependencies).concat(Object.keys(pkg.peerDependencies)),
         plugins: [
-            commonjs(),
             babel({ babelHelpers: 'bundled' })
         ]
     },

spec/DateFunctions.spec.js

@@ -1,4 +1,5 @@
 import { TestApplication } from './TestApplication';
+import moment from 'moment';
 
 describe('DateFunctions', () => {
     /**
@@ -36,11 +37,13 @@ describe('DateFunctions', () => {
     it('should use getDay()', async () => {
         await app.executeInTestTranscaction(async (context) => {
             let items = await context.model('Order')
-                .asQueryable().where('orderDate').getDay().equal(15).silent().getItems();
+                .asQueryable().where('orderDate').getDate().getDay().equal(15).silent().take(10).getItems();
             expect(Array.isArray(items)).toBeTruthy();
             expect(items.length).toBeGreaterThan(0);
             for (const item of items) {
-                expect(item.orderDate.getDate()).toEqual(15);
+                const orderDate = item.orderDate;
+                const dayOfMonth = parseInt(moment.utc(orderDate).format('D'), 10);
+                expect(dayOfMonth).toEqual(15);
             }
         });
     });
@@ -52,7 +55,8 @@ describe('DateFunctions', () => {
             expect(Array.isArray(items)).toBeTruthy();
             expect(items.length).toBeGreaterThan(0);
             for (const item of items) {
-                expect(item.orderDate.getMonth()).toEqual(3);
+                const orderMonth = parseInt(moment.utc(item.orderDate).format('M'), 10);
+                expect(orderMonth).toEqual(4);
             }
         });
     });
@@ -77,7 +81,8 @@ describe('DateFunctions', () => {
             expect(Array.isArray(items)).toBeTruthy();
             expect(items.length).toBeGreaterThan(0);
             for (const item of items) {
-                expect(item.orderDate.getHours()).toEqual(14);
+                const hour = parseInt(moment.utc(item.orderDate).format('H'), 10);
+                expect(hour).toEqual(14);
             }
         });
     });