@cloud-cli/d0 1.0.0

package/README.md

@@ -0,0 +1,32 @@
+# d0
+
+SQLite server over HTTP
+
+## Usage
+
+**POST /query**
+
+Run a prepared SQLite statement.
+Send a JSON with two properties: `s` for statement and `d` for data (optional)
+
+```js
+// using fetch
+fetch('https://db.example.com/query', {
+  body: JSON.stringify({
+    s: 'SELECT * FROM user WHERE id = ?',
+    d: [123]
+  });
+});
+
+// using the server-provided library
+import db from 'https://db.example.com/index.mjs';
+
+const user = await db.query('SELECT * FROM user WHERE id = ?', [123]);
+```
+
+## Environment variables
+
+| Variable       | Description                                       |
+|-|-|
+| PORT           | HTTP port                                         |
+| SQLITE_DB_PATH | Path to file where the database files are stored  |

package/client.mjs

@@ -0,0 +1,18 @@
+const baseURL = 'https://__API_URL__';
+
+export default {
+  async query(statement, data) {
+    const req = await fetch(new URL('/query', baseURL), {
+      body: JSON.stringify({
+        s: statement,
+        d: data || null,
+      }),
+    });
+
+    if (req.ok) {
+      return await req.json();
+    }
+
+    throw new Error(await req.text());
+  },
+};

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="node" />
+import { IncomingMessage, ServerResponse } from 'node:http';
+import { Database } from 'better-sqlite3';
+export declare function getDatabase(): Database;
+export declare function serve(): import("http").Server<typeof IncomingMessage, typeof ServerResponse>;

package/dist/index.js

@@ -0,0 +1,68 @@
+import { createServer } from 'node:http';
+import { readFile } from 'node:fs/promises';
+import SQLite from 'better-sqlite3';
+export function getDatabase() {
+    const db = new SQLite(process.env.SQLITE_DB_PATH || './db.sqlite3');
+    db.pragma('journal_mode = WAL');
+    return db;
+}
+export function serve() {
+    const db = getDatabase();
+    const server = createServer((request, response) => {
+        const url = new URL(request.url, 'http://localhost');
+        const route = `${request.method} ${url.pathname}`.trim();
+        const args = Object.fromEntries(url.searchParams.entries());
+        const q = { db, request, response, args };
+        switch (route) {
+            case 'GET /index.mjs':
+                return onEsModule(q);
+            case 'POST /query':
+                return onQuery(q);
+            default:
+                response.writeHead(404).end();
+        }
+    });
+    server.listen(process.env.PORT);
+    return server;
+}
+async function onQuery({ db, request, response }) {
+    const query = await readStream(request);
+    if (!query.length) {
+        response.writeHead(400).end();
+        return;
+    }
+    try {
+        const { s, d } = JSON.parse(query);
+        const result = db.prepare(s).run(d);
+        response.end(JSON.stringify(result));
+    }
+    catch (error) {
+        process.env.DEBUG && console.error(error);
+        response.writeHead(400).end(String(error));
+    }
+}
+let file;
+async function getFile() {
+    if (!file) {
+        file = await readFile('./client.mjs', 'utf8');
+    }
+    return file;
+}
+async function onEsModule({ request, response }) {
+    const hostname = request.headers['x-forwarded-for'];
+    const code = await getFile();
+    response
+        .writeHead(200, {
+        'Content-Type': 'text/javascript',
+        'Access-Control-Allow-Origin': '*',
+    })
+        .end(code.replace('__API_URL__', hostname));
+}
+function readStream(stream) {
+    return new Promise((resolve, reject) => {
+        const all = [];
+        stream.on('data', (c) => all.push(c));
+        stream.on('end', () => resolve(Buffer.concat(all).toString('utf8')));
+        stream.on('error', reject);
+    });
+}

package/dist/serve.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/serve.js

@@ -0,0 +1,2 @@
+import { serve } from './index.js';
+serve();

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@cloud-cli/d0",
+  "version": "1.0.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "test": "echo true",
+    "start": "node dist/serve.js"
+  },
+  "prettier": "@cloud-cli/prettier-config",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cloud-cli/d0.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "better-sqlite3": "^8.2.0"
+  },
+  "devDependencies": {
+    "@cloud-cli/prettier-config": "^1.0.0",
+    "@cloud-cli/typescript-config": "^1.0.0",
+    "@types/better-sqlite3": "^7.6.3",
+    "@types/node": "^20.3.3",
+    "typescript": "^5.4.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,90 @@
+import { createServer, IncomingMessage, ServerResponse } from 'node:http';
+import { readFile } from 'node:fs/promises';
+import SQLite, { Database } from 'better-sqlite3';
+
+type Q = {
+  db: Database;
+  request: IncomingMessage;
+  response: ServerResponse;
+  args: Record<string, string>;
+};
+
+export function getDatabase(): Database {
+  const db = new SQLite(process.env.SQLITE_DB_PATH || './db.sqlite3');
+  db.pragma('journal_mode = WAL');
+  return db;
+}
+
+export function serve() {
+  const db = getDatabase();
+
+  const server = createServer((request, response) => {
+    const url = new URL(request.url, 'http://localhost');
+    const route = `${request.method} ${url.pathname}`.trim();
+    const args = Object.fromEntries(url.searchParams.entries()) as Q['args'];
+    const q: Q = { db, request, response, args };
+
+    switch (route) {
+      case 'GET /index.mjs':
+        return onEsModule(q);
+
+      case 'POST /query':
+        return onQuery(q);
+
+      default:
+        response.writeHead(404).end();
+    }
+  });
+
+  server.listen(process.env.PORT);
+
+  return server;
+}
+
+async function onQuery({ db, request, response }: Q) {
+  const query = await readStream(request);
+
+  if (!query.length) {
+    response.writeHead(400).end();
+    return;
+  }
+
+  try {
+    const { s, d } = JSON.parse(query);
+    const result = db.prepare(s).run(d);
+    response.end(JSON.stringify(result));
+  } catch (error) {
+    process.env.DEBUG && console.error(error);
+    response.writeHead(400).end(String(error));
+  }
+}
+
+let file;
+async function getFile() {
+  if (!file) {
+    file = await readFile('./client.mjs', 'utf8');
+  }
+
+  return file;
+}
+
+async function onEsModule({ request, response }: Q) {
+  const hostname = request.headers['x-forwarded-for'];
+  const code = await getFile();
+
+  response
+    .writeHead(200, {
+      'Content-Type': 'text/javascript',
+      'Access-Control-Allow-Origin': '*',
+    })
+    .end(code.replace('__API_URL__', hostname));
+}
+
+function readStream(stream): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const all = [];
+    stream.on('data', (c) => all.push(c));
+    stream.on('end', () => resolve(Buffer.concat(all).toString('utf8')));
+    stream.on('error', reject);
+  });
+}

package/src/serve.ts

@@ -0,0 +1,2 @@
+import { serve } from './index.js';
+serve();