angular-toolbox 0.9.1 → 0.9.3

package/fesm2022/angular-toolbox.mjs

@@ -333,11 +333,18 @@ const SYMBOL = "symbol";
  * Angular Toolbox Subscription Service.
  */
 class IdentifiableComponent {
-    constructor() {
+    /**
+     * A string that represent the class reference for this object.
+     * This can be useful to workaround TypeScript compilation obfuscation.
+     *
+     * @param classRef The class reference for this object.
+     */
+    constructor(classRef = undefined) {
         /**
          * @private
          */
         this._uuid = Uuid.build();
+        this._classRef = classRef || this.constructor.name;
     }
     /**
      * Returns the unique identifier for this object.
@@ -347,9 +354,198 @@ class IdentifiableComponent {
     getID() {
         return this._uuid;
     }
+    /**
+     * Returns the class name reference of this object. Can be either the `classRef`
+     * paramter of the contructor method, or the constructor `name` property value.
+     *
+     * @returns the class name reference of this object.
+     */
+    getClassRef() {
+        return this._classRef;
+    }
 }
 ;
 
+/**
+ * @license
+ * Copyright Pascal ECHEMANN. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be found in
+ * the LICENSE file at https://pascalechemann.com/angular-toolbox/resources/license
+ */
+/**
+ * The abstract class for all services that implement the `SubscriptionManager` interface.
+ */
+class AbstractSubscriptionManager {
+    constructor() {
+        /**
+         * @private
+         * Stores an internal reference to the last reference used with the `register()`
+         * method.
+         */
+        this._lastRef = null;
+        /**
+         * @private
+         * The internal `Subscription` instances storage.
+         */
+        this._subMap = new Map();
+    }
+    /**
+     * Stores a new `Subscription` instance associated with the specified reference.
+     *
+     * @param ref The reference for which to store a new `Subscription` instance.
+     *            Can be either a string or an `Identifiable` object.
+     * @param subscription The `Subscription` instance to register.
+     *
+     * @returns A reference to this `SubscriptionService` instance.
+     */
+    register(ref, subscription) {
+        const REF = this.getRef(ref);
+        this._lastRef = REF;
+        if (!this._subMap.has(REF))
+            this._subMap.set(REF, []);
+        this._subMap.get(REF)?.push(subscription);
+        return this;
+    }
+    /**
+     * Stores a new `Subscription` instance associated with the reference specified
+     * by the last `register()` method invokation.
+     *
+     * @param subscription The `Subscription` instance to register.
+     *
+     * @returns A reference to this `SubscriptionService` instance.
+     */
+    append(subscription) {
+        if (!this._lastRef)
+            throw new SubscriptionError("Illegal Access Error: you must call the register() method before invoking the append() method.");
+        return this.register(this._lastRef, subscription);
+    }
+    /**
+     * Unsubscribes and removes all `Subscription` instances associated with the specified reference.
+     *
+     * @param ref The reference for which to remove all `Subscription` instances.
+     *            Can be either a string or an `Identifiable` object.
+     *
+     * @returns `true` whether the specified reference exists; `false` otherwise.
+     */
+    clearAll(ref) {
+        const REF = this.getRef(ref);
+        let result = false;
+        if (this._lastRef === REF)
+            this._lastRef = null;
+        if (this._subMap.has(REF)) {
+            this._subMap.get(REF)?.forEach(subscription => {
+                if (!subscription.closed)
+                    subscription.unsubscribe();
+            });
+            this._subMap.delete(REF);
+            result = true;
+        }
+        return result;
+    }
+    /**
+     * Returns all `Subscription` instances associated with the specified reference.
+     *
+     * @param ref The reference for which to remove get `Subscription` instances.
+     *            Can be either a string or an `Identifiable` object.
+     *
+     * @returns All `Subscription` instances associated with the specified reference, or
+     *          `null` whether the specified reference does not exists.
+     */
+    get(ref) {
+        return this._subMap.get(this.getRef(ref)) || null;
+    }
+    /**
+     * @private
+     * Returns the string reference for the regsitration process.
+     *
+     * @param ref The reference to be used the regsitration process.
+     *            Can be either a string or an `Identifiable` object.
+     *
+     * @returns the string reference for the regsitration process.
+     */
+    getRef(ref) {
+        let targetRef;
+        if (typeof ref === STRING)
+            targetRef = ref;
+        else if (ref instanceof IdentifiableComponent)
+            targetRef = ref.getID().toString();
+        else
+            throw new TypeError("ref must be of type of string or Identifiable");
+        return targetRef;
+    }
+}
+
+/**
+ * @license
+ * Copyright Pascal ECHEMANN. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be ound in
+ * fthe LICENSE file at https://pascalechemann.com/angular-toolbox/resources/license
+ */
+/**
+ * @private
+ * Specifies the semantic versioning of an API.
+ */
+class VersionImpl {
+    /**
+     * @private
+     */
+    constructor(major, minor, patch, buildTimeStamp) {
+        this.major = major;
+        this.minor = minor;
+        this.patch = patch;
+        this.buildTimeStamp = buildTimeStamp;
+    }
+    /**
+     * Returns a string representation of this `Version` object in the form `M.m.p`, where
+     * `M` represents the major number, `m` represents the minor number and `p` represents
+     * the patch number of this `VersionImpl` instance.
+     *
+     * @returns A string representation of this `VersionImpl` instance.
+     */
+    toString() {
+        return `${this.major}.${this.minor}.${this.patch}`;
+    }
+}
+;
+
+/**
+ * @license
+ * Copyright Pascal ECHEMANN. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be found in
+ * the LICENSE file at https://pascalechemann.com/angular-toolbox/resources/license
+ */
+/**
+ * The abstract class for all services that implement the `VersionManager` interface.
+ */
+class AbstractVersionManager {
+    /**
+     * Creates a new VersionManager object.
+     * @param config the reference to the VersionConfig provider.
+     */
+    constructor(config) {
+        this._version = new VersionImpl(config.major, config.minor, config.patch, config.buildTimestamp);
+    }
+    /**
+     * Returns the version of the associated Angular project.
+     *
+     * @return the version of the associated Angular project.
+     */
+    getVersion() {
+        return this._version;
+    }
+    /**
+     * Returns the build timestamp of the associated Angular project.
+     *
+     * @return the  build timestamp of the associated Angular project.
+     */
+    getBuildTimestamp() {
+        return this._version.buildTimeStamp;
+    }
+}
+
 /**
  * @license
  * Copyright Pascal ECHEMANN. All Rights Reserved.
@@ -707,6 +903,15 @@ const VERSION_CONFIG = {
     buildTimestamp: NaN
 };
 
+/**
+ * @license
+ * Copyright Pascal ECHEMANN. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be found in
+ * the LICENSE file at https://pascalechemann.com/angular-toolbox/resources/license
+ */
+;
+
 /**
  * @license
  * Copyright Pascal ECHEMANN. All Rights Reserved.
@@ -869,6 +1074,14 @@ const DARK_MODE_CONFIG = {
  * the LICENSE file at https://pascalechemann.com/angular-toolbox/resources/license
  */
 
+/**
+ * @license
+ * Copyright Pascal ECHEMANN. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be found in
+ * the LICENSE file at https://pascalechemann.com/angular-toolbox/resources/license
+ */
+
 /**
  * @license
  * Copyright Pascal ECHEMANN. All Rights Reserved.
@@ -879,103 +1092,12 @@ const DARK_MODE_CONFIG = {
 /**
  * A lightweight service that helps to manage unregistration issues of Angular subscriptions.
  */
-class SubscriptionService {
-    constructor() {
-        /**
-         * @private
-         * Stores an internal reference to the last reference used with the `register()`
-         * method.
-         */
-        this._lastRef = null;
-        /**
-         * @private
-         * The internal `Subscription` instances storage.
-         */
-        this._subMap = new Map();
-    }
-    /**
-     * Stores a new `Subscription` instance associated with the specified reference.
-     *
-     * @param ref The reference for which to store a new `Subscription` instance.
-     *            Can be either a string or an `Identifiable` object.
-     * @param subscription The `Subscription` instance to register.
-     *
-     * @returns A reference to this `SubscriptionService` instance.
-     */
-    register(ref, subscription) {
-        const REF = this.getRef(ref);
-        this._lastRef = REF;
-        if (!this._subMap.has(REF))
-            this._subMap.set(REF, []);
-        this._subMap.get(REF)?.push(subscription);
-        return this;
-    }
-    /**
-     * Stores a new `Subscription` instance associated with the reference specified
-     * by the last `register()` method invokation.
-     *
-     * @param subscription The `Subscription` instance to register.
-     *
-     * @returns A reference to this `SubscriptionService` instance.
-     */
-    append(subscription) {
-        if (!this._lastRef)
-            throw new SubscriptionError("Illegal Access Error: you must call the register() method before invoking the append() method.");
-        return this.register(this._lastRef, subscription);
-    }
-    /**
-     * Unsubscribes and removes all `Subscription` instances associated with the specified reference.
-     *
-     * @param ref The reference for which to remove all `Subscription` instances.
-     *            Can be either a string or an `Identifiable` object.
-     *
-     * @returns `true` whether the specified reference exists; `false` otherwise.
-     */
-    clearAll(ref) {
-        const REF = this.getRef(ref);
-        let result = false;
-        if (this._lastRef === REF)
-            this._lastRef = null;
-        if (this._subMap.has(REF)) {
-            this._subMap.get(REF)?.forEach(subscription => {
-                if (!subscription.closed)
-                    subscription.unsubscribe();
-            });
-            this._subMap.delete(REF);
-            result = true;
-        }
-        return result;
-    }
-    /**
-     * Returns all `Subscription` instances associated with the specified reference.
-     *
-     * @param ref The reference for which to remove get `Subscription` instances.
-     *            Can be either a string or an `Identifiable` object.
-     *
-     * @returns All `Subscription` instances associated with the specified reference, or
-     *          `null` whether the specified reference does not exists.
-     */
-    get(ref) {
-        return this._subMap.get(this.getRef(ref)) || null;
-    }
+class SubscriptionService extends AbstractSubscriptionManager {
     /**
      * @private
-     * Returns the string reference for the regsitration process.
-     *
-     * @param ref The reference to be used the regsitration process.
-     *            Can be either a string or an `Identifiable` object.
-     *
-     * @returns the string reference for the regsitration process.
      */
-    getRef(ref) {
-        let targetRef;
-        if (typeof ref === "string")
-            targetRef = ref;
-        else if (ref instanceof IdentifiableComponent)
-            targetRef = ref.getID().toString();
-        else
-            throw new TypeError("ref must be of type of string or Identifiable");
-        return targetRef;
+    constructor() {
+        super();
     }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.0.3", ngImport: i0, type: SubscriptionService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
     static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.0.3", ngImport: i0, type: SubscriptionService, providedIn: 'root' }); }
@@ -985,7 +1107,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.0.3", ngImpor
             args: [{
                     providedIn: 'root'
                 }]
-        }] });
+        }], ctorParameters: () => [] });
 
 /**
  * @license
@@ -1466,40 +1588,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.0.3", ngImpor
                     args: [DOCUMENT]
                 }] }] });
 
-/**
- * @license
- * Copyright Pascal ECHEMANN. All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be ound in
- * fthe LICENSE file at https://pascalechemann.com/angular-toolbox/resources/license
- */
-/**
- * @private
- * Specifies the semantic versioning of an API.
- */
-class VersionImpl {
-    /**
-     * @private
-     */
-    constructor(major, minor, patch, buildTimeStamp) {
-        this.major = major;
-        this.minor = minor;
-        this.patch = patch;
-        this.buildTimeStamp = buildTimeStamp;
-    }
-    /**
-     * Returns a string representation of this `Version` object in the form `M.m.p`, where
-     * `M` represents the major number, `m` represents the minor number and `p` represents
-     * the patch number of this `VersionImpl` instance.
-     *
-     * @returns A string representation of this `VersionImpl` instance.
-     */
-    toString() {
-        return `${this.major}.${this.minor}.${this.patch}`;
-    }
-}
-;
-
 /**
  * @license
  * Copyright Pascal ECHEMANN. All Rights Reserved.
@@ -1510,29 +1598,13 @@ class VersionImpl {
 /**
  * A lightweight service that provides Semantic Versioning implementation for your Angular projects.
  */
-class VersionService {
+class VersionService extends AbstractVersionManager {
     /**
      * Creates a new VersionService instance.
      * @param config the reference to the VersionConfig provider.
      */
     constructor(config) {
-        this._version = new VersionImpl(config.major, config.minor, config.patch, config.buildTimestamp);
-    }
-    /**
-     * Returns the version of the associated Angular project.
-     *
-     * @return the version of the associated Angular project.
-     */
-    getVersion() {
-        return this._version;
-    }
-    /**
-     * Returns the build timestamp of the associated Angular project.
-     *
-     * @return the  build timestamp of the associated Angular project.
-     */
-    getBuildTimestamp() {
-        return this._version.buildTimeStamp;
+        super(config);
     }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.0.3", ngImport: i0, type: VersionService, deps: [{ token: VERSION_CONFIG }], target: i0.ɵɵFactoryTarget.Injectable }); }
     static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.0.3", ngImport: i0, type: VersionService, providedIn: 'root' }); }
@@ -3705,5 +3777,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.0.3", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { APP_PRIDGE_REF, AnchorLinklDirective, AngularToolboxModule, AppBridgeError, AppBrigeService, BIGINT, BOOLEAN, BUTTON_ROLE, ButtonRoleDirective, CSS_PROP, ContentRendererDirective, DARK_MODE_CONFIG, DarkModeService, EMPTY_STRING, FUNCTION, HTTP_MOCK_SERVICE, HttpHeadersMockBuilder, HttpMock, HttpMockService, HttpMockServiceError, HttpResponseMockBuilder, IdentifiableComponent, IntegrityError, LINK_ROLE, NUMBER, NavigateToUrlDirective, OBJECT, STORAGE_KEY, STRING, SYMBOL, SafeHtmlPipe, ScrollService, SubscriptionError, SubscriptionService, UNDEFINED, Uuid, VERSION_CONFIG, VersionService, httpHeadersMock, httpMockFactory, httpResponseMock };
+export { APP_PRIDGE_REF, AbstractSubscriptionManager, AbstractVersionManager, AnchorLinklDirective, AngularToolboxModule, AppBridgeError, AppBrigeService, BIGINT, BOOLEAN, BUTTON_ROLE, ButtonRoleDirective, CSS_PROP, ContentRendererDirective, DARK_MODE_CONFIG, DarkModeService, EMPTY_STRING, FUNCTION, HTTP_MOCK_SERVICE, HttpHeadersMockBuilder, HttpMock, HttpMockService, HttpMockServiceError, HttpResponseMockBuilder, IdentifiableComponent, IntegrityError, LINK_ROLE, NUMBER, NavigateToUrlDirective, OBJECT, STORAGE_KEY, STRING, SYMBOL, SafeHtmlPipe, ScrollService, SubscriptionError, SubscriptionService, UNDEFINED, Uuid, VERSION_CONFIG, VersionService, httpHeadersMock, httpMockFactory, httpResponseMock };
 //# sourceMappingURL=angular-toolbox.mjs.map