@storecraft/database-mongodb 1.0.12 → 1.0.14

package/index.js

@@ -1,3 +1,10 @@
+/**
+ * @import { Config } from './types.public.js'
+ * @import { MongoClientOptions } from 'mongodb'
+ * @import { db_driver } from '@storecraft/core/database'
+ * @import { BaseType } from '@storecraft/core/api'
+ * @import { ENV } from '@storecraft/core'
+ */
 import { App } from '@storecraft/core';
 import { Collection, MongoClient, ServerApiVersion } from 'mongodb';
 import { impl as auth_users } from './src/con.auth_users.js';
@@ -15,66 +22,43 @@ import { impl as tags } from './src/con.tags.js';
 import { impl as templates } from './src/con.templates.js';
 import { impl as search } from './src/con.search.js';
 export { migrateToLatest } from './migrate.js';
+export { MongoVectorStore } from './vector-store/index.js';
 
-/**
- * @typedef {Partial<import('./types.public.d.ts').Config>} Config
- */
-
-/**
- * 
- * @param {string} uri 
- * @param {import('mongodb').MongoClientOptions} [options] 
- */
-const connect = async (uri, options) => {
-
-  options = options ?? {
-    ignoreUndefined: true,
-    serverApi: {
-      version: ServerApiVersion.v1,
-      strict: false,
-      deprecationErrors: true,
-
-    }
-  }
-  const client = new MongoClient(uri, options);
-
-  return client.connect();
-}
 
 /**
- * @typedef {import('@storecraft/core/database').db_driver} db_driver
- * 
- * 
  * @implements {db_driver}
  */
 export class MongoDB {
 
+  /** @satisfies {ENV<Config>} */
+  static EnvConfig = /** @type{const} */ ({
+    db_name: 'MONGODB_NAME',
+    url: 'MONGODB_URL',
+  });
+
   /** 
    * 
    * @type {boolean} 
    */ 
-  #_is_ready;
+  #is_ready;
 
   /** 
    * 
    * @type {App<any, any, any>} 
    */ 
-  #_app;
+  #app;
 
   /** 
    * 
    * @type {MongoClient} 
    */ 
-  #_mongo_client;
+  #mongo_client;
 
   /** 
    * 
    * @type {Config} 
    */ 
-  #_config;
-
-  // /** @type {db_driver["resources"]} */
-  // #_resources;
+  #config;
 
   /**
    * 
@@ -82,34 +66,35 @@ export class MongoDB {
    * env variables `MONGODB_URL` will be used for uri upon init later
    */
   constructor(config) {
-    this.#_is_ready = false;
-    this.#_config = config;
+    this.#is_ready = false;
+    this.#config = {
+      options: {
+        ignoreUndefined: true,
+        serverApi: {
+          version: ServerApiVersion.v1,
+          strict: false,
+          deprecationErrors: true,
+        }
+      },
+      ...config
+    };
   }
 
   /**
-   * 
-   * @param {App} app 
-   * 
-   * 
-   * @returns {Promise<this>}
+   * @type {db_driver["init"]}
    */
-  async init(app) {
+  init(app) {
     if(this.isReady)
       return this;
-    const c = this.#_config;
-    this.#_config = {
-      ...c, 
-      url: c?.url ?? app.platform.env.MONGODB_URL,
-      db_name: c?.db_name ?? app.platform.env.MONGODB_NAME ?? 'main'
-    }
-
-    this.#_mongo_client = await connect(
-      this.config.url,
-      this.config.options
-    );
-   
-    this.#_app = app;
+    const c = this.#config;
+    c.db_name ??= app.platform.env[MongoDB.EnvConfig.db_name];
+    c.url ??= app.platform.env[MongoDB.EnvConfig.url] ?? 'main';
 
+    if(!this.config.db_name || !this.config.url) {
+      throw new Error('MongoVectorStore::client() - missing url or db_name');
+    }
+    
+    this.#app = app;
     this.resources = {
       auth_users: auth_users(this),
       collections: collections(this),
@@ -127,7 +112,7 @@ export class MongoDB {
       search: search(this),
     }
     
-    this.#_is_ready = true; 
+    this.#is_ready = true; 
 
     return this;
   }
@@ -137,7 +122,7 @@ export class MongoDB {
     return true;
   }
 
-  get isReady() { return this.#_is_ready; }
+  get isReady() { return this.#is_ready; }
 
   throwIfNotReady() {
     if(!this.isReady)
@@ -157,7 +142,7 @@ export class MongoDB {
    * @description Get the `storecraft` app
    */
   get app() { 
-    return this.#_app; 
+    return this.#app; 
   }
 
   /**
@@ -165,7 +150,15 @@ export class MongoDB {
    * @description Get the native `mongodb` client
    */
   get mongo_client() {
-    return this.#_mongo_client;
+    if(!this.config.db_name || !this.config.url) {
+      throw new Error('MongoVectorStore::client() - missing url or db_name');
+    }
+      
+    this.#mongo_client = this.#mongo_client ?? new MongoClient(
+      this.config.url, this.config.options
+    );
+  
+    return this.#mongo_client;
   }
 
   /**
@@ -173,12 +166,12 @@ export class MongoDB {
    * @description Get the config object
    */
   get config() { 
-    return this.#_config; 
+    return this.#config; 
   }
 
   /**
    * 
-   * @template {import('@storecraft/core/api').BaseType} T
+   * @template {BaseType} T
    * 
    * 
    * @param {string} name 

package/jsconfig.json

@@ -7,6 +7,7 @@
   },
   "include": [
     "*", 
+    "vector-store/*", 
     "src/*", 
     "tests/*.js",
     "migrations/*",

package/migrate.js

@@ -22,6 +22,7 @@ export async function migrateToLatest(driver, destroy_db_upon_completion=true) {
 
   config.set(config_migrate);
 
+  // @ts-ignore
   driver.mongo_client.__db_driver = driver;
 
   const results = await up(

package/migrations/00001_seed_email_templates.js

@@ -14,6 +14,7 @@ export async function up(db, client) {
     await session.withTransaction(
       async (s) => {
         /** @type {MongoDB} */
+        // @ts-ignore
         const driver = client.__db_driver;
 
         for (const template of templates) {

package/migrations/00002_seed_email_templates.js

@@ -0,0 +1,36 @@
+import { Db, MongoClient } from 'mongodb';
+import { MongoDB } from '../index.js'
+import { templates } from '@storecraft/core/assets/seed-templates-v2.js'
+
+/**
+ * 
+ * @param {Db} db 
+ * @param {MongoClient} client 
+ */
+export async function up(db, client) {
+
+  const session = client.startSession();
+  try {
+    await session.withTransaction(
+      async (s) => {
+        /** @type {MongoDB} */
+        // @ts-ignore
+        const driver = client.__db_driver;
+
+        for (const template of templates) {
+          await driver.resources.templates.upsert(template, template.search);
+        }
+      }
+    );
+  } finally {
+    await session.endSession();
+  }
+}
+
+/**
+ * 
+ * @param {Db} db 
+ * @param {MongoClient} client 
+ */
+export async function down(db, client) {
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storecraft/database-mongodb",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "Storecraft database driver for mongodb on node / bun / deno platform",
   "license": "MIT",
   "author": "Tomer Shalev (https://github.com/store-craft)",
@@ -24,6 +24,10 @@
       "import": "./index.js",
       "types": "./types.public.d.ts"
     },
+    "./vector-store": {
+      "import": "./vector-store/index.js",
+      "types": "./vector-store/types.d.ts"
+    },
     "./*": {
       "import": "./*"
     }
@@ -37,7 +41,7 @@
   "dependencies": {
     "@storecraft/core": "^1.0.0",
     "migrate-mongo": "^11.0.0",
-    "mongodb": "^6.3.0"
+    "mongodb": "^6.14.0"
   },
   "devDependencies": {
     "@types/migrate-mongo": "^10.0.4",

package/src/con.auth_users.js

@@ -1,14 +1,17 @@
+/**
+ * @import { db_auth_users as db_col } from '@storecraft/core/database'
+ * @import { AuthUserType } from '@storecraft/core/api'
+ */
+
 import { MongoDB } from '../index.js'
 import { Collection } from 'mongodb'
-import { objid_or_else_filter, sanitize_one, to_objid_safe } from './utils.funcs.js'
+import { 
+  objid_or_else_filter, sanitize_one, to_objid_safe 
+} from './utils.funcs.js'
 import { 
   count_regular, get_regular, list_regular, upsert_regular 
 } from './con.shared.js'
 
-/**
- * @typedef {import('@storecraft/core/database').db_auth_users} db_col
- */
-
 /**
  * @param {MongoDB} d 
  * 
@@ -32,8 +35,6 @@ const upsert = (driver) => upsert_regular(driver, col(driver));
 const get = (driver) => {
   return async (id_or_email) => {
     const filter = objid_or_else_filter(id_or_email, 'email');
-
-    /** @type {import('@storecraft/core/api').AuthUserType} */
     const res = await col(driver).findOne(
       filter
     );
@@ -51,8 +52,6 @@ const get = (driver) => {
 const getByEmail = (driver) => {
   return async (email) => {
     const filter = { email: email };
-
-    /** @type {import('@storecraft/core/api').AuthUserType} */
     const res = await col(driver).findOne(
       filter
     );
@@ -100,7 +99,6 @@ const remove = (driver) => {
  */
 const removeByEmail = (driver) => {
   return async (email) => {
-    /** @type {import('@storecraft/core/api').AuthUserType} */
     await col(driver).deleteOne(
       { email }
     );

package/src/con.collections.js

@@ -1,3 +1,10 @@
+/**
+ * @import { db_collections as db_col } from '@storecraft/core/database'
+ * @import { ProductType, VariantType } from '@storecraft/core/api'
+ * @import { WithRelations } from './utils.relations.js'
+ * @import { Filter } from 'mongodb'
+ */
+
 import { Collection } from 'mongodb'
 import { MongoDB } from '../index.js'
 import { count_regular, expand, get_regular, list_regular } from './con.shared.js'
@@ -11,10 +18,6 @@ import {
   update_entry_on_all_connection_of_relation 
 } from './utils.relations.js'
 
-/**
- * @typedef {import('@storecraft/core/database').db_collections} db_col
- */
-
 
 const transactionOptions = {
   readPreference: 'primary',
@@ -26,9 +29,7 @@ const transactionOptions = {
  * @param {MongoDB} d 
  * 
  * 
- * @returns {Collection<
- *  import('./utils.relations.js').WithRelations<db_col["$type_get"]>
- * >}
+ * @returns {Collection<WithRelations<db_col["$type_get"]>>}
  */
 const col = (d) => d.collection('collections');
 
@@ -73,6 +74,7 @@ const upsert = (driver) => {
             driver, 'collections', objid, data, session
           );
 
+        // @ts-ignore
         }, transactionOptions
       );
     
@@ -136,6 +138,7 @@ const remove = (driver) => {
             driver, 'collections', objid, session
           );
 
+        // @ts-ignore
         }, transactionOptions
       );
     } catch(e) {
@@ -173,7 +176,9 @@ const count = (driver) => count_regular(driver, col(driver));
 const list_collection_products = (driver) => {
   return async (handle_or_id, query) => {
 
-    const { filter: filter_query, sort, reverse_sign } = query_to_mongo(query);
+    const { 
+      filter: filter_query, sort, reverse_sign 
+    } = query_to_mongo(query);
 
     // console.log('query', query)
     // console.log('filter', JSON.stringify(filter_query, null, 2))
@@ -181,12 +186,8 @@ const list_collection_products = (driver) => {
     // console.log('expand', query?.expand)
     
     /**
-     * @type {import('mongodb').Filter<
-     *  import('./utils.relations.js').WithRelations<
-     *    import('@storecraft/core/api').ProductType | 
-     *    import('@storecraft/core/api').VariantType
-     *  >
-     * >}
+     * @type {Filter<WithRelations<ProductType | VariantType>>
+     * }
      */
     const filter = {
       $and: [

package/src/con.customers.js

@@ -1,3 +1,10 @@
+/**
+ * @import { db_customers as db_col } from '@storecraft/core/database'
+ * @import { OrderData } from '@storecraft/core/api'
+ * @import { WithRelations } from './utils.relations.js'
+ * @import { Filter } from 'mongodb'
+ */
+
 import { Collection, ObjectId } from 'mongodb'
 import { MongoDB } from '../index.js'
 import { count_regular, get_regular, list_regular, 
@@ -5,14 +12,9 @@ import { count_regular, get_regular, list_regular,
 import { isDef, sanitize_array, to_objid } from './utils.funcs.js'
 import { query_to_mongo } from './utils.query.js';
 
-/**
- * @typedef {import('@storecraft/core/database').db_customers} db_col
- */
-
 /**
  * @param {MongoDB} d 
  * 
- * 
  * @returns {Collection<db_col["$type_get"]>}
  */
 const col = (d) => d.collection('customers');
@@ -123,13 +125,7 @@ const list_customer_orders = (driver) => {
     console.log('sort', sort)
     console.log('expand', query?.expand)
     
-    /**
-     * @type {import('mongodb').Filter<
-     *  import('./utils.relations.js').WithRelations<
-     *    import('@storecraft/core/api').OrderData
-     *  >
-     * >}
-     */
+    /** @type {Filter<WithRelations<OrderData>>} */
     const filter = {
       $and: [
         {'_relations.search': `customer:${customer_id}` },

package/src/con.discounts.js

@@ -1,3 +1,10 @@
+/**
+ * @import { db_discounts as db_col } from '@storecraft/core/database'
+ * @import { ProductType, VariantType } from '@storecraft/core/api'
+ * @import { WithRelations } from './utils.relations.js'
+ * @import { Filter } from 'mongodb'
+ */
+
 import { Collection } from 'mongodb'
 import { MongoDB } from '../index.js'
 import { 
@@ -18,11 +25,6 @@ import {
 } from './utils.relations.js'
 
 
-/**
- * @typedef {import('@storecraft/core/database').db_discounts} db_col
- */
-
-
 /**
  * @param {MongoDB} d 
  * 
@@ -208,14 +210,7 @@ const list_discount_products = (driver) => {
     // console.log('sort', sort)
     // console.log('expand', query?.expand)
     
-    /**
-     * @type {import('mongodb').Filter<
-     *  import('./utils.relations.js').WithRelations<
-     *    import('@storecraft/core/api').ProductType | 
-     *    import('@storecraft/core/api').VariantType
-     *  >
-     * >}
-     */
+    /** @type {Filter<WithRelations<ProductType | VariantType>>} */
     const filter = {
       $and: [
         { '_relations.search': `discount:${handle_or_id}` },

package/src/con.discounts.utils.js

@@ -1,12 +1,20 @@
+/**
+ * @import { 
+ *  DiscountType, FilterValue_p_in_price_range, FilterValue_p_not_in_collections, 
+ *  FilterValue_p_in_collections, FilterValue_p_not_in_tags, FilterValue_p_in_tags, 
+ *  FilterValue_p_in_products, FilterValue_p_not_in_products 
+ * } from '@storecraft/core/api'
+ */
+
 import { enums } from "@storecraft/core/api";
 import { to_objid_safe } from "./utils.funcs.js";
 
-/** @param {import("@storecraft/core/api").DiscountType} d */
+/** @param {DiscountType} d */
 const is_order_discount = d => {
   return (d.info.details.meta.id===enums.DiscountMetaEnum.order.id);
 }
 
-/** @param {import("@storecraft/core/api").DiscountType} d */
+/** @param {DiscountType} d */
 const is_automatic_discount = d => {
   return (d.application.id===enums.DiscountApplicationEnum.Auto.id);
 }
@@ -20,7 +28,7 @@ const extract_abs_number = v => {
  * for filtering.
  * 
  * 
- * @param {import("@storecraft/core/api").DiscountType} d 
+ * @param {DiscountType} d 
  */
 export const discount_to_mongo_conjunctions = d => {
   // discount has to be product discount + automatic + active + has filters
@@ -40,8 +48,9 @@ export const discount_to_mongo_conjunctions = d => {
         break;
       case enums.FilterMetaEnum.p_in_products.op:
         {
-          /** @type {import("@storecraft/core/api").FilterValue_p_in_products} */
-          const cast = filter.value ?? [];
+          const cast = /** @type {FilterValue_p_in_products} */ (
+            filter.value ?? []
+          );
           
           conjunctions.push(
             { handle: { $in: cast.map(it => it.handle) } }
@@ -50,8 +59,9 @@ export const discount_to_mongo_conjunctions = d => {
         break;
       case enums.FilterMetaEnum.p_not_in_products.op:
         {
-          /** @type {import("@storecraft/core/api").FilterValue_p_not_in_products} */
-          const cast = filter.value ?? [];
+          const cast = /** @type {FilterValue_p_not_in_products} */(
+            filter.value ?? []
+          );
           
           conjunctions.push(
             { handle: { $nin: cast.map(it => it.handle) } }
@@ -60,8 +70,9 @@ export const discount_to_mongo_conjunctions = d => {
         break;
       case enums.FilterMetaEnum.p_in_tags.op:
         {
-          /** @type {import("@storecraft/core/api").FilterValue_p_in_tags} */
-          const cast = filter.value ?? [];
+          const cast = /** @type {FilterValue_p_in_tags} */ (
+            filter.value ?? []
+          );
           
           conjunctions.push(
             { tags: { $in: cast } }
@@ -70,8 +81,9 @@ export const discount_to_mongo_conjunctions = d => {
         break;
       case enums.FilterMetaEnum.p_not_in_tags.op:
         {
-          /** @type {import("@storecraft/core/api").FilterValue_p_not_in_tags} */
-          const cast = filter.value ?? [];
+          const cast = /** @type {FilterValue_p_not_in_tags} */(
+            filter.value ?? []
+          );
 
           conjunctions.push(
             { tags: { $nin: cast } }
@@ -80,8 +92,9 @@ export const discount_to_mongo_conjunctions = d => {
         break;
       case enums.FilterMetaEnum.p_in_collections.op:
         {
-          /** @type {import("@storecraft/core/api").FilterValue_p_in_collections} */
-          const cast = filter.value ?? [];
+          const cast = /** @type {FilterValue_p_in_collections} */ (
+            filter.value ?? []
+          );
 
           conjunctions.push(
             { 
@@ -94,8 +107,9 @@ export const discount_to_mongo_conjunctions = d => {
         break;
       case enums.FilterMetaEnum.p_not_in_collections.op:
         {
-          /** @type {import("@storecraft/core/api").FilterValue_p_not_in_collections} */
-          const cast = filter.value ?? [];
+          const cast = /** @type {FilterValue_p_not_in_collections} */ (
+            filter.value ?? []
+          );
 
           conjunctions.push(
             { 
@@ -108,12 +122,13 @@ export const discount_to_mongo_conjunctions = d => {
         break;
       case enums.FilterMetaEnum.p_in_price_range.op:
         {
-          /** @type {import("@storecraft/core/api").FilterValue_p_in_price_range} */
-          const cast = {
-            from: 0,
-            to: Number.POSITIVE_INFINITY,
-            ...(filter?.value ?? {})
-          };
+          const cast = /** @type {FilterValue_p_in_price_range} */ (
+            {
+              from: 0,
+              to: Number.POSITIVE_INFINITY,
+              ...(filter?.value ?? {})
+            }
+          );
 
           const from = extract_abs_number(cast.from);
           const to = extract_abs_number(cast.to);

package/src/con.images.js

@@ -1,3 +1,9 @@
+/**
+ * @import { db_images as db_col } from '@storecraft/core/database'
+ * @import { ImageType } from '@storecraft/core/api'
+ * @import { Filter, AnyBulkWriteOperation } from 'mongodb'
+ */
+
 import { Collection } from 'mongodb'
 import { MongoDB } from '../index.js'
 import { count_regular, get_regular, list_regular, 
@@ -9,9 +15,6 @@ import {
   image_url_to_handle, image_url_to_name 
 } from '@storecraft/core/api/con.images.logic.js';
 
-/**
- * @typedef {import('@storecraft/core/database').db_images} db_col
- */
 
 /**
  * @param {MongoDB} d @returns {Collection<db_col["$type_get"]>}
@@ -105,9 +108,7 @@ export const report_document_media = (driver) => {
      * @param {string} url 
      * 
      * 
-     * @returns {import('mongodb').AnyBulkWriteOperation<
-     *  import('@storecraft/core/api').ImageType>
-     * }
+     * @returns {AnyBulkWriteOperation<ImageType>}
      */
     const url_to_update = url => {
       const id_on_insert = ID('img');

package/src/con.notifications.js

@@ -1,3 +1,7 @@
+/**
+ * @import { db_notifications as db_col } from '@storecraft/core/database'
+ */
+
 import { Collection } from 'mongodb'
 import { MongoDB } from '../index.js'
 import { count_regular, get_regular, list_regular, 
@@ -6,10 +10,6 @@ import { to_objid } from './utils.funcs.js';
 import { add_search_terms_relation_on } from './utils.relations.js';
 import { union } from '@storecraft/core/api/utils.func.js';
 
-/**
- * @typedef {import('@storecraft/core/database').db_notifications} db_col
- */
-
 /**
  * @param {MongoDB} d 
  * 
@@ -42,6 +42,7 @@ const upsertBulk = (driver) => {
     items = items.map(item => ({...item}));
     items.forEach(
       (item, ix) => {
+        // @ts-ignore
         item._id = to_objid(item.id);
         
         add_search_terms_relation_on(

package/src/con.orders.js

@@ -1,12 +1,12 @@
+/**
+ * @import { db_orders as db_col } from '@storecraft/core/database'
+ */
+
 import { Collection } from 'mongodb'
 import { MongoDB } from '../index.js'
 import { count_regular, get_regular, list_regular, 
   remove_regular, upsert_regular } from './con.shared.js'
 
-/**
- * @typedef {import('@storecraft/core/database').db_orders} db_col
- */
-
 /**
  * @param {MongoDB} d 
  *