json-rest-api 1.0.10 → 1.0.11

package/docs/GUIDE/GUIDE_2_2_Manipulating_And_Searching_Tables.md

@@ -56,7 +56,7 @@ $ curl -i -X POST -H "Content-Type: application/vnd.api+json" -d '{
 ```text
 HTTP/1.1 204 No Content
 X-Powered-By: Express
-Location: /api/1.0/countries/2
+Location: /api/countries/2
 ETag: W/"a-bAsFyilMr4Ra1hIU5PyoyFRunpI"
 Date: Wed, 23 Jul 2025 07:54:09 GMT
 Connection: keep-alive
@@ -75,7 +75,7 @@ Date: Wed, 23 Jul 2025 07:54:12 GMT
 Connection: keep-alive
 Keep-Alive: timeout=5
 
-{"data":{"type":"countries","id":"2","attributes":{"name":"United Kingdom","code":"UK"},"links":{"self":"/api/1.0/countries/2"}},"links":{"self":"/api/1.0/countries/2"}}
+{"data":{"type":"countries","id":"2","attributes":{"name":"United Kingdom","code":"UK"},"links":{"self":"/api/countries/2"}},"links":{"self":"/api/countries/2"}}
 ```
 
 Note that in "transport" mode after the POST the record was not returned to the client: instead, a status `204 No Content` was returned. However, the client will be aware of the ID of the newly created record thanks to the `Location` header.
@@ -294,14 +294,17 @@ await api.resources.countries.createKnexTable()
 
 Note that the definition above is functionally _identical_ to the one provided a few paragraphs above.
 
-**Important: When you define a `searchSchema`, it completely replaces the search configuration from the main schema.** Only fields defined in the `searchSchema` are searchable if `searchSchema` is defined.
+**Important: When you define a `searchSchema`, it takes precedence over fields marked with `search: true` in the main schema.** However, fields marked with `search: true` that are NOT in the explicit `searchSchema` will be automatically added to enable searching. This allows you to:
+- Use `searchSchema` to override specific field behaviors
+- Still benefit from `search: true` markers for additional fields  
+- Have the explicit `searchSchema` always win in case of conflicts
 
 The `searchSchema` gives you:
 
-* complete control and isolation: With searchSchema, you define the search interface completely separately from the data schema. This can be cleaner when you have complex search requirements.
-* No mixing of concerns: Your data schema stays focused on data validation and storage, while searchSchema handles search behavior.
-* Easier to see all searchable fields at once: Everything is in one place rather than scattered across field definitions.
-* Flexibility to completely diverge from the data schema: You might have 20 fields in your schema but only expose 3 for searching, or create 10 search fields from 3 data fields.
+* Complete control where needed: Override specific fields while keeping the convenience of `search: true` for others
+* No mixing of concerns: Your data schema stays focused on data validation and storage, while searchSchema handles complex search behavior
+* Flexibility to extend: Add virtual fields or complex filters via searchSchema while basic fields use `search: true`
+* Best of both worlds: Explicit control for complex cases, automatic setup for simple ones
 
 `searchSchema` also gives you the ability to define a search field that will search in multiple fields. For example:
 
@@ -340,6 +343,57 @@ Search for "ge": { data: [
 
 This common pattern will give you the ability to create "global" search fields that will look in multiple fields.
 
+### Merging searchSchema with search:true Fields
+
+When you combine `searchSchema` with fields marked `search: true`, the library intelligently merges them:
+
+```javascript
+await api.addResource('products', {
+  schema: {
+    name: { type: 'string', search: true },        // Will be added to searchSchema
+    description: { type: 'string', search: true }, // Will be added to searchSchema  
+    price: { type: 'number', search: true },       // Overridden by searchSchema below
+    category_id: { type: 'number' },               // Not searchable
+    sku: { type: 'string', search: true }          // Will be added to searchSchema
+  },
+  searchSchema: {
+    // Explicit searchSchema entries take precedence
+    price: { 
+      type: 'number', 
+      filterOperator: 'between'  // Overrides the search:true with custom operator
+    },
+    category_name: {              // Virtual field (doesn't exist in schema)
+      type: 'string',
+      actualField: 'category.name',
+      filterOperator: 'like'
+    }
+  }
+});
+
+// Result: The effective searchSchema includes:
+// - name (from search:true, uses default '=' operator)
+// - description (from search:true, uses default '=' operator)  
+// - sku (from search:true, uses default '=' operator)
+// - price (from explicit searchSchema, uses 'between' operator)
+// - category_name (from explicit searchSchema, virtual field)
+
+// You can now search using all these fields:
+const results = await api.resources.products.query({
+  queryParams: {
+    filters: {
+      name: 'Widget',           // From search:true
+      price: [10, 100],         // From searchSchema with 'between'
+      category_name: 'Electronics' // Virtual field from searchSchema
+    }
+  }
+});
+```
+
+This merge behavior gives you the best of both worlds:
+- Quick setup with `search: true` for simple fields
+- Precise control with `searchSchema` for complex requirements
+- No need to repeat fields in searchSchema that already have `search: true`
+
 ### Multi-word Search with AND Logic
 
 The `oneOf` search feature becomes even more powerful when combined with `splitBy` and `matchAll` options. This allows you to search for multiple words where ALL must appear somewhere in the specified fields.

package/docs/GUIDE/GUIDE_2_3_BelongsTo_Relationships.md

@@ -30,23 +30,22 @@ await api.addResource('publishers', {
 await api.resources.publishers.createKnexTable();
 ```
 
-Now, let's add some data. Notice the flexibility of using either the foreign key field `country_id` or the relationship alias `country` when linking a publisher to a country in simplified mode.
+Now, let's add some data. Use the relationship name `country` when linking a publisher to a country in simplified mode.
 
 ```javascript
 const france = await api.resources.countries.post({ name: 'France', code: 'FR' });
 const germany = await api.resources.countries.post({ name: 'Germany', code: 'DE' });
 const uk = await api.resources.countries.post({ name: 'United Kingdom', code: 'UK' });
 
-// Create a publisher linking via the relationship alias (simplified syntax)
+// Create publishers linking via the relationship name (simplified syntax)
 const frenchPublisher = await api.resources.publishers.post({
   name: 'French Books Inc.',
   country: france.id
 });
 
-// Create a publisher linking via the foreign key field directly
 const germanPublisher = await api.resources.publishers.post({
   name: 'German Press GmbH',
-  country_id: germany.id
+  country: germany.id
 });
 
 const ukPublisher = await api.resources.publishers.post({
@@ -56,7 +55,7 @@ const ukPublisher = await api.resources.publishers.post({
 
 const internationalPublisher = await api.resources.publishers.post({
   name: 'Global Publishing',
-  country_id: null
+  country: null
 });
 
 
@@ -66,22 +65,29 @@ console.log('Added UK Publisher:', inspect(ukPublisher));
 console.log('Added International Publisher:', inspect(internationalPublisher));
 ```
 
-**Explanation of Interchangeability (`country_id` vs. `country`):**
+**Using Relationship Names:**
 
-When defining a `belongsTo` relationship with an `as` alias (e.g., `country_id: { ..., as: 'country' }`), `json-rest-api` provides flexibility in how you provide the related resource's ID during `post`, `put`, or `patch` operations in **simplified mode**:
+When defining a `belongsTo` relationship with an `as` alias (e.g., `country_id: { ..., as: 'country' }`), use the relationship name `country` when providing the related resource's ID during `post`, `put`, or `patch` operations in **simplified mode**:
 
-* You can use the **relationship alias** (the `as` value) directly with the ID of the related resource (e.g., `country: france.id`). This is generally recommended for clarity and aligns with the relationship concept.
-* You can use the direct **foreign key field name** (e.g., `country_id: germany.id`). The system is flexible enough to recognize this as a foreign key and process it correctly.
+* Use the **relationship name** (the `as` value) directly with the ID of the related resource (e.g., `country: france.id`). This provides clarity and aligns with the relationship concept.
+* Foreign key field names (e.g., `country_id`) are no longer supported for relationship input to maintain consistency across all relationship types.
 
-Both approaches achieve the same result of setting the underlying foreign key in the database.
+**Field Visibility and Database-First Design:**
+
+Note that while the schema defines `country_id` (the actual database column), the API layer abstracts this away:
+- **API Input**: Use `country` (the relationship name)
+- **API Output**: Returns `country: { id: '1' }` (relationship object)
+- **Internal/Hooks**: Work with `country_id` (actual database field via `context.belongsToUpdates`)
+
+This separation ensures API consumers never see database implementation details like foreign key fields, while backend developers retain full control over the database structure.
 
 **Expected Output (Illustrative, IDs may vary):**
 
 ```text
-Added French Publisher: { id: '1', name: 'French Books Inc.', country_id: '1' }
-Added German Publisher: { id: '2', name: 'German Press GmbH', country_id: '2' }
-Added UK Publisher: { id: '3', name: 'UK Books Ltd.', country_id: '3' }
-Added International Publisher: { id: '4', name: 'Global Publishing', country_id: null }
+Added French Publisher: { id: '1', name: 'French Books Inc.', country: { id: '1' } }
+Added German Publisher: { id: '2', name: 'German Press GmbH', country: { id: '2' } }
+Added UK Publisher: { id: '3', name: 'UK Books Ltd.', country: { id: '3' } }
+Added International Publisher: { id: '4', name: 'Global Publishing', country: null }
 ```
 
 ## Including `belongsTo` Records (`include`)
@@ -101,8 +107,8 @@ const uk = await api.resources.countries.post({ name: 'United Kingdom', code: 'U
 await api.resources.publishers.post({ name: 'French Books Inc.', country: france.id });
 await api.resources.publishers.post({ name: 'Another French Books Inc.', country: france.id });
 await api.resources.publishers.post({ name: 'UK Books Ltd.', country: uk.id });
-await api.resources.publishers.post({ name: 'German Press GmbH', country_id: germany.id });
-await api.resources.publishers.post({ name: 'Global Publishing', country_id: null });
+await api.resources.publishers.post({ name: 'German Press GmbH', country: germany.id });
+await api.resources.publishers.post({ name: 'Global Publishing', country: null });
 
 await api.resources.publishers.post({ 
   name: 'UK Books Ltd.', 
@@ -127,10 +133,10 @@ const allPublishersWithCountries = await api.resources.publishers.query({
 });
 // HTTP: GET /api/publishers?include=country
 // Returns (simplified): [
-//   { id: '1', name: 'French Books Inc.', country_id: '1', country: { id: '1', name: 'France', code: 'FR' } },
-//   { id: '2', name: 'German Press GmbH', country_id: '2', country: { id: '2', name: 'Germany', code: 'DE' } },
-//   { id: '3', name: 'UK Books Ltd.', country_id: '3', country: { id: '3', name: 'United Kingdom', code: 'UK' } },
-//   { id: '4', name: 'Global Publishing', country_id: null, country: null }
+//   { id: '1', name: 'French Books Inc.', country: { id: '1', name: 'France', code: 'FR' } },
+//   { id: '2', name: 'German Press GmbH', country: { id: '2', name: 'Germany', code: 'DE' } },
+//   { id: '3', name: 'UK Books Ltd.', country: { id: '3', name: 'United Kingdom', code: 'UK' } },
+//   { id: '4', name: 'Global Publishing', country: null }
 // ]
 
 console.log('All Publishers with Countries:', inspect(allPublishersWithCountries));
@@ -173,7 +179,6 @@ Here is the expected output. Notice how the last call shows the non-simplified v
 Publisher with Country: {
   id: '1',
   name: 'French Books Inc.',
-  country_id: '1',
   country: { id: '1', name: 'France', code: 'FR' }
 }
 All Publishers with Countries: {
@@ -181,27 +186,23 @@ All Publishers with Countries: {
     {
       id: '1',
       name: 'French Books Inc.',
-      country_id: '1',
       country: { id: '1', name: 'France', code: 'FR' }
     },
     {
       id: '2',
       name: 'Another French Books Inc.',
-      country_id: '1',
       country: { id: '1', name: 'France', code: 'FR' }
     },
     {
       id: '3',
       name: 'UK Books Ltd.',
-    country_id: '3',
-    country: { id: '3', name: 'United Kingdom', code: 'UK' }
-  },
-  {
-    id: '4',
-    name: 'German Press GmbH',
-    country_id: '2',
-    country: { id: '2', name: 'Germany', code: 'DE' }
-  },
+      country: { id: '3', name: 'United Kingdom', code: 'UK' }
+    },
+    {
+      id: '4',
+      name: 'German Press GmbH',
+      country: { id: '2', name: 'Germany', code: 'DE' }
+    },
     { id: '5', name: 'Global Publishing' }
   ],
   meta: {...},
@@ -217,12 +218,12 @@ All Publishers with Countries (not simplified): {
         country: {
           data: { type: 'countries', id: '1' },
           links: {
-            self: '/api/1.0/publishers/1/relationships/country',
-            related: '/api/1.0/publishers/1/country'
+            self: '/api/publishers/1/relationships/country',
+            related: '/api/publishers/1/country'
           }
         }
       },
-      links: { self: '/api/1.0/publishers/1' }
+      links: { self: '/api/publishers/1' }
     },
     {
       type: 'publishers',
@@ -232,12 +233,12 @@ All Publishers with Countries (not simplified): {
         country: {
           data: { type: 'countries', id: '1' },
           links: {
-            self: '/api/1.0/publishers/2/relationships/country',
-            related: '/api/1.0/publishers/2/country'
+            self: '/api/publishers/2/relationships/country',
+            related: '/api/publishers/2/country'
           }
         }
       },
-      links: { self: '/api/1.0/publishers/2' }
+      links: { self: '/api/publishers/2' }
     },
     {
       type: 'publishers',
@@ -247,12 +248,12 @@ All Publishers with Countries (not simplified): {
         country: {
           data: { type: 'countries', id: '3' },
           links: {
-            self: '/api/1.0/publishers/3/relationships/country',
-            related: '/api/1.0/publishers/3/country'
+            self: '/api/publishers/3/relationships/country',
+            related: '/api/publishers/3/country'
           }
         }
       },
-      links: { self: '/api/1.0/publishers/3' }
+      links: { self: '/api/publishers/3' }
     },
     {
       type: 'publishers',
@@ -262,11 +263,11 @@ All Publishers with Countries (not simplified): {
         country: {
           data: { type: 'countries', id: '2' },
           links: {
-            self: '/api/1.0/publishers/4/relationships/country',
-          related: '/api/1.0/publishers/4/country'
+            self: '/api/publishers/4/relationships/country',
+          related: '/api/publishers/4/country'
         }
       },
-      links: { self: '/api/1.0/publishers/4' }
+      links: { self: '/api/publishers/4' }
     },
     {
       type: 'publishers',
@@ -276,12 +277,12 @@ All Publishers with Countries (not simplified): {
         country: {
           data: null,
           links: {
-            self: '/api/1.0/publishers/5/relationships/country',
-            related: '/api/1.0/publishers/5/country'
+            self: '/api/publishers/5/relationships/country',
+            related: '/api/publishers/5/country'
           }
         }
       },
-      links: { self: '/api/1.0/publishers/5' }
+      links: { self: '/api/publishers/5' }
     }
   ],
   included: [
@@ -290,24 +291,24 @@ All Publishers with Countries (not simplified): {
       id: '1',
       attributes: { name: 'France', code: 'FR' },
       relationships: {},
-      links: { self: '/api/1.0/countries/1' }
+      links: { self: '/api/countries/1' }
     },
     {
       type: 'countries',
       id: '3',
       attributes: { name: 'United Kingdom', code: 'UK' },
       relationships: {},
-      links: { self: '/api/1.0/countries/3' }
+      links: { self: '/api/countries/3' }
     },
     {
       type: 'countries',
       id: '2',
       attributes: { name: 'Germany', code: 'DE' },
       relationships: {},
-      links: { self: '/api/1.0/countries/2' }
+      links: { self: '/api/countries/2' }
     }
   ],
-  links: { self: '/api/1.0/publishers?include=country' }
+  links: { self: '/api/publishers?include=country' }
 }
 ```
 
@@ -328,8 +329,8 @@ const uk = await api.resources.countries.post({ name: 'United Kingdom', code: 'U
 
 await api.resources.publishers.post({ name: 'French Books Inc.', country: france.id });
 await api.resources.publishers.post({ name: 'UK Books Ltd.', country: uk.id });
-await api.resources.publishers.post({ name: 'German Press GmbH', country_id: germany.id });
-await api.resources.publishers.post({ name: 'Global Publishing', country_id: null });
+await api.resources.publishers.post({ name: 'German Press GmbH', country: germany.id });
+await api.resources.publishers.post({ name: 'Global Publishing', country: null });
 
 
 // Get a publisher, include its country, but only retrieve publisher name and country code
@@ -379,7 +380,6 @@ When you specify `fields: { countries: ['code'] }`, this instruction applies to
 {
   id: '1',
   name: 'French Books Inc.',
-  country_id: '1',
   country: { id: '1', code: 'FR' }
 }
 Sparse Publishers Query (all results): {
@@ -387,19 +387,16 @@ Sparse Publishers Query (all results): {
     {
       id: '1',
       name: 'French Books Inc.',
-      country_id: '1',
       country: { id: '1', code: 'FR', name: 'France' }
     },
     {
       id: '2',
       name: 'UK Books Ltd.',
-      country_id: '3',
       country: { id: '3', code: 'UK', name: 'United Kingdom' }
     },
     {
       id: '3',
       name: 'German Press GmbH',
-      country_id: '2',
       country: { id: '2', code: 'DE', name: 'Germany' }
     },
     { id: '4', name: 'Global Publishing' }
@@ -425,8 +422,8 @@ const uk = await api.resources.countries.post({ name: 'United Kingdom', code: 'U
 
 await api.resources.publishers.post({ name: 'French Books Inc.', country: france.id });
 await api.resources.publishers.post({ name: 'UK Books Ltd.', country: uk.id });
-await api.resources.publishers.post({ name: 'German Press GmbH', country_id: germany.id });
-await api.resources.publishers.post({ name: 'Global Publishing', country_id: null });
+await api.resources.publishers.post({ name: 'German Press GmbH', country: germany.id });
+await api.resources.publishers.post({ name: 'Global Publishing', country: null });
 
 
 // Programmatic search: Find publishers from France using the country ID alias in searchSchema
@@ -484,9 +481,9 @@ console.log('Publishers from UK (by countryCode):', inspect(publishersFromUK));
 **Expected Output**
 
 ```text
-Publishers from France (by country ID): [ { id: '1', name: 'French Books Inc.', country_id: '1' } ]
+Publishers from France (by country ID): [ { id: '1', name: 'French Books Inc.', country: { id: '1' } } ]
 Publishers with No Country (by country ID: null): [ { id: '4', name: 'Global Publishing' } ]
-Publishers from UK (by countryCode): [ { id: '2', name: 'UK Books Ltd.', country_id: '3' } ]
+Publishers from UK (by countryCode): [ { id: '2', name: 'UK Books Ltd.', country: { id: '3' } } ]
 ```
 
 ---

package/docs/GUIDE/GUIDE_2_4_HasMany_Records.md

@@ -14,7 +14,7 @@ await api.addResource('publishers', {
   },
   relationships: {
     // A publisher has many authors
-    authors: { hasMany: 'authors', foreignKey: 'publisher_id' },
+    authors: { type: 'hasMany', target: 'authors', foreignKey: 'publisher_id' },
   },
   searchSchema: { // Adding search schema for publishers
     name: { type: 'string', filterOperator: 'like' }
@@ -80,11 +80,11 @@ console.log('French publisher  Authors (author ids only, NOT simplified):', insp
 The output:
 
 ```text
-Added French Publisher: { id: '1', name: 'French Books Inc.', authors_ids: [] }
-Added Victor Hugo: { id: '1', name: 'Victor', surname: 'Hugo', publisher_id: '1' }
-Added Émile Zola: { id: '2', name: 'Émile', surname: 'Zola', publisher_id: '1' }
-Added German Publisher: { id: '2', name: 'German Press GmbH', authors_ids: [] }
-French publisher  Authors (ids only, simplified): { id: '1', name: 'French Books Inc.', authors_ids: [ '1', '2' ] }
+Added French Publisher: { id: '1', name: 'French Books Inc.', authors: [] }
+Added Victor Hugo: { id: '1', name: 'Victor', surname: 'Hugo', publisher: { id: '1' } }
+Added Émile Zola: { id: '2', name: 'Émile', surname: 'Zola', publisher: { id: '1' } }
+Added German Publisher: { id: '2', name: 'German Press GmbH', authors: [] }
+French publisher  Authors (ids only, simplified): { id: '1', name: 'French Books Inc.', authors: [ { id: '1' }, { id: '2' } ] }
 French publisher  Authors (ids only, NOT simplified): {
   data: {
     type: 'publishers',
@@ -95,9 +95,9 @@ French publisher  Authors (ids only, NOT simplified): {
         data: [ { type: 'authors', id: '1' }, { type: 'authors', id: '2' } ]
       }
     },
-    links: { self: '/api/1.0/publishers/1' }
+    links: { self: '/api/publishers/1' }
   },
-  links: { self: '/api/1.0/publishers/1' }
+  links: { self: '/api/publishers/1' }
 }
 ```
 
@@ -145,12 +145,12 @@ French publisher  Authors (with authors, NOT simplified): {
       authors: {
         data: [ { type: 'authors', id: '1' }, { type: 'authors', id: '2' } ],
         links: {
-          self: '/api/1.0/publishers/1/relationships/authors',
-          related: '/api/1.0/publishers/1/authors'
+          self: '/api/publishers/1/relationships/authors',
+          related: '/api/publishers/1/authors'
         }
       }
     },
-    links: { self: '/api/1.0/publishers/1' }
+    links: { self: '/api/publishers/1' }
   },
   included: [
     {
@@ -158,17 +158,17 @@ French publisher  Authors (with authors, NOT simplified): {
       id: '1',
       attributes: { name: 'Victor', surname: 'Hugo' },
       relationships: { publisher: { data: { type: 'publishers', id: '1' } } },
-      links: { self: '/api/1.0/authors/1' }
+      links: { self: '/api/authors/1' }
     },
     {
       type: 'authors',
       id: '2',
       attributes: { name: 'Émile', surname: 'Zola' },
       relationships: { publisher: { data: { type: 'publishers', id: '1' } } },
-      links: { self: '/api/1.0/authors/2' }
+      links: { self: '/api/authors/2' }
     }
   ],
-  links: { self: '/api/1.0/publishers/1' }
+  links: { self: '/api/publishers/1' }
 }
 ```
 
@@ -184,19 +184,19 @@ const allPublishersWithAuthors = await api.resources.publishers.query({
 });
 // HTTP: GET /api/publishers?include=authors
 // Returns (simplified): [
-//   { id: '1', name: 'French Books Inc.', country_id: '1', 
+//   { id: '1', name: 'French Books Inc.', country: { id: '1' }, 
 //     authors: [
-//       { id: '1', name: 'Victor Hugo', publisher_id: '1' },
-//       { id: '2', name: 'Alexandre Dumas', publisher_id: '1' }
+//       { id: '1', name: 'Victor Hugo', publisher: { id: '1' } },
+//       { id: '2', name: 'Alexandre Dumas', publisher: { id: '1' } }
 //     ]
 //   },
-//   { id: '2', name: 'German Press GmbH', country_id: '2', 
+//   { id: '2', name: 'German Press GmbH', country: { id: '2' }, 
 //     authors: [
-//       { id: '3', name: 'Johann Wolfgang von Goethe', publisher_id: '2' }
+//       { id: '3', name: 'Johann Wolfgang von Goethe', publisher: { id: '2' } }
 //     ]
 //   },
-//   { id: '3', name: 'UK Books Ltd.', country_id: '3', authors: [] },
-//   { id: '4', name: 'Global Publishing', country_id: null, authors: [] }
+//   { id: '3', name: 'UK Books Ltd.', country: { id: '3' }, authors: [] },
+//   { id: '4', name: 'Global Publishing', country: null, authors: [] }
 // ]
 
 console.log('All Publishers with Authors:', inspect(allPublishersWithAuthors));
@@ -279,12 +279,12 @@ All Publishers with Authors (not simplified): {
             { type: 'authors', id: '2' }
           ],
           links: {
-            self: '/api/1.0/publishers/1/relationships/authors',
-            related: '/api/1.0/publishers/1/authors'
+            self: '/api/publishers/1/relationships/authors',
+            related: '/api/publishers/1/authors'
           }
         }
       },
-      links: { self: '/api/1.0/publishers/1' }
+      links: { self: '/api/publishers/1' }
     },
     {
       type: 'publishers',
@@ -294,12 +294,12 @@ All Publishers with Authors (not simplified): {
         authors: {
           data: [ { type: 'authors', id: '3' } ],
           links: {
-            self: '/api/1.0/publishers/2/relationships/authors',
-            related: '/api/1.0/publishers/2/authors'
+            self: '/api/publishers/2/relationships/authors',
+            related: '/api/publishers/2/authors'
           }
         }
       },
-      links: { self: '/api/1.0/publishers/2' }
+      links: { self: '/api/publishers/2' }
     },
     {
       type: 'publishers',
@@ -309,12 +309,12 @@ All Publishers with Authors (not simplified): {
         authors: {
           data: [],
           links: {
-            self: '/api/1.0/publishers/3/relationships/authors',
-            related: '/api/1.0/publishers/3/authors'
+            self: '/api/publishers/3/relationships/authors',
+            related: '/api/publishers/3/authors'
           }
         }
       },
-      links: { self: '/api/1.0/publishers/3' }
+      links: { self: '/api/publishers/3' }
     }
   ],
   included: [
@@ -323,30 +323,30 @@ All Publishers with Authors (not simplified): {
       id: '1',
       attributes: { name: 'Victor', surname: 'Hugo' },
       relationships: { publisher: { data: { type: 'publishers', id: '1' } } },
-      links: { self: '/api/1.0/authors/1' }
+      links: { self: '/api/authors/1' }
     },
     {
       type: 'authors',
       id: '2',
       attributes: { name: 'Émile', surname: 'Zola' },
       relationships: { publisher: { data: { type: 'publishers', id: '1' } } },
-      links: { self: '/api/1.0/authors/2' }
+      links: { self: '/api/authors/2' }
     },
     {
       type: 'authors',
       id: '3',
       attributes: { name: 'Johann', surname: 'Goethe' },
       relationships: { publisher: { data: { type: 'publishers', id: '2' } } },
-      links: { self: '/api/1.0/authors/3' }
+      links: { self: '/api/authors/3' }
     }
   ],
-  links: { self: '/api/1.0/publishers?include=authors' }
+  links: { self: '/api/publishers?include=authors' }
 }
 ```
 
 **Important Note on `hasMany` in Non-Simplified Mode:**
 
-In non-simplified (full JSON:API) mode, `hasMany` relationships in the `data` section of the parent resource only contain an empty `data` array or `links` to the related endpoint (e.g., `authors: { links: { related: '/api/1.0/publishers/1/authors' } }`). The actual related `author` resources are placed in the top-level `included` array. This is standard JSON:API behavior to avoid duplicating large amounts of data. The `included` array ensures that each included resource appears only once, even if referenced by multiple parent resources.
+In non-simplified (full JSON:API) mode, `hasMany` relationships in the `data` section of the parent resource only contain an empty `data` array or `links` to the related endpoint (e.g., `authors: { links: { related: '/api/publishers/1/authors' } }`). The actual related `author` resources are placed in the top-level `included` array. This is standard JSON:API behavior to avoid duplicating large amounts of data. The `included` array ensures that each included resource appears only once, even if referenced by multiple parent resources.
 
 ## Filtering by `hasMany` Relationships
 
@@ -368,7 +368,7 @@ const authorsFromGermanPress = await api.resources.authors.query({
 });
 // HTTP: GET /api/authors?filter[publisherName]=German
 // Returns: {
-//   data: [{ id: '3', name: 'Johann Wolfgang von Goethe', publisher_id: '2' }]
+//   data: [{ id: '3', name: 'Johann Wolfgang von Goethe', publisher: { id: '2' } }]
 // }
 
 console.log('Authors from German Press:', inspect(authorsFromGermanPress));
@@ -378,7 +378,7 @@ console.log('Authors from German Press:', inspect(authorsFromGermanPress));
 The output will be:
 
 ```text
-Authors from German Press: [ { id: '3', name: 'Johann', surname: 'Goethe', publisher_id: '2' } ]
+Authors from German Press: [ { id: '3', name: 'Johann', surname: 'Goethe', publisher: { id: '2' } } ]
 ```
 
 Once again, the search logic is always define on the `schema` -- that is, it's handled by the server -- and not by the client.