Module factory

core/lib/module.ts → core/lib/module/index.ts

@@ -1,42 +1,24 @@
-import { Module, Store } from 'vuex'
+import { Module } from 'vuex'
 import { RouteConfig, NavigationGuard } from 'vue-router'
-import Vue, { VueConstructor } from 'vue'
+import Vue from 'vue'
 import merge from 'lodash-es/merge'
 import some from 'lodash-es/some'
 import find from 'lodash-es/find'
-import RootState from '@vue-storefront/core/types/RootState'
 import rootStore from '@vue-storefront/store'
 import { Logger } from '@vue-storefront/core/lib/logger'
-import { setupMultistoreRoutes } from './multistore'
+import { setupMultistoreRoutes } from '..//multistore'
 import { router } from '@vue-storefront/core/app'
 import { isServer } from '@vue-storefront/core/helpers'
-
-export interface VSF {
-  Vue?: VueConstructor, 
-  config?: Object, 
-  store?: Store<RootState>, 
-  isServer?: boolean
-}
-
-export interface VueStorefrontModuleConfig {
-  key: string;
-  store?: { modules?: { key: string, module: Module<any, any> }[], plugin?: Function };
-  router?: { routes?: RouteConfig[], beforeEach?: NavigationGuard, afterEach?: NavigationGuard },
-  beforeRegistration?: (VSF: VSF | VueConstructor, config?: Object, store?: Store<RootState>, isServer?: boolean) => void,
-  afterRegistration?: (VSF: VSF | VueConstructor, config?: Object, store?: Store<RootState>, isServer?: boolean) => void,
-}
+import { VSF, VueStorefrontModuleConfig } from './types'
 
 const moduleExtendings: VueStorefrontModuleConfig[] = []
+const registeredModules: VueStorefrontModuleConfig[] = []
 
-/** Provide `VueStorefrontModule` config that will be merged with module with the same `key` as this config.
- * It's important to call this function before module is registered.
- *
- * Read more: [here](https://docs.vuestorefront.io/guide/modules/introduction.html#extending-and-overriding-vue-storefront-modules) */
-export function extendModule(moduleConfig: VueStorefrontModuleConfig) {
+function extendModule(moduleConfig: VueStorefrontModuleConfig) {
   moduleExtendings.push(moduleConfig)
 }
 
-export class VueStorefrontModule {
+class VueStorefrontModule {
   private _isRegistered = false
   constructor (
     private _c: VueStorefrontModuleConfig,
@@ -51,16 +33,15 @@ export class VueStorefrontModule {
     this._c = config
   }
 
-  private static _registeredModules: VueStorefrontModuleConfig[] = []
 
   private static _doesStoreAlreadyExists (key: string) : boolean {
-    let moduleExists = false
-    VueStorefrontModule._registeredModules.forEach(m => {
+    let storeExists = false
+    registeredModules.forEach(m => {
       if (m.store) {
-        if (m.store.modules.some(m => m.key === key)) moduleExists = true
+        if (m.store.modules.some(m => m.key === key)) storeExists = true
       }
     })
-    return moduleExists
+    return storeExists
   }
 
   private static _extendStore (storeInstance: any, modules: { key: string, module: Module<any, any> }[], plugin: any) : void {
@@ -77,7 +58,7 @@ export class VueStorefrontModule {
     if (afterEach) routerInstance.afterEach(afterEach)
   }
 
-  private _extend (extendedConfig: VueStorefrontModuleConfig) {
+  private _extendModule (extendedConfig: VueStorefrontModuleConfig) : void {
     const mergedStore = { modules: [] };
     const key = this._c.key
     const originalStore = this._c.store
@@ -104,8 +85,7 @@ export class VueStorefrontModule {
   }
 
   public register (): VueStorefrontModuleConfig | void {
-
-    const VSF = {
+    const VSF: VSF = {
       Vue, 
       config: rootStore.state.config, 
       store: rootStore, 
@@ -114,19 +94,19 @@ export class VueStorefrontModule {
 
     if (!this._isRegistered) {
       moduleExtendings.forEach(extending => {
-        if (extending.key === this._c.key) this._extend(extending)
+        if (extending.key === this._c.key) this._extendModule(extending)
       })
 
-      let isUnique = true
+      let areStoresUnique = true
       if ( this._c.store) {
         this._c.store.modules.forEach(store => {
           if (VueStorefrontModule._doesStoreAlreadyExists(store.key)) {
             Logger.warn('Error during "' + this._c.key + '" module registration! Store with key "' + store.key + '" already exists!', 'module')()
-            isUnique = false
+            areStoresUnique = false
           }
         })
       }
-      if (isUnique) {
+      if (areStoresUnique) {
         if (this._c.beforeRegistration) {
           if (this._c.beforeRegistration.length === 1 ) { 
             this._c.beforeRegistration(VSF) 
@@ -137,7 +117,7 @@ export class VueStorefrontModule {
         }
         if (this._c.store) VueStorefrontModule._extendStore(rootStore, this._c.store.modules, this._c.store.plugin)
         if (this._c.router) VueStorefrontModule._extendRouter(router, this._c.router.routes, this._c.router.beforeEach, this._c.router.afterEach)
-        VueStorefrontModule._registeredModules.push(this._c)
+        registeredModules.push(this._c)
         this._isRegistered = true
         if (this._c.afterRegistration) {
           if (this._c.afterRegistration.length === 1 ) {
@@ -153,12 +133,29 @@ export class VueStorefrontModule {
   }
 }
 
-export function registerModules (modules: VueStorefrontModule[], context): void {
-  let registeredModules = []
-  modules.forEach(m => registeredModules.push(m.register()))
+function registerModules (modules: VueStorefrontModule[], context): void {
+  modules.forEach(m => m.register())
   Logger.info('VS Modules registration finished.', 'module', {
       succesfulyRegistered: registeredModules.length + ' / ' + modules.length,
       registrationOrder: registeredModules
     }
   )()
 }
+
+function isModuleRegistered(key: string) : boolean {
+  return registeredModules.find(m => m.key === key) ? true : false
+}
+
+function createModule(config: VueStorefrontModuleConfig) : VueStorefrontModule {
+  return new VueStorefrontModule(config)
+}
+
+export {
+  VSF,
+  VueStorefrontModuleConfig,
+  extendModule,
+  VueStorefrontModule,
+  registerModules,
+  isModuleRegistered,
+  createModule
+}

core/lib/module/types.ts

@@ -0,0 +1,24 @@
+import { Module, Store } from 'vuex'
+import { RouteConfig, NavigationGuard } from 'vue-router'
+import { VueConstructor } from 'vue'
+import RootState from '@vue-storefront/core/types/RootState'
+
+interface VSF {
+  Vue?: VueConstructor, 
+  config?: Object, 
+  store?: Store<RootState>, 
+  isServer?: boolean
+}
+
+interface VueStorefrontModuleConfig {
+  key: string;
+  store?: { modules?: { key: string, module: Module<any, any> }[], plugin?: Function };
+  router?: { routes?: RouteConfig[], beforeEach?: NavigationGuard, afterEach?: NavigationGuard },
+  beforeRegistration?: (VSF: VSF | VueConstructor, config?: Object, store?: Store<RootState>, isServer?: boolean) => void,
+  afterRegistration?: (VSF: VSF | VueConstructor, config?: Object, store?: Store<RootState>, isServer?: boolean) => void,
+}
+
+export {
+  VSF,
+  VueStorefrontModuleConfig
+}

core/modules/breadcrumbs/index.ts

@@ -1,13 +1,10 @@
 import { module } from './store'
-import { VueStorefrontModule, VueStorefrontModuleConfig } from '@vue-storefront/core/lib/module'
+import { createModule } from '@vue-storefront/core/lib/module'
 
 export const KEY = 'breadcrumbs'
-
-const moduleConfig: VueStorefrontModuleConfig = {
+export const Breadcrumbs = createModule({
   key: KEY,
   store: { modules: [
     { key: KEY, module: module }
   ] },
-}
-
-export const Breadcrumbs = new VueStorefrontModule(moduleConfig)
+})

core/modules/cart/index.ts

@@ -1,15 +1,12 @@
 import { module } from './store'
-import { VueStorefrontModule, VueStorefrontModuleConfig } from '@vue-storefront/core/lib/module'
+import { createModule } from '@vue-storefront/core/lib/module'
 import { beforeRegistration } from './hooks/beforeRegistration'
 import { afterRegistration } from './hooks/afterRegistration'
 
 export const KEY = 'cart'
-
-const moduleConfig: VueStorefrontModuleConfig = {
+export const Cart = createModule({
   key: KEY,
   store: { modules: [{ key: KEY, module }] },
   beforeRegistration,
   afterRegistration
-}
-
-export const Cart = new VueStorefrontModule(moduleConfig)
+})

core/modules/catalog/index.ts

@@ -3,12 +3,11 @@ import { attributeModule } from './store/attribute'
 import { stockModule } from './store/stock'
 import { taxModule } from './store/tax'
 import { categoryModule } from './store/category'
-import { VueStorefrontModule, VueStorefrontModuleConfig } from '@vue-storefront/core/lib/module'
+import { createModule } from '@vue-storefront/core/lib/module'
 import { beforeRegistration } from './hooks/beforeRegistration'
 
 export const KEY = 'catalog'
-
-const moduleConfig: VueStorefrontModuleConfig = {
+export const Catalog = createModule({
   key: KEY,
   store: { modules: [
     { key: 'product', module: productModule },
@@ -18,6 +17,4 @@ const moduleConfig: VueStorefrontModuleConfig = {
     { key: 'category', module: categoryModule }
   ] },
   beforeRegistration
-}
-
-export const Catalog = new VueStorefrontModule(moduleConfig)
+})

core/modules/checkout/index.ts

@@ -3,12 +3,10 @@ import { paymentModule } from './store/payment'
 import { shippingModule } from './store/shipping'
 import { beforeRegistration } from './hooks/beforeRegistration'
 import { afterRegistration } from './hooks/afterRegistration'
-
-import { VueStorefrontModule, VueStorefrontModuleConfig } from '@vue-storefront/core/lib/module'
+import { createModule } from '@vue-storefront/core/lib/module'
 
 export const KEY = 'checkout'
-
-const moduleConfig: VueStorefrontModuleConfig = {
+export const Checkout = createModule({
   key: KEY,
   store: { modules: [
     { key: 'shipping', module: shippingModule },
@@ -17,6 +15,4 @@ const moduleConfig: VueStorefrontModuleConfig = {
   ] },
   beforeRegistration,
   afterRegistration
-}
-
-export const Checkout = new VueStorefrontModule(moduleConfig)
+})

core/modules/cms/index.ts

@@ -1,22 +1,19 @@
 import { cmsPageModule } from './store/page'
 import { cmsBlockModule } from './store/block'
 import { cmsHierarchyModule } from './store/hierarchy'
-import { VueStorefrontModule, VueStorefrontModuleConfig } from '@vue-storefront/core/lib/module'
+import { createModule } from '@vue-storefront/core/lib/module'
 import { beforeRegistration } from './hooks/beforeRegistration'
 import { plugin } from './store/plugin'
 import { initCacheStorage } from '@vue-storefront/core/helpers/initCacheStorage';
 
 export const KEY = 'cms'
 export const cacheStorage = initCacheStorage(KEY)
-
-const moduleConfig: VueStorefrontModuleConfig = {
+export const Cms = createModule({
   key: KEY,
   store: { modules: [
     { key: 'cmsPage', module: cmsPageModule },
     { key: 'cmsBlock', module: cmsBlockModule },
     { key: 'cmsHierarchy', module: cmsHierarchyModule }
   ], plugin },
   beforeRegistration
-}
-
-export const Cms = new VueStorefrontModule(moduleConfig)
+})

core/modules/compare/index.ts

@@ -1,19 +1,15 @@
 import { module } from './store'
-import { VueStorefrontModule, VueStorefrontModuleConfig } from '@vue-storefront/core/lib/module'
+import { createModule } from '@vue-storefront/core/lib/module'
 import { beforeRegistration } from './hooks/beforeRegistration'
 import { afterRegistration } from './hooks/afterRegistration'
 import { initCacheStorage } from '@vue-storefront/core/helpers/initCacheStorage';
 import { plugin } from './store/plugin'
 
 export const KEY = 'compare'
-
 export const cacheStorage = initCacheStorage(KEY)
-
-const moduleConfig: VueStorefrontModuleConfig = {
+export const Compare = createModule({
   key: KEY,
   store: { modules: [{ key: KEY, module }], plugin },
   beforeRegistration,
   afterRegistration
-}
-
-export const Compare = new VueStorefrontModule(moduleConfig)
+})

core/modules/mailer/index.ts

@@ -1,11 +1,8 @@
 import { module } from './store'
-import { VueStorefrontModule, VueStorefrontModuleConfig } from '@vue-storefront/core/lib/module'
+import { createModule } from '@vue-storefront/core/lib/module'
 
 export const KEY = 'mailer'
-
-const moduleConfig: VueStorefrontModuleConfig = {
+export const Mailer = createModule({
   key: KEY,
   store: { modules: [{ key: KEY, module }] },
-}
-
-export const Mailer = new VueStorefrontModule(moduleConfig)
+})

core/modules/notification/index.ts

@@ -1,11 +1,8 @@
 import { module } from './store'
-import { VueStorefrontModule, VueStorefrontModuleConfig } from '@vue-storefront/core/lib/module'
+import { createModule } from '@vue-storefront/core/lib/module'
 
 export const KEY = 'notification'
-
-const moduleConfig: VueStorefrontModuleConfig = {
+export const Notification = createModule({
   key: KEY,
   store: { modules: [{ key: KEY, module }] },
-}
-
-export const Notification = new VueStorefrontModule(moduleConfig)
+})

core/modules/order/index.ts

@@ -1,13 +1,10 @@
-import { VueStorefrontModuleConfig, VueStorefrontModule } from '@vue-storefront/core/lib/module'
+import { createModule } from '@vue-storefront/core/lib/module'
 import { module } from './store'
 import { beforeRegistration } from './hooks/beforeRegistration'
 
 export const KEY = 'order'
-
-const moduleConfig: VueStorefrontModuleConfig = {
+export const Order = createModule({
   key: KEY,
   store: { modules: [{ key: KEY, module }] },
   beforeRegistration
-}
-
-export const Order = new VueStorefrontModule(moduleConfig)
+})

core/modules/recently-viewed/index.ts

@@ -1,16 +1,13 @@
 import { module } from './store'
 import { plugin } from './store/plugin'
-import { VueStorefrontModule, VueStorefrontModuleConfig } from '@vue-storefront/core/lib/module'
+import { createModule } from '@vue-storefront/core/lib/module'
 import { initCacheStorage } from '@vue-storefront/core/helpers/initCacheStorage'
 import { afterRegistration } from './hooks/afterRegistration'
 
 export const KEY = 'recently-viewed'
 export const cacheStorage = initCacheStorage(KEY)
-
-const moduleConfig: VueStorefrontModuleConfig = {
+export const RecentlyViewed = createModule({
   key: KEY,
   store: { modules: [{ key: KEY, module }], plugin },
   afterRegistration
-}
-
-export const RecentlyViewed = new VueStorefrontModule(moduleConfig)
+})