@atscript/moost-db 0.1.63 → 0.1.64

package/dist/index.cjs

@@ -991,14 +991,27 @@ let AsDbReadableController = class AsDbReadableController extends AsReadableCont
 	_gates;
 	_preferredIdSet;
 	_overlayIsNoOp;
+	/** path → sibling-ref path for `@db.amount.currency.ref` / `@db.unit.ref`. */
+	_quantityRefByPath;
 	constructor(readable, app) {
 		super(readable.type, readable.tableName, app, readable.isView ? "view" : "table");
 		this.readable = readable;
 		this._gates = this._buildGates();
 		this._preferredIdSet = new Set(readable.preferredId ?? []);
+		this._quantityRefByPath = this._collectQuantityRefs();
 		const defaultOverlay = AsReadableController.prototype.applyMetaOverlay;
 		this._overlayIsNoOp = this.applyMetaOverlay === defaultOverlay;
 	}
+	_collectQuantityRefs() {
+		const out = /* @__PURE__ */ new Map();
+		if (!this.readable.flatMap) return out;
+		for (const [path, entry] of this.readable.flatMap) {
+			const meta = entry?.metadata;
+			const ref = meta?.get("db.amount.currency.ref") ?? meta?.get("db.unit.ref");
+			if (ref) out.set(path, ref);
+		}
+		return out;
+	}
 	_buildGates() {
 		const meta = this.readable.type.metadata;
 		const gates = {};
@@ -1066,9 +1079,11 @@ let AsDbReadableController = class AsDbReadableController extends AsReadableCont
 		return projection;
 	}
 	widenPreferredIdProjection(projection) {
-		if (this._preferredIdSet.size === 0 || projection === void 0) return projection;
-		if (Array.isArray(projection)) return this._widenArrayProjection(projection);
-		return this._widenMapProjection(projection);
+		const widened = this.widenQuantityRefProjection(projection);
+		if (widened instanceof _moostjs_event_http.HttpError) return widened;
+		if (this._preferredIdSet.size === 0 || widened === void 0) return widened;
+		if (Array.isArray(widened)) return this._widenArrayProjection(widened);
+		return this._widenMapProjection(widened);
 	}
 	_widenArrayProjection(projection) {
 		const stringItems = /* @__PURE__ */ new Set();
@@ -1108,6 +1123,46 @@ let AsDbReadableController = class AsDbReadableController extends AsReadableCont
 		for (const field of this._preferredIdSet) widened[field] = 1;
 		return widened;
 	}
+	/**
+	* Auto-includes the sibling-ref field whenever its `@db.amount.currency.ref`
+	* / `@db.unit.ref` quantity is selected — UI must never get a value without
+	* its dimension. No-op when `$select` is undefined (full row covers it).
+	*/
+	widenQuantityRefProjection(projection) {
+		if (this._quantityRefByPath.size === 0 || projection === void 0) return projection;
+		if (Array.isArray(projection)) return this._widenQuantityArrayProjection(projection);
+		return this._widenQuantityMapProjection(projection);
+	}
+	_widenQuantityArrayProjection(projection) {
+		const stringItems = /* @__PURE__ */ new Set();
+		for (const item of projection) if (typeof item === "string") stringItems.add(item);
+		const toAdd = [];
+		for (const [valuePath, refPath] of this._quantityRefByPath) if (stringItems.has(valuePath) && !stringItems.has(refPath)) {
+			toAdd.push(refPath);
+			stringItems.add(refPath);
+		}
+		if (toAdd.length === 0) return projection;
+		return [...projection, ...toAdd];
+	}
+	_widenQuantityMapProjection(projection) {
+		const entries = Object.entries(projection);
+		if (entries.length === 0) return projection;
+		const included = /* @__PURE__ */ new Set();
+		const excluded = /* @__PURE__ */ new Set();
+		for (const [k, v] of entries) if (v === 1 || v === true) included.add(k);
+		else if (v === 0 || v === false) excluded.add(k);
+		if (included.size > 0 && excluded.size > 0) return new _moostjs_event_http.HttpError(400, "Mixed inclusion/exclusion $select maps are not supported");
+		if (excluded.size === 0) {
+			const toAdd = [];
+			for (const [valuePath, refPath] of this._quantityRefByPath) if (included.has(valuePath) && !included.has(refPath)) toAdd.push(refPath);
+			if (toAdd.length === 0) return projection;
+			const widened = {};
+			for (const k of included) widened[k] = 1;
+			for (const k of toAdd) widened[k] = 1;
+			return widened;
+		}
+		return projection;
+	}
 	/** WHY: the URL parser only auto-coerces `$count`; every other boolean control reaches us as `"true"`/`"1"` and would fail DTO validation. */
 	_coerceActionsControl(controls) {
 		const v = controls.$actions;

package/dist/index.d.cts

@@ -180,7 +180,10 @@ declare class AsDbReadableController<T extends TAtscriptAnnotatedType = TAtscrip
   private readonly _gates;
   private readonly _preferredIdSet;
   private readonly _overlayIsNoOp;
+  /** path → sibling-ref path for `@db.amount.currency.ref` / `@db.unit.ref`. */
+  private readonly _quantityRefByPath;
   constructor(readable: AtscriptDbReadable<T>, app: Moost);
+  private _collectQuantityRefs;
   private _buildGates;
   private _collectAnnotated;
   protected hasField(path: string): boolean;
@@ -205,6 +208,14 @@ declare class AsDbReadableController<T extends TAtscriptAnnotatedType = TAtscrip
   private widenPreferredIdProjection;
   private _widenArrayProjection;
   private _widenMapProjection;
+  /**
+   * Auto-includes the sibling-ref field whenever its `@db.amount.currency.ref`
+   * / `@db.unit.ref` quantity is selected — UI must never get a value without
+   * its dimension. No-op when `$select` is undefined (full row covers it).
+   */
+  private widenQuantityRefProjection;
+  private _widenQuantityArrayProjection;
+  private _widenQuantityMapProjection;
   /** WHY: the URL parser only auto-coerces `$count`; every other boolean control reaches us as `"true"`/`"1"` and would fail DTO validation. */
   private _coerceActionsControl;
   /** Normalize a post-`widenPreferredIdProjection` $select into `string[] | null` (`null` = all fields). */

package/dist/index.d.mts

@@ -180,7 +180,10 @@ declare class AsDbReadableController<T extends TAtscriptAnnotatedType = TAtscrip
   private readonly _gates;
   private readonly _preferredIdSet;
   private readonly _overlayIsNoOp;
+  /** path → sibling-ref path for `@db.amount.currency.ref` / `@db.unit.ref`. */
+  private readonly _quantityRefByPath;
   constructor(readable: AtscriptDbReadable<T>, app: Moost);
+  private _collectQuantityRefs;
   private _buildGates;
   private _collectAnnotated;
   protected hasField(path: string): boolean;
@@ -205,6 +208,14 @@ declare class AsDbReadableController<T extends TAtscriptAnnotatedType = TAtscrip
   private widenPreferredIdProjection;
   private _widenArrayProjection;
   private _widenMapProjection;
+  /**
+   * Auto-includes the sibling-ref field whenever its `@db.amount.currency.ref`
+   * / `@db.unit.ref` quantity is selected — UI must never get a value without
+   * its dimension. No-op when `$select` is undefined (full row covers it).
+   */
+  private widenQuantityRefProjection;
+  private _widenQuantityArrayProjection;
+  private _widenQuantityMapProjection;
   /** WHY: the URL parser only auto-coerces `$count`; every other boolean control reaches us as `"true"`/`"1"` and would fail DTO validation. */
   private _coerceActionsControl;
   /** Normalize a post-`widenPreferredIdProjection` $select into `string[] | null` (`null` = all fields). */

package/dist/index.mjs

@@ -990,14 +990,27 @@ let AsDbReadableController = class AsDbReadableController extends AsReadableCont
 	_gates;
 	_preferredIdSet;
 	_overlayIsNoOp;
+	/** path → sibling-ref path for `@db.amount.currency.ref` / `@db.unit.ref`. */
+	_quantityRefByPath;
 	constructor(readable, app) {
 		super(readable.type, readable.tableName, app, readable.isView ? "view" : "table");
 		this.readable = readable;
 		this._gates = this._buildGates();
 		this._preferredIdSet = new Set(readable.preferredId ?? []);
+		this._quantityRefByPath = this._collectQuantityRefs();
 		const defaultOverlay = AsReadableController.prototype.applyMetaOverlay;
 		this._overlayIsNoOp = this.applyMetaOverlay === defaultOverlay;
 	}
+	_collectQuantityRefs() {
+		const out = /* @__PURE__ */ new Map();
+		if (!this.readable.flatMap) return out;
+		for (const [path, entry] of this.readable.flatMap) {
+			const meta = entry?.metadata;
+			const ref = meta?.get("db.amount.currency.ref") ?? meta?.get("db.unit.ref");
+			if (ref) out.set(path, ref);
+		}
+		return out;
+	}
 	_buildGates() {
 		const meta = this.readable.type.metadata;
 		const gates = {};
@@ -1065,9 +1078,11 @@ let AsDbReadableController = class AsDbReadableController extends AsReadableCont
 		return projection;
 	}
 	widenPreferredIdProjection(projection) {
-		if (this._preferredIdSet.size === 0 || projection === void 0) return projection;
-		if (Array.isArray(projection)) return this._widenArrayProjection(projection);
-		return this._widenMapProjection(projection);
+		const widened = this.widenQuantityRefProjection(projection);
+		if (widened instanceof HttpError) return widened;
+		if (this._preferredIdSet.size === 0 || widened === void 0) return widened;
+		if (Array.isArray(widened)) return this._widenArrayProjection(widened);
+		return this._widenMapProjection(widened);
 	}
 	_widenArrayProjection(projection) {
 		const stringItems = /* @__PURE__ */ new Set();
@@ -1107,6 +1122,46 @@ let AsDbReadableController = class AsDbReadableController extends AsReadableCont
 		for (const field of this._preferredIdSet) widened[field] = 1;
 		return widened;
 	}
+	/**
+	* Auto-includes the sibling-ref field whenever its `@db.amount.currency.ref`
+	* / `@db.unit.ref` quantity is selected — UI must never get a value without
+	* its dimension. No-op when `$select` is undefined (full row covers it).
+	*/
+	widenQuantityRefProjection(projection) {
+		if (this._quantityRefByPath.size === 0 || projection === void 0) return projection;
+		if (Array.isArray(projection)) return this._widenQuantityArrayProjection(projection);
+		return this._widenQuantityMapProjection(projection);
+	}
+	_widenQuantityArrayProjection(projection) {
+		const stringItems = /* @__PURE__ */ new Set();
+		for (const item of projection) if (typeof item === "string") stringItems.add(item);
+		const toAdd = [];
+		for (const [valuePath, refPath] of this._quantityRefByPath) if (stringItems.has(valuePath) && !stringItems.has(refPath)) {
+			toAdd.push(refPath);
+			stringItems.add(refPath);
+		}
+		if (toAdd.length === 0) return projection;
+		return [...projection, ...toAdd];
+	}
+	_widenQuantityMapProjection(projection) {
+		const entries = Object.entries(projection);
+		if (entries.length === 0) return projection;
+		const included = /* @__PURE__ */ new Set();
+		const excluded = /* @__PURE__ */ new Set();
+		for (const [k, v] of entries) if (v === 1 || v === true) included.add(k);
+		else if (v === 0 || v === false) excluded.add(k);
+		if (included.size > 0 && excluded.size > 0) return new HttpError(400, "Mixed inclusion/exclusion $select maps are not supported");
+		if (excluded.size === 0) {
+			const toAdd = [];
+			for (const [valuePath, refPath] of this._quantityRefByPath) if (included.has(valuePath) && !included.has(refPath)) toAdd.push(refPath);
+			if (toAdd.length === 0) return projection;
+			const widened = {};
+			for (const k of included) widened[k] = 1;
+			for (const k of toAdd) widened[k] = 1;
+			return widened;
+		}
+		return projection;
+	}
 	/** WHY: the URL parser only auto-coerces `$count`; every other boolean control reaches us as `"true"`/`"1"` and would fail DTO validation. */
 	_coerceActionsControl(controls) {
 		const v = controls.$actions;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/moost-db",
-  "version": "0.1.63",
+  "version": "0.1.64",
   "description": "Generic database controller for Moost with Atscript.",
   "keywords": [
     "annotations",
@@ -58,7 +58,7 @@
     "@wooksjs/event-core": "^0.7.10",
     "@wooksjs/http-body": "^0.7.10",
     "moost": "^0.6.8",
-    "@atscript/db": "^0.1.63"
+    "@atscript/db": "^0.1.64"
   },
   "scripts": {
     "postinstall": "asc -f dts",