s3db.js 11.3.1 → 11.3.2

package/dist/s3db.cjs.js

@@ -15283,7 +15283,7 @@ class Database extends EventEmitter {
     this.id = idGenerator(7);
     this.version = "1";
     this.s3dbVersion = (() => {
-      const [ok, err, version] = tryFn(() => true ? "11.3.1" : "latest");
+      const [ok, err, version] = tryFn(() => true ? "11.3.2" : "latest");
       return ok ? version : "latest";
     })();
     this.resources = {};

package/dist/s3db.es.js

@@ -15279,7 +15279,7 @@ class Database extends EventEmitter {
     this.id = idGenerator(7);
     this.version = "1";
     this.s3dbVersion = (() => {
-      const [ok, err, version] = tryFn(() => true ? "11.3.1" : "latest");
+      const [ok, err, version] = tryFn(() => true ? "11.3.2" : "latest");
       return ok ? version : "latest";
     })();
     this.resources = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "s3db.js",
-  "version": "11.3.1",
+  "version": "11.3.2",
   "description": "Use AWS S3, the world's most reliable document storage, as a database with this ORM.",
   "main": "dist/s3db.cjs.js",
   "module": "dist/s3db.es.js",

package/mcp/CLAUDE_CLI_SETUP.md

@@ -1,302 +0,0 @@
-# 🚀 Claude CLI Setup Guide
-
-Este guia mostra como configurar o S3DB MCP Server para usar com o Claude CLI.
-
-## 📋 Pré-requisitos
-
-```bash
-# Verificar se Claude CLI está instalado
-claude --version
-
-# Verificar se o projeto está instalado
-cd /home/ff/work/martech/s3db.js
-pnpm install
-
-# Instalar dependências do MCP (se ainda não estiver)
-pnpm add zod@3 express
-```
-
-## 🔌 Métodos de Configuração
-
-### Método 1: Stdio Transport (Recomendado para desenvolvimento)
-
-O Claude CLI vai spawnar o servidor automaticamente quando necessário.
-
-```bash
-claude mcp add s3db \
-  --transport stdio \
-  -- node /home/ff/work/martech/s3db.js/mcp/entrypoint.js --transport=stdio
-```
-
-**Variáveis de ambiente** (opcional):
-```bash
-# Editar configuração para adicionar env vars
-claude mcp edit s3db
-
-# Adicionar na seção env:
-{
-  "s3db": {
-    "transport": "stdio",
-    "command": "node",
-    "args": ["/home/ff/work/martech/s3db.js/mcp/entrypoint.js", "--transport=stdio"],
-    "env": {
-      "S3DB_CONNECTION_STRING": "s3://minioadmin:minioadmin123@localhost:9000/dev-bucket?forcePathStyle=true",
-      "S3DB_CACHE_ENABLED": "true",
-      "S3DB_CACHE_DRIVER": "memory",
-      "S3DB_VERBOSE": "false"
-    }
-  }
-}
-```
-
-### Método 2: HTTP Transport (Recomendado para produção)
-
-Primeiro, inicie o servidor em background:
-
-```bash
-# Inicie o servidor HTTP
-cd /home/ff/work/martech/s3db.js
-node mcp/entrypoint.js --transport=sse &
-
-# Ou com PM2 para auto-restart
-pm2 start mcp/entrypoint.js --name s3db-mcp -- --transport=sse
-pm2 save
-```
-
-Depois configure o Claude CLI:
-
-```bash
-claude mcp add s3db --transport http http://localhost:17500/sse
-```
-
-## 🧪 Testando a Configuração
-
-### 1. Verificar servidores configurados
-
-```bash
-claude mcp list
-```
-
-Você deve ver:
-```
-s3db - stdio://node /home/ff/work/martech/s3db.js/mcp/entrypoint.js --transport=stdio
-```
-
-### 2. Testar conexão
-
-```bash
-# Iniciar sessão do Claude
-claude
-
-# No chat, testar as tools:
-# "Can you connect to the S3DB database and list available resources?"
-```
-
-### 3. Comandos de teste no Claude Chat
-
-```
-1. Conectar ao banco:
-   "Connect to the S3DB database using dbConnect"
-
-2. Listar recursos:
-   "List all resources in the database using dbListResources"
-
-3. Criar um recurso de teste:
-   "Create a resource called 'test_users' with fields: name (string, required), email (string, required), age (number)"
-
-4. Inserir dados:
-   "Insert a test user with name 'John Doe', email 'john@example.com', age 30"
-
-5. Ver estatísticas:
-   "Show me database statistics including cache and costs"
-```
-
-## 🔧 Configurações Avançadas
-
-### Configurar para múltiplos ambientes
-
-```bash
-# Development (local MinIO)
-claude mcp add s3db-dev \
-  --transport stdio \
-  -- node /home/ff/work/martech/s3db.js/mcp/entrypoint.js --transport=stdio
-
-# Production (AWS S3)
-claude mcp add s3db-prod \
-  --transport http \
-  http://production-server:17500/sse
-```
-
-### Editar configuração existente
-
-```bash
-# Ver configuração atual
-claude mcp show s3db
-
-# Editar configuração
-claude mcp edit s3db
-
-# Remover servidor
-claude mcp remove s3db
-```
-
-## 📊 Tools Disponíveis (39 total)
-
-### 🔌 Connection Management (3)
-- `dbConnect` - Connect to S3DB database
-- `dbDisconnect` - Disconnect from database
-- `dbStatus` - Get connection status
-
-### 📦 Resource Management (2)
-- `dbCreateResource` - Create new resource/collection
-- `dbListResources` - List all resources
-
-### 🔍 Debugging Tools (5)
-- `dbInspectResource` - Detailed resource inspection
-- `dbGetMetadata` - Get raw metadata.json
-- `resourceValidate` - Validate data against schema
-- `dbHealthCheck` - Comprehensive health check
-- `resourceGetRaw` - Get raw S3 object data
-
-### 📊 Query & Filtering (2)
-- `resourceQuery` - Complex queries with filters
-- `resourceSearch` - Text search in fields
-
-### 🔧 Partition Management (4)
-- `resourceListPartitions` - List all partitions
-- `resourceListPartitionValues` - List partition values
-- `dbFindOrphanedPartitions` - Find orphaned partitions
-- `dbRemoveOrphanedPartitions` - Remove orphaned partitions
-
-### ✏️ CRUD Operations (14)
-- `resourceInsert` - Insert single document
-- `resourceInsertMany` - Insert multiple documents
-- `resourceGet` - Get document by ID
-- `resourceGetMany` - Get multiple documents
-- `resourceUpdate` - Update document
-- `resourceUpsert` - Insert or update
-- `resourceDelete` - Delete document
-- `resourceDeleteMany` - Delete multiple documents
-- `resourceExists` - Check if document exists
-- `resourceList` - List with pagination
-- `resourceListIds` - List document IDs
-- `resourceCount` - Count documents
-- `resourceGetAll` - Get all documents
-- `resourceDeleteAll` - Delete all documents
-
-### 🚀 Bulk Operations (2)
-- `resourceUpdateMany` - Update multiple documents
-- `resourceBulkUpsert` - Bulk upsert operation
-
-### 💾 Export/Import (3)
-- `resourceExport` - Export to JSON/CSV/NDJSON
-- `resourceImport` - Import from JSON/NDJSON
-- `dbBackupMetadata` - Backup metadata.json
-
-### 📈 Monitoring (4)
-- `dbGetStats` - Database statistics
-- `dbClearCache` - Clear cache
-- `resourceGetStats` - Resource statistics
-- `cacheGetStats` - Cache statistics
-
-## 🐛 Troubleshooting
-
-### Erro: "Command not found"
-
-```bash
-# Usar caminho absoluto completo
-claude mcp add s3db \
-  --transport stdio \
-  -- /home/ff/.nvm/versions/node/v22.6.0/bin/node \
-  /home/ff/work/martech/s3db.js/mcp/entrypoint.js --transport=stdio
-```
-
-### Erro: "Connection refused" (HTTP)
-
-```bash
-# Verificar se o servidor está rodando
-curl http://localhost:17500/health
-
-# Se não estiver, inicie:
-cd /home/ff/work/martech/s3db.js
-node mcp/entrypoint.js --transport=sse
-```
-
-### Erro: "Database not connected"
-
-No chat do Claude, sempre conecte primeiro:
-```
-"Please connect to the database first using dbConnect with connection string: s3://minioadmin:minioadmin123@localhost:9000/dev-bucket"
-```
-
-### Ver logs do servidor
-
-```bash
-# Se usando PM2
-pm2 logs s3db-mcp
-
-# Se rodando diretamente
-# Os logs aparecem no terminal onde iniciou o servidor
-```
-
-## 📚 Recursos Adicionais
-
-- [MCP Documentation](https://modelcontextprotocol.io)
-- [S3DB Documentation](../README.md)
-- [Full MCP Documentation](../docs/mcp.md)
-- [Claude CLI Documentation](https://docs.claude.com/en/docs/claude-code)
-
-## 🎯 Exemplos de Uso
-
-### Exemplo 1: CRUD Básico
-
-```
-User: Connect to local MinIO and create a users resource
-
-Claude will:
-1. Use dbConnect with MinIO connection string
-2. Use dbCreateResource to create 'users' resource
-3. Confirm creation with dbListResources
-
-User: Insert 5 test users
-
-Claude will:
-1. Use resourceInsertMany with test data
-2. Confirm with resourceCount
-```
-
-### Exemplo 2: Análise de Performance
-
-```
-User: Analyze database performance and suggest optimizations
-
-Claude will:
-1. Use dbGetStats to get overall statistics
-2. Use cacheGetStats to check cache performance
-3. Use dbHealthCheck to find issues
-4. Provide optimization suggestions
-```
-
-### Exemplo 3: Partition Recovery
-
-```
-User: Check for orphaned partitions and fix them
-
-Claude will:
-1. Use dbFindOrphanedPartitions to detect issues
-2. Use dbRemoveOrphanedPartitions with dryRun:true to preview
-3. Execute removal with dryRun:false
-4. Verify with dbHealthCheck
-```
-
-## ✅ Checklist de Configuração
-
-- [ ] Claude CLI instalado e funcionando
-- [ ] S3DB.js projeto instalado (pnpm install)
-- [ ] Servidor MCP configurado (claude mcp add)
-- [ ] Conexão testada (claude mcp list)
-- [ ] Tools testadas no chat do Claude
-- [ ] Environment variables configuradas (se necessário)
-- [ ] Backup da configuração (claude mcp show s3db > backup.json)
-
-Pronto! Agora você pode usar todas as 39 tools do S3DB diretamente no Claude CLI! 🎉

package/mcp/Dockerfile

@@ -1,45 +0,0 @@
-# syntax=docker/dockerfile:1.9
-FROM node:20-slim
-
-# Set working directory
-WORKDIR /app
-
-# Install system dependencies
-RUN apt-get update && apt-get install -y --no-install-recommends \
-    curl \
-    ca-certificates \
-    && rm -rf /var/lib/apt/lists/*
-
-# Copy package files first for better caching
-COPY package*.json ./
-
-# Install dependencies
-RUN npm ci --only=production && npm cache clean --force
-
-# Copy application code
-COPY s3db_mcp_server.js ./
-
-# Create non-root user
-RUN groupadd -r s3dbmcp && useradd -r -d /app -g s3dbmcp s3dbmcp
-
-# Change ownership to app user
-RUN chown -Rv s3dbmcp:s3dbmcp /app
-
-# Switch to non-root user
-USER s3dbmcp
-
-# Set environment variables
-ENV NODE_ENV=production \
-    MCP_SERVER_HOST=0.0.0.0 \
-    MCP_SERVER_PORT=8000 \
-    MCP_TRANSPORT=sse
-
-# Expose port
-EXPOSE 8000
-
-# Health check
-HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
-  CMD curl -f http://localhost:8001/health || exit 1
-
-# Default command
-CMD ["node", "s3db_mcp_server.js", "--transport=sse"]

package/mcp/Makefile

@@ -1,162 +0,0 @@
-# S3DB MCP Server Makefile
-
-.PHONY: help server server-v2 test test-simple test-interactive health tools minio clean
-
-# Default target
-help:
-	@echo "S3DB MCP Server Commands"
-	@echo "========================"
-	@echo ""
-	@echo "Server Commands:"
-	@echo "  make server        - Start original MCP server (SSE)"
-	@echo "  make server-v2     - Start refactored MCP server v2 (SSE)"
-	@echo "  make server-stdio  - Start server with stdio transport"
-	@echo ""
-	@echo "Test Commands:"
-	@echo "  make test          - Run automated tests"
-	@echo "  make test-simple   - Run simple HTTP tests"
-	@echo "  make test-mock     - Run tests with mock client"
-	@echo "  make test-interactive - Interactive test client"
-	@echo ""
-	@echo "Utility Commands:"
-	@echo "  make health        - Check server health"
-	@echo "  make tools         - List available tools"
-	@echo "  make minio         - Start MinIO for local testing"
-	@echo "  make clean         - Clean cache and temp files"
-	@echo ""
-	@echo "Docker Commands:"
-	@echo "  make docker-build  - Build Docker image"
-	@echo "  make docker-run    - Run in Docker container"
-	@echo "  make docker-compose - Start with docker-compose"
-
-# Server targets
-server:
-	@echo "Starting MCP Server (original)..."
-	@node server.js --transport=sse
-
-server-v2:
-	@echo "Starting MCP Server v2..."
-	@node server-v2.js --transport=sse
-
-server-stdio:
-	@echo "Starting MCP Server (stdio)..."
-	@node server-v2.js --transport=stdio
-
-# Test targets
-test:
-	@echo "Running automated tests..."
-	@node test-mcp-v2.js
-
-test-simple:
-	@echo "Running simple tests..."
-	@node test-simple.js
-
-test-mock:
-	@echo "Running tests with mock client..."
-	@node test-mcp-v2.js --mock
-
-test-interactive:
-	@echo "Starting interactive test client..."
-	@node test-mcp-v2.js --interactive
-
-# Utility targets
-health:
-	@echo "Checking server health..."
-	@curl -s http://localhost:8001/health | jq '.' || echo "Server not running"
-
-tools:
-	@echo "Listing available tools..."
-	@curl -s http://localhost:8001/tools | jq '.' || echo "Server not running"
-
-minio:
-	@echo "Starting MinIO..."
-	@docker run -d \
-		--name minio-s3db \
-		-p 9000:9000 \
-		-p 9001:9001 \
-		-e MINIO_ROOT_USER=minioadmin \
-		-e MINIO_ROOT_PASSWORD=minioadmin \
-		-v minio-data:/data \
-		minio/minio server /data --console-address ":9001"
-	@echo "MinIO started at http://localhost:9000 (console: http://localhost:9001)"
-	@echo "Credentials: minioadmin/minioadmin"
-
-minio-stop:
-	@echo "Stopping MinIO..."
-	@docker stop minio-s3db && docker rm minio-s3db
-
-# Docker targets
-docker-build:
-	@echo "Building Docker image..."
-	@docker build -t s3db-mcp-server .
-
-docker-run:
-	@echo "Running in Docker..."
-	@docker run -it --rm \
-		-p 8000:8000 \
-		-p 8001:8001 \
-		-e S3DB_CONNECTION=$${S3DB_CONNECTION} \
-		s3db-mcp-server
-
-docker-compose:
-	@echo "Starting with docker-compose..."
-	@docker-compose up -d
-
-docker-compose-down:
-	@echo "Stopping docker-compose..."
-	@docker-compose down
-
-# Clean target
-clean:
-	@echo "Cleaning cache and temp files..."
-	@rm -rf cache/
-	@rm -rf ./test-cache/
-	@rm -f *.log
-	@echo "Cleaned!"
-
-# Development targets
-dev:
-	@echo "Starting development environment..."
-	@make minio
-	@sleep 2
-	@make server-v2 &
-	@sleep 2
-	@make test-simple
-
-dev-stop:
-	@echo "Stopping development environment..."
-	@pkill -f "node server" || true
-	@make minio-stop
-
-# Watch for changes
-watch:
-	@echo "Watching for changes..."
-	@nodemon --watch lib --watch server-v2.js --exec "make server-v2"
-
-# Benchmark
-benchmark:
-	@echo "Running benchmarks..."
-	@node test-mcp-v2.js --benchmark
-
-# Installation
-install:
-	@echo "Installing dependencies..."
-	@pnpm install
-	@pnpm install -D @modelcontextprotocol/sdk nodemon
-
-# Environment setup
-setup:
-	@echo "Setting up environment..."
-	@cp .env.example .env 2>/dev/null || echo "No .env.example found"
-	@echo "S3DB_CONNECTION=s3://minioadmin:minioadmin@test-bucket?endpoint=http://localhost:9000&forcePathStyle=true" >> .env
-	@echo "MCP_TRANSPORT=sse" >> .env
-	@echo "MCP_SERVER_HOST=0.0.0.0" >> .env
-	@echo "MCP_SERVER_PORT=8000" >> .env
-	@echo "Environment setup complete!"
-
-# Combined targets
-all: install setup minio server-v2
-
-test-all: test-simple test-mock
-
-.DEFAULT_GOAL := help