@zeroxsolutions/jsonapi 0.13.4 → 0.13.6

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## 0.13.6 (2026-10-21)
+
+This was a version bump only for @zeroxsolutions/jsonapi to align it with other projects, there were no code changes.
+
+## 0.13.5 (2026-10-20)
+
+### 🚀 Features
+
+- **jsonapi:** read a facet's own facets where its fieldset names them ([a370c97](https://github.com/zeroxsolutions/zeroxsolutions/commit/a370c97))
+
+### ❤️ Thank You
+
+- Lương Văn Tú
+
 ## 0.13.4 (2026-10-19)
 
 This was a version bump only for @zeroxsolutions/jsonapi to align it with other projects, there were no code changes.

package/README.md

@@ -95,9 +95,12 @@ A read-one query answers `{ read }` alone. The permits name the `type` the read
 | -------------------------------------------- | ------------------------------------------------------------------------------ |
 | a column in the type's fieldset              | that column                                                                    |
 | a relationship in the fieldset, not included | the related row's primary key, which is the linkage its relationship publishes |
-| a facet (`facets`) in the fieldset           | that relation under its own type's fieldset, exactly                           |
+| a facet (`facets`) in the fieldset           | that relation under its own type's fieldset, exactly, its facets read the same |
 | an `include` path                            | every relation on it, each under its type's fieldset and its primary key       |
 | a computed name given a `ComputedRead`       | the columns and relations it names, whatever the fieldset asked                |
 
+A facet's type may declare facets of its own, such as a step's texts under a revision's steps; each loads where its
+parent facet's fieldset names it. A chain of facets leading back to a type it left throws, since it would never end.
+
 The filter, the order and the page window pass through unchanged. The package depends on `@zeroxsolutions/query`
 alone: the read names are strings, and `@zeroxsolutions/db` refuses one its table does not hold with `UnknownReadName`.

package/dist/lib/find-options/find-options-of.d.ts

@@ -27,7 +27,7 @@ export interface CollectionFindOptions<Leaf> extends ResourceFindOptions {
  * | `fields[<type>]` naming columns | those columns in `read` |
  * | a relationship in a fieldset, not included | that relation in `read` with its primary key alone, the linkage it publishes |
  * | an `include` path | every relation on it in `read`, each under its own type's fieldset and its primary key |
- * | a facet in a fieldset | that relation in `read` with exactly the columns its own type's fieldset names |
+ * | a facet in a fieldset | that relation in `read` with exactly the columns its own type's fieldset names, and each facet of that type the fieldset names, the same way |
  * | `filter`, `sort`, `offset`, `limit` | `filter`, `orderBy`, `offset` and `limit`, unchanged |
  *
  * Each computed attribute the permits map to a read loads that read on every query, whatever fieldset was sent.

package/dist/lib/find-options/find-options-of.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find-options-of.d.ts","sourceRoot":"","sources":["../../../src/lib/find-options/find-options-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,UAAU,EACV,wBAAwB,EACxB,sBAAsB,EAEtB,oBAAoB,EACpB,SAAS,EACV,MAAM,uBAAuB,CAAC;AAE/B;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,4DAA4D;AAC5D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+GAA+G;AAC/G,MAAM,WAAW,qBAAqB,CAAC,IAAI,CAAE,SAAQ,mBAAmB;IACtE,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;IAC3B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AA4FD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,CAAC,SAAS,oBAAoB,EAChE,KAAK,EAAE,wBAAwB,CAAC,IAAI,EAAE,CAAC,CAAC,EACxC,OAAO,EAAE,CAAC,GACT,qBAAqB,CAAC,IAAI,CAAC,CAAC;AAC/B,wBAAgB,aAAa,CAAC,CAAC,SAAS,oBAAoB,EAC1D,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC,EAChC,OAAO,EAAE,CAAC,GACT,mBAAmB,CAAC"}
+{"version":3,"file":"find-options-of.d.ts","sourceRoot":"","sources":["../../../src/lib/find-options/find-options-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,UAAU,EACV,wBAAwB,EACxB,sBAAsB,EAEtB,oBAAoB,EACpB,SAAS,EACV,MAAM,uBAAuB,CAAC;AAE/B;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,4DAA4D;AAC5D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+GAA+G;AAC/G,MAAM,WAAW,qBAAqB,CAAC,IAAI,CAAE,SAAQ,mBAAmB;IACtE,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;IAC3B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AA0GD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,CAAC,SAAS,oBAAoB,EAChE,KAAK,EAAE,wBAAwB,CAAC,IAAI,EAAE,CAAC,CAAC,EACxC,OAAO,EAAE,CAAC,GACT,qBAAqB,CAAC,IAAI,CAAC,CAAC;AAC/B,wBAAgB,aAAa,CAAC,CAAC,SAAS,oBAAoB,EAC1D,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC,EAChC,OAAO,EAAE,CAAC,GACT,mBAAmB,CAAC"}

package/dist/lib/find-options/find-options-of.js

@@ -29,10 +29,12 @@ function mergeComputed(level, computed) {
     }
 }
 /**
- * One level of the read: its fieldset's columns, the linkage of each relationship it names, each facet under its own
- * table's fieldset, each included relation under its own type's fieldset, and what its computed attributes need.
+ * One level of the read: its fieldset's columns, the linkage of each relationship it names, each facet as a level of
+ * its own type, each included relation under its own type's fieldset, and what its computed attributes need.
+ *
+ * @param facetsLeft - the types the facets leading to this level left, which a facet of it may not return to
  */
-function levelOf(walk, type, relations, include, path) {
+function levelOf(walk, type, relations, include, path, facetsLeft = new Set()) {
     const level = {};
     const fieldset = walk.fields[type];
     const facets = new Set(walk.permits.facets?.[type] ?? []);
@@ -43,12 +45,16 @@ function levelOf(walk, type, relations, include, path) {
             if (!target)
                 continue;
             level.relations ??= {};
-            const facetColumns = walk.fields[target.type];
-            level.relations[name] = facets.has(name)
-                ? facetColumns === undefined
-                    ? {}
-                    : { columns: [...facetColumns] }
-                : { columns: [...target.primaryKey] };
+            if (!facets.has(name)) {
+                level.relations[name] = { columns: [...target.primaryKey] };
+                continue;
+            }
+            // A facet's relations come back to the type it left, so a facet chain declared in a circle would never end.
+            if (facetsLeft.has(target.type) || target.type === type) {
+                throw new Error(`"${path}${name}" is a facet leading back to "${target.type}", which a facet above it left.`);
+            }
+            // A facet publishes no id, so its level holds only what its own type's fieldset names, its facets included.
+            level.relations[name] = levelOf(walk, target.type, target.relations, {}, `${path}${name}.`, new Set([...facetsLeft, type]));
         }
     }
     for (const [name, below] of Object.entries(include)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeroxsolutions/jsonapi",
-  "version": "0.13.4",
+  "version": "0.13.6",
   "private": false,
   "type": "module",
   "sideEffects": false,
@@ -30,7 +30,12 @@
   "dependencies": {
     "jsona": "^1.12.0",
     "tslib": "^2.3.0",
-    "@zeroxsolutions/response": "0.14.5",
-    "@zeroxsolutions/query": "0.7.4"
+    "@zeroxsolutions/query": "0.7.5",
+    "@zeroxsolutions/response": "0.14.6"
+  },
+  "nx": {
+    "targets": {
+      "lint-deps": {}
+    }
   }
 }