@objectql/server 1.8.1 → 1.8.3

package/dist/storage.js

@@ -0,0 +1,181 @@
+"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.MemoryFileStorage = exports.LocalFileStorage = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const crypto = __importStar(require("crypto"));
+/**
+ * Local filesystem storage implementation for file attachments
+ */
+class LocalFileStorage {
+    constructor(options) {
+        this.baseDir = options.baseDir;
+        this.baseUrl = options.baseUrl;
+        // Ensure base directory exists
+        if (!fs.existsSync(this.baseDir)) {
+            fs.mkdirSync(this.baseDir, { recursive: true });
+        }
+    }
+    async save(file, filename, mimeType, options) {
+        // Generate unique ID for the file
+        const id = crypto.randomBytes(16).toString('hex');
+        const ext = path.extname(filename);
+        const basename = path.basename(filename, ext);
+        const storedFilename = `${id}${ext}`;
+        // Determine storage path
+        let folder = (options === null || options === void 0 ? void 0 : options.folder) || 'uploads';
+        if (options === null || options === void 0 ? void 0 : options.object) {
+            folder = path.join(folder, options.object);
+        }
+        const folderPath = path.join(this.baseDir, folder);
+        if (!fs.existsSync(folderPath)) {
+            fs.mkdirSync(folderPath, { recursive: true });
+        }
+        const filePath = path.join(folderPath, storedFilename);
+        // Write file to disk (async for better performance)
+        await fs.promises.writeFile(filePath, file);
+        // Generate public URL
+        const url = this.getPublicUrl(path.join(folder, storedFilename));
+        const attachmentData = {
+            id,
+            name: storedFilename,
+            url,
+            size: file.length,
+            type: mimeType,
+            original_name: filename,
+            uploaded_at: new Date().toISOString(),
+            uploaded_by: options === null || options === void 0 ? void 0 : options.userId
+        };
+        return attachmentData;
+    }
+    async get(fileId) {
+        try {
+            // Search for file in the upload directory
+            const found = this.findFile(this.baseDir, fileId);
+            if (!found) {
+                return null;
+            }
+            // Use async read for better performance
+            return await fs.promises.readFile(found);
+        }
+        catch (error) {
+            console.error('Error reading file:', error);
+            return null;
+        }
+    }
+    async delete(fileId) {
+        try {
+            const found = this.findFile(this.baseDir, fileId);
+            if (!found) {
+                return false;
+            }
+            // Use async unlink for better performance
+            await fs.promises.unlink(found);
+            return true;
+        }
+        catch (error) {
+            console.error('Error deleting file:', error);
+            return false;
+        }
+    }
+    getPublicUrl(filePath) {
+        // Normalize path separators for URLs
+        const normalizedPath = filePath.replace(/\\/g, '/');
+        return `${this.baseUrl}/${normalizedPath}`;
+    }
+    /**
+     * Recursively search for a file by ID
+     */
+    findFile(dir, fileId) {
+        const files = fs.readdirSync(dir);
+        for (const file of files) {
+            const filePath = path.join(dir, file);
+            const stat = fs.statSync(filePath);
+            if (stat.isDirectory()) {
+                const found = this.findFile(filePath, fileId);
+                if (found) {
+                    return found;
+                }
+            }
+            else if (file.startsWith(fileId)) {
+                return filePath;
+            }
+        }
+        return null;
+    }
+}
+exports.LocalFileStorage = LocalFileStorage;
+/**
+ * Memory storage implementation for testing
+ */
+class MemoryFileStorage {
+    constructor(options) {
+        this.files = new Map();
+        this.baseUrl = options.baseUrl;
+    }
+    async save(file, filename, mimeType, options) {
+        const id = crypto.randomBytes(16).toString('hex');
+        const ext = path.extname(filename);
+        const storedFilename = `${id}${ext}`;
+        const attachmentData = {
+            id,
+            name: storedFilename,
+            url: this.getPublicUrl(storedFilename),
+            size: file.length,
+            type: mimeType,
+            original_name: filename,
+            uploaded_at: new Date().toISOString(),
+            uploaded_by: options === null || options === void 0 ? void 0 : options.userId
+        };
+        this.files.set(id, { buffer: file, metadata: attachmentData });
+        return attachmentData;
+    }
+    async get(fileId) {
+        const entry = this.files.get(fileId);
+        return entry ? entry.buffer : null;
+    }
+    async delete(fileId) {
+        return this.files.delete(fileId);
+    }
+    getPublicUrl(filePath) {
+        return `${this.baseUrl}/${filePath}`;
+    }
+    clear() {
+        this.files.clear();
+    }
+}
+exports.MemoryFileStorage = MemoryFileStorage;
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

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

package/dist/types.d.ts

@@ -70,3 +70,75 @@ export interface ObjectQLResponse {
     };
     [key: string]: any;
 }
+/**
+ * Attachment/File metadata structure
+ */
+export interface AttachmentData {
+    /** Unique identifier for this file */
+    id: string;
+    /** File name (e.g., "invoice.pdf") */
+    name: string;
+    /** Publicly accessible URL to the file */
+    url: string;
+    /** File size in bytes */
+    size: number;
+    /** MIME type (e.g., "application/pdf", "image/jpeg") */
+    type: string;
+    /** Original filename as uploaded by user */
+    original_name?: string;
+    /** Upload timestamp (ISO 8601) */
+    uploaded_at?: string;
+    /** User ID who uploaded the file */
+    uploaded_by?: string;
+}
+/**
+ * Image-specific attachment data with metadata
+ */
+export interface ImageAttachmentData extends AttachmentData {
+    /** Image width in pixels */
+    width?: number;
+    /** Image height in pixels */
+    height?: number;
+    /** Thumbnail URL (if generated) */
+    thumbnail_url?: string;
+    /** Alternative sizes/versions */
+    variants?: {
+        small?: string;
+        medium?: string;
+        large?: string;
+    };
+}
+/**
+ * File storage provider interface
+ */
+export interface IFileStorage {
+    /**
+     * Save a file and return its metadata
+     */
+    save(file: Buffer, filename: string, mimeType: string, options?: FileStorageOptions): Promise<AttachmentData>;
+    /**
+     * Retrieve a file by its ID or path
+     */
+    get(fileId: string): Promise<Buffer | null>;
+    /**
+     * Delete a file
+     */
+    delete(fileId: string): Promise<boolean>;
+    /**
+     * Generate a public URL for a file
+     */
+    getPublicUrl(fileId: string): string;
+}
+/**
+ * Options for file storage operations
+ */
+export interface FileStorageOptions {
+    /** Logical folder/path for organization */
+    folder?: string;
+    /** Object name (for context/validation) */
+    object?: string;
+    /** Field name (for validation against field config) */
+    field?: string;
+    /** User ID who uploaded the file */
+    userId?: string;
+}

package/package.json

@@ -1,16 +1,28 @@
 {
   "name": "@objectql/server",
-  "version": "1.8.1",
+  "version": "1.8.3",
+  "description": "HTTP server adapter for ObjectQL - Express/NestJS compatible with GraphQL and REST API support",
+  "keywords": [
+    "objectql",
+    "server",
+    "http",
+    "api",
+    "rest",
+    "graphql",
+    "express",
+    "nestjs",
+    "adapter",
+    "backend"
+  ],
   "license": "MIT",
-  "description": "HTTP Server Adapter for ObjectQL",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
     "graphql": "^16.8.1",
     "@graphql-tools/schema": "^10.0.2",
     "js-yaml": "^4.1.1",
-    "@objectql/core": "1.8.1",
-    "@objectql/types": "1.8.1"
+    "@objectql/core": "1.8.3",
+    "@objectql/types": "1.8.3"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",

package/src/adapters/node.ts

@@ -1,14 +1,35 @@
 import { IObjectQL } from '@objectql/types';
 import { ObjectQLServer } from '../server';
-import { ObjectQLRequest, ErrorCode } from '../types';
+import { ObjectQLRequest, ErrorCode, IFileStorage } from '../types';
 import { IncomingMessage, ServerResponse } from 'http';
 import { generateOpenAPI } from '../openapi';
+import { createFileUploadHandler, createBatchFileUploadHandler, createFileDownloadHandler } from '../file-handler';
+import { LocalFileStorage } from '../storage';
+
+/**
+ * Options for createNodeHandler
+ */
+export interface NodeHandlerOptions {
+    /** File storage provider (defaults to LocalFileStorage) */
+    fileStorage?: IFileStorage;
+}
 
 /**
  * Creates a standard Node.js HTTP request handler.
  */
-export function createNodeHandler(app: IObjectQL) {
+export function createNodeHandler(app: IObjectQL, options?: NodeHandlerOptions) {
     const server = new ObjectQLServer(app);
+    
+    // Initialize file storage
+    const fileStorage = options?.fileStorage || new LocalFileStorage({
+        baseDir: process.env.OBJECTQL_UPLOAD_DIR || './uploads',
+        baseUrl: process.env.OBJECTQL_BASE_URL || 'http://localhost:3000/api/files'
+    });
+    
+    // Create file handlers
+    const uploadHandler = createFileUploadHandler(fileStorage, app);
+    const batchUploadHandler = createBatchFileUploadHandler(fileStorage, app);
+    const downloadHandler = createFileDownloadHandler(fileStorage);
 
 
     return async (req: IncomingMessage & { body?: any }, res: ServerResponse) => {
@@ -165,6 +186,27 @@ export function createNodeHandler(app: IObjectQL) {
             }
         }
         
+        // File Upload Endpoints
+        // POST /api/files/upload - Single file upload
+        if (pathName === '/api/files/upload' && method === 'POST') {
+            await uploadHandler(req, res);
+            return;
+        }
+        
+        // POST /api/files/upload/batch - Batch file upload
+        if (pathName === '/api/files/upload/batch' && method === 'POST') {
+            await batchUploadHandler(req, res);
+            return;
+        }
+        
+        // GET /api/files/:fileId - Download file
+        const fileMatch = pathName.match(/^\/api\/files\/([^/]+)$/);
+        if (fileMatch && method === 'GET') {
+            const fileId = fileMatch[1];
+            await downloadHandler(req, res, fileId);
+            return;
+        }
+        
         // Fallback or 404
         if (req.method === 'POST') {
              // Fallback for root POSTs if people forget /api/objectql but send to /api something