@atscript/db-client 0.1.146 → 0.1.148

package/dist/index.cjs

@@ -65,6 +65,29 @@ var ActionDisabledError = class extends ClientError {
 	}
 };
 /**
+* Typed marker thrown by `Client` when a query-targeted action request is
+* refused (body `name === 'ActionTargetError'`): `TARGET_INVALID` (400),
+* `TARGET_TOO_LARGE` (400, `cap`) or `TARGET_CHANGED` (409, `matched` — the
+* rows the query matches now; re-confirm and retry with that count).
+*
+* @since 0.1.147
+*/
+var ActionTargetError = class extends ClientError {
+	name = "ActionTargetError";
+	get code() {
+		return this.body.code;
+	}
+	get action() {
+		return this.body.action;
+	}
+	get matched() {
+		return this.body.matched;
+	}
+	get cap() {
+		return this.body.cap;
+	}
+};
+/**
 * Typed marker thrown by `Client._send` when the server response body's
 * `kind === 'version_mismatch'`. The transport / status / base body are
 * identical to a generic `ClientError`; this subclass adds a typed
@@ -143,6 +166,17 @@ var ActionUnsupportedError = class extends Error {
 * const all = await users.query()
 * const page = await users.pages({ filter: { active: true } }, 1, 20)
 * ```
+*
+* `D` (since 0.1.148) types the display-only fields the controller declares
+* with `@DbDecorations`: `$select` of the read methods accepts their keys and
+* rows carry them as optional properties. Filter and sort stay over `T`'s own
+* fields — a decoration is never filterable or sortable.
+*
+* ```typescript
+* const tickets = new Client<typeof Ticket, TicketDecorations>('/api/tickets')
+* const rows = await tickets.query({ controls: { $select: ['title', 'ownerName'] } })
+* rows[0].ownerName // string | undefined
+* ```
 */
 var Client = class {
 	_path;
@@ -186,8 +220,15 @@ var Client = class {
 	*
 	* `$select` may carry calendar buckets (`{ $bucket, $field, $tz?, $weekStart?, $as? }`);
 	* a `$groupBy` entry must be a dimension or a bucket alias (`ValidGroupBy`), and a
-	* bucket's value is typed as its `YYYY-MM-DD` label (`| null` for an optional source).
+	* bucket's value is typed as its `YYYY-MM-DD` (hour: `YYYY-MM-DDTHH:00`) label
+	* (`| null` for an optional source).
 	* Gap-fill between labels with `nextBucketLabel` (re-exported here).
+	*
+	* Arithmetic (since 0.1.148): `{ $fn: 'sum', $expr, $as }` aggregates a per-row
+	* expression over numeric fields; `{ $expr, $as }` computes over aliases of other
+	* numeric entries or numeric `$groupBy` fields (`number | null`). `first` / `last`
+	* read a representative row ordered by `$rowOrder`. The URL forms are `expr(a/b):x`,
+	* `sum(a*b):x`, `first(f):x` and `$rowOrder=f,-id`.
 	*/
 	async aggregate(query) {
 		return this._get("query", query);
@@ -250,8 +291,9 @@ var Client = class {
 		const controlStr = query?.controls ? (0, _uniqu_url_builder.buildUrl)({ controls: query.controls }) : "";
 		return this._getOrNull(this._idUrl("one", id, controlStr));
 	}
-	async insert(data) {
-		return this._request("POST", "", await this._prepareWrite(data, "insert"));
+	async insert(data, opts) {
+		const query = opts?.onConflict === "ignore" ? "?$onConflict=ignore" : "";
+		return this._request("POST", query, await this._prepareWrite(data, "insert"));
 	}
 	/**
 	* `PATCH /` — partial update one or many records by primary key.
@@ -323,6 +365,13 @@ var Client = class {
 	* `{ ids?, input? }` — `ids` carries `id` (object or array per level),
 	* `input` carries the form payload.
 	*
+	* **Delegated actions** (since 0.1.147). An action another controller owns
+	* (`owner`, e.g. a view listing its source table's actions) may carry
+	* `idMap`: each `id` is then a row (or identifier) of THIS controller and
+	* is mapped to the owner's identification — `{ [ownerField]:
+	* row[path] }` — before it is sent to `value` (the owner's route). A
+	* missing path throws `TypeError`. See {@link actionIdentifier}.
+	*
 	* @typeParam R Caller-asserted return shape from the action handler. The
 	*              server returns whatever the handler emits (commonly
 	*              `{ message?: string, ... }`); the client cannot validate.
@@ -332,15 +381,65 @@ var Client = class {
 		const action = meta.actions.find((a) => a.name === name);
 		if (!action) throw new ActionNotFoundError(name);
 		if (action.processor === "custom") throw new ActionUnsupportedError(name, "custom", `Action "${name}" has processor "custom" — applications must dispatch custom actions themselves; the client cannot.`);
+		const mapped = action.idMap ? mapDelegatedIds(action, id) : id;
 		if (action.processor === "navigate") {
-			const url = this._interpolateNavigateUrl(action, id, meta.preferredId);
+			const order = action.idMap ? Object.keys(action.idMap) : meta.preferredId;
+			const url = this._interpolateNavigateUrl(action, mapped, order);
 			await this._dispatchNavigate(action, url);
 			return;
 		}
-		const body = this._buildActionBody(action, id, input);
+		const body = this._buildActionBody(action, mapped, input);
 		return this._postAction(action, body);
 	}
 	/**
+	* Runs a `'rows'` action on every row matching a query (since 0.1.147) —
+	* the action's `/meta` entry must carry `queryTarget`. POSTs
+	* `{ query: { q, exclude?, expectCount?, maxRows? }, input? }` to
+	* `queryTarget.url` (a delegated action: the view resolves the rows and
+	* runs the owner's action in batches) or `value`. `q` is the `/query`
+	* string of `target.filter` / `search` / `index`.
+	*
+	* The server answers what the handler returns — for a delegated action
+	* (and a handler returning `target.summary()`) a
+	* {@link TDbActionTargetSummary}. Refusals arrive as
+	* {@link ActionTargetError}: `TARGET_TOO_LARGE` (`cap`), `TARGET_CHANGED`
+	* (`matched` differs from `expectCount`), `TARGET_INVALID`. Throws
+	* {@link ActionUnsupportedError} when the action takes no query target.
+	*
+	* @since 0.1.147
+	*/
+	async actionOnQuery(name, target, input) {
+		const action = await this._queryTargetAction(name);
+		const body = { query: queryTargetBody(target) };
+		if (input !== void 0) body.input = input;
+		return this._postQueryTarget(action, body);
+	}
+	/**
+	* How many rows {@link actionOnQuery} would target right now (a dry run:
+	* the handler does not run) — pass the answer as `expectCount` to make the
+	* real run fail with `TARGET_CHANGED` if the set changed in between.
+	*
+	* @since 0.1.147
+	*/
+	async countActionTarget(name, target) {
+		const action = await this._queryTargetAction(name);
+		const query = {
+			...queryTargetBody(target),
+			dryRun: true
+		};
+		return this._postQueryTarget(action, { query });
+	}
+	async _queryTargetAction(name) {
+		const action = (await this.meta()).actions.find((a) => a.name === name);
+		if (!action) throw new ActionNotFoundError(name);
+		if (!action.queryTarget || action.processor !== "backend") throw new ActionUnsupportedError(name, action.processor, `Action "${name}" does not accept a query target (no \`queryTarget\` in /meta).`);
+		return action;
+	}
+	_postQueryTarget(action, body) {
+		const path = action.queryTarget?.url ?? action.value;
+		return this._requestUrl("POST", `${this._baseUrl}${path}`, body, true);
+	}
+	/**
 	* `GET /meta/actions/:id` or `GET /meta/actions?k1=v1&k2=v2` — the
 	* row-level actions the caller may run on one row right now, and the
 	* reasons of those disabled with one: `{ actions, disabledReasons? }`.
@@ -519,6 +618,7 @@ var Client = class {
 				};
 			}
 			if (errorBody.name === "ActionDisabledError") throw new ActionDisabledError(res.status, errorBody);
+			if (errorBody.name === "ActionTargetError") throw new ActionTargetError(res.status, errorBody);
 			if (errorBody.kind === "version_mismatch") throw new VersionMismatchError(res.status, errorBody);
 			throw new ClientError(res.status, errorBody);
 		}
@@ -540,6 +640,60 @@ function describeCause(cause) {
 	if (cause instanceof Error) return cause.message || cause.name;
 	return String(cause);
 }
+/** The value at a dot `path` of `row`. */
+function valueAt(row, path) {
+	if (!path.includes(".") || Object.hasOwn(row, path)) return row[path];
+	let v = row;
+	for (const part of path.split(".")) v = v?.[part];
+	return v;
+}
+/**
+* The identifier `action` takes for one row (or identifier) of the
+* controller whose `/meta` listed it (since 0.1.147):
+*
+* - a delegated action with `idMap` → the owner's identification,
+*   `{ [ownerField]: rowOrId[path] }` (dot paths allowed); a missing value
+*   throws `TypeError` naming the action and the path;
+* - any other action → `rowOrId`'s `preferredId` fields when it carries them
+*   all, else `rowOrId` itself (already an identifier).
+*
+* UIs build `ids` from loaded rows with it; `Client.action()` applies the
+* `idMap` mapping itself.
+*
+* @since 0.1.147
+*/
+function actionIdentifier(action, rowOrId, preferredId) {
+	if (action.idMap) {
+		const out = {};
+		for (const [field, path] of Object.entries(action.idMap)) {
+			const value = valueAt(rowOrId, path);
+			if (value === void 0 || value === null) throw new TypeError(`client.action("${action.name}"): the identifier has no "${path}" — needed for the owner's "${field}".`);
+			out[field] = value;
+		}
+		return out;
+	}
+	if (preferredId.length > 0 && preferredId.every((f) => rowOrId[f] !== void 0)) return Object.fromEntries(preferredId.map((f) => [f, rowOrId[f]]));
+	return rowOrId;
+}
+/** `action()`'s `id` argument through a delegated action's `idMap` (shape errors are left to the body builder). */
+function mapDelegatedIds(action, id) {
+	const map = (one) => one !== null && typeof one === "object" && !Array.isArray(one) ? actionIdentifier(action, one, []) : one;
+	return Array.isArray(id) ? id.map(map) : map(id);
+}
+/** The wire `query` of a {@link TDbQueryTarget}. */
+function queryTargetBody(target) {
+	const controls = {};
+	if (target.search !== void 0) controls.$search = target.search;
+	if (target.index !== void 0) controls.$index = target.index;
+	const out = { q: (0, _uniqu_url_builder.buildUrl)({
+		filter: target.filter ?? {},
+		controls
+	}) };
+	if (target.exclude?.length) out.exclude = target.exclude;
+	if (target.expectCount !== void 0) out.expectCount = target.expectCount;
+	if (target.maxRows !== void 0) out.maxRows = target.maxRows;
+	return out;
+}
 /**
 * Render a single identifier field for substitution into a navigate-URL
 * template or human-readable string. `null` / `undefined` collapse to `""`
@@ -578,11 +732,19 @@ function describeShape(value) {
 //#endregion
 exports.ActionDisabledError = ActionDisabledError;
 exports.ActionNotFoundError = ActionNotFoundError;
+exports.ActionTargetError = ActionTargetError;
 exports.ActionUnsupportedError = ActionUnsupportedError;
 exports.Client = Client;
 exports.ClientError = ClientError;
 exports.TransportError = TransportError;
 exports.VersionMismatchError = VersionMismatchError;
+exports.actionIdentifier = actionIdentifier;
+Object.defineProperty(exports, "bucketSeries", {
+	enumerable: true,
+	get: function() {
+		return _uniqu_core.bucketSeries;
+	}
+});
 Object.defineProperty(exports, "bucketStartInstant", {
 	enumerable: true,
 	get: function() {

package/dist/index.d.cts

@@ -1,13 +1,15 @@
-import { A as TDbDeleteResult, C as OwnOf, D as RowOf, E as RelationInfo, F as Uniquery, I as UniqueryControls, L as ValidGroupBy, M as TDbInsertResult, N as TDbUpdateResult, O as SearchIndexInfo, P as TypedWithRelation, R as WeekStart, S as NavOf, T as PatchOf, _ as DbRow, a as ValidatorMode, b as IdOf, c as AggregateResult, d as BucketUnit, f as CalendarBucketLabel, g as DbPatch, h as DataOf, j as TDbInsertManyResult, k as ServerError, l as AtscriptClientShape, m as ClientResponse, n as ClientValidator, p as ClientOptions, r as ClientValidatorOptions, s as AggregateQuery, t as ClientValidationError, u as BucketExpr, v as FieldMeta, w as PageResult, x as MetaResponse, y as FilterExpr } from "./validator-810-rhnQ.cjs";
-import { AggregateExpr, AggregateQuery as AggregateQuery$1, AggregateResult as AggregateResult$1, BucketExpr as BucketExpr$1, Uniquery as Uniquery$1, UniqueryControls as UniqueryControls$1, ValidGroupBy as ValidGroupBy$1, bucketStartInstant, nextBucketLabel } from "@uniqu/core";
+import { A as SearchIndexInfo, B as Uniquery, C as MetaResponse, D as PatchOf, E as PageResult, F as TDbInsertManyResult, H as ValidGroupBy, I as TDbInsertResult, L as TDbQueryTarget, M as TDbDeleteResult, N as TDbInsertIgnoreResult, O as RelationInfo, P as TDbInsertManyIgnoreResult, R as TDbUpdateResult, S as IdOf, T as OwnOf, U as WeekStart, V as UniqueryControls, _ as DbRow, a as ValidatorMode, b as FieldMeta, c as AggregateResult, d as BucketUnit, f as CalendarBucketLabel, g as DbPatch, h as DataOf, j as ServerError, k as RowOf, l as AtscriptClientShape, m as ClientResponse, n as ClientValidator, p as ClientOptions, r as ClientValidatorOptions, s as AggregateQuery, t as ClientValidationError, u as BucketExpr, v as DecoratedControls, w as NavOf, x as FilterExpr, y as DecoratedQuery, z as TypedWithRelation } from "./validator-CVM7eNP7.cjs";
+import { AggregateExpr, AggregateOfExpr, AggregateQuery as AggregateQuery$1, AggregateResult as AggregateResult$1, BucketExpr as BucketExpr$1, BucketSeriesOptions, NextBucketOptions, SelectArithExpr, Uniquery as Uniquery$1, ValidGroupBy as ValidGroupBy$1, bucketSeries, bucketStartInstant, nextBucketLabel } from "@uniqu/core";
 import { TAtscriptAnnotatedType, TSerializedAnnotatedType } from "@atscript/typescript/utils";
-import { TCrudOp, TCrudPermissions, TDbActionInfo, TDbActionIntent, TDbActionLevel, TDbActionProcessor, TDbAvailableActions, TDbAvailableActions as TDbAvailableActions$1, TDbDeleteResult as TDbDeleteResult$1, TDbInsertManyResult as TDbInsertManyResult$1, TDbInsertResult as TDbInsertResult$1, TDbUpdateResult as TDbUpdateResult$1 } from "@atscript/db";
+import { TCrudOp, TCrudPermissions, TDbActionInfo, TDbActionInfo as TDbActionInfo$1, TDbActionIntent, TDbActionLevel, TDbActionProcessor, TDbActionTargetSummary, TDbActionTargetSummary as TDbActionTargetSummary$1, TDbAvailableActions, TDbAvailableActions as TDbAvailableActions$1, TDbDeleteResult as TDbDeleteResult$1, TDbInsertIgnoreResult as TDbInsertIgnoreResult$1, TDbInsertManyIgnoreResult as TDbInsertManyIgnoreResult$1, TDbInsertManyResult as TDbInsertManyResult$1, TDbInsertResult as TDbInsertResult$1, TDbUpdateResult as TDbUpdateResult$1 } from "@atscript/db";
 
 //#region src/client.d.ts
 type Own<T> = OwnOf<T>;
 type Nav<T> = NavOf<T>;
 type Id<T> = IdOf<T>;
 type Response<T, Q> = ClientResponse<T, Q>;
+/** A read row: the response over the own fields plus the declared decorations `D`, each optional. */
+type DecoratedRow<T, Q, D> = Response<T, Q> & Partial<D>;
 /**
  * HTTP client for moost-db REST endpoints.
  *
@@ -28,8 +30,19 @@ type Response<T, Q> = ClientResponse<T, Q>;
  * const all = await users.query()
  * const page = await users.pages({ filter: { active: true } }, 1, 20)
  * ```
+ *
+ * `D` (since 0.1.148) types the display-only fields the controller declares
+ * with `@DbDecorations`: `$select` of the read methods accepts their keys and
+ * rows carry them as optional properties. Filter and sort stay over `T`'s own
+ * fields — a decoration is never filterable or sortable.
+ *
+ * ```typescript
+ * const tickets = new Client<typeof Ticket, TicketDecorations>('/api/tickets')
+ * const rows = await tickets.query({ controls: { $select: ['title', 'ownerName'] } })
+ * rows[0].ownerName // string | undefined
+ * ```
  */
-declare class Client<T extends AtscriptClientShape = AtscriptClientShape> {
+declare class Client<T extends AtscriptClientShape = AtscriptClientShape, D extends object = Record<never, never>> {
   private readonly _path;
   private readonly _baseUrl;
   private readonly _fetch;
@@ -47,7 +60,7 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape> {
    * The response type narrows by the literal `$with` array in `query` —
    * relations not listed in `$with` are stripped from the row type.
    */
-  query<Q extends Uniquery$1<Own<T>, Nav<T>> = Uniquery$1<Own<T>, Nav<T>>>(query?: Q): Promise<Response<T, Q>[]>;
+  query<Q extends DecoratedQuery<T, D> = DecoratedQuery<T, D>>(query?: Q): Promise<DecoratedRow<T, Q, D>[]>;
   /**
    * `GET /query` with `$count: true` — returns record count.
    */
@@ -59,17 +72,24 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape> {
    *
    * `$select` may carry calendar buckets (`{ $bucket, $field, $tz?, $weekStart?, $as? }`);
    * a `$groupBy` entry must be a dimension or a bucket alias (`ValidGroupBy`), and a
-   * bucket's value is typed as its `YYYY-MM-DD` label (`| null` for an optional source).
+   * bucket's value is typed as its `YYYY-MM-DD` (hour: `YYYY-MM-DDTHH:00`) label
+   * (`| null` for an optional source).
    * Gap-fill between labels with `nextBucketLabel` (re-exported here).
+   *
+   * Arithmetic (since 0.1.148): `{ $fn: 'sum', $expr, $as }` aggregates a per-row
+   * expression over numeric fields; `{ $expr, $as }` computes over aliases of other
+   * numeric entries or numeric `$groupBy` fields (`number | null`). `first` / `last`
+   * read a representative row ordered by `$rowOrder`. The URL forms are `expr(a/b):x`,
+   * `sum(a*b):x`, `first(f):x` and `$rowOrder=f,-id`.
    */
-  aggregate<const Q extends AggregateQuery$1<Own<T>>>(query: Q & ValidGroupBy$1<Own<T>, Q>): Promise<Q["controls"]["$select"] extends readonly (string | AggregateExpr | BucketExpr$1)[] ? AggregateResult$1<Own<T>, Q["controls"]["$select"]>[] : Record<string, unknown>[]>;
+  aggregate<const Q extends AggregateQuery$1<Own<T>>>(query: Q & ValidGroupBy$1<Own<T>, Q>): Promise<Q["controls"]["$select"] extends readonly (string | AggregateExpr | BucketExpr$1 | AggregateOfExpr | SelectArithExpr)[] ? AggregateResult$1<Own<T>, Q["controls"]["$select"]>[] : Record<string, unknown>[]>;
   /**
    * `GET /pages` — paginated query with typed filter and relations.
    *
    * Response rows narrow by the literal `$with` array — same algebra as
    * {@link query}.
    */
-  pages<Q extends Uniquery$1<Own<T>, Nav<T>> = Uniquery$1<Own<T>, Nav<T>>>(query?: Q, page?: number, size?: number): Promise<PageResult<Response<T, Q>>>;
+  pages<Q extends DecoratedQuery<T, D> = DecoratedQuery<T, D>>(query?: Q, page?: number, size?: number): Promise<PageResult<DecoratedRow<T, Q, D>>>;
   /**
    * `GET /geo` — distance-ranked geospatial search (tables with `@db.index.geo`).
    *
@@ -79,13 +99,13 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape> {
    * in `query.controls`; filter / `$select` / `$with` / `$skip` / `$limit`
    * compose as usual.
    */
-  geoSearch<Q extends Uniquery$1<Own<T>, Nav<T>> = Uniquery$1<Own<T>, Nav<T>>>(point: [number, number], query?: Q): Promise<Array<Response<T, Q> & {
+  geoSearch<Q extends DecoratedQuery<T, D> = DecoratedQuery<T, D>>(point: [number, number], query?: Q): Promise<Array<DecoratedRow<T, Q, D> & {
     $distance: number;
   }>>;
   /**
    * `GET /geo` with `$page` / `$size` — paginated distance-ranked search.
    */
-  geoPages<Q extends Uniquery$1<Own<T>, Nav<T>> = Uniquery$1<Own<T>, Nav<T>>>(point: [number, number], query?: Q, page?: number, size?: number): Promise<PageResult<Response<T, Q> & {
+  geoPages<Q extends DecoratedQuery<T, D> = DecoratedQuery<T, D>>(point: [number, number], query?: Q, page?: number, size?: number): Promise<PageResult<DecoratedRow<T, Q, D> & {
     $distance: number;
   }>>;
   /**
@@ -95,10 +115,10 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape> {
    * `query.controls` — same algebra as {@link query}.
    */
   one<Q extends {
-    controls?: UniqueryControls$1<Own<T>, Nav<T>>;
+    controls?: DecoratedControls<T, D>;
   } = {
-    controls?: UniqueryControls$1<Own<T>, Nav<T>>;
-  }>(id: Id<T>, query?: Q): Promise<Response<T, Q> | null>;
+    controls?: DecoratedControls<T, D>;
+  }>(id: Id<T>, query?: Q): Promise<DecoratedRow<T, Q, D> | null>;
   /**
    * `POST /` — insert one record. The version column (if any) is optional —
    * the server initialises it; `$cas` is rejected (no meaning on insert).
@@ -108,6 +128,20 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape> {
    * `POST /` — insert many records.
    */
   insert(data: PatchOf<T>[]): Promise<TDbInsertManyResult$1>;
+  /**
+   * `POST /?$onConflict=ignore` — insert one record, skipping it when it
+   * collides on the primary key or a unique index (since 0.1.148).
+   */
+  insert(data: PatchOf<T>, opts: {
+    onConflict: "ignore";
+  }): Promise<TDbInsertIgnoreResult$1>;
+  /**
+   * `POST /?$onConflict=ignore` — insert many records, skipping the ones that
+   * collide; the result reports inserted and skipped input indices (since 0.1.148).
+   */
+  insert(data: PatchOf<T>[], opts: {
+    onConflict: "ignore";
+  }): Promise<TDbInsertManyIgnoreResult$1>;
   /**
    * `PATCH /` — partial update one or many records by primary key.
    *
@@ -166,11 +200,48 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape> {
    * `{ ids?, input? }` — `ids` carries `id` (object or array per level),
    * `input` carries the form payload.
    *
+   * **Delegated actions** (since 0.1.147). An action another controller owns
+   * (`owner`, e.g. a view listing its source table's actions) may carry
+   * `idMap`: each `id` is then a row (or identifier) of THIS controller and
+   * is mapped to the owner's identification — `{ [ownerField]:
+   * row[path] }` — before it is sent to `value` (the owner's route). A
+   * missing path throws `TypeError`. See {@link actionIdentifier}.
+   *
    * @typeParam R Caller-asserted return shape from the action handler. The
    *              server returns whatever the handler emits (commonly
    *              `{ message?: string, ... }`); the client cannot validate.
    */
   action<R = unknown>(name: string, id?: Partial<Own<T>> | Partial<Own<T>>[], input?: unknown): Promise<R>;
+  /**
+   * Runs a `'rows'` action on every row matching a query (since 0.1.147) —
+   * the action's `/meta` entry must carry `queryTarget`. POSTs
+   * `{ query: { q, exclude?, expectCount?, maxRows? }, input? }` to
+   * `queryTarget.url` (a delegated action: the view resolves the rows and
+   * runs the owner's action in batches) or `value`. `q` is the `/query`
+   * string of `target.filter` / `search` / `index`.
+   *
+   * The server answers what the handler returns — for a delegated action
+   * (and a handler returning `target.summary()`) a
+   * {@link TDbActionTargetSummary}. Refusals arrive as
+   * {@link ActionTargetError}: `TARGET_TOO_LARGE` (`cap`), `TARGET_CHANGED`
+   * (`matched` differs from `expectCount`), `TARGET_INVALID`. Throws
+   * {@link ActionUnsupportedError} when the action takes no query target.
+   *
+   * @since 0.1.147
+   */
+  actionOnQuery<R = TDbActionTargetSummary$1>(name: string, target: TDbQueryTarget<T>, input?: unknown): Promise<R>;
+  /**
+   * How many rows {@link actionOnQuery} would target right now (a dry run:
+   * the handler does not run) — pass the answer as `expectCount` to make the
+   * real run fail with `TARGET_CHANGED` if the set changed in between.
+   *
+   * @since 0.1.147
+   */
+  countActionTarget(name: string, target: TDbQueryTarget<T>): Promise<{
+    matched: number;
+  }>;
+  private _queryTargetAction;
+  private _postQueryTarget;
   /**
    * `GET /meta/actions/:id` or `GET /meta/actions?k1=v1&k2=v2` — the
    * row-level actions the caller may run on one row right now, and the
@@ -224,6 +295,22 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape> {
   private _requestUrl;
   private _send;
 }
+/**
+ * The identifier `action` takes for one row (or identifier) of the
+ * controller whose `/meta` listed it (since 0.1.147):
+ *
+ * - a delegated action with `idMap` → the owner's identification,
+ *   `{ [ownerField]: rowOrId[path] }` (dot paths allowed); a missing value
+ *   throws `TypeError` naming the action and the path;
+ * - any other action → `rowOrId`'s `preferredId` fields when it carries them
+ *   all, else `rowOrId` itself (already an identifier).
+ *
+ * UIs build `ids` from loaded rows with it; `Client.action()` applies the
+ * `idMap` mapping itself.
+ *
+ * @since 0.1.147
+ */
+declare function actionIdentifier(action: Pick<TDbActionInfo$1, "name" | "idMap">, rowOrId: Record<string, unknown>, preferredId: readonly string[]): Record<string, unknown>;
 /**
  * Render a single identifier field for substitution into a navigate-URL
  * template or human-readable string. `null` / `undefined` collapse to `""`
@@ -318,6 +405,34 @@ declare class ActionDisabledError extends ClientError {
    */
   get reasons(): (string | null)[] | undefined;
 }
+/**
+ * Wire-body shape for `ActionTargetError` responses (since 0.1.147): a
+ * query target the server refused — `code` says why.
+ */
+interface ActionTargetErrorBody extends ServerError {
+  name: "ActionTargetError";
+  code: "TARGET_INVALID" | "TARGET_TOO_LARGE" | "TARGET_CHANGED";
+  action: string;
+  /** `TARGET_CHANGED`: the current match count. */
+  matched?: number;
+  /** `TARGET_TOO_LARGE`: the most rows one request may target. */
+  cap?: number;
+}
+/**
+ * Typed marker thrown by `Client` when a query-targeted action request is
+ * refused (body `name === 'ActionTargetError'`): `TARGET_INVALID` (400),
+ * `TARGET_TOO_LARGE` (400, `cap`) or `TARGET_CHANGED` (409, `matched` — the
+ * rows the query matches now; re-confirm and retry with that count).
+ *
+ * @since 0.1.147
+ */
+declare class ActionTargetError extends ClientError {
+  name: string;
+  get code(): ActionTargetErrorBody["code"];
+  get action(): string;
+  get matched(): number | undefined;
+  get cap(): number | undefined;
+}
 /**
  * Wire-body shape for 409 OCC `version_mismatch` responses. Extends the base
  * `ServerError` envelope with a `kind` discriminator and the row's current
@@ -382,4 +497,4 @@ declare class ActionUnsupportedError extends Error {
   constructor(action: string, processor: string, message: string);
 }
 //#endregion
-export { ActionDisabledError, type ActionDisabledErrorBody, ActionNotFoundError, ActionUnsupportedError, type AggregateQuery, type AggregateResult, type AtscriptClientShape, type BucketExpr, type BucketUnit, type CalendarBucketLabel, Client, ClientError, type ClientOptions, type ClientResponse, type ClientValidationError, type ClientValidator, type ClientValidatorOptions, type DataOf, type DbPatch, type DbRow, type FieldMeta, type FilterExpr, type IdOf, type MetaResponse, type NavOf, type OwnOf, type PageResult, type PatchOf, type RelationInfo, type RowOf, type SearchIndexInfo, type ServerError, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbAvailableActions, type TDbDeleteResult, type TDbInsertManyResult, type TDbInsertResult, type TDbUpdateResult, type TSerializedAnnotatedType, TransportError, type TypedWithRelation, type Uniquery, type UniqueryControls, type ValidGroupBy, type ValidatorMode, VersionMismatchError, type VersionMismatchErrorBody, type WeekStart, bucketStartInstant, encodeNavigateId, formatIdentifier, formatIdentifierField, nextBucketLabel };
+export { ActionDisabledError, type ActionDisabledErrorBody, ActionNotFoundError, ActionTargetError, type ActionTargetErrorBody, ActionUnsupportedError, type AggregateQuery, type AggregateResult, type AtscriptClientShape, type BucketExpr, type BucketSeriesOptions, type BucketUnit, type CalendarBucketLabel, Client, ClientError, type ClientOptions, type ClientResponse, type ClientValidationError, type ClientValidator, type ClientValidatorOptions, type DataOf, type DbPatch, type DbRow, type FieldMeta, type FilterExpr, type IdOf, type MetaResponse, type NavOf, type NextBucketOptions, type OwnOf, type PageResult, type PatchOf, type RelationInfo, type RowOf, type SearchIndexInfo, type ServerError, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbActionTargetSummary, type TDbAvailableActions, type TDbDeleteResult, type TDbInsertIgnoreResult, type TDbInsertManyIgnoreResult, type TDbInsertManyResult, type TDbInsertResult, type TDbQueryTarget, type TDbUpdateResult, type TSerializedAnnotatedType, TransportError, type TypedWithRelation, type Uniquery, type UniqueryControls, type ValidGroupBy, type ValidatorMode, VersionMismatchError, type VersionMismatchErrorBody, type WeekStart, actionIdentifier, bucketSeries, bucketStartInstant, encodeNavigateId, formatIdentifier, formatIdentifierField, nextBucketLabel };

package/dist/index.d.mts

@@ -1,13 +1,15 @@
-import { A as TDbDeleteResult, C as OwnOf, D as RowOf, E as RelationInfo, F as Uniquery, I as UniqueryControls, L as ValidGroupBy, M as TDbInsertResult, N as TDbUpdateResult, O as SearchIndexInfo, P as TypedWithRelation, R as WeekStart, S as NavOf, T as PatchOf, _ as DbRow, a as ValidatorMode, b as IdOf, c as AggregateResult, d as BucketUnit, f as CalendarBucketLabel, g as DbPatch, h as DataOf, j as TDbInsertManyResult, k as ServerError, l as AtscriptClientShape, m as ClientResponse, n as ClientValidator, p as ClientOptions, r as ClientValidatorOptions, s as AggregateQuery, t as ClientValidationError, u as BucketExpr, v as FieldMeta, w as PageResult, x as MetaResponse, y as FilterExpr } from "./validator-CIm1ZCS5.mjs";
+import { A as SearchIndexInfo, B as Uniquery, C as MetaResponse, D as PatchOf, E as PageResult, F as TDbInsertManyResult, H as ValidGroupBy, I as TDbInsertResult, L as TDbQueryTarget, M as TDbDeleteResult, N as TDbInsertIgnoreResult, O as RelationInfo, P as TDbInsertManyIgnoreResult, R as TDbUpdateResult, S as IdOf, T as OwnOf, U as WeekStart, V as UniqueryControls, _ as DbRow, a as ValidatorMode, b as FieldMeta, c as AggregateResult, d as BucketUnit, f as CalendarBucketLabel, g as DbPatch, h as DataOf, j as ServerError, k as RowOf, l as AtscriptClientShape, m as ClientResponse, n as ClientValidator, p as ClientOptions, r as ClientValidatorOptions, s as AggregateQuery, t as ClientValidationError, u as BucketExpr, v as DecoratedControls, w as NavOf, x as FilterExpr, y as DecoratedQuery, z as TypedWithRelation } from "./validator-CPmmXTAt.mjs";
 import { TAtscriptAnnotatedType, TSerializedAnnotatedType } from "@atscript/typescript/utils";
-import { AggregateExpr, AggregateQuery as AggregateQuery$1, AggregateResult as AggregateResult$1, BucketExpr as BucketExpr$1, Uniquery as Uniquery$1, UniqueryControls as UniqueryControls$1, ValidGroupBy as ValidGroupBy$1, bucketStartInstant, nextBucketLabel } from "@uniqu/core";
-import { TCrudOp, TCrudPermissions, TDbActionInfo, TDbActionIntent, TDbActionLevel, TDbActionProcessor, TDbAvailableActions, TDbAvailableActions as TDbAvailableActions$1, TDbDeleteResult as TDbDeleteResult$1, TDbInsertManyResult as TDbInsertManyResult$1, TDbInsertResult as TDbInsertResult$1, TDbUpdateResult as TDbUpdateResult$1 } from "@atscript/db";
+import { AggregateExpr, AggregateOfExpr, AggregateQuery as AggregateQuery$1, AggregateResult as AggregateResult$1, BucketExpr as BucketExpr$1, BucketSeriesOptions, NextBucketOptions, SelectArithExpr, Uniquery as Uniquery$1, ValidGroupBy as ValidGroupBy$1, bucketSeries, bucketStartInstant, nextBucketLabel } from "@uniqu/core";
+import { TCrudOp, TCrudPermissions, TDbActionInfo, TDbActionInfo as TDbActionInfo$1, TDbActionIntent, TDbActionLevel, TDbActionProcessor, TDbActionTargetSummary, TDbActionTargetSummary as TDbActionTargetSummary$1, TDbAvailableActions, TDbAvailableActions as TDbAvailableActions$1, TDbDeleteResult as TDbDeleteResult$1, TDbInsertIgnoreResult as TDbInsertIgnoreResult$1, TDbInsertManyIgnoreResult as TDbInsertManyIgnoreResult$1, TDbInsertManyResult as TDbInsertManyResult$1, TDbInsertResult as TDbInsertResult$1, TDbUpdateResult as TDbUpdateResult$1 } from "@atscript/db";
 
 //#region src/client.d.ts
 type Own<T> = OwnOf<T>;
 type Nav<T> = NavOf<T>;
 type Id<T> = IdOf<T>;
 type Response<T, Q> = ClientResponse<T, Q>;
+/** A read row: the response over the own fields plus the declared decorations `D`, each optional. */
+type DecoratedRow<T, Q, D> = Response<T, Q> & Partial<D>;
 /**
  * HTTP client for moost-db REST endpoints.
  *
@@ -28,8 +30,19 @@ type Response<T, Q> = ClientResponse<T, Q>;
  * const all = await users.query()
  * const page = await users.pages({ filter: { active: true } }, 1, 20)
  * ```
+ *
+ * `D` (since 0.1.148) types the display-only fields the controller declares
+ * with `@DbDecorations`: `$select` of the read methods accepts their keys and
+ * rows carry them as optional properties. Filter and sort stay over `T`'s own
+ * fields — a decoration is never filterable or sortable.
+ *
+ * ```typescript
+ * const tickets = new Client<typeof Ticket, TicketDecorations>('/api/tickets')
+ * const rows = await tickets.query({ controls: { $select: ['title', 'ownerName'] } })
+ * rows[0].ownerName // string | undefined
+ * ```
  */
-declare class Client<T extends AtscriptClientShape = AtscriptClientShape> {
+declare class Client<T extends AtscriptClientShape = AtscriptClientShape, D extends object = Record<never, never>> {
   private readonly _path;
   private readonly _baseUrl;
   private readonly _fetch;
@@ -47,7 +60,7 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape> {
    * The response type narrows by the literal `$with` array in `query` —
    * relations not listed in `$with` are stripped from the row type.
    */
-  query<Q extends Uniquery$1<Own<T>, Nav<T>> = Uniquery$1<Own<T>, Nav<T>>>(query?: Q): Promise<Response<T, Q>[]>;
+  query<Q extends DecoratedQuery<T, D> = DecoratedQuery<T, D>>(query?: Q): Promise<DecoratedRow<T, Q, D>[]>;
   /**
    * `GET /query` with `$count: true` — returns record count.
    */
@@ -59,17 +72,24 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape> {
    *
    * `$select` may carry calendar buckets (`{ $bucket, $field, $tz?, $weekStart?, $as? }`);
    * a `$groupBy` entry must be a dimension or a bucket alias (`ValidGroupBy`), and a
-   * bucket's value is typed as its `YYYY-MM-DD` label (`| null` for an optional source).
+   * bucket's value is typed as its `YYYY-MM-DD` (hour: `YYYY-MM-DDTHH:00`) label
+   * (`| null` for an optional source).
    * Gap-fill between labels with `nextBucketLabel` (re-exported here).
+   *
+   * Arithmetic (since 0.1.148): `{ $fn: 'sum', $expr, $as }` aggregates a per-row
+   * expression over numeric fields; `{ $expr, $as }` computes over aliases of other
+   * numeric entries or numeric `$groupBy` fields (`number | null`). `first` / `last`
+   * read a representative row ordered by `$rowOrder`. The URL forms are `expr(a/b):x`,
+   * `sum(a*b):x`, `first(f):x` and `$rowOrder=f,-id`.
    */
-  aggregate<const Q extends AggregateQuery$1<Own<T>>>(query: Q & ValidGroupBy$1<Own<T>, Q>): Promise<Q["controls"]["$select"] extends readonly (string | AggregateExpr | BucketExpr$1)[] ? AggregateResult$1<Own<T>, Q["controls"]["$select"]>[] : Record<string, unknown>[]>;
+  aggregate<const Q extends AggregateQuery$1<Own<T>>>(query: Q & ValidGroupBy$1<Own<T>, Q>): Promise<Q["controls"]["$select"] extends readonly (string | AggregateExpr | BucketExpr$1 | AggregateOfExpr | SelectArithExpr)[] ? AggregateResult$1<Own<T>, Q["controls"]["$select"]>[] : Record<string, unknown>[]>;
   /**
    * `GET /pages` — paginated query with typed filter and relations.
    *
    * Response rows narrow by the literal `$with` array — same algebra as
    * {@link query}.
    */
-  pages<Q extends Uniquery$1<Own<T>, Nav<T>> = Uniquery$1<Own<T>, Nav<T>>>(query?: Q, page?: number, size?: number): Promise<PageResult<Response<T, Q>>>;
+  pages<Q extends DecoratedQuery<T, D> = DecoratedQuery<T, D>>(query?: Q, page?: number, size?: number): Promise<PageResult<DecoratedRow<T, Q, D>>>;
   /**
    * `GET /geo` — distance-ranked geospatial search (tables with `@db.index.geo`).
    *
@@ -79,13 +99,13 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape> {
    * in `query.controls`; filter / `$select` / `$with` / `$skip` / `$limit`
    * compose as usual.
    */
-  geoSearch<Q extends Uniquery$1<Own<T>, Nav<T>> = Uniquery$1<Own<T>, Nav<T>>>(point: [number, number], query?: Q): Promise<Array<Response<T, Q> & {
+  geoSearch<Q extends DecoratedQuery<T, D> = DecoratedQuery<T, D>>(point: [number, number], query?: Q): Promise<Array<DecoratedRow<T, Q, D> & {
     $distance: number;
   }>>;
   /**
    * `GET /geo` with `$page` / `$size` — paginated distance-ranked search.
    */
-  geoPages<Q extends Uniquery$1<Own<T>, Nav<T>> = Uniquery$1<Own<T>, Nav<T>>>(point: [number, number], query?: Q, page?: number, size?: number): Promise<PageResult<Response<T, Q> & {
+  geoPages<Q extends DecoratedQuery<T, D> = DecoratedQuery<T, D>>(point: [number, number], query?: Q, page?: number, size?: number): Promise<PageResult<DecoratedRow<T, Q, D> & {
     $distance: number;
   }>>;
   /**
@@ -95,10 +115,10 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape> {
    * `query.controls` — same algebra as {@link query}.
    */
   one<Q extends {
-    controls?: UniqueryControls$1<Own<T>, Nav<T>>;
+    controls?: DecoratedControls<T, D>;
   } = {
-    controls?: UniqueryControls$1<Own<T>, Nav<T>>;
-  }>(id: Id<T>, query?: Q): Promise<Response<T, Q> | null>;
+    controls?: DecoratedControls<T, D>;
+  }>(id: Id<T>, query?: Q): Promise<DecoratedRow<T, Q, D> | null>;
   /**
    * `POST /` — insert one record. The version column (if any) is optional —
    * the server initialises it; `$cas` is rejected (no meaning on insert).
@@ -108,6 +128,20 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape> {
    * `POST /` — insert many records.
    */
   insert(data: PatchOf<T>[]): Promise<TDbInsertManyResult$1>;
+  /**
+   * `POST /?$onConflict=ignore` — insert one record, skipping it when it
+   * collides on the primary key or a unique index (since 0.1.148).
+   */
+  insert(data: PatchOf<T>, opts: {
+    onConflict: "ignore";
+  }): Promise<TDbInsertIgnoreResult$1>;
+  /**
+   * `POST /?$onConflict=ignore` — insert many records, skipping the ones that
+   * collide; the result reports inserted and skipped input indices (since 0.1.148).
+   */
+  insert(data: PatchOf<T>[], opts: {
+    onConflict: "ignore";
+  }): Promise<TDbInsertManyIgnoreResult$1>;
   /**
    * `PATCH /` — partial update one or many records by primary key.
    *
@@ -166,11 +200,48 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape> {
    * `{ ids?, input? }` — `ids` carries `id` (object or array per level),
    * `input` carries the form payload.
    *
+   * **Delegated actions** (since 0.1.147). An action another controller owns
+   * (`owner`, e.g. a view listing its source table's actions) may carry
+   * `idMap`: each `id` is then a row (or identifier) of THIS controller and
+   * is mapped to the owner's identification — `{ [ownerField]:
+   * row[path] }` — before it is sent to `value` (the owner's route). A
+   * missing path throws `TypeError`. See {@link actionIdentifier}.
+   *
    * @typeParam R Caller-asserted return shape from the action handler. The
    *              server returns whatever the handler emits (commonly
    *              `{ message?: string, ... }`); the client cannot validate.
    */
   action<R = unknown>(name: string, id?: Partial<Own<T>> | Partial<Own<T>>[], input?: unknown): Promise<R>;
+  /**
+   * Runs a `'rows'` action on every row matching a query (since 0.1.147) —
+   * the action's `/meta` entry must carry `queryTarget`. POSTs
+   * `{ query: { q, exclude?, expectCount?, maxRows? }, input? }` to
+   * `queryTarget.url` (a delegated action: the view resolves the rows and
+   * runs the owner's action in batches) or `value`. `q` is the `/query`
+   * string of `target.filter` / `search` / `index`.
+   *
+   * The server answers what the handler returns — for a delegated action
+   * (and a handler returning `target.summary()`) a
+   * {@link TDbActionTargetSummary}. Refusals arrive as
+   * {@link ActionTargetError}: `TARGET_TOO_LARGE` (`cap`), `TARGET_CHANGED`
+   * (`matched` differs from `expectCount`), `TARGET_INVALID`. Throws
+   * {@link ActionUnsupportedError} when the action takes no query target.
+   *
+   * @since 0.1.147
+   */
+  actionOnQuery<R = TDbActionTargetSummary$1>(name: string, target: TDbQueryTarget<T>, input?: unknown): Promise<R>;
+  /**
+   * How many rows {@link actionOnQuery} would target right now (a dry run:
+   * the handler does not run) — pass the answer as `expectCount` to make the
+   * real run fail with `TARGET_CHANGED` if the set changed in between.
+   *
+   * @since 0.1.147
+   */
+  countActionTarget(name: string, target: TDbQueryTarget<T>): Promise<{
+    matched: number;
+  }>;
+  private _queryTargetAction;
+  private _postQueryTarget;
   /**
    * `GET /meta/actions/:id` or `GET /meta/actions?k1=v1&k2=v2` — the
    * row-level actions the caller may run on one row right now, and the
@@ -224,6 +295,22 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape> {
   private _requestUrl;
   private _send;
 }
+/**
+ * The identifier `action` takes for one row (or identifier) of the
+ * controller whose `/meta` listed it (since 0.1.147):
+ *
+ * - a delegated action with `idMap` → the owner's identification,
+ *   `{ [ownerField]: rowOrId[path] }` (dot paths allowed); a missing value
+ *   throws `TypeError` naming the action and the path;
+ * - any other action → `rowOrId`'s `preferredId` fields when it carries them
+ *   all, else `rowOrId` itself (already an identifier).
+ *
+ * UIs build `ids` from loaded rows with it; `Client.action()` applies the
+ * `idMap` mapping itself.
+ *
+ * @since 0.1.147
+ */
+declare function actionIdentifier(action: Pick<TDbActionInfo$1, "name" | "idMap">, rowOrId: Record<string, unknown>, preferredId: readonly string[]): Record<string, unknown>;
 /**
  * Render a single identifier field for substitution into a navigate-URL
  * template or human-readable string. `null` / `undefined` collapse to `""`
@@ -318,6 +405,34 @@ declare class ActionDisabledError extends ClientError {
    */
   get reasons(): (string | null)[] | undefined;
 }
+/**
+ * Wire-body shape for `ActionTargetError` responses (since 0.1.147): a
+ * query target the server refused — `code` says why.
+ */
+interface ActionTargetErrorBody extends ServerError {
+  name: "ActionTargetError";
+  code: "TARGET_INVALID" | "TARGET_TOO_LARGE" | "TARGET_CHANGED";
+  action: string;
+  /** `TARGET_CHANGED`: the current match count. */
+  matched?: number;
+  /** `TARGET_TOO_LARGE`: the most rows one request may target. */
+  cap?: number;
+}
+/**
+ * Typed marker thrown by `Client` when a query-targeted action request is
+ * refused (body `name === 'ActionTargetError'`): `TARGET_INVALID` (400),
+ * `TARGET_TOO_LARGE` (400, `cap`) or `TARGET_CHANGED` (409, `matched` — the
+ * rows the query matches now; re-confirm and retry with that count).
+ *
+ * @since 0.1.147
+ */
+declare class ActionTargetError extends ClientError {
+  name: string;
+  get code(): ActionTargetErrorBody["code"];
+  get action(): string;
+  get matched(): number | undefined;
+  get cap(): number | undefined;
+}
 /**
  * Wire-body shape for 409 OCC `version_mismatch` responses. Extends the base
  * `ServerError` envelope with a `kind` discriminator and the row's current
@@ -382,4 +497,4 @@ declare class ActionUnsupportedError extends Error {
   constructor(action: string, processor: string, message: string);
 }
 //#endregion
-export { ActionDisabledError, type ActionDisabledErrorBody, ActionNotFoundError, ActionUnsupportedError, type AggregateQuery, type AggregateResult, type AtscriptClientShape, type BucketExpr, type BucketUnit, type CalendarBucketLabel, Client, ClientError, type ClientOptions, type ClientResponse, type ClientValidationError, type ClientValidator, type ClientValidatorOptions, type DataOf, type DbPatch, type DbRow, type FieldMeta, type FilterExpr, type IdOf, type MetaResponse, type NavOf, type OwnOf, type PageResult, type PatchOf, type RelationInfo, type RowOf, type SearchIndexInfo, type ServerError, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbAvailableActions, type TDbDeleteResult, type TDbInsertManyResult, type TDbInsertResult, type TDbUpdateResult, type TSerializedAnnotatedType, TransportError, type TypedWithRelation, type Uniquery, type UniqueryControls, type ValidGroupBy, type ValidatorMode, VersionMismatchError, type VersionMismatchErrorBody, type WeekStart, bucketStartInstant, encodeNavigateId, formatIdentifier, formatIdentifierField, nextBucketLabel };
+export { ActionDisabledError, type ActionDisabledErrorBody, ActionNotFoundError, ActionTargetError, type ActionTargetErrorBody, ActionUnsupportedError, type AggregateQuery, type AggregateResult, type AtscriptClientShape, type BucketExpr, type BucketSeriesOptions, type BucketUnit, type CalendarBucketLabel, Client, ClientError, type ClientOptions, type ClientResponse, type ClientValidationError, type ClientValidator, type ClientValidatorOptions, type DataOf, type DbPatch, type DbRow, type FieldMeta, type FilterExpr, type IdOf, type MetaResponse, type NavOf, type NextBucketOptions, type OwnOf, type PageResult, type PatchOf, type RelationInfo, type RowOf, type SearchIndexInfo, type ServerError, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbActionTargetSummary, type TDbAvailableActions, type TDbDeleteResult, type TDbInsertIgnoreResult, type TDbInsertManyIgnoreResult, type TDbInsertManyResult, type TDbInsertResult, type TDbQueryTarget, type TDbUpdateResult, type TSerializedAnnotatedType, TransportError, type TypedWithRelation, type Uniquery, type UniqueryControls, type ValidGroupBy, type ValidatorMode, VersionMismatchError, type VersionMismatchErrorBody, type WeekStart, actionIdentifier, bucketSeries, bucketStartInstant, encodeNavigateId, formatIdentifier, formatIdentifierField, nextBucketLabel };

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { buildUrl } from "@uniqu/url/builder";
 import { deserializeAnnotatedType } from "@atscript/typescript/utils";
-import { bucketStartInstant, nextBucketLabel } from "@uniqu/core";
+import { bucketSeries, bucketStartInstant, nextBucketLabel } from "@uniqu/core";
 //#region src/client-error.ts
 /**
 * Error thrown by `Client` when the server responds with a non-2xx status code.
@@ -64,6 +64,29 @@ var ActionDisabledError = class extends ClientError {
 	}
 };
 /**
+* Typed marker thrown by `Client` when a query-targeted action request is
+* refused (body `name === 'ActionTargetError'`): `TARGET_INVALID` (400),
+* `TARGET_TOO_LARGE` (400, `cap`) or `TARGET_CHANGED` (409, `matched` — the
+* rows the query matches now; re-confirm and retry with that count).
+*
+* @since 0.1.147
+*/
+var ActionTargetError = class extends ClientError {
+	name = "ActionTargetError";
+	get code() {
+		return this.body.code;
+	}
+	get action() {
+		return this.body.action;
+	}
+	get matched() {
+		return this.body.matched;
+	}
+	get cap() {
+		return this.body.cap;
+	}
+};
+/**
 * Typed marker thrown by `Client._send` when the server response body's
 * `kind === 'version_mismatch'`. The transport / status / base body are
 * identical to a generic `ClientError`; this subclass adds a typed
@@ -142,6 +165,17 @@ var ActionUnsupportedError = class extends Error {
 * const all = await users.query()
 * const page = await users.pages({ filter: { active: true } }, 1, 20)
 * ```
+*
+* `D` (since 0.1.148) types the display-only fields the controller declares
+* with `@DbDecorations`: `$select` of the read methods accepts their keys and
+* rows carry them as optional properties. Filter and sort stay over `T`'s own
+* fields — a decoration is never filterable or sortable.
+*
+* ```typescript
+* const tickets = new Client<typeof Ticket, TicketDecorations>('/api/tickets')
+* const rows = await tickets.query({ controls: { $select: ['title', 'ownerName'] } })
+* rows[0].ownerName // string | undefined
+* ```
 */
 var Client = class {
 	_path;
@@ -185,8 +219,15 @@ var Client = class {
 	*
 	* `$select` may carry calendar buckets (`{ $bucket, $field, $tz?, $weekStart?, $as? }`);
 	* a `$groupBy` entry must be a dimension or a bucket alias (`ValidGroupBy`), and a
-	* bucket's value is typed as its `YYYY-MM-DD` label (`| null` for an optional source).
+	* bucket's value is typed as its `YYYY-MM-DD` (hour: `YYYY-MM-DDTHH:00`) label
+	* (`| null` for an optional source).
 	* Gap-fill between labels with `nextBucketLabel` (re-exported here).
+	*
+	* Arithmetic (since 0.1.148): `{ $fn: 'sum', $expr, $as }` aggregates a per-row
+	* expression over numeric fields; `{ $expr, $as }` computes over aliases of other
+	* numeric entries or numeric `$groupBy` fields (`number | null`). `first` / `last`
+	* read a representative row ordered by `$rowOrder`. The URL forms are `expr(a/b):x`,
+	* `sum(a*b):x`, `first(f):x` and `$rowOrder=f,-id`.
 	*/
 	async aggregate(query) {
 		return this._get("query", query);
@@ -249,8 +290,9 @@ var Client = class {
 		const controlStr = query?.controls ? buildUrl({ controls: query.controls }) : "";
 		return this._getOrNull(this._idUrl("one", id, controlStr));
 	}
-	async insert(data) {
-		return this._request("POST", "", await this._prepareWrite(data, "insert"));
+	async insert(data, opts) {
+		const query = opts?.onConflict === "ignore" ? "?$onConflict=ignore" : "";
+		return this._request("POST", query, await this._prepareWrite(data, "insert"));
 	}
 	/**
 	* `PATCH /` — partial update one or many records by primary key.
@@ -322,6 +364,13 @@ var Client = class {
 	* `{ ids?, input? }` — `ids` carries `id` (object or array per level),
 	* `input` carries the form payload.
 	*
+	* **Delegated actions** (since 0.1.147). An action another controller owns
+	* (`owner`, e.g. a view listing its source table's actions) may carry
+	* `idMap`: each `id` is then a row (or identifier) of THIS controller and
+	* is mapped to the owner's identification — `{ [ownerField]:
+	* row[path] }` — before it is sent to `value` (the owner's route). A
+	* missing path throws `TypeError`. See {@link actionIdentifier}.
+	*
 	* @typeParam R Caller-asserted return shape from the action handler. The
 	*              server returns whatever the handler emits (commonly
 	*              `{ message?: string, ... }`); the client cannot validate.
@@ -331,15 +380,65 @@ var Client = class {
 		const action = meta.actions.find((a) => a.name === name);
 		if (!action) throw new ActionNotFoundError(name);
 		if (action.processor === "custom") throw new ActionUnsupportedError(name, "custom", `Action "${name}" has processor "custom" — applications must dispatch custom actions themselves; the client cannot.`);
+		const mapped = action.idMap ? mapDelegatedIds(action, id) : id;
 		if (action.processor === "navigate") {
-			const url = this._interpolateNavigateUrl(action, id, meta.preferredId);
+			const order = action.idMap ? Object.keys(action.idMap) : meta.preferredId;
+			const url = this._interpolateNavigateUrl(action, mapped, order);
 			await this._dispatchNavigate(action, url);
 			return;
 		}
-		const body = this._buildActionBody(action, id, input);
+		const body = this._buildActionBody(action, mapped, input);
 		return this._postAction(action, body);
 	}
 	/**
+	* Runs a `'rows'` action on every row matching a query (since 0.1.147) —
+	* the action's `/meta` entry must carry `queryTarget`. POSTs
+	* `{ query: { q, exclude?, expectCount?, maxRows? }, input? }` to
+	* `queryTarget.url` (a delegated action: the view resolves the rows and
+	* runs the owner's action in batches) or `value`. `q` is the `/query`
+	* string of `target.filter` / `search` / `index`.
+	*
+	* The server answers what the handler returns — for a delegated action
+	* (and a handler returning `target.summary()`) a
+	* {@link TDbActionTargetSummary}. Refusals arrive as
+	* {@link ActionTargetError}: `TARGET_TOO_LARGE` (`cap`), `TARGET_CHANGED`
+	* (`matched` differs from `expectCount`), `TARGET_INVALID`. Throws
+	* {@link ActionUnsupportedError} when the action takes no query target.
+	*
+	* @since 0.1.147
+	*/
+	async actionOnQuery(name, target, input) {
+		const action = await this._queryTargetAction(name);
+		const body = { query: queryTargetBody(target) };
+		if (input !== void 0) body.input = input;
+		return this._postQueryTarget(action, body);
+	}
+	/**
+	* How many rows {@link actionOnQuery} would target right now (a dry run:
+	* the handler does not run) — pass the answer as `expectCount` to make the
+	* real run fail with `TARGET_CHANGED` if the set changed in between.
+	*
+	* @since 0.1.147
+	*/
+	async countActionTarget(name, target) {
+		const action = await this._queryTargetAction(name);
+		const query = {
+			...queryTargetBody(target),
+			dryRun: true
+		};
+		return this._postQueryTarget(action, { query });
+	}
+	async _queryTargetAction(name) {
+		const action = (await this.meta()).actions.find((a) => a.name === name);
+		if (!action) throw new ActionNotFoundError(name);
+		if (!action.queryTarget || action.processor !== "backend") throw new ActionUnsupportedError(name, action.processor, `Action "${name}" does not accept a query target (no \`queryTarget\` in /meta).`);
+		return action;
+	}
+	_postQueryTarget(action, body) {
+		const path = action.queryTarget?.url ?? action.value;
+		return this._requestUrl("POST", `${this._baseUrl}${path}`, body, true);
+	}
+	/**
 	* `GET /meta/actions/:id` or `GET /meta/actions?k1=v1&k2=v2` — the
 	* row-level actions the caller may run on one row right now, and the
 	* reasons of those disabled with one: `{ actions, disabledReasons? }`.
@@ -518,6 +617,7 @@ var Client = class {
 				};
 			}
 			if (errorBody.name === "ActionDisabledError") throw new ActionDisabledError(res.status, errorBody);
+			if (errorBody.name === "ActionTargetError") throw new ActionTargetError(res.status, errorBody);
 			if (errorBody.kind === "version_mismatch") throw new VersionMismatchError(res.status, errorBody);
 			throw new ClientError(res.status, errorBody);
 		}
@@ -539,6 +639,60 @@ function describeCause(cause) {
 	if (cause instanceof Error) return cause.message || cause.name;
 	return String(cause);
 }
+/** The value at a dot `path` of `row`. */
+function valueAt(row, path) {
+	if (!path.includes(".") || Object.hasOwn(row, path)) return row[path];
+	let v = row;
+	for (const part of path.split(".")) v = v?.[part];
+	return v;
+}
+/**
+* The identifier `action` takes for one row (or identifier) of the
+* controller whose `/meta` listed it (since 0.1.147):
+*
+* - a delegated action with `idMap` → the owner's identification,
+*   `{ [ownerField]: rowOrId[path] }` (dot paths allowed); a missing value
+*   throws `TypeError` naming the action and the path;
+* - any other action → `rowOrId`'s `preferredId` fields when it carries them
+*   all, else `rowOrId` itself (already an identifier).
+*
+* UIs build `ids` from loaded rows with it; `Client.action()` applies the
+* `idMap` mapping itself.
+*
+* @since 0.1.147
+*/
+function actionIdentifier(action, rowOrId, preferredId) {
+	if (action.idMap) {
+		const out = {};
+		for (const [field, path] of Object.entries(action.idMap)) {
+			const value = valueAt(rowOrId, path);
+			if (value === void 0 || value === null) throw new TypeError(`client.action("${action.name}"): the identifier has no "${path}" — needed for the owner's "${field}".`);
+			out[field] = value;
+		}
+		return out;
+	}
+	if (preferredId.length > 0 && preferredId.every((f) => rowOrId[f] !== void 0)) return Object.fromEntries(preferredId.map((f) => [f, rowOrId[f]]));
+	return rowOrId;
+}
+/** `action()`'s `id` argument through a delegated action's `idMap` (shape errors are left to the body builder). */
+function mapDelegatedIds(action, id) {
+	const map = (one) => one !== null && typeof one === "object" && !Array.isArray(one) ? actionIdentifier(action, one, []) : one;
+	return Array.isArray(id) ? id.map(map) : map(id);
+}
+/** The wire `query` of a {@link TDbQueryTarget}. */
+function queryTargetBody(target) {
+	const controls = {};
+	if (target.search !== void 0) controls.$search = target.search;
+	if (target.index !== void 0) controls.$index = target.index;
+	const out = { q: buildUrl({
+		filter: target.filter ?? {},
+		controls
+	}) };
+	if (target.exclude?.length) out.exclude = target.exclude;
+	if (target.expectCount !== void 0) out.expectCount = target.expectCount;
+	if (target.maxRows !== void 0) out.maxRows = target.maxRows;
+	return out;
+}
 /**
 * Render a single identifier field for substitution into a navigate-URL
 * template or human-readable string. `null` / `undefined` collapse to `""`
@@ -575,4 +729,4 @@ function describeShape(value) {
 	return typeof value;
 }
 //#endregion
-export { ActionDisabledError, ActionNotFoundError, ActionUnsupportedError, Client, ClientError, TransportError, VersionMismatchError, bucketStartInstant, encodeNavigateId, formatIdentifier, formatIdentifierField, nextBucketLabel };
+export { ActionDisabledError, ActionNotFoundError, ActionTargetError, ActionUnsupportedError, Client, ClientError, TransportError, VersionMismatchError, actionIdentifier, bucketSeries, bucketStartInstant, encodeNavigateId, formatIdentifier, formatIdentifierField, nextBucketLabel };

package/dist/{validator-810-rhnQ.d.cts → validator-CPmmXTAt.d.mts}

@@ -1,7 +1,7 @@
-import { AggregateQuery as AggregateQuery$1, AggregateResult as AggregateResult$1, BucketExpr as BucketExpr$1, BucketUnit, CalendarBucketLabel, FilterExpr, TypedWithRelation, Uniquery as Uniquery$1, UniqueryControls as UniqueryControls$1, ValidGroupBy as ValidGroupBy$1, WeekStart } from "@uniqu/core";
 import { TAtscriptAnnotatedType, TAtscriptTypeObject } from "@atscript/typescript/utils";
-import { DbPatch, DbResponse, DbRow, TDbDeleteResult as TDbDeleteResult$1, TDbInsertManyResult as TDbInsertManyResult$1, TDbInsertResult as TDbInsertResult$1, TDbUpdateResult as TDbUpdateResult$1, TFieldMeta, TMetaResponse, TRelationInfo, TSearchIndexInfo } from "@atscript/db";
+import { AggregateQuery as AggregateQuery$1, AggregateResult as AggregateResult$1, BucketExpr as BucketExpr$1, BucketUnit, CalendarBucketLabel, FilterExpr, SelectExpr, TypedWithRelation, Uniquery as Uniquery$1, UniqueryControls, ValidGroupBy as ValidGroupBy$1, WeekStart } from "@uniqu/core";
 import { DbValidationContext, ValidatorMode, ValidatorMode as ValidatorMode$1 } from "@atscript/db/validator";
+import { DbPatch, DbResponse, DbRow, TDbDeleteResult as TDbDeleteResult$1, TDbInsertIgnoreResult as TDbInsertIgnoreResult$1, TDbInsertManyIgnoreResult as TDbInsertManyIgnoreResult$1, TDbInsertManyResult as TDbInsertManyResult$1, TDbInsertResult as TDbInsertResult$1, TDbUpdateResult as TDbUpdateResult$1, TFieldMeta, TMetaResponse, TRelationInfo, TSearchIndexInfo } from "@atscript/db";
 
 //#region src/types.d.ts
 /**
@@ -96,6 +96,18 @@ type DataOf<T> = T extends {
     __dataType?: infer D;
   };
 } ? unknown extends D ? T extends (new (...a: any[]) => infer I) ? I : Record<string, unknown> : D & Record<string, unknown> : Record<string, unknown>;
+/**
+ * `$select` controls of a read over `T` whose controller declares the display-only
+ * fields `D` (`@DbDecorations`): `$select` also accepts `keyof D`; filter, sort
+ * and every other control stay over the own fields. Since 0.1.148.
+ */
+type DecoratedControls<T, D> = Omit<UniqueryControls<OwnOf<T>, NavOf<T>>, "$select"> & {
+  $select?: SelectExpr<OwnOf<T> & D>;
+};
+/** A read query over `T` — {@link DecoratedControls} for the controls. Since 0.1.148. */
+type DecoratedQuery<T, D> = Omit<Uniquery$1<OwnOf<T>, NavOf<T>>, "controls"> & {
+  controls?: DecoratedControls<T, D>;
+};
 /** Extract own (non-nav) properties from an Atscript annotated type. */
 type OwnOf<T> = T extends {
   __ownProps: infer O;
@@ -132,6 +144,28 @@ type ClientResponse<T, Q> = DbResponse<DataOf<T>, NavOf<T>, Q> & {
    */
   $disabledReasons?: Record<string, string>;
 };
+/**
+ * "Every row matching this query" — the target of
+ * `Client.actionOnQuery()` / `countActionTarget()`, for a `'rows'` action
+ * whose `/meta` entry carries `queryTarget`. The same filter / search /
+ * index the user's `/query` used; the server resolves it under the caller's
+ * read scope and the action's own gate.
+ *
+ * @since 0.1.147
+ */
+interface TDbQueryTarget<T = AtscriptClientShape> {
+  filter?: Uniquery$1<OwnOf<T>, NavOf<T>>["filter"];
+  /** `$search` term. */
+  search?: string;
+  /** `$index` — the search index `search` uses. */
+  index?: string;
+  /** Identifiers to leave out (any identification of the controller the request goes to). */
+  exclude?: Record<string, unknown>[];
+  /** Fail with 409 `TARGET_CHANGED` when the target no longer matches exactly this many rows. */
+  expectCount?: number;
+  /** Client-side cap (never above the action's `queryTarget.maxRows`). */
+  maxRows?: number;
+}
 //#endregion
 //#region src/validator.d.ts
 /** Options for {@link ClientValidator} / {@link createClientValidator}. */
@@ -214,4 +248,4 @@ declare class ClientValidationError extends Error {
  */
 declare function createClientValidator(meta: MetaResponse, opts?: ClientValidatorOptions): ClientValidator;
 //#endregion
-export { TDbDeleteResult$1 as A, OwnOf as C, RowOf as D, RelationInfo as E, Uniquery$1 as F, UniqueryControls$1 as I, ValidGroupBy$1 as L, TDbInsertResult$1 as M, TDbUpdateResult$1 as N, SearchIndexInfo as O, TypedWithRelation as P, WeekStart as R, NavOf as S, PatchOf as T, DbRow as _, ValidatorMode$1 as a, IdOf as b, AggregateResult$1 as c, BucketUnit as d, CalendarBucketLabel as f, DbPatch as g, DataOf as h, DbValidationContext as i, TDbInsertManyResult$1 as j, ServerError as k, AtscriptClientShape as l, ClientResponse as m, ClientValidator as n, createClientValidator as o, ClientOptions as p, ClientValidatorOptions as r, AggregateQuery$1 as s, ClientValidationError as t, BucketExpr$1 as u, FieldMeta as v, PageResult as w, MetaResponse as x, FilterExpr as y };
+export { SearchIndexInfo as A, Uniquery$1 as B, MetaResponse as C, PatchOf as D, PageResult as E, TDbInsertManyResult$1 as F, ValidGroupBy$1 as H, TDbInsertResult$1 as I, TDbQueryTarget as L, TDbDeleteResult$1 as M, TDbInsertIgnoreResult$1 as N, RelationInfo as O, TDbInsertManyIgnoreResult$1 as P, TDbUpdateResult$1 as R, IdOf as S, OwnOf as T, WeekStart as U, UniqueryControls as V, DbRow as _, ValidatorMode$1 as a, FieldMeta as b, AggregateResult$1 as c, BucketUnit as d, CalendarBucketLabel as f, DbPatch as g, DataOf as h, DbValidationContext as i, ServerError as j, RowOf as k, AtscriptClientShape as l, ClientResponse as m, ClientValidator as n, createClientValidator as o, ClientOptions as p, ClientValidatorOptions as r, AggregateQuery$1 as s, ClientValidationError as t, BucketExpr$1 as u, DecoratedControls as v, NavOf as w, FilterExpr as x, DecoratedQuery as y, TypedWithRelation as z };

package/dist/{validator-CIm1ZCS5.d.mts → validator-CVM7eNP7.d.cts}

@@ -1,7 +1,7 @@
+import { AggregateQuery as AggregateQuery$1, AggregateResult as AggregateResult$1, BucketExpr as BucketExpr$1, BucketUnit, CalendarBucketLabel, FilterExpr, SelectExpr, TypedWithRelation, Uniquery as Uniquery$1, UniqueryControls, ValidGroupBy as ValidGroupBy$1, WeekStart } from "@uniqu/core";
 import { TAtscriptAnnotatedType, TAtscriptTypeObject } from "@atscript/typescript/utils";
-import { AggregateQuery as AggregateQuery$1, AggregateResult as AggregateResult$1, BucketExpr as BucketExpr$1, BucketUnit, CalendarBucketLabel, FilterExpr, TypedWithRelation, Uniquery as Uniquery$1, UniqueryControls as UniqueryControls$1, ValidGroupBy as ValidGroupBy$1, WeekStart } from "@uniqu/core";
+import { DbPatch, DbResponse, DbRow, TDbDeleteResult as TDbDeleteResult$1, TDbInsertIgnoreResult as TDbInsertIgnoreResult$1, TDbInsertManyIgnoreResult as TDbInsertManyIgnoreResult$1, TDbInsertManyResult as TDbInsertManyResult$1, TDbInsertResult as TDbInsertResult$1, TDbUpdateResult as TDbUpdateResult$1, TFieldMeta, TMetaResponse, TRelationInfo, TSearchIndexInfo } from "@atscript/db";
 import { DbValidationContext, ValidatorMode, ValidatorMode as ValidatorMode$1 } from "@atscript/db/validator";
-import { DbPatch, DbResponse, DbRow, TDbDeleteResult as TDbDeleteResult$1, TDbInsertManyResult as TDbInsertManyResult$1, TDbInsertResult as TDbInsertResult$1, TDbUpdateResult as TDbUpdateResult$1, TFieldMeta, TMetaResponse, TRelationInfo, TSearchIndexInfo } from "@atscript/db";
 
 //#region src/types.d.ts
 /**
@@ -96,6 +96,18 @@ type DataOf<T> = T extends {
     __dataType?: infer D;
   };
 } ? unknown extends D ? T extends (new (...a: any[]) => infer I) ? I : Record<string, unknown> : D & Record<string, unknown> : Record<string, unknown>;
+/**
+ * `$select` controls of a read over `T` whose controller declares the display-only
+ * fields `D` (`@DbDecorations`): `$select` also accepts `keyof D`; filter, sort
+ * and every other control stay over the own fields. Since 0.1.148.
+ */
+type DecoratedControls<T, D> = Omit<UniqueryControls<OwnOf<T>, NavOf<T>>, "$select"> & {
+  $select?: SelectExpr<OwnOf<T> & D>;
+};
+/** A read query over `T` — {@link DecoratedControls} for the controls. Since 0.1.148. */
+type DecoratedQuery<T, D> = Omit<Uniquery$1<OwnOf<T>, NavOf<T>>, "controls"> & {
+  controls?: DecoratedControls<T, D>;
+};
 /** Extract own (non-nav) properties from an Atscript annotated type. */
 type OwnOf<T> = T extends {
   __ownProps: infer O;
@@ -132,6 +144,28 @@ type ClientResponse<T, Q> = DbResponse<DataOf<T>, NavOf<T>, Q> & {
    */
   $disabledReasons?: Record<string, string>;
 };
+/**
+ * "Every row matching this query" — the target of
+ * `Client.actionOnQuery()` / `countActionTarget()`, for a `'rows'` action
+ * whose `/meta` entry carries `queryTarget`. The same filter / search /
+ * index the user's `/query` used; the server resolves it under the caller's
+ * read scope and the action's own gate.
+ *
+ * @since 0.1.147
+ */
+interface TDbQueryTarget<T = AtscriptClientShape> {
+  filter?: Uniquery$1<OwnOf<T>, NavOf<T>>["filter"];
+  /** `$search` term. */
+  search?: string;
+  /** `$index` — the search index `search` uses. */
+  index?: string;
+  /** Identifiers to leave out (any identification of the controller the request goes to). */
+  exclude?: Record<string, unknown>[];
+  /** Fail with 409 `TARGET_CHANGED` when the target no longer matches exactly this many rows. */
+  expectCount?: number;
+  /** Client-side cap (never above the action's `queryTarget.maxRows`). */
+  maxRows?: number;
+}
 //#endregion
 //#region src/validator.d.ts
 /** Options for {@link ClientValidator} / {@link createClientValidator}. */
@@ -214,4 +248,4 @@ declare class ClientValidationError extends Error {
  */
 declare function createClientValidator(meta: MetaResponse, opts?: ClientValidatorOptions): ClientValidator;
 //#endregion
-export { TDbDeleteResult$1 as A, OwnOf as C, RowOf as D, RelationInfo as E, Uniquery$1 as F, UniqueryControls$1 as I, ValidGroupBy$1 as L, TDbInsertResult$1 as M, TDbUpdateResult$1 as N, SearchIndexInfo as O, TypedWithRelation as P, WeekStart as R, NavOf as S, PatchOf as T, DbRow as _, ValidatorMode$1 as a, IdOf as b, AggregateResult$1 as c, BucketUnit as d, CalendarBucketLabel as f, DbPatch as g, DataOf as h, DbValidationContext as i, TDbInsertManyResult$1 as j, ServerError as k, AtscriptClientShape as l, ClientResponse as m, ClientValidator as n, createClientValidator as o, ClientOptions as p, ClientValidatorOptions as r, AggregateQuery$1 as s, ClientValidationError as t, BucketExpr$1 as u, FieldMeta as v, PageResult as w, MetaResponse as x, FilterExpr as y };
+export { SearchIndexInfo as A, Uniquery$1 as B, MetaResponse as C, PatchOf as D, PageResult as E, TDbInsertManyResult$1 as F, ValidGroupBy$1 as H, TDbInsertResult$1 as I, TDbQueryTarget as L, TDbDeleteResult$1 as M, TDbInsertIgnoreResult$1 as N, RelationInfo as O, TDbInsertManyIgnoreResult$1 as P, TDbUpdateResult$1 as R, IdOf as S, OwnOf as T, WeekStart as U, UniqueryControls as V, DbRow as _, ValidatorMode$1 as a, FieldMeta as b, AggregateResult$1 as c, BucketUnit as d, CalendarBucketLabel as f, DbPatch as g, DataOf as h, DbValidationContext as i, ServerError as j, RowOf as k, AtscriptClientShape as l, ClientResponse as m, ClientValidator as n, createClientValidator as o, ClientOptions as p, ClientValidatorOptions as r, AggregateQuery$1 as s, ClientValidationError as t, BucketExpr$1 as u, DecoratedControls as v, NavOf as w, FilterExpr as x, DecoratedQuery as y, TypedWithRelation as z };

package/dist/validator.d.cts

@@ -1,2 +1,2 @@
-import { a as ValidatorMode, i as DbValidationContext, n as ClientValidator, o as createClientValidator, r as ClientValidatorOptions, t as ClientValidationError } from "./validator-810-rhnQ.cjs";
+import { a as ValidatorMode, i as DbValidationContext, n as ClientValidator, o as createClientValidator, r as ClientValidatorOptions, t as ClientValidationError } from "./validator-CVM7eNP7.cjs";
 export { ClientValidationError, ClientValidator, ClientValidatorOptions, type DbValidationContext, type ValidatorMode, createClientValidator };

package/dist/validator.d.mts

@@ -1,2 +1,2 @@
-import { a as ValidatorMode, i as DbValidationContext, n as ClientValidator, o as createClientValidator, r as ClientValidatorOptions, t as ClientValidationError } from "./validator-CIm1ZCS5.mjs";
+import { a as ValidatorMode, i as DbValidationContext, n as ClientValidator, o as createClientValidator, r as ClientValidatorOptions, t as ClientValidationError } from "./validator-CPmmXTAt.mjs";
 export { ClientValidationError, ClientValidator, ClientValidatorOptions, type DbValidationContext, type ValidatorMode, createClientValidator };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db-client",
-  "version": "0.1.146",
+  "version": "0.1.148",
   "description": "Browser-compatible HTTP client for @atscript/moost-db REST endpoints.",
   "keywords": [
     "atscript",
@@ -43,18 +43,18 @@
     "access": "public"
   },
   "dependencies": {
-    "@uniqu/core": "^0.1.11",
-    "@uniqu/url": "^0.1.11"
+    "@uniqu/core": "^0.1.13",
+    "@uniqu/url": "^0.1.13"
   },
   "devDependencies": {
-    "@atscript/core": "^0.1.98",
-    "@atscript/typescript": "^0.1.98",
-    "unplugin-atscript": "^0.1.98",
-    "@atscript/db": "0.1.146"
+    "@atscript/core": "^0.1.100",
+    "@atscript/typescript": "^0.1.100",
+    "unplugin-atscript": "^0.1.100",
+    "@atscript/db": "0.1.148"
   },
   "peerDependencies": {
     "@atscript/db": "^0.1.44",
-    "@atscript/typescript": "^0.1.98"
+    "@atscript/typescript": "^0.1.100"
   },
   "scripts": {
     "postinstall": "asc -f dts",