@atscript/moost-mongo 0.0.18 → 0.0.20

package/README.md

@@ -104,6 +104,28 @@ Decorator that glues your subclass to Moost:
 export class UsersController extends AsMongoController<typeof User> {}
 ```
 
+### Injecting the collection in services
+
+When you need raw collection access outside the generated controller,
+use `@InjectCollection`:
+
+```ts
+@Injectable()
+export class AuditService {
+  constructor(
+    @InjectCollection(User)
+    private users: AsCollection<typeof User>
+  ) {}
+
+  async purgeSoftDeleted() {
+    await this.users.collection.deleteMany({ deleted: true })
+  }
+}
+```
+
+AsMongo is resolved automatically from DI, so make sure it is provided
+globally (see Quick start).
+
 ---
 
 ## Route reference

package/dist/index.cjs

@@ -79,6 +79,10 @@ const COLLECTION_DEF = "__atscript_mongo_collection_def";
 const CollectionController = (type, prefix) => {
 	return (0, moost.ApplyDecorators)((0, moost.Provide)(COLLECTION_DEF, () => type), (0, moost.Controller)(prefix || type.metadata.get("mongo.collection") || type.name), (0, moost.Inherit)());
 };
+const InjectCollection = (type) => (0, moost.Resolve)(async ({ instantiate }) => {
+	const asMongo = await instantiate(__atscript_mongo.AsMongo);
+	return asMongo.getCollection(type);
+});
 
 //#endregion
 //#region packages/moost-mongo/src/as-mongo.controller.ts
@@ -462,4 +466,5 @@ Object.defineProperty(exports, 'AsMongoController', {
   }
 });
 exports.COLLECTION_DEF = COLLECTION_DEF
-exports.CollectionController = CollectionController
+exports.CollectionController = CollectionController
+exports.InjectCollection = InjectCollection

package/dist/index.d.ts

@@ -162,19 +162,19 @@ declare class AsMongoController<T extends TAtscriptAnnotatedTypeConstructor> {
      *
      * @param payload - Raw request body to be inserted.
      */
-    insert(payload: any): Promise<HttpError | InsertOneResult | InsertManyResult>;
+    insert(payload: Parameters<AsCollection<T>['prepareInsert']>[0]): Promise<HttpError | InsertOneResult | InsertManyResult>;
     /**
      * **PUT /** – fully replaces a document matched by `_id`.
      *
      * @param payload - Object containing `_id` plus full replacement document.
      */
-    replace(payload: any): Promise<HttpError | UpdateResult<InstanceType<T>>>;
+    replace(payload: Parameters<AsCollection<T>['prepareReplace']>[0]): Promise<HttpError | UpdateResult<InstanceType<T>>>;
     /**
      * **PATCH /** – updates one document using MongoDB update operators.
      *
      * @param payload - Update payload produced by `asCollection.prepareUpdate`.
      */
-    update(payload: any): Promise<HttpError | UpdateResult>;
+    update(payload: Parameters<AsCollection<T>['prepareUpdate']>[0]): Promise<HttpError | UpdateResult>;
     /**
      * **DELETE /:id** – removes a single document by `_id`.
      *
@@ -229,5 +229,27 @@ declare const COLLECTION_DEF = "__atscript_mongo_collection_def";
  * ```
  */
 declare const CollectionController: (type: TAtscriptAnnotatedTypeConstructor, prefix?: string) => MethodDecorator & ClassDecorator & ParameterDecorator & PropertyDecorator;
+/**
+ * Parameter decorator that injects the lazily-resolved {@link AsCollection}
+ * instance for a given AtScript model.
+ *
+ * > `AsMongo` **must** be provided in the current DI scope
+ * > (e.g. `@Provide(AsMongo, () => new AsMongo(url))`).
+ *
+ * @param type AtScript-annotated constructor produced by
+ *             `@mongo.collection`.
+ *
+ * @example
+ * ```ts
+ * ‎@Injectable()
+ * export class SomeProvider {
+ *   constructor(
+ *     ‎@InjectCollection(User)
+ *     private users: AsCollection<typeof User>
+ *   ) {}
+ * }
+ * ```
+ */
+declare const InjectCollection: (type: TAtscriptAnnotatedTypeConstructor) => ParameterDecorator & PropertyDecorator;
 
-export { AsMongoController, COLLECTION_DEF, CollectionController };
+export { AsMongoController, COLLECTION_DEF, CollectionController, InjectCollection };

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { Body, Delete, Get, HttpError, Patch, Post, Put, Url } from "@moostjs/event-http";
-import { ApplyDecorators, Controller, Inherit, Inject, Moost, Param, Provide } from "moost";
+import { ApplyDecorators, Controller, Inherit, Inject, Moost, Param, Provide, Resolve } from "moost";
 import { parseUrlql } from "urlql";
 import { ValidatorError, defineAnnotatedType } from "@atscript/typescript";
 import { AsMongo } from "@atscript/mongo";
@@ -55,6 +55,10 @@ const COLLECTION_DEF = "__atscript_mongo_collection_def";
 const CollectionController = (type, prefix) => {
 	return ApplyDecorators(Provide(COLLECTION_DEF, () => type), Controller(prefix || type.metadata.get("mongo.collection") || type.name), Inherit());
 };
+const InjectCollection = (type) => Resolve(async ({ instantiate }) => {
+	const asMongo = await instantiate(AsMongo);
+	return asMongo.getCollection(type);
+});
 
 //#endregion
 //#region packages/moost-mongo/src/as-mongo.controller.ts
@@ -431,4 +435,4 @@ AsMongoController = _ts_decorate([
 ], AsMongoController);
 
 //#endregion
-export { AsMongoController, COLLECTION_DEF, CollectionController };
+export { AsMongoController, COLLECTION_DEF, CollectionController, InjectCollection };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/moost-mongo",
-  "version": "0.0.18",
+  "version": "0.0.20",
   "description": "Atscript Mongo for Moost.",
   "type": "module",
   "main": "dist/index.mjs",
@@ -41,11 +41,11 @@
     "vitest": "3.2.4"
   },
   "peerDependencies": {
-    "@moostjs/event-http": "^0.5.30",
+    "@moostjs/event-http": "^0.5.31",
     "mongodb": "^6.17.0",
-    "moost": "^0.5.30",
-    "@atscript/mongo": "^0.0.18",
-    "@atscript/typescript": "^0.0.18"
+    "moost": "^0.5.31",
+    "@atscript/mongo": "^0.0.20",
+    "@atscript/typescript": "^0.0.20"
   },
   "scripts": {
     "pub": "pnpm publish --access public",