angular-toolbox 0.9.1 → 0.9.3

package/lib/core/abstract/abstract-subscription-manager.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @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
+ */
+import { Subscription } from 'rxjs';
+import { Identifiable, SubscriptionManager } from '../../model';
+/**
+ * The abstract class for all services that implement the `SubscriptionManager` interface.
+ */
+export declare abstract class AbstractSubscriptionManager implements SubscriptionManager {
+    /**
+     * @private
+     * Stores an internal reference to the last reference used with the `register()`
+     * method.
+     */
+    private _lastRef;
+    /**
+     * @private
+     * The internal `Subscription` instances storage.
+     */
+    private _subMap;
+    /**
+     * 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: string | Identifiable, subscription: Subscription): SubscriptionManager;
+    /**
+     * 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: Subscription): SubscriptionManager;
+    /**
+     * 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: string | Identifiable): boolean;
+    /**
+     * 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: string | Identifiable): Array<Subscription> | 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.
+     */
+    private getRef;
+}

package/lib/core/abstract/abstract-version-manager.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @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
+ */
+import { Version, VersionConfig, VersionManager } from "../../model";
+/**
+ * The abstract class for all services that implement the `VersionManager` interface.
+ */
+export declare abstract class AbstractVersionManager implements VersionManager {
+    /**
+     * @private
+     */
+    private readonly _version;
+    /**
+     * Creates a new VersionManager object.
+     * @param config the reference to the VersionConfig provider.
+     */
+    constructor(config: VersionConfig);
+    /**
+     * Returns the version of the associated Angular project.
+     *
+     * @return the version of the associated Angular project.
+     */
+    getVersion(): Version;
+    /**
+     * Returns the build timestamp of the associated Angular project.
+     *
+     * @return the  build timestamp of the associated Angular project.
+     */
+    getBuildTimestamp(): number;
+}

package/lib/core/abstract/index.d.ts

@@ -0,0 +1,2 @@
+export * from './abstract-subscription-manager';
+export * from './abstract-version-manager';

package/lib/core/impl/lang/identifiable-component.d.ts

@@ -13,14 +13,32 @@ import { Uuid } from "../../../util";
  * Angular Toolbox Subscription Service.
  */
 export declare class IdentifiableComponent implements Identifiable {
+    /**
+     * @private
+     */
+    private readonly _classRef;
     /**
      * @private
      */
     private readonly _uuid;
+    /**
+     * 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?: string | undefined);
     /**
      * Returns the unique identifier for this object.
      *
      * @returns An instance of the `Uuid` class.
      */
     getID(): 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(): string;
 }

package/lib/core/index.d.ts

@@ -1,2 +1,3 @@
 export * from './error';
 export * from './impl';
+export * from './abstract';

package/lib/model/business/index.d.ts

@@ -2,3 +2,4 @@ export * from './version';
 export * from './ui';
 export * from './lang';
 export * from './mock/http';
+export * from './subscription';

package/lib/model/business/lang/identifiable.d.ts

@@ -16,4 +16,11 @@ export interface Identifiable {
      * @returns An instance of the `Uuid` class.
      */
     getID(): Uuid;
+    /**
+     * Returns the class name reference of this object.
+     * This can be useful to workaround TypeScript compilation obfuscation.
+     *
+     * @returns the class name reference of this object.
+     */
+    getClassRef(): string;
 }

package/lib/model/business/subscription/index.d.ts

@@ -0,0 +1 @@
+export * from './subscription-manager';

package/lib/model/business/subscription/subscription-manager.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @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
+ */
+import { Subscription } from 'rxjs';
+import { Identifiable } from '../lang';
+/**
+ * Defines the API to implement to create Angular subscription management objects.
+ */
+export interface SubscriptionManager {
+    /**
+     * 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 `SubscriptionManager` object.
+     */
+    register(ref: string | Identifiable, subscription: Subscription): SubscriptionManager;
+    /**
+     * 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 `SubscriptionManager` object.
+     */
+    append(subscription: Subscription): SubscriptionManager;
+    /**
+     * 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: string | Identifiable): boolean;
+    /**
+     * 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: string | Identifiable): Array<Subscription> | null;
+}

package/lib/model/business/version/index.d.ts

@@ -1,3 +1,4 @@
 export * from './version';
 export * from './version-config';
 export * from './version-config.provider';
+export * from './version-manager';

package/lib/model/business/version/version-manager.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @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
+ */
+import { Version } from "./version";
+/**
+ * The interface implemented by services that specifie the semantic versioning of an Angular application.
+ */
+export interface VersionManager {
+    /**
+     * Returns the version of the associated Angular project.
+     *
+     * @return the version of the associated Angular project.
+     */
+    getVersion(): Version;
+    /**
+     * Returns the build timestamp of the associated Angular project.
+     *
+     * @return the  build timestamp of the associated Angular project.
+     */
+    getBuildTimestamp(): number;
+}

package/lib/model/service/subscription/subscription.service.d.ts

@@ -1,66 +1,10 @@
-import { Subscription } from 'rxjs';
-import { Identifiable } from '../../business';
+import { AbstractSubscriptionManager } from '../../../core';
 import * as i0 from "@angular/core";
-export declare class SubscriptionService {
+export declare class SubscriptionService extends AbstractSubscriptionManager {
     /**
      * @private
-     * Stores an internal reference to the last reference used with the `register()`
-     * method.
      */
-    private _lastRef;
-    /**
-     * @private
-     * The internal `Subscription` instances storage.
-     */
-    private _subMap;
-    /**
-     * 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: string | Identifiable, subscription: Subscription): SubscriptionService;
-    /**
-     * 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: Subscription): SubscriptionService;
-    /**
-     * 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: string | Identifiable): boolean;
-    /**
-     * 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: string | Identifiable): Array<Subscription> | 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.
-     */
-    private getRef;
+    constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<SubscriptionService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SubscriptionService>;
 }

package/lib/model/service/version/version.service.d.ts

@@ -1,30 +1,15 @@
-import { Version, VersionConfig } from '../../business';
+import { VersionConfig, VersionManager } from '../../business';
+import { AbstractVersionManager } from '../../../core';
 import * as i0 from "@angular/core";
 /**
  * A lightweight service that provides Semantic Versioning implementation for your Angular projects.
  */
-export declare class VersionService {
-    /**
-     * @private
-     */
-    private readonly _version;
+export declare class VersionService extends AbstractVersionManager implements VersionManager {
     /**
      * Creates a new VersionService instance.
      * @param config the reference to the VersionConfig provider.
      */
     constructor(config: VersionConfig);
-    /**
-     * Returns the version of the associated Angular project.
-     *
-     * @return the version of the associated Angular project.
-     */
-    getVersion(): Version;
-    /**
-     * Returns the build timestamp of the associated Angular project.
-     *
-     * @return the  build timestamp of the associated Angular project.
-     */
-    getBuildTimestamp(): number;
     static ɵfac: i0.ɵɵFactoryDeclaration<VersionService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<VersionService>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "angular-toolbox",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "license": "SEE LICENSE IN LICENSE",
   "peerDependencies": {
     "@angular/common": "^18.0.0",