metal-orm 1.0.4 → 1.0.5

package/docs/hydration.md

@@ -38,4 +38,13 @@ const hydrated = hydrateRows(rows, builder.getHydrationPlan());
 
 ## How it Works
 
-The `SelectQueryBuilder` analyzes the `include()` configuration and generates a `HydrationPlan`. This plan contains the necessary information to map the flat rows to a nested structure, including relation details and column aliases. The `hydrateRows()` function then uses this plan to efficiently process the result set.
+The `SelectQueryBuilder` analyzes the `include()` configuration and generates a `HydrationPlan`. This plan contains the necessary information to map the flat rows to a nested structure, including relation details and column aliases. The `hydrateRows()` function then uses this plan to efficiently process the result set.
+
+For belongs-to-many relationships you can also request pivot columns via the `pivot` option. Pivot columns are hydrated alongside each child row under the `_pivot` key, e.g.:
+
+```typescript
+.include('projects', {
+  columns: ['id', 'name', 'client'],
+  pivot: { columns: ['assigned_at', 'role_id'] }
+})
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "metal-orm",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "type": "module",
   "exports": {
     ".": {