@e-techsolutions/e-baas-sdk 1.0.6 → 1.0.7

package/README.md

@@ -56,34 +56,44 @@ await ebaas.auth.signOut();
 ### Database Operations
 
 ```typescript
-// Select data
+// Select data (GET /sdk/v1/users?operation=select&select=id,name,email&status=eq.active)
+// IMPORTANTE: Campos sensíveis (password, hash, token, secret, key) são automaticamente 
+// excluídos quando usando select='*' por motivos de segurança
 const { data, error } = await ebaas
   .from('users')
-  .select('id, name, email')
+  .select('id, name, email') // Especificar campos explicitamente é mais seguro
   .eq('status', 'active')
   .order('created_at', { ascending: false })
   .limit(10)
   .execute();
 
-// Insert data
+// Para incluir todos os campos (incluindo sensíveis), especifique explicitamente:
+const { data, error } = await ebaas
+  .from('users')
+  .select('id, name, email, password') // Explícito para incluir campo sensível
+  .execute();
+
+// Insert data (POST /sdk/v1/users?operation=insert)
+// Retorna automaticamente os dados inseridos (com campos sensíveis filtrados)
 const { data, error } = await ebaas
   .from('users')
   .insert([
     { name: 'John Doe', email: 'john@example.com' },
     { name: 'Jane Smith', email: 'jane@example.com' }
-  ]);
+  ]); // data contém os registros criados com IDs gerados
 
-// Update data
+// Update data (PATCH /sdk/v1/users?operation=update&id=eq.123)
 const { data, error } = await ebaas
   .from('users')
   .update({ status: 'inactive' })
   .eq('id', 123);
 
-// Delete data
+// Delete data (DELETE /sdk/v1/users?operation=delete&id=eq.123)
+// IMPORTANTE: DELETE requer pelo menos um filtro por motivos de segurança
 const { data, error } = await ebaas
   .from('users')
   .delete()
-  .eq('status', 'inactive');
+  .eq('id', 123); // Filtro obrigatório para segurança
 
 // RPC (stored procedures)
 const { data, error } = await ebaas.rpc('get_user_stats', {
@@ -123,11 +133,12 @@ if (testResult.success) {
 const status = ebaas.getCustomDatabaseStatus();
 console.log('Using custom database:', status.hasConfig);
 
-// Use with different schema
+// Use with different schema (GET /sdk/v1/users?operation=select&select=*)
 const data = await ebaas.database
   .schema('custom_schema')
   .from('users')
-  .select('*');
+  .select('*')
+  .execute();
 ```
 
 For detailed information about custom database features, see [Custom Database Guide](./CUSTOM_DATABASE_GUIDE.md).
@@ -287,6 +298,7 @@ const ebaas = createClient('https://your-project.e-baas.io', 'your-anon-key', {
 import { EBaaSError } from '@e-techsolutions/e-baas-sdk';
 
 try {
+  // GET /sdk/v1/users?operation=select&select=*
   const { data } = await ebaas.from('users').select('*').execute();
 } catch (error) {
   if (error instanceof EBaaSError) {
@@ -297,6 +309,51 @@ try {
 }
 ```
 
+## Operações DELETE Seguras
+
+### Validação de Segurança
+O E-BaaS implementa validação rigorosa para operações DELETE e UPDATE, exigindo **pelo menos um filtro** para prevenir exclusões acidentais em massa:
+
+```typescript
+// ✅ CORRETO: DELETE com filtro específico
+const { data, error } = await ebaas
+  .from('users')
+  .delete()
+  .eq('id', 123);
+
+// ❌ ERRO: DELETE sem filtros (retorna "Security violation")
+const { data, error } = await ebaas
+  .from('users')
+  .delete(); // Falha com erro de segurança
+```
+
+### Workaround para Casos Específicos
+Em casos onde o SDK nativo apresenta problemas com operações DELETE, você pode usar requisições HTTP diretas:
+
+```typescript
+// Workaround usando fetch direta
+const deleteUser = async (userId, session, workspaceId, apiUrl, apiKey) => {
+  const url = `${apiUrl}/sdk/v1/users?operation=delete&id=${userId}`;
+  
+  const response = await fetch(url, {
+    method: 'DELETE',
+    headers: {
+      'Authorization': `Bearer ${session.access_token}`,
+      'apikey': apiKey,
+      'x-workspace-id': workspaceId,
+      'Content-Type': 'application/json'
+    }
+  });
+  
+  if (!response.ok) {
+    const errorData = await response.json();
+    throw new Error(errorData.error || `HTTP ${response.status}`);
+  }
+  
+  return { error: null };
+};
+```
+
 ## TypeScript Support
 
 The SDK is built with TypeScript and provides full type safety:
@@ -309,6 +366,7 @@ interface User {
   created_at: string;
 }
 
+// GET /sdk/v1/users?operation=select&select=*
 const { data, error } = await ebaas
   .from<User>('users')
   .select('*')
@@ -376,6 +434,13 @@ try {
 
 ## Changelog
 
+### v1.0.8 (2025-07-17)
+- 🔧 **FIX**: Correção crítica em operações DELETE no SDK
+- 🔧 **FIX**: Implementação de workaround HTTP para casos de falha do SDK nativo
+- 📚 **DOCS**: Documentação expandida sobre operações DELETE seguras
+- 🛡️ **SECURITY**: Validação rigorosa de filtros em operações DELETE/UPDATE
+- ✅ **TESTED**: Operações DELETE testadas e confirmadas funcionando
+
 ### v1.0.1 (2024-06-24)
 - 🚀 **NEW**: Native SDK integration in Edge Functions
 - 🚀 **NEW**: Dual runtime support (Node.js VM + Deno)