s3db.js 4.1.4 → 4.1.6

package/README.md

@@ -263,74 +263,93 @@ const users = await s3db.createResource({
 });
 ```
 
-#### Nested Attributes
+#### List, ListIds, Count, Page, Query (Novo Formato)
 
-`s3db.js` fully supports nested object attributes, allowing you to create complex document structures:
+Todos os métodos de listagem, paginação e contagem agora recebem um único objeto de parâmetros:
 
-```javascript
+```js
+// Listar todos os usuários
+const allUsers = await users.list();
+
+// Listar usuários de uma partição
+const googleUsers = await users.list({
+  partition: 'byUtmSource',
+  partitionValues: { 'utm.source': 'google' }
+});
+
+// Listar IDs de uma partição
+const googleUserIds = await users.listIds({
+  partition: 'byUtmSource',
+  partitionValues: { 'utm.source': 'google' }
+});
+
+// Paginar resultados
+const page = await users.page({
+  partition: 'byUtmSource',
+  partitionValues: { 'utm.source': 'google' },
+  offset: 0,
+  size: 10
+});
+console.log(page.items); // Array de usuários
+console.log(page.totalItems, page.totalPages);
+
+// Contar documentos em uma partição
+const count = await users.count({
+  partition: 'byUtmSource',
+  partitionValues: { 'utm.source': 'google' }
+});
+
+// Query com filtro e paginação
+const filtered = await users.query(
+  { isActive: true },
+  { partition: 'byUtmSource', partitionValues: { 'utm.source': 'google' }, limit: 5, offset: 0 }
+);
+```
+
+#### Partições com Campos Aninhados
+
+Você pode usar dot notation para acessar campos aninhados em partições:
+
+```js
 const users = await s3db.createResource({
-  name: "users",
+  name: 'users',
   attributes: {
-    name: "string|required",
-    email: "email|required",
-    utm: {
-      source: "string|required",
-      medium: "string|required",
-      campaign: "string|required",
-      term: "string|optional",
-      content: "string|optional"
-    },
-    address: {
-      street: "string|required",
-      city: "string|required",
-      state: "string|required",
-      country: "string|required",
-      zipCode: "string|optional"
-    },
-    metadata: {
-      category: "string|required",
-      priority: "string|required",
-      settings: "object|optional"
+    name: 'string|required',
+    utm: { source: 'string|required', medium: 'string|required' },
+    address: { country: 'string|required', city: 'string|required' }
+  },
+  options: {
+    partitions: {
+      byUtmSource: { fields: { 'utm.source': 'string' } },
+      byCountry: { fields: { 'address.country': 'string' } }
     }
   }
 });
 
-// Insert data with nested objects
-const user = await users.insert({
-  name: "John Doe",
-  email: "john@example.com",
-  utm: {
-    source: "google",
-    medium: "cpc",
-    campaign: "brand_awareness",
-    term: "search term"
-  },
-  address: {
-    street: "123 Main St",
-    city: "San Francisco",
-    state: "California",
-    country: "US",
-    zipCode: "94105"
-  },
-  metadata: {
-    category: "premium",
-    priority: "high",
-    settings: { theme: "dark", notifications: true }
-  }
+// Listar por campo aninhado
+const usUsers = await users.list({
+  partition: 'byCountry',
+  partitionValues: { 'address.country': 'US' }
 });
-
-// Access nested data
-console.log(user.utm.source); // "google"
-console.log(user.address.city); // "San Francisco"
-console.log(user.metadata.category); // "premium"
 ```
 
-**Key features of nested attributes:**
-- **Deep nesting**: Support for multiple levels of nested objects
-- **Validation**: Each nested field can have its own validation rules
-- **Optional fields**: Nested objects can contain optional fields
-- **Mixed types**: Combine simple types, arrays, and nested objects
-- **Partition support**: Use dot notation for partitions on nested fields (e.g., `"utm.source"`, `"address.country"`)
+#### getPartitionKey e getFromPartition
+
+```js
+// Gerar chave de partição
+const key = users.getPartitionKey({
+  partitionName: 'byUtmSource',
+  id: 'user-123',
+  data: { utm: { source: 'google' } }
+});
+
+// Buscar diretamente de uma partição
+const user = await users.getFromPartition({
+  id: 'user-123',
+  partitionName: 'byUtmSource',
+  partitionValues: { 'utm.source': 'google' }
+});
+```
 
 #### Automatic Timestamps
 
@@ -440,7 +459,7 @@ try {
   });
 } catch (error) {
   console.error("Operation failed:", error.message);
-  // Error: S3 metadata size exceeds 2KB limit. Current size: 2500 bytes, limit: 2048 bytes
+  // Error: S3 metadata size exceeds 2KB limit. Current size: 2500 bytes, limit: 2000 bytes
 }
 ```
 

package/dist/s3db.cjs.js

@@ -901,10 +901,10 @@ class Client extends EventEmitter {
       Bucket: this.config.bucket,
       Key: this.config.keyPrefix ? path.join(this.config.keyPrefix, key) : key,
       Metadata: { ...metadata },
-      Body: body || "",
-      ContentType: contentType,
-      ContentEncoding: contentEncoding
+      Body: body || Buffer.alloc(0)
     };
+    if (contentType !== void 0) options2.ContentType = contentType;
+    if (contentEncoding !== void 0) options2.ContentEncoding = contentEncoding;
     try {
       const response = await this.sendCommand(new clientS3.PutObjectCommand(options2));
       this.emit("putObject", response, options2);
@@ -8500,12 +8500,16 @@ class ResourceWriter extends EventEmitter {
   }
   write(chunk) {
     this.buffer.push(chunk);
-    this._maybeWrite();
+    this._maybeWrite().catch((error) => {
+      this.emit("error", error);
+    });
     return true;
   }
   end() {
     this.ended = true;
-    this._maybeWrite();
+    this._maybeWrite().catch((error) => {
+      this.emit("error", error);
+    });
   }
   async _maybeWrite() {
     if (this.writing) return;
@@ -8602,7 +8606,7 @@ function calculateTotalSize(mappedObject) {
   return Object.values(sizes).reduce((total, size) => total + size, 0);
 }
 
-const S3_METADATA_LIMIT_BYTES$3 = 2048;
+const S3_METADATA_LIMIT_BYTES$3 = 2e3;
 async function handleInsert$3({ resource, data, mappedData }) {
   const totalSize = calculateTotalSize(mappedData);
   if (totalSize > S3_METADATA_LIMIT_BYTES$3) {
@@ -8656,7 +8660,7 @@ var userManagement = /*#__PURE__*/Object.freeze({
   handleUpsert: handleUpsert$3
 });
 
-const S3_METADATA_LIMIT_BYTES$2 = 2048;
+const S3_METADATA_LIMIT_BYTES$2 = 2e3;
 async function handleInsert$2({ resource, data, mappedData }) {
   const totalSize = calculateTotalSize(mappedData);
   if (totalSize > S3_METADATA_LIMIT_BYTES$2) {
@@ -8690,7 +8694,7 @@ var enforceLimits = /*#__PURE__*/Object.freeze({
   handleUpsert: handleUpsert$2
 });
 
-const S3_METADATA_LIMIT_BYTES$1 = 2048;
+const S3_METADATA_LIMIT_BYTES$1 = 2e3;
 const TRUNCATE_SUFFIX = "...";
 const TRUNCATE_SUFFIX_BYTES = calculateUTF8Bytes(TRUNCATE_SUFFIX);
 async function handleInsert$1({ resource, data, mappedData }) {
@@ -8748,7 +8752,7 @@ var dataTruncate = /*#__PURE__*/Object.freeze({
   handleUpsert: handleUpsert$1
 });
 
-const S3_METADATA_LIMIT_BYTES = 2048;
+const S3_METADATA_LIMIT_BYTES = 2e3;
 const OVERFLOW_FLAG = "$overflow";
 const OVERFLOW_FLAG_VALUE = "true";
 const OVERFLOW_FLAG_BYTES = calculateUTF8Bytes(OVERFLOW_FLAG) + calculateUTF8Bytes(OVERFLOW_FLAG_VALUE);
@@ -9817,7 +9821,7 @@ class Database extends EventEmitter {
     this.version = "1";
     this.s3dbVersion = (() => {
       try {
-        return true ? "4.1.3" : "latest";
+        return true ? "4.1.4" : "latest";
       } catch (e) {
         return "latest";
       }