chore: Update modules providers configuration with 'identifier' and 'PROVIDER' (#9636)

* chore: Update modules providers configuration with 'identifier' and 'PROVIDER'

* update check

* fix tests

* type

* normalize auth provider

* emailpass

* providers

---------

Co-authored-by: Carlos R. L. Rodrigues <rodrigolr@gmail.com>
Co-authored-by: Carlos R. L. Rodrigues <37986729+carlos-r-l-rodrigues@users.noreply.github.com>

packages/core/modules-sdk/src/loaders/utils/__fixtures__/module-with-providers/provider-2/services/provider-service.ts

@@ -1 +1,3 @@
-export class ModuleProvider2Service {}
+export class ModuleProvider2Service {
+  static identifier = "provider-2"
+}

packages/core/modules-sdk/src/loaders/utils/__tests__/load-internal.spec.ts

@@ -1,5 +1,9 @@
 import { IModuleService, ModuleResolution } from "@medusajs/types"
-import { createMedusaContainer, upperCaseFirst } from "@medusajs/utils"
+import {
+  createMedusaContainer,
+  getProviderRegistrationKey,
+  upperCaseFirst,
+} from "@medusajs/utils"
 import { join } from "path"
 import {
   ModuleWithDmlMixedWithoutJoinerConfigFixtures,
@@ -10,11 +14,7 @@ import {
 import { ModuleService as ModuleServiceWithProvider } from "../__fixtures__/module-with-providers"
 import { ModuleProviderService as ModuleServiceWithProviderProvider1 } from "../__fixtures__/module-with-providers/provider-1"
 import { ModuleProvider2Service as ModuleServiceWithProviderProvider2 } from "../__fixtures__/module-with-providers/provider-2"
-import {
-  getProviderRegistrationKey,
-  loadInternalModule,
-  loadResources,
-} from "../load-internal"
+import { loadInternalModule, loadResources } from "../load-internal"
 
 describe("load internal", () => {
   describe("loadResources", () => {
@@ -376,9 +376,10 @@ describe("load internal", () => {
 
       const moduleService = container.resolve(moduleResolution.definition.key)
       const provider = (moduleService as any).container[
-        getProviderRegistrationKey(
-          ModuleServiceWithProviderProvider1.identifier
-        )
+        getProviderRegistrationKey({
+          providerId: moduleResolution.options!.providers![0].id,
+          providerIdentifier: ModuleServiceWithProviderProvider1.identifier,
+        })
       ]
 
       expect(moduleService).toBeInstanceOf(ModuleServiceWithProvider)
@@ -427,7 +428,10 @@ describe("load internal", () => {
 
       const moduleService = container.resolve(moduleResolution.definition.key)
       const provider = (moduleService as any).container[
-        getProviderRegistrationKey(moduleResolution.options!.providers![0].id)
+        getProviderRegistrationKey({
+          providerId: moduleResolution.options!.providers![0].id,
+          providerIdentifier: ModuleServiceWithProviderProvider2.identifier,
+        })
       ]
 
       expect(moduleService).toBeInstanceOf(ModuleServiceWithProvider)

packages/core/modules-sdk/src/loaders/utils/load-internal.ts

@@ -18,6 +18,7 @@ import {
   defineJoinerConfig,
   DmlEntity,
   dynamicImport,
+  getProviderRegistrationKey,
   isString,
   MedusaModuleProviderType,
   MedusaModuleType,
@@ -51,17 +52,6 @@ type ResolvedModuleProvider = ModuleProviderExports & {
   discoveryPath: string
 }
 
-export const moduleProviderRegistrationKeyPrefix = "__providers__"
-
-/**
- * Return the key used to register a module provider in the container
- * @param {string} moduleKey
- * @return {string}
- */
-export function getProviderRegistrationKey(moduleKey: string): string {
-  return moduleProviderRegistrationKeyPrefix + moduleKey
-}
-
 export async function resolveModuleExports({
   resolution,
 }: {
@@ -140,7 +130,7 @@ async function loadInternalProvider(
         moduleExports: !isString(providerRes) ? providerRes : undefined,
         definition: {
           ...resolution.definition,
-          key: provider.id,
+          key: provider.id!,
         },
         resolutionPath: isString(provider.resolve)
           ? require.resolve(provider.resolve, {
@@ -321,13 +311,39 @@ export async function loadInternalModule(args: {
     for (const moduleProviderService of moduleProviderServices) {
       const modProvider_ = moduleProviderService as any
 
-      modProvider_.identifier ??= keyName
-      modProvider_.__type = MedusaModuleProviderType
-      const registrationKey = getProviderRegistrationKey(
-        modProvider_.identifier
+      const originalIdentifier = modProvider_.identifier as string
+      const providerId = keyName
+
+      if (!originalIdentifier) {
+        const providerResolutionName =
+          modProvider_.DISPLAY_NAME ?? resolution.resolutionPath
+
+        throw new Error(
+          `Module provider ${providerResolutionName} does not have a static "identifier" property on its service class.`
+        )
+      }
+
+      const alreadyRegisteredProvider = container.hasRegistration(
+        getProviderRegistrationKey({
+          providerId,
+          providerIdentifier: originalIdentifier,
+        })
       )
+      if (alreadyRegisteredProvider) {
+        throw new Error(
+          `Module provider ${originalIdentifier} has already been registered. Please provide a different "id" in the provider options.`
+        )
+      }
+
+      modProvider_.__type = MedusaModuleProviderType
+
+      const registrationKey = getProviderRegistrationKey({
+        providerId,
+        providerIdentifier: originalIdentifier,
+      })
+
       container.register({
-        [registrationKey]: asFunction((cradle) => {
+        [registrationKey]: asFunction(() => {
           ;(moduleProviderService as any).__type = MedusaModuleType
           return new moduleProviderService(
             localContainer.cradle,

packages/core/types/src/modules-sdk/module-provider.ts

@@ -42,7 +42,7 @@ export type ModuleProviderLoaderFunction = (
 
 export type ModuleProvider = {
   resolve: string | ModuleProviderExports<any>
-  id: string
+  id?: string
   options?: Record<string, unknown>
   is_default?: boolean
 }

packages/core/utils/src/auth/abstract-auth-provider.ts

@@ -69,22 +69,32 @@ export abstract class AbstractAuthModuleProvider implements IAuthProvider {
   /**
    * @ignore
    */
-  private static PROVIDER: string
+  static identifier: string
   /**
    * @ignore
    */
-  private static DISPLAY_NAME: string
+  static DISPLAY_NAME: string
 
   /**
    * @ignore
    */
   protected readonly container_: any
+
   /**
+   * @deprecated Use `identifier` instead.
    * @ignore
    */
   public get provider() {
-    return (this.constructor as typeof AbstractAuthModuleProvider).PROVIDER
+    return (this.constructor as typeof AbstractAuthModuleProvider).identifier
   }
+
+  /**
+   * @ignore
+   */
+  public get identifier() {
+    return (this.constructor as typeof AbstractAuthModuleProvider).identifier
+  }
+
   /**
    * @ignore
    */
@@ -98,21 +108,6 @@ export abstract class AbstractAuthModuleProvider implements IAuthProvider {
    */
   static validateOptions(options: Record<any, any>): void | never {}
 
-  /**
-   * @ignore
-   *
-   * @privateRemarks
-   * Documenting the constructor in the class's TSDocs as it's difficult to relay
-   * the necessary information with this constructor's signature.
-   */
-  protected constructor({}, config: { provider: string; displayName: string }) {
-    this.container_ = arguments[0]
-    ;(this.constructor as typeof AbstractAuthModuleProvider).PROVIDER ??=
-      config.provider
-    ;(this.constructor as typeof AbstractAuthModuleProvider).DISPLAY_NAME ??=
-      config.displayName
-  }
-
   /**
    * This method authenticates the user.
    *

packages/core/utils/src/modules-sdk/index.ts

@@ -19,3 +19,4 @@ export * from "./module-provider"
 export * from "./query-context"
 export * from "./types/links-config"
 export * from "./types/medusa-service"
+export * from "./module-provider-registration-key"

packages/core/utils/src/modules-sdk/module-provider-registration-key.ts

@@ -0,0 +1,19 @@
+export const moduleProviderRegistrationKeyPrefix = "__providers__"
+
+/**
+ * Return the key used to register a module provider in the container
+ * @param {string} moduleKey
+ * @return {string}
+ */
+export function getProviderRegistrationKey({
+  providerId,
+  providerIdentifier,
+}: {
+  providerId?: string
+  providerIdentifier?: string
+}): string {
+  const registrationIdentifier = `${
+    providerIdentifier ? providerIdentifier : ""
+  }${providerId ? `${providerIdentifier ? "_" : ""}${providerId}` : ""}`
+  return moduleProviderRegistrationKeyPrefix + registrationIdentifier
+}