zibri 2.4.1 → 2.5.0

package/src/websocket/services/websocket.service.ts

@@ -1,3 +1,5 @@
+import assert from 'node:assert';
+
 import { Server, Socket } from 'socket.io';
 
 import { WebsocketSendData, WebsocketSendDataMessage, WebsocketSendToAllData, WebsocketSendToChannelData, WebsocketServiceInterface } from './websocket-service.interface';
@@ -17,6 +19,7 @@ import { toHttpError } from '../../error-handling/error-handler';
 import { BadRequestError } from '../../error-handling/errors/bad-request.error';
 import { HttpError, isHttpError } from '../../error-handling/errors/http.error';
 import { NotFoundError } from '../../error-handling/errors/not-found.error';
+import { UnauthorizedError } from '../../error-handling/errors/unauthorized.error';
 import { isError } from '../../error-handling/is-error.function';
 import { BeforeAppShutdown } from '../../global/before-app-shutdown.interface';
 import { GlobalRegistry } from '../../global/global-registry';
@@ -24,13 +27,17 @@ import { OnAppInit } from '../../global/on-app-init.interface';
 import { HttpStatus } from '../../http/http-status.enum';
 import { KnownHeader } from '../../http/known-header.enum';
 import { type LoggerInterface } from '../../logging/logger.interface';
-import { type ParserInterface } from '../../parsing/parser.interface';
 import { resolveRouteParams } from '../../routing/resolve-route-params.function';
 import { Newable } from '../../types/newable.type';
 import { JsonUtilities } from '../../utilities/json.utilities';
 import { MetadataUtilities } from '../../utilities/metadata.utilities';
+import { SemVerVersion } from '../../utilities/sem-ver.utilities';
 import { UUIDUtilities } from '../../utilities/uuid.utilities';
 import { type ValidationServiceInterface } from '../../validation/validation-service.interface';
+import { RouteWithVersionData } from '../../versioning/route-with-version-data.model';
+import { SupportedVersionsOptions } from '../../versioning/supported-versions-options.model';
+import { Version } from '../../versioning/version.model';
+import { type VersioningServiceInterface } from '../../versioning/versioning-service.interface';
 import { WebsocketControllerData } from '../decorators/websocket-controller.decorator';
 import { SocketIOWebsocketConnection } from '../models/connection/socket-io-websocket-connection.model';
 import { WebsocketChannel } from '../models/websocket-channel.model';
@@ -57,17 +64,25 @@ type SocketIOWebsocketHandler = (
 @Injectable({ register: 'onUse' })
 export class WebsocketService implements WebsocketServiceInterface<SocketIOWebsocketConnection>, OnAppInit, BeforeAppShutdown {
     private socketServer!: Server;
+    private readonly allEventRoutes: RouteWithVersionData[] = [];
     private readonly websocketHandlers: Record<string, SocketIOWebsocketHandler | undefined> = {};
     private readonly websocketChannels: Record<string, SocketIOWebsocketConnection[] | undefined> = {};
     private readonly connections: SocketIOWebsocketConnection[] = [];
 
+    private readonly pendingRouteGroups: Map<string, {
+        // eslint-disable-next-line jsdoc/require-jsdoc
+        entries: { versions: SupportedVersionsOptions, innerHandler: SocketIOWebsocketHandler }[]
+    }> = new Map();
+
+    private get versioningService(): VersioningServiceInterface {
+        return inject(ZIBRI_DI_TOKENS.VERSIONING_SERVICE);
+    }
+
     constructor(
         @Inject(ZIBRI_DI_TOKENS.LOGGER)
         private readonly logger: LoggerInterface,
         @Inject(ZIBRI_DI_TOKENS.AUTH_SERVICE)
         private readonly authService: AuthServiceInterface,
-        @Inject(ZIBRI_DI_TOKENS.PARSER)
-        private readonly parser: ParserInterface,
         @Inject(ZIBRI_DI_TOKENS.VALIDATION_SERVICE)
         private readonly validationService: ValidationServiceInterface,
         @InjectRepository(WebsocketChannel)
@@ -92,7 +107,44 @@ export class WebsocketService implements WebsocketServiceInterface<SocketIOWebso
         }
         this.checkForOrphanedControllers(app.options.websocketControllers);
 
-        this.socketServer.on('connection', socket => this.onConnect(socket));
+        for (const [event, group] of this.pendingRouteGroups.entries()) {
+            this.websocketHandlers[event] = this.createDispatchHandler(group.entries);
+            await this.logger.debug(`- mounting websocket event "${event}"`);
+        }
+
+        // eslint-disable-next-line typescript/no-misused-promises
+        this.socketServer.use(async (socket, next) => {
+            const request: WebsocketRequest = {
+                headers: socket.handshake.headers as Partial<Record<KnownHeader, string | undefined>>,
+                body: undefined,
+                query: socket.handshake.query as Partial<Record<string, string | undefined>>,
+                params: {}
+            };
+            const context: WebsocketRequestContext = new WebsocketRequestContext(request, undefined, undefined, undefined);
+
+            const currentUser: BaseUser<string> | undefined = await this.authService.getCurrentUser(
+                context,
+                this.authService.strategies,
+                false
+            );
+            if (!await this.options.isAllowedToConnect(currentUser)) {
+                next(new UnauthorizedError('Not allowed to connect'));
+                return;
+            }
+
+            try {
+                const version: Version = await this.versioningService.resolveVersion(context);
+                // eslint-disable-next-line typescript/no-unsafe-member-access
+                socket.data.resolvedVersion = version;
+                // eslint-disable-next-line typescript/no-unsafe-member-access
+                socket.data.currentUser = currentUser;
+                next();
+            }
+            catch (error) {
+                next(error instanceof Error ? error : new Error('Could not resolve version', { cause: error }));
+            }
+        });
+        this.socketServer.on('connection', async socket => await this.onConnect(socket));
     }
 
     // eslint-disable-next-line jsdoc/require-jsdoc
@@ -101,26 +153,12 @@ export class WebsocketService implements WebsocketServiceInterface<SocketIOWebso
     }
 
     private async onConnect(socket: Socket): Promise<void> {
-        const request: WebsocketRequest = {
-            headers: socket.handshake.headers as Partial<Record<KnownHeader, string | undefined>>,
-            body: undefined,
-            query: socket.handshake.query as Partial<Record<string, string | undefined>>,
-            params: {}
-        };
-        let connection: SocketIOWebsocketConnection | undefined = this.connections.find(c => c.id === socket.id);
-
-        const context: WebsocketRequestContext = new WebsocketRequestContext(request, connection, undefined, undefined);
-        const currentUser: BaseUser<string> | undefined = await this.authService.getCurrentUser(
-            context,
-            this.authService.strategies,
-            false
-        );
+        // eslint-disable-next-line typescript/no-unsafe-member-access
+        const currentUser: BaseUser<string> | undefined = socket.data.currentUser as BaseUser<string> | undefined;
+        // eslint-disable-next-line typescript/no-unsafe-member-access
+        const resolvedVersion: Version = socket.data.resolvedVersion as Version;
 
-        const isAllowedToConnect: boolean = await this.options.isAllowedToConnect(currentUser);
-        if (!isAllowedToConnect) {
-            socket.disconnect(true);
-            return;
-        }
+        let connection: SocketIOWebsocketConnection | undefined = this.connections.find(c => c.id === socket.id);
 
         if (connection) {
             connection.offset = socket.handshake.auth.offset as number;
@@ -128,7 +166,7 @@ export class WebsocketService implements WebsocketServiceInterface<SocketIOWebso
             return;
         }
 
-        connection = new SocketIOWebsocketConnection(socket, currentUser?.id);
+        connection = new SocketIOWebsocketConnection(socket, currentUser?.id, resolvedVersion);
         this.connections.push(connection);
         await this.logger.debug('a user connected');
 
@@ -284,6 +322,8 @@ export class WebsocketService implements WebsocketServiceInterface<SocketIOWebso
     // eslint-disable-next-line jsdoc/require-jsdoc
     async registerController(controllerClass: Newable<unknown>): Promise<void> {
         const controllerData: WebsocketControllerData | undefined = MetadataUtilities.getWebsocketControllerData(controllerClass);
+        const currentLatest: SemVerVersion | undefined = GlobalRegistry.getAppData('version');
+        assert(currentLatest);
         if (controllerData == undefined) {
             // eslint-disable-next-line stylistic/max-len
             throw new Error(`Could not find websocket controller data on class ${controllerClass.name}. Did you forget to decorate it with @WebsocketController?`);
@@ -291,19 +331,44 @@ export class WebsocketService implements WebsocketServiceInterface<SocketIOWebso
         const routes: WebsocketControllerRouteConfiguration[] = MetadataUtilities.getWebsocketControllerRoutes(controllerClass);
 
         for (const route of routes) {
-            const handler: SocketIOWebsocketHandler = this.controllerRouteToWebsocketHandler(
-                controllerClass,
-                route
+            const fullEvent: string = `${controllerData.eventPrefix}${route.event}`;
+            const versions: SupportedVersionsOptions = route.versions ?? controllerData.versions;
+
+            const overlappingRoute: RouteWithVersionData | undefined = this.allEventRoutes.find(
+                r => r.key === fullEvent && this.versioningService.hasOverlappingVersions(r.versions, versions, currentLatest)
             );
-            if (this.websocketHandlers[route.event]) {
-                throw new Error(
-                    `The websocket event "${route.event}" has been defined more than once.`,
-                    { cause: controllerClass }
+            if (overlappingRoute) {
+                const overlappingVersions: SupportedVersionsOptions = this.versioningService.findOverlappingVersions(
+                    overlappingRoute.versions,
+                    versions,
+                    currentLatest
                 );
+                if (overlappingVersions === 'all') {
+                    throw new Error([
+                        `The websocket event "${fullEvent}"`,
+                        'has been defined more than once.',
+                        '(versions: \'all\' has been used)'
+                    ].join(' '), { cause: controllerClass });
+                }
+                throw new Error([
+                    `The websocket event "${fullEvent}"`,
+                    `for the ${overlappingVersions.length > 1 ? 'versions' : 'version'} "${overlappingVersions.join(', ')}"`,
+                    'has been defined more than once.'
+                ].join(' '), { cause: controllerClass });
             }
-            await this.logger.debug(`- mounting websocket event "${route.event}"`);
 
-            this.websocketHandlers[route.event] = handler;
+            this.allEventRoutes.push({ key: fullEvent, versions });
+
+            const innerHandler: SocketIOWebsocketHandler = this.controllerRouteToWebsocketHandler(controllerClass, route);
+            // eslint-disable-next-line typescript/typedef
+            const existing = this.pendingRouteGroups.get(fullEvent);
+            if (existing) {
+                existing.entries.push({ versions, innerHandler });
+            }
+            else {
+                this.pendingRouteGroups.set(fullEvent, { entries: [{ versions, innerHandler }] });
+            }
+            await this.logger.debug(`- registering websocket event "${fullEvent}"`);
         }
     }
 
@@ -358,7 +423,7 @@ export class WebsocketService implements WebsocketServiceInterface<SocketIOWebso
     async sendToChannel<B extends boolean>(
         data: WebsocketSendToChannelData<B>
     ): Promise<B extends false ? void : WebsocketRequestWithConnection<SocketIOWebsocketConnection>[]> {
-        data.expectResponse ??= true as B;
+        data.expectResponse ??= false as B;
         const channel: WebsocketChannel = await this.channelRepository.findById(data.channelId);
 
         const message: WebsocketMessage = await this.createWebsocketMessage(
@@ -422,9 +487,9 @@ export class WebsocketService implements WebsocketServiceInterface<SocketIOWebso
 
     // eslint-disable-next-line jsdoc/require-jsdoc
     async sendToAll<B extends boolean>(
-        data: WebsocketSendToAllData<B>,
-        expectResponse: B = true as B
+        data: WebsocketSendToAllData<B>
     ): Promise<B extends false ? void : WebsocketRequestWithConnection<SocketIOWebsocketConnection>[]> {
+        data.expectResponse ??= false as B;
         const message: WebsocketMessage = await this.createWebsocketMessage(
             data.persist ?? true,
             data.message.ok
@@ -450,7 +515,7 @@ export class WebsocketService implements WebsocketServiceInterface<SocketIOWebso
             return undefined as B extends false ? void : WebsocketRequestWithConnection<SocketIOWebsocketConnection>[];
         }
 
-        if (!expectResponse) {
+        if (!data.expectResponse) {
             this.socketServer.emit(data.event, JsonUtilities.parse(JsonUtilities.stringify(message)));
             return undefined as B extends false ? void : WebsocketRequestWithConnection<SocketIOWebsocketConnection>[];
         }
@@ -514,7 +579,9 @@ export class WebsocketService implements WebsocketServiceInterface<SocketIOWebso
         }
         await connection.leave(channel.name);
 
-        const foundChannel: SocketIOWebsocketConnection | undefined = this.websocketChannels[channel.name]?.find(c => c.id === channel.id);
+        const foundChannel: SocketIOWebsocketConnection | undefined = this.websocketChannels[channel.name]?.find(
+            c => c.id === connection.id
+        );
         if (foundChannel) {
             // eslint-disable-next-line typescript/no-non-null-assertion
             this.websocketChannels[channel.name]!.splice(this.websocketChannels[channel.name]!.indexOf(foundChannel), 1);
@@ -544,6 +611,44 @@ export class WebsocketService implements WebsocketServiceInterface<SocketIOWebso
         return foundConnection;
     }
 
+    private createDispatchHandler(
+        // eslint-disable-next-line jsdoc/require-jsdoc
+        entries: { versions: SupportedVersionsOptions, innerHandler: SocketIOWebsocketHandler }[]
+    ): SocketIOWebsocketHandler {
+        return async (connection, req, responseHandler) => {
+            try {
+                // eslint-disable-next-line typescript/typedef
+                const match = entries.find(e => this.versioningService.matchesVersion(e.versions, connection.resolvedVersion));
+                if (!match) {
+                    const error: NotFoundError = new NotFoundError(
+                        `Could not find handler for websocket event for version "${connection.resolvedVersion.value}"`
+                    );
+                    await this.send({
+                        connection,
+                        event: WebsocketEvent.RESPONSE,
+                        message: { ok: false, error, status: error.status, senderUserId: undefined, senderConnectionId: undefined },
+                        responseHandler,
+                        expectResponse: true,
+                        persist: false
+                    });
+                    return;
+                }
+                await match.innerHandler(connection, req, responseHandler);
+            }
+            catch (error) {
+                const err: HttpError = toHttpError(error);
+                await this.send({
+                    connection,
+                    event: WebsocketEvent.RESPONSE,
+                    message: { ok: false, error: err, status: err.status, senderUserId: undefined, senderConnectionId: undefined },
+                    responseHandler,
+                    expectResponse: true,
+                    persist: false
+                });
+            }
+        };
+    }
+
     private async createWebsocketMessage(
         persist: boolean,
         messageData: CreateWebsocketMessageData | WebsocketMessage

package/dist/cjs/types/version.type.d.ts

@@ -1,5 +0,0 @@
-/**
- * Definition for a SemVer version.
- */
-export type Version = `${number}.${number}.${number}`;
-//# sourceMappingURL=version.type.d.ts.map

package/dist/cjs/types/version.type.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"version.type.d.ts","sourceRoot":"","sources":["../../../src/types/version.type.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC"}

package/dist/cjs/types/version.type.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"version.type.js","sourceRoot":"","sources":["../../../src/types/version.type.ts"],"names":[],"mappings":""}

package/dist/cjs/utilities/compare-versions.function.d.ts

@@ -1,9 +0,0 @@
-import { Version } from '../types/version.type';
-/**
- * Compares the given versions and check if the first one is bigger, equal or smaller than the second one.
- * @param v1 - The first version.
- * @param v2 - The second version to compare against.
- * @returns 'bigger', 'equal' or 'smaller'.
- */
-export declare function compareVersion(v1: Version, v2: Version): 'bigger' | 'equal' | 'smaller';
-//# sourceMappingURL=compare-versions.function.d.ts.map

package/dist/cjs/utilities/compare-versions.function.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"compare-versions.function.d.ts","sourceRoot":"","sources":["../../../src/utilities/compare-versions.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAwBvF"}

package/dist/cjs/utilities/compare-versions.function.js

@@ -1,33 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.compareVersion = compareVersion;
-/**
- * Compares the given versions and check if the first one is bigger, equal or smaller than the second one.
- * @param v1 - The first version.
- * @param v2 - The second version to compare against.
- * @returns 'bigger', 'equal' or 'smaller'.
- */
-function compareVersion(v1, v2) {
-    const [v1One, v1Two, v1Three] = v1;
-    const [v2One, v2Two, v2Three] = v2;
-    if (v1One > v2One) {
-        return 'bigger';
-    }
-    if (v1Two > v2Two) {
-        return 'bigger';
-    }
-    if (v1Three > v2Three) {
-        return 'bigger';
-    }
-    if (v2One > v1One) {
-        return 'smaller';
-    }
-    if (v2Two > v1Two) {
-        return 'smaller';
-    }
-    if (v2Three > v1Three) {
-        return 'smaller';
-    }
-    return 'equal';
-}
-//# sourceMappingURL=compare-versions.function.js.map

package/dist/cjs/utilities/compare-versions.function.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"compare-versions.function.js","sourceRoot":"","sources":["../../../src/utilities/compare-versions.function.ts"],"names":[],"mappings":";;AAQA,wCAwBC;AA9BD;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,EAAW,EAAE,EAAW;IACnD,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;IACnC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;IACnC,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;QAChB,OAAO,QAAQ,CAAC;IACpB,CAAC;IACD,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;QAChB,OAAO,QAAQ,CAAC;IACpB,CAAC;IACD,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;QACpB,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/dist/cjs/utilities/is-version.function.d.ts

@@ -1,7 +0,0 @@
-import { Version } from '../types/version.type';
-/**
- * Checks whether the given value is a valid SemVer Version.
- * @param value - The value to check.
- */
-export declare function isVersion(value: string): value is Version;
-//# sourceMappingURL=is-version.function.d.ts.map

package/dist/cjs/utilities/is-version.function.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"is-version.function.d.ts","sourceRoot":"","sources":["../../../src/utilities/is-version.function.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGhD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,OAAO,CAOzD"}

package/dist/cjs/utilities/is-version.function.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isVersion = isVersion;
-const is_numeric_function_1 = require("./is-numeric.function");
-// eslint-disable-next-line jsdoc/require-returns
-/**
- * Checks whether the given value is a valid SemVer Version.
- * @param value - The value to check.
- */
-function isVersion(value) {
-    const parts = value.split('.');
-    if (parts.length !== 3) {
-        return false;
-    }
-    const [one, two, three] = parts;
-    return (0, is_numeric_function_1.isNumeric)(one) && (0, is_numeric_function_1.isNumeric)(two) && (0, is_numeric_function_1.isNumeric)(three);
-}
-//# sourceMappingURL=is-version.function.js.map

package/dist/cjs/utilities/is-version.function.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"is-version.function.js","sourceRoot":"","sources":["../../../src/utilities/is-version.function.ts"],"names":[],"mappings":";;AAQA,8BAOC;AAfD,+DAAkD;AAGlD,iDAAiD;AACjD;;;GAGG;AACH,SAAgB,SAAS,CAAC,KAAa;IACnC,MAAM,KAAK,GAAa,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC;IAChC,OAAO,IAAA,+BAAS,EAAC,GAAG,CAAC,IAAI,IAAA,+BAAS,EAAC,GAAG,CAAC,IAAI,IAAA,+BAAS,EAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/esm/types/version.type.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"version.type.js","sourceRoot":"","sources":["../../../src/types/version.type.ts"],"names":[],"mappings":""}

package/dist/esm/utilities/compare-versions.function.js

@@ -1,33 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.compareVersion = compareVersion;
-/**
- * Compares the given versions and check if the first one is bigger, equal or smaller than the second one.
- * @param v1 - The first version.
- * @param v2 - The second version to compare against.
- * @returns 'bigger', 'equal' or 'smaller'.
- */
-function compareVersion(v1, v2) {
-    const [v1One, v1Two, v1Three] = v1;
-    const [v2One, v2Two, v2Three] = v2;
-    if (v1One > v2One) {
-        return 'bigger';
-    }
-    if (v1Two > v2Two) {
-        return 'bigger';
-    }
-    if (v1Three > v2Three) {
-        return 'bigger';
-    }
-    if (v2One > v1One) {
-        return 'smaller';
-    }
-    if (v2Two > v1Two) {
-        return 'smaller';
-    }
-    if (v2Three > v1Three) {
-        return 'smaller';
-    }
-    return 'equal';
-}
-//# sourceMappingURL=compare-versions.function.js.map

package/dist/esm/utilities/compare-versions.function.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"compare-versions.function.js","sourceRoot":"","sources":["../../../src/utilities/compare-versions.function.ts"],"names":[],"mappings":";;AAQA,wCAwBC;AA9BD;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,EAAW,EAAE,EAAW;IACnD,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;IACnC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;IACnC,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;QAChB,OAAO,QAAQ,CAAC;IACpB,CAAC;IACD,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;QAChB,OAAO,QAAQ,CAAC;IACpB,CAAC;IACD,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;QACpB,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/dist/esm/utilities/is-version.function.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isVersion = isVersion;
-const is_numeric_function_1 = require("./is-numeric.function");
-// eslint-disable-next-line jsdoc/require-returns
-/**
- * Checks whether the given value is a valid SemVer Version.
- * @param value - The value to check.
- */
-function isVersion(value) {
-    const parts = value.split('.');
-    if (parts.length !== 3) {
-        return false;
-    }
-    const [one, two, three] = parts;
-    return (0, is_numeric_function_1.isNumeric)(one) && (0, is_numeric_function_1.isNumeric)(two) && (0, is_numeric_function_1.isNumeric)(three);
-}
-//# sourceMappingURL=is-version.function.js.map

package/dist/esm/utilities/is-version.function.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"is-version.function.js","sourceRoot":"","sources":["../../../src/utilities/is-version.function.ts"],"names":[],"mappings":";;AAQA,8BAOC;AAfD,+DAAkD;AAGlD,iDAAiD;AACjD;;;GAGG;AACH,SAAgB,SAAS,CAAC,KAAa;IACnC,MAAM,KAAK,GAAa,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC;IAChC,OAAO,IAAA,+BAAS,EAAC,GAAG,CAAC,IAAI,IAAA,+BAAS,EAAC,GAAG,CAAC,IAAI,IAAA,+BAAS,EAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/src/types/version.type.ts

@@ -1,4 +0,0 @@
-/**
- * Definition for a SemVer version.
- */
-export type Version = `${number}.${number}.${number}`;

package/src/utilities/compare-versions.function.ts

@@ -1,33 +0,0 @@
-import { Version } from '../types/version.type';
-
-/**
- * Compares the given versions and check if the first one is bigger, equal or smaller than the second one.
- * @param v1 - The first version.
- * @param v2 - The second version to compare against.
- * @returns 'bigger', 'equal' or 'smaller'.
- */
-export function compareVersion(v1: Version, v2: Version): 'bigger' | 'equal' | 'smaller' {
-    const [v1One, v1Two, v1Three] = v1;
-    const [v2One, v2Two, v2Three] = v2;
-    if (v1One > v2One) {
-        return 'bigger';
-    }
-    if (v1Two > v2Two) {
-        return 'bigger';
-    }
-    if (v1Three > v2Three) {
-        return 'bigger';
-    }
-
-    if (v2One > v1One) {
-        return 'smaller';
-    }
-    if (v2Two > v1Two) {
-        return 'smaller';
-    }
-    if (v2Three > v1Three) {
-        return 'smaller';
-    }
-
-    return 'equal';
-}

package/src/utilities/is-version.function.ts

@@ -1,16 +0,0 @@
-import { isNumeric } from './is-numeric.function';
-import { Version } from '../types/version.type';
-
-// eslint-disable-next-line jsdoc/require-returns
-/**
- * Checks whether the given value is a valid SemVer Version.
- * @param value - The value to check.
- */
-export function isVersion(value: string): value is Version {
-    const parts: string[] = value.split('.');
-    if (parts.length !== 3) {
-        return false;
-    }
-    const [one, two, three] = parts;
-    return isNumeric(one) && isNumeric(two) && isNumeric(three);
-}