Adding usage example with Knex SQL query builder

https://knexjs.org/

Author: gionatamettifogo

examples/with-javascript-express/package-lock.json

@@ -10,6 +10,6 @@
     "dotenv": "^16.3.1",
     "express": "^4.18.2",
     "http-errors": "^2.0.0",
-    "sqlitecloud-js": "^0.0.20-beta"
+    "sqlitecloud-js": "^0.0.25"
   }
 }

examples/with-javascript-express/package.json

@@ -0,0 +1,36 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+.yarn/install-state.gz
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env*.local
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

examples/with-typescript-knex/.gitignore

@@ -0,0 +1,5 @@
+## Getting Started
+
+This example shows how you can use sqlitecloud-js with [Knex](https://knexjs.org/), a SQL query builder for Javascript.
+
+You can launch example.ts from VS Code "Run and Debug" menu.

examples/with-typescript-knex/README.md

@@ -0,0 +1,36 @@
+//
+// Using sqlitecloud drivers with knex
+//
+
+import { knex } from 'knex'
+
+const Client_SQLite3 = require('knex/lib/dialects/sqlite3')
+
+// client will have sqlite3 dialect, but will use sqlitecloud-js driver
+class Client_Libsql extends Client_SQLite3 {
+  _driver() {
+    return require('sqlitecloud-js')
+  }
+}
+
+console.assert(process.env.CHINOOK_DATABASE_URL, 'Define CHINOOK_URL environment variable')
+
+// create knex instance with sqlitecloud-js driver
+// database url is passed as filename parameter
+const db = knex({
+  client: Client_Libsql as any,
+  connection: {
+    filename: process.env.CHINOOK_DATABASE_URL as string
+  }
+})
+
+db.raw('select * from customers')
+  .then(result => {
+    console.log(`Connected to database via knex and received ${result.length} rows`)
+    console.log(JSON.stringify(result, null, 2))
+    db.destroy()
+  })
+  .catch(err => {
+    console.error(err)
+    db.destroy()
+  })

examples/with-typescript-knex/example.ts

@@ -0,0 +1,4 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {}
+
+module.exports = nextConfig