@empathyco/x-components 6.0.0-alpha.17 → 6.0.0-alpha.170

package/js/plugins/x-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"x-plugin.js","sources":["../../../src/plugins/x-plugin.ts"],"sourcesContent":["import { deepMerge } from '@empathyco/x-deep-merge';\nimport { forEach, Dictionary } from '@empathyco/x-utils';\nimport { App } from 'vue';\nimport { createStore, Module, Store } from 'vuex';\nimport { XComponentsAdapter } from '@empathyco/x-types';\nimport { EventPayload, SubjectPayload, XBus } from '@empathyco/x-bus';\nimport { Observable } from 'rxjs';\nimport { AnyXStoreModule, RootXStoreState } from '../store/store.types';\nimport { cleanGettersProxyCache } from '../store/utils/getters-proxy.utils';\nimport { RootXStoreModule } from '../store/x.module';\nimport { XEvent, XEventsTypes } from '../wiring/events.types';\nimport { AnyWire, WireMetadata } from '../wiring/wiring.types';\nimport { AnyXModule, XModuleName } from '../x-modules/x-modules.types';\nimport { sendWiringToDevtools } from './devtools/wiring.devtools';\nimport { bus } from './x-bus';\nimport { registerStoreEmitters } from './x-emitters';\nimport { AnyXStoreModuleOption, XModuleOptions, XPluginOptions } from './x-plugin.types';\nimport { assertXPluginOptionsAreValid } from './x-plugin.utils';\n\n/**\n * Vue plugin that initializes the properties needed by the x-components, and exposes the events bus\n * and the adapter after it has been installed.\n *\n * @public\n */\nexport class XPlugin {\n  /**\n   * {@link @empathyco/x-typesm#XComponentsAdapter | XComponentsAdapter} Is the middleware\n   * between the components and our API where data can be mapped to client needs.\n   * This property is only available after installing the plugin.\n   *\n   * @returns The installed adapter.\n   * @throws If this property is accessed before calling `Vue.use(xPlugin)`.\n   * @public\n   */\n  public static get adapter(): XComponentsAdapter {\n    return this.getInstance().adapter;\n  }\n\n  /**\n   * Exposed {@link @empathyco/x-bus#XBus}, so any kind of application can subscribe to\n   * {@link XEventsTypes} without having to pass through a component.\n   * This property is only available after installing the plugin.\n   *\n   * @returns The installed bus.\n   * @throws If this property is accessed before calling `Vue.use(xPlugin)`.\n   * @public\n   */\n  public static get bus(): XBus<XEventsTypes, WireMetadata> {\n    return this.getInstance().bus;\n  }\n\n  /**\n   * {@link https://vuex.vuejs.org | Vuex Store} Is the place where all shared data\n   * is saved.\n   *\n   * @returns The installed store.\n   * @throws If this property is accessed before calling `Vue.use(xPlugin)`.\n   * @public\n   */\n  public static get store(): Store<RootXStoreState> {\n    return this.getInstance().store;\n  }\n\n  /**\n   * Safely retrieves the installed instance of the XPlugin.\n   *\n   * @returns The installed instance of the XPlugin.\n   * @throws If this method is called before calling `Vue.use(xPlugin)`.\n   * @internal\n   */\n  protected static getInstance(): XPlugin {\n    if (!this.instance) {\n      throw Error(\"XPlugin must be installed before accessing it's API.\");\n    }\n    return this.instance;\n  }\n\n  /**\n   * Record of modules that have been tried to be installed before the installation of the plugin.\n   *\n   * @internal\n   */\n  protected static pendingXModules: Partial<Record<XModuleName, AnyXModule>> = {};\n\n  /**\n   * Instance of the installed plugin. Used to expose the bus and the adapter.\n   *\n   * @internal\n   */\n  protected static instance?: XPlugin;\n\n  public wiring: Partial<Record<XModuleName, Partial<Record<XEvent, string[]>>>> = {};\n  /**\n   * Bus for retrieving the observables when registering the wiring.\n   *\n   * @internal\n   */\n  protected bus: XBus<XEventsTypes, WireMetadata>;\n\n  /**\n   * Adapter for the API, responsible for transforming requests and responses.\n   *\n   * @internal\n   */\n  protected adapter!: XComponentsAdapter;\n\n  /**\n   * Set of the already installed {@link XModule | XModules} to avoid re-registering them.\n   *\n   * @internal\n   */\n  protected installedXModules = new Set<string>();\n\n  /**\n   * True if the plugin has been installed in a Vue instance, in this case\n   * {@link XModule |Xmodules} will be installed immediately. False otherwise, in this case\n   * {@link XModule | XModules} will be installed lazily when the {@link XPlugin#install} method\n   * is called.\n   *\n   * @internal\n   */\n  protected isInstalled = false;\n\n  /**\n   * The installation options of the plugin, where all the customization of\n   * {@link XModule | XModules} is done.\n   *\n   * @internal\n   */\n  protected options!: XPluginOptions;\n\n  /**\n   * The Vuex store, to pass to the wires for its registration, and to register the store\n   * modules on it.\n   *\n   * @internal\n   */\n  protected store!: Store<any>;\n\n  /**\n   * The Vue application instance, passed by the installation method.\n   *\n   * @internal\n   */\n  protected app!: App;\n\n  /**\n   * Creates a new instance of the XPlugin with the given bus passed as parameter.\n   *\n   * @param bus - The {@link @empathyco/x-bus#XBus} implementation to use for the plugin.\n   *\n   * @public\n   */\n  public constructor(bus: XBus<XEventsTypes, WireMetadata>) {\n    this.bus = bus;\n  }\n\n  /**\n   * If the plugin has already been installed, it immediately registers a {@link XModule}. If it\n   * has not been installed yet, it stores the module in a list until the plugin is installed.\n   *\n   * @param xModule - The module to register.\n   *\n   * @public\n   */\n  static registerXModule(xModule: AnyXModule): void {\n    if (this.instance) {\n      this.instance.registerXModule(xModule);\n    } else {\n      this.lazyRegisterXModule(xModule);\n    }\n  }\n\n  /**\n   * Utility method for resetting the installed instance of the plugin.\n   *\n   * @remarks Use only for testing.\n   *\n   * @internal\n   */\n  static resetInstance(): void {\n    cleanGettersProxyCache();\n    this.instance = undefined;\n  }\n\n  /**\n   * Stores the {@link XModule} in a dictionary, so it can be registered later in the installation\n   * process.\n   *\n   * @param xModule - The module to register.\n   *\n   * @internal\n   */\n  protected static lazyRegisterXModule(xModule: AnyXModule): void {\n    this.pendingXModules[xModule.name] = xModule;\n  }\n\n  /**\n   * Installs the plugin into the Vue instance.\n   *\n   * @param app - The Vue application instance.\n   * @param options - The options to install this plugin with.\n   * @throws If the XPlugin has already been installed, or the options are not valid.\n   *\n   * @internal\n   */\n  install(app: App, options?: XPluginOptions): void {\n    if (this.isInstalled) {\n      throw new Error('XPlugin has already been installed');\n    }\n    assertXPluginOptionsAreValid(options);\n    XPlugin.instance = this;\n    this.app = app;\n    this.options = options;\n    this.adapter = options.adapter;\n    this.registerStore();\n    this.registerInitialModules();\n    this.registerPendingXModules();\n    this.isInstalled = true;\n  }\n\n  /**\n   * Performs the registration of a {@link XModule}.\n   *\n   * @param xModule - The module to register.\n   *\n   * @internal\n   */\n  protected registerXModule(xModule: AnyXModule): void {\n    if (!this.installedXModules.has(xModule.name)) {\n      const customizedXModule = this.customizeXModule(xModule);\n      this.registerStoreModule(customizedXModule);\n      this.registerStoreEmitters(customizedXModule);\n      this.registerWiring(customizedXModule);\n      // The wiring must be registered after the store emitters\n      // to allow lazy loaded modules work properly.\n      this.installedXModules.add(xModule.name);\n      this.bus.emit('ModuleRegistered', xModule.name);\n    }\n  }\n\n  /**\n   * Performs a customization of a {@link XModule} using the XPlugin public and private options.\n   *\n   * @param xModule - The module to customize.\n   * @returns The customized xModule.\n   *\n   * @internal\n   */\n  protected customizeXModule({\n    name,\n    wiring,\n    storeModule,\n    storeEmitters,\n    ...restXModule\n  }: AnyXModule): AnyXModule {\n    const { wiring: wiringOptions, config }: XModuleOptions<XModuleName> =\n      this.options.xModules?.[name] ?? {};\n\n    const { storeModule: storeModuleOptions, storeEmitters: emittersOptions } =\n      this.options.__PRIVATE__xModules?.[name] ?? {};\n\n    return {\n      name,\n      wiring: wiringOptions ? deepMerge({}, wiring, wiringOptions) : wiring,\n      storeModule: this.customizeStoreModule(storeModule, storeModuleOptions ?? {}, config),\n      storeEmitters: emittersOptions\n        ? deepMerge({}, storeEmitters, emittersOptions)\n        : storeEmitters,\n      ...restXModule\n    };\n  }\n\n  /**\n   * Performs the registration of the wiring, retrieving the observable for each event, and\n   * executing each wire.\n   *\n   * @param xModule - The {@link XModule} to register its wiring.\n   *\n   * @internal\n   */\n  protected registerWiring({ wiring, name }: AnyXModule): void {\n    sendWiringToDevtools(name, wiring);\n    forEach(wiring, (event, wires: Dictionary<AnyWire>) => {\n      // Obtain the observable\n      const observable = this.bus.on(event, true) as unknown as Observable<\n        SubjectPayload<EventPayload<XEventsTypes, typeof event>, WireMetadata>\n      >;\n      // Register event wires\n      forEach(wires, (_, wire) => {\n        wire(observable, this.store as Store<RootXStoreState>, this.bus.on.bind(this.bus));\n      });\n    });\n  }\n\n  /**\n   * Registers a {@link https://vuex.vuejs.org/ | Vuex} store module under the 'x' module.\n   *\n   * @param xModule - The {@link XModule} to register its Store Module.\n   *\n   * @internal\n   */\n  protected registerStoreModule({ name, storeModule }: AnyXModule): void {\n    (storeModule as Module<any, any>).namespaced = true;\n    this.store.registerModule(['x', name], storeModule);\n  }\n\n  /**\n   * Overrides a {@link https://vuex.vuejs.org/ | Vuex} store module definition.\n   *\n   * Priority of configuration merging.\n   * 1st {@link XPluginOptions.xModules | xModules XPlugin option}.\n   * 2nd {@link XPluginOptions.__PRIVATE__xModules | Private xModules XPlugin option}.\n   * 3rd {@link XStoreModule.state | Default state of the xModule}.\n   *\n   * @param defaultModule - The default store module to override.\n   * @param moduleOptions - The state, actions, mutations and getters to override the defaultModule.\n   * @param configOptions - The state config to override the moduleOptions.\n   * @returns The {@link XStoreModule} customized.\n   *\n   * @internal\n   */\n  protected customizeStoreModule(\n    { state: defaultState, ...actionsGettersMutations }: AnyXStoreModule,\n    { state: xModuleState, ...newActionsGettersMutations }: AnyXStoreModuleOption,\n    configOptions: unknown\n  ): AnyXStoreModule {\n    const configOptionsObject = configOptions ? { config: configOptions } : {};\n    const customizedModule = deepMerge({}, actionsGettersMutations, newActionsGettersMutations);\n    customizedModule.state = deepMerge(defaultState(), xModuleState, configOptionsObject);\n    return customizedModule;\n  }\n\n  /**\n   * Registers the store emitters, making them emit the event when the part of the state selected\n   * changes.\n   *\n   * @param xModule - The {@link XModule} to register its Store Emitters.\n   *\n   * @internal\n   */\n  protected registerStoreEmitters(xModule: AnyXModule): void {\n    registerStoreEmitters(xModule, this.bus, this.store);\n  }\n\n  /**\n   * Registers the {@link https://vuex.vuejs.org/ | Vuex} store. If the store has not been passed\n   * through the {@link XPluginOptions} object, it creates one, and injects it in the Vue\n   * prototype. Then it registers an x module in the store, to safe scope all the\n   * {@link XModule | XModules} dynamically installed.\n   *\n   * @internal\n   */\n  protected registerStore(): void {\n    this.store = this.options.store ?? createStore({});\n    this.app.use(this.store);\n    this.store.registerModule('x', RootXStoreModule);\n  }\n  /**\n   * Registers the initial {@link XModule | XModules} during the {@link XPlugin} installation.\n   *\n   * @internal\n   */\n  protected registerInitialModules(): void {\n    this.options.initialXModules?.forEach(xModule => {\n      this.registerXModule(xModule);\n    });\n  }\n\n  /**\n   * Registers the pending {@link XModule | XModules}, that requested to be registered before the\n   * installation of the plugin.\n   *\n   * @internal\n   */\n  protected registerPendingXModules(): void {\n    forEach(XPlugin.pendingXModules, (_, xModule) => {\n      this.registerXModule(xModule);\n    });\n    XPlugin.pendingXModules = {};\n  }\n}\n\n/**\n * Vue plugin that modifies each component instance, extending them with the\n * {@link XComponentAPI | X Component API }.\n *\n * @example\n * Minimal installation example. An API adapter is needed to connect the X Components with the\n * suggestions, search, or tagging APIs. In this example we are using the default Empathy's platform\n * adapter.\n *\n * ```typescript\n *  import { platformAdapter } from '@empathyco/x-adapter-platform';\n *  Vue.use(xPlugin, { adapter: platformAdapter });\n * ```\n *\n * @example\n * If you are using {@link https://vuex.vuejs.org/ | Vuex} in your project you must install its\n *   plugin, and instantiate a store before installing the XPlugin:\n * ```typescript\n * Vue.use(Vuex);\n * const store = new Store({ ... });\n * Vue.use(xPlugin, { adapter, store });\n * ```\n * @public\n */\nexport const xPlugin = new XPlugin(bus);\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"x-plugin.js","sources":["../../../src/plugins/x-plugin.ts"],"sourcesContent":["import type { XComponentsAdapter } from '@empathyco/x-types'\nimport type { Dictionary } from '@empathyco/x-utils'\nimport type { Observable } from 'rxjs'\nimport type { App } from 'vue'\nimport type { Module, Store } from 'vuex'\nimport type { AnyXStoreModule, RootXStoreState } from '../store/store.types'\nimport type { XEvent, XEventsTypes } from '../wiring/events.types'\nimport type { AnyWire, WireMetadata } from '../wiring/wiring.types'\nimport type { EventPayload, SubjectPayload, XBus } from '../x-bus'\nimport type { AnyXModule, XModuleName } from '../x-modules/x-modules.types'\nimport type { AnyXStoreModuleOption, XModuleOptions, XPluginOptions } from './x-plugin.types'\nimport { deepMerge } from '@empathyco/x-deep-merge'\nimport { forEach } from '@empathyco/x-utils'\nimport { createStore } from 'vuex'\nimport { cleanGettersProxyCache } from '../store/utils/getters-proxy.utils'\nimport { RootXStoreModule } from '../store/x.module'\nimport { sendWiringToDevtools } from './devtools/wiring.devtools'\nimport { bus } from './x-bus'\nimport { registerStoreEmitters } from './x-emitters'\nimport { assertXPluginOptionsAreValid } from './x-plugin.utils'\n\n/**\n * Vue plugin that initializes the properties needed by the x-components, and exposes the events bus\n * and the adapter after it has been installed.\n *\n * @public\n */\nexport class XPlugin {\n  /**\n   * XComponentsAdapter Is the middleware between the components and our API where data can be\n   * mapped to client needs.\n   * This property is only available after installing the plugin.\n   *\n   * @returns The installed adapter.\n   * @throws If this property is accessed before calling `Vue.use(xPlugin)`.\n   * @public\n   */\n  public static get adapter(): XComponentsAdapter {\n    return this.getInstance().adapter\n  }\n\n  /**\n   * Exposed XBus, so any kind of application can subscribe to\n   * {@link XEventsTypes} without having to pass through a component.\n   * This property is only available after installing the plugin.\n   *\n   * @returns The installed bus.\n   * @throws If this property is accessed before calling `Vue.use(xPlugin)`.\n   * @public\n   */\n  public static get bus(): XBus<XEventsTypes, WireMetadata> {\n    return this.getInstance().bus\n  }\n\n  /**\n   * {@link https://vuex.vuejs.org | Vuex Store} Is the place where all shared data\n   * is saved.\n   *\n   * @returns The installed store.\n   * @throws If this property is accessed before calling `Vue.use(xPlugin)`.\n   * @public\n   */\n  public static get store(): Store<RootXStoreState> {\n    return this.getInstance().store\n  }\n\n  /**\n   * Safely retrieves the installed instance of the XPlugin.\n   *\n   * @returns The installed instance of the XPlugin.\n   * @throws If this method is called before calling `Vue.use(xPlugin)`.\n   * @internal\n   */\n  protected static getInstance(): XPlugin {\n    if (!this.instance) {\n      throw new Error(\"XPlugin must be installed before accessing it's API.\")\n    }\n    return this.instance\n  }\n\n  /**\n   * Record of modules that have been tried to be installed before the installation of the plugin.\n   *\n   * @internal\n   */\n  protected static pendingXModules: Partial<Record<XModuleName, AnyXModule>> = {}\n\n  /**\n   * Instance of the installed plugin. Used to expose the bus and the adapter.\n   *\n   * @internal\n   */\n  protected static instance?: XPlugin\n\n  public wiring: Partial<Record<XModuleName, Partial<Record<XEvent, string[]>>>> = {}\n  /**\n   * Bus for retrieving the observables when registering the wiring.\n   *\n   * @internal\n   */\n  protected bus: XBus<XEventsTypes, WireMetadata>\n\n  /**\n   * Adapter for the API, responsible for transforming requests and responses.\n   *\n   * @internal\n   */\n  protected adapter!: XComponentsAdapter\n\n  /**\n   * Set of the already installed XModules to avoid re-registering them.\n   *\n   * @internal\n   */\n  protected installedXModules = new Set<string>()\n\n  /**\n   * True if the plugin has been installed in a Vue instance, in this case\n   * XModules will be installed immediately. False otherwise, in this case\n   * XModules will be installed lazily when the {@link XPlugin#install} method\n   * is called.\n   *\n   * @internal\n   */\n  protected isInstalled = false\n\n  /**\n   * The installation options of the plugin, where all the customization of\n   * {@link XModule | XModules} is done.\n   *\n   * @internal\n   */\n  protected options!: XPluginOptions\n\n  /**\n   * The Vuex store, to pass to the wires for its registration, and to register the store\n   * modules on it.\n   *\n   * @internal\n   */\n  protected store!: Store<any>\n\n  /**\n   * The Vue application instance, passed by the installation method.\n   *\n   * @internal\n   */\n  protected app!: App\n\n  /**\n   * Creates a new instance of the XPlugin with the given bus passed as parameter.\n   *\n   * @param bus - The XBus implementation to use for the plugin.\n   *\n   * @public\n   */\n  public constructor(bus: XBus<XEventsTypes, WireMetadata>) {\n    this.bus = bus\n  }\n\n  /**\n   * If the plugin has already been installed, it immediately registers a {@link XModule}. If it\n   * has not been installed yet, it stores the module in a list until the plugin is installed.\n   *\n   * @param xModule - The module to register.\n   *\n   * @public\n   */\n  static registerXModule(xModule: AnyXModule): void {\n    if (this.instance) {\n      this.instance.registerXModule(xModule)\n    } else {\n      this.lazyRegisterXModule(xModule)\n    }\n  }\n\n  /**\n   * Utility method for resetting the installed instance of the plugin.\n   *\n   * @remarks Use only for testing.\n   *\n   * @internal\n   */\n  static resetInstance(): void {\n    cleanGettersProxyCache()\n    this.instance = undefined\n  }\n\n  /**\n   * Stores the {@link XModule} in a dictionary, so it can be registered later in the installation\n   * process.\n   *\n   * @param xModule - The module to register.\n   *\n   * @internal\n   */\n  protected static lazyRegisterXModule(xModule: AnyXModule): void {\n    this.pendingXModules[xModule.name] = xModule\n  }\n\n  /**\n   * Installs the plugin into the Vue instance.\n   *\n   * @param app - The Vue application instance.\n   * @param options - The options to install this plugin with.\n   * @throws If the XPlugin has already been installed, or the options are not valid.\n   *\n   * @internal\n   */\n  install(app: App, options?: XPluginOptions): void {\n    if (this.isInstalled) {\n      throw new Error('XPlugin has already been installed')\n    }\n    assertXPluginOptionsAreValid(options)\n    XPlugin.instance = this\n    this.app = app\n    this.options = options\n    this.adapter = options.adapter\n    this.registerStore()\n    this.registerInitialModules()\n    this.registerPendingXModules()\n    this.isInstalled = true\n  }\n\n  /**\n   * Performs the registration of a {@link XModule}.\n   *\n   * @param xModule - The module to register.\n   *\n   * @internal\n   */\n  protected registerXModule(xModule: AnyXModule): void {\n    if (!this.installedXModules.has(xModule.name)) {\n      const customizedXModule = this.customizeXModule(xModule)\n      this.registerStoreModule(customizedXModule)\n      this.registerStoreEmitters(customizedXModule)\n      this.registerWiring(customizedXModule)\n      // The wiring must be registered after the store emitters\n      // to allow lazy loaded modules work properly.\n      this.installedXModules.add(xModule.name)\n      void this.bus.emit('ModuleRegistered', xModule.name)\n    }\n  }\n\n  /**\n   * Performs a customization of a {@link XModule} using the XPlugin public and private options.\n   *\n   * @param xModule - The module to customize.\n   * @returns The customized xModule.\n   * @internal\n   */\n  protected customizeXModule({\n    name,\n    wiring,\n    storeModule,\n    storeEmitters,\n    ...restXModule\n  }: AnyXModule): AnyXModule {\n    const { wiring: wiringOptions, config }: XModuleOptions<XModuleName> =\n      this.options.xModules?.[name] ?? {}\n\n    const { storeModule: storeModuleOptions, storeEmitters: emittersOptions } =\n      this.options.__PRIVATE__xModules?.[name] ?? {}\n\n    return {\n      name,\n      // eslint-disable-next-line ts/no-unsafe-assignment\n      wiring: wiringOptions ? deepMerge({}, wiring, wiringOptions) : wiring,\n      storeModule: this.customizeStoreModule(storeModule, storeModuleOptions ?? {}, config),\n      // eslint-disable-next-line ts/no-unsafe-assignment\n      storeEmitters: emittersOptions\n        ? deepMerge({}, storeEmitters, emittersOptions)\n        : storeEmitters,\n      ...restXModule,\n    }\n  }\n\n  /**\n   * Performs the registration of the wiring, retrieving the observable for each event, and\n   * executing each wire.\n   *\n   * @param xModule - The {@link XModule} to register its wiring.\n   * @internal\n   */\n  protected registerWiring({ wiring, name }: AnyXModule): void {\n    sendWiringToDevtools(name, wiring)\n    forEach(wiring, (event, wires: Dictionary<AnyWire>) => {\n      // Obtain the observable\n      const observable = this.bus.on(event, true) as unknown as Observable<\n        SubjectPayload<EventPayload<XEventsTypes, typeof event>, WireMetadata>\n      >\n      // Register event wires\n      forEach(wires, (_, wire) => {\n        wire(observable, this.store as Store<RootXStoreState>, this.bus.on.bind(this.bus))\n      })\n    })\n  }\n\n  /**\n   * Registers a {@link https://vuex.vuejs.org/ | Vuex} store module under the 'x' module.\n   *\n   * @param xModule - The {@link XModule} to register its Store Module.\n   * @internal\n   */\n  protected registerStoreModule({ name, storeModule }: AnyXModule): void {\n    ;(storeModule as Module<any, any>).namespaced = true\n    this.store.registerModule(['x', name], storeModule)\n  }\n\n  /**\n   * Overrides a {@link https://vuex.vuejs.org/ | Vuex} store module definition.\n   *\n   * Priority of configuration merging.\n   * 1st {@link XPluginOptions.xModules | xModules XPlugin option}.\n   * 2nd {@link XPluginOptions.__PRIVATE__xModules | Private xModules XPlugin option}.\n   * 3rd {@link XStoreModule.state | Default state of the xModule}.\n   *\n   * @param defaultModule - The default store module to override.\n   * @param moduleOptions - The state, actions, mutations and getters to override the defaultModule.\n   * @param configOptions - The state config to override the moduleOptions.\n   * @returns The {@link XStoreModule} customized.\n   * @internal\n   */\n  protected customizeStoreModule(\n    { state: defaultState, ...actionsGettersMutations }: AnyXStoreModule,\n    { state: xModuleState, ...newActionsGettersMutations }: AnyXStoreModuleOption,\n    configOptions: unknown,\n  ): AnyXStoreModule {\n    const configOptionsObject = configOptions ? { config: configOptions } : {}\n    // eslint-disable-next-line ts/no-unsafe-assignment\n    const customizedModule = deepMerge({}, actionsGettersMutations, newActionsGettersMutations)\n    // eslint-disable-next-line ts/no-unsafe-assignment,ts/no-unsafe-member-access\n    customizedModule.state = deepMerge(defaultState(), xModuleState, configOptionsObject)\n    // eslint-disable-next-line ts/no-unsafe-return\n    return customizedModule\n  }\n\n  /**\n   * Registers the store emitters, making them emit the event when the part of the state selected\n   * changes.\n   *\n   * @param xModule - The {@link XModule} to register its Store Emitters.\n   * @internal\n   */\n  protected registerStoreEmitters(xModule: AnyXModule): void {\n    registerStoreEmitters(xModule, this.bus, this.store)\n  }\n\n  /**\n   * Registers the {@link https://vuex.vuejs.org/ | Vuex} store. If the store has not been passed\n   * through the {@link XPluginOptions} object, it creates one, and injects it in the Vue\n   * prototype. Then it registers an x module in the store, to safe scope all the\n   * {@link XModule | XModules} dynamically installed.\n   *\n   * @internal\n   */\n  protected registerStore(): void {\n    this.store = this.options.store ?? createStore({})\n    this.app.use(this.store)\n    this.store.registerModule('x', RootXStoreModule)\n  }\n  /**\n   * Registers the initial {@link XModule | XModules} during the {@link XPlugin} installation.\n   *\n   * @internal\n   */\n  protected registerInitialModules(): void {\n    this.options.initialXModules?.forEach(xModule => {\n      this.registerXModule(xModule)\n    })\n  }\n\n  /**\n   * Registers the pending {@link XModule | XModules}, that requested to be registered before the\n   * installation of the plugin.\n   *\n   * @internal\n   */\n  protected registerPendingXModules(): void {\n    forEach(XPlugin.pendingXModules, (_, xModule) => {\n      this.registerXModule(xModule)\n    })\n    XPlugin.pendingXModules = {}\n  }\n}\n\n/**\n * Vue plugin that modifies each component instance, extending them with the\n * {@link XComponentAPI | X Component API }.\n *\n * @example\n * Minimal installation example. An API adapter is needed to connect the X Components with the\n * suggestions, search, or tagging APIs. In this example we are using the default Empathy's platform\n * adapter.\n *\n * ```typescript\n *  import { platformAdapter } from '@empathyco/x-adapter-platform';\n *  Vue.use(xPlugin, { adapter: platformAdapter });\n * ```\n *\n * @example\n * If you are using {@link https://vuex.vuejs.org/ | Vuex} in your project you must install its\n *   plugin, and instantiate a store before installing the XPlugin:\n * ```typescript\n * Vue.use(Vuex);\n * const store = new Store({ ... });\n * Vue.use(xPlugin, { adapter, store });\n * ```\n * @public\n */\nexport const xPlugin = new XPlugin(bus)\n"],"names":[],"mappings":"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"}

package/js/plugins/x-plugin.utils.js

@@ -1,31 +1,27 @@
-/**
- * Asserts that the passed options object is valid, providing helpful error messages.
- *
- * @param options - The options to check if they are valid.
- * @public
- */
-function assertXPluginOptionsAreValid(options) {
-    if (!options) {
-        throw new Error(
-        // eslint-disable-next-line max-len
-        'XPlugin needs to be installed with an options object containing at least an adapter. Please provide a valid object');
-    }
-    if (options.adapter == null) {
-        throw new Error(
-        // eslint-disable-next-line max-len
-        "The options object doesn't seem to have an adapter. Please, create one and pass it through the options object");
-    }
-}
-/**
- * Generates a getter path string with the module and getter name.
- *
- * @param moduleName - The module name the getter belongs to.
- * @param getterName - The getter name.
- * @returns A string representing the getter path.
- * @public
- */
-function getGetterPath(moduleName, getterName) {
-    return `x/${moduleName}/${getterName}`;
+/**
+ * Asserts that the passed options object is valid, providing helpful error messages.
+ *
+ * @param options - The options to check if they are valid.
+ * @public
+ */
+function assertXPluginOptionsAreValid(options) {
+    if (!options) {
+        throw new Error('XPlugin needs to be installed with an options object containing at least an adapter. Please provide a valid object');
+    }
+    if (options.adapter == null) {
+        throw new Error("The options object doesn't seem to have an adapter. Please, create one and pass it through the options object");
+    }
+}
+/**
+ * Generates a getter path string with the module and getter name.
+ *
+ * @param moduleName - The module name the getter belongs to.
+ * @param getterName - The getter name.
+ * @returns A string representing the getter path.
+ * @public
+ */
+function getGetterPath(moduleName, getterName) {
+    return `x/${moduleName}/${getterName}`;
 }
 
 export { assertXPluginOptionsAreValid, getGetterPath };

package/js/plugins/x-plugin.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"x-plugin.utils.js","sources":["../../../src/plugins/x-plugin.utils.ts"],"sourcesContent":["import { ExtractGetters, XModuleName } from '../x-modules/x-modules.types';\nimport { XPluginOptions } from './x-plugin.types';\n\n/**\n * Asserts that the passed options object is valid, providing helpful error messages.\n *\n * @param options - The options to check if they are valid.\n * @public\n */\nexport function assertXPluginOptionsAreValid(\n  options: XPluginOptions | undefined\n): asserts options is XPluginOptions {\n  if (!options) {\n    throw new Error(\n      // eslint-disable-next-line max-len\n      'XPlugin needs to be installed with an options object containing at least an adapter. Please provide a valid object'\n    );\n  }\n\n  if (options.adapter == null) {\n    throw new Error(\n      // eslint-disable-next-line max-len\n      \"The options object doesn't seem to have an adapter. Please, create one and pass it through the options object\"\n    );\n  }\n}\n\n/**\n * Generates a getter path string with the module and getter name.\n *\n * @param moduleName - The module name the getter belongs to.\n * @param getterName - The getter name.\n * @returns A string representing the getter path.\n * @public\n */\nexport function getGetterPath<ModuleName extends XModuleName>(\n  moduleName: ModuleName,\n  getterName: keyof ExtractGetters<ModuleName>\n): string {\n  return `x/${moduleName}/${getterName as string}`;\n}\n"],"names":[],"mappings":"AAGA;;;;;AAKG;AACG,SAAU,4BAA4B,CAC1C,OAAmC,EAAA;IAEnC,IAAI,CAAC,OAAO,EAAE;AACZ,QAAA,MAAM,IAAI,KAAK;;AAEb,QAAA,oHAAoH,CACrH,CAAC;AACH,KAAA;AAED,IAAA,IAAI,OAAO,CAAC,OAAO,IAAI,IAAI,EAAE;AAC3B,QAAA,MAAM,IAAI,KAAK;;AAEb,QAAA,+GAA+G,CAChH,CAAC;AACH,KAAA;AACH,CAAC;AAED;;;;;;;AAOG;AACa,SAAA,aAAa,CAC3B,UAAsB,EACtB,UAA4C,EAAA;AAE5C,IAAA,OAAO,CAAK,EAAA,EAAA,UAAU,CAAI,CAAA,EAAA,UAAoB,EAAE,CAAC;AACnD;;;;"}
+{"version":3,"file":"x-plugin.utils.js","sources":["../../../src/plugins/x-plugin.utils.ts"],"sourcesContent":["import type { ExtractGetters, XModuleName } from '../x-modules/x-modules.types'\nimport type { XPluginOptions } from './x-plugin.types'\n\n/**\n * Asserts that the passed options object is valid, providing helpful error messages.\n *\n * @param options - The options to check if they are valid.\n * @public\n */\nexport function assertXPluginOptionsAreValid(\n  options: XPluginOptions | undefined,\n): asserts options is XPluginOptions {\n  if (!options) {\n    throw new Error(\n      'XPlugin needs to be installed with an options object containing at least an adapter. Please provide a valid object',\n    )\n  }\n\n  if (options.adapter == null) {\n    throw new Error(\n      \"The options object doesn't seem to have an adapter. Please, create one and pass it through the options object\",\n    )\n  }\n}\n\n/**\n * Generates a getter path string with the module and getter name.\n *\n * @param moduleName - The module name the getter belongs to.\n * @param getterName - The getter name.\n * @returns A string representing the getter path.\n * @public\n */\nexport function getGetterPath<ModuleName extends XModuleName>(\n  moduleName: ModuleName,\n  getterName: keyof ExtractGetters<ModuleName>,\n): string {\n  return `x/${moduleName}/${getterName as string}`\n}\n"],"names":[],"mappings":"AAGA;;;;;AAKG;AACG,SAAU,4BAA4B,CAC1C,OAAmC,EAAA;IAEnC,IAAI,CAAC,OAAO,EAAE;AACZ,QAAA,MAAM,IAAI,KAAK,CACb,oHAAoH,CACrH,CAAA;KACF;AAED,IAAA,IAAI,OAAO,CAAC,OAAO,IAAI,IAAI,EAAE;AAC3B,QAAA,MAAM,IAAI,KAAK,CACb,+GAA+G,CAChH,CAAA;KACF;AACH,CAAC;AAED;;;;;;;AAOG;AACa,SAAA,aAAa,CAC3B,UAAsB,EACtB,UAA4C,EAAA;AAE5C,IAAA,OAAO,CAAK,EAAA,EAAA,UAAU,CAAI,CAAA,EAAA,UAAoB,EAAE,CAAA;AAClD;;;;"}