@antelopejs/interface-data-api 0.1.6 → 0.1.8

package/dist/tests/components/deferred_joined.test.js

@@ -0,0 +1,315 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_path_1 = __importDefault(require("node:path"));
+const interface_api_1 = require("@antelopejs/interface-api");
+const interface_data_api_1 = require("@antelopejs/interface-data-api");
+const components_1 = require("@antelopejs/interface-data-api/components");
+const metadata_1 = require("@antelopejs/interface-data-api/metadata");
+const interface_database_1 = require("@antelopejs/interface-database");
+const interface_database_decorators_1 = require("@antelopejs/interface-database-decorators");
+const chai_1 = require("chai");
+const utils_1 = require("../utils");
+const currentTestName = node_path_1.default
+    .basename(__filename)
+    .replace(/\.test\.(ts|js)$/, "");
+const authorTableName = `authors-${currentTestName}`;
+const bookTableName = `books-${currentTestName}`;
+const schemaName = "default";
+let Author = class Author extends interface_database_decorators_1.Table {
+};
+__decorate([
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", String)
+], Author.prototype, "name", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", String)
+], Author.prototype, "email", void 0);
+Author = __decorate([
+    (0, interface_database_decorators_1.RegisterTable)(authorTableName, schemaName)
+], Author);
+class AuthorModel extends (0, interface_database_decorators_1.BasicDataModel)(Author, authorTableName) {
+}
+let Book = class Book extends interface_database_decorators_1.Table {
+};
+__decorate([
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", String)
+], Book.prototype, "authorId", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", String)
+], Book.prototype, "title", void 0);
+Book = __decorate([
+    (0, interface_database_decorators_1.RegisterTable)(bookTableName, schemaName)
+], Book);
+class BookModel extends (0, interface_database_decorators_1.BasicDataModel)(Book, bookTableName) {
+}
+let _DeferredJoinedTestAPI = class _DeferredJoinedTestAPI extends (0, interface_data_api_1.DataController)(Book, {
+    list: interface_data_api_1.DefaultRoutes.List,
+}, (0, interface_api_1.Controller)(`/${currentTestName}`)) {
+};
+__decorate([
+    (0, metadata_1.ModelReference)(),
+    (0, interface_database_decorators_1.Model)(BookModel),
+    __metadata("design:type", BookModel)
+], _DeferredJoinedTestAPI.prototype, "bookModel", void 0);
+__decorate([
+    (0, metadata_1.Listable)(),
+    (0, metadata_1.Access)(metadata_1.AccessMode.ReadOnly),
+    __metadata("design:type", String)
+], _DeferredJoinedTestAPI.prototype, "_id", void 0);
+__decorate([
+    (0, metadata_1.Listable)(),
+    (0, metadata_1.Access)(metadata_1.AccessMode.ReadWrite),
+    __metadata("design:type", String)
+], _DeferredJoinedTestAPI.prototype, "authorId", void 0);
+__decorate([
+    (0, metadata_1.Listable)(),
+    (0, metadata_1.Access)(metadata_1.AccessMode.ReadWrite),
+    __metadata("design:type", String)
+], _DeferredJoinedTestAPI.prototype, "title", void 0);
+__decorate([
+    (0, metadata_1.Listable)(["authorId"]),
+    (0, metadata_1.Joined)({
+        table: authorTableName,
+        localKey: "authorId",
+        remoteField: "name",
+    }),
+    (0, metadata_1.Sortable)({ noIndex: true }),
+    (0, metadata_1.Filter)(),
+    __metadata("design:type", String)
+], _DeferredJoinedTestAPI.prototype, "name", void 0);
+__decorate([
+    (0, metadata_1.Listable)(["authorId"]),
+    (0, metadata_1.Joined)({
+        table: authorTableName,
+        localKey: "authorId",
+        remoteField: "email",
+    }),
+    __metadata("design:type", String)
+], _DeferredJoinedTestAPI.prototype, "email", void 0);
+_DeferredJoinedTestAPI = __decorate([
+    (0, interface_data_api_1.RegisterDataController)()
+], _DeferredJoinedTestAPI);
+const authorsDataset = [
+    { name: "Alice Carter", email: "alice@example.com" },
+    { name: "Bob Stone", email: "bob@example.com" },
+    { name: "Carol Wilde", email: "carol@example.com" },
+];
+const orphanAuthorId = "orphan-author-id";
+const reqCtx = {};
+describe("Query.List deferred joined self-resolution", () => {
+    it("resolves joined fields on a paged two-element destructure", async () => await resolvesJoinedFieldsOnPagedTwoElementDestructure());
+    it("keeps page lookups after the slice and off the count pipeline", async () => await keepsLookupsAfterSliceAndOffCountPipeline());
+    it("materializes joined fields for a caller-added filter", async () => await materializesJoinedFieldsForCallerFilter());
+    it("resolves joined fields on a directly awaited stream", async () => await resolvesJoinedFieldsOnDirectAwait());
+    it("resolves joined fields on an nth datum", async () => await resolvesJoinedFieldsOnNthDatum());
+    it("orders by a joined field when the caller sorts the stream", async () => await ordersByJoinedFieldOnCallerSort());
+    it("materializes the whole joined group when sorting through List", async () => await materializesJoinedGroupOnListSort());
+    it("exposes the deferred set and raw stream only on demand", async () => await exposesDeferredSetOnDemand());
+    it("keeps the change feed on the raw pipeline", async () => await keepsChangeFeedOnRawPipeline());
+    it("scopes field aggregates to the joined fields they read", async () => await scopesFieldAggregatesToJoinedFields());
+    it("still pages the lookups after a cast", async () => await stillPagesLookupsAfterCast());
+    it("materializes joined fields when embedded in another query", async () => await materializesJoinedFieldsWhenEmbedded());
+    it("resolves joined fields on async iteration", async () => await resolvesJoinedFieldsOnAsyncIteration());
+    it("returns the unresolved names when no database is provided", async () => await returnsUnresolvedNamesWithoutDatabase());
+});
+async function _seedTables() {
+    await (0, interface_database_decorators_1.RegisterSchema)(schemaName);
+    const schema = interface_database_1.Schema.get(schemaName);
+    if (schema) {
+        await schema.instance().table(bookTableName).delete();
+        await schema.instance().table(authorTableName).delete();
+    }
+    const schemaInstance = (0, utils_1.getSchemaInstance)(schemaName);
+    const authorModel = new AuthorModel(schemaInstance);
+    const bookModel = new BookModel(schemaInstance);
+    const authorIdsRecord = await authorModel.insert(authorsDataset);
+    const authorIds = Object.values(authorIdsRecord);
+    const booksDataset = [
+        { authorId: authorIds[0], title: "Alpha Rising" },
+        { authorId: authorIds[1], title: "Beta Stories" },
+        { authorId: authorIds[2], title: "Gamma Tales" },
+        { authorId: authorIds[0], title: "Alpha Returns" },
+        { authorId: orphanAuthorId, title: "Lost Chapter" },
+    ];
+    await bookModel.insert(booksDataset);
+    const thisObj = Object.create(_DeferredJoinedTestAPI.prototype);
+    return { thisObj, model: bookModel };
+}
+function listAsConsumer(harness) {
+    const meta = (0, interface_data_api_1.GetDataControllerMeta)(harness.thisObj);
+    return components_1.Query.List(harness.thisObj, meta, harness.model.table, reqCtx, undefined, undefined, harness.model.database);
+}
+function stageNames(staged) {
+    return staged.build().map((entry) => entry.stage);
+}
+async function resolvesJoinedFieldsOnPagedTwoElementDestructure() {
+    const harness = await _seedTables();
+    const [query, queryTotal] = listAsConsumer(harness);
+    const page = (await query
+        .slice(0, 10)
+        .pluck("_internal", "title", "name", "email"));
+    (0, chai_1.expect)(await queryTotal).to.equal(5);
+    (0, chai_1.expect)(page).to.have.lengthOf(5);
+    const alphaRising = page.find((book) => book.title === "Alpha Rising");
+    (0, chai_1.expect)(alphaRising?.name).to.equal("Alice Carter");
+    (0, chai_1.expect)(alphaRising?.email).to.equal("alice@example.com");
+    const lostChapter = page.find((book) => book.title === "Lost Chapter");
+    (0, chai_1.expect)(lostChapter?.name).to.equal(null);
+    (0, chai_1.expect)(lostChapter?.email).to.equal(null);
+}
+async function keepsLookupsAfterSliceAndOffCountPipeline() {
+    const harness = await _seedTables();
+    const [query, queryTotal] = listAsConsumer(harness);
+    const countStages = stageNames(queryTotal);
+    (0, chai_1.expect)(countStages).to.include("count");
+    (0, chai_1.expect)(countStages).to.not.include("lookup");
+    const directCountStages = stageNames(query.count());
+    (0, chai_1.expect)(directCountStages).to.include("count");
+    (0, chai_1.expect)(directCountStages).to.not.include("lookup");
+    const pageStages = stageNames(query.slice(0, 2));
+    (0, chai_1.expect)(pageStages.indexOf("lookup")).to.be.greaterThan(pageStages.indexOf("slice"));
+}
+async function materializesJoinedFieldsForCallerFilter() {
+    const harness = await _seedTables();
+    let [query] = listAsConsumer(harness);
+    query = query.filter((row) => row.key("name").eq("Alice Carter"));
+    const matches = (await query);
+    (0, chai_1.expect)(matches).to.have.lengthOf(2);
+    for (const match of matches) {
+        (0, chai_1.expect)(match.name).to.equal("Alice Carter");
+        (0, chai_1.expect)(match.email).to.equal("alice@example.com");
+    }
+    (0, chai_1.expect)(await query.count()).to.equal(2);
+}
+async function resolvesJoinedFieldsOnDirectAwait() {
+    const harness = await _seedTables();
+    const [query] = listAsConsumer(harness);
+    const rows = (await query);
+    (0, chai_1.expect)(rows).to.have.lengthOf(5);
+    const betaStories = rows.find((book) => book.title === "Beta Stories");
+    (0, chai_1.expect)(betaStories?.name).to.equal("Bob Stone");
+    (0, chai_1.expect)(betaStories?.email).to.equal("bob@example.com");
+}
+async function resolvesJoinedFieldsOnNthDatum() {
+    const harness = await _seedTables();
+    const [query] = listAsConsumer(harness);
+    const first = (await query.nth(0));
+    (0, chai_1.expect)(first.title).to.be.a("string");
+    (0, chai_1.expect)(first).to.have.property("name");
+    (0, chai_1.expect)(first).to.have.property("email");
+    const internalKeys = Object.keys(first).filter((key) => key.startsWith("__joined_orig_"));
+    (0, chai_1.expect)(internalKeys).to.deep.equal([]);
+    (0, chai_1.expect)(first.authorId).to.be.a("string");
+    const second = (await query.nth(1));
+    (0, chai_1.expect)(second.title).to.not.equal(first.title);
+}
+async function ordersByJoinedFieldOnCallerSort() {
+    const harness = await _seedTables();
+    const [query] = listAsConsumer(harness);
+    const rows = (await query.orderBy("name", "desc"));
+    (0, chai_1.expect)(rows).to.have.lengthOf(5);
+    const names = rows.map((book) => book.name).filter((name) => name !== null);
+    (0, chai_1.expect)(names).to.deep.equal([...names].sort().reverse());
+    (0, chai_1.expect)(names[0]).to.equal("Carol Wilde");
+}
+async function materializesJoinedGroupOnListSort() {
+    const harness = await _seedTables();
+    const meta = (0, interface_data_api_1.GetDataControllerMeta)(harness.thisObj);
+    const [query, , deferredJoined] = components_1.Query.List(harness.thisObj, meta, harness.model.table, reqCtx, ["name", "asc"], undefined, harness.model.database);
+    (0, chai_1.expect)(deferredJoined.size).to.equal(0);
+    const rows = (await query.slice(0, 5));
+    const gammaTales = rows.find((book) => book.title === "Gamma Tales");
+    (0, chai_1.expect)(gammaTales?.name).to.equal("Carol Wilde");
+    (0, chai_1.expect)(gammaTales?.email).to.equal("carol@example.com");
+}
+async function keepsChangeFeedOnRawPipeline() {
+    const harness = await _seedTables();
+    const [query] = listAsConsumer(harness);
+    const feedStages = stageNames(query.changes());
+    (0, chai_1.expect)(feedStages).to.include("changes");
+    (0, chai_1.expect)(feedStages).to.not.include("lookup");
+}
+async function scopesFieldAggregatesToJoinedFields() {
+    const harness = await _seedTables();
+    const [query] = listAsConsumer(harness);
+    const listedQuery = query;
+    const joinedFieldStages = stageNames(listedQuery.count("name"));
+    (0, chai_1.expect)(joinedFieldStages).to.include("count");
+    (0, chai_1.expect)(joinedFieldStages).to.include("lookup");
+    const plainFieldStages = stageNames(query.count("title"));
+    (0, chai_1.expect)(plainFieldStages).to.include("count");
+    (0, chai_1.expect)(plainFieldStages).to.not.include("lookup");
+    const distinctRowStages = stageNames(query.distinct());
+    (0, chai_1.expect)(distinctRowStages).to.include("distinct");
+    (0, chai_1.expect)(distinctRowStages).to.include("lookup");
+}
+async function stillPagesLookupsAfterCast() {
+    const harness = await _seedTables();
+    const [query] = listAsConsumer(harness);
+    const pageStages = stageNames(query.cast().slice(0, 2));
+    (0, chai_1.expect)(pageStages.indexOf("lookup")).to.be.greaterThan(pageStages.indexOf("slice"));
+    const page = (await query.cast().slice(0, 10));
+    const alphaRising = page.find((book) => book.title === "Alpha Rising");
+    (0, chai_1.expect)(alphaRising?.name).to.equal("Alice Carter");
+}
+async function materializesJoinedFieldsWhenEmbedded() {
+    const harness = await _seedTables();
+    const [query] = listAsConsumer(harness);
+    const unioned = (await harness.model.table.union(query));
+    (0, chai_1.expect)(unioned).to.have.lengthOf(10);
+    const withJoined = unioned.filter((row) => "name" in row);
+    (0, chai_1.expect)(withJoined).to.have.lengthOf(5);
+    (0, chai_1.expect)(withJoined.filter((row) => row.name === "Alice Carter")).to.have.lengthOf(2);
+}
+async function resolvesJoinedFieldsOnAsyncIteration() {
+    const harness = await _seedTables();
+    const [query] = listAsConsumer(harness);
+    const names = new Set();
+    for await (const row of query) {
+        names.add(row.name);
+        if (names.has("Alice Carter") && names.has("Bob Stone")) {
+            break;
+        }
+    }
+    (0, chai_1.expect)(names.has("Alice Carter")).to.equal(true);
+    (0, chai_1.expect)(names.has("Bob Stone")).to.equal(true);
+}
+async function returnsUnresolvedNamesWithoutDatabase() {
+    const harness = await _seedTables();
+    const meta = (0, interface_data_api_1.GetDataControllerMeta)(harness.thisObj);
+    const [query, , deferredJoined] = components_1.Query.List(harness.thisObj, meta, harness.model.table, reqCtx);
+    (0, chai_1.expect)(Array.from(deferredJoined).sort()).to.deep.equal(["email", "name"]);
+    const pageStages = stageNames(query.slice(0, 5));
+    (0, chai_1.expect)(pageStages).to.not.include("lookup");
+}
+async function exposesDeferredSetOnDemand() {
+    const harness = await _seedTables();
+    const meta = (0, interface_data_api_1.GetDataControllerMeta)(harness.thisObj);
+    const [, , resolvedByLayer] = listAsConsumer(harness);
+    (0, chai_1.expect)(resolvedByLayer.size).to.equal(0);
+    const [rawQuery, rawTotal, deferredJoined] = components_1.Query.List(harness.thisObj, meta, harness.model.table, reqCtx, undefined, undefined, harness.model.database, { exposeDeferredJoined: true });
+    (0, chai_1.expect)(Array.from(deferredJoined).sort()).to.deep.equal(["email", "name"]);
+    (0, chai_1.expect)(await rawTotal).to.equal(5);
+    const rawRows = (await rawQuery.slice(0, 5));
+    (0, chai_1.expect)(rawRows).to.have.lengthOf(5);
+    for (const row of rawRows) {
+        (0, chai_1.expect)(row).to.not.have.property("name");
+        (0, chai_1.expect)(row).to.not.have.property("email");
+    }
+}
+//# sourceMappingURL=deferred_joined.test.js.map

package/dist/tests/components/deferred_joined.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred_joined.test.js","sourceRoot":"","sources":["../../../src/tests/components/deferred_joined.test.ts"],"names":[],"mappings":"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"}

package/docs/1.introduction.md

@@ -0,0 +1,128 @@
+# Data API Documentation
+
+## Overview
+
+The Data API interface provides a declarative approach to building RESTful APIs with automatic CRUD operations. It connects your database models directly to API endpoints, handling validation, access control, foreign key resolution, and pagination with minimal boilerplate.
+
+## Key Features
+
+- **Database-to-API Mapping** - Expose database tables as REST endpoints through data controllers.
+- **Default CRUD Routes** - Built-in `get`, `list`, `new`, `edit`, and `delete` operations that work out of the box.
+- **Access Control** - Define read-only, write-only, or read-write permissions per field, with per-action overrides.
+- **Field Validation** - Attach custom validation functions to individual fields and enforce mandatory fields per operation.
+- **Listable Fields and Pagination** - Control which fields appear in list responses, with support for multiple pluck modes and paginated results.
+- **Sorting** - Mark fields as sortable to enable ordering in list queries.
+- **Foreign Key Resolution** - Automatically resolve relationships between tables with optional field plucking.
+- **Joined Fields** - Flatten a scalar field from another table onto each row so it can be sorted, filtered, and searched natively in the database.
+- **Computed Fields** - Merge in-database computed expressions (row-local values or aggregates over other tables) onto each row, natively sortable, filterable, and pageable.
+- **Filters** - Add default or custom filter logic to list endpoints using query parameters.
+- **Modifier Integration** - Automatic data transformation (encryption, hashing, localization) through database-decorators.
+
+## Dependencies
+
+This interface relies on the following AntelopeJS packages:
+
+- [@antelopejs/interface-api](https://github.com/AntelopeJS/interface-api) - API controllers and route registration.
+- [@antelopejs/interface-database-decorators](https://github.com/AntelopeJS/interface-database-decorators) - Database table definitions and models.
+
+## Quick Start
+
+The following example creates a full CRUD API for a `users` table.
+
+```typescript
+import { Controller } from "@antelopejs/interface-api";
+import {
+  DataController,
+  DefaultRoutes,
+  RegisterDataController,
+} from "@antelopejs/interface-data-api";
+import {
+  Access,
+  AccessMode,
+  Listable,
+  Mandatory,
+  ModelReference,
+} from "@antelopejs/interface-data-api/metadata";
+import {
+  BasicDataModel,
+  Field,
+  Index,
+  Model,
+  RegisterTable,
+  Table,
+} from "@antelopejs/interface-database-decorators";
+
+// Define the database table
+@RegisterTable("users")
+class User extends Table {
+  @Index({ primary: true })
+  @Field("string")
+  declare _id: string;
+
+  @Index()
+  @Field("string")
+  declare email: string;
+
+  @Field("string")
+  declare name: string;
+
+  @Field("string")
+  declare password: string;
+}
+
+// Create the database model
+class UserModel extends BasicDataModel(User, "users") {}
+
+// Create the data controller
+@RegisterDataController()
+class UserAPI extends DataController(
+  User,
+  DefaultRoutes.All,
+  Controller("/users"),
+) {
+  @ModelReference()
+  @Model(UserModel, "my-database")
+  declare userModel: UserModel;
+
+  @Listable()
+  @Access(AccessMode.ReadOnly)
+  declare _id: string;
+
+  @Listable()
+  @Access(AccessMode.ReadWrite)
+  @Mandatory("new", "edit")
+  declare email: string;
+
+  @Listable()
+  @Access(AccessMode.ReadWrite)
+  @Mandatory("new")
+  declare name: string;
+
+  @Access(AccessMode.WriteOnly)
+  @Mandatory("new")
+  declare password: string;
+}
+```
+
+This generates the following REST endpoints:
+
+| Method | Endpoint | Description |
+| ------ | -------- | ----------- |
+| GET | `/users/get?id=<id>` | Retrieve a single user |
+| GET | `/users/list?limit=10` | List users with pagination |
+| POST | `/users/new` | Create a new user |
+| PUT | `/users/edit?id=<id>` | Update an existing user |
+| DELETE | `/users/delete?id=<id>` | Delete a user |
+
+## Documentation Sections
+
+- [Data Controllers](./2.data-controllers.md) - Create and configure data controllers
+- [Routes](./3.routes.md) - Default routes, custom routes, and route options
+- [Access Rights](./4.access-rights.md) - Control field read/write permissions
+- [Validators](./5.validators.md) - Field-level validation and mandatory fields
+- [Listable Fields](./6.listable.md) - Pagination, pluck modes, and sorting
+- [Foreign Keys](./7.foreign-keys.md) - Establish relationships between tables
+- [Filters](./8.filters.md) - Add filtering capabilities to list endpoints
+- [Modifiers](./9.modifiers.md) - Automatic data transformation with database-decorators
+- [Joined Fields](./10.joined.md) - Flatten a remote field onto rows for native sort/filter
+- [Computed Fields](./11.computed.md) - In-database computed values, sortable and pageable natively

package/docs/10.joined.md

@@ -0,0 +1,157 @@
+# Joined Fields
+
+## Overview
+
+The `@Joined` decorator imports a single scalar field from another table and flattens it onto each row at query time. Unlike `@Foreign`, which embeds the full referenced record as a nested object in the response, `@Joined` copies one remote field to the top level of the row before sorting and filtering are applied. This makes the joined field natively sortable, filterable, and searchable in the database.
+
+Joined fields are read-only: the value is set by a lookup at query time and is never persisted on the controller's own table. Declaring a field as joined automatically sets its access mode to read-only and forces non-indexed sorting.
+
+## Basic Usage
+
+Apply `@Joined` to a field that should be populated from a remote table. The local row must carry a foreign key (`localKey`) that matches the remote table's `remoteIndex`.
+
+```typescript
+import { Joined } from "@antelopejs/interface-data-api/metadata";
+import {
+  Field,
+  Index,
+  RegisterTable,
+  Relation,
+  Table,
+} from "@antelopejs/interface-database-decorators";
+
+@RegisterTable("users")
+class User extends Table {
+  @Index({ primary: true })
+  @Field("string")
+  declare _id: string;
+
+  @Field("string")
+  declare name: string;
+}
+
+@RegisterTable("orders")
+class Order extends Table {
+  @Index({ primary: true })
+  @Field("string")
+  declare _id: string;
+
+  @Field("string")
+  @Relation({ to: () => User })
+  declare userId: string;
+
+  @Field("number")
+  declare total: number;
+}
+
+@RegisterDataController()
+class OrderAPI extends DataController(
+  Order,
+  DefaultRoutes.All,
+  Controller("/orders"),
+) {
+  @ModelReference()
+  @Model(OrderModel, "my-database")
+  declare orderModel: OrderModel;
+
+  @Listable()
+  @Access(AccessMode.ReadOnly)
+  declare _id: string;
+
+  declare userId: string;
+
+  // Pull the remote "name" field from the User referenced by userId
+  @Listable()
+  @Joined({
+    table: User,
+    localKey: "userId",
+    remoteField: "name",
+  })
+  declare userName: string;
+
+  @Listable()
+  @Access(AccessMode.ReadOnly)
+  declare total: number;
+}
+```
+
+A GET request to `/orders/get?id=order-123` returns the joined value at the top level:
+
+```json
+{
+  "_id": "order-123",
+  "userName": "Bob",
+  "total": 99.99
+}
+```
+
+## Decorator Parameters
+
+```typescript
+@Joined({ table, localKey, remoteField, remoteIndex?, schema? })
+```
+
+| Option | Type | Required | Default | Description |
+| ------ | ---- | -------- | ------- | ----------- |
+| `table` | `Class<Table>` or `string` | Yes | - | The remote table class or registered table name string |
+| `localKey` | `string` | Yes | - | The field on the local row holding the value matched against the remote table |
+| `remoteField` | `string` | Yes | - | The remote field whose value is flattened onto the row |
+| `remoteIndex` | `string` | No | `"_id"` | The index on the remote table to match `localKey` against |
+| `schema` | `string` | No | Controller schema | Name of the schema the remote table is registered in, when it differs from the controller's schema |
+
+## Sorting and Filtering
+
+Because the join is applied to the underlying query before sorting and filtering, joined fields behave like native columns. Combine `@Joined` with `@Sortable` or `@Filter` to order or filter by the imported value.
+
+```typescript
+@Sortable()
+@Filter()
+@Joined({
+  table: User,
+  localKey: "userId",
+  remoteField: "name",
+})
+declare userName: string;
+```
+
+Joined fields are always sorted without a database index (`@Sortable` is forced to non-indexed for them), since the value comes from a runtime lookup rather than a stored column.
+
+## Deferred Resolution on Lists
+
+`Query.List` only materializes the joined groups that the request's sort or filters reference before the count. The remaining display-only groups are deferred: the returned stream resolves them itself as soon as an operation can observe them, so destructuring `[query, total]` alone always yields rows with every `@Joined` field resolved.
+
+- Paging the stream (`slice`, `nth`) appends the lookups after the page boundary, so they only run on the returned rows.
+- A bare `count()` — and any field aggregate (`sum`, `min`, `distinct(field)`, ...) on a non-joined field — skips them entirely (left-join lookups never change the row count nor other fields).
+- `changes()` attaches to the raw stream, since change feeds cannot carry the join lookups.
+- Any other operation (`filter`, `orderBy`, `map`, ...) materializes them first, since it may read the joined values.
+
+The page-only benefit therefore holds as long as paging is the first thing the caller does. An operation applied to the whole stream before paging — a filter, a sort, or the `lookup` that `Query.Foreign` stages for a `@Foreign` field — materializes the joined groups over the whole matched set instead. The lookups still stay out of the count pipeline, but a caller that wants them strictly on the page must pass `{ exposeDeferredJoined: true }` to `Query.List` and resolve them itself after the slice: the raw stream is then returned unchanged and the third tuple element names the joined fields left to resolve with `Query.Joined`. This is what the default list route does, which also lets it limit the page lookups to the plucked fields.
+
+## Cross-Schema Joins
+
+By default, the remote table is resolved in the same schema as the controller's table. Use the `schema` option to join against a table registered in a different schema; the join is resolved against that schema's default instance.
+
+```typescript
+@Joined({
+  table: "users",
+  localKey: "userId",
+  remoteField: "name",
+  schema: "auth",
+})
+declare userName: string;
+```
+
+When a table class is passed, its schema is inferred from its `@RegisterTable` metadata. If both the class metadata and the explicit `schema` option specify a schema and they disagree, an error is thrown.
+
+## Joined vs. Foreign
+
+| Aspect | `@Joined` | `@Foreign` |
+| ------ | --------- | ---------- |
+| Result shape | A single scalar value flattened onto the row | The full referenced record (or plucked subset) nested under the field |
+| Access | Read-only (enforced) | Configurable via `@Access` |
+| Sort / filter | Native (join applied before sort/filter) | Not natively sortable/filterable on remote fields |
+| Multiple references | One remote field per decorator | Single or array (`multi`) references |
+
+## Next Steps
+
+See the [computed fields documentation](./11.computed.md) to generalize this merge mechanism to arbitrary in-database expressions, or the [modifiers documentation](./9.modifiers.md) to learn how automatic data transformation integrates with the Data API.