@atscript/db-client 0.1.140 → 0.1.141

package/dist/index.cjs

@@ -26,7 +26,8 @@ var ClientError = class extends Error {
 * `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` without indexing into `body`.
+* to access `action` / `id` / `ids` / `reason` / `reasons` without indexing
+* into `body`.
 */
 var ActionDisabledError = class extends ClientError {
 	name = "ActionDisabledError";
@@ -42,6 +43,26 @@ var ActionDisabledError = class extends ClientError {
 	get ids() {
 		return this.body.ids;
 	}
+	/**
+	* 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() {
+		return this.body.reason;
+	}
+	/**
+	* `'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() {
+		return this.body.reasons;
+	}
 };
 /**
 * Typed marker thrown by `Client._send` when the server response body's

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-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-D6V_8Fxi.cjs";
+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 { TAtscriptAnnotatedType, TSerializedAnnotatedType } from "@atscript/typescript/utils";
 import { TCrudOp, TCrudPermissions, TDbActionInfo, TDbActionIntent, TDbActionLevel, TDbActionProcessor, TDbDeleteResult as TDbDeleteResult$1, TDbInsertManyResult as TDbInsertManyResult$1, TDbInsertResult as TDbInsertResult$1, TDbUpdateResult as TDbUpdateResult$1 } from "@atscript/db";
@@ -264,13 +264,18 @@ interface ActionDisabledErrorBody extends ServerError {
   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` without indexing into `body`.
+ * to access `action` / `id` / `ids` / `reason` / `reasons` without indexing
+ * into `body`.
  */
 declare class ActionDisabledError extends ClientError {
   name: string;
@@ -280,6 +285,22 @@ declare class ActionDisabledError extends ClientError {
   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 409 OCC `version_mismatch` responses. Extends the base

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-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-B_AWTflO.mjs";
+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 { 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, TDbDeleteResult as TDbDeleteResult$1, TDbInsertManyResult as TDbInsertManyResult$1, TDbInsertResult as TDbInsertResult$1, TDbUpdateResult as TDbUpdateResult$1 } from "@atscript/db";
@@ -264,13 +264,18 @@ interface ActionDisabledErrorBody extends ServerError {
   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` without indexing into `body`.
+ * to access `action` / `id` / `ids` / `reason` / `reasons` without indexing
+ * into `body`.
  */
 declare class ActionDisabledError extends ClientError {
   name: string;
@@ -280,6 +285,22 @@ declare class ActionDisabledError extends ClientError {
   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 409 OCC `version_mismatch` responses. Extends the base

package/dist/index.mjs

@@ -25,7 +25,8 @@ var ClientError = class extends Error {
 * `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` without indexing into `body`.
+* to access `action` / `id` / `ids` / `reason` / `reasons` without indexing
+* into `body`.
 */
 var ActionDisabledError = class extends ClientError {
 	name = "ActionDisabledError";
@@ -41,6 +42,26 @@ var ActionDisabledError = class extends ClientError {
 	get ids() {
 		return this.body.ids;
 	}
+	/**
+	* 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() {
+		return this.body.reason;
+	}
+	/**
+	* `'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() {
+		return this.body.reasons;
+	}
 };
 /**
 * Typed marker thrown by `Client._send` when the server response body's

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

@@ -1,7 +1,7 @@
-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 { DbValidationContext, ValidatorMode, ValidatorMode as ValidatorMode$1 } from "@atscript/db/validator";
+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 { DbValidationContext, ValidatorMode, ValidatorMode as ValidatorMode$1 } from "@atscript/db/validator";
 
 //#region src/types.d.ts
 /**
@@ -113,8 +113,8 @@ type IdOf<T> = T extends {
  * query, mirroring the backend's `DbResponse<Data, Nav, Q>` algebra. Nav
  * properties are stripped by default and re-added only for relations the
  * caller listed in `$with`. When `T` carries no nav-prop brand, `DbResponse`
- * short-circuits to the data type. `$actions` is always optional — the
- * server emits it only when the request set `?$actions=true`.
+ * short-circuits to the data type. `$actions` / `$disabledReasons` are always
+ * optional — the server emits them only when the request set `?$actions=true`.
  */
 type ClientResponse<T, Q> = DbResponse<DataOf<T>, NavOf<T>, Q> & {
   /**
@@ -123,6 +123,14 @@ type ClientResponse<T, Q> = DbResponse<DataOf<T>, NavOf<T>, Q> & {
    * this row.
    */
   $actions?: string[];
+  /**
+   * Action name → human-readable reason, for actions disabled on this row
+   * whose `disabled` predicate returned a reason string. Present only on
+   * rows with at least one such reason; keys never appear in `$actions`.
+   *
+   * @since 0.1.141
+   */
+  $disabledReasons?: Record<string, string>;
 };
 //#endregion
 //#region src/validator.d.ts

package/dist/{validator-D6V_8Fxi.d.cts → validator-CIm1ZCS5.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, TypedWithRelation, Uniquery as Uniquery$1, UniqueryControls as UniqueryControls$1, 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, TDbInsertManyResult as TDbInsertManyResult$1, TDbInsertResult as TDbInsertResult$1, TDbUpdateResult as TDbUpdateResult$1, TFieldMeta, TMetaResponse, TRelationInfo, TSearchIndexInfo } from "@atscript/db";
 
 //#region src/types.d.ts
 /**
@@ -113,8 +113,8 @@ type IdOf<T> = T extends {
  * query, mirroring the backend's `DbResponse<Data, Nav, Q>` algebra. Nav
  * properties are stripped by default and re-added only for relations the
  * caller listed in `$with`. When `T` carries no nav-prop brand, `DbResponse`
- * short-circuits to the data type. `$actions` is always optional — the
- * server emits it only when the request set `?$actions=true`.
+ * short-circuits to the data type. `$actions` / `$disabledReasons` are always
+ * optional — the server emits them only when the request set `?$actions=true`.
  */
 type ClientResponse<T, Q> = DbResponse<DataOf<T>, NavOf<T>, Q> & {
   /**
@@ -123,6 +123,14 @@ type ClientResponse<T, Q> = DbResponse<DataOf<T>, NavOf<T>, Q> & {
    * this row.
    */
   $actions?: string[];
+  /**
+   * Action name → human-readable reason, for actions disabled on this row
+   * whose `disabled` predicate returned a reason string. Present only on
+   * rows with at least one such reason; keys never appear in `$actions`.
+   *
+   * @since 0.1.141
+   */
+  $disabledReasons?: Record<string, string>;
 };
 //#endregion
 //#region src/validator.d.ts

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-D6V_8Fxi.cjs";
+import { a as ValidatorMode, i as DbValidationContext, n as ClientValidator, o as createClientValidator, r as ClientValidatorOptions, t as ClientValidationError } from "./validator-810-rhnQ.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-B_AWTflO.mjs";
+import { a as ValidatorMode, i as DbValidationContext, n as ClientValidator, o as createClientValidator, r as ClientValidatorOptions, t as ClientValidationError } from "./validator-CIm1ZCS5.mjs";
 export { ClientValidationError, ClientValidator, ClientValidatorOptions, type DbValidationContext, type ValidatorMode, createClientValidator };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db-client",
-  "version": "0.1.140",
+  "version": "0.1.141",
   "description": "Browser-compatible HTTP client for @atscript/moost-db REST endpoints.",
   "keywords": [
     "atscript",
@@ -47,14 +47,14 @@
     "@uniqu/url": "^0.1.11"
   },
   "devDependencies": {
-    "@atscript/core": "^0.1.92",
-    "@atscript/typescript": "^0.1.92",
-    "unplugin-atscript": "^0.1.92",
-    "@atscript/db": "0.1.140"
+    "@atscript/core": "^0.1.95",
+    "@atscript/typescript": "^0.1.95",
+    "unplugin-atscript": "^0.1.95",
+    "@atscript/db": "0.1.141"
   },
   "peerDependencies": {
     "@atscript/db": "^0.1.44",
-    "@atscript/typescript": "^0.1.92"
+    "@atscript/typescript": "^0.1.95"
   },
   "scripts": {
     "postinstall": "asc -f dts",