retold-harness 1.0.4 → 1.0.6

package/.vscode/launch.json

@@ -0,0 +1,18 @@
+{
+	// Use IntelliSense to learn about possible attributes.
+	// Hover to view descriptions of existing attributes.
+	// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+	"version": "0.2.0",
+	"configurations": [
+	
+		{
+			"type": "node",
+			"request": "launch",
+			"name": "Launch Program",
+			"skipFiles": [
+				"<node_internals>/**"
+			],
+			"program": "${workspaceFolder}/source/Retold-Harness.js"
+		}
+	]
+}

package/.vscode/settings.json

@@ -0,0 +1,19 @@
+{
+	"sqltools.connections": [
+		{
+			"mysqlOptions": {
+				"authProtocol": "default",
+				"enableSsl": "Disabled"
+			},
+			"ssh": "Disabled",
+			"previewLimit": 50,
+			"server": "localhost",
+			"port": 3306,
+			"driver": "MariaDB",
+			"name": "Local MariaDB server",
+			"database": "bookstore",
+			"username": "root",
+			"password": "123456789"
+		}
+	]
+}

package/Dockerfile_LUXURYCode

@@ -11,61 +11,20 @@ RUN sudo apt install vim curl tmux -y
 
 RUN echo "Building development image..."
 
-RUN echo "...installing vscode extensions..."
-
-# Mocha unit testing in the sidebar
-RUN code-server --install-extension hbenl.vscode-mocha-test-adapter
-RUN code-server --install-extension hbenl.test-adapter-converter
-RUN code-server --install-extension hbenl.vscode-test-explorer
-
-# Magic indentation rainbow
-RUN code-server --install-extension oderwat.indent-rainbow
-RUN code-server --install-extension dbaeumer.vscode-eslint
-
-# Contextual git
-RUN code-server --install-extension eamodio.gitlens
-
-# Other extensions (uncomment them to have them automagic, or run this from a terminal to install in the container):
-
-# SQL Tools
-RUN code-server --install-extension mtxr.sqltools
-RUN code-server --install-extension mtxr.sqltools-driver-mysql
-
-# Microsoft's AI code completion
-# RUN code-server --install-extension  VisualStudioExptTeam.vscodeintellicode
-
-# Live server -- make sure to open up the port on the docker image
-# RUN code-server --install-extension ritwickdey.LiveServer
-
-# Quick link to required modules' documentation
-# RUN code-server --install-extension bengreenier.vscode-node-readme
-
-# Switch up fonts
-# RUN code-server --install-extension evan-buss.font-switcher
-
-# Icons
-# RUN code-server --install-extension vscode-icons-team.vscode-icons
-# RUN code-server --install-extension PKief.material-icon-theme
-
-# Hover over CSS colors to see them previewed
-# RUN code-server --install-extension bierner.color-info
-
-# An easy on the eyes color theme
-# RUN code-server --install-extension daylerees.rainglow
-
 RUN echo "...configuring mariadb (mysql) server...."
 RUN sudo apt install default-mysql-server default-mysql-client -y
 RUN sudo sed -i "s|bind-address|#bind-address|g" /etc/mysql/mariadb.conf.d/50-server.cnf
-ADD ./source/model/sql_create/MySQL-Security.sql /home/coder/MySQL-Configure-Security.sql
+ADD ./source/model/mysql_create/MySQL-Configure-Security.sql /home/coder/MySQL-Configure-Security.sql
 ADD ./docker_scripts/MySQL-Laden-Entry.sh /usr/bin/MySQL-Laden-Entry.sh
 RUN ( sudo mysqld_safe --skip-grant-tables --skip-networking & ) && sleep 5 &&  mysql -u root < /home/coder/MySQL-Configure-Security.sql
 
 # Import the initial database
-COPY ./source/model/sql_create/BookStore-CreateDatabase.mysql.sql /home/coder/MySQL-Create-Databases.sql
-COPY ./source/model/sql_create/BookStore-DeleteAndRepopulateTables.sql /home/coder/MySQL-Repopulate-Databases.sql
+COPY ./source/model/mysql_create/MeadowModel-CreateMySQLDatabase.mysql.sql /home/coder/MeadowModel-CreateMySQLDatabase.mysql.sql
+COPY ./source/model/mysql_create/MeadowModel-PopulateDatabase.sql /home/coder/MeadowModel-PopulateDatabase.sql
+
 RUN sudo service mariadb restart && sleep 5 && mysql -u root -p"123456789" -e "CREATE DATABASE bookstore;"
-RUN sudo service mariadb restart && sleep 5 && mysql -u root -p"123456789" bookstore < /home/coder/MySQL-Create-Databases.sql
-RUN sudo service mariadb restart && sleep 5 && mysql -u root -p"123456789" bookstore < /home/coder/MySQL-Repopulate-Databases.sql
+RUN sudo service mariadb restart && sleep 5 && mysql -u root -p"123456789" bookstore < /home/coder/MeadowModel-CreateMySQLDatabase.mysql.sql
+RUN sudo service mariadb restart && sleep 5 && mysql -u root -p"123456789" bookstore < /home/coder/MeadowModel-PopulateDatabase.sql
 
 RUN echo "...mapping library specific volumes..."
 
@@ -81,10 +40,10 @@ RUN touch ~/.bashrc && chmod +x ~/.bashrc
 RUN curl https://raw.githubusercontent.com/creationix/nvm/master/install.sh | bash
 RUN chmod +x ~/.nvm/nvm.sh
 
-RUN echo "...installing node version 14 as the default..."
-RUN . ~/.nvm/nvm.sh && source ~/.bashrc && nvm install 14
-RUN . ~/.nvm/nvm.sh && source ~/.bashrc && nvm alias default 14
+RUN echo "...installing node version 20 as the default..."
+RUN . ~/.nvm/nvm.sh && source ~/.bashrc && nvm install 20
+RUN . ~/.nvm/nvm.sh && source ~/.bashrc && nvm alias default 20 
 
 WORKDIR /home/coder/retold-harness
 
-ENTRYPOINT ["/usr/bin/MySQL-Laden-Entry.sh"]
+ENTRYPOINT ["/usr/bin/MySQL-Laden-Entry.sh"]

package/Dockerfile_Service

@@ -0,0 +1,51 @@
+FROM debian:latest
+MAINTAINER steven velozo
+
+RUN echo "...installing debian dependencies..."
+RUN apt update
+RUN apt install vim curl tmux -y
+
+RUN echo "Building service image..."
+
+RUN echo "...configuring mariadb (mysql) server...."
+RUN apt install default-mysql-server default-mysql-client -y
+RUN sed -i "s|bind-address|#bind-address|g" /etc/mysql/mariadb.conf.d/50-server.cnf
+ADD ./source/model/mysql_create/MySQL-Configure-Security.sql /home/coder/MySQL-Configure-Security.sql
+ADD ./docker_scripts/MySQL-Laden-Entry.sh /usr/bin/MySQL-Laden-Entry.sh
+RUN ( mysqld_safe --skip-grant-tables --skip-networking & ) && sleep 5 && mysql -u root < /home/coder/MySQL-Configure-Security.sql
+
+# Import the initial database
+COPY ./source/model/mysql_create/MeadowModel-CreateMySQLDatabase.mysql.sql /home/coder/MeadowModel-CreateMySQLDatabase.mysql.sql
+COPY ./source/model/mysql_create/MeadowModel-PopulateDatabase.sql /home/coder/MeadowModel-PopulateDatabase.sql
+
+RUN service mariadb restart && sleep 5 && mysql -u root -p"123456789" -e "CREATE DATABASE bookstore;"
+RUN service mariadb restart && sleep 5 && mysql -u root -p"123456789" bookstore < /home/coder/MeadowModel-CreateMySQLDatabase.mysql.sql
+RUN service mariadb restart && sleep 5 && mysql -u root -p"123456789" bookstore < /home/coder/MeadowModel-PopulateDatabase.sql
+
+RUN echo "...mapping library specific volumes..."
+
+VOLUME /retold-harness
+
+SHELL ["/bin/bash", "-c"]
+
+RUN echo "...installing node version manager..."
+
+# Because there is a .bashrc chicken/egg problem, we will create one here to simulate logging in.  This is not great.
+RUN touch /root/.bashrc && chmod +x /root/.bashrc
+RUN curl -o- https://raw.githubusercontent.com/creationix/nvm/master/install.sh | bash
+
+ENV NODE_VERSION=20
+ENV NVM_DIR=/root/.nvm
+RUN . "$NVM_DIR/nvm.sh" && nvm install ${NODE_VERSION}
+RUN . "$NVM_DIR/nvm.sh" && nvm use v${NODE_VERSION}
+RUN . "$NVM_DIR/nvm.sh" && nvm alias default v${NODE_VERSION}
+ENV PATH="/root/.nvm/versions/node/v${NODE_VERSION}/bin/:${PATH}"
+RUN . /root/.nvm/nvm.sh && source /root/.bashrc && node --version
+RUN . /root/.nvm/nvm.sh && npm --version
+
+WORKDIR /retold-harness
+
+RUN echo "...configuring entrypoint..."
+
+COPY ./docker_scripts/MySQL-Laden-Entry-ServicesOnly.sh /root/MySQL-Laden-Entry-ServicesOnly.sh
+ENTRYPOINT ["/root/MySQL-Laden-Entry-ServicesOnly.sh"]

package/README.md

@@ -1,77 +1,127 @@
 # Retold Harness
 
-A basic set of API endpoints that contains Books, Authors, Joins and links to 
-images for the cover of each book.  Useful for more complex harnesses.  
+> A self-contained REST API harness for the Retold framework
 
-Entirely self-contained.
+Retold Harness brings together the full Retold stack into a running bookstore application.  Point a browser at `http://localhost:8086/1.0/Books/0/100` and you have a working REST API backed by 10,000+ book records, author joins, pricing, store inventory, and reviews -- all auto-generated from a Stricture DDL.
 
-## Getting up and Running
+## Features
 
-This package requires Docker to be installed on your workstation.  You can get 
-things running by typing the following commands:
+- **8-Entity Bookstore Model** - Users, Books, Authors, Joins, Prices, Stores, Inventory, and Reviews
+- **Auto-Generated CRUD** - Every entity gets Create, Read, Reads, Update, Delete, Count, Schema, and New endpoints
+- **Author Enrichment** - Single Book reads include an Authors array via behavior injection
+- **Pre-Loaded Data** - 10,000+ book records with associated authors for realistic testing
+- **Docker Containerized** - MariaDB database and API server in a single container
+- **Luxury Code IDE** - Browser-based VS Code for in-container development
+- **SQLite Testing** - In-memory test suite requires no external database
 
-### 1) Clone the code from github:
+## Quick Start (Docker)
 
-```
+```bash
 git clone https://github.com/stevenvelozo/retold-harness
+cd retold-harness
+npm run docker-dev-build
+npm run docker-dev-run
 ```
 
+The REST API is now at `http://localhost:8086`.
 
-### 2) Build the docker image:
+![Building the docker image](./images/Docker-Build-Image.png)
 
-_This can take a bit of time, depending on your connection speed and resources._
+## Quick Start (Manual)
 
-```
-npm run docker-dev-build
+```bash
+# Start a MariaDB container
+docker run -d --name mariadb -p 3306:3306 \
+  -e MARIADB_ROOT_PASSWORD=123456789 \
+  -e MARIADB_DATABASE=bookstore \
+  mariadb:latest
+
+# Create the tables
+cat ./source/model/mysql_create/MeadowModel-CreateMySQLDatabase.mysql.sql \
+  | docker exec -i mariadb mariadb -u root -p123456789 bookstore
+
+# Install and start
+npm install
+npm start
 ```
 
-![Building the docker image](./images/Docker-Build-Image.png)
+Alternatively, if using a true MySQL image:
 
-### 3) Create and launch the docker container:
+```bash
+cat ./source/model/mysql_create/MeadowModel-CreateMySQLDatabase.mysql.sql \
+  | docker exec -i mariadb mysql -u root -p123456789 bookstore
+```
 
-_This can also take a bit of time....._
+## Architecture
 
 ```
-npm run docker-dev-run
+Retold Harness
+  ├── Retold Data Service
+  │     ├── Orator + Restify (HTTP Server, port 8086)
+  │     ├── Meadow (DAL for each entity)
+  │     │     └── Provider (MySQL / SQLite)
+  │     └── Meadow Endpoints (REST Routes)
+  │           └── Behavior Injection (Author enrichment)
+  ├── Data Model (8 entities from Stricture DDL)
+  └── Docker Environment
+        ├── MariaDB (pre-loaded bookstore database)
+        └── Luxury Code (browser VS Code, port 20001)
 ```
 
-![Launching the docker container](./images/Docker-Run-Container.png)
+## REST API Examples
 
-![The launched container in the Docker UI](./images/Docker-Container-Launched.png)
+### List the first 100 books: `http://localhost:8086/1.0/Books/0/100`
 
+![The first 100 Books](./images/API-Book-List.png)
 
-## After the docker container is running there is quite a bit available:
+### Get a single book with authors: `http://localhost:8086/1.0/Book/1`
 
-* a REST web API serving JSON on port 8086
-* a browser-based visual studio code environment ready to run node applications
-* a mariadb instance, preloaded with 10,000 Book records joined to their Author records
-* a partridge
-* a pear tree
+When fetching a single book, the response includes an `Authors` array populated via the behavior injection hook in `source/Retold-Harness.js`.  In the multi-record list, the array is not included because the hook is only on the singular Read endpoint.
 
-### This all fits in less than 500 meg of RAM, and uses virtually no processor power
+![Book 1](./images/API-Book-First.png)
 
-![Docker statistics after a few minutes of running](./images/Docker-Container-Resources.png)
+### Filter authors by name: `http://localhost:8086/1.0/Authors/FilteredTo/FBV~Name~LK~Susan%25/0/10`
 
-## Some REST API Examples
+![The first 10 Susans](./images/API-Author-Susans.png)
 
-The REST endpoints are provided by the [meadow-endpoints](https://www.npmjs.com/package/meadow-endpoints) library on NPM.  Some examples of queries you can make:
+### Count books by genre
 
-### List the first 100 Books in the database: (http://localhost:8086/1.0/Books/0/100)
+```
+GET http://localhost:8086/1.0/Books/Count/FilteredTo/FBV~Genre~EQ~Science Fiction
+```
 
-![The first 100 Books](./images/API-Book-List.png)
-### Get the book with `IDBook` 1: (http://localhost:8086/1.0/Book/1)
+## Data Model
 
-You will notice that when requesting a single book, there is an `Authors` array populated with the connected authors for the particular book.  But in the list, the array was not filled out.  This is because in meadow-endpoints there is a post-operation behavior hook only attached to the read single record endpoint.  This is reflected in the `/source/Retold-Harness.js` code file in lines 14-41.
+| Entity | Columns | Description |
+|--------|---------|-------------|
+| User | 8 | System user accounts |
+| Book | 16 | Books with title, genre, ISBN, language, cover image |
+| Author | 11 | Authors with name and optional user link |
+| BookAuthorJoin | 4 | Many-to-many join between Books and Authors |
+| BookPrice | 15 | Pricing periods with discount and coupon support |
+| BookStore | 15 | Physical store locations with address |
+| BookStoreInventory | 16 | Stock levels per book per store |
+| Review | 13 | User reviews with text and rating |
 
-![Book 1](./images/API-Book-First.png)
+## Docker Services
 
-### List the first 10 Authors in the database whose name begins with `Susan`:  (http://localhost:8086/1.0/Authors/FilteredTo/FBV~Name~LK~Susan%25/0/10)
+| Port | Service |
+|------|---------|
+| 8086 | REST API |
+| 31306 | MariaDB (mapped from 3306) |
+| 20001 | Luxury Code (VS Code in browser) |
 
-![The first 10 Susans](./images/API-Author-Susans.png)
+### Database Credentials
+
+| Setting | Value |
+|---------|-------|
+| User | `root` |
+| Password | `123456789` |
+| Database | `bookstore` |
 
 ## Luxury Code
 
-Luxury code is a set of tools to provide easy debugging and test running regardless of environment.  These tools leverage the code-server browser implementation of the Visual Studio Code editor.  The first time you launch the browser editor, you will be asked for a password.  The password is: `luxury`
+Luxury Code provides a browser-based VS Code environment inside the Docker container.  Open `http://localhost:20001` after launching the container.  Password: `luxury`
 
 ![Launching Luxury Code requires a Password: luxury](./images/vscode-Login.png)
 
@@ -79,12 +129,54 @@ Luxury code is a set of tools to provide easy debugging and test running regardl
 
 ## MySQL
 
-The docker image also exposes a MySQL server (it's actually MariaDB but nobody is the wiser).  You can connect to and query this database directly from your tool of choice or other applications.  The user is: `root`, the port is `3306` and the password is: `123456789`
+The Docker image exposes a MariaDB server.  Connect with your tool of choice using the credentials above.
 
 ![MySQL Connection Info](./images/SQL-Connection.png)
 
 ![MySQL Query](./images/SQL-Query.png)
 
-## Customizing your Environment
+## Source Code
+
+The harness is intentionally minimal:
+
+- `source/Retold-Harness.js` (47 lines) -- Initializes Fable, creates the data service, installs the Author enrichment hook
+- `source/configuration-bookstore-serve-api.js` (41 lines) -- Configuration with MySQL connection details and server port
+- `source/model/` -- Compiled Stricture model, DDL source, SQL scripts, and sample data
+
+## Building the Model
+
+To recompile the DDL after schema changes:
+
+```bash
+npm run build-model
+```
+
+## Testing
+
+```bash
+npm test
+```
+
+The test suite contains 90 tests covering all 8 entities, behavior injection, DAL access, filtering, pagination, and soft deletes.  Tests use in-memory SQLite and require no external database.
+
+## Documentation
+
+Detailed documentation is available in the `docs/` folder and can be served locally:
+
+```bash
+npx docsify-cli serve docs
+```
+
+## Customizing
+
+All ports, passwords, and configuration are in `source/configuration-bookstore-serve-api.js` and `package.json`.  Docker port mappings are in the npm scripts.
+
+## Related Packages
 
-If you dislike the ports, passwords or anything else about this configuration all the code is readily available.  In the `package.json` file, the two convenience docker spin-up commands are there.  This is where you would change the port mapping for the API server, SQL server and other services.  Remember.... you broke it, you bought it.
+- [retold-data-service](https://github.com/stevenvelozo/retold-data-service) - All-in-one data service
+- [meadow](https://github.com/stevenvelozo/meadow) - Data access layer and ORM
+- [meadow-endpoints](https://github.com/stevenvelozo/meadow-endpoints) - Automatic REST endpoint generation
+- [foxhound](https://github.com/stevenvelozo/foxhound) - Query DSL for SQL generation
+- [stricture](https://github.com/stevenvelozo/stricture) - Schema definition language
+- [orator](https://github.com/stevenvelozo/orator) - API server abstraction
+- [fable](https://github.com/stevenvelozo/fable) - Service provider framework

package/docker_scripts/MySQL-Laden-Entry-ServicesOnly.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+
+service mariadb restart
+
+sleep 2
+
+source /root/.bashrc
+npm install
+npm start
+
+node ./source/Retold-Harness.js

package/docker_scripts/Service-Only_docker-entrypoint-combined.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+set -e
+
+# This script will:
+# 1. Start MariaDB (via the official entrypoint) in the background
+# 2. Wait until MariaDB is ready
+# 3. Start the Node app using pm2-runtime
+
+# If first argument looks like an option, assume it's for mysqld (same behavior as official entrypoint)
+if [ "${1:0:1}" = '-' ]; then
+  set -- mysqld "$@"
+fi
+
+# Start MariaDB using the original entrypoint in the background
+# The official MariaDB image's entrypoint is still at this path
+/usr/local/bin/docker-entrypoint.sh mysqld "$@" &
+
+# Wait for MariaDB to be ready
+echo "Waiting for MariaDB to be ready..."
+until mariadb-admin ping -h "127.0.0.1" --silent; do
+  sleep 1
+done
+echo "MariaDB is up."
+
+# Load nvm and use Node 22
+export NVM_DIR=/usr/local/nvm
+# shellcheck disable=SC1091
+. "$NVM_DIR/nvm.sh"
+
+# Move to app directory
+cd /usr/src/app
+
+echo "Starting Node app with pm2-runtime..."
+# pm2-runtime keeps the process in the foreground (PID 1) for Docker
+exec pm2-runtime ecosystem.config.js

package/docs/README.md

@@ -0,0 +1,48 @@
+# Retold Harness
+
+A self-contained REST API harness for the [Retold](https://github.com/stevenvelozo/retold) framework.  It serves a complete bookstore data model with auto-generated CRUD endpoints, pre-loaded sample data, and a containerized development environment.
+
+## What It Does
+
+Retold Harness brings together several Retold modules into a running application:
+
+- **[Retold Data Service](https://github.com/stevenvelozo/retold-data-service)** orchestrates the stack
+- **[Meadow](https://github.com/stevenvelozo/meadow)** provides the data access layer
+- **[Meadow Endpoints](https://github.com/stevenvelozo/meadow-endpoints)** generates REST routes
+- **[Orator](https://github.com/stevenvelozo/orator)** serves the HTTP API
+- **[Stricture](https://github.com/stevenvelozo/stricture)** defines the schema
+
+## Features
+
+- **8-Entity Bookstore Model** -- Users, Books, Authors, Joins, Prices, Stores, Inventory, and Reviews
+- **Auto-Generated CRUD** -- Every entity gets Create, Read, Reads, Update, Delete, Count, Schema, and New endpoints
+- **Author Enrichment** -- Single Book reads are enriched with related Author data via behavior injection
+- **Pre-Loaded Data** -- 10,000+ book records with associated authors for realistic testing
+- **Docker Containerized** -- MariaDB database and API server in a single container
+- **Luxury Code IDE** -- Browser-based VS Code for in-container development
+
+## Architecture
+
+```
+Retold Harness
+  ├── Retold Data Service
+  │     ├── Orator + Restify (HTTP Server, port 8086)
+  │     ├── Meadow (DAL for each entity)
+  │     │     └── Provider (MySQL / SQLite)
+  │     └── Meadow Endpoints (REST Routes)
+  │           └── Behavior Injection (Author enrichment)
+  ├── Data Model (8 entities from Stricture DDL)
+  └── Docker Environment
+        ├── MariaDB (pre-loaded bookstore database)
+        └── Luxury Code (browser VS Code, port 20001)
+```
+
+## Related Packages
+
+- [retold-data-service](https://github.com/stevenvelozo/retold-data-service) -- All-in-one data service
+- [meadow](https://github.com/stevenvelozo/meadow) -- Data access layer
+- [meadow-endpoints](https://github.com/stevenvelozo/meadow-endpoints) -- REST endpoint generation
+- [foxhound](https://github.com/stevenvelozo/foxhound) -- Query DSL
+- [stricture](https://github.com/stevenvelozo/stricture) -- Schema definition language
+- [orator](https://github.com/stevenvelozo/orator) -- API server abstraction
+- [fable](https://github.com/stevenvelozo/fable) -- Service provider framework

package/docs/_coverpage.md

@@ -0,0 +1,11 @@
+# Retold Harness <small>1.0</small>
+
+> A self-contained REST API harness for the Retold framework
+
+- Fully containerized bookstore REST API
+- 8 entities with 10,000+ pre-loaded records
+- Author enrichment via behavior injection
+- Browser-based VS Code development environment
+
+[Getting Started](#retold-harness)
+[GitHub](https://github.com/stevenvelozo/retold-harness)

package/docs/_sidebar.md

@@ -0,0 +1,20 @@
+- Getting Started
+	- [Overview](/)
+	- [Quick Start](quickstart.md)
+	- [Docker Setup](docker.md)
+
+- Data Model
+	- [Schema Overview](schema.md)
+	- [Entity Reference](entities.md)
+
+- API
+	- [REST Endpoints](endpoints.md)
+	- [Filtering & Pagination](filtering.md)
+
+- Customization
+	- [Behavior Injection](behavior-injection.md)
+	- [Configuration](configuration.md)
+
+- Development
+	- [Testing](testing.md)
+	- [Luxury Code IDE](luxury-code.md)

package/docs/behavior-injection.md

@@ -0,0 +1,100 @@
+# Behavior Injection
+
+The harness demonstrates behavior injection by enriching single Book reads with Author data.  This is the core customization pattern for Meadow Endpoints.
+
+## How It Works
+
+In `source/Retold-Harness.js`, a `Read-PostOperation` hook is installed on the Book endpoint after initialization:
+
+```javascript
+_Fable.MeadowEndpoints.Book.controller.BehaviorInjection.setBehavior('Read-PostOperation',
+    (pRequest, pRequestState, fRequestComplete) =>
+    {
+        // 1. Find join records for this book
+        _Fable.DAL.BookAuthorJoin.doReads(
+            _Fable.DAL.BookAuthorJoin.query.addFilter('IDBook', pRequestState.Record.IDBook),
+            (pJoinError, pJoinQuery, pJoinRecords) =>
+            {
+                // 2. Collect author IDs from the join records
+                let tmpAuthorList = pJoinRecords.map(j => j.IDAuthor);
+
+                if (tmpAuthorList.length < 1)
+                {
+                    pRequestState.Record.Authors = [];
+                    return fRequestComplete();
+                }
+
+                // 3. Load the actual Author records
+                _Fable.DAL.Author.doReads(
+                    _Fable.DAL.Author.query.addFilter('IDAuthor', tmpAuthorList, 'IN'),
+                    (pError, pQuery, pAuthors) =>
+                    {
+                        // 4. Attach to the response record
+                        pRequestState.Record.Authors = pAuthors;
+                        return fRequestComplete();
+                    });
+            });
+    });
+```
+
+## Result
+
+When you fetch a single book:
+
+```
+GET /1.0/Book/1
+```
+
+The response includes an `Authors` array:
+
+```json
+{
+    "IDBook": 1,
+    "Title": "Dune",
+    "Genre": "Science Fiction",
+    "Authors": [
+        {
+            "IDAuthor": 42,
+            "Name": "Frank Herbert"
+        }
+    ]
+}
+```
+
+When you fetch multiple books (`/1.0/Books/0/10`), the Authors array is **not** included because the hook is only on the singular Read, not the plural Reads.
+
+## Available Hook Points
+
+Each entity supports pre- and post-operation hooks:
+
+| Hook | When |
+|------|------|
+| `Create-PreOperation` | Before a record is created |
+| `Create-PostOperation` | After a record is created |
+| `Read-PreOperation` | Before a single record read |
+| `Read-PostOperation` | After a single record read |
+| `Reads-PreOperation` | Before a multi-record read |
+| `Reads-PostOperation` | After a multi-record read |
+| `Update-PreOperation` | Before a record is updated |
+| `Update-PostOperation` | After a record is updated |
+| `Delete-PreOperation` | Before a record is deleted |
+| `Delete-PostOperation` | After a record is deleted |
+| `Count-PreOperation` | Before a count query |
+| `Count-PostOperation` | After a count query |
+
+## Accessing Request State
+
+The callback receives three arguments:
+
+| Argument | Description |
+|----------|-------------|
+| `pRequest` | The HTTP request object |
+| `pRequestState` | Contains `Record`, `RecordToCreate`, `Query`, `SessionData` |
+| `fRequestComplete` | Callback: pass `false` to continue, `true` to signal an error |
+
+## Removing a Behavior
+
+```javascript
+delete _Fable.MeadowEndpoints.Book.controller
+    .BehaviorInjection._BehaviorFunctions['Read-PostOperation'];
+```