@o3r/apis-manager 12.1.0 → 12.1.7

package/apis-manager/api-factory.service.d.ts

@@ -22,8 +22,11 @@ export declare class ApiFactoryService {
      * Retrieve a specific API with loaded configuration
      * @param apiClass class of the API to retrieve
      * @param refreshCache Ignore cached API instance and refresh it
+     * @param customApiName override the `apiName` set in the `apiClass`
+     * @note When passing `customApiName` the configuration is expecting to exist else an error is thrown
+     * @note When passing an Api instance that does not match a registered configuration without `customApiName`, the default one will be returned
      */
-    getApi<T extends Api>(apiClass: (new (client: ApiClient) => T) & ApiName, refreshCache?: boolean): T;
+    getApi<T extends Api>(apiClass: (new (client: ApiClient) => T) & ApiName, refreshCache?: boolean, customApiName?: string): T;
     /**
      * Update the Map of loaded APIs.
      * Note: Can be used to override the a specific API
@@ -34,12 +37,12 @@ export declare class ApiFactoryService {
      * Clear the cache of loaded APIs
      * @param apis Whitelist of APIs to clear from the cache, if specified only these apis will be removed from the cache
      */
-    clearCache(apis?: ApiName[]): void;
+    clearCache(apis?: (ApiName | string)[]): void;
     /**
      * Retrieve the configuration for a specific API
-     * @param apiClass class of the API for which retrieving the configuration
+     * @param api API for which retrieving the configuration
      */
-    getConfigFor(apiClass: ApiName): ApiClient;
+    getConfigFor(api: string | ApiName): ApiClient;
     static ɵfac: i0.ɵɵFactoryDeclaration<ApiFactoryService, [null, { optional: true; }]>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ApiFactoryService>;
 }

package/apis-manager/api-factory.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-factory.service.d.ts","sourceRoot":"","sources":["../../src/apis-manager/api-factory.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,GAAG,EACH,SAAS,EACT,OAAO,EACR,MAAM,eAAe,CAAC;AACvB,OAAO,EAGL,cAAc,EAEf,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,UAAU,EACX,MAAM,eAAe,CAAC;;AAKvB,sCAAsC;AACtC,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,IAAI,CAAC,KAAK,MAAM,EAAE,SAAS,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC;AAEzF;;GAEG;AACH,eAAO,MAAM,kBAAkB,6CAAmE,CAAC;AAEnG,qBACa,iBAAiB;IAIG,OAAO,CAAC,QAAQ,CAAC,UAAU;IAH1D,yBAAyB;IACzB,OAAO,CAAC,UAAU,CAA2B;gBAEG,UAAU,EAAE,UAAU,EAA0C,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,YAAY,CAAC,EAAE;IAM7I;;;OAGG;IACH,OAAO,CAAC,UAAU;IAIlB;;;;OAIG;IACI,MAAM,CAAC,CAAC,SAAS,GAAG,EAAE,QAAQ,EAAE,CAAC,KAAK,MAAM,EAAE,SAAS,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,YAAY,UAAQ,GAAG,CAAC;IAWzG;;;;OAIG;IACI,gBAAgB,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,YAAY,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,GAAG,YAAY,CAAC,CAAC;IAmB1F;;;OAGG;IACI,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE;IAQlC;;;OAGG;IACI,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS;yCA1EtC,iBAAiB;6CAAjB,iBAAiB;CA6E7B"}
+{"version":3,"file":"api-factory.service.d.ts","sourceRoot":"","sources":["../../src/apis-manager/api-factory.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,GAAG,EACH,SAAS,EACT,OAAO,EACR,MAAM,eAAe,CAAC;AACvB,OAAO,EAGL,cAAc,EAEf,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,UAAU,EACX,MAAM,eAAe,CAAC;;AAKvB,sCAAsC;AACtC,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,IAAI,CAAC,KAAK,MAAM,EAAE,SAAS,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC;AAEzF;;GAEG;AACH,eAAO,MAAM,kBAAkB,6CAAmE,CAAC;AAEnG,qBACa,iBAAiB;IAIG,OAAO,CAAC,QAAQ,CAAC,UAAU;IAH1D,yBAAyB;IACzB,OAAO,CAAC,UAAU,CAA2B;gBAEG,UAAU,EAAE,UAAU,EAA0C,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,YAAY,CAAC,EAAE;IAM7I;;;OAGG;IACH,OAAO,CAAC,UAAU;IAIlB;;;;;;;OAOG;IACI,MAAM,CAAC,CAAC,SAAS,GAAG,EAAE,QAAQ,EAAE,CAAC,KAAK,MAAM,EAAE,SAAS,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,YAAY,UAAQ,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,CAAC;IAYjI;;;;OAIG;IACI,gBAAgB,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,YAAY,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,GAAG,YAAY,CAAC,CAAC;IAmB1F;;;OAGG;IACI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,GAAG,MAAM,CAAC,EAAE;IAQ7C;;;OAGG;IACI,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;yCA9E1C,iBAAiB;6CAAjB,iBAAiB;CAiF7B"}

package/apis-manager/api-manager.d.ts

@@ -1,4 +1,4 @@
-import type { Api, ApiClient } from '@ama-sdk/core';
+import type { ApiClient, ApiName } from '@ama-sdk/core';
 /**
  * Api manager is responsible to provide an api configuration to a service factory, so that it could instantiate an API
  * with the right parameters. It contains a default configuration and a map of specific configurations for API / set of
@@ -25,13 +25,15 @@ export declare class ApiManager {
     /**
      * Retrieve a configuration for a specific API
      * @param api API to get the configuration for
+     * @note When passing a string the configuration is expecting to exist else an error is thrown
+     * @note when passing an Api instance that does not match a registered configuration, the default one will be returned
      */
-    getConfiguration(api?: string | Api): ApiClient;
+    getConfiguration(api?: string | ApiName): ApiClient;
     /**
      * Set or override API configuration
      * @param apiClient API configuration to override to the given api
      * @param api API name to override, the default configuration will be used if not specified
      */
-    setConfiguration(apiClient: ApiClient, api?: string | Api): void;
+    setConfiguration(apiClient: ApiClient, api?: string | ApiName): void;
 }
 //# sourceMappingURL=api-manager.d.ts.map

package/apis-manager/api-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-manager.d.ts","sourceRoot":"","sources":["../../src/apis-manager/api-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,GAAG,EACH,SAAS,EACV,MAAM,eAAe,CAAC;AAEvB;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,oBAAoB,CAAY;IACxC,OAAO,CAAC,iBAAiB,CAA+B;IAExD;;;OAGG;IACH,IAAW,2BAA2B;;MAErC;IAED;;;OAGG;gBACS,oBAAoB,EAAE,SAAS,EAAE,iBAAiB,GAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;KAAO;IAKjG;;;OAGG;IACI,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS;IAItD;;;;OAIG;IACI,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI;CAOxE"}
+{"version":3,"file":"api-manager.d.ts","sourceRoot":"","sources":["../../src/apis-manager/api-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,OAAO,EACR,MAAM,eAAe,CAAC;AAEvB;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,oBAAoB,CAAY;IACxC,OAAO,CAAC,iBAAiB,CAA+B;IAExD;;;OAGG;IACH,IAAW,2BAA2B;;MAErC;IAED;;;OAGG;gBACS,oBAAoB,EAAE,SAAS,EAAE,iBAAiB,GAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;KAAO;IAKjG;;;;;OAKG;IACI,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAW1D;;;;OAIG;IACI,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;CAO5E"}

package/fesm2022/o3r-apis-manager.mjs

@@ -26,9 +26,19 @@ class ApiManager {
     /**
      * Retrieve a configuration for a specific API
      * @param api API to get the configuration for
+     * @note When passing a string the configuration is expecting to exist else an error is thrown
+     * @note when passing an Api instance that does not match a registered configuration, the default one will be returned
      */
     getConfiguration(api) {
-        return (api && this.apiConfigurations[typeof api === 'string' ? api : api.apiName]) || this.defaultConfiguration;
+        if (typeof api === 'string') {
+            if (this.apiConfigurations[api]) {
+                return this.apiConfigurations[api];
+            }
+            else {
+                throw new Error(`Unknown API configuration: ${api}\nKnown API configurations: ${Object.keys(this.apiConfigurations).join(', ')}`);
+            }
+        }
+        return (api && this.apiConfigurations[api.apiName]) || this.defaultConfiguration;
     }
     /**
      * Set or override API configuration
@@ -74,14 +84,18 @@ class ApiFactoryService {
      * Retrieve a specific API with loaded configuration
      * @param apiClass class of the API to retrieve
      * @param refreshCache Ignore cached API instance and refresh it
+     * @param customApiName override the `apiName` set in the `apiClass`
+     * @note When passing `customApiName` the configuration is expecting to exist else an error is thrown
+     * @note When passing an Api instance that does not match a registered configuration without `customApiName`, the default one will be returned
      */
-    getApi(apiClass, refreshCache = false) {
-        const cache = this.loadedApis[apiClass.apiName];
+    getApi(apiClass, refreshCache = false, customApiName) {
+        const apiName = customApiName ?? apiClass.apiName;
+        const cache = this.loadedApis[apiName];
         if (!refreshCache && cache) {
             return cache;
         }
-        const instance = new apiClass(this.getConfigFor(apiClass));
-        this.loadedApis[apiClass.apiName] = instance;
+        const instance = new apiClass(this.getConfigFor(customApiName ?? apiClass));
+        this.loadedApis[apiName] = instance;
         return instance;
     }
     /**
@@ -112,7 +126,7 @@ class ApiFactoryService {
      */
     clearCache(apis) {
         if (apis) {
-            apis.forEach((api) => delete this.loadedApis[api.apiName]);
+            apis.forEach((api) => delete this.loadedApis[typeof api === 'string' ? api : api.apiName]);
         }
         else {
             this.loadedApis = {};
@@ -120,10 +134,10 @@ class ApiFactoryService {
     }
     /**
      * Retrieve the configuration for a specific API
-     * @param apiClass class of the API for which retrieving the configuration
+     * @param api API for which retrieving the configuration
      */
-    getConfigFor(apiClass) {
-        return this.apiManager.getConfiguration(apiClass.apiName);
+    getConfigFor(api) {
+        return this.apiManager.getConfiguration(api);
     }
     /** @nocollapse */ static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.1", ngImport: i0, type: ApiFactoryService, deps: [{ token: API_TOKEN }, { token: INITIAL_APIS_TOKEN, optional: true }], target: i0.ɵɵFactoryTarget.Injectable }); }
     /** @nocollapse */ static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.2.1", ngImport: i0, type: ApiFactoryService }); }

package/fesm2022/o3r-apis-manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"o3r-apis-manager.mjs","sources":["../../src/apis-manager/api-manager.ts","../../src/apis-manager/api-manager.token.ts","../../src/apis-manager/api-factory.service.ts","../../src/apis-manager/api-manager.helpers.ts","../../src/apis-manager/api-manager.module.ts","../../src/o3r-apis-manager.ts"],"sourcesContent":["import type {\n  Api,\n  ApiClient,\n} from '@ama-sdk/core';\n\n/**\n * Api manager is responsible to provide an api configuration to a service factory, so that it could instantiate an API\n * with the right parameters. It contains a default configuration and a map of specific configurations for API / set of\n * API. Configurations are only exposed through the method getConfiguration, which will merge the default configuration\n * and the requested one.\n */\nexport class ApiManager {\n  private defaultConfiguration: ApiClient;\n  private apiConfigurations: { [key: string]: ApiClient };\n\n  /**\n   * Map of registered Api Client associated to specific API\n   * Warning: This should not be used to get the ApiClient for an API, the function getConfiguration() should be used instead\n   */\n  public get registeredApiConfigurations() {\n    return { ...this.apiConfigurations } as const;\n  }\n\n  /**\n   * Create an API manager using a custom ApiClient\n   * @param defaultConfiguration\n   */\n  constructor(defaultConfiguration: ApiClient, apiConfigurations: { [key: string]: ApiClient } = {}) {\n    this.defaultConfiguration = defaultConfiguration;\n    this.apiConfigurations = apiConfigurations;\n  }\n\n  /**\n   * Retrieve a configuration for a specific API\n   * @param api API to get the configuration for\n   */\n  public getConfiguration(api?: string | Api): ApiClient {\n    return (api && this.apiConfigurations[typeof api === 'string' ? api : api.apiName]) || this.defaultConfiguration;\n  }\n\n  /**\n   * Set or override API configuration\n   * @param apiClient API configuration to override to the given api\n   * @param api API name to override, the default configuration will be used if not specified\n   */\n  public setConfiguration(apiClient: ApiClient, api?: string | Api): void {\n    if (api) {\n      this.apiConfigurations[typeof api === 'string' ? api : api.apiName] = apiClient;\n    } else {\n      this.defaultConfiguration = apiClient;\n    }\n  }\n}\n","import {\n  InjectionToken,\n} from '@angular/core';\nimport {\n  ApiManager,\n} from './api-manager';\n\n/**\n * Token used by the core library to provide an Api manager to services. It can be provided in the app.\n */\nexport const API_TOKEN = new InjectionToken<ApiManager>('Custom API manager token');\n","import type {\n  Api,\n  ApiClient,\n  ApiName,\n} from '@ama-sdk/core';\nimport {\n  Inject,\n  Injectable,\n  InjectionToken,\n  Optional,\n} from '@angular/core';\nimport {\n  ApiManager,\n} from './api-manager';\nimport {\n  API_TOKEN,\n} from './api-manager.token';\n\n/** Type of the Class of an SDK Api */\nexport type ApiClassType<T extends Api = Api> = (new (client: ApiClient) => T) & ApiName;\n\n/**\n * Initial APIs instantiations\n */\nexport const INITIAL_APIS_TOKEN = new InjectionToken<(Api | ApiClassType)[]>('Initial APIs token');\n\n@Injectable()\nexport class ApiFactoryService {\n  /** Map of loaded APIs */\n  private loadedApis: Record<string, Api> = {};\n\n  constructor(@Inject(API_TOKEN) private readonly apiManager: ApiManager, @Optional() @Inject(INITIAL_APIS_TOKEN) apis?: (Api | ApiClassType)[]) {\n    if (apis) {\n      this.updateApiMapping(apis);\n    }\n  }\n\n  /**\n   * Determine if the given parameter is a API class\n   * @param apiClass object to check\n   */\n  private isApiClass<T extends Api = Api>(apiClass: any): apiClass is ApiClassType<T> {\n    return !!apiClass.apiName && typeof apiClass === 'function';\n  }\n\n  /**\n   * Retrieve a specific API with loaded configuration\n   * @param apiClass class of the API to retrieve\n   * @param refreshCache Ignore cached API instance and refresh it\n   */\n  public getApi<T extends Api>(apiClass: (new (client: ApiClient) => T) & ApiName, refreshCache = false): T {\n    const cache = this.loadedApis[apiClass.apiName];\n    if (!refreshCache && cache) {\n      return cache as T;\n    }\n\n    const instance = new apiClass(this.getConfigFor(apiClass));\n    this.loadedApis[apiClass.apiName] = instance;\n    return instance;\n  }\n\n  /**\n   * Update the Map of loaded APIs.\n   * Note: Can be used to override the a specific API\n   * @param map Map of loaded APIs to update\n   */\n  public updateApiMapping(map: (Api | ApiClassType)[] | Record<string, (Api | ApiClassType)>) {\n    const newItems: Record<string, (Api | ApiClassType)> = Array.isArray(map)\n      ? map\n        .reduce<Record<string, Api | ApiClassType<Api>>>((acc, curr) => {\n          acc[curr.apiName] = curr;\n          return acc;\n        }, {})\n      : map;\n\n    this.loadedApis = {\n      ...this.loadedApis,\n      ...Object.entries(newItems)\n        .reduce<Record<string, Api>>((acc, [apiName, api]) => {\n          acc[apiName] = this.isApiClass(api) ? new api(this.getConfigFor(api)) : api;\n          return acc;\n        }, {})\n    };\n  }\n\n  /**\n   * Clear the cache of loaded APIs\n   * @param apis Whitelist of APIs to clear from the cache, if specified only these apis will be removed from the cache\n   */\n  public clearCache(apis?: ApiName[]) {\n    if (apis) {\n      apis.forEach((api) => delete this.loadedApis[api.apiName]);\n    } else {\n      this.loadedApis = {};\n    }\n  }\n\n  /**\n   * Retrieve the configuration for a specific API\n   * @param apiClass class of the API for which retrieving the configuration\n   */\n  public getConfigFor(apiClass: ApiName): ApiClient {\n    return this.apiManager.getConfiguration(apiClass.apiName);\n  }\n}\n","/**\n * Add a preconnect `<link>` element to the DOM\n * @param baseUrl the origin href\n * @param supportCrossOrigin add crossorigin attribute to the link element\n */\nexport function appendPreconnect(baseUrl: string, supportCrossOrigin = true): void {\n  const preConnectLink = document.createElement('link');\n  preConnectLink.setAttribute('rel', 'preconnect');\n  preConnectLink.setAttribute('href', baseUrl);\n  if (supportCrossOrigin) {\n    preConnectLink.setAttribute('crossorigin', '');\n  }\n  document.head.append(preConnectLink);\n}\n","import {\n  ModuleWithProviders,\n  NgModule,\n} from '@angular/core';\nimport {\n  ApiFactoryService,\n} from './api-factory.service';\nimport {\n  ApiManager,\n} from './api-manager';\nimport {\n  API_TOKEN,\n} from './api-manager.token';\n\n// Module that needs to be imported by the application to instantiate an SDK configuration.\n@NgModule({\n  providers: [\n    ApiFactoryService\n  ]\n})\nexport class ApiManagerModule {\n  /**\n   * Provide a custom apiManager\n   * A factory can be provided via injection to the token API_TOKEN\n   * @param apiManager\n   */\n  public static forRoot(apiManager: ApiManager): ModuleWithProviders<ApiManagerModule> {\n    return {\n      ngModule: ApiManagerModule,\n      providers: [\n        { provide: API_TOKEN, useValue: apiManager }\n      ]\n    };\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public_api';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"o3r-apis-manager.mjs","sources":["../../src/apis-manager/api-manager.ts","../../src/apis-manager/api-manager.token.ts","../../src/apis-manager/api-factory.service.ts","../../src/apis-manager/api-manager.helpers.ts","../../src/apis-manager/api-manager.module.ts","../../src/o3r-apis-manager.ts"],"sourcesContent":["import type {\n  ApiClient,\n  ApiName,\n} from '@ama-sdk/core';\n\n/**\n * Api manager is responsible to provide an api configuration to a service factory, so that it could instantiate an API\n * with the right parameters. It contains a default configuration and a map of specific configurations for API / set of\n * API. Configurations are only exposed through the method getConfiguration, which will merge the default configuration\n * and the requested one.\n */\nexport class ApiManager {\n  private defaultConfiguration: ApiClient;\n  private apiConfigurations: { [key: string]: ApiClient };\n\n  /**\n   * Map of registered Api Client associated to specific API\n   * Warning: This should not be used to get the ApiClient for an API, the function getConfiguration() should be used instead\n   */\n  public get registeredApiConfigurations() {\n    return { ...this.apiConfigurations } as const;\n  }\n\n  /**\n   * Create an API manager using a custom ApiClient\n   * @param defaultConfiguration\n   */\n  constructor(defaultConfiguration: ApiClient, apiConfigurations: { [key: string]: ApiClient } = {}) {\n    this.defaultConfiguration = defaultConfiguration;\n    this.apiConfigurations = apiConfigurations;\n  }\n\n  /**\n   * Retrieve a configuration for a specific API\n   * @param api API to get the configuration for\n   * @note When passing a string the configuration is expecting to exist else an error is thrown\n   * @note when passing an Api instance that does not match a registered configuration, the default one will be returned\n   */\n  public getConfiguration(api?: string | ApiName): ApiClient {\n    if (typeof api === 'string') {\n      if (this.apiConfigurations[api]) {\n        return this.apiConfigurations[api];\n      } else {\n        throw new Error(`Unknown API configuration: ${api}\\nKnown API configurations: ${Object.keys(this.apiConfigurations).join(', ')}`);\n      }\n    }\n    return (api && this.apiConfigurations[api.apiName]) || this.defaultConfiguration;\n  }\n\n  /**\n   * Set or override API configuration\n   * @param apiClient API configuration to override to the given api\n   * @param api API name to override, the default configuration will be used if not specified\n   */\n  public setConfiguration(apiClient: ApiClient, api?: string | ApiName): void {\n    if (api) {\n      this.apiConfigurations[typeof api === 'string' ? api : api.apiName] = apiClient;\n    } else {\n      this.defaultConfiguration = apiClient;\n    }\n  }\n}\n","import {\n  InjectionToken,\n} from '@angular/core';\nimport {\n  ApiManager,\n} from './api-manager';\n\n/**\n * Token used by the core library to provide an Api manager to services. It can be provided in the app.\n */\nexport const API_TOKEN = new InjectionToken<ApiManager>('Custom API manager token');\n","import type {\n  Api,\n  ApiClient,\n  ApiName,\n} from '@ama-sdk/core';\nimport {\n  Inject,\n  Injectable,\n  InjectionToken,\n  Optional,\n} from '@angular/core';\nimport {\n  ApiManager,\n} from './api-manager';\nimport {\n  API_TOKEN,\n} from './api-manager.token';\n\n/** Type of the Class of an SDK Api */\nexport type ApiClassType<T extends Api = Api> = (new (client: ApiClient) => T) & ApiName;\n\n/**\n * Initial APIs instantiations\n */\nexport const INITIAL_APIS_TOKEN = new InjectionToken<(Api | ApiClassType)[]>('Initial APIs token');\n\n@Injectable()\nexport class ApiFactoryService {\n  /** Map of loaded APIs */\n  private loadedApis: Record<string, Api> = {};\n\n  constructor(@Inject(API_TOKEN) private readonly apiManager: ApiManager, @Optional() @Inject(INITIAL_APIS_TOKEN) apis?: (Api | ApiClassType)[]) {\n    if (apis) {\n      this.updateApiMapping(apis);\n    }\n  }\n\n  /**\n   * Determine if the given parameter is a API class\n   * @param apiClass object to check\n   */\n  private isApiClass<T extends Api = Api>(apiClass: any): apiClass is ApiClassType<T> {\n    return !!apiClass.apiName && typeof apiClass === 'function';\n  }\n\n  /**\n   * Retrieve a specific API with loaded configuration\n   * @param apiClass class of the API to retrieve\n   * @param refreshCache Ignore cached API instance and refresh it\n   * @param customApiName override the `apiName` set in the `apiClass`\n   * @note When passing `customApiName` the configuration is expecting to exist else an error is thrown\n   * @note When passing an Api instance that does not match a registered configuration without `customApiName`, the default one will be returned\n   */\n  public getApi<T extends Api>(apiClass: (new (client: ApiClient) => T) & ApiName, refreshCache = false, customApiName?: string): T {\n    const apiName = customApiName ?? apiClass.apiName;\n    const cache = this.loadedApis[apiName];\n    if (!refreshCache && cache) {\n      return cache as T;\n    }\n\n    const instance = new apiClass(this.getConfigFor(customApiName ?? apiClass));\n    this.loadedApis[apiName] = instance;\n    return instance;\n  }\n\n  /**\n   * Update the Map of loaded APIs.\n   * Note: Can be used to override the a specific API\n   * @param map Map of loaded APIs to update\n   */\n  public updateApiMapping(map: (Api | ApiClassType)[] | Record<string, (Api | ApiClassType)>) {\n    const newItems: Record<string, (Api | ApiClassType)> = Array.isArray(map)\n      ? map\n        .reduce<Record<string, Api | ApiClassType<Api>>>((acc, curr) => {\n          acc[curr.apiName] = curr;\n          return acc;\n        }, {})\n      : map;\n\n    this.loadedApis = {\n      ...this.loadedApis,\n      ...Object.entries(newItems)\n        .reduce<Record<string, Api>>((acc, [apiName, api]) => {\n          acc[apiName] = this.isApiClass(api) ? new api(this.getConfigFor(api)) : api;\n          return acc;\n        }, {})\n    };\n  }\n\n  /**\n   * Clear the cache of loaded APIs\n   * @param apis Whitelist of APIs to clear from the cache, if specified only these apis will be removed from the cache\n   */\n  public clearCache(apis?: (ApiName | string)[]) {\n    if (apis) {\n      apis.forEach((api) => delete this.loadedApis[typeof api === 'string' ? api : api.apiName]);\n    } else {\n      this.loadedApis = {};\n    }\n  }\n\n  /**\n   * Retrieve the configuration for a specific API\n   * @param api API for which retrieving the configuration\n   */\n  public getConfigFor(api: string | ApiName): ApiClient {\n    return this.apiManager.getConfiguration(api);\n  }\n}\n","/**\n * Add a preconnect `<link>` element to the DOM\n * @param baseUrl the origin href\n * @param supportCrossOrigin add crossorigin attribute to the link element\n */\nexport function appendPreconnect(baseUrl: string, supportCrossOrigin = true): void {\n  const preConnectLink = document.createElement('link');\n  preConnectLink.setAttribute('rel', 'preconnect');\n  preConnectLink.setAttribute('href', baseUrl);\n  if (supportCrossOrigin) {\n    preConnectLink.setAttribute('crossorigin', '');\n  }\n  document.head.append(preConnectLink);\n}\n","import {\n  ModuleWithProviders,\n  NgModule,\n} from '@angular/core';\nimport {\n  ApiFactoryService,\n} from './api-factory.service';\nimport {\n  ApiManager,\n} from './api-manager';\nimport {\n  API_TOKEN,\n} from './api-manager.token';\n\n// Module that needs to be imported by the application to instantiate an SDK configuration.\n@NgModule({\n  providers: [\n    ApiFactoryService\n  ]\n})\nexport class ApiManagerModule {\n  /**\n   * Provide a custom apiManager\n   * A factory can be provided via injection to the token API_TOKEN\n   * @param apiManager\n   */\n  public static forRoot(apiManager: ApiManager): ModuleWithProviders<ApiManagerModule> {\n    return {\n      ngModule: ApiManagerModule,\n      providers: [\n        { provide: API_TOKEN, useValue: apiManager }\n      ]\n    };\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public_api';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@o3r/apis-manager",
-  "version": "12.1.0",
+  "version": "12.1.7",
   "publishConfig": {
     "access": "public"
   },
@@ -11,12 +11,12 @@
     "otter-module"
   ],
   "peerDependencies": {
-    "@ama-sdk/client-fetch": "^12.1.0",
-    "@ama-sdk/core": "^12.1.0",
+    "@ama-sdk/client-fetch": "^12.1.7",
+    "@ama-sdk/core": "^12.1.7",
     "@angular-devkit/schematics": "^19.0.0",
     "@angular/common": "^19.0.0",
     "@angular/core": "^19.0.0",
-    "@o3r/schematics": "^12.1.0",
+    "@o3r/schematics": "^12.1.7",
     "@schematics/angular": "^19.0.0",
     "rxjs": "^7.8.1",
     "ts-node": "~10.9.2",