insforge 0.3.1

package/examples/response-examples.md

@@ -0,0 +1,444 @@
+# InsForge API Response Format Examples
+
+All API responses now follow a consistent format with `success` field and proper structure.
+
+## Success Response Format
+
+```json
+{
+  "success": true,
+  "data": <response_data>,
+  "meta": {
+    "timestamp": "2024-01-01T00:00:00.000Z",
+    "pagination": { // optional, only for list endpoints
+      "total": 100,
+      "limit": 10,
+      "offset": 0,
+      "page": 1,
+      "totalPages": 10
+    }
+  }
+}
+```
+
+## Error Response Format
+
+```json
+{
+  "success": false,
+  "error": {
+    "code": "ERROR_CODE",
+    "message": "Human readable error message",
+    "details": {} // optional
+  },
+  "meta": {
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+## Endpoint Examples
+
+### Authentication Endpoints
+
+#### POST /auth/register
+**Success Response (201):**
+```json
+{
+  "success": true,
+  "data": {
+    "user": {
+      "id": "123",
+      "email": "user@example.com"
+    },
+    "token": "eyJhbGciOiJIUzI1NiIs..."
+  },
+  "meta": {
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+**Error Response (400):**
+```json
+{
+  "success": false,
+  "error": {
+    "code": "ALREADY_EXISTS",
+    "message": "User already exists"
+  },
+  "meta": {
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+#### POST /auth/login
+**Success Response (200):**
+```json
+{
+  "success": true,
+  "data": {
+    "user": {
+      "id": "123",
+      "name": "John Doe",
+      "email": "user@example.com"
+    },
+    "token": "eyJhbGciOiJIUzI1NiIs..."
+  },
+  "meta": {
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+**Error Response (401):**
+```json
+{
+  "success": false,
+  "error": {
+    "code": "INVALID_CREDENTIALS",
+    "message": "Invalid credentials"
+  },
+  "meta": {
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+#### GET /auth/me
+**Success Response (200):**
+```json
+{
+  "success": true,
+  "data": {
+    "user": {
+      "id": "123",
+      "email": "user@example.com",
+      "type": "user"
+    }
+  },
+  "meta": {
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+#### GET /auth/users
+**Success Response (200):**
+```json
+{
+  "success": true,
+  "data": [
+    {
+      "id": "123",
+      "email": "user1@example.com",
+      "created_at": "2024-01-01T00:00:00.000Z",
+      "updated_at": "2024-01-01T00:00:00.000Z"
+    },
+    {
+      "id": "124",
+      "email": "user2@example.com",
+      "created_at": "2024-01-01T00:00:00.000Z",
+      "updated_at": "2024-01-01T00:00:00.000Z"
+    }
+  ],
+  "meta": {
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+### Tables Endpoints
+
+#### GET /database/tables
+**Success Response (200):**
+```json
+{
+  "success": true,
+  "data": ["users", "posts", "comments"],
+  "meta": {
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+#### POST /database/tables
+**Success Response (201):**
+```json
+{
+  "success": true,
+  "data": {
+    "message": "Table created successfully",
+    "table_name": "posts"
+  },
+  "meta": {
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+#### GET /database/records/:table
+**Success Response with Pagination (200):**
+```json
+{
+  "success": true,
+  "data": [
+    {
+      "id": 1,
+      "title": "First Post",
+      "content": "Hello World"
+    },
+    {
+      "id": 2,
+      "title": "Second Post",
+      "content": "Another post"
+    }
+  ],
+  "meta": {
+    "pagination": {
+      "total": 50,
+      "limit": 10,
+      "offset": 0,
+      "page": 1,
+      "totalPages": 5
+    },
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+#### GET /database/records/:table?id=eq.:id
+**Success Response (200):**
+```json
+{
+  "success": true,
+  "data": {
+    "id": 1,
+    "title": "First Post",
+    "content": "Hello World",
+    "created_at": "2024-01-01T00:00:00.000Z"
+  },
+  "meta": {
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+**Error Response (404):**
+```json
+{
+  "success": false,
+  "error": {
+    "code": "NOT_FOUND",
+    "message": "Record not found"
+  },
+  "meta": {
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+#### POST /database/records/:table
+**Success Response (201):**
+```json
+{
+  "success": true,
+  "data": {
+    "message": "Records inserted successfully",
+    "inserted": 3,
+    "ids": [1, 2, 3]
+  },
+  "meta": {
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+#### PATCH /database/records/:table?id=eq.:id
+**Success Response (200):**
+```json
+{
+  "success": true,
+  "data": {
+    "message": "Record updated successfully",
+    "affected": 1
+  },
+  "meta": {
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+#### DELETE /database/records/:table?id=eq.:id
+**Success Response (200):**
+```json
+{
+  "success": true,
+  "data": {
+    "message": "Record deleted successfully",
+    "affected": 1
+  },
+  "meta": {
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+#### GET /database/tables/:table/schema
+**Success Response (200):**
+```json
+{
+  "success": true,
+  "data": {
+    "table_name": "posts",
+    "columns": [
+      {
+        "name": "id",
+        "type": "INTEGER",
+        "nullable": false,
+        "primary_key": true,
+        "default_value": null
+      },
+      {
+        "name": "title",
+        "type": "TEXT",
+        "nullable": false,
+        "primary_key": false,
+        "default_value": null
+      }
+    ]
+  },
+  "meta": {
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+#### PATCH /database/tables/:table
+**Success Response (200):**
+```json
+{
+  "success": true,
+  "data": {
+    "message": "Table schema updated successfully",
+    "table_name": "posts",
+    "operations": [
+      "Added column: tags",
+      "Renamed column: content → body",
+      "Dropped columns: temp_field"
+    ]
+  },
+  "meta": {
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+#### DELETE /database/tables/:table
+**Success Response (200):**
+```json
+{
+  "success": true,
+  "data": {
+    "message": "Table deleted successfully",
+    "table_name": "posts"
+  },
+  "meta": {
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+### Metadata Endpoints
+
+#### GET /metadata
+**Success Response (200):**
+```json
+{
+  "success": true,
+  "data": {
+    "app_name": "My InsForge App",
+    "app_description": "Backend as a Service",
+    "created_at": "2024-01-01T00:00:00.000Z"
+  },
+  "meta": {
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+#### GET /metadata/api-key
+**Success Response (200):**
+```json
+{
+  "success": true,
+  "data": {
+    "api_key": "ik_1234567890abcdef..."
+  },
+  "meta": {
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+### MCP Endpoints
+
+#### GET /mcp/metadata
+**Success Response (200):**
+```json
+{
+  "success": true,
+  "data": {
+    "app_name": "My InsForge App",
+    "app_description": "Backend as a Service",
+    "mcp_tools": {
+      "database": {
+        "create_table": true,
+        "modify_table": true,
+        "delete_table": true,
+        "query_records": true,
+        "insert_records": true,
+        "update_records": true,
+        "delete_records": true
+      }
+    }
+  },
+  "meta": {
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+### System Endpoints
+
+#### GET /health
+**Success Response (200):**
+```json
+{
+  "success": true,
+  "data": {
+    "status": "ok",
+    "service": "Insforge Backend",
+    "timestamp": "2024-01-01T00:00:00.000Z"
+  }
+}
+```
+
+### Common Error Codes
+
+- `MISSING_AUTH` - No authentication provided
+- `INVALID_AUTH` - Invalid authentication token or API key
+- `INVALID_CREDENTIALS` - Wrong username/password
+- `TOKEN_EXPIRED` - JWT token has expired
+- `FORBIDDEN` - Access denied
+- `INSUFFICIENT_PERMISSIONS` - Missing required permissions
+- `VALIDATION_ERROR` - Input validation failed
+- `INVALID_INPUT` - Invalid input format
+- `MISSING_FIELD` - Required field missing
+- `NOT_FOUND` - Resource not found
+- `ALREADY_EXISTS` - Resource already exists
+- `DATABASE_ERROR` - Database operation failed
+- `CONSTRAINT_VIOLATION` - Database constraint violated
+- `INTERNAL_ERROR` - Internal server error
+- `SERVICE_UNAVAILABLE` - Service temporarily unavailable

package/frontend/README.md

@@ -0,0 +1,112 @@
+# Insforge Dashboard
+
+A React-based admin dashboard for managing Insforge projects and databases.
+
+## Features
+
+- **Dashboard Overview**: System statistics and project overview
+- **Project Management**: Create, view, and delete projects
+- **Database Viewer**: Browse tables, schemas, and data
+- **API Key Management**: Copy and manage project API keys
+- **User Authentication**: Secure admin login
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Start development server (runs on port 7131)
+npm run dev
+
+# Build for production
+npm run build
+```
+
+## Built With
+
+- **React 18** - UI Framework
+- **TypeScript** - Type safety
+- **Tailwind CSS** - Styling
+- **Vite** - Build tool
+- **React Router** - Navigation
+- **Lucide React** - Icons
+
+## API Integration
+
+The dashboard communicates with the Insforge backend via REST API:
+
+### Authentication
+- `POST /api/auth/register` - User registration
+- `POST /api/auth/login` - User login (email/password)
+- `GET /api/auth/me` - Get current user info
+- `GET /api/auth/users` - List all users (admin only)
+
+### Database Management
+- `GET /api/database/tables` - List all tables
+- `POST /api/database/tables` - Create new table with schema
+- `DELETE /api/database/tables/:tablename` - Delete table
+- `GET /api/database/tables/:tablename/schema` - Get table schema
+- `PATCH /api/database/tables/:tablename/schema` - Modify table schema
+
+### Record Operations
+- `GET /api/database/records/:tablename` - Query records (supports pagination)
+- `POST /api/database/records/:tablename` - Insert records
+- `PATCH /api/database/records/:tablename?id=eq.:id` - Update specific record
+- `DELETE /api/database/records/:tablename?id=eq.:id` - Delete specific record
+
+### Storage
+- `GET /api/storage/buckets` - List all buckets
+- `POST /api/storage/buckets` - Create new bucket
+- `PATCH /api/storage/buckets/:bucketName` - Update bucket
+- `DELETE /api/storage/buckets/:bucketName` - Delete bucket
+- `GET /api/storage/buckets/:bucketName/objects` - List objects in bucket
+- `PUT /api/storage/buckets/:bucketName/objects/:objectKey` - Upload object with specific key
+- `POST /api/storage/buckets/:bucketName/objects` - Upload object with auto-generated key
+- `GET /api/storage/buckets/:bucketName/objects/:objectKey` - Download object
+- `DELETE /api/storage/buckets/:bucketName/objects/:objectKey` - Delete object
+
+### Metadata & Logs
+- `GET /api/metadata` - Get system metadata and statistics
+- `GET /api/logs` - Get activity logs (admin only)
+
+## Project Structure
+
+```
+frontend/
+├── src/
+│   ├── components/        # Reusable UI components
+│   │   ├── layout/       # Layout components
+│   │   └── table/        # Table components
+│   ├── features/         # Feature modules
+│   │   ├── auth/         # Authentication (login, users)
+│   │   ├── dashboard/    # Dashboard & metadata
+│   │   ├── database/     # Database management
+│   │   ├── logs/         # Activity logs
+│   │   └── storage/      # File storage
+│   ├── lib/              # Utilities and API client
+│   │   └── api/          # API client configuration
+│   ├── types/            # TypeScript type definitions
+│   ├── App.tsx           # Main app component
+│   └── main.tsx          # Entry point
+├── public/               # Static assets
+├── index.html            # HTML template
+├── vite.config.ts        # Vite configuration
+└── package.json          # Dependencies
+```
+
+## Usage
+
+1. Start the Insforge backend server
+2. Navigate to `http://localhost:7130` in your browser (production) or `http://localhost:7131` (development)
+3. Login with your admin credentials (from .env file)
+4. Create tables and manage data
+
+### Key Features
+- **Table Management**: Create tables with explicit schemas defining column types
+- **Data Types**: Support for string, integer, float, boolean, datetime, json, uuid, and file types
+- **Auto-generated Fields**: Every table gets id, created_at, and updated_at fields
+- **Record Management**: Full CRUD operations with pagination support
+- **API Key**: Single API key for all database operations (displayed in dashboard)
+
+The dashboard is automatically served by the backend when you access the root URL.

package/frontend/components.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "tailwind.config.js",
+    "css": "src/index.css",
+    "baseColor": "zinc",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils"
+  }
+}

package/frontend/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/x-icon" href="/favicon.ico" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>InsForge Dashboard</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/frontend/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "insforge-dashboard",
+  "version": "1.0.0",
+  "author": "Insforge",
+  "description": "Admin dashboard for Insforge backend management",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest --coverage",
+    "test:watch": "vitest --watch"
+  },
+  "dependencies": {
+    "@hookform/resolvers": "^5.1.1",
+    "@radix-ui/react-alert-dialog": "^1.1.14",
+    "@radix-ui/react-avatar": "^1.1.10",
+    "@radix-ui/react-dialog": "^1.1.14",
+    "@radix-ui/react-dropdown-menu": "^2.1.15",
+    "@radix-ui/react-icons": "^1.3.2",
+    "@radix-ui/react-label": "^2.1.7",
+    "@radix-ui/react-popover": "^1.1.14",
+    "@radix-ui/react-scroll-area": "^1.2.9",
+    "@radix-ui/react-select": "^2.2.5",
+    "@radix-ui/react-separator": "^1.1.7",
+    "@radix-ui/react-slot": "^1.2.3",
+    "@radix-ui/react-switch": "^1.2.5",
+    "@radix-ui/react-tabs": "^1.1.12",
+    "@radix-ui/react-tooltip": "^1.2.7",
+    "@tanstack/react-query": "^5.83.0",
+    "@types/uuid": "^10.0.0",
+    "@xyflow/react": "^12.8.4",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "date-fns": "^4.1.0",
+    "lucide-react": "^0.536.0",
+    "react": "19.1.1",
+    "react-data-grid": "7.0.0-beta.47",
+    "react-dom": "19.1.1",
+    "react-hook-form": "^7.61.1",
+    "react-router-dom": "^7.7.0",
+    "socket.io-client": "^4.8.1",
+    "tailwind-merge": "^3.3.1",
+    "uuid": "^11.1.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@tailwindcss/vite": "^4.1.11",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.3.0",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
+    "@vitejs/plugin-react": "^4.7.0",
+    "@vitest/ui": "^3.2.4",
+    "jsdom": "^26.1.0",
+    "tailwindcss": "^4.1.11",
+    "tailwindcss-animate": "^1.0.7",
+    "vite": "^7.0.5",
+    "vite-plugin-svgr": "^4.3.0"
+  }
+}