@storecraft/database-mongodb 1.0.20 → 1.2.5

package/src/con.images.js

@@ -1,13 +1,14 @@
 /**
  * @import { db_images as db_col } from '@storecraft/core/database'
  * @import { ImageType } from '@storecraft/core/api'
- * @import { Filter, AnyBulkWriteOperation } from 'mongodb'
+ * @import { AnyBulkWriteOperation } from 'mongodb'
  */
-
 import { Collection } from 'mongodb'
 import { MongoDB } from '../index.js'
-import { count_regular, get_regular, list_regular, 
-  upsert_regular } from './con.shared.js'
+import { 
+  count_regular, get_regular, list_regular, 
+  upsert_regular 
+} from './con.shared.js'
 import { handle_or_id, to_objid } from './utils.funcs.js';
 import { func } from '@storecraft/core/api';
 import { ID } from '@storecraft/core/api/utils.func.js';
@@ -34,8 +35,6 @@ const get = (driver) => get_regular(driver, col(driver));
 
 /**
  * @param {MongoDB} driver 
- * 
- * 
  * @returns {db_col["remove"]}
  */
 const remove = (driver) => {
@@ -85,12 +84,8 @@ const remove = (driver) => {
 }
 
 /**
- * report media usages
- * 
- * 
+ * @description report media usages
  * @param {MongoDB} driver 
- * 
- * 
  * @returns {db_col["report_document_media"]}
  */
 export const report_document_media = (driver) => {
@@ -99,15 +94,14 @@ export const report_document_media = (driver) => {
       return;
 
     const add_to_search_index = func.union(
-      data['title'], func.to_tokens(data['title'])
+      data['title'], 
+      func.to_tokens(data['title'])
     );
 
     const dates = func.apply_dates({});
     
     /** 
      * @param {string} url 
-     * 
-     * 
      * @returns {AnyBulkWriteOperation<ImageType>}
      */
     const url_to_update = url => {
@@ -156,10 +150,8 @@ const count = (driver) => count_regular(driver, col(driver));
 
 /** 
  * @param {MongoDB} driver
- * 
- * 
  * @return {db_col & { _col: ReturnType<col>}}
- * */
+ */
 export const impl = (driver) => {
 
   return {

package/src/con.notifications.js

@@ -1,26 +1,24 @@
 /**
  * @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, 
-  remove_regular, upsert_regular } from './con.shared.js'
+import { 
+  count_regular, get_regular, list_regular, 
+  remove_regular, 
+} from './con.shared.js'
 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';
 
 /**
  * @param {MongoDB} d 
- * 
- * 
  * @returns {Collection<db_col["$type_get"]>}
  */
 const col = (d) => d.collection('notifications');
 
 /**
  * @param {MongoDB} driver 
- * 
  * @returns {db_col["upsert"]}
  */
 const upsert = (driver) => {
@@ -29,11 +27,8 @@ const upsert = (driver) => {
   }
 }
 
-
 /**
  * @param {MongoDB} driver 
- * 
- * 
  * @returns {db_col["upsertBulk"]}
  */
 const upsertBulk = (driver) => {
@@ -84,8 +79,6 @@ const count = (driver) => count_regular(driver, col(driver));
 
 /** 
  * @param {MongoDB} driver
- * 
- * 
  * @return {db_col & { _col: ReturnType<col>}}
  */
 export const impl = (driver) => {

package/src/con.orders.js

@@ -1,16 +1,15 @@
 /**
  * @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'
+import { 
+  count_regular, get_regular, list_regular, 
+  remove_regular, upsert_regular 
+} from './con.shared.js'
 
 /**
  * @param {MongoDB} d 
- * 
- * 
  * @returns {Collection<db_col["$type_get"]>}
  */
 const col = (d) => d.collection('orders');
@@ -44,8 +43,6 @@ const count = (driver) => count_regular(driver, col(driver));
 
 /** 
  * @param {MongoDB} driver
- * 
- * 
  * @return {db_col & { _col: ReturnType<col>}}
  */
 export const impl = (driver) => {

package/src/con.posts.js

@@ -2,7 +2,6 @@
  * @import { db_posts as db_col } from '@storecraft/core/database'
  * @import { WithRelations } from './utils.types.js'
  */
-
 import { Collection } from 'mongodb'
 import { MongoDB } from '../index.js'
 import { count_regular, get_regular, list_regular } from './con.shared.js'
@@ -14,23 +13,14 @@ import {
   update_entry_on_all_connection_of_relation 
 } from './utils.relations.js';
 
-
-/**
- * @typedef {import('@storecraft/core/database').db_posts} db_col
- */
-
 /**
  * @param {MongoDB} d 
- * 
- * 
  * @returns {Collection<WithRelations<db_col["$type_get"]>>}
  */
 const col = (d) => d.collection('posts');
 
 /**
  * @param {MongoDB} driver 
- * 
- * 
  * @returns {db_col["upsert"]}
  */
 const upsert = (driver) => {
@@ -49,7 +39,6 @@ const upsert = (driver) => {
           ////
           // STOREFRONTS --> POSTS RELATION
           ////
-
           await update_entry_on_all_connection_of_relation(
             driver, 'storefronts', 'posts', objid, data, session
           );
@@ -82,8 +71,6 @@ const get = (driver) => get_regular(driver, col(driver));
 
 /**
  * @param {MongoDB} driver 
- * 
- * 
  * @returns {db_col["remove"]}
  */
 const remove = (driver) => {
@@ -137,8 +124,6 @@ const count = (driver) => count_regular(driver, col(driver));
 
 /** 
  * @param {MongoDB} driver
- * 
- * 
  * @return {db_col & { _col: ReturnType<col>}}
  */
 export const impl = (driver) => {

package/src/con.products.js

@@ -2,9 +2,8 @@
  * @import { db_products as db_col, RegularGetOptions } from '@storecraft/core/database'
  * @import { ProductType, VariantType } from '@storecraft/core/api'
  * @import { WithRelations } from './utils.types.js'
- * @import { Filter, AnyBulkWriteOperation } from 'mongodb'
+ * @import { AnyBulkWriteOperation } from 'mongodb'
  */
-
 import { Collection } from 'mongodb'
 import { MongoDB } from '../index.js'
 import { 
@@ -38,16 +37,12 @@ import {
 
 /**
  * @param {MongoDB} d 
- * 
- * 
  * @returns {Collection<WithRelations<db_col["$type_get"]>>}
  */
 const col = (d) => d.collection('products');
 
 /**
  * @param {MongoDB} driver 
- * 
- * 
  * @returns {db_col["upsert"]}
  */
 const upsert = (driver) => {
@@ -206,15 +201,12 @@ const upsert = (driver) => {
  
 
 /**
- * 
  * @param {MongoDB} driver 
  */
 const get = (driver) => get_regular(driver, col(driver));
 
 /**
  * @param {MongoDB} driver 
- * 
- * 
  * @returns {db_col["remove"]}
  */
 const remove = (driver) => {

package/src/con.search.js

@@ -2,11 +2,9 @@
  * @import { search as db_col, db_driver } from '@storecraft/core/database'
  * @import { QuickSearchResource, QuickSearchResult } from '@storecraft/core/api'
  */
-
 import { MongoDB } from '../index.js'
 import { query_to_mongo } from './utils.query.js';
 
-
 /**
  * @type {(keyof db_driver["resources"])[]}
  */
@@ -22,7 +20,8 @@ const tables = [
   'notifications',
   'discounts',
   'orders',
-  'templates'
+  'templates',
+  'chats'
 ]
 
 /**
@@ -42,13 +41,27 @@ const prefix_to_resource = {
   'tag': 'tags',
   'template': 'templates',
   'post': 'posts',
-  
+  'chat': 'chats',
+}
+
+const resource_to_props = {
+  'auth_users': ['id', 'handle'],
+  'collections': ['id', 'handle'],
+  'customers': ['id', 'handle'],
+  'discounts': ['id', 'handle', 'title'],
+  'images': ['id', 'handle', 'name'],
+  'orders': ['id'],
+  'products': ['id', 'handle', 'title'],
+  'shipping_methods': ['id', 'handle', 'title'],
+  'storefronts': ['id', 'handle', 'title'],
+  'tags': ['id', 'handle'],
+  'templates': ['id', 'handle', 'title'],
+  'posts': ['id', 'handle', 'title'],
+  'chats': ['id', 'customer_email', 'customer_id'],
 }
 
 /**
- * 
  * @param {string} id 
- * 
  * @returns {keyof db_driver["resources"]}
  */
 export const id_to_resource = id => {
@@ -65,8 +78,6 @@ export const id_to_resource = id => {
 
 /**
  * @param {MongoDB} driver 
- * 
- * 
  * @returns {db_col["quicksearch"]}
  */
 export const quicksearch = (driver) => {
@@ -93,10 +104,15 @@ export const quicksearch = (driver) => {
       },
       {
         $project: { 
-          title: 1,
-          handle: 1,
-          // '_relations.search': 1,
           id: 1,
+          handle: 1,
+
+          title: 1,
+          name: 1,
+
+          customer_email: 1,
+          customer_id: 1,
+
           _id: 0
         }
       }
@@ -151,10 +167,8 @@ export const quicksearch = (driver) => {
 
 /** 
  * @param {MongoDB} driver
- * 
- * 
  * @return {db_col}
- * */
+ */
 export const impl = (driver) => {
 
   return {

package/src/con.shared.js

@@ -1,27 +1,28 @@
 /**
- * @import { db_crud, RegularGetOptions } from '@storecraft/core/database'
- * @import { ApiQuery, BaseType, Cursor, ExpandQuery, QuickSearchResource, QuickSearchResult, Tuple, withOptionalID } from '@storecraft/core/api'
- * @import { VQL } from '@storecraft/core/vql'
+ * @import { db_crud, withConcreteId, withConcreteIdAndHandle } from '@storecraft/core/database'
+ * @import { 
+ *  BaseType, ExpandQuery, withOptionalID 
+ * } from '@storecraft/core/api'
  * @import { WithRelations } from './utils.types.js'
  * @import { WithId } from 'mongodb'
  */
-
 import { Collection } from 'mongodb'
 import { MongoDB } from '../index.js'
-import { handle_or_id, isUndef, sanitize_array, 
-  sanitize_one, to_objid } from './utils.funcs.js'
+import { 
+  handle_or_id, isUndef, sanitize_array, 
+  sanitize_one, to_objid 
+} from './utils.funcs.js'
 import { query_to_mongo } from './utils.query.js'
 import { report_document_media } from './con.images.js'
 import { add_search_terms_relation_on } from './utils.relations.js'
 
 
 /**
- * @template {BaseType} T
- * @template {BaseType} G
- * 
+ * @description Upsert function for MongoDB
+ * @template {Partial<withConcreteIdAndHandle<{}>>} T
+ * @template {Partial<withConcreteIdAndHandle<{}>>} G
  * @param {MongoDB} driver 
  * @param {Collection<G>} col 
- * 
  * @returns {db_crud<T, G>["upsert"]}
  */
 export const upsert_regular = (driver, col) => {
@@ -72,20 +73,6 @@ export const upsert_regular = (driver, col) => {
 
           );
 
-          // const res = await col.replaceOne(
-          //   // @ts-ignore
-          //   { 
-          //     $or: [
-          //       data.id && { _id: to_objid(data.id) },
-          //       data.handle && { handle: data.handle }
-          //     ].filter(Boolean)
-          //   }, 
-          //   data,
-          //   { 
-          //     session, upsert: true 
-          //   }
-          // );
-
           ////
           // REPORT IMAGES USAGE
           ////
@@ -105,7 +92,7 @@ export const upsert_regular = (driver, col) => {
 }
 
 /**
- * Extract relations names from item
+ * @description Extract relations names from item
  * @template {WithRelations<{}>} T
  * @param {T} item
  */
@@ -114,10 +101,8 @@ export const get_relations_names = item => {
 }
 
 /**
- * Expand relations in-place
- * 
+ * @description Expand relations in-place
  * @template {any} T
- * 
  * @param {WithRelations<T>[]} items
  * @param {ExpandQuery<T>} [expand_query] 
  */
@@ -224,7 +209,7 @@ export const get_regular = (driver, col) => {
 }
 
 /**
- * get bulk of items, ordered, if something is missing, `undefined`
+ * @description get bulk of items, ordered, if something is missing, `undefined`
  * should be instead
  * @template {withOptionalID} T
  * @template {withOptionalID} G
@@ -234,11 +219,10 @@ export const get_regular = (driver, col) => {
  */
 export const get_bulk = (driver, col) => {
   return async (ids, options) => {
-    const objids = ids.map(handle_or_id)
-                      .map(v => ('_id' in v) ? v._id : undefined)
-                      .filter(Boolean);
-
-
+    const objids = ids
+    .map(handle_or_id)
+    .map(v => ('_id' in v) ? v._id : undefined)
+    .filter(Boolean);
 
     const res = /** @type {(WithRelations<WithId<G>>)[]} */ (
       await col.find(
@@ -264,7 +248,6 @@ export const get_bulk = (driver, col) => {
       )
     );
     
-    
     const sanitized = /** @type {G[]} */(
       /** @type {unknown} */(
         sanitize_array(res)
@@ -273,7 +256,9 @@ export const get_bulk = (driver, col) => {
 
     // now let's order them
     return ids.map(
-      id => sanitized.find(s => s.id===id || s?.['handle']===id)
+      id => sanitized.find(
+        s => s.id===id || s?.['handle']===id
+      )
     );
     
   }
@@ -282,12 +267,8 @@ export const get_bulk = (driver, col) => {
 
 /**
  * @template T, G
- * 
- * 
  * @param {MongoDB} driver 
  * @param {Collection<G>} col 
- * 
- * 
  * @returns {db_crud<T, G>["remove"]}
  */
 export const remove_regular = (driver, col) => {
@@ -321,7 +302,8 @@ export const list_regular = (driver, col) => {
 
     /** @type {WithRelations<WithId<G>>[]} */
     const items = await col.find(
-      filter,  {
+      filter, 
+      {
         sort, 
         limit: reverse_sign==-1 ? query.limitToLast : query.limit,
         projection: expand_to_mongo_projection(query?.expand)
@@ -349,12 +331,8 @@ export const list_regular = (driver, col) => {
 /**
  * @template {any} T
  * @template {any} G
- * 
- * 
  * @param {MongoDB} driver 
  * @param {Collection<G>} col 
- * 
- * 
  * @returns {db_crud<T, G>["count"]}
  */
 export const count_regular = (driver, col) => {

package/src/con.shipping.js

@@ -2,7 +2,6 @@
  * @import { db_shipping as db_col } from '@storecraft/core/database'
  * @import { WithRelations } from './utils.types.js'
  */
-
 import { Collection } from 'mongodb'
 import { MongoDB } from '../index.js'
 import { count_regular, get_regular, list_regular } from './con.shared.js'
@@ -22,8 +21,6 @@ const col = (d) => d.collection('shipping_methods');
 
 /**
  * @param {MongoDB} driver 
- * 
- * 
  * @returns {db_col["upsert"]}
  */
 const upsert = (driver) => {
@@ -79,8 +76,6 @@ const get = (driver) => get_regular(driver, col(driver));
 
 /**
  * @param {MongoDB} driver 
- * 
- * 
  * @returns {db_col["remove"]}
  */
 const remove = (driver) => {
@@ -136,8 +131,6 @@ const count = (driver) => count_regular(driver, col(driver));
 
 /** 
  * @param {MongoDB} driver
- * 
- * 
  * @return {db_col & { _col: ReturnType<col>}}
  */
 export const impl = (driver) => {

package/src/con.storefronts.js

@@ -5,12 +5,13 @@
  * @import { StorefrontType } from '@storecraft/core/api'
  * @import { WithRelations } from './utils.types.js'
  */
-
 import { Collection } from 'mongodb'
 import { MongoDB } from '../index.js'
-import { count_regular, expand, get_regular, list_regular, 
-  remove_regular } from './con.shared.js'
-import { sanitize_array, sanitize_recursively, to_objid } from './utils.funcs.js'
+import { 
+  count_regular, expand, get_regular, list_regular, 
+  remove_regular 
+} from './con.shared.js'
+import { sanitize_recursively, to_objid } from './utils.funcs.js'
 import { 
   add_search_terms_relation_on, create_explicit_relation, save_me 
 } from './utils.relations.js';
@@ -24,8 +25,6 @@ const col = (d) => d.collection('storefronts');
 
 /**
  * @param {MongoDB} driver 
- * 
- * 
  * @return {db_col["upsert"]}
  */
 const upsert = (driver) => {
@@ -223,10 +222,8 @@ const get_default_auto_generated_storefront = (driver) => {
 
 /** 
  * @param {MongoDB} driver
- * 
- * 
  * @return {db_col & { _col: ReturnType<col>}}
- * */
+ */
 export const impl = (driver) => {
 
   return {

package/src/con.tags.js

@@ -1,23 +1,21 @@
 /**
  * @import { db_tags 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'
+import { Collection } from 'mongodb';
+import { MongoDB } from '../index.js';
+import { 
+  count_regular, get_regular, list_regular, 
+  remove_regular, upsert_regular 
+} from './con.shared.js';
 
 /**
  * @param {MongoDB} d 
- * 
- * 
  * @returns {Collection<db_col["$type_get"]>}
  */
 const col = (d) => d.collection('tags');
 
 /**
  * @param {MongoDB} driver 
- * 
  * @returns {db_col["upsert"]}
  */
 const upsert = (driver) => upsert_regular(driver, col(driver));
@@ -44,10 +42,8 @@ const count = (driver) => count_regular(driver, col(driver));
 
 /** 
  * @param {MongoDB} driver
- * 
- * 
  * @return {db_col & { _col: ReturnType<col>}}
- * */
+ */
 export const impl = (driver) => {
 
   return {

package/src/con.templates.js

@@ -1,23 +1,21 @@
 /**
  * @import { db_templates 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'
+import { 
+  count_regular, get_regular, list_regular, 
+  remove_regular, upsert_regular 
+} from './con.shared.js'
 
 /**
  * @param {MongoDB} d 
- * 
- * 
  * @returns {Collection<db_col["$type_get"]>}
  */
 const col = (d) => d.collection('templates');
 
 /**
  * @param {MongoDB} driver 
- * 
  * @returns {db_col["upsert"]}
  */
 const upsert = (driver) => upsert_regular(driver, col(driver));
@@ -44,8 +42,6 @@ const count = (driver) => count_regular(driver, col(driver));
 
 /** 
  * @param {MongoDB} driver
- * 
- * 
  * @return {db_col & { _col: ReturnType<col>}}
  * */
 export const impl = (driver) => {