@atscript/db-client 0.1.163 → 0.1.165

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { A as SearchIndexInfo, B as Uniquery, C as MetaResponse, D as PatchOf, E as PageResult, F as TDbInsertManyResult, G as MetaStoreOptions, H as ValidGroupBy, I as TDbInsertResult, K as clearMetaStore, 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, W as MetaStore, _ 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, q as defaultMetaStore, 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-CI8qxCps.cjs";
+import { $ as UniqueryControls, A as FieldMeta, B as RowOf, C as ClientOptions, D as DbRow, E as DbPatch, F as OwnOf, G as TDbInsertIgnoreResult, H as ServerError, I as PageResult, J as TDbInsertResult, K as TDbInsertManyIgnoreResult, L as PatchOf, M as IdOf, N as MetaResponse, O as DecoratedControls, P as NavOf, Q as Uniquery, R as RelationInfo, S as CalendarBucketLabel, T as DataOf, U as TClientCallOptions, V as SearchIndexInfo, W as TDbDeleteResult, X as TDbUpdateResult, Y as TDbQueryTarget, Z as TypedWithRelation, _ as AggregateQuery, at as defaultMetaStore, b as BucketExpr, c as ActionNotFoundError, d as ActionUnsupportedError, et as ValidGroupBy, f as ClientError, g as VersionMismatchErrorBody, h as VersionMismatchError, i as ValidatorMode, it as clearMetaStore, j as FilterExpr, k as DecoratedQuery, l as ActionTargetError, m as TransportError, n as ClientValidatorOptions, nt as MetaStore, o as ActionDisabledError, p as ClientValidationError, q as TDbInsertManyResult, rt as MetaStoreOptions, s as ActionDisabledErrorBody, t as ClientValidator, tt as WeekStart, u as ActionTargetErrorBody, v as AggregateResult, w as ClientResponse, x as BucketUnit, y as AtscriptClientShape, z as ResponseDataOf } from "./validator-DrJYT-pz.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, 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";
@@ -64,13 +64,13 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape, D exte
    * 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 DecoratedQuery<T, D> = DecoratedQuery<T, D>>(query?: Q): Promise<DecoratedRow<T, Q, D>[]>;
+  query<const Q extends DecoratedQuery<T, D> = DecoratedQuery<T, D>>(query?: Q, opts?: TClientCallOptions): Promise<DecoratedRow<T, Q, D>[]>;
   /**
    * `GET /query` with `$count: true` — returns record count.
    */
   count(query?: {
     filter?: Uniquery$1<Own<T>, Nav<T>>["filter"];
-  }): Promise<number>;
+  }, opts?: TClientCallOptions): Promise<number>;
   /**
    * `GET /query` with `$groupBy` — aggregate query with typed dimension/measure fields.
    * `$groupBy: []` is the ungrouped aggregate: one row over the filtered set (served
@@ -88,14 +88,14 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape, D exte
    * 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 | AggregateOfExpr | SelectArithExpr)[] ? 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>, opts?: TClientCallOptions): 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 DecoratedQuery<T, D> = DecoratedQuery<T, D>>(query?: Q, page?: number, size?: number): Promise<PageResult<DecoratedRow<T, Q, D>>>;
+  pages<const Q extends DecoratedQuery<T, D> = DecoratedQuery<T, D>>(query?: Q, page?: number, size?: number, opts?: TClientCallOptions): Promise<PageResult<DecoratedRow<T, Q, D>>>;
   /**
    * `GET /geo` — distance-ranked geospatial search (tables with `@db.index.geo`).
    *
@@ -105,13 +105,13 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape, D exte
    * in `query.controls`; filter / `$select` / `$with` / `$skip` / `$limit`
    * compose as usual.
    */
-  geoSearch<Q extends DecoratedQuery<T, D> = DecoratedQuery<T, D>>(point: [number, number], query?: Q): Promise<Array<DecoratedRow<T, Q, D> & {
+  geoSearch<const Q extends DecoratedQuery<T, D> = DecoratedQuery<T, D>>(point: [number, number], query?: Q, opts?: TClientCallOptions): Promise<Array<DecoratedRow<T, Q, D> & {
     $distance: number;
   }>>;
   /**
    * `GET /geo` with `$page` / `$size` — paginated distance-ranked search.
    */
-  geoPages<Q extends DecoratedQuery<T, D> = DecoratedQuery<T, D>>(point: [number, number], query?: Q, page?: number, size?: number): Promise<PageResult<DecoratedRow<T, Q, D> & {
+  geoPages<const Q extends DecoratedQuery<T, D> = DecoratedQuery<T, D>>(point: [number, number], query?: Q, page?: number, size?: number, opts?: TClientCallOptions): Promise<PageResult<DecoratedRow<T, Q, D> & {
     $distance: number;
   }>>;
   /**
@@ -120,32 +120,32 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape, D exte
    * Returns `null` on 404. Response narrows by the literal `$with` array in
    * `query.controls` — same algebra as {@link query}.
    */
-  one<Q extends {
+  one<const Q extends {
     controls?: DecoratedControls<T, D>;
   } = {
     controls?: DecoratedControls<T, D>;
-  }>(id: Id<T>, query?: Q): Promise<DecoratedRow<T, Q, D> | null>;
+  }>(id: Id<T>, query?: Q, opts?: TClientCallOptions): 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).
    */
-  insert(data: PatchOf<T>): Promise<TDbInsertResult$1>;
+  insert(data: PatchOf<T>, opts?: TClientCallOptions): Promise<TDbInsertResult$1>;
   /**
    * `POST /` — insert many records.
    */
-  insert(data: PatchOf<T>[]): Promise<TDbInsertManyResult$1>;
+  insert(data: PatchOf<T>[], opts?: TClientCallOptions): 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: {
+  insert(data: PatchOf<T>, opts: TClientCallOptions & {
     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: {
+  insert(data: PatchOf<T>[], opts: TClientCallOptions & {
     onConflict: "ignore";
   }): Promise<TDbInsertManyIgnoreResult$1>;
   /**
@@ -157,16 +157,16 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape, D exte
    * {@link VersionMismatchError}; a PK-only body with a version is a real
    * write (the server bumps the version).
    */
-  update(data: PatchOf<T> | PatchOf<T>[]): Promise<TDbUpdateResult$1>;
+  update(data: PatchOf<T> | PatchOf<T>[], opts?: TClientCallOptions): Promise<TDbUpdateResult$1>;
   /**
    * `PUT /` — full replace one or many records by primary key. Same OCC
    * shapes as {@link update}; the version column itself is optional.
    */
-  replace(data: RowOf<T> | RowOf<T>[]): Promise<TDbUpdateResult$1>;
+  replace(data: RowOf<T> | RowOf<T>[], opts?: TClientCallOptions): Promise<TDbUpdateResult$1>;
   /**
    * `DELETE /:id` or `DELETE /?k1=v1&k2=v2` — remove a record by primary key.
    */
-  remove(id: Id<T>): Promise<TDbDeleteResult$1>;
+  remove(id: Id<T>, opts?: TClientCallOptions): Promise<TDbDeleteResult$1>;
   /**
    * `GET /meta` — table/view metadata (cached after first call).
    *
@@ -390,169 +390,4 @@ declare function formatIdentifier(id: Record<string, unknown> | undefined, prefe
  */
 declare function encodeNavigateId(id: Record<string, unknown>, preferredId: readonly string[]): string;
 //#endregion
-//#region src/client-error.d.ts
-/**
- * Error thrown by `Client` when the server responds with a non-2xx status code.
- * Captures the HTTP status and the structured error body from moost-db.
- */
-declare class ClientError extends Error {
-  /** HTTP status code (e.g. 400, 404, 409, 500). */
-  readonly status: number;
-  /** Structured error response from the server. */
-  readonly body: ServerError;
-  name: string;
-  constructor(/** HTTP status code (e.g. 400, 404, 409, 500). */
-
-  status: number, /** Structured error response from the server. */
-
-  body: ServerError);
-  /** Shortcut to structured validation/DB errors from the server. */
-  get errors(): {
-    path: string;
-    message: string;
-    details?: unknown[];
-  }[];
-}
-/**
- * Wire-body shape for `ActionDisabledError` responses (HTTP 409). Extends
- * the base `ServerError` envelope with a `name` discriminator, the action
- * name, and the offending identifier(s). The bridge between `@atscript/moost-db`'s
- * server-side error and this typed client-side subclass is the wire JSON
- * body — neither package depends on the other.
- */
-interface ActionDisabledErrorBody extends ServerError {
-  name: "ActionDisabledError";
-  action: string;
-  id?: Record<string, unknown>;
-  ids?: Record<string, unknown>[];
-  /** Reason shared by every rejected row, when the server's predicate gave one. @since 0.1.141 */
-  reason?: string;
-  /** `'rows'` level: index-aligned with `ids`, `null` = no reason for that row. @since 0.1.141 */
-  reasons?: (string | null)[];
-}
-/**
- * Typed marker thrown by `Client._send` when the server response body's
- * `name === 'ActionDisabledError'`. The transport / status / base body are
- * identical to a generic `ClientError`; this subclass adds typed accessors
- * so consumers can write `catch (e) { if (e instanceof ActionDisabledError) … }`
- * to access `action` / `id` / `ids` / `reason` / `reasons` without indexing
- * into `body`.
- */
-declare class ActionDisabledError extends ClientError {
-  name: string;
-  /** The `@DbAction` name that rejected the request. */
-  get action(): string;
-  /** Present only for `'row'`-level rejections. */
-  get id(): Record<string, unknown> | undefined;
-  /** Present only for `'rows'`-level rejections (full list of failing IDs). */
-  get ids(): Record<string, unknown>[] | undefined;
-  /**
-   * Human-readable reason shared by every rejected row — present only when
-   * the server's `disabled` predicate returned one. `message` already
-   * carries it.
-   *
-   * @since 0.1.141
-   */
-  get reason(): string | undefined;
-  /**
-   * `'rows'`-level only: per-row reasons index-aligned with {@link ids}
-   * (`null` where that row has none). Present only when at least one
-   * rejected row carries a reason.
-   *
-   * @since 0.1.141
-   */
-  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
- * server-side version. The bridge between `@atscript/moost-db`'s server-side
- * `_disambiguateMismatch` and this typed client-side subclass is the wire
- * JSON body — neither package depends on the other.
- */
-interface VersionMismatchErrorBody extends ServerError {
-  kind: "version_mismatch";
-  currentVersion: number;
-}
-/**
- * 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
- * `currentVersion` accessor so consumers can write
- * `catch (e) { if (e instanceof VersionMismatchError) … }` without casting.
- */
-declare class VersionMismatchError extends ClientError {
-  name: string;
-  /** Row's current server-side version — clients refresh + retry against it. */
-  get currentVersion(): number;
-}
-/**
- * Thrown by `Client` when NO server verdict was obtained: `fetch` itself
- * rejected (network down, DNS, CORS, `AbortError`, …) or a 2xx response
- * carried a body that is not JSON. Unlike {@link ClientError} — where the
- * server answered and rejected — the request's outcome is unknown: a write
- * may have committed. Reload before retrying a non-idempotent write.
- * The underlying error is the standard `cause`.
- */
-declare class TransportError extends Error {
-  /** HTTP method of the failed request. */
-  readonly method: string;
-  /** Full request URL. */
-  readonly url: string;
-  name: string;
-  constructor(/** HTTP method of the failed request. */
-
-  method: string, /** Full request URL. */
-
-  url: string, /** What went wrong; the message is `<method> <url>: <detail>`. */
-
-  detail: string, cause?: unknown);
-}
-/** Thrown by `Client.action()` when the action name is not present in `/meta`. */
-declare class ActionNotFoundError extends Error {
-  readonly action: string;
-  name: string;
-  constructor(action: string);
-}
-/**
- * Thrown by `Client.action()` for actions that cannot be invoked through
- * the client — currently `processor: 'custom'` (UI-dispatched events,
- * which the application is responsible for handling) and `processor: 'navigate'`
- * when no browser environment and no `navigate` option are configured.
- */
-declare class ActionUnsupportedError extends Error {
-  readonly action: string;
-  readonly processor: string;
-  name: string;
-  constructor(action: string, processor: string, message: string);
-}
-//#endregion
-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, MetaStore, type MetaStoreOptions, 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, clearMetaStore, defaultMetaStore, 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, ClientValidationError, type ClientValidator, type ClientValidatorOptions, type DataOf, type DbPatch, type DbRow, type FieldMeta, type FilterExpr, type IdOf, type MetaResponse, MetaStore, type MetaStoreOptions, type NavOf, type NextBucketOptions, type OwnOf, type PageResult, type PatchOf, type RelationInfo, type ResponseDataOf, type RowOf, type SearchIndexInfo, type ServerError, type TClientCallOptions, 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, clearMetaStore, defaultMetaStore, encodeNavigateId, formatIdentifier, formatIdentifierField, nextBucketLabel };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { A as SearchIndexInfo, B as Uniquery, C as MetaResponse, D as PatchOf, E as PageResult, F as TDbInsertManyResult, G as MetaStoreOptions, H as ValidGroupBy, I as TDbInsertResult, K as clearMetaStore, 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, W as MetaStore, _ 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, q as defaultMetaStore, 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-zwjB-484.mjs";
+import { $ as UniqueryControls, A as FieldMeta, B as RowOf, C as ClientOptions, D as DbRow, E as DbPatch, F as OwnOf, G as TDbInsertIgnoreResult, H as ServerError, I as PageResult, J as TDbInsertResult, K as TDbInsertManyIgnoreResult, L as PatchOf, M as IdOf, N as MetaResponse, O as DecoratedControls, P as NavOf, Q as Uniquery, R as RelationInfo, S as CalendarBucketLabel, T as DataOf, U as TClientCallOptions, V as SearchIndexInfo, W as TDbDeleteResult, X as TDbUpdateResult, Y as TDbQueryTarget, Z as TypedWithRelation, _ as AggregateQuery, at as defaultMetaStore, b as BucketExpr, c as ActionNotFoundError, d as ActionUnsupportedError, et as ValidGroupBy, f as ClientError, g as VersionMismatchErrorBody, h as VersionMismatchError, i as ValidatorMode, it as clearMetaStore, j as FilterExpr, k as DecoratedQuery, l as ActionTargetError, m as TransportError, n as ClientValidatorOptions, nt as MetaStore, o as ActionDisabledError, p as ClientValidationError, q as TDbInsertManyResult, rt as MetaStoreOptions, s as ActionDisabledErrorBody, t as ClientValidator, tt as WeekStart, u as ActionTargetErrorBody, v as AggregateResult, w as ClientResponse, x as BucketUnit, y as AtscriptClientShape, z as ResponseDataOf } from "./validator-tvR4Sl3l.mjs";
 import { TAtscriptAnnotatedType, TSerializedAnnotatedType } from "@atscript/typescript/utils";
 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";
@@ -64,13 +64,13 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape, D exte
    * 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 DecoratedQuery<T, D> = DecoratedQuery<T, D>>(query?: Q): Promise<DecoratedRow<T, Q, D>[]>;
+  query<const Q extends DecoratedQuery<T, D> = DecoratedQuery<T, D>>(query?: Q, opts?: TClientCallOptions): Promise<DecoratedRow<T, Q, D>[]>;
   /**
    * `GET /query` with `$count: true` — returns record count.
    */
   count(query?: {
     filter?: Uniquery$1<Own<T>, Nav<T>>["filter"];
-  }): Promise<number>;
+  }, opts?: TClientCallOptions): Promise<number>;
   /**
    * `GET /query` with `$groupBy` — aggregate query with typed dimension/measure fields.
    * `$groupBy: []` is the ungrouped aggregate: one row over the filtered set (served
@@ -88,14 +88,14 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape, D exte
    * 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 | AggregateOfExpr | SelectArithExpr)[] ? 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>, opts?: TClientCallOptions): 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 DecoratedQuery<T, D> = DecoratedQuery<T, D>>(query?: Q, page?: number, size?: number): Promise<PageResult<DecoratedRow<T, Q, D>>>;
+  pages<const Q extends DecoratedQuery<T, D> = DecoratedQuery<T, D>>(query?: Q, page?: number, size?: number, opts?: TClientCallOptions): Promise<PageResult<DecoratedRow<T, Q, D>>>;
   /**
    * `GET /geo` — distance-ranked geospatial search (tables with `@db.index.geo`).
    *
@@ -105,13 +105,13 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape, D exte
    * in `query.controls`; filter / `$select` / `$with` / `$skip` / `$limit`
    * compose as usual.
    */
-  geoSearch<Q extends DecoratedQuery<T, D> = DecoratedQuery<T, D>>(point: [number, number], query?: Q): Promise<Array<DecoratedRow<T, Q, D> & {
+  geoSearch<const Q extends DecoratedQuery<T, D> = DecoratedQuery<T, D>>(point: [number, number], query?: Q, opts?: TClientCallOptions): Promise<Array<DecoratedRow<T, Q, D> & {
     $distance: number;
   }>>;
   /**
    * `GET /geo` with `$page` / `$size` — paginated distance-ranked search.
    */
-  geoPages<Q extends DecoratedQuery<T, D> = DecoratedQuery<T, D>>(point: [number, number], query?: Q, page?: number, size?: number): Promise<PageResult<DecoratedRow<T, Q, D> & {
+  geoPages<const Q extends DecoratedQuery<T, D> = DecoratedQuery<T, D>>(point: [number, number], query?: Q, page?: number, size?: number, opts?: TClientCallOptions): Promise<PageResult<DecoratedRow<T, Q, D> & {
     $distance: number;
   }>>;
   /**
@@ -120,32 +120,32 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape, D exte
    * Returns `null` on 404. Response narrows by the literal `$with` array in
    * `query.controls` — same algebra as {@link query}.
    */
-  one<Q extends {
+  one<const Q extends {
     controls?: DecoratedControls<T, D>;
   } = {
     controls?: DecoratedControls<T, D>;
-  }>(id: Id<T>, query?: Q): Promise<DecoratedRow<T, Q, D> | null>;
+  }>(id: Id<T>, query?: Q, opts?: TClientCallOptions): 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).
    */
-  insert(data: PatchOf<T>): Promise<TDbInsertResult$1>;
+  insert(data: PatchOf<T>, opts?: TClientCallOptions): Promise<TDbInsertResult$1>;
   /**
    * `POST /` — insert many records.
    */
-  insert(data: PatchOf<T>[]): Promise<TDbInsertManyResult$1>;
+  insert(data: PatchOf<T>[], opts?: TClientCallOptions): 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: {
+  insert(data: PatchOf<T>, opts: TClientCallOptions & {
     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: {
+  insert(data: PatchOf<T>[], opts: TClientCallOptions & {
     onConflict: "ignore";
   }): Promise<TDbInsertManyIgnoreResult$1>;
   /**
@@ -157,16 +157,16 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape, D exte
    * {@link VersionMismatchError}; a PK-only body with a version is a real
    * write (the server bumps the version).
    */
-  update(data: PatchOf<T> | PatchOf<T>[]): Promise<TDbUpdateResult$1>;
+  update(data: PatchOf<T> | PatchOf<T>[], opts?: TClientCallOptions): Promise<TDbUpdateResult$1>;
   /**
    * `PUT /` — full replace one or many records by primary key. Same OCC
    * shapes as {@link update}; the version column itself is optional.
    */
-  replace(data: RowOf<T> | RowOf<T>[]): Promise<TDbUpdateResult$1>;
+  replace(data: RowOf<T> | RowOf<T>[], opts?: TClientCallOptions): Promise<TDbUpdateResult$1>;
   /**
    * `DELETE /:id` or `DELETE /?k1=v1&k2=v2` — remove a record by primary key.
    */
-  remove(id: Id<T>): Promise<TDbDeleteResult$1>;
+  remove(id: Id<T>, opts?: TClientCallOptions): Promise<TDbDeleteResult$1>;
   /**
    * `GET /meta` — table/view metadata (cached after first call).
    *
@@ -390,169 +390,4 @@ declare function formatIdentifier(id: Record<string, unknown> | undefined, prefe
  */
 declare function encodeNavigateId(id: Record<string, unknown>, preferredId: readonly string[]): string;
 //#endregion
-//#region src/client-error.d.ts
-/**
- * Error thrown by `Client` when the server responds with a non-2xx status code.
- * Captures the HTTP status and the structured error body from moost-db.
- */
-declare class ClientError extends Error {
-  /** HTTP status code (e.g. 400, 404, 409, 500). */
-  readonly status: number;
-  /** Structured error response from the server. */
-  readonly body: ServerError;
-  name: string;
-  constructor(/** HTTP status code (e.g. 400, 404, 409, 500). */
-
-  status: number, /** Structured error response from the server. */
-
-  body: ServerError);
-  /** Shortcut to structured validation/DB errors from the server. */
-  get errors(): {
-    path: string;
-    message: string;
-    details?: unknown[];
-  }[];
-}
-/**
- * Wire-body shape for `ActionDisabledError` responses (HTTP 409). Extends
- * the base `ServerError` envelope with a `name` discriminator, the action
- * name, and the offending identifier(s). The bridge between `@atscript/moost-db`'s
- * server-side error and this typed client-side subclass is the wire JSON
- * body — neither package depends on the other.
- */
-interface ActionDisabledErrorBody extends ServerError {
-  name: "ActionDisabledError";
-  action: string;
-  id?: Record<string, unknown>;
-  ids?: Record<string, unknown>[];
-  /** Reason shared by every rejected row, when the server's predicate gave one. @since 0.1.141 */
-  reason?: string;
-  /** `'rows'` level: index-aligned with `ids`, `null` = no reason for that row. @since 0.1.141 */
-  reasons?: (string | null)[];
-}
-/**
- * Typed marker thrown by `Client._send` when the server response body's
- * `name === 'ActionDisabledError'`. The transport / status / base body are
- * identical to a generic `ClientError`; this subclass adds typed accessors
- * so consumers can write `catch (e) { if (e instanceof ActionDisabledError) … }`
- * to access `action` / `id` / `ids` / `reason` / `reasons` without indexing
- * into `body`.
- */
-declare class ActionDisabledError extends ClientError {
-  name: string;
-  /** The `@DbAction` name that rejected the request. */
-  get action(): string;
-  /** Present only for `'row'`-level rejections. */
-  get id(): Record<string, unknown> | undefined;
-  /** Present only for `'rows'`-level rejections (full list of failing IDs). */
-  get ids(): Record<string, unknown>[] | undefined;
-  /**
-   * Human-readable reason shared by every rejected row — present only when
-   * the server's `disabled` predicate returned one. `message` already
-   * carries it.
-   *
-   * @since 0.1.141
-   */
-  get reason(): string | undefined;
-  /**
-   * `'rows'`-level only: per-row reasons index-aligned with {@link ids}
-   * (`null` where that row has none). Present only when at least one
-   * rejected row carries a reason.
-   *
-   * @since 0.1.141
-   */
-  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
- * server-side version. The bridge between `@atscript/moost-db`'s server-side
- * `_disambiguateMismatch` and this typed client-side subclass is the wire
- * JSON body — neither package depends on the other.
- */
-interface VersionMismatchErrorBody extends ServerError {
-  kind: "version_mismatch";
-  currentVersion: number;
-}
-/**
- * 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
- * `currentVersion` accessor so consumers can write
- * `catch (e) { if (e instanceof VersionMismatchError) … }` without casting.
- */
-declare class VersionMismatchError extends ClientError {
-  name: string;
-  /** Row's current server-side version — clients refresh + retry against it. */
-  get currentVersion(): number;
-}
-/**
- * Thrown by `Client` when NO server verdict was obtained: `fetch` itself
- * rejected (network down, DNS, CORS, `AbortError`, …) or a 2xx response
- * carried a body that is not JSON. Unlike {@link ClientError} — where the
- * server answered and rejected — the request's outcome is unknown: a write
- * may have committed. Reload before retrying a non-idempotent write.
- * The underlying error is the standard `cause`.
- */
-declare class TransportError extends Error {
-  /** HTTP method of the failed request. */
-  readonly method: string;
-  /** Full request URL. */
-  readonly url: string;
-  name: string;
-  constructor(/** HTTP method of the failed request. */
-
-  method: string, /** Full request URL. */
-
-  url: string, /** What went wrong; the message is `<method> <url>: <detail>`. */
-
-  detail: string, cause?: unknown);
-}
-/** Thrown by `Client.action()` when the action name is not present in `/meta`. */
-declare class ActionNotFoundError extends Error {
-  readonly action: string;
-  name: string;
-  constructor(action: string);
-}
-/**
- * Thrown by `Client.action()` for actions that cannot be invoked through
- * the client — currently `processor: 'custom'` (UI-dispatched events,
- * which the application is responsible for handling) and `processor: 'navigate'`
- * when no browser environment and no `navigate` option are configured.
- */
-declare class ActionUnsupportedError extends Error {
-  readonly action: string;
-  readonly processor: string;
-  name: string;
-  constructor(action: string, processor: string, message: string);
-}
-//#endregion
-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, MetaStore, type MetaStoreOptions, 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, clearMetaStore, defaultMetaStore, 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, ClientValidationError, type ClientValidator, type ClientValidatorOptions, type DataOf, type DbPatch, type DbRow, type FieldMeta, type FilterExpr, type IdOf, type MetaResponse, MetaStore, type MetaStoreOptions, type NavOf, type NextBucketOptions, type OwnOf, type PageResult, type PatchOf, type RelationInfo, type ResponseDataOf, type RowOf, type SearchIndexInfo, type ServerError, type TClientCallOptions, 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, clearMetaStore, defaultMetaStore, encodeNavigateId, formatIdentifier, formatIdentifierField, nextBucketLabel };