funifier-mcp 0.3.9 → 0.3.11

package/skills/funifier/references/implement-frontend.md

@@ -34,6 +34,7 @@ If search returns insufficient results, read these directly:
 - **Senha do player no banco deve ser BCrypt** (`$2a$...`) — texto plano causa `"Invalid salt version"`
 - **Scope `database`** é obrigatório na role para usar `/v3/database` — sem ele escrita retorna 201 mas não persiste
 - **Header `Range: items=0-1000`** para listas sem paginação explícita
+- **Datas em objetos de negócio:** enviar como `{ "$date": new Date(value).toISOString() }`, não string solta, quando o campo será consultado como data.
 
 ### Auth flow
 
@@ -72,6 +73,7 @@ const basicToken = 'Basic ' + btoa('API_KEY:APP_SECRET');
 - `funifier_read_doc path=modules/auth`
 - `funifier_read_doc path=modules/patterns`
 - `funifier_read_doc path=guides/aggregates` (para relatórios)
+- Se criar, editar ou filtrar datas, leia `references/date-handling.md`.
 
 ### 2. Implementar autenticação
 
@@ -101,6 +103,22 @@ const report = await fetch('/v3/database/achievement/aggregate', {
 });
 ```
 
+### Datas no frontend
+
+```javascript
+const payload = {
+  _id: 'cycle_2026_05',
+  startsAt: { $date: new Date('2026-05-01T00:00:00.000Z').toISOString() },
+  endsAt: { $date: new Date('2026-05-31T23:59:59.999Z').toISOString() }
+};
+
+await fetch('/v3/database/cycle__c?strict=true', {
+  method: 'POST',
+  headers: { ...headers, 'Content-Type': 'application/json' },
+  body: JSON.stringify(payload)
+});
+```
+
 ### 5. Hospedar no Funifier (opcional)
 
 Para arquivos estáticos, leia `funifier_read_doc path=modules/static-repo`.