@aneuhold/be-ts-db-lib 1.0.115 → 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2024] [Anton G Neuhold Jr]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,15 +1,56 @@
 # Personal Backend Database Library
 
-![npm](https://img.shields.io/npm/v/%40aneuhold%2Fbe-ts-db-lib)
+[![JSR](https://jsr.io/badges/@aneuhold/be-ts-db-lib)](https://jsr.io/@aneuhold/be-ts-db-lib)
+[![NPM](https://img.shields.io/npm/v/%40aneuhold%2Fbe-ts-db-lib)](https://www.npmjs.com/package/@aneuhold/be-ts-db-lib)
 
 This is used to actually interact with databases in personal projects.
 
+## 📦 Installation
+
+To add to a repo, follow the instructions below for your environment:
+
+### For Node using NPM
+
+Run `yarn add @aneuhold/be-ts-db-lib`
+
+### For Node using JSR
+
+The below instructions still allow for things like Renovate to work, and normal commands with yarn such as `yarn up`.
+
+1. Add the required JSR configuration to a `.yarnrc.yml` file if not there already:
+   ```yml
+   npmScopes:
+     jsr:
+       npmRegistryServer: 'https://npm.jsr.io'
+   ```
+1. Add the package with `yarn add @jsr/aneuhold__be-ts-db-lib`
+
+### For Deno
+
+Run `deno add jsr:@aneuhold/be-ts-db-lib`
+
+## 🟢 Usage
+
+Pull in one of the services and use it like so:
+
+```ts
+import { DocumentService } from '@aneuhold/be-ts-db-lib';
+// If using Node with JSR
+// import { DocumentService } from '@jsr/aneuhold__be-ts-db-lib';
+
+export default function deepCopy() {
+  DocumentService.deepCopy({ someProperty: 'someString' });
+}
+```
+
+[See full documentation on usage at JSR!](https://jsr.io/@aneuhold/be-ts-db-lib/doc)
+
+## 🛠️ Development
+
 Possible next tasks:
 
 - Make the validators have an updateMany validation that is more performant.
 
-## Development
-
 ### Creating a new Repository
 
 1. Copy an existing one over
@@ -17,13 +58,8 @@ Possible next tasks:
 
 ## Schema Validation for DB
 
-If any of the base document types are updated, make sure to run `yarn validate`
-to make sure that the DB is up-to-date as well.
+If any of the base document types are updated, make sure to run `yarn validate` to ensure that the DB is up-to-date as well.
 
 ## Manual Database Operations
 
-Go ahead and run these as code in a test in the BaseRepository.spec.ts file.
-
-## Dependencies
-
-- [`core-ts-db-lib`](https://github.com/aneuhold/core-ts-db-lib)
+Go ahead and run these as code in a test in the `BaseRepository.spec.ts` file.

package/lib/index.d.ts

@@ -1,10 +1,10 @@
-import ApiKeyRepository from './repositories/common/ApiKeyRepository';
-import UserRepository from './repositories/common/UserRepository';
-import DashboardNonogramKatanaItemRepository from './repositories/dashboard/DashboardNonogramKatanaItemRepository';
-import DashboardNonogramKatanaUpgradeRepository from './repositories/dashboard/DashboardNonogramKatanaUpgradeRepository';
-import DashboardTaskRepository from './repositories/dashboard/DashboardTaskRepository';
-import DashboardUserConfigRepository from './repositories/dashboard/DashboardUserConfigRepository';
-import DocumentDb from './util/DocumentDb';
-export { UserRepository, ApiKeyRepository, DashboardTaskRepository, DashboardUserConfigRepository, DashboardNonogramKatanaItemRepository, DashboardNonogramKatanaUpgradeRepository, DocumentDb };
+import ApiKeyRepository from './repositories/common/ApiKeyRepository.js';
+import UserRepository from './repositories/common/UserRepository.js';
+import DashboardNonogramKatanaItemRepository from './repositories/dashboard/DashboardNonogramKatanaItemRepository.js';
+import DashboardNonogramKatanaUpgradeRepository from './repositories/dashboard/DashboardNonogramKatanaUpgradeRepository.js';
+import DashboardTaskRepository from './repositories/dashboard/DashboardTaskRepository.js';
+import DashboardUserConfigRepository from './repositories/dashboard/DashboardUserConfigRepository.js';
+import DocumentDb from './util/DocumentDb.js';
+export { ApiKeyRepository, DashboardNonogramKatanaItemRepository, DashboardNonogramKatanaUpgradeRepository, DashboardTaskRepository, DashboardUserConfigRepository, DocumentDb, UserRepository };
 export type {};
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,wCAAwC,CAAC;AACtE,OAAO,cAAc,MAAM,sCAAsC,CAAC;AAClE,OAAO,qCAAqC,MAAM,gEAAgE,CAAC;AACnH,OAAO,wCAAwC,MAAM,mEAAmE,CAAC;AACzH,OAAO,uBAAuB,MAAM,kDAAkD,CAAC;AACvF,OAAO,6BAA6B,MAAM,wDAAwD,CAAC;AACnG,OAAO,UAAU,MAAM,mBAAmB,CAAC;AAG3C,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,6BAA6B,EAC7B,qCAAqC,EACrC,wCAAwC,EACxC,UAAU,EACX,CAAC;AAGF,YAAY,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"./src/","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,2CAA2C,CAAC;AACzE,OAAO,cAAc,MAAM,yCAAyC,CAAC;AACrE,OAAO,qCAAqC,MAAM,mEAAmE,CAAC;AACtH,OAAO,wCAAwC,MAAM,sEAAsE,CAAC;AAC5H,OAAO,uBAAuB,MAAM,qDAAqD,CAAC;AAC1F,OAAO,6BAA6B,MAAM,2DAA2D,CAAC;AACtG,OAAO,UAAU,MAAM,sBAAsB,CAAC;AAG9C,OAAO,EACL,gBAAgB,EAChB,qCAAqC,EACrC,wCAAwC,EACxC,uBAAuB,EACvB,6BAA6B,EAC7B,UAAU,EACV,cAAc,EACf,CAAC;AAGF,YAAY,EAAE,CAAC"}

package/lib/index.js

@@ -1,20 +1,10 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DocumentDb = exports.DashboardNonogramKatanaUpgradeRepository = exports.DashboardNonogramKatanaItemRepository = exports.DashboardUserConfigRepository = exports.DashboardTaskRepository = exports.ApiKeyRepository = exports.UserRepository = void 0;
-const ApiKeyRepository_1 = __importDefault(require("./repositories/common/ApiKeyRepository"));
-exports.ApiKeyRepository = ApiKeyRepository_1.default;
-const UserRepository_1 = __importDefault(require("./repositories/common/UserRepository"));
-exports.UserRepository = UserRepository_1.default;
-const DashboardNonogramKatanaItemRepository_1 = __importDefault(require("./repositories/dashboard/DashboardNonogramKatanaItemRepository"));
-exports.DashboardNonogramKatanaItemRepository = DashboardNonogramKatanaItemRepository_1.default;
-const DashboardNonogramKatanaUpgradeRepository_1 = __importDefault(require("./repositories/dashboard/DashboardNonogramKatanaUpgradeRepository"));
-exports.DashboardNonogramKatanaUpgradeRepository = DashboardNonogramKatanaUpgradeRepository_1.default;
-const DashboardTaskRepository_1 = __importDefault(require("./repositories/dashboard/DashboardTaskRepository"));
-exports.DashboardTaskRepository = DashboardTaskRepository_1.default;
-const DashboardUserConfigRepository_1 = __importDefault(require("./repositories/dashboard/DashboardUserConfigRepository"));
-exports.DashboardUserConfigRepository = DashboardUserConfigRepository_1.default;
-const DocumentDb_1 = __importDefault(require("./util/DocumentDb"));
-exports.DocumentDb = DocumentDb_1.default;
+import ApiKeyRepository from './repositories/common/ApiKeyRepository.js';
+import UserRepository from './repositories/common/UserRepository.js';
+import DashboardNonogramKatanaItemRepository from './repositories/dashboard/DashboardNonogramKatanaItemRepository.js';
+import DashboardNonogramKatanaUpgradeRepository from './repositories/dashboard/DashboardNonogramKatanaUpgradeRepository.js';
+import DashboardTaskRepository from './repositories/dashboard/DashboardTaskRepository.js';
+import DashboardUserConfigRepository from './repositories/dashboard/DashboardUserConfigRepository.js';
+import DocumentDb from './util/DocumentDb.js';
+// Export all the functions and classes from this library
+export { ApiKeyRepository, DashboardNonogramKatanaItemRepository, DashboardNonogramKatanaUpgradeRepository, DashboardTaskRepository, DashboardUserConfigRepository, DocumentDb, UserRepository };
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"./src/","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,2CAA2C,CAAC;AACzE,OAAO,cAAc,MAAM,yCAAyC,CAAC;AACrE,OAAO,qCAAqC,MAAM,mEAAmE,CAAC;AACtH,OAAO,wCAAwC,MAAM,sEAAsE,CAAC;AAC5H,OAAO,uBAAuB,MAAM,qDAAqD,CAAC;AAC1F,OAAO,6BAA6B,MAAM,2DAA2D,CAAC;AACtG,OAAO,UAAU,MAAM,sBAAsB,CAAC;AAE9C,yDAAyD;AACzD,OAAO,EACL,gBAAgB,EAChB,qCAAqC,EACrC,wCAAwC,EACxC,uBAAuB,EACvB,6BAA6B,EAC7B,UAAU,EACV,cAAc,EACf,CAAC"}

package/lib/index.ts

@@ -0,0 +1,21 @@
+import ApiKeyRepository from './repositories/common/ApiKeyRepository.js';
+import UserRepository from './repositories/common/UserRepository.js';
+import DashboardNonogramKatanaItemRepository from './repositories/dashboard/DashboardNonogramKatanaItemRepository.js';
+import DashboardNonogramKatanaUpgradeRepository from './repositories/dashboard/DashboardNonogramKatanaUpgradeRepository.js';
+import DashboardTaskRepository from './repositories/dashboard/DashboardTaskRepository.js';
+import DashboardUserConfigRepository from './repositories/dashboard/DashboardUserConfigRepository.js';
+import DocumentDb from './util/DocumentDb.js';
+
+// Export all the functions and classes from this library
+export {
+  ApiKeyRepository,
+  DashboardNonogramKatanaItemRepository,
+  DashboardNonogramKatanaUpgradeRepository,
+  DashboardTaskRepository,
+  DashboardUserConfigRepository,
+  DocumentDb,
+  UserRepository
+};
+
+// Export TypeScript types where needed
+export type {};

package/lib/repositories/BaseRepository.d.ts

@@ -1,10 +1,12 @@
 import { BaseDocument } from '@aneuhold/core-ts-db-lib';
-import { BulkWriteResult, Collection, DeleteResult, Filter, UpdateResult } from 'mongodb';
 import { Document, ObjectId } from 'bson';
-import IValidator from '../validators/BaseValidator';
-import { RepoListeners } from '../services/RepoSubscriptionService';
+import { BulkWriteResult, Collection, DeleteResult, Filter, UpdateResult } from 'mongodb';
+import { RepoListeners, RepoSubscribers } from '../services/RepoSubscriptionService.js';
+import IValidator from '../validators/BaseValidator.js';
 /**
- * A base repository that implements a lot of the normal CRUD operations.
+ * Base repository class for handling common database operations.
+ *
+ * @template TBasetype - The type of the documents in the collection.
  */
 export default abstract class BaseRepository<TBasetype extends BaseDocument> {
     private validator;
@@ -12,50 +14,108 @@ export default abstract class BaseRepository<TBasetype extends BaseDocument> {
     private defaultUpdateCleaner?;
     protected collectionName: string;
     private collection?;
-    protected subscribers: import("../services/RepoSubscriptionService").RepoSubscribers<TBasetype>;
+    protected subscribers: RepoSubscribers<TBasetype>;
     /**
      * Constructs a new base repository.
      *
-     * @param defaultUpdateCleaner this is a function that will be run on the
-     * update object before it is sent to the DB. This is useful for removing
-     * fields that should not be updated. Only remove fields that are at the
-     * top-level of the object. _id is already removed.
+     * @param collectionName - The name of the collection.
+     * @param validator - The validator for the document type.
+     * @param defaultFilter - The default filter to apply to queries.
+     * @param defaultUpdateCleaner - A function to clean update objects before sending to the DB.
      */
     constructor(collectionName: string, validator: IValidator<TBasetype>, defaultFilter?: Partial<TBasetype> | undefined, defaultUpdateCleaner?: ((doc: Partial<TBasetype>) => Partial<TBasetype>) | undefined);
+    /**
+     * Gets the collection, initializing it if necessary.
+     *
+     * @returns The collection.
+     */
     protected getCollection(): Promise<Collection<TBasetype>>;
     protected abstract setupSubscribers(): void;
     /**
      * Registers a set of functions that will be called when a change happens
      * in this repository.
+     *
+     * @param listeners - The listeners to register.
      */
     subscribeToChanges(listeners: RepoListeners<TBasetype>): void;
+    /**
+     * Inserts a new document into the collection.
+     *
+     * @param newDoc - The new document to insert.
+     * @returns The inserted document or null if the insertion failed.
+     */
     insertNew(newDoc: TBasetype): Promise<TBasetype | null>;
+    /**
+     * Inserts multiple new documents into the collection.
+     *
+     * @param newDocs - The new documents to insert.
+     * @returns The inserted documents or an empty array if the insertion failed.
+     */
     insertMany(newDocs: TBasetype[]): Promise<TBasetype[]>;
+    /**
+     * Retrieves a document matching the given filter.
+     *
+     * @param filter - The filter to apply.
+     * @returns The matching document or null if no document was found.
+     */
     get(filter: Partial<TBasetype>): Promise<TBasetype | null>;
+    /**
+     * Retrieves all documents in the collection.
+     *
+     * @returns An array of all documents in the collection.
+     */
     getAll(): Promise<TBasetype[]>;
     /**
      * Gets all the IDs in the collection as a hash for performant lookups.
+     *
+     * @returns An object where the keys are document IDs and the values are true.
      */
     getAllIdsAsHash(): Promise<{
         [id: string]: boolean;
     }>;
+    /**
+     * Retrieves a list of documents matching the given IDs.
+     *
+     * @param docIds - The IDs of the documents to retrieve.
+     * @returns An array of matching documents.
+     */
     getList(docIds: ObjectId[]): Promise<TBasetype[]>;
+    /**
+     * Deletes a document by its ID.
+     *
+     * @param docId - The ID of the document to delete.
+     * @returns The result of the delete operation.
+     */
     delete(docId: ObjectId): Promise<DeleteResult>;
+    /**
+     * Deletes multiple documents by their IDs.
+     *
+     * @param docIds - The IDs of the documents to delete.
+     * @returns The result of the delete operation.
+     */
     deleteList(docIds: ObjectId[]): Promise<DeleteResult>;
     /**
      * This should not be used except for testing purposes
+     *
+     * @returns The result of the delete operation.
      */
     deleteAll(): Promise<DeleteResult>;
     /**
-     * Updates the provided doc in the DB.
+     * Updates the provided document in the DB.
      *
      * This base method strips the `_id` before updating.
+     *
+     * @param updatedDoc - The document to update.
+     * @returns The result of the update operation.
      */
     update(updatedDoc: Partial<TBasetype>): Promise<UpdateResult>;
     /**
-     * Updates the provided docs in the DB.
+     * Updates the provided documents in the DB.
      *
      * This base method strips the `_id` before updating.
+     *
+     * @param updatedDocs - The documents to update.
+     * @returns The result of the bulk update operation.
      */
     updateMany(updatedDocs: Array<Partial<TBasetype>>): Promise<BulkWriteResult>;
     /**
@@ -63,14 +123,27 @@ export default abstract class BaseRepository<TBasetype extends BaseDocument> {
      *
      * This is purposefully changing the type because of some weird restrictions
      * with the `mongodb` package types.
+     *
+     * @param filter - The filter to apply.
+     * @returns The filter with the default filter applied.
      */
     protected getFilterWithDefault(filter?: Filter<Document>): Filter<Document>;
+    /**
+     * Checks if two arrays of {@link ObjectId} are equal.
+     *
+     * @param array1 - The first array.
+     * @param array2 - The second array.
+     * @returns True if the arrays are equal, false otherwise.
+     */
     protected objectIdArraysAreEqual(array1: ObjectId[], array2: ObjectId[]): boolean;
     /**
      * Cleans the update object by removing the `_id` field and running the
      * default update cleaner if there is one.
      *
      * Returns a shallow copy of the object.
+     *
+     * @param updatedDoc - The document to clean.
+     * @returns The cleaned document.
      */
     private cleanUpdateObject;
 }

package/lib/repositories/BaseRepository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseRepository.d.ts","sourceRoot":"","sources":["../../src/repositories/BaseRepository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAEL,eAAe,EACf,UAAU,EACV,YAAY,EACZ,MAAM,EAEN,YAAY,EACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAE1C,OAAO,UAAU,MAAM,6BAA6B,CAAC;AAErD,OAAgC,EAC9B,aAAa,EACd,MAAM,qCAAqC,CAAC;AAE7C;;GAEG;AACH,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,cAAc,CAAC,SAAS,SAAS,YAAY;IAkBvE,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,aAAa,CAAC;IACtB,OAAO,CAAC,oBAAoB,CAAC;IAnB/B,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC;IAEjC,OAAO,CAAC,UAAU,CAAC,CAAwB;IAE3C,SAAS,CAAC,WAAW,2EACwC;IAE7D;;;;;;;OAOG;gBAED,cAAc,EAAE,MAAM,EACd,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,EAChC,aAAa,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,YAAA,EAClC,oBAAoB,CAAC,GAAE,CAC7B,GAAG,EAAE,OAAO,CAAC,SAAS,CAAC,KACpB,OAAO,CAAC,SAAS,CAAC,aAAA;cAKT,aAAa;IAQ7B,SAAS,CAAC,QAAQ,CAAC,gBAAgB,IAAI,IAAI;IAE3C;;;OAGG;IACH,kBAAkB,CAAC,SAAS,EAAE,aAAa,CAAC,SAAS,CAAC;IAoBhD,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAevD,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAiBtD,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAM1D,MAAM,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAOpC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC;QAAE,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAQrD,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAQjD,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC;IAQ9C,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAW3D;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC;IAKxC;;;;OAIG;IACG,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAiBnE;;;;OAIG;IACG,UAAU,CACd,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GACrC,OAAO,CAAC,eAAe,CAAC;IAwB3B;;;;;OAKG;IACH,SAAS,CAAC,oBAAoB,CAC5B,MAAM,GAAE,MAAM,CAAC,QAAQ,CAAM,GAC5B,MAAM,CAAC,QAAQ,CAAC;IAOnB,SAAS,CAAC,sBAAsB,CAC9B,MAAM,EAAE,QAAQ,EAAE,EAClB,MAAM,EAAE,QAAQ,EAAE,GACjB,OAAO;IAOV;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;CAO1B"}
+{"version":3,"file":"BaseRepository.d.ts","sourceRoot":"./src/","sources":["repositories/BaseRepository.ts"],"names":[],"mappings":"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"}

package/lib/repositories/BaseRepository.js

@@ -1,28 +1,25 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const DocumentDb_1 = __importDefault(require("../util/DocumentDb"));
-const DocumentCleaner_1 = __importDefault(require("../util/DocumentCleaner"));
-const RepoSubscriptionService_1 = __importDefault(require("../services/RepoSubscriptionService"));
+import RepoSubscriptionService from '../services/RepoSubscriptionService.js';
+import DocumentCleaner from '../util/DocumentCleaner.js';
+import DocumentDb from '../util/DocumentDb.js';
 /**
- * A base repository that implements a lot of the normal CRUD operations.
+ * Base repository class for handling common database operations.
+ *
+ * @template TBasetype - The type of the documents in the collection.
  */
-class BaseRepository {
+export default class BaseRepository {
     validator;
     defaultFilter;
     defaultUpdateCleaner;
     collectionName;
     collection;
-    subscribers = RepoSubscriptionService_1.default.getDefaultSubscribers();
+    subscribers = RepoSubscriptionService.getDefaultSubscribers();
     /**
      * Constructs a new base repository.
      *
-     * @param defaultUpdateCleaner this is a function that will be run on the
-     * update object before it is sent to the DB. This is useful for removing
-     * fields that should not be updated. Only remove fields that are at the
-     * top-level of the object. _id is already removed.
+     * @param collectionName - The name of the collection.
+     * @param validator - The validator for the document type.
+     * @param defaultFilter - The default filter to apply to queries.
+     * @param defaultUpdateCleaner - A function to clean update objects before sending to the DB.
      */
     constructor(collectionName, validator, defaultFilter, defaultUpdateCleaner) {
         this.validator = validator;
@@ -30,9 +27,14 @@ class BaseRepository {
         this.defaultUpdateCleaner = defaultUpdateCleaner;
         this.collectionName = collectionName;
     }
+    /**
+     * Gets the collection, initializing it if necessary.
+     *
+     * @returns The collection.
+     */
     async getCollection() {
         if (!this.collection) {
-            this.collection = await DocumentDb_1.default.getCollection(this.collectionName);
+            this.collection = await DocumentDb.getCollection(this.collectionName);
             this.setupSubscribers();
         }
         return this.collection;
@@ -40,6 +42,8 @@ class BaseRepository {
     /**
      * Registers a set of functions that will be called when a change happens
      * in this repository.
+     *
+     * @param listeners - The listeners to register.
      */
     subscribeToChanges(listeners) {
         const { insertNew, updateOne, updateMany, deleteOne, deleteList } = listeners;
@@ -59,6 +63,12 @@ class BaseRepository {
             this.subscribers.deleteList.push(deleteList);
         }
     }
+    /**
+     * Inserts a new document into the collection.
+     *
+     * @param newDoc - The new document to insert.
+     * @returns The inserted document or null if the insertion failed.
+     */
     async insertNew(newDoc) {
         const collection = await this.getCollection();
         await this.validator.validateNewObject(newDoc);
@@ -69,6 +79,12 @@ class BaseRepository {
         await Promise.all(this.subscribers.insertNew.map((subscriber) => subscriber(newDoc)));
         return newDoc;
     }
+    /**
+     * Inserts multiple new documents into the collection.
+     *
+     * @param newDocs - The new documents to insert.
+     * @returns The inserted documents or an empty array if the insertion failed.
+     */
     async insertMany(newDocs) {
         const collection = await this.getCollection();
         await Promise.all(newDocs.map((doc) => this.validator.validateNewObject(doc)));
@@ -79,11 +95,22 @@ class BaseRepository {
         await Promise.all(this.subscribers.insertMany.map((subscriber) => subscriber(newDocs)));
         return newDocs;
     }
+    /**
+     * Retrieves a document matching the given filter.
+     *
+     * @param filter - The filter to apply.
+     * @returns The matching document or null if no document was found.
+     */
     async get(filter) {
         const collection = await this.getCollection();
         const result = await collection.findOne(this.getFilterWithDefault(filter));
         return result;
     }
+    /**
+     * Retrieves all documents in the collection.
+     *
+     * @returns An array of all documents in the collection.
+     */
     async getAll() {
         const collection = await this.getCollection();
         const result = await collection.find(this.getFilterWithDefault()).toArray();
@@ -92,6 +119,8 @@ class BaseRepository {
     }
     /**
      * Gets all the IDs in the collection as a hash for performant lookups.
+     *
+     * @returns An object where the keys are document IDs and the values are true.
      */
     async getAllIdsAsHash() {
         const allDocs = await this.getAll();
@@ -100,6 +129,12 @@ class BaseRepository {
             return acc;
         }, {});
     }
+    /**
+     * Retrieves a list of documents matching the given IDs.
+     *
+     * @param docIds - The IDs of the documents to retrieve.
+     * @returns An array of matching documents.
+     */
     async getList(docIds) {
         const collection = await this.getCollection();
         const result = await collection
@@ -107,11 +142,23 @@ class BaseRepository {
             .toArray();
         return result;
     }
+    /**
+     * Deletes a document by its ID.
+     *
+     * @param docId - The ID of the document to delete.
+     * @returns The result of the delete operation.
+     */
     async delete(docId) {
         const collection = await this.getCollection();
         await Promise.all(this.subscribers.deleteOne.map((subscriber) => subscriber(docId)));
         return collection.deleteOne({ _id: docId });
     }
+    /**
+     * Deletes multiple documents by their IDs.
+     *
+     * @param docIds - The IDs of the documents to delete.
+     * @returns The result of the delete operation.
+     */
     async deleteList(docIds) {
         const collection = await this.getCollection();
         const deleteResult = collection.deleteMany({
@@ -122,15 +169,20 @@ class BaseRepository {
     }
     /**
      * This should not be used except for testing purposes
+     *
+     * @returns The result of the delete operation.
      */
     async deleteAll() {
         const collection = await this.getCollection();
         return collection.deleteMany(this.getFilterWithDefault());
     }
     /**
-     * Updates the provided doc in the DB.
+     * Updates the provided document in the DB.
      *
      * This base method strips the `_id` before updating.
+     *
+     * @param updatedDoc - The document to update.
+     * @returns The result of the update operation.
      */
     async update(updatedDoc) {
         const collection = await this.getCollection();
@@ -144,9 +196,12 @@ class BaseRepository {
         return result;
     }
     /**
-     * Updates the provided docs in the DB.
+     * Updates the provided documents in the DB.
      *
      * This base method strips the `_id` before updating.
+     *
+     * @param updatedDocs - The documents to update.
+     * @returns The result of the bulk update operation.
      */
     async updateMany(updatedDocs) {
         const collection = await this.getCollection();
@@ -169,6 +224,9 @@ class BaseRepository {
      *
      * This is purposefully changing the type because of some weird restrictions
      * with the `mongodb` package types.
+     *
+     * @param filter - The filter to apply.
+     * @returns The filter with the default filter applied.
      */
     getFilterWithDefault(filter = {}) {
         if (!this.defaultFilter) {
@@ -176,6 +234,13 @@ class BaseRepository {
         }
         return { ...filter, ...this.defaultFilter };
     }
+    /**
+     * Checks if two arrays of {@link ObjectId} are equal.
+     *
+     * @param array1 - The first array.
+     * @param array2 - The second array.
+     * @returns True if the arrays are equal, false otherwise.
+     */
     objectIdArraysAreEqual(array1, array2) {
         if (array1.length !== array2.length) {
             return false;
@@ -187,11 +252,14 @@ class BaseRepository {
      * default update cleaner if there is one.
      *
      * Returns a shallow copy of the object.
+     *
+     * @param updatedDoc - The document to clean.
+     * @returns The cleaned document.
      */
     cleanUpdateObject(updatedDoc) {
         return this.defaultUpdateCleaner
-            ? this.defaultUpdateCleaner(DocumentCleaner_1.default.id(updatedDoc))
-            : DocumentCleaner_1.default.id(updatedDoc);
+            ? this.defaultUpdateCleaner(DocumentCleaner.id(updatedDoc))
+            : DocumentCleaner.id(updatedDoc);
     }
 }
-exports.default = BaseRepository;
+//# sourceMappingURL=BaseRepository.js.map

package/lib/repositories/BaseRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseRepository.js","sourceRoot":"./src/","sources":["repositories/BaseRepository.ts"],"names":[],"mappings":"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"}