Add Express server example and CLI serve command

Introduces a new Express server example with ObjectQL integration, including schema and configuration files. Adds a 'serve' command to the CLI for starting a development server with in-memory SQLite, updates dependencies, and registers the new command in the CLI entry point.

Author: hotlong

examples/express-server/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@example/express-server",
+  "version": "1.0.0",
+  "private": true,
+  "scripts": {
+    "build": "tsc && cp src/*.yml dist/ || true",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@objectql/core": "workspace:*",
+    "@objectql/server": "workspace:*",
+    "@objectql/types": "workspace:*",
+    "@objectql/driver-knex": "workspace:*",
+    "express": "^4.18.2",
+    "sqlite3": "^5.1.7"
+  },
+  "devDependencies": {
+     "@types/express": "^4.17.21",
+     "typescript": "^5.0.0"
+  }
+}

examples/express-server/src/index.ts

@@ -0,0 +1,46 @@
+import express from 'express';
+import { ObjectQL } from '@objectql/core';
+import { KnexDriver } from '@objectql/driver-knex';
+import { createNodeHandler } from '@objectql/server';
+import * as path from 'path';
+
+async function main() {
+    // 1. Init ObjectQL
+    const app = new ObjectQL({
+        datasources: {
+            default: new KnexDriver({
+                client: 'sqlite3',
+                connection: {
+                    filename: ':memory:'
+                },
+                useNullAsDefault: true
+            })
+        }
+    });
+
+    // 2. Register Schema
+    app.loadFromDirectory(path.join(__dirname));
+    await app.init();
+
+    // 3. Create Handler
+    const objectQLHandler = createNodeHandler(app);
+
+    // 4. Setup Express
+    const server = express();
+    const port = 3004;
+
+    // Optional: Parse JSON body globally (or strict to other routes)
+    // server.use(express.json()); 
+
+    // Mount ObjectQL handler
+    // Supports both /api/objectql (POST) or similar
+    server.all('/api/objectql', objectQLHandler);
+
+    server.listen(port, () => {
+        console.log(`Express app listening on port ${port}`);
+        console.log(`Test CURL:`);
+        console.log(`curl -X POST http://localhost:${port}/api/objectql -H "Content-Type: application/json" -d '{"op": "create", "object": "User", "args": { "data": { "name": "ExpressUser", "email": "express@example.com" }}}'`);
+    });
+}
+
+main().catch(console.error);

examples/express-server/src/user.object.yml

@@ -0,0 +1,6 @@
+name: User
+fields:
+  name:
+    type: string
+  email:
+    type: string

packages/cli/package.json

@@ -12,6 +12,9 @@
   "dependencies": {
     "@objectql/types": "workspace:*",
     "@objectql/core": "workspace:*",
+    "@objectql/server": "workspace:*",
+    "@objectql/driver-knex": "workspace:*",
+    "sqlite3": "^5.1.7",
     "commander": "^11.0.0",
     "chalk": "^4.1.2",
     "fast-glob": "^3.3.0",

packages/cli/src/commands/serve.ts

@@ -0,0 +1,48 @@
+import { ObjectQL } from '@objectql/core';
+import { KnexDriver } from '@objectql/driver-knex';
+import { createNodeHandler } from '@objectql/server';
+import { createServer } from 'http';
+import * as path from 'path';
+import chalk from 'chalk';
+
+export async function serve(options: { port: number; dir: string }) {
+    console.log(chalk.blue('Starting ObjectQL Dev Server...'));
+    
+    const rootDir = path.resolve(process.cwd(), options.dir);
+    console.log(chalk.gray(`Loading schema from: ${rootDir}`));
+
+    // 1. Init ObjectQL with in-memory SQLite for Dev
+    const app = new ObjectQL({
+        datasources: {
+            default: new KnexDriver({
+                client: 'sqlite3',
+                connection: {
+                    filename: ':memory:' // Or local file './dev.db'
+                },
+                useNullAsDefault: true
+            })
+        }
+    });
+
+    // 2. Load Schema
+    try {
+        app.loadFromDirectory(rootDir);
+        await app.init();
+        console.log(chalk.green('✅ Schema loaded successfully.'));
+    } catch (e: any) {
+        console.error(chalk.red('❌ Failed to load schema:'), e.message);
+        process.exit(1);
+    }
+
+    // 3. Create Handler
+    const handler = createNodeHandler(app);
+
+    // 4. Start Server
+    const server = createServer(handler);
+    
+    server.listen(options.port, () => {
+        console.log(chalk.green(`\n🚀 Server ready at http://localhost:${options.port}`));
+        console.log(chalk.gray('\nTry a curl command:'));
+        console.log(`curl -X POST http://localhost:${options.port} -H "Content-Type: application/json" -d '{"op": "find", "object": "YourObject", "args": {}}'`);
+    });
+}

packages/cli/src/index.ts

@@ -1,6 +1,7 @@
 import { Command } from 'commander';
 import { generateTypes } from './commands/generate';
 import { startRepl } from './commands/repl';
+import { serve } from './commands/serve';
 
 const program = new Command();
 
@@ -33,4 +34,14 @@ program
         await startRepl(options.config);
     });
 
+program
+    .command('serve')
+    .alias('s')
+    .description('Start a development server')
+    .option('-p, --port <number>', 'Port to listen on', '3000')
+    .option('-d, --dir <path>', 'Directory containing schema', '.')
+    .action(async (options) => {
+        await serve({ port: parseInt(options.port), dir: options.dir });
+    });
+
 program.parse();