@atscript/db-mongo 0.1.140 → 0.1.142

package/dist/index.cjs

@@ -1033,7 +1033,10 @@ function joinedAs(table) {
 *    pipeline paths (SQL null semantics — `queryNodeToExpr`).
 *
 * All field paths are PHYSICAL document paths (`@db.column` renames), joined
-* tables live under `__joined_<table>`. A column whose source may be missing
+* tables live under `__joined_<scope>` — the physical collection, or the
+* `@db.alias` type name for an aliased join (`__joined_Manager`), whose
+* `$lookup.from` stays the physical collection (since 0.1.141).
+* The entry collection and a `$lookup.from` may be views. A column whose source may be missing
 * (`nullable` mapping) reads as null; every other column is a plain path, so
 * a `$match` / `$sort` on the view can still push down to an index.
 * @since 0.1.136
@@ -1052,10 +1055,10 @@ function buildViewPipeline(view) {
 	for (const join of plan.joins) {
 		pipeline.push(buildLookup(view, join, prefixes));
 		pipeline.push({ $unwind: {
-			path: `$${joinedAs(join.targetTable)}`,
+			path: `$${joinedAs(join.scope)}`,
 			preserveNullAndEmptyArrays: join.kind === "left"
 		} });
-		prefixes.set(join.targetTable, `${joinedAs(join.targetTable)}.`);
+		prefixes.set(join.scope, `${joinedAs(join.scope)}.`);
 	}
 	if (plan.filter) pipeline.push({ $match: viewMatch(plan.filter, pathOf) });
 	/** A column's source field as an aggregation operand. */
@@ -1099,7 +1102,8 @@ function buildViewPipeline(view) {
 * `$match: { $expr }`, SQL null semantics).
 */
 function buildLookup(view, join, outer) {
-	const as = joinedAs(join.targetTable);
+	const scope = join.scope;
+	const as = joinedAs(scope);
 	const simple = simpleJoinFields(view, join, outer);
 	if (simple) return { $lookup: {
 		from: join.targetTable,
@@ -1110,9 +1114,9 @@ function buildLookup(view, join, outer) {
 	const varByPath = /* @__PURE__ */ new Map();
 	const pathOf = (ref) => {
 		const { table, source } = view.resolveRefSource(ref);
-		if (table === join.targetTable) return `$${source.column}`;
+		if (table === scope) return `$${source.column}`;
 		const prefix = outer.get(table);
-		if (prefix === void 0) throw new Error(`View "${view.tableName}": the join on "${join.targetTable}" references "${table}", which is not joined before it`);
+		if (prefix === void 0) throw new Error(`View "${view.tableName}": the join on "${scope}" references "${table}", which is not joined before it`);
 		const outerPath = prefix + source.column;
 		let varName = varByPath.get(outerPath);
 		if (!varName) {
@@ -1141,14 +1145,15 @@ function simpleJoinFields(view, join, outer) {
 	if ("$or" in node || "$not" in node || "$and" in node) return void 0;
 	const comp = node;
 	if (comp.op !== "$eq" || !(0, _atscript_db.isFieldRef)(comp.right)) return void 0;
+	const scope = join.scope;
 	const left = view.resolveRefSource(comp.left);
 	const right = view.resolveRefSource(comp.right);
 	let target;
 	let local;
-	if (left.table === join.targetTable && right.table !== join.targetTable) {
+	if (left.table === scope && right.table !== scope) {
 		target = left;
 		local = right;
-	} else if (right.table === join.targetTable && left.table !== join.targetTable) {
+	} else if (right.table === scope && left.table !== scope) {
 		target = right;
 		local = left;
 	} else return;
@@ -1895,7 +1900,7 @@ var MongoAdapter = class MongoAdapter extends _atscript_db.BaseDbAdapter {
 	}
 	async nativePatch(filter, patch, ops, expectedVersion) {
 		const mongoFilter = this._buildCasFilter(filter, expectedVersion, "nativePatch");
-		const versionColumn = this._table.versionColumn;
+		const versionColumn = this._table.versionColumnPhysical;
 		const effectiveOps = versionColumn !== void 0 ? {
 			...ops,
 			inc: {
@@ -1905,14 +1910,10 @@ var MongoAdapter = class MongoAdapter extends _atscript_db.BaseDbAdapter {
 		} : ops;
 		const { updateFilter, updateOptions } = new CollectionPatcher(this.getPatcherContext(), patch, effectiveOps).preparePatch();
 		this._log("updateOne (patch)", mongoFilter, updateFilter);
-		const result = await this.collection.updateOne(mongoFilter, updateFilter, {
+		return this._wrapUpdate(() => this.collection.updateOne(mongoFilter, updateFilter, {
 			...updateOptions,
 			...this._getSessionOpts()
-		});
-		return {
-			matchedCount: result.matchedCount,
-			modifiedCount: result.modifiedCount
-		};
+		}));
 	}
 	onBeforeFlatten(_type) {
 		const typeMeta = _type.metadata;
@@ -2144,7 +2145,7 @@ var MongoAdapter = class MongoAdapter extends _atscript_db.BaseDbAdapter {
 	* rather than silently dropping the CAS predicate.
 	*/
 	_buildCasFilter(filter, expectedVersion, op) {
-		const versionColumn = this._table.versionColumn;
+		const versionColumn = this._table.versionColumnPhysical;
 		if (expectedVersion !== void 0 && versionColumn === void 0) throw new Error(`${op}: expectedVersion requires versionColumn`);
 		const mongoFilter = require_mongo_accumulator.buildMongoFilter(filter);
 		if (expectedVersion !== void 0 && versionColumn !== void 0) mongoFilter[versionColumn] = expectedVersion;
@@ -2152,7 +2153,9 @@ var MongoAdapter = class MongoAdapter extends _atscript_db.BaseDbAdapter {
 	}
 	/**
 	* Wraps an async operation to catch MongoDB duplicate key errors
-	* (code 11000) and rethrow as structured `DbError`.
+	* (code 11000) and rethrow as structured `DbError` — every write path
+	* (insert, replace, update, patch, their `*Many` variants) goes through it,
+	* so a unique-index violation is a `CONFLICT` whichever statement hit it.
 	*/
 	async _wrapDuplicateKeyError(fn) {
 		try {
@@ -2165,8 +2168,16 @@ var MongoAdapter = class MongoAdapter extends _atscript_db.BaseDbAdapter {
 			throw error;
 		}
 	}
+	/** An update-shaped write under {@link _wrapDuplicateKeyError}, reduced to `TDbUpdateResult`. */
+	async _wrapUpdate(fn) {
+		const { matchedCount, modifiedCount } = await this._wrapDuplicateKeyError(fn);
+		return {
+			matchedCount,
+			modifiedCount
+		};
+	}
 	async insertOne(data) {
-		const versionColumn = this._table.versionColumn;
+		const versionColumn = this._table.versionColumnPhysical;
 		if (versionColumn !== void 0 && !(versionColumn in data)) data[versionColumn] = 0;
 		if (this._incrementFields.size > 0) {
 			const fields = this._fieldsNeedingIncrement(data);
@@ -2180,7 +2191,7 @@ var MongoAdapter = class MongoAdapter extends _atscript_db.BaseDbAdapter {
 		return { insertedId: objectIdFromStorage(this._resolveInsertedId(data, result.insertedId)) };
 	}
 	async insertMany(data) {
-		const versionColumn = this._table.versionColumn;
+		const versionColumn = this._table.versionColumnPhysical;
 		if (versionColumn !== void 0) {
 			for (const item of data) if (!(versionColumn in item)) item[versionColumn] = 0;
 		}
@@ -2226,30 +2237,22 @@ var MongoAdapter = class MongoAdapter extends _atscript_db.BaseDbAdapter {
 	}
 	async updateOne(filter, data, ops, expectedVersion) {
 		const mongoFilter = this._buildCasFilter(filter, expectedVersion, "updateOne");
-		const updateDoc = buildMongoUpdateDoc(data, ops, this._table.versionColumn);
+		const updateDoc = buildMongoUpdateDoc(data, ops, this._table.versionColumnPhysical);
 		this._log("updateOne", mongoFilter, updateDoc);
-		const result = await this.collection.updateOne(mongoFilter, updateDoc, this._getSessionOpts());
-		return {
-			matchedCount: result.matchedCount,
-			modifiedCount: result.modifiedCount
-		};
+		return this._wrapUpdate(() => this.collection.updateOne(mongoFilter, updateDoc, this._getSessionOpts()));
 	}
 	async replaceOne(filter, data, expectedVersion) {
 		const mongoFilter = this._buildCasFilter(filter, expectedVersion, "replaceOne");
-		const versionColumn = this._table.versionColumn;
+		const versionColumn = this._table.versionColumnPhysical;
 		this._log("replaceOne", mongoFilter, data);
-		let result;
 		if (versionColumn !== void 0) {
 			const pipeline = [{ $replaceWith: {
 				...data,
 				[versionColumn]: { $add: [`$${versionColumn}`, 1] }
 			} }];
-			result = await this._wrapDuplicateKeyError(() => this.collection.updateOne(mongoFilter, pipeline, this._getSessionOpts()));
-		} else result = await this._wrapDuplicateKeyError(() => this.collection.replaceOne(mongoFilter, data, this._getSessionOpts()));
-		return {
-			matchedCount: result.matchedCount,
-			modifiedCount: result.modifiedCount
-		};
+			return this._wrapUpdate(() => this.collection.updateOne(mongoFilter, pipeline, this._getSessionOpts()));
+		}
+		return this._wrapUpdate(() => this.collection.replaceOne(mongoFilter, data, this._getSessionOpts()));
 	}
 	async deleteOne(filter) {
 		const mongoFilter = require_mongo_accumulator.buildMongoFilter(filter);
@@ -2257,25 +2260,17 @@ var MongoAdapter = class MongoAdapter extends _atscript_db.BaseDbAdapter {
 		return { deletedCount: (await this.collection.deleteOne(mongoFilter, this._getSessionOpts())).deletedCount };
 	}
 	async updateMany(filter, data, ops) {
-		const versionColumn = this._table.versionColumn;
+		const versionColumn = this._table.versionColumnPhysical;
 		const mongoFilter = require_mongo_accumulator.buildMongoFilter(filter);
 		const updateDoc = buildMongoUpdateDoc(data, ops, versionColumn);
 		this._log("updateMany", mongoFilter, updateDoc);
-		const result = await this.collection.updateMany(mongoFilter, updateDoc, this._getSessionOpts());
-		return {
-			matchedCount: result.matchedCount,
-			modifiedCount: result.modifiedCount
-		};
+		return this._wrapUpdate(() => this.collection.updateMany(mongoFilter, updateDoc, this._getSessionOpts()));
 	}
 	async replaceMany(filter, data) {
 		const mongoFilter = require_mongo_accumulator.buildMongoFilter(filter);
-		const updateDoc = buildMongoUpdateDoc(data, void 0, this._table.versionColumn);
+		const updateDoc = buildMongoUpdateDoc(data, void 0, this._table.versionColumnPhysical);
 		this._log("replaceMany", mongoFilter, updateDoc);
-		const result = await this.collection.updateMany(mongoFilter, updateDoc, this._getSessionOpts());
-		return {
-			matchedCount: result.matchedCount,
-			modifiedCount: result.modifiedCount
-		};
+		return this._wrapUpdate(() => this.collection.updateMany(mongoFilter, updateDoc, this._getSessionOpts()));
 	}
 	async deleteMany(filter) {
 		const mongoFilter = require_mongo_accumulator.buildMongoFilter(filter);

package/dist/index.d.cts

@@ -390,9 +390,13 @@ declare class MongoAdapter extends BaseDbAdapter {
   private _buildCasFilter;
   /**
    * Wraps an async operation to catch MongoDB duplicate key errors
-   * (code 11000) and rethrow as structured `DbError`.
+   * (code 11000) and rethrow as structured `DbError` — every write path
+   * (insert, replace, update, patch, their `*Many` variants) goes through it,
+   * so a unique-index violation is a `CONFLICT` whichever statement hit it.
    */
   private _wrapDuplicateKeyError;
+  /** An update-shaped write under {@link _wrapDuplicateKeyError}, reduced to `TDbUpdateResult`. */
+  private _wrapUpdate;
   insertOne(data: Record<string, unknown>): Promise<TDbInsertResult>;
   insertMany(data: Array<Record<string, unknown>>): Promise<TDbInsertManyResult>;
   findOne(query: DbQuery): Promise<Record<string, unknown> | null>;

package/dist/index.d.mts

@@ -390,9 +390,13 @@ declare class MongoAdapter extends BaseDbAdapter {
   private _buildCasFilter;
   /**
    * Wraps an async operation to catch MongoDB duplicate key errors
-   * (code 11000) and rethrow as structured `DbError`.
+   * (code 11000) and rethrow as structured `DbError` — every write path
+   * (insert, replace, update, patch, their `*Many` variants) goes through it,
+   * so a unique-index violation is a `CONFLICT` whichever statement hit it.
    */
   private _wrapDuplicateKeyError;
+  /** An update-shaped write under {@link _wrapDuplicateKeyError}, reduced to `TDbUpdateResult`. */
+  private _wrapUpdate;
   insertOne(data: Record<string, unknown>): Promise<TDbInsertResult>;
   insertMany(data: Array<Record<string, unknown>>): Promise<TDbInsertManyResult>;
   findOne(query: DbQuery): Promise<Record<string, unknown> | null>;

package/dist/index.mjs

@@ -1032,7 +1032,10 @@ function joinedAs(table) {
 *    pipeline paths (SQL null semantics — `queryNodeToExpr`).
 *
 * All field paths are PHYSICAL document paths (`@db.column` renames), joined
-* tables live under `__joined_<table>`. A column whose source may be missing
+* tables live under `__joined_<scope>` — the physical collection, or the
+* `@db.alias` type name for an aliased join (`__joined_Manager`), whose
+* `$lookup.from` stays the physical collection (since 0.1.141).
+* The entry collection and a `$lookup.from` may be views. A column whose source may be missing
 * (`nullable` mapping) reads as null; every other column is a plain path, so
 * a `$match` / `$sort` on the view can still push down to an index.
 * @since 0.1.136
@@ -1051,10 +1054,10 @@ function buildViewPipeline(view) {
 	for (const join of plan.joins) {
 		pipeline.push(buildLookup(view, join, prefixes));
 		pipeline.push({ $unwind: {
-			path: `$${joinedAs(join.targetTable)}`,
+			path: `$${joinedAs(join.scope)}`,
 			preserveNullAndEmptyArrays: join.kind === "left"
 		} });
-		prefixes.set(join.targetTable, `${joinedAs(join.targetTable)}.`);
+		prefixes.set(join.scope, `${joinedAs(join.scope)}.`);
 	}
 	if (plan.filter) pipeline.push({ $match: viewMatch(plan.filter, pathOf) });
 	/** A column's source field as an aggregation operand. */
@@ -1098,7 +1101,8 @@ function buildViewPipeline(view) {
 * `$match: { $expr }`, SQL null semantics).
 */
 function buildLookup(view, join, outer) {
-	const as = joinedAs(join.targetTable);
+	const scope = join.scope;
+	const as = joinedAs(scope);
 	const simple = simpleJoinFields(view, join, outer);
 	if (simple) return { $lookup: {
 		from: join.targetTable,
@@ -1109,9 +1113,9 @@ function buildLookup(view, join, outer) {
 	const varByPath = /* @__PURE__ */ new Map();
 	const pathOf = (ref) => {
 		const { table, source } = view.resolveRefSource(ref);
-		if (table === join.targetTable) return `$${source.column}`;
+		if (table === scope) return `$${source.column}`;
 		const prefix = outer.get(table);
-		if (prefix === void 0) throw new Error(`View "${view.tableName}": the join on "${join.targetTable}" references "${table}", which is not joined before it`);
+		if (prefix === void 0) throw new Error(`View "${view.tableName}": the join on "${scope}" references "${table}", which is not joined before it`);
 		const outerPath = prefix + source.column;
 		let varName = varByPath.get(outerPath);
 		if (!varName) {
@@ -1140,14 +1144,15 @@ function simpleJoinFields(view, join, outer) {
 	if ("$or" in node || "$not" in node || "$and" in node) return void 0;
 	const comp = node;
 	if (comp.op !== "$eq" || !isFieldRef(comp.right)) return void 0;
+	const scope = join.scope;
 	const left = view.resolveRefSource(comp.left);
 	const right = view.resolveRefSource(comp.right);
 	let target;
 	let local;
-	if (left.table === join.targetTable && right.table !== join.targetTable) {
+	if (left.table === scope && right.table !== scope) {
 		target = left;
 		local = right;
-	} else if (right.table === join.targetTable && left.table !== join.targetTable) {
+	} else if (right.table === scope && left.table !== scope) {
 		target = right;
 		local = left;
 	} else return;
@@ -1894,7 +1899,7 @@ var MongoAdapter = class MongoAdapter extends BaseDbAdapter {
 	}
 	async nativePatch(filter, patch, ops, expectedVersion) {
 		const mongoFilter = this._buildCasFilter(filter, expectedVersion, "nativePatch");
-		const versionColumn = this._table.versionColumn;
+		const versionColumn = this._table.versionColumnPhysical;
 		const effectiveOps = versionColumn !== void 0 ? {
 			...ops,
 			inc: {
@@ -1904,14 +1909,10 @@ var MongoAdapter = class MongoAdapter extends BaseDbAdapter {
 		} : ops;
 		const { updateFilter, updateOptions } = new CollectionPatcher(this.getPatcherContext(), patch, effectiveOps).preparePatch();
 		this._log("updateOne (patch)", mongoFilter, updateFilter);
-		const result = await this.collection.updateOne(mongoFilter, updateFilter, {
+		return this._wrapUpdate(() => this.collection.updateOne(mongoFilter, updateFilter, {
 			...updateOptions,
 			...this._getSessionOpts()
-		});
-		return {
-			matchedCount: result.matchedCount,
-			modifiedCount: result.modifiedCount
-		};
+		}));
 	}
 	onBeforeFlatten(_type) {
 		const typeMeta = _type.metadata;
@@ -2143,7 +2144,7 @@ var MongoAdapter = class MongoAdapter extends BaseDbAdapter {
 	* rather than silently dropping the CAS predicate.
 	*/
 	_buildCasFilter(filter, expectedVersion, op) {
-		const versionColumn = this._table.versionColumn;
+		const versionColumn = this._table.versionColumnPhysical;
 		if (expectedVersion !== void 0 && versionColumn === void 0) throw new Error(`${op}: expectedVersion requires versionColumn`);
 		const mongoFilter = buildMongoFilter(filter);
 		if (expectedVersion !== void 0 && versionColumn !== void 0) mongoFilter[versionColumn] = expectedVersion;
@@ -2151,7 +2152,9 @@ var MongoAdapter = class MongoAdapter extends BaseDbAdapter {
 	}
 	/**
 	* Wraps an async operation to catch MongoDB duplicate key errors
-	* (code 11000) and rethrow as structured `DbError`.
+	* (code 11000) and rethrow as structured `DbError` — every write path
+	* (insert, replace, update, patch, their `*Many` variants) goes through it,
+	* so a unique-index violation is a `CONFLICT` whichever statement hit it.
 	*/
 	async _wrapDuplicateKeyError(fn) {
 		try {
@@ -2164,8 +2167,16 @@ var MongoAdapter = class MongoAdapter extends BaseDbAdapter {
 			throw error;
 		}
 	}
+	/** An update-shaped write under {@link _wrapDuplicateKeyError}, reduced to `TDbUpdateResult`. */
+	async _wrapUpdate(fn) {
+		const { matchedCount, modifiedCount } = await this._wrapDuplicateKeyError(fn);
+		return {
+			matchedCount,
+			modifiedCount
+		};
+	}
 	async insertOne(data) {
-		const versionColumn = this._table.versionColumn;
+		const versionColumn = this._table.versionColumnPhysical;
 		if (versionColumn !== void 0 && !(versionColumn in data)) data[versionColumn] = 0;
 		if (this._incrementFields.size > 0) {
 			const fields = this._fieldsNeedingIncrement(data);
@@ -2179,7 +2190,7 @@ var MongoAdapter = class MongoAdapter extends BaseDbAdapter {
 		return { insertedId: objectIdFromStorage(this._resolveInsertedId(data, result.insertedId)) };
 	}
 	async insertMany(data) {
-		const versionColumn = this._table.versionColumn;
+		const versionColumn = this._table.versionColumnPhysical;
 		if (versionColumn !== void 0) {
 			for (const item of data) if (!(versionColumn in item)) item[versionColumn] = 0;
 		}
@@ -2225,30 +2236,22 @@ var MongoAdapter = class MongoAdapter extends BaseDbAdapter {
 	}
 	async updateOne(filter, data, ops, expectedVersion) {
 		const mongoFilter = this._buildCasFilter(filter, expectedVersion, "updateOne");
-		const updateDoc = buildMongoUpdateDoc(data, ops, this._table.versionColumn);
+		const updateDoc = buildMongoUpdateDoc(data, ops, this._table.versionColumnPhysical);
 		this._log("updateOne", mongoFilter, updateDoc);
-		const result = await this.collection.updateOne(mongoFilter, updateDoc, this._getSessionOpts());
-		return {
-			matchedCount: result.matchedCount,
-			modifiedCount: result.modifiedCount
-		};
+		return this._wrapUpdate(() => this.collection.updateOne(mongoFilter, updateDoc, this._getSessionOpts()));
 	}
 	async replaceOne(filter, data, expectedVersion) {
 		const mongoFilter = this._buildCasFilter(filter, expectedVersion, "replaceOne");
-		const versionColumn = this._table.versionColumn;
+		const versionColumn = this._table.versionColumnPhysical;
 		this._log("replaceOne", mongoFilter, data);
-		let result;
 		if (versionColumn !== void 0) {
 			const pipeline = [{ $replaceWith: {
 				...data,
 				[versionColumn]: { $add: [`$${versionColumn}`, 1] }
 			} }];
-			result = await this._wrapDuplicateKeyError(() => this.collection.updateOne(mongoFilter, pipeline, this._getSessionOpts()));
-		} else result = await this._wrapDuplicateKeyError(() => this.collection.replaceOne(mongoFilter, data, this._getSessionOpts()));
-		return {
-			matchedCount: result.matchedCount,
-			modifiedCount: result.modifiedCount
-		};
+			return this._wrapUpdate(() => this.collection.updateOne(mongoFilter, pipeline, this._getSessionOpts()));
+		}
+		return this._wrapUpdate(() => this.collection.replaceOne(mongoFilter, data, this._getSessionOpts()));
 	}
 	async deleteOne(filter) {
 		const mongoFilter = buildMongoFilter(filter);
@@ -2256,25 +2259,17 @@ var MongoAdapter = class MongoAdapter extends BaseDbAdapter {
 		return { deletedCount: (await this.collection.deleteOne(mongoFilter, this._getSessionOpts())).deletedCount };
 	}
 	async updateMany(filter, data, ops) {
-		const versionColumn = this._table.versionColumn;
+		const versionColumn = this._table.versionColumnPhysical;
 		const mongoFilter = buildMongoFilter(filter);
 		const updateDoc = buildMongoUpdateDoc(data, ops, versionColumn);
 		this._log("updateMany", mongoFilter, updateDoc);
-		const result = await this.collection.updateMany(mongoFilter, updateDoc, this._getSessionOpts());
-		return {
-			matchedCount: result.matchedCount,
-			modifiedCount: result.modifiedCount
-		};
+		return this._wrapUpdate(() => this.collection.updateMany(mongoFilter, updateDoc, this._getSessionOpts()));
 	}
 	async replaceMany(filter, data) {
 		const mongoFilter = buildMongoFilter(filter);
-		const updateDoc = buildMongoUpdateDoc(data, void 0, this._table.versionColumn);
+		const updateDoc = buildMongoUpdateDoc(data, void 0, this._table.versionColumnPhysical);
 		this._log("replaceMany", mongoFilter, updateDoc);
-		const result = await this.collection.updateMany(mongoFilter, updateDoc, this._getSessionOpts());
-		return {
-			matchedCount: result.matchedCount,
-			modifiedCount: result.modifiedCount
-		};
+		return this._wrapUpdate(() => this.collection.updateMany(mongoFilter, updateDoc, this._getSessionOpts()));
 	}
 	async deleteMany(filter) {
 		const mongoFilter = buildMongoFilter(filter);

package/dist/plugin.cjs

@@ -52,6 +52,7 @@ const annotations = {
 	collection: new _atscript_core.AnnotationSpec({
 		description: "Marks an interface as a **MongoDB collection**.\n\n- Use together with `@db.table \"name\"` which provides the collection name.\n- Automatically injects a **non-optional** `_id` field if not explicitly defined.\n- `_id` must be of type **`string`**, **`number`**, or **`mongo.objectId`**.\n\n**Example:**\n```atscript\n@db.table \"users\"\n@db.mongo.collection\nexport interface User {\n    _id: mongo.objectId\n    email: string.email\n}\n```\n",
 		nodeType: ["interface"],
+		passedWhenReferred: false,
 		validate(token, args, doc) {
 			const parent = token.parentNode;
 			const struc = parent?.getDefinition();
@@ -91,6 +92,7 @@ const annotations = {
 	capped: new _atscript_core.AnnotationSpec({
 		description: "Creates a **capped collection** with a fixed maximum size.\n\n- Capped collections have fixed size and maintain insertion order.\n- Ideal for logs, event streams, and cache-like data.\n- Changing the cap size requires dropping and recreating the collection — use `@db.sync.method \"drop\"` to allow this.\n\n**Example:**\n```atscript\n@db.table \"logs\"\n@db.mongo.collection\n@db.mongo.capped 10485760, 10000\n@db.sync.method \"drop\"\nexport interface LogEntry {\n    message: string\n    timestamp: number\n}\n```\n",
 		nodeType: ["interface"],
+		passedWhenReferred: false,
 		multiple: false,
 		argument: [{
 			optional: false,
@@ -108,6 +110,7 @@ const annotations = {
 		dynamic: new _atscript_core.AnnotationSpec({
 			description: "Creates a **dynamic MongoDB Search Index** that applies to the entire collection.\n\n- **Indexes all text fields automatically** (no need to specify fields).\n- Supports **language analyzers** for text tokenization.\n- Enables **fuzzy search** (typo tolerance) if needed.\n\n**Example:**\n```atscript\n@db.mongo.search.dynamic \"lucene.english\", 1\nexport interface MongoCollection {}\n```\n",
 			nodeType: ["interface"],
+			passedWhenReferred: false,
 			multiple: false,
 			argument: [{
 				optional: true,
@@ -125,6 +128,7 @@ const annotations = {
 		static: new _atscript_core.AnnotationSpec({
 			description: "Defines a **MongoDB Atlas Search Index** for the collection. The props can refer to this index using `@db.mongo.search.text` annotation.\n\n- **Creates a named search index** for full-text search.\n- **Specify analyzers and fuzzy search** behavior at the index level.\n- **Fields must explicitly use `@db.mongo.search.text`** to be included in this search index.\n\n**Example:**\n```atscript\n@db.mongo.search.static \"lucene.english\", 1, \"mySearchIndex\"\nexport interface MongoCollection {}\n```\n",
 			nodeType: ["interface"],
+			passedWhenReferred: false,
 			multiple: true,
 			argument: [
 				{

package/dist/plugin.mjs

@@ -48,6 +48,7 @@ const annotations = {
 	collection: new AnnotationSpec({
 		description: "Marks an interface as a **MongoDB collection**.\n\n- Use together with `@db.table \"name\"` which provides the collection name.\n- Automatically injects a **non-optional** `_id` field if not explicitly defined.\n- `_id` must be of type **`string`**, **`number`**, or **`mongo.objectId`**.\n\n**Example:**\n```atscript\n@db.table \"users\"\n@db.mongo.collection\nexport interface User {\n    _id: mongo.objectId\n    email: string.email\n}\n```\n",
 		nodeType: ["interface"],
+		passedWhenReferred: false,
 		validate(token, args, doc) {
 			const parent = token.parentNode;
 			const struc = parent?.getDefinition();
@@ -87,6 +88,7 @@ const annotations = {
 	capped: new AnnotationSpec({
 		description: "Creates a **capped collection** with a fixed maximum size.\n\n- Capped collections have fixed size and maintain insertion order.\n- Ideal for logs, event streams, and cache-like data.\n- Changing the cap size requires dropping and recreating the collection — use `@db.sync.method \"drop\"` to allow this.\n\n**Example:**\n```atscript\n@db.table \"logs\"\n@db.mongo.collection\n@db.mongo.capped 10485760, 10000\n@db.sync.method \"drop\"\nexport interface LogEntry {\n    message: string\n    timestamp: number\n}\n```\n",
 		nodeType: ["interface"],
+		passedWhenReferred: false,
 		multiple: false,
 		argument: [{
 			optional: false,
@@ -104,6 +106,7 @@ const annotations = {
 		dynamic: new AnnotationSpec({
 			description: "Creates a **dynamic MongoDB Search Index** that applies to the entire collection.\n\n- **Indexes all text fields automatically** (no need to specify fields).\n- Supports **language analyzers** for text tokenization.\n- Enables **fuzzy search** (typo tolerance) if needed.\n\n**Example:**\n```atscript\n@db.mongo.search.dynamic \"lucene.english\", 1\nexport interface MongoCollection {}\n```\n",
 			nodeType: ["interface"],
+			passedWhenReferred: false,
 			multiple: false,
 			argument: [{
 				optional: true,
@@ -121,6 +124,7 @@ const annotations = {
 		static: new AnnotationSpec({
 			description: "Defines a **MongoDB Atlas Search Index** for the collection. The props can refer to this index using `@db.mongo.search.text` annotation.\n\n- **Creates a named search index** for full-text search.\n- **Specify analyzers and fuzzy search** behavior at the index level.\n- **Fields must explicitly use `@db.mongo.search.text`** to be included in this search index.\n\n**Example:**\n```atscript\n@db.mongo.search.static \"lucene.english\", 1, \"mySearchIndex\"\nexport interface MongoCollection {}\n```\n",
 			nodeType: ["interface"],
+			passedWhenReferred: false,
 			multiple: true,
 			argument: [
 				{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db-mongo",
-  "version": "0.1.140",
+  "version": "0.1.142",
   "description": "Mongodb plugin for atscript.",
   "keywords": [
     "atscript",
@@ -46,19 +46,19 @@
     "access": "public"
   },
   "devDependencies": {
-    "@atscript/core": "^0.1.92",
-    "@atscript/typescript": "^0.1.92",
+    "@atscript/core": "^0.1.95",
+    "@atscript/typescript": "^0.1.95",
     "@uniqu/core": "^0.1.11",
     "mongodb": "^6.17.0",
     "mongodb-memory-server-core": "^10.0.0",
-    "unplugin-atscript": "^0.1.92"
+    "unplugin-atscript": "^0.1.95"
   },
   "peerDependencies": {
-    "@atscript/core": "^0.1.92",
-    "@atscript/typescript": "^0.1.92",
+    "@atscript/core": "^0.1.95",
+    "@atscript/typescript": "^0.1.95",
     "@uniqu/core": "^0.1.11",
     "mongodb": "^6.17.0",
-    "@atscript/db": "^0.1.140"
+    "@atscript/db": "^0.1.142"
   },
   "scripts": {
     "postinstall": "asc -f dts",