@antelopejs/interface-data-api 0.4.0 → 0.5.0

package/dist/internal/controller-types.d.ts

@@ -0,0 +1,19 @@
+/** @internal @packageDocumentation */
+import type { ParameterDecorator } from "@antelopejs/interface-core/decorators";
+export type DataControllerCallback<O = any> = {
+    args: (ParameterDecorator | ParameterDecorator[])[];
+    method: string;
+    func: (ctx: any, opts: O, ...args: any[]) => any;
+};
+export type DataControllerCallbackWithOptions<O = any> = {
+    endpoint?: string;
+    options?: Partial<O>;
+    callback: DataControllerCallback<O>;
+};
+export type ExtractCallback<T> = T extends DataControllerCallbackWithOptions ? T["callback"]["func"] : T extends DataControllerCallback ? T["func"] : never;
+export type DataControllerDef = {
+    [name: string]: DataControllerCallback | DataControllerCallbackWithOptions;
+};
+export type ExtractDefCallbacks<T extends {}> = {
+    [K in keyof T]: ExtractCallback<T[K]>;
+};

package/dist/internal/controller-types.js

@@ -0,0 +1,4 @@
+"use strict";
+/** @internal @packageDocumentation */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=controller-types.js.map

package/dist/internal/controller-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-types.js","sourceRoot":"","sources":["../../src/internal/controller-types.ts"],"names":[],"mappings":";AAAA,sCAAsC"}

package/dist/internal/default-filter.d.ts

@@ -0,0 +1,4 @@
+/** @internal @packageDocumentation */
+import type { DataAPIMeta } from "../metadata";
+export type DefaultFilterFunction = Parameters<DataAPIMeta["setFilter"]>[1];
+export declare function createDefaultFilter(): DefaultFilterFunction;

package/dist/internal/default-filter.js

@@ -0,0 +1,19 @@
+"use strict";
+/** @internal @packageDocumentation */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDefaultFilter = createDefaultFilter;
+const DEFAULT_FILTER_OPERATORS = {
+    eq: (proxy, value) => proxy.eq(value),
+    ne: (proxy, value) => proxy.ne(value),
+    gt: (proxy, value) => proxy.gt(value),
+    ge: (proxy, value) => proxy.ge(value),
+    lt: (proxy, value) => proxy.lt(value),
+    le: (proxy, value) => proxy.le(value),
+};
+function applyDefaultFilterMode(proxy, value, mode) {
+    return DEFAULT_FILTER_OPERATORS[mode](proxy, value);
+}
+function createDefaultFilter() {
+    return (_context, proxy, _key, value, mode) => applyDefaultFilterMode(proxy, value, mode);
+}
+//# sourceMappingURL=default-filter.js.map

package/dist/internal/default-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-filter.js","sourceRoot":"","sources":["../../src/internal/default-filter.ts"],"names":[],"mappings":";AAAA,sCAAsC;;AAoCtC,kDAGC;AApBD,MAAM,wBAAwB,GAA2B;IACvD,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC;IACrC,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC;IACrC,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC;IACrC,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC;IACrC,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC;IACrC,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC;CACtC,CAAC;AAEF,SAAS,sBAAsB,CAC7B,KAAyB,EACzB,KAAa,EACb,IAAoB;IAEpB,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACtD,CAAC;AAED,SAAgB,mBAAmB;IACjC,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAC5C,sBAAsB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC"}

package/dist/internal/deferred-joined-stream.d.ts

@@ -0,0 +1,11 @@
+/** @internal @packageDocumentation */
+import { type SchemaInstance, Stream } from "@antelopejs/interface-database";
+import type { DataAPIMeta } from "../metadata";
+/**
+ * Wraps `raw` into a {@link DeferredJoinedStream}. The wrapper keeps the
+ * raw stages as its own (an unobservable fallback, since every operation
+ * is overridden) while `build()` serializes the materialized pipeline, so
+ * a wrapper embedded as an argument of another query never leaks rows
+ * without the joined fields.
+ */
+export declare function wrapDeferredJoined(db: SchemaInstance<any>, meta: DataAPIMeta, names: Set<string>, raw: Stream<any>): Stream<any>;

package/dist/internal/deferred-joined-stream.js

@@ -0,0 +1,112 @@
+"use strict";
+/** @internal @packageDocumentation */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wrapDeferredJoined = wrapDeferredJoined;
+const interface_database_1 = require("@antelopejs/interface-database");
+const joined_1 = require("./joined");
+/**
+ * Stream returned by {@link List} when the deferred joined fields are not
+ * exposed to the caller: it resolves them itself, so consumers that
+ * destructure `[query, total]` alone still observe every `@Joined` field.
+ * The lookups are appended after `slice`/`nth`, keeping them on the
+ * requested page only; bare `count()` calls and field aggregates on
+ * non-joined fields skip them (left-join lookups never change the row
+ * count nor other fields); `changes()` attaches to the raw stream, since
+ * change feeds cannot carry the lookups. Any other operation may observe
+ * the joined fields, so it materializes them first.
+ */
+class DeferredJoinedStream extends interface_database_1.Stream {
+}
+function materializeDeferredJoin(stream) {
+    const { db, meta, names, raw } = stream.deferredJoin;
+    return (0, joined_1.Joined)(db, meta, raw, names);
+}
+function pagedDeferredJoinOperation(name) {
+    return function (...args) {
+        const { db, meta, names, raw } = this.deferredJoin;
+        // SAFETY: pagedDeferredJoinOperation is registered only under the slice key of DEFERRED_JOIN_OPERATION_FACTORIES, so name is always "slice", which every Stream has; raw is the Stream given to wrapDeferredJoined.
+        const paged = raw[name](...args);
+        return (0, joined_1.Joined)(db, meta, paged, names);
+    };
+}
+/**
+ * Resolves the joined fields through the stream form of {@link Joined}
+ * rather than its datum form: only the datum form has no way to drop the
+ * temporary key it stages (neither `Datum` nor `ValueProxy` exposes
+ * `without`), so it would leave `__joined_orig_*` on the row.
+ */
+function nthDeferredJoinOperation() {
+    return function (n) {
+        const { db, meta, names, raw } = this.deferredJoin;
+        return (0, joined_1.Joined)(db, meta, raw.slice(n, 1), names).nth(0);
+    };
+}
+function rawDeferredJoinOperation(name) {
+    return function (...args) {
+        // SAFETY: rawDeferredJoinOperation is registered only under the changes key of DEFERRED_JOIN_OPERATION_FACTORIES, so name is always "changes", which every Stream has; raw is the Stream given to wrapDeferredJoined.
+        return this.deferredJoin.raw[name](...args);
+    };
+}
+function fieldAggregateDeferredJoinOperation(name, bareCallOnRaw) {
+    return function (field) {
+        const { db, meta, names, raw } = this.deferredJoin;
+        if (!field) {
+            const bareTarget = bareCallOnRaw ? raw : materializeDeferredJoin(this);
+            // SAFETY: fieldAggregateDeferredJoinOperation is registered only under count, sum, avg, min, max and distinct, all Stream methods, and bareTarget is a Stream (raw, or the Stream Joined returns for it).
+            return bareTarget[name]();
+        }
+        const target = names.has(field)
+            ? (0, joined_1.Joined)(db, meta, raw, new Set([field]))
+            : raw;
+        // SAFETY: name is one of count, sum, avg, min, max and distinct, all Stream methods (see the factory table), and target is a Stream (raw, or the Stream Joined returns for it).
+        return target[name](field);
+    };
+}
+function forwardingDeferredJoinOperation(name) {
+    return function (...args) {
+        // SAFETY: name comes from wireDeferredJoinedStream, which lists the own method names of Stream.prototype plus run, cursor and build, all present on any Stream, and Joined returns a Stream for the raw Stream it is given.
+        return materializeDeferredJoin(this)[name](...args);
+    };
+}
+const DEFERRED_JOIN_OPERATION_FACTORIES = {
+    slice: pagedDeferredJoinOperation,
+    nth: nthDeferredJoinOperation,
+    changes: rawDeferredJoinOperation,
+    count: (name) => fieldAggregateDeferredJoinOperation(name, true),
+    sum: (name) => fieldAggregateDeferredJoinOperation(name, false),
+    avg: (name) => fieldAggregateDeferredJoinOperation(name, false),
+    min: (name) => fieldAggregateDeferredJoinOperation(name, false),
+    max: (name) => fieldAggregateDeferredJoinOperation(name, false),
+    distinct: (name) => fieldAggregateDeferredJoinOperation(name, false),
+};
+const DEFERRED_JOIN_INHERITED_OPERATIONS = new Set(["constructor", "cast"]);
+function wireDeferredJoinedStream() {
+    const operationNames = [
+        ...Object.getOwnPropertyNames(interface_database_1.Stream.prototype),
+        "run",
+        "cursor",
+        "build",
+    ].filter((name) => !DEFERRED_JOIN_INHERITED_OPERATIONS.has(name));
+    for (const name of operationNames) {
+        const factory = DEFERRED_JOIN_OPERATION_FACTORIES[name] ??
+            forwardingDeferredJoinOperation;
+        // SAFETY: name is a method name of Stream.prototype (or run, cursor, build), so the key is a writable data property on DeferredJoinedStream's prototype chain and assigning a function to it cannot throw; each installed operation takes the arguments of the Stream method it replaces.
+        DeferredJoinedStream.prototype[name] = factory(name);
+    }
+}
+wireDeferredJoinedStream();
+/**
+ * Wraps `raw` into a {@link DeferredJoinedStream}. The wrapper keeps the
+ * raw stages as its own (an unobservable fallback, since every operation
+ * is overridden) while `build()` serializes the materialized pipeline, so
+ * a wrapper embedded as an argument of another query never leaks rows
+ * without the joined fields.
+ */
+function wrapDeferredJoined(db, meta, names, raw) {
+    const wrapped = Object.create(DeferredJoinedStream.prototype);
+    // SAFETY: Object.create skips the StagedObject constructor that sets the protected stages field, so this assigns the same field, the stage list of raw, that the constructor would have set.
+    wrapped.stages = raw.build();
+    wrapped.deferredJoin = { db, meta, names, raw };
+    return wrapped;
+}
+//# sourceMappingURL=deferred-joined-stream.js.map

package/dist/internal/deferred-joined-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-joined-stream.js","sourceRoot":"","sources":["../../src/internal/deferred-joined-stream.ts"],"names":[],"mappings":";AAAA,sCAAsC;;AA4ItC,gDAaC;AAvJD,uEAA6E;AAG7E,qCAAkC;AASlC;;;;;;;;;;GAUG;AACH,MAAM,oBAAqB,SAAQ,2BAAW;CAE7C;AAOD,SAAS,uBAAuB,CAAC,MAA4B;IAC3D,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC;IACrD,OAAO,IAAA,eAAM,EAAC,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,0BAA0B,CAAC,IAAY;IAC9C,OAAO,UAAsC,GAAG,IAAW;QACzD,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC;QACnD,oNAAoN;QACpN,MAAM,KAAK,GAAI,GAAW,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC1C,OAAO,IAAA,eAAM,EAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,wBAAwB;IAC/B,OAAO,UAAsC,CAAS;QACpD,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC;QACnD,OAAO,IAAA,eAAM,EAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,IAAY;IAC5C,OAAO,UAAsC,GAAG,IAAW;QACzD,sNAAsN;QACtN,OAAQ,IAAI,CAAC,YAAY,CAAC,GAAW,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvD,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,mCAAmC,CAC1C,IAAY,EACZ,aAAsB;IAEtB,OAAO,UAAsC,KAAc;QACzD,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC;QACnD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,UAAU,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;YACvE,0MAA0M;YAC1M,OAAQ,UAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC;YAC7B,CAAC,CAAC,IAAA,eAAM,EAAC,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;YACzC,CAAC,CAAC,GAAG,CAAC;QACR,gLAAgL;QAChL,OAAQ,MAAc,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,+BAA+B,CACtC,IAAY;IAEZ,OAAO,UAAsC,GAAG,IAAW;QACzD,4NAA4N;QAC5N,OAAQ,uBAAuB,CAAC,IAAI,CAAS,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/D,CAAC,CAAC;AACJ,CAAC;AAOD,MAAM,iCAAiC,GAAmC;IACxE,KAAK,EAAE,0BAA0B;IACjC,GAAG,EAAE,wBAAwB;IAC7B,OAAO,EAAE,wBAAwB;IACjC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,mCAAmC,CAAC,IAAI,EAAE,IAAI,CAAC;IAChE,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,mCAAmC,CAAC,IAAI,EAAE,KAAK,CAAC;IAC/D,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,mCAAmC,CAAC,IAAI,EAAE,KAAK,CAAC;IAC/D,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,mCAAmC,CAAC,IAAI,EAAE,KAAK,CAAC;IAC/D,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,mCAAmC,CAAC,IAAI,EAAE,KAAK,CAAC;IAC/D,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,mCAAmC,CAAC,IAAI,EAAE,KAAK,CAAC;CACrE,CAAC;AAEF,MAAM,kCAAkC,GAAG,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;AAE5E,SAAS,wBAAwB;IAC/B,MAAM,cAAc,GAAG;QACrB,GAAG,MAAM,CAAC,mBAAmB,CAAC,2BAAM,CAAC,SAAS,CAAC;QAC/C,KAAK;QACL,QAAQ;QACR,OAAO;KACR,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,kCAAkC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,MAAM,OAAO,GACX,iCAAiC,CAAC,IAAI,CAAC;YACvC,+BAA+B,CAAC;QAClC,0RAA0R;QACzR,oBAAoB,CAAC,SAAiB,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED,wBAAwB,EAAE,CAAC;AAE3B;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAChC,EAAuB,EACvB,IAAiB,EACjB,KAAkB,EAClB,GAAgB;IAEhB,MAAM,OAAO,GAAyB,MAAM,CAAC,MAAM,CACjD,oBAAoB,CAAC,SAAS,CAC/B,CAAC;IACF,6LAA6L;IAC5L,OAAe,CAAC,MAAM,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC;IACtC,OAAO,CAAC,YAAY,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IAChD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/internal/field-types.d.ts

@@ -0,0 +1,183 @@
+/** @internal @packageDocumentation */
+import type { RequestContext } from "@antelopejs/interface-api";
+import type { Class } from "@antelopejs/interface-core/decorators";
+import type { Query, SchemaInstance, ValueProxy, ValueProxyOrValue } from "@antelopejs/interface-database";
+import type { Table } from "@antelopejs/interface-database-decorators";
+import type { AccessMode, DataAPIMeta } from "../metadata";
+/**
+ * A `@Joined` field declared on the target of a relation, captured so the
+ * foreign lookup can re-materialize it (joined fields are not physical columns,
+ * so a plain pluck of the target table would return them empty).
+ */
+export interface ForeignJoinedRef {
+    name: string;
+    table: string;
+    tableClass?: Class<Table>;
+    localKey: string;
+    remoteField: string;
+    remoteIndex: string;
+    schemaName?: string;
+}
+/** A value a request body or a table row holds. */
+export type FieldValue = string | number | boolean | null | Date | FieldValue[] | FieldValues;
+/** Fields by name, as a request body or a table row holds them. */
+export interface FieldValues {
+    [field: string]: FieldValue | undefined;
+}
+/** Parse outcome accepting the field value, carrying the value to write. */
+export interface FieldParseSuccess {
+    success: true;
+    data: FieldValue | undefined;
+}
+/** Parse outcome rejecting the field value. */
+export interface FieldParseFailure {
+    success: false;
+}
+/** Parse outcome of a field value, shaped like the result of zod's `safeParse`. */
+export type FieldParseResult = FieldParseSuccess | FieldParseFailure;
+/**
+ * Outcome of a field validator: `true`/`false` accepts or rejects the raw
+ * value, which is then written as received; a {@link FieldParseResult}
+ * accepts or rejects it, and on success its `data` is written instead of the
+ * raw value.
+ */
+export type FieldValidationResult = boolean | FieldParseResult;
+/** Field value validator, see {@link FieldValidationResult}. */
+export type FieldValidator = (value: FieldValue | undefined) => FieldValidationResult | Promise<FieldValidationResult>;
+/** What a foreign key declaration takes after the field and the other table. */
+export type ForeignOptions = [
+    index?: string,
+    multi?: boolean,
+    pluck?: string[],
+    schema?: string,
+    targetMeta?: DataAPIMeta
+];
+/** DataAPI Metadata field information. */
+export interface FieldData {
+    /**
+     * Field name in-database.
+     */
+    dbName?: string;
+    /**
+     * Field access mode.
+     *
+     * @see {@link AccessMode}
+     */
+    mode?: AccessMode;
+    /**
+     * Field access mode overrides per DataAPI action.
+     */
+    modeOverrides?: Record<string, AccessMode>;
+    /**
+     * DB Fields that should be selected for this field.
+     */
+    listable?: Record<string, string[]>;
+    /**
+     * Set of api methods for which the field must be set.
+     */
+    mandatory?: Set<string>;
+    /**
+     * Whether the DataAPI can be sorted using this field.
+     */
+    sortable?: {
+        indexed?: boolean;
+    };
+    /**
+     * Foreign key reference.
+     *
+     * `schemaName` is set when the target lives in another schema than the
+     * controller's table; runtime resolves the foreign lookup against that
+     * schema's default instance instead of the source instance.
+     */
+    foreign?: [
+        table: string,
+        tableClass?: Class<Table>,
+        index?: string,
+        multi?: true,
+        pluck?: string[],
+        schemaName?: string,
+        targetJoined?: ForeignJoinedRef[]
+    ];
+    /**
+     * Joined-from-other-table reference.
+     *
+     * Imports a single scalar field from another table at query time and
+     * flattens it into the row, enabling sort/search/filter natively in DB.
+     *
+     * `schemaName` is set when the target lives in another schema than the
+     * controller's table; runtime resolves the join against that schema's
+     * default instance instead of the source instance.
+     */
+    joined?: {
+        table: string;
+        tableClass?: Class<Table>;
+        localKey: string;
+        remoteField: string;
+        remoteIndex: string;
+        schemaName?: string;
+    };
+    /**
+     * In-database computed value.
+     *
+     * The expression is merged into each row at query time, enabling sort,
+     * filter, and pagination natively in DB.
+     */
+    computed?: ComputedFieldData;
+    /**
+     * Value validator callback.
+     */
+    validator?: FieldValidator;
+    /**
+     * Field property descriptor.
+     */
+    desc?: PropertyDescriptor;
+    /**
+     * Whether or not an `eq` filter with this field name can use an indexed lookup.
+     */
+    indexable?: boolean;
+}
+/**
+ * In-database computed field expression.
+ *
+ * Receives the row proxy and the schema instance of the controller's table.
+ * May return a row-local expression (built from `row`) or a per-row subquery
+ * (ex: an aggregate over another table).
+ */
+export type ComputedExpression = (row: ValueProxy<Record<string, any>>, db: SchemaInstance<any>) => ValueProxyOrValue<unknown> | Query<unknown>;
+/**
+ * Computed field options.
+ */
+export interface ComputedOptions {
+    /**
+     * Fallback merged over the computed value when the expression yields null
+     * (ex: `0` for an aggregate count over an empty set).
+     */
+    default?: unknown;
+}
+/**
+ * Computed field information.
+ */
+export interface ComputedFieldData extends ComputedOptions {
+    expr: ComputedExpression;
+}
+export type Comparison = "eq" | "ne" | "gt" | "ge" | "lt" | "le";
+export type FilterValue = [value: string, mode: Comparison];
+/**
+ * The filters of one field in a list request: one {@link FilterValue}, or
+ * several a row must all pass (`?filter_age=ge:18&filter_age=lt:65`).
+ */
+export type FieldFilter = FilterValue | FilterValue[];
+/**
+ * Filter callback.
+ */
+export type FilterFunction<T extends Record<string, any>, U extends Record<string, any> = Record<string, any>> = (context: RequestContext & {
+    this: T;
+}, proxy: ValueProxy<any>, key: string, ...rest: [value: FilterValue[0], mode: FilterValue[1], row: ValueProxy<U>]) => ValueProxyOrValue<boolean>;
+export interface ReadableAccessFields {
+    getters: [string, FieldData][];
+    props: [string, FieldData][];
+}
+export interface WritableAccessFields {
+    setters: [string, FieldData][];
+    props: [string, FieldData][];
+}

package/dist/internal/field-types.js

@@ -0,0 +1,4 @@
+"use strict";
+/** @internal @packageDocumentation */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=field-types.js.map

package/dist/internal/field-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-types.js","sourceRoot":"","sources":["../../src/internal/field-types.ts"],"names":[],"mappings":";AAAA,sCAAsC"}

package/dist/internal/filters.d.ts

@@ -0,0 +1,4 @@
+/** @internal @packageDocumentation */
+import { type FieldFilter, type FilterValue } from "../metadata";
+export declare function parseFilter(searchVal: string): FilterValue;
+export declare function copyFilter(filter: FieldFilter): FieldFilter;

package/dist/internal/filters.js

@@ -0,0 +1,15 @@
+"use strict";
+/** @internal @packageDocumentation */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFilter = parseFilter;
+exports.copyFilter = copyFilter;
+const metadata_1 = require("../metadata");
+function parseFilter(searchVal) {
+    const match = searchVal.match(/([^:]+):(.*)/);
+    return match ? [match[2], match[1]] : [searchVal, "eq"];
+}
+function copyFilter(filter) {
+    const copies = (0, metadata_1.FilterValuesOf)(filter).map((value) => [...value]);
+    return copies.length === 1 ? copies[0] : copies;
+}
+//# sourceMappingURL=filters.js.map

package/dist/internal/filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.js","sourceRoot":"","sources":["../../src/internal/filters.ts"],"names":[],"mappings":";AAAA,sCAAsC;;AAQtC,kCAGC;AAED,gCAGC;AAdD,0CAIqB;AAErB,SAAgB,WAAW,CAAC,SAAiB;IAC3C,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC9C,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAC5E,CAAC;AAED,SAAgB,UAAU,CAAC,MAAmB;IAC5C,MAAM,MAAM,GAAG,IAAA,yBAAc,EAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAe,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAC9E,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAClD,CAAC"}

package/dist/internal/foreign.d.ts

@@ -0,0 +1,6 @@
+/** @internal @packageDocumentation */
+import { type Datum, type SchemaInstance, type Stream } from "@antelopejs/interface-database";
+import type { DataAPIMeta } from "../metadata";
+export declare function Foreign(db: SchemaInstance<any>, meta: DataAPIMeta, query: Stream<any>, pluck?: Set<string>): Stream<any>;
+export declare function Foreign(db: SchemaInstance<any>, meta: DataAPIMeta, query: Datum<any>, pluck?: Set<string>): Datum<any>;
+export declare function Foreign(db: SchemaInstance<any>, meta: DataAPIMeta, query: Stream<any> | Datum<any>, pluck?: Set<string>): Stream<any> | Datum<any>;

package/dist/internal/foreign.js

@@ -0,0 +1,116 @@
+"use strict";
+/** @internal @packageDocumentation */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Foreign = Foreign;
+const interface_database_1 = require("@antelopejs/interface-database");
+const tables_1 = require("./tables");
+function Foreign(db, meta, query, pluck) {
+    if ((0, interface_database_1.IsStream)(query)) {
+        for (const [name, field] of Object.entries(meta.fields)) {
+            if (!field.foreign || (pluck && !pluck.has(name))) {
+                continue;
+            }
+            const [table, tableClass, index, multi, pluckField, schemaName, targetJoined,] = field.foreign;
+            const other = (0, tables_1.targetTable)(db, { table, tableClass, schemaName });
+            const hasTargetJoined = !multi && !!targetJoined?.length;
+            if (pluckField) {
+                const lookupPluck = hasTargetJoined
+                    ? Array.from(new Set([...pluckField, ...targetJoined.map((g) => g.localKey)]))
+                    : pluckField;
+                query = query.lookup((0, tables_1.pluckedTable)(other, ...lookupPluck), name, index || "_id");
+            }
+            else {
+                query = query.lookup(other, name, index || "_id");
+            }
+            if (hasTargetJoined) {
+                query = applyForeignJoinedStream(db, query, name, targetJoined);
+            }
+        }
+        return query;
+    }
+    else {
+        const oldForeign = (obj) => {
+            const changedFields = {};
+            for (const [name, field] of Object.entries(meta.fields)) {
+                if (!field.foreign || (pluck && !pluck.has(name))) {
+                    continue;
+                }
+                const [table, tableClass, index, multi, pluckField, schemaName, targetJoined,] = field.foreign;
+                const remote = (0, tables_1.targetTable)(db, { table, tableClass, schemaName });
+                if (multi) {
+                    changedFields[name] = obj
+                        .key(name)
+                        .cast()
+                        .default([])
+                        .map((val) => {
+                        let foreignObject = (0, tables_1.Get)(remote, val, index);
+                        if (pluckField) {
+                            foreignObject = foreignObject.pluck("_internal", ...pluckField);
+                        }
+                        return foreignObject.default(null);
+                    });
+                }
+                else {
+                    let foreignObject = (0, tables_1.Get)(remote, obj.key(name), index);
+                    if (targetJoined && targetJoined.length > 0) {
+                        foreignObject = applyForeignJoinedDatum(db, foreignObject, targetJoined);
+                    }
+                    changedFields[name] = foreignObject.default(null);
+                }
+            }
+            return obj.merge(changedFields);
+        };
+        return query.do(oldForeign);
+    }
+}
+/**
+ * Re-materializes the `@Joined` fields of a relation target on the looked-up
+ * sub-object (Stream/list path). The base `Foreign` lookup only plucks the
+ * target's physical columns, so a joined label would come back empty; here we
+ * resolve each joined field with a second lookup keyed on the target's
+ * (already plucked) local key, then merge it back into the relation object.
+ * For an orphan foreign key the merge yields `{ [joined]: null }`: the
+ * database DSL has no value-level conditional to null the relation here, so
+ * {@link Validation.ClearInternal} normalizes it back to a null relation.
+ */
+function applyForeignJoinedStream(db, stream, foreignName, groups) {
+    let s = stream;
+    for (const group of groups) {
+        const remoteTable = (0, tables_1.pluckedTable)((0, tables_1.targetTable)(db, group), group.remoteIndex, group.remoteField);
+        const tmpKey = `__fjoin_${foreignName}_${group.name}`;
+        s = s
+            .map((row) => row.merge({
+            [tmpKey]: row.key(foreignName).key(group.localKey),
+        }))
+            .lookup(remoteTable, tmpKey, group.remoteIndex)
+            .map((row) => row.merge({
+            [foreignName]: row.key(foreignName).merge({
+                [group.name]: row
+                    .key(tmpKey)
+                    .default({})
+                    .key(group.remoteField)
+                    .default(null),
+            }),
+        }))
+            .without(tmpKey);
+    }
+    return s;
+}
+/**
+ * Datum/get counterpart of {@link applyForeignJoinedStream}: resolves each of
+ * the target's `@Joined` fields with a secondary `Get` and merges it into the
+ * relation object.
+ */
+function applyForeignJoinedDatum(db, datum, groups) {
+    let d = datum;
+    for (const group of groups) {
+        const remoteTable = (0, tables_1.targetTable)(db, group);
+        d = d.do((row) => row.merge({
+            [group.name]: (0, tables_1.Get)(remoteTable, row.key(group.localKey), group.remoteIndex)
+                .key(group.remoteField)
+                .default(null),
+        }));
+    }
+    return d;
+}
+//# sourceMappingURL=foreign.js.map

package/dist/internal/foreign.js.map

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

package/dist/internal/guards.d.ts

@@ -0,0 +1,20 @@
+/** @internal @packageDocumentation */
+import type { FieldValue, FieldValues } from "./field-types";
+/** Whether a value is a string. */
+export declare function isString(value: unknown): value is string;
+/** Whether `typeof` calls a value an object and it is not `null`: arrays qualify, functions do not (the predicate `object` still types a function as one). */
+export declare function isObject(value: unknown): value is object;
+/** Whether a value is a function, whatever its parameters. */
+export declare function isFunction(value: unknown): value is Function;
+/** Whether a value is a number. */
+export declare function isNumber(value: unknown): value is number;
+/** Whether a value is a boolean. */
+export declare function isBoolean(value: unknown): value is boolean;
+/**
+ * Whether a value is a {@link FieldValue}: JSON or `Date` all the way down,
+ * with no cycle. The walk keeps its own stack, so a deeply nested body is
+ * not bounded by the call stack.
+ */
+export declare function isFieldValue(value: unknown): value is FieldValue;
+/** Whether a value is {@link FieldValues}: a plain object holding field values. */
+export declare function isFieldValues(value: unknown): value is FieldValues;

package/dist/internal/guards.js

@@ -0,0 +1,74 @@
+"use strict";
+/** @internal @packageDocumentation */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isString = isString;
+exports.isObject = isObject;
+exports.isFunction = isFunction;
+exports.isNumber = isNumber;
+exports.isBoolean = isBoolean;
+exports.isFieldValue = isFieldValue;
+exports.isFieldValues = isFieldValues;
+/** Whether a value is a string. */
+function isString(value) {
+    return typeof value === "string";
+}
+/** Whether `typeof` calls a value an object and it is not `null`: arrays qualify, functions do not (the predicate `object` still types a function as one). */
+function isObject(value) {
+    return typeof value === "object" && value !== null;
+}
+/** Whether a value is a function, whatever its parameters. */
+function isFunction(value) {
+    return typeof value === "function";
+}
+/** Whether a value is a number. */
+function isNumber(value) {
+    return typeof value === "number";
+}
+/** Whether a value is a boolean. */
+function isBoolean(value) {
+    return typeof value === "boolean";
+}
+/**
+ * Whether a value is a {@link FieldValue}: JSON or `Date` all the way down,
+ * with no cycle. The walk keeps its own stack, so a deeply nested body is
+ * not bounded by the call stack.
+ */
+function isFieldValue(value) {
+    const ancestors = new Set();
+    const steps = [{ value, leaving: false }];
+    for (let step = steps.pop(); step; step = steps.pop()) {
+        if (step.leaving) {
+            ancestors.delete(step.value);
+            continue;
+        }
+        const current = step.value;
+        if (current === null || isString(current) || isNumber(current))
+            continue;
+        if (isBoolean(current) || current instanceof Date)
+            continue;
+        if (!isObject(current) || ancestors.has(current))
+            return false;
+        const isArray = Array.isArray(current);
+        const prototype = Object.getPrototypeOf(current);
+        if (!isArray && prototype !== Object.prototype && prototype !== null) {
+            return false;
+        }
+        ancestors.add(current);
+        steps.push({ value: current, leaving: true });
+        for (const member of Object.values(current)) {
+            if (member === undefined && isArray)
+                return false;
+            if (member !== undefined)
+                steps.push({ value: member, leaving: false });
+        }
+    }
+    return true;
+}
+/** Whether a value is {@link FieldValues}: a plain object holding field values. */
+function isFieldValues(value) {
+    return (isFieldValue(value) &&
+        isObject(value) &&
+        !Array.isArray(value) &&
+        !(value instanceof Date));
+}
+//# sourceMappingURL=guards.js.map

package/dist/internal/guards.js.map

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