@furystack/mongodb-store 10.1.7 → 11.0.1

package/src/mongodb-store.ts

@@ -1,4 +1,5 @@
 import type {
+  Constructable,
   CreateResult,
   FilterType,
   FindOptions,
@@ -6,10 +7,11 @@ import type {
   PhysicalStore,
   WithOptionalId,
 } from '@furystack/core'
-import type { Constructable } from '@furystack/inject'
+import { NotFoundError } from '@furystack/core'
 import { EventHub } from '@furystack/utils'
-import type { Collection, Filter, MongoClient, OptionalUnlessRequiredId, Sort, UpdateFilter } from 'mongodb'
+import type { Collection, Filter, MongoClient, OptionalUnlessRequiredId, Sort } from 'mongodb'
 import { ObjectId } from 'mongodb'
+import type { MongoClientFactory } from './mongo-client-factory.js'
 
 // Improved type safety for hasObjectId
 const hasObjectId = <T extends { _id?: unknown }>(value: T): value is T & { _id: ObjectId } => {
@@ -17,7 +19,19 @@ const hasObjectId = <T extends { _id?: unknown }>(value: T): value is T & { _id:
 }
 
 /**
- * MongoDB Store implementation for FuryStack
+ * {@link PhysicalStore} backed by a MongoDB collection.
+ *
+ * The collection handle is resolved lazily on the first call via
+ * {@link getCollection}; if the primary key is not `_id` a unique index is
+ * created on it during init. Init failure clears the cached promise so the
+ * next call retries.
+ *
+ * When `primaryKey` is `_id`, string keys are transparently coerced to
+ * `ObjectId` for filters and back to hex strings on results so callers can
+ * stay in plain string-key territory.
+ *
+ * The store has no `[Symbol.asyncDispose]` — client lifetime belongs to
+ * {@link MongoClientFactory}, which closes pooled clients on injector teardown.
  */
 export class MongodbStore<
   T extends object,
@@ -142,9 +156,9 @@ export class MongodbStore<
 
   public async update(id: T[TPrimaryKey], data: Partial<T>): Promise<void> {
     const collection = await this.getCollection()
-    const updateResult = await collection.updateOne(this.createIdFilter(id), { $set: data } as UpdateFilter<T>)
+    const updateResult = await collection.updateOne(this.createIdFilter(id), { $set: data })
     if (updateResult.matchedCount < 1) {
-      throw Error(`Entity not found with id '${String(id)}', cannot update!`)
+      throw new NotFoundError(`Entity not found with id '${String(id)}', cannot update`)
     }
     this.emit('onEntityUpdated', { id, change: data })
   }

package/esm/store-manager-helpers.d.ts

@@ -1,33 +0,0 @@
-import type { Constructable, Injector } from '@furystack/inject';
-import type { MongoClientOptions } from 'mongodb';
-export declare const useMongoDb: <T extends object>({ injector, model, primaryKey, db, collection, url, options, }: {
-    /**
-     * The Injector instance to use
-     */
-    injector: Injector;
-    /**
-     * The constructable model class
-     */
-    model: Constructable<T>;
-    /**
-     * The name of the Primary Key property
-     */
-    primaryKey: keyof T;
-    /**
-     * Url of the MongoDb repository
-     */
-    url: string;
-    /**
-     * MongoDb Database name
-     */
-    db: string;
-    /**
-     * MongoDb Collection name
-     */
-    collection: string;
-    /**
-     * Optional options for the MongoDb Client
-     */
-    options?: MongoClientOptions;
-}) => void;
-//# sourceMappingURL=store-manager-helpers.d.ts.map

package/esm/store-manager-helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"store-manager-helpers.d.ts","sourceRoot":"","sources":["../src/store-manager-helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAIjD,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,MAAM,EAAE,gEAQ1C;IACD;;OAEG;IACH,QAAQ,EAAE,QAAQ,CAAA;IAClB;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IACvB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC,CAAA;IACnB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAA;IACX;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IACV;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAA;CAC7B,SAUA,CAAA"}

package/esm/store-manager-helpers.js

@@ -1,15 +0,0 @@
-import { addStore } from '@furystack/core';
-import { MongoClientFactory } from './mongo-client-factory.js';
-import { MongodbStore } from './mongodb-store.js';
-export const useMongoDb = ({ injector, model, primaryKey, db, collection, url, options, }) => {
-    const clientFactory = injector.getInstance(MongoClientFactory);
-    const store = new MongodbStore({
-        model,
-        primaryKey,
-        db,
-        collection,
-        mongoClient: () => clientFactory.getClientFor(url, options),
-    });
-    addStore(injector, store);
-};
-//# sourceMappingURL=store-manager-helpers.js.map

package/esm/store-manager-helpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"store-manager-helpers.js","sourceRoot":"","sources":["../src/store-manager-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAG1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAmB,EAC3C,QAAQ,EACR,KAAK,EACL,UAAU,EACV,EAAE,EACF,UAAU,EACV,GAAG,EACH,OAAO,GA+BR,EAAE,EAAE;IACH,MAAM,aAAa,GAAG,QAAQ,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAA;IAC9D,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC;QAC7B,KAAK;QACL,UAAU;QACV,EAAE;QACF,UAAU;QACV,WAAW,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC;KAC5D,CAAC,CAAA;IACF,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;AAC3B,CAAC,CAAA"}

package/src/store-manager-helpers.ts

@@ -1,55 +0,0 @@
-import { addStore } from '@furystack/core'
-import type { Constructable, Injector } from '@furystack/inject'
-import type { MongoClientOptions } from 'mongodb'
-import { MongoClientFactory } from './mongo-client-factory.js'
-import { MongodbStore } from './mongodb-store.js'
-
-export const useMongoDb = <T extends object>({
-  injector,
-  model,
-  primaryKey,
-  db,
-  collection,
-  url,
-  options,
-}: {
-  /**
-   * The Injector instance to use
-   */
-  injector: Injector
-  /**
-   * The constructable model class
-   */
-  model: Constructable<T>
-  /**
-   * The name of the Primary Key property
-   */
-  primaryKey: keyof T
-  /**
-   * Url of the MongoDb repository
-   */
-  url: string
-  /**
-   * MongoDb Database name
-   */
-  db: string
-  /**
-   * MongoDb Collection name
-   */
-  collection: string
-
-  /**
-   * Optional options for the MongoDb Client
-   */
-  options?: MongoClientOptions
-}) => {
-  const clientFactory = injector.getInstance(MongoClientFactory)
-  const store = new MongodbStore({
-    model,
-    primaryKey,
-    db,
-    collection,
-    mongoClient: () => clientFactory.getClientFor(url, options),
-  })
-  addStore(injector, store)
-}