@objectql/server 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @objectql/server
+
+## 0.2.0
+
+### Minor Changes
+
+- 7df2977: 拆分 objectos
+
+### Patch Changes
+
+- Updated dependencies [7df2977]
+  - @objectql/core@1.2.0
+  - @objectql/types@1.2.0

package/README.md

@@ -0,0 +1,58 @@
+# @objectql/server
+
+Generic HTTP Server Adapter for ObjectQL.
+Allows running ObjectQL on Node.js, Express, Next.js, etc.
+
+## Installation
+
+```bash
+pnpm add @objectql/server
+```
+
+## Usage
+
+### Node.js (Raw HTTP)
+
+```typescript
+import { createNodeHandler } from '@objectql/server';
+import { app } from './objectql'; // Your initialized ObjectQL instance
+import { createServer } from 'http';
+
+const handler = createNodeHandler(app);
+const server = createServer(handler);
+server.listen(3000);
+```
+
+### Express
+
+```typescript
+import express from 'express';
+import { createNodeHandler } from '@objectql/server';
+import { app } from './objectql';
+
+const server = express();
+
+// Optional: Mount express.json() if you want, but ObjectQL handles parsing too.
+// server.use(express.json());
+
+// Mount the handler
+server.all('/api/objectql', createNodeHandler(app));
+
+server.listen(3000);
+```
+
+### Next.js (API Routes)
+
+```typescript
+// pages/api/objectql.ts
+import { createNodeHandler } from '@objectql/server';
+import { app } from '../../lib/objectql';
+
+export const config = {
+  api: {
+    bodyParser: false, // ObjectQL handles body parsing
+  },
+};
+
+export default createNodeHandler(app);
+```

package/dist/adapters/node.d.ts

@@ -0,0 +1,8 @@
+import { IObjectQL } from '@objectql/types';
+import { IncomingMessage, ServerResponse } from 'http';
+/**
+ * Creates a standard Node.js HTTP request handler.
+ */
+export declare function createNodeHandler(app: IObjectQL): (req: IncomingMessage & {
+    body?: any;
+}, res: ServerResponse) => Promise<void>;

package/dist/adapters/node.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNodeHandler = createNodeHandler;
+const server_1 = require("../server");
+const openapi_1 = require("../openapi");
+/**
+ * Creates a standard Node.js HTTP request handler.
+ */
+function createNodeHandler(app) {
+    const server = new server_1.ObjectQLServer(app);
+    return async (req, res) => {
+        // Handle OpenAPI spec request
+        if (req.method === 'GET' && req.url?.endsWith('/openapi.json')) {
+            const spec = (0, openapi_1.generateOpenAPI)(app);
+            res.setHeader('Content-Type', 'application/json');
+            res.statusCode = 200;
+            res.end(JSON.stringify(spec));
+            return;
+        }
+        if (req.method !== 'POST') {
+            res.statusCode = 405;
+            res.end('Method Not Allowed');
+            return;
+        }
+        const handleRequest = async (json) => {
+            try {
+                // TODO: Parse user from header or request override
+                const qlReq = {
+                    op: json.op,
+                    object: json.object,
+                    args: json.args,
+                    user: json.user // For dev/testing, allowing user injection
+                };
+                const result = await server.handle(qlReq);
+                res.setHeader('Content-Type', 'application/json');
+                res.statusCode = result.error ? 500 : 200;
+                res.end(JSON.stringify(result));
+            }
+            catch (e) {
+                res.statusCode = 500;
+                res.end(JSON.stringify({ error: { code: 'INTERNAL_ERROR', message: 'Internal Server Error' } }));
+            }
+        };
+        // 1. Check if body is already parsed (e.g. by express.json())
+        if (req.body && typeof req.body === 'object') {
+            await handleRequest(req.body);
+            return;
+        }
+        // 2. Parse Body from stream
+        let body = '';
+        req.on('data', chunk => body += chunk);
+        req.on('end', async () => {
+            try {
+                const json = JSON.parse(body);
+                await handleRequest(json);
+            }
+            catch (e) {
+                res.statusCode = 400;
+                res.end('Invalid JSON');
+            }
+        });
+    };
+}
+//# sourceMappingURL=node.js.map

package/dist/adapters/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/adapters/node.ts"],"names":[],"mappings":"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"}

package/dist/console.d.ts

@@ -0,0 +1,5 @@
+import { IncomingMessage, ServerResponse } from 'http';
+/**
+ * Creates a handler to serve the console UI static files.
+ */
+export declare function createConsoleHandler(): (req: IncomingMessage, res: ServerResponse) => Promise<void>;

package/dist/console.js

@@ -0,0 +1,173 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConsoleHandler = createConsoleHandler;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Creates a handler to serve the console UI static files.
+ */
+function createConsoleHandler() {
+    // Try to find the built console files
+    const possiblePaths = [
+        path.join(__dirname, '../../console/dist'),
+        path.join(process.cwd(), 'node_modules/@objectql/console/dist'),
+        path.join(process.cwd(), 'packages/console/dist'),
+    ];
+    let distPath = null;
+    for (const p of possiblePaths) {
+        if (fs.existsSync(p)) {
+            distPath = p;
+            break;
+        }
+    }
+    return async (req, res) => {
+        if (!distPath) {
+            // Return placeholder page if console is not built
+            const html = getPlaceholderPage();
+            res.setHeader('Content-Type', 'text/html');
+            res.statusCode = 200;
+            res.end(html);
+            return;
+        }
+        // Parse the URL and remove /console prefix
+        let urlPath = (req.url || '').replace(/^\/console/, '') || '/';
+        // Default to index.html for SPA routing
+        if (urlPath === '/' || !urlPath.includes('.')) {
+            urlPath = '/index.html';
+        }
+        const filePath = path.join(distPath, urlPath);
+        // Security check: ensure the file is within distPath
+        if (!filePath.startsWith(distPath)) {
+            res.statusCode = 403;
+            res.end('Forbidden');
+            return;
+        }
+        // Check if file exists
+        if (!fs.existsSync(filePath)) {
+            // For SPA, return index.html for any non-existent routes
+            const indexPath = path.join(distPath, 'index.html');
+            if (fs.existsSync(indexPath)) {
+                const content = fs.readFileSync(indexPath);
+                res.setHeader('Content-Type', 'text/html');
+                res.statusCode = 200;
+                res.end(content);
+                return;
+            }
+            res.statusCode = 404;
+            res.end('Not Found');
+            return;
+        }
+        // Read and serve the file
+        const content = fs.readFileSync(filePath);
+        const ext = path.extname(filePath);
+        const contentType = getContentType(ext);
+        res.setHeader('Content-Type', contentType);
+        res.statusCode = 200;
+        res.end(content);
+    };
+}
+function getContentType(ext) {
+    const types = {
+        '.html': 'text/html',
+        '.js': 'application/javascript',
+        '.css': 'text/css',
+        '.json': 'application/json',
+        '.png': 'image/png',
+        '.jpg': 'image/jpeg',
+        '.gif': 'image/gif',
+        '.svg': 'image/svg+xml',
+        '.ico': 'image/x-icon',
+    };
+    return types[ext] || 'application/octet-stream';
+}
+function getPlaceholderPage() {
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>ObjectQL Console</title>
+    <style>
+        * { margin: 0; padding: 0; box-sizing: border-box; }
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            min-height: 100vh;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            color: white;
+        }
+        .container {
+            text-align: center;
+            max-width: 600px;
+            padding: 2rem;
+        }
+        h1 { font-size: 3rem; margin-bottom: 1rem; }
+        p { font-size: 1.25rem; opacity: 0.9; line-height: 1.6; }
+        .info {
+            background: rgba(255, 255, 255, 0.1);
+            padding: 1.5rem;
+            border-radius: 8px;
+            margin-top: 2rem;
+            backdrop-filter: blur(10px);
+        }
+        code {
+            background: rgba(0, 0, 0, 0.2);
+            padding: 0.25rem 0.5rem;
+            border-radius: 4px;
+            font-family: monospace;
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <h1>ObjectQL Console</h1>
+        <p>Web-based admin console for database management</p>
+        <div class="info">
+            <p style="margin-bottom: 1rem;">
+                The console is available but needs to be built separately.
+            </p>
+            <p style="font-size: 1rem;">
+                To use the full console UI, run:<br>
+                <code>cd packages/console && pnpm run build</code>
+            </p>
+        </div>
+    </div>
+</body>
+</html>`;
+}
+//# sourceMappingURL=console.js.map

package/dist/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../src/console.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,oDAqEC;AA3ED,uCAAyB;AACzB,2CAA6B;AAE7B;;GAEG;AACH,SAAgB,oBAAoB;IAChC,sCAAsC;IACtC,MAAM,aAAa,GAAG;QAClB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,qCAAqC,CAAC;QAC/D,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,uBAAuB,CAAC;KACpD,CAAC;IAEF,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;QAC5B,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YACnB,QAAQ,GAAG,CAAC,CAAC;YACb,MAAM;QACV,CAAC;IACL,CAAC;IAED,OAAO,KAAK,EAAE,GAAoB,EAAE,GAAmB,EAAE,EAAE;QACvD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,kDAAkD;YAClD,MAAM,IAAI,GAAG,kBAAkB,EAAE,CAAC;YAClC,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;YAC3C,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACd,OAAO;QACX,CAAC;QAED,2CAA2C;QAC3C,IAAI,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;QAE/D,wCAAwC;QACxC,IAAI,OAAO,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5C,OAAO,GAAG,aAAa,CAAC;QAC5B,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAE9C,qDAAqD;QACrD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACrB,OAAO;QACX,CAAC;QAED,uBAAuB;QACvB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3B,yDAAyD;YACzD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YACpD,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3B,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;gBAC3C,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;gBAC3C,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;gBACrB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACjB,OAAO;YACX,CAAC;YAED,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACrB,OAAO;QACX,CAAC;QAED,0BAA0B;QAC1B,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,WAAW,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QAExC,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QAC3C,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;QACrB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC,CAAC;AACN,CAAC;AAED,SAAS,cAAc,CAAC,GAAW;IAC/B,MAAM,KAAK,GAA2B;QAClC,OAAO,EAAE,WAAW;QACpB,KAAK,EAAE,wBAAwB;QAC/B,MAAM,EAAE,UAAU;QAClB,OAAO,EAAE,kBAAkB;QAC3B,MAAM,EAAE,WAAW;QACnB,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE,WAAW;QACnB,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE,cAAc;KACzB,CAAC;IACF,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAC;AACpD,CAAC;AAED,SAAS,kBAAkB;IACvB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAsDH,CAAC;AACT,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types';
+export * from './openapi';
+export * from './server';
+export * from './metadata';
+export * from './console';
+export * from './adapters/node';

package/dist/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./openapi"), exports);
+__exportStar(require("./server"), exports);
+__exportStar(require("./metadata"), exports);
+__exportStar(require("./console"), exports);
+// We export createNodeHandler from root for convenience, 
+// but in the future we might encourage 'import ... from @objectql/server/node'
+__exportStar(require("./adapters/node"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,4CAA0B;AAC1B,2CAAyB;AACzB,6CAA2B;AAC3B,4CAA0B;AAC1B,0DAA0D;AAC1D,+EAA+E;AAC/E,kDAAgC"}

package/dist/metadata.d.ts

@@ -0,0 +1,7 @@
+import { IObjectQL } from '@objectql/types';
+import { IncomingMessage, ServerResponse } from 'http';
+/**
+ * Creates a handler for metadata endpoints.
+ * These endpoints expose information about registered objects.
+ */
+export declare function createMetadataHandler(app: IObjectQL): (req: IncomingMessage, res: ServerResponse) => Promise<void>;

package/dist/metadata.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMetadataHandler = createMetadataHandler;
+/**
+ * Creates a handler for metadata endpoints.
+ * These endpoints expose information about registered objects.
+ */
+function createMetadataHandler(app) {
+    return async (req, res) => {
+        // Parse the URL
+        const url = req.url || '';
+        // CORS headers for development
+        res.setHeader('Access-Control-Allow-Origin', '*');
+        res.setHeader('Access-Control-Allow-Methods', 'GET, OPTIONS');
+        res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+        if (req.method === 'OPTIONS') {
+            res.statusCode = 200;
+            res.end();
+            return;
+        }
+        try {
+            // GET /api/metadata/objects - List all objects
+            if (url === '/api/metadata/objects') {
+                const configs = app.getConfigs();
+                const objects = Object.values(configs).map(obj => ({
+                    name: obj.name,
+                    label: obj.label || obj.name,
+                    icon: obj.icon,
+                    fields: obj.fields ? Object.keys(obj.fields) : []
+                }));
+                res.setHeader('Content-Type', 'application/json');
+                res.statusCode = 200;
+                res.end(JSON.stringify({ objects }));
+                return;
+            }
+            // GET /api/metadata/objects/:name - Get object details
+            const match = url.match(/^\/api\/metadata\/objects\/([^\/]+)$/);
+            if (match) {
+                const objectName = match[1];
+                const metadata = app.getObject(objectName);
+                if (!metadata) {
+                    res.statusCode = 404;
+                    res.end(JSON.stringify({ error: 'Object not found' }));
+                    return;
+                }
+                // Convert fields object to array
+                const fields = metadata.fields
+                    ? Object.entries(metadata.fields).map(([key, field]) => ({
+                        name: field.name || key,
+                        type: field.type,
+                        label: field.label,
+                        required: field.required,
+                        defaultValue: field.defaultValue
+                    }))
+                    : [];
+                res.setHeader('Content-Type', 'application/json');
+                res.statusCode = 200;
+                res.end(JSON.stringify({
+                    ...metadata,
+                    fields
+                }));
+                return;
+            }
+            // Not found
+            res.statusCode = 404;
+            res.end('Not Found');
+        }
+        catch (e) {
+            console.error('[Metadata Handler] Error:', e);
+            res.statusCode = 500;
+            res.end(JSON.stringify({ error: 'Internal Server Error' }));
+        }
+    };
+}
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"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"}

package/dist/openapi.d.ts

@@ -0,0 +1,14 @@
+import { IObjectQL } from '@objectql/types';
+interface OpenAPISchema {
+    openapi: string;
+    info: {
+        title: string;
+        version: string;
+    };
+    paths: Record<string, any>;
+    components: {
+        schemas: Record<string, any>;
+    };
+}
+export declare function generateOpenAPI(app: IObjectQL): OpenAPISchema;
+export {};

package/dist/openapi.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateOpenAPI = generateOpenAPI;
+function generateOpenAPI(app) {
+    const registry = app.metadata; // Direct access or via interface
+    const objects = registry.list('object');
+    const paths = {};
+    const schemas = {};
+    // 1. Generate Schemas
+    for (const obj of objects) {
+        const schemaName = obj.name;
+        const properties = {};
+        for (const [fieldName, field] of Object.entries(obj.fields)) {
+            properties[fieldName] = mapFieldTypeToOpenAPI(field);
+        }
+        schemas[schemaName] = {
+            type: 'object',
+            properties
+        };
+        // 2. Generate Paths (RPC Style representation for documentation purposes)
+        // Since we only have one endpoint, we might document operations as descriptions
+        // Or if we support REST style in the future, we would add /object paths here.
+        // For now, let's document the "Virtual" REST API that could exist via a gateway
+        // OR just document the schema.
+        // Let's assume the user might want to see standard CRUD paths even if implementation is RPC,
+        // so they can pass it to frontend generators?
+        // No, that would be misleading if the server doesn't support it.
+        // Let's DOCUMENT the RPC operations as if they were paths, 
+        // OR clearer: One path /api/objectql with polymorphic body?
+        // Swagger UI handles oneOf poorly for top level operations sometimes.
+    }
+    // Let's do a "Virtual" REST path generation for better visualization
+    // Assuming we WILL support REST mapping in this update.
+    for (const obj of objects) {
+        const name = obj.name;
+        // GET /name (List)
+        paths[`/${name}`] = {
+            get: {
+                summary: `List ${name}s`,
+                tags: [name],
+                parameters: [
+                    { name: 'filter', in: 'query', schema: { type: 'string' }, description: 'JSON filter args' }
+                ],
+                responses: {
+                    200: {
+                        description: `List of ${name}`,
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    type: 'object',
+                                    properties: {
+                                        data: { type: 'array', items: { $ref: `#/components/schemas/${name}` } }
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            },
+            post: {
+                summary: `Create ${name}`,
+                tags: [name],
+                requestBody: {
+                    content: {
+                        'application/json': {
+                            schema: {
+                                type: 'object',
+                                properties: {
+                                    data: { $ref: `#/components/schemas/${name}` }
+                                }
+                            }
+                        }
+                    }
+                },
+                responses: {
+                    200: { description: 'Created' }
+                }
+            }
+        };
+        // GET /name/{id}
+        paths[`/${name}/{id}`] = {
+            get: {
+                summary: `Get ${name}`,
+                tags: [name],
+                parameters: [{ name: 'id', in: 'path', required: true, schema: { type: 'string' } }],
+                responses: { 200: { description: 'Item' } }
+            },
+            patch: {
+                summary: `Update ${name}`,
+                tags: [name],
+                parameters: [{ name: 'id', in: 'path', required: true, schema: { type: 'string' } }],
+                requestBody: { content: { 'application/json': { schema: { type: 'object', properties: { data: { type: 'object' } } } } } },
+                responses: { 200: { description: 'Updated' } }
+            },
+            delete: {
+                summary: `Delete ${name}`,
+                tags: [name],
+                parameters: [{ name: 'id', in: 'path', required: true, schema: { type: 'string' } }],
+                responses: { 200: { description: 'Deleted' } }
+            }
+        };
+    }
+    return {
+        openapi: '3.0.0',
+        info: {
+            title: 'ObjectQL API',
+            version: '1.0.0'
+        },
+        paths,
+        components: {
+            schemas
+        }
+    };
+}
+function mapFieldTypeToOpenAPI(field) {
+    const type = typeof field === 'string' ? field : field.type;
+    switch (type) {
+        case 'string': return { type: 'string' };
+        case 'integer': return { type: 'integer' };
+        case 'float': return { type: 'number' };
+        case 'boolean': return { type: 'boolean' };
+        case 'date': return { type: 'string', format: 'date-time' };
+        case 'json': return { type: 'object' };
+        default: return { type: 'string' }; // Fallback or relationship ID
+    }
+}
+//# sourceMappingURL=openapi.js.map

package/dist/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":";;AAcA,0CAyHC;AAzHD,SAAgB,eAAe,CAAC,GAAc;IAC1C,MAAM,QAAQ,GAAI,GAAW,CAAC,QAAQ,CAAC,CAAC,iCAAiC;IACzE,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAmB,CAAC;IAE1D,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,MAAM,OAAO,GAAwB,EAAE,CAAC;IAGxC,sBAAsB;IACtB,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC;QAC5B,MAAM,UAAU,GAAwB,EAAE,CAAC;QAE3C,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1D,UAAU,CAAC,SAAS,CAAC,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,CAAC,UAAU,CAAC,GAAG;YAClB,IAAI,EAAE,QAAQ;YACd,UAAU;SACb,CAAC;QAEF,0EAA0E;QAC1E,gFAAgF;QAChF,8EAA8E;QAC9E,gFAAgF;QAChF,+BAA+B;QAC/B,6FAA6F;QAC7F,8CAA8C;QAC9C,iEAAiE;QAEjE,4DAA4D;QAC5D,4DAA4D;QAC5D,sEAAsE;IAC1E,CAAC;IAED,qEAAqE;IACrE,wDAAwD;IACxD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QAEtB,mBAAmB;QACnB,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG;YAChB,GAAG,EAAE;gBACD,OAAO,EAAE,QAAQ,IAAI,GAAG;gBACxB,IAAI,EAAE,CAAC,IAAI,CAAC;gBACZ,UAAU,EAAE;oBACR,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,kBAAkB,EAAE;iBAC/F;gBACD,SAAS,EAAE;oBACP,GAAG,EAAE;wBACD,WAAW,EAAE,WAAW,IAAI,EAAE;wBAC9B,OAAO,EAAE;4BACL,kBAAkB,EAAE;gCAChB,MAAM,EAAE;oCACJ,IAAI,EAAE,QAAQ;oCACd,UAAU,EAAE;wCACR,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,wBAAwB,IAAI,EAAE,EAAE,EAAE;qCAC3E;iCACJ;6BACJ;yBACJ;qBACJ;iBACJ;aACJ;YACD,IAAI,EAAE;gBACF,OAAO,EAAE,UAAU,IAAI,EAAE;gBACzB,IAAI,EAAE,CAAC,IAAI,CAAC;gBACZ,WAAW,EAAE;oBACT,OAAO,EAAE;wBACL,kBAAkB,EAAE;4BAChB,MAAM,EAAE;gCACJ,IAAI,EAAE,QAAQ;gCACd,UAAU,EAAE;oCACR,IAAI,EAAE,EAAE,IAAI,EAAE,wBAAwB,IAAI,EAAE,EAAE;iCACjD;6BACJ;yBACJ;qBACJ;iBACJ;gBACD,SAAS,EAAE;oBACP,GAAG,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE;iBAClC;aACJ;SACJ,CAAC;QAEF,iBAAiB;QACjB,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG;YACrB,GAAG,EAAE;gBACD,OAAO,EAAE,OAAO,IAAI,EAAE;gBACtB,IAAI,EAAE,CAAC,IAAI,CAAC;gBACZ,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;gBACpF,SAAS,EAAE,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE;aAC9C;YACD,KAAK,EAAE;gBACF,OAAO,EAAE,UAAU,IAAI,EAAE;gBACzB,IAAI,EAAE,CAAC,IAAI,CAAC;gBACZ,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;gBACpF,WAAW,EAAE,EAAE,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAC,EAAE,EAAE,EAAE,EAAE;gBACzH,SAAS,EAAE,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE;aAClD;YACD,MAAM,EAAE;gBACH,OAAO,EAAE,UAAU,IAAI,EAAE;gBACzB,IAAI,EAAE,CAAC,IAAI,CAAC;gBACZ,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;gBACpF,SAAS,EAAE,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE;aAClD;SACJ,CAAC;IACN,CAAC;IAED,OAAO;QACH,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE;YACF,KAAK,EAAE,cAAc;YACrB,OAAO,EAAE,OAAO;SACnB;QACD,KAAK;QACL,UAAU,EAAE;YACR,OAAO;SACV;KACJ,CAAC;AACN,CAAC;AAED,SAAS,qBAAqB,CAAC,KAA2B;IACtD,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;IAE5D,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,QAAQ,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACzC,KAAK,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC3C,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACxC,KAAK,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAC5D,KAAK,MAAM,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACvC,OAAO,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,8BAA8B;IACtE,CAAC;AACL,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,11 @@
+import { IObjectQL } from '@objectql/types';
+import { ObjectQLRequest, ObjectQLResponse } from './types';
+export declare class ObjectQLServer {
+    private app;
+    constructor(app: IObjectQL);
+    /**
+     * The core handler that processes a JSON request object and returns a result.
+     * This is framework-agnostic.
+     */
+    handle(req: ObjectQLRequest): Promise<ObjectQLResponse>;
+}