zibri 2.4.1 → 2.5.0

package/dist/cjs/versioning/versioning.service.js

@@ -0,0 +1,366 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersioningService = void 0;
+const websocket_request_context_1 = require("../context/request/websocket-request.context");
+const inject_decorator_1 = require("../di/decorators/inject.decorator");
+const injectable_decorator_1 = require("../di/decorators/injectable.decorator");
+const zibri_di_tokens_default_1 = require("../di/default/zibri-di-tokens.default");
+const bad_request_error_1 = require("../error-handling/errors/bad-request.error");
+const fs_utilities_1 = require("../utilities/fs.utilities");
+const is_date_function_1 = require("../utilities/is-date.function");
+const json_utilities_1 = require("../utilities/json.utilities");
+const metadata_utilities_1 = require("../utilities/metadata.utilities");
+const sem_ver_utilities_1 = require("../utilities/sem-ver.utilities");
+const ROUTE_VERSION_MISMATCH_ERROR_MESSAGE = 'Route version mismatch detected:';
+/**
+ * Default implementation of the versioning service.
+ */
+let VersioningService = class VersioningService {
+    versionHeader;
+    router;
+    versionsPath = fs_utilities_1.FsUtilities.getPath(__dirname, '..', 'versions');
+    versionFiles = [];
+    constructor(versionHeader, router) {
+        this.versionHeader = versionHeader;
+        this.router = router;
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    async afterAppInit(app) {
+        await fs_utilities_1.FsUtilities.mkdir(this.versionsPath);
+        this.versionFiles = await this.loadAllVersionFiles();
+        const currentLatestVersions = this.versionFiles.filter(v => v.endsAt == undefined);
+        if (currentLatestVersions.length === 1 && currentLatestVersions.at(0)?.value === app.options.version) {
+            // is already at the latest version, doesn't need to do anything.
+            return;
+        }
+        if (!this.versionFiles.length) {
+            await this.createVersionFile({
+                startsAt: new Date(),
+                value: app.options.version,
+                routes: this.getAllRoutes(app)
+            });
+            this.versionFiles = await this.loadAllVersionFiles();
+            return;
+        }
+        const currentLatest = this.resolveCurrentLatest(currentLatestVersions, app);
+        const inCodeRoutes = this.getAllRoutes(app);
+        const storedRoutes = currentLatest ? currentLatest.routes : [];
+        this.validateNoDowngrade(app);
+        this.validateRouteVersionSnapshot(inCodeRoutes, storedRoutes, this.versionFiles, currentLatest?.value, app.options.version);
+        this.validateRouteVersionsExist(inCodeRoutes, this.versionFiles, app.options.version);
+        this.validateLatestRoutes(inCodeRoutes, app.options.version, this.versionFiles);
+        // Create new version file (deprecate the old one)
+        const transitionTime = new Date();
+        const newVersion = this.versionFiles.find(v => v.value === app.options.version);
+        if (newVersion != undefined) {
+            // Sort old active versions (excluding the new one) by startsAt
+            const oldActives = currentLatestVersions
+                .filter(v => v.value !== app.options.version)
+                .sort((a, b) => new Date(a.startsAt).getTime() - new Date(b.startsAt).getTime());
+            // Chain the end dates: each old version ends when the next one starts
+            for (let i = 0; i < oldActives.length; i++) {
+                const nextStart = i < oldActives.length - 1
+                    ? new Date(oldActives[i + 1].startsAt)
+                    : new Date(newVersion.startsAt);
+                await this.updateVersionFile(oldActives[i], { endsAt: nextStart });
+            }
+            // Ensure the new file’s routes are up to date
+            await this.updateVersionFile(newVersion, { routes: inCodeRoutes });
+            this.versionFiles = await this.loadAllVersionFiles();
+            return;
+        }
+        await this.createVersionFile({
+            value: app.options.version,
+            startsAt: transitionTime,
+            routes: inCodeRoutes
+        });
+        for (const active of currentLatestVersions) {
+            await this.updateVersionFile(active, { endsAt: transitionTime });
+        }
+        this.versionFiles = await this.loadAllVersionFiles();
+    }
+    validateNoDowngrade(app) {
+        const latestVersion = this.versionFiles.reduce((max, v) => sem_ver_utilities_1.SemVerUtilities.compare(v.value, max.value) === 'bigger' ? v : max);
+        if (sem_ver_utilities_1.SemVerUtilities.compare(latestVersion.value, app.options.version) === 'bigger') {
+            throw new Error([
+                `Version "${app.options.version}" was previously active but has been superseded by "${latestVersion.value}".`,
+                'Downgrading is not supported automatically. To resolve this, either:',
+                '- Revert your code and version files together via git',
+                `- Manually delete and update version files so that "${app.options.version}" is treated as a fresh version`
+            ].join('\n'));
+        }
+    }
+    resolveCurrentLatest(currentLatestVersions, app) {
+        if (currentLatestVersions.length === 1) {
+            return currentLatestVersions.at(0);
+        }
+        if (currentLatestVersions.length < 1) {
+            return this.versionFiles.reduce((max, v) => sem_ver_utilities_1.SemVerUtilities.compare(v.value, max.value) === 'bigger' ? v : max);
+        }
+        const currentLatest = currentLatestVersions.find(v => v.value !== app.options.version);
+        if (!currentLatest) {
+            throw new Error('Inconsistent version state: multiple active versions exist, but they all represent the global version.'
+                + ' Check for duplicate version files.');
+        }
+        return currentLatest;
+    }
+    async loadAllVersionFiles() {
+        const entries = await fs_utilities_1.FsUtilities.readdir(fs_utilities_1.FsUtilities.getPath(this.versionsPath));
+        const res = await Promise.all(entries.map(async (e) => {
+            if (!e.isFile() || !e.name.endsWith('.json')) {
+                return undefined;
+            }
+            const raw = await fs_utilities_1.FsUtilities.readFile(fs_utilities_1.FsUtilities.getPath(e.parentPath, e.name));
+            return json_utilities_1.JsonUtilities.parse(raw);
+        }));
+        return res.filter(Boolean);
+    }
+    async createVersionFile(data) {
+        await fs_utilities_1.FsUtilities.createFile(fs_utilities_1.FsUtilities.getPath(this.versionsPath, `${data.value}.json`), json_utilities_1.JsonUtilities.stringify(data));
+    }
+    async updateVersionFile(versionFile, data) {
+        const updated = { ...versionFile, ...data };
+        await fs_utilities_1.FsUtilities.updateFile(fs_utilities_1.FsUtilities.getPath(this.versionsPath, `${versionFile.value}.json`), json_utilities_1.JsonUtilities.stringify(updated), 'replace');
+    }
+    validateRouteVersionSnapshot(inCodeRoutes, storedRoutes, versionFiles, currentLatest, newVersion) {
+        if (!currentLatest) {
+            return;
+        }
+        const knownVersions = new Set(versionFiles.map(e => e.value));
+        const errors = [];
+        for (const storedRoute of storedRoutes) {
+            const routes = inCodeRoutes.filter(r => r.key === storedRoute.key);
+            if (!routes.length) {
+                errors.push(`Route "${storedRoute.key}" no longer exists in code.`);
+                continue;
+            }
+            const removedVersions = this.getRemovedVersions(storedRoute.versions, routes.some(r => r.versions === 'all')
+                ? 'all'
+                : routes.flatMap(r => r.versions === 'all' ? [] : r.versions), [...knownVersions], currentLatest, newVersion);
+            if (!removedVersions.length) {
+                continue;
+            }
+            const versionLabel = removedVersions.length > 1 ? 'versions' : 'version';
+            errors.push(`Route "${storedRoute.key}" removed ${versionLabel}: ${removedVersions.join(', ')}`);
+        }
+        if (errors.length) {
+            throw new Error([ROUTE_VERSION_MISMATCH_ERROR_MESSAGE, ...errors.map(error => `- ${error}`)].join('\n'));
+        }
+    }
+    getRemovedVersions(previous, current, knownVersions, currentLatest, newVersion) {
+        const previousResolved = this.resolveConcreteVersions(previous, knownVersions, currentLatest);
+        const currentResolved = this.resolveConcreteVersions(current, knownVersions, newVersion);
+        return previousResolved.filter(v => !currentResolved.includes(v));
+    }
+    resolveConcreteVersions(versions, knownVersions, currentLatest) {
+        if (versions === 'all') {
+            return [...knownVersions];
+        }
+        const resolvedMatchers = versions.map(v => this.versionMatcherToSemVerMatcher(v, currentLatest));
+        return knownVersions.filter(version => sem_ver_utilities_1.SemVerUtilities.matches(version, resolvedMatchers));
+    }
+    validateRouteVersionsExist(inCodeRoutes, versionFiles, newVersion) {
+        const knownVersions = versionFiles.map(v => v.value);
+        const candidateVersions = [...knownVersions, newVersion];
+        const errors = [];
+        // eslint-disable-next-line typescript/typedef
+        const validateRoute = (route, latest, location) => {
+            if (route.versions === 'all') {
+                return;
+            }
+            for (const matcher of route.versions) {
+                const resolvedMatcher = this.versionMatcherToSemVerMatcher(matcher, latest);
+                const matchesAny = candidateVersions.some(version => sem_ver_utilities_1.SemVerUtilities.matches(version, [resolvedMatcher]));
+                if (!matchesAny) {
+                    errors.push(`Unknown version "${matcher}" ${location}`);
+                }
+            }
+        };
+        for (const file of versionFiles) {
+            for (const route of file.routes) {
+                validateRoute(route, file.value, `in version file "${file.value}.json" on route "${route.key}"`);
+            }
+        }
+        if (errors.length) {
+            throw new Error([ROUTE_VERSION_MISMATCH_ERROR_MESSAGE, ...errors.map(error => `- ${error}`)].join('\n'));
+        }
+        for (const route of inCodeRoutes) {
+            validateRoute(route, newVersion, `on route "${route.key}"`);
+        }
+        if (errors.length) {
+            throw new Error([ROUTE_VERSION_MISMATCH_ERROR_MESSAGE, ...errors.map(error => `- ${error}`)].join('\n'));
+        }
+    }
+    validateLatestRoutes(inCodeRoutes, currentVersion, allVersionFiles) {
+        const previousCandidates = allVersionFiles.filter(v => v.endsAt == undefined && v.value !== currentVersion);
+        if (previousCandidates.length === 0) {
+            return;
+        }
+        const previousLatest = previousCandidates.reduce((max, v) => new Date(v.startsAt) > new Date(max.startsAt) ? v : max);
+        const previousRoutesByKey = new Map(previousLatest.routes.map(route => [route.key, route]));
+        const routesThatNeedUpdate = inCodeRoutes.filter(r => {
+            if (r.versions === 'all') {
+                return false;
+            }
+            const usesLatestAlias = r.versions.some(v => v === 'latest' || v === '^latest' || v === '~latest');
+            if (!usesLatestAlias) {
+                return false;
+            }
+            const previousRoute = previousRoutesByKey.get(r.key);
+            if (!previousRoute || previousRoute.versions === 'all') {
+                return true;
+            }
+            return !this.routeSupportsVersion(previousRoute, previousLatest.value, previousLatest.value);
+        });
+        if (routesThatNeedUpdate.length) {
+            throw new Error([
+                `There are routes that have been used under the previous version "${previousLatest.value}"`,
+                'To continue, you either need to:',
+                '- Define that the route supports the previous version as well as \'latest\'',
+                '- Define that it only supports the previous version and optionally create a separate endpoint for the new version',
+                'This can be done on the @Get/@Post etc. decorators or on the @Controller/@WebsocketController decorators',
+                '',
+                'Affected routes/websocket events:',
+                ...routesThatNeedUpdate.map(r => `- ${r.key}`)
+            ].join('\n'));
+        }
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    resolveVersion(context) {
+        const versionValue = context instanceof websocket_request_context_1.WebsocketRequestContext
+            ? context.connection?.resolvedVersion.value ?? context.request.headers?.[this.versionHeader]
+            : context.request.headers?.[this.versionHeader];
+        try {
+            if (versionValue == undefined) {
+                const latest = this.versionFiles.find(v => v.endsAt == undefined);
+                if (!latest) {
+                    throw new bad_request_error_1.BadRequestError('No active version found');
+                }
+                return latest;
+            }
+            if ((0, is_date_function_1.isDate)(versionValue)) {
+                return this.resolveVersionForDate(new Date(versionValue), this.versionFiles);
+            }
+            const res = this.versionFiles.find(v => v.value === versionValue);
+            if (!res) {
+                throw new bad_request_error_1.BadRequestError(`Version "${versionValue}" not found`);
+            }
+            return res;
+        }
+        catch (error) {
+            if (error instanceof bad_request_error_1.BadRequestError) {
+                throw error;
+            }
+            throw new bad_request_error_1.BadRequestError('Could not resolve version');
+        }
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    findOverlappingVersions(a, b, currentLatest) {
+        if (a === 'all' || b === 'all') {
+            return 'all';
+        }
+        const resolvedA = a.map(v => this.versionMatcherToSemVerMatcher(v, currentLatest));
+        const resolvedB = b.map(v => this.versionMatcherToSemVerMatcher(v, currentLatest));
+        return resolvedA.filter(v => sem_ver_utilities_1.SemVerUtilities.matches(v, resolvedB));
+    }
+    versionMatcherToSemVerMatcher(version, currentLatest) {
+        if (version === 'latest') {
+            return currentLatest;
+        }
+        if (version === '^latest') {
+            return `^${currentLatest}`;
+        }
+        if (version === '~latest') {
+            return `~${currentLatest}`;
+        }
+        return version;
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    hasOverlappingVersions(a, b, currentLatest) {
+        const result = this.findOverlappingVersions(a, b, currentLatest);
+        return result === 'all' || !!result.length;
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    matchesVersion(versions, resolvedVersion) {
+        if (versions === 'all') {
+            return true;
+        }
+        const latest = this.versionFiles.find(v => v.endsAt == undefined);
+        if (!latest) {
+            throw new bad_request_error_1.BadRequestError('No active version found');
+        }
+        const resolvedMatchers = versions.map(v => this.versionMatcherToSemVerMatcher(v, latest.value));
+        return sem_ver_utilities_1.SemVerUtilities.matches(resolvedVersion.value, resolvedMatchers);
+    }
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    getVersions() {
+        return this.versionFiles;
+    }
+    resolveVersionForDate(date, allVersions) {
+        const res = allVersions.find(v => {
+            return (new Date(v.startsAt).getTime() <= date.getTime())
+                && (v.endsAt == undefined || new Date(v.endsAt).getTime() > date.getTime());
+        });
+        if (!res) {
+            throw new bad_request_error_1.BadRequestError('No version active at that date');
+        }
+        return res;
+    }
+    routeSupportsVersion(route, version, latestContext) {
+        if (route.versions === 'all') {
+            return true;
+        }
+        const resolved = route.versions.map(v => this.versionMatcherToSemVerMatcher(v, latestContext));
+        return sem_ver_utilities_1.SemVerUtilities.matches(version, resolved);
+    }
+    getAllRoutes(app) {
+        const allRoutes = [
+            ...this.router.manuallyRegisteredRoutes.map(r => ({ key: `${r.httpMethod.toUpperCase()} ${r.route}`, versions: r.versions })),
+            ...app.options.controllers.flatMap(c => {
+                const controllerData = metadata_utilities_1.MetadataUtilities.getControllerData(c);
+                if (!controllerData) {
+                    throw new Error('Could not resolve controller data');
+                }
+                const routes = metadata_utilities_1.MetadataUtilities.getControllerRoutes(c);
+                return routes.map(r => ({
+                    versions: r.versions ?? controllerData.versions,
+                    key: controllerData.baseRoute === '/'
+                        ? `${r.httpMethod.toUpperCase()} ${r.route}`
+                        : `${r.httpMethod.toUpperCase()} ${controllerData.baseRoute}${r.route}`
+                }));
+            }),
+            ...app.options.websocketControllers.flatMap(c => {
+                const controllerData = metadata_utilities_1.MetadataUtilities.getWebsocketControllerData(c);
+                if (!controllerData) {
+                    throw new Error('Could not resolve controller data');
+                }
+                const routes = metadata_utilities_1.MetadataUtilities.getWebsocketControllerRoutes(c);
+                return routes.map(r => ({
+                    versions: r.versions ?? controllerData.versions,
+                    key: `${controllerData.eventPrefix}${r.event}`
+                }));
+            })
+        ];
+        return allRoutes;
+    }
+};
+exports.VersioningService = VersioningService;
+exports.VersioningService = VersioningService = __decorate([
+    (0, injectable_decorator_1.Injectable)({ register: 'onUse' }),
+    __param(0, (0, inject_decorator_1.Inject)(zibri_di_tokens_default_1.ZIBRI_DI_TOKENS.VERSION_HEADER)),
+    __param(1, (0, inject_decorator_1.Inject)(zibri_di_tokens_default_1.ZIBRI_DI_TOKENS.ROUTER)),
+    __metadata("design:paramtypes", [String, Object])
+], VersioningService);
+//# sourceMappingURL=versioning.service.js.map

package/dist/cjs/versioning/versioning.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.service.js","sourceRoot":"","sources":["../../../src/versioning/versioning.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAQA,4FAAuF;AACvF,wEAA2D;AAC3D,gFAAmE;AACnE,mFAAwE;AACxE,kFAA6E;AAO7E,4DAAgE;AAChE,oEAAuD;AACvD,gEAA4D;AAC5D,wEAAoE;AACpE,sEAAgF;AAIhF,MAAM,oCAAoC,GAAW,kCAAkC,CAAC;AAExF;;GAEG;AAEI,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAOL;IAEA;IAPJ,YAAY,GAAW,0BAAW,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IACjF,YAAY,GAAkB,EAAE,CAAC;IAEzC,YAEqB,aAAqB,EAErB,MAAuB;QAFvB,kBAAa,GAAb,aAAa,CAAQ;QAErB,WAAM,GAAN,MAAM,CAAiB;IACzC,CAAC;IAEJ,+CAA+C;IAC/C,KAAK,CAAC,YAAY,CAAC,GAAqB;QACpC,MAAM,0BAAW,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3C,IAAI,CAAC,YAAY,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACrD,MAAM,qBAAqB,GAAkB,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC;QAElG,IAAI,qBAAqB,CAAC,MAAM,KAAK,CAAC,IAAI,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACnG,iEAAiE;YACjE,OAAO;QACX,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,iBAAiB,CAAC;gBACzB,QAAQ,EAAE,IAAI,IAAI,EAAE;gBACpB,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO;gBAC1B,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC;aACjC,CAAC,CAAC;YACH,IAAI,CAAC,YAAY,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACrD,OAAO;QACX,CAAC;QAED,MAAM,aAAa,GAA4B,IAAI,CAAC,oBAAoB,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;QACrG,MAAM,YAAY,GAA2B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACpE,MAAM,YAAY,GAA2B,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAEvF,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,4BAA4B,CAAC,YAAY,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5H,IAAI,CAAC,0BAA0B,CAAC,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACtF,IAAI,CAAC,oBAAoB,CAAC,YAAY,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAEhF,kDAAkD;QAClD,MAAM,cAAc,GAAS,IAAI,IAAI,EAAE,CAAC;QACxC,MAAM,UAAU,GAA4B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAEzG,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;YAC1B,+DAA+D;YAC/D,MAAM,UAAU,GAAkB,qBAAqB;iBAClD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC;iBAC5C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAErF,sEAAsE;YACtE,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACjD,MAAM,SAAS,GAAS,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC;oBAC7C,CAAC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;oBACtC,CAAC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;gBACpC,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YACvE,CAAC;YAED,8CAA8C;YAC9C,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;YACnE,IAAI,CAAC,YAAY,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACrD,OAAO;QACX,CAAC;QAED,MAAM,IAAI,CAAC,iBAAiB,CAAC;YACzB,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO;YAC1B,QAAQ,EAAE,cAAc;YACxB,MAAM,EAAE,YAAY;SACvB,CAAC,CAAC;QAEH,KAAK,MAAM,MAAM,IAAI,qBAAqB,EAAE,CAAC;YACzC,MAAM,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;IACzD,CAAC;IAEO,mBAAmB,CAAC,GAAqB;QAC7C,MAAM,aAAa,GAAgB,IAAI,CAAC,YAAY,CAAC,MAAM,CACvD,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,mCAAe,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CACjF,CAAC;QACF,IAAI,mCAAe,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YACjF,MAAM,IAAI,KAAK,CACX;gBACI,YAAY,GAAG,CAAC,OAAO,CAAC,OAAO,uDAAuD,aAAa,CAAC,KAAK,IAAI;gBAC7G,sEAAsE;gBACtE,uDAAuD;gBACvD,uDAAuD,GAAG,CAAC,OAAO,CAAC,OAAO,iCAAiC;aAC9G,CAAC,IAAI,CAAC,IAAI,CAAC,CACf,CAAC;QACN,CAAC;IACL,CAAC;IAEO,oBAAoB,CAAC,qBAAoC,EAAE,GAAqB;QACpF,IAAI,qBAAqB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,mCAAe,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACpH,CAAC;QAED,MAAM,aAAa,GAA4B,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAChH,IAAI,CAAC,aAAa,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACX,wGAAwG;kBACtG,qCAAqC,CAC1C,CAAC;QACN,CAAC;QACD,OAAO,aAAa,CAAC;IACzB,CAAC;IAEO,KAAK,CAAC,mBAAmB;QAC7B,MAAM,OAAO,GAAa,MAAM,0BAAW,CAAC,OAAO,CAAC,0BAAW,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QAC5F,MAAM,GAAG,GAAgC,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAC,CAAC,EAAC,EAAE;YAC7E,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3C,OAAO,SAAS,CAAC;YACrB,CAAC;YACD,MAAM,GAAG,GAAW,MAAM,0BAAW,CAAC,QAAQ,CAAC,0BAAW,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1F,OAAO,8BAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC,CAAC;QACJ,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,CAAkB,CAAC;IAChD,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,IAAiB;QAC7C,MAAM,0BAAW,CAAC,UAAU,CACxB,0BAAW,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,KAAK,OAAO,CAAC,EAC5D,8BAAa,CAAC,SAAS,CAAC,IAAI,CAAC,CAChC,CAAC;IACN,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,WAAwB,EAAE,IAA+C;QACrG,MAAM,OAAO,GAAgB,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,EAAE,CAAC;QACzD,MAAM,0BAAW,CAAC,UAAU,CACxB,0BAAW,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,WAAW,CAAC,KAAK,OAAO,CAAC,EACnE,8BAAa,CAAC,SAAS,CAAC,OAAO,CAAC,EAChC,SAAS,CACZ,CAAC;IACN,CAAC;IAEO,4BAA4B,CAChC,YAAoC,EACpC,YAAoC,EACpC,YAA2B,EAC3B,aAAwC,EACxC,UAAyB;QAEzB,IAAI,CAAC,aAAa,EAAE,CAAC;YACjB,OAAO;QACX,CAAC;QACD,MAAM,aAAa,GAAuB,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAClF,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;YACrC,MAAM,MAAM,GAA2B,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,WAAW,CAAC,GAAG,CAAC,CAAC;YAE3F,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACjB,MAAM,CAAC,IAAI,CAAC,UAAU,WAAW,CAAC,GAAG,6BAA6B,CAAC,CAAC;gBACpE,SAAS;YACb,CAAC;YAED,MAAM,eAAe,GAAoB,IAAI,CAAC,kBAAkB,CAC5D,WAAW,CAAC,QAAQ,EACpB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC;gBAClC,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EACjE,CAAC,GAAG,aAAa,CAAC,EAClB,aAAa,EACb,UAAU,CAEb,CAAC;YACF,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC;gBAC1B,SAAS;YACb,CAAC;YAED,MAAM,YAAY,GAAW,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;YACjF,MAAM,CAAC,IAAI,CACP,UAAU,WAAW,CAAC,GAAG,aAAa,YAAY,KAAK,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtF,CAAC;QACN,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,CAAC,oCAAoC,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7G,CAAC;IACL,CAAC;IAEO,kBAAkB,CACtB,QAAkC,EAClC,OAAiC,EACjC,aAA8B,EAC9B,aAA4B,EAC5B,UAAyB;QAEzB,MAAM,gBAAgB,GAAoB,IAAI,CAAC,uBAAuB,CAAC,QAAQ,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;QAC/G,MAAM,eAAe,GAAoB,IAAI,CAAC,uBAAuB,CAAC,OAAO,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC;QAE1G,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC;IAEO,uBAAuB,CAC3B,QAAkC,EAClC,aAA8B,EAC9B,aAA4B;QAE5B,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,aAAa,CAAC,CAAC;QAC9B,CAAC;QAED,MAAM,gBAAgB,GAAoB,QAAQ,CAAC,GAAG,CAClD,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,EAAE,aAAa,CAAC,CAC5D,CAAC;QAEF,OAAO,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,mCAAe,CAAC,OAAO,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAC/F,CAAC;IAEO,0BAA0B,CAC9B,YAAoC,EACpC,YAA2B,EAC3B,UAAyB;QAEzB,MAAM,aAAa,GAAoB,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACtE,MAAM,iBAAiB,GAAoB,CAAC,GAAG,aAAa,EAAE,UAAU,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,8CAA8C;QAC9C,MAAM,aAAa,GAAG,CAAC,KAA2B,EAAE,MAAqB,EAAE,QAAgB,EAAQ,EAAE;YACjG,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;gBAC3B,OAAO;YACX,CAAC;YAED,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACnC,MAAM,eAAe,GAAkB,IAAI,CAAC,6BAA6B,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAE3F,MAAM,UAAU,GAAY,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,mCAAe,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;gBAEnH,IAAI,CAAC,UAAU,EAAE,CAAC;oBACd,MAAM,CAAC,IAAI,CAAC,oBAAoB,OAAO,KAAK,QAAQ,EAAE,CAAC,CAAC;gBAC5D,CAAC;YACL,CAAC;QACL,CAAC,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAC9B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC9B,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,oBAAoB,IAAI,CAAC,KAAK,oBAAoB,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;YACrG,CAAC;QACL,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,CAAC,oCAAoC,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7G,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;YAC/B,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,aAAa,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,CAAC,oCAAoC,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7G,CAAC;IACL,CAAC;IAEO,oBAAoB,CACxB,YAAoC,EACpC,cAA6B,EAC7B,eAA8B;QAE9B,MAAM,kBAAkB,GAAkB,eAAe,CAAC,MAAM,CAC5D,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,SAAS,IAAI,CAAC,CAAC,KAAK,KAAK,cAAc,CAC3D,CAAC;QACF,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO;QACX,CAAC;QAED,MAAM,cAAc,GAAgB,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACnI,MAAM,mBAAmB,GAAsC,IAAI,GAAG,CAClE,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CACzD,CAAC;QAEF,MAAM,oBAAoB,GAA2B,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YACzE,IAAI,CAAC,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;gBACvB,OAAO,KAAK,CAAC;YACjB,CAAC;YAED,MAAM,eAAe,GAAY,CAAC,CAAC,QAAQ,CAAC,IAAI,CAC5C,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS,CAC5D,CAAC;YAEF,IAAI,CAAC,eAAe,EAAE,CAAC;gBACnB,OAAO,KAAK,CAAC;YACjB,CAAC;YAED,MAAM,aAAa,GAAqC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACvF,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;gBACrD,OAAO,IAAI,CAAC;YAChB,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,aAAa,EAAE,cAAc,CAAC,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;QACjG,CAAC,CAAC,CAAC;QAEH,IAAI,oBAAoB,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACX;gBACI,oEAAoE,cAAc,CAAC,KAAK,GAAG;gBAC3F,kCAAkC;gBAClC,6EAA6E;gBAC7E,mHAAmH;gBACnH,0GAA0G;gBAC1G,EAAE;gBACF,mCAAmC;gBACnC,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC;aACjD,CAAC,IAAI,CAAC,IAAI,CAAC,CACf,CAAC;QACN,CAAC;IACL,CAAC;IAED,+CAA+C;IAC/C,cAAc,CAAC,OAAqD;QAChE,MAAM,YAAY,GAAuB,OAAO,YAAY,mDAAuB;YAC/E,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,eAAe,CAAC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC;YAC5F,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAEpD,IAAI,CAAC;YACD,IAAI,YAAY,IAAI,SAAS,EAAE,CAAC;gBAC5B,MAAM,MAAM,GAA4B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC;gBAC3F,IAAI,CAAC,MAAM,EAAE,CAAC;oBACV,MAAM,IAAI,mCAAe,CAAC,yBAAyB,CAAC,CAAC;gBACzD,CAAC;gBACD,OAAO,MAAM,CAAC;YAClB,CAAC;YACD,IAAI,IAAA,yBAAM,EAAC,YAAY,CAAC,EAAE,CAAC;gBACvB,OAAO,IAAI,CAAC,qBAAqB,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;YACjF,CAAC;YACD,MAAM,GAAG,GAA4B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,YAAY,CAAC,CAAC;YAC3F,IAAI,CAAC,GAAG,EAAE,CAAC;gBACP,MAAM,IAAI,mCAAe,CAAC,YAAY,YAAY,aAAa,CAAC,CAAC;YACrE,CAAC;YACD,OAAO,GAAG,CAAC;QACf,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACX,IAAI,KAAK,YAAY,mCAAe,EAAE,CAAC;gBACnC,MAAM,KAAK,CAAC;YAChB,CAAC;YACD,MAAM,IAAI,mCAAe,CAAC,2BAA2B,CAAC,CAAC;QAC3D,CAAC;IACL,CAAC;IAED,+CAA+C;IAC/C,uBAAuB,CACnB,CAA2B,EAC3B,CAA2B,EAC3B,aAA4B;QAE5B,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,MAAM,SAAS,GAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;QACpG,MAAM,SAAS,GAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;QAEpG,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,mCAAe,CAAC,OAAO,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IACxE,CAAC;IAEO,6BAA6B,CAAC,OAAuB,EAAE,aAA4B;QACvF,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YACvB,OAAO,aAAa,CAAC;QACzB,CAAC;QACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,IAAI,aAAa,EAAE,CAAC;QAC/B,CAAC;QACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,IAAI,aAAa,EAAE,CAAC;QAC/B,CAAC;QAED,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,+CAA+C;IAC/C,sBAAsB,CAClB,CAA2B,EAC3B,CAA2B,EAC3B,aAA4B;QAE5B,MAAM,MAAM,GAA6B,IAAI,CAAC,uBAAuB,CAAC,CAAC,EAAE,CAAC,EAAE,aAAa,CAAC,CAAC;QAC3F,OAAO,MAAM,KAAK,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;IAC/C,CAAC;IAED,+CAA+C;IAC/C,cAAc,CAAC,QAAkC,EAAE,eAAwB;QACvE,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,MAAM,GAA4B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC;QAC3F,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,MAAM,IAAI,mCAAe,CAAC,yBAAyB,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,gBAAgB,GAAoB,QAAQ,CAAC,GAAG,CAClD,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAC3D,CAAC;QAEF,OAAO,mCAAe,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;IAC5E,CAAC;IAED,+CAA+C;IAC/C,WAAW;QACP,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAEO,qBAAqB,CAAC,IAAU,EAAE,WAA0B;QAChE,MAAM,GAAG,GAA4B,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;YACtD,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;mBAClD,CAAC,CAAC,CAAC,MAAM,IAAI,SAAS,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACpF,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,MAAM,IAAI,mCAAe,CAAC,gCAAgC,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;IAEO,oBAAoB,CACxB,KAA2B,EAC3B,OAAsB,EACtB,aAA4B;QAE5B,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,QAAQ,GAAoB,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;QAEhH,OAAO,mCAAe,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC;IAEO,YAAY,CAAC,GAAqB;QACtC,MAAM,SAAS,GAA2B;YACtC,GAAG,IAAI,CAAC,MAAM,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC7H,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;gBACnC,MAAM,cAAc,GAA+B,sCAAiB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;gBAC1F,IAAI,CAAC,cAAc,EAAE,CAAC;oBAClB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;gBACzD,CAAC;gBACD,MAAM,MAAM,GAAmC,sCAAiB,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;gBACxF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,cAAc,CAAC,QAAQ;oBAC/C,GAAG,EAAE,cAAc,CAAC,SAAS,KAAK,GAAG;wBACjC,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE;wBAC5C,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,cAAc,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE;iBAC9E,CAAC,CAAC,CAAC;YACR,CAAC,CAAC;YACF,GAAG,GAAG,CAAC,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;gBAC5C,MAAM,cAAc,GAAwC,sCAAiB,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC;gBAC5G,IAAI,CAAC,cAAc,EAAE,CAAC;oBAClB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;gBACzD,CAAC;gBACD,MAAM,MAAM,GAA4C,sCAAiB,CAAC,4BAA4B,CAAC,CAAC,CAAC,CAAC;gBAC1G,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,cAAc,CAAC,QAAQ;oBAC/C,GAAG,EAAE,GAAG,cAAc,CAAC,WAAW,GAAG,CAAC,CAAC,KAAK,EAAE;iBACjD,CAAC,CAAC,CAAC;YACR,CAAC,CAAC;SACL,CAAC;QACF,OAAO,SAAS,CAAC;IACrB,CAAC;CACJ,CAAA;AA9cY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,iCAAU,EAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAOzB,WAAA,IAAA,yBAAM,EAAC,yCAAe,CAAC,cAAc,CAAC,CAAA;IAEtC,WAAA,IAAA,yBAAM,EAAC,yCAAe,CAAC,MAAM,CAAC,CAAA;;GAR1B,iBAAiB,CA8c7B"}

package/dist/cjs/websocket/decorators/websocket-controller.decorator.d.ts

@@ -1,11 +1,21 @@
+import { SupportedVersionsOptions } from '../../versioning/supported-versions-options.model';
 /**
  * Data of a websocket controller.
  */
 export type WebsocketControllerData = {
+    /**
+     * A prefix that all events of the controller should have.
+     * @default ''
+     */
+    eventPrefix: string;
     /**
      * Whether or not this websocket controller is allowed to exist without being registered in the application.
      */
     allowOrphan: boolean;
+    /**
+     * The versions that should be supported by this websocket controller's events. Can be overridden per event.
+     */
+    versions: SupportedVersionsOptions;
 };
 /**
  * Marks a websocket controller class to be registered.

package/dist/cjs/websocket/decorators/websocket-controller.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"websocket-controller.decorator.d.ts","sourceRoot":"","sources":["../../../../src/websocket/decorators/websocket-controller.decorator.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IAClC;;OAEG;IACH,WAAW,EAAE,OAAO,CAAA;CACvB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAAG,cAAc,CAalG"}
+{"version":3,"file":"websocket-controller.decorator.d.ts","sourceRoot":"","sources":["../../../../src/websocket/decorators/websocket-controller.decorator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mDAAmD,CAAC;AAE7F;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IAClC;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,QAAQ,EAAE,wBAAwB,CAAA;CACrC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAAG,cAAc,CAalG"}

package/dist/cjs/websocket/decorators/websocket-controller.decorator.js

@@ -8,12 +8,12 @@ const metadata_utilities_1 = require("../../utilities/metadata.utilities");
  * @param options - Options for the websocket controller.
  */
 function WebsocketController(options = {}) {
-    const { allowOrphan = false } = options;
+    const { allowOrphan = false, versions = ['^latest'], eventPrefix = '' } = options;
     return target => {
         // eslint-disable-next-line unicorn/error-message
         const stack = new Error().stack ?? '';
         metadata_utilities_1.MetadataUtilities.setFilePath(target, stack);
-        metadata_utilities_1.MetadataUtilities.setWebsocketControllerData(target, { allowOrphan });
+        metadata_utilities_1.MetadataUtilities.setWebsocketControllerData(target, { allowOrphan, versions, eventPrefix });
         global_registry_1.GlobalRegistry.injectables.push({
             token: target,
             useClass: target

package/dist/cjs/websocket/decorators/websocket-controller.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"websocket-controller.decorator.js","sourceRoot":"","sources":["../../../../src/websocket/decorators/websocket-controller.decorator.ts"],"names":[],"mappings":";;AAkBA,kDAaC;AA/BD,kEAA8D;AAE9D,2EAAuE;AAYvE;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,UAA4C,EAAE;IAC9E,MAAM,EAAE,WAAW,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IACxC,OAAO,MAAM,CAAC,EAAE;QACZ,iDAAiD;QACjD,MAAM,KAAK,GAAW,IAAI,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9C,sCAAiB,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC7C,sCAAiB,CAAC,0BAA0B,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;QACtE,gCAAc,CAAC,WAAW,CAAC,IAAI,CAAC;YAC5B,KAAK,EAAE,MAAqC;YAC5C,QAAQ,EAAE,MAAqC;SAClD,CAAC,CAAC;QACH,gCAAc,CAAC,0BAA0B,CAAC,IAAI,CAAC,MAAqC,CAAC,CAAC;IAC1F,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"websocket-controller.decorator.js","sourceRoot":"","sources":["../../../../src/websocket/decorators/websocket-controller.decorator.ts"],"names":[],"mappings":";;AA4BA,kDAaC;AAzCD,kEAA8D;AAE9D,2EAAuE;AAsBvE;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,UAA4C,EAAE;IAC9E,MAAM,EAAE,WAAW,GAAG,KAAK,EAAE,QAAQ,GAAG,CAAC,SAAS,CAAC,EAAE,WAAW,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAClF,OAAO,MAAM,CAAC,EAAE;QACZ,iDAAiD;QACjD,MAAM,KAAK,GAAW,IAAI,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9C,sCAAiB,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC7C,sCAAiB,CAAC,0BAA0B,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;QAC7F,gCAAc,CAAC,WAAW,CAAC,IAAI,CAAC;YAC5B,KAAK,EAAE,MAAqC;YAC5C,QAAQ,EAAE,MAAqC;SAClD,CAAC,CAAC;QACH,gCAAc,CAAC,0BAA0B,CAAC,IAAI,CAAC,MAAqC,CAAC,CAAC;IAC1F,CAAC,CAAC;AACN,CAAC"}

package/dist/cjs/websocket/decorators/websocket-route.decorator.d.ts

@@ -1,6 +1,18 @@
+import { SupportedVersionsOptions } from '../../versioning/supported-versions-options.model';
+/**
+ * Options for a websocket route.
+ */
+export type WebsocketRouteOptions = {
+    /**
+     * The supported versions of this route.
+     * Defaults to '^latest'.
+     */
+    versions?: SupportedVersionsOptions;
+};
 /**
  * Defines a route to receive websocket messages.
  * @param event - The event to listen on.
+ * @param options - The options of the route, like eg. The supported versions.
  */
-export declare function WebsocketRoute(event: string): MethodDecorator;
+export declare function WebsocketRoute(event: string, options?: WebsocketRouteOptions): MethodDecorator;
 //# sourceMappingURL=websocket-route.decorator.d.ts.map

package/dist/cjs/websocket/decorators/websocket-route.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"websocket-route.decorator.d.ts","sourceRoot":"","sources":["../../../../src/websocket/decorators/websocket-route.decorator.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAU7D"}
+{"version":3,"file":"websocket-route.decorator.d.ts","sourceRoot":"","sources":["../../../../src/websocket/decorators/websocket-route.decorator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mDAAmD,CAAC;AAG7F;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAChC;;;OAGG;IACH,QAAQ,CAAC,EAAE,wBAAwB,CAAA;CACtC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,eAAe,CAUlG"}

package/dist/cjs/websocket/decorators/websocket-route.decorator.js

@@ -5,15 +5,16 @@ const metadata_utilities_1 = require("../../utilities/metadata.utilities");
 /**
  * Defines a route to receive websocket messages.
  * @param event - The event to listen on.
+ * @param options - The options of the route, like eg. The supported versions.
  */
-function WebsocketRoute(event) {
+function WebsocketRoute(event, options = {}) {
     return (target, propertyKey) => {
         const ctor = target.constructor;
         // eslint-disable-next-line unicorn/error-message
         const stack = new Error().stack ?? '';
         metadata_utilities_1.MetadataUtilities.setFilePath(ctor, stack);
         const routes = metadata_utilities_1.MetadataUtilities.getWebsocketControllerRoutes(ctor);
-        routes.push({ event, controllerMethod: propertyKey.toString() });
+        routes.push({ event, controllerMethod: propertyKey.toString(), versions: options.versions });
         metadata_utilities_1.MetadataUtilities.setWebsocketControllerRoutes(ctor, routes);
     };
 }

package/dist/cjs/websocket/decorators/websocket-route.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"websocket-route.decorator.js","sourceRoot":"","sources":["../../../../src/websocket/decorators/websocket-route.decorator.ts"],"names":[],"mappings":";;AAOA,wCAUC;AAjBD,2EAAuE;AAGvE;;;GAGG;AACH,SAAgB,cAAc,CAAC,KAAa;IACxC,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC3B,MAAM,IAAI,GAAa,MAAM,CAAC,WAAW,CAAC;QAC1C,iDAAiD;QACjD,MAAM,KAAK,GAAW,IAAI,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9C,sCAAiB,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3C,MAAM,MAAM,GAA4C,sCAAiB,CAAC,4BAA4B,CAAC,IAAI,CAAC,CAAC;QAC7G,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACjE,sCAAiB,CAAC,4BAA4B,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjE,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"websocket-route.decorator.js","sourceRoot":"","sources":["../../../../src/websocket/decorators/websocket-route.decorator.ts"],"names":[],"mappings":";;AAoBA,wCAUC;AA9BD,2EAAuE;AAevE;;;;GAIG;AACH,SAAgB,cAAc,CAAC,KAAa,EAAE,UAAiC,EAAE;IAC7E,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC3B,MAAM,IAAI,GAAa,MAAM,CAAC,WAAW,CAAC;QAC1C,iDAAiD;QACjD,MAAM,KAAK,GAAW,IAAI,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9C,sCAAiB,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3C,MAAM,MAAM,GAA4C,sCAAiB,CAAC,4BAA4B,CAAC,IAAI,CAAC,CAAC;QAC7G,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,WAAW,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7F,sCAAiB,CAAC,4BAA4B,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjE,CAAC,CAAC;AACN,CAAC"}

package/dist/cjs/websocket/models/connection/base-websocket-connection.model.d.ts

@@ -1,3 +1,4 @@
+import { Version } from '../../../versioning/version.model';
 /**
  * Basic definition of a websocket connection.
  * Your implementation probably needs to extend this.
@@ -11,6 +12,10 @@ export type BaseWebsocketConnection = {
      * The id of the user that this connection belongs to.
      */
     readonly userId: string | undefined;
+    /**
+     * The resolved version of the connection.
+     */
+    readonly resolvedVersion: Version;
     /**
      * The current offset of the connection.
      * Is used to sync the state of the server with the client after a reconnect.

package/dist/cjs/websocket/models/connection/base-websocket-connection.model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-websocket-connection.model.d.ts","sourceRoot":"","sources":["../../../../../src/websocket/models/connection/base-websocket-connection.model.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG;IAClC;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;CACjB,CAAC"}
+{"version":3,"file":"base-websocket-connection.model.d.ts","sourceRoot":"","sources":["../../../../../src/websocket/models/connection/base-websocket-connection.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG;IAClC;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;CACjB,CAAC"}

package/dist/cjs/websocket/models/connection/socket-io-websocket-connection.model.d.ts

@@ -1,5 +1,6 @@
 import { Socket } from 'socket.io';
 import { BaseWebsocketConnection } from './base-websocket-connection.model';
+import { Version } from '../../../versioning/version.model';
 import { LooseWebsocketEvent } from '../websocket-event.enum';
 import { WebsocketMessage } from '../websocket-message.model';
 /**
@@ -8,6 +9,7 @@ import { WebsocketMessage } from '../websocket-message.model';
 export declare class SocketIOWebsocketConnection implements BaseWebsocketConnection {
     private readonly socket;
     userId: string | undefined;
+    readonly resolvedVersion: Version;
     readonly id: string;
     /**
      * Whether the connection state was recovered after a temporary disconnection.
@@ -16,7 +18,7 @@ export declare class SocketIOWebsocketConnection implements BaseWebsocketConnect
     readonly recovered: boolean;
     get offset(): number;
     set offset(value: number);
-    constructor(socket: Socket, userId: string | undefined);
+    constructor(socket: Socket, userId: string | undefined, resolvedVersion: Version);
     /**
      * Disconnects the socket.
      * @param close - Whether or not to close the underlying connection.

package/dist/cjs/websocket/models/connection/socket-io-websocket-connection.model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socket-io-websocket-connection.model.d.ts","sourceRoot":"","sources":["../../../../../src/websocket/models/connection/socket-io-websocket-connection.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAkB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;GAEG;AACH,qBAAa,2BAA4B,YAAW,uBAAuB;IAmB3D,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAiB,MAAM,EAAE,MAAM,GAAG,SAAS;IAjB9E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B,IAAI,MAAM,IAAI,MAAM,CAKnB;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,EAEvB;gBAE4B,MAAM,EAAE,MAAM,EAAS,MAAM,EAAE,MAAM,GAAG,SAAS;IAK9E;;;OAGG;IACH,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAIhC;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAI9D;;;;;;OAMG;IACG,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrG;;;OAGG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD;;;OAGG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IASvD;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIxD;;;OAGG;IACH,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAIlF"}
+{"version":3,"file":"socket-io-websocket-connection.model.d.ts","sourceRoot":"","sources":["../../../../../src/websocket/models/connection/socket-io-websocket-connection.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAkB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;GAEG;AACH,qBAAa,2BAA4B,YAAW,uBAAuB;IAqBnE,OAAO,CAAC,QAAQ,CAAC,MAAM;IAChB,MAAM,EAAE,MAAM,GAAG,SAAS;IACjC,QAAQ,CAAC,eAAe,EAAE,OAAO;IArBrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAG5B,IAAI,MAAM,IAAI,MAAM,CAKnB;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,EAEvB;gBAGoB,MAAM,EAAE,MAAM,EACxB,MAAM,EAAE,MAAM,GAAG,SAAS,EACxB,eAAe,EAAE,OAAO;IAOrC;;;OAGG;IACH,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAIhC;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAI9D;;;;;;OAMG;IACG,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrG;;;OAGG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD;;;OAGG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IASvD;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIxD;;;OAGG;IACH,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAIlF"}

package/dist/cjs/websocket/models/connection/socket-io-websocket-connection.model.js

@@ -8,6 +8,7 @@ const websocket_event_enum_1 = require("../websocket-event.enum");
 class SocketIOWebsocketConnection {
     socket;
     userId;
+    resolvedVersion;
     // eslint-disable-next-line jsdoc/require-jsdoc
     id;
     /**
@@ -25,9 +26,10 @@ class SocketIOWebsocketConnection {
     set offset(value) {
         this.socket.handshake.auth.offset = value;
     }
-    constructor(socket, userId) {
+    constructor(socket, userId, resolvedVersion) {
         this.socket = socket;
         this.userId = userId;
+        this.resolvedVersion = resolvedVersion;
         this.id = this.socket.id;
         this.recovered = this.socket.recovered;
     }

package/dist/cjs/websocket/models/connection/socket-io-websocket-connection.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"socket-io-websocket-connection.model.js","sourceRoot":"","sources":["../../../../../src/websocket/models/connection/socket-io-websocket-connection.model.ts"],"names":[],"mappings":";;;AAGA,kEAA8E;AAG9E;;GAEG;AACH,MAAa,2BAA2B;IAmBP;IAAuB;IAlBpD,+CAA+C;IACtC,EAAE,CAAS;IACpB;;;OAGG;IACM,SAAS,CAAU;IAC5B,+CAA+C;IAC/C,IAAI,MAAM;QACN,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;IAC7C,CAAC;IACD,IAAI,MAAM,CAAC,KAAa;QACpB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IAC9C,CAAC;IAED,YAA6B,MAAc,EAAS,MAA0B;QAAjD,WAAM,GAAN,MAAM,CAAQ;QAAS,WAAM,GAAN,MAAM,CAAoB;QAC1E,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,KAAc;QACrB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,KAA0B,EAAE,IAAsB;QACnD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CAAI,KAA0B,EAAE,IAAsB,EAAE,OAAe;QACpF,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAM,CAAC;IAC5E,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,QAA2B;QAClC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,QAA2B;QACnC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC/B,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAClC,OAAO;QACX,CAAC;QAED,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,QAAoC;QAC7C,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,qCAAc,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAkE;QACpE,0DAA0D;QAC1D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;CACJ;AAzFD,kEAyFC"}
+{"version":3,"file":"socket-io-websocket-connection.model.js","sourceRoot":"","sources":["../../../../../src/websocket/models/connection/socket-io-websocket-connection.model.ts"],"names":[],"mappings":";;;AAIA,kEAA8E;AAG9E;;GAEG;AACH,MAAa,2BAA2B;IAqBf;IACV;IACE;IAtBb,+CAA+C;IACtC,EAAE,CAAS;IACpB;;;OAGG;IACM,SAAS,CAAU;IAE5B,+CAA+C;IAC/C,IAAI,MAAM;QACN,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;IAC7C,CAAC;IACD,IAAI,MAAM,CAAC,KAAa;QACpB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IAC9C,CAAC;IAED,YACqB,MAAc,EACxB,MAA0B,EACxB,eAAwB;QAFhB,WAAM,GAAN,MAAM,CAAQ;QACxB,WAAM,GAAN,MAAM,CAAoB;QACxB,oBAAe,GAAf,eAAe,CAAS;QAGjC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,KAAc;QACrB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,KAA0B,EAAE,IAAsB;QACnD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CAAI,KAA0B,EAAE,IAAsB,EAAE,OAAe;QACpF,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAM,CAAC;IAC5E,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,QAA2B;QAClC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,QAA2B;QACnC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC/B,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAClC,OAAO;QACX,CAAC;QAED,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,QAAoC;QAC7C,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,qCAAc,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAkE;QACpE,0DAA0D;QAC1D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;CACJ;AA/FD,kEA+FC"}

package/dist/cjs/websocket/models/websocket-controller-route-configuration.model.d.ts

@@ -1,3 +1,4 @@
+import { SupportedVersionsOptions } from '../../versioning/supported-versions-options.model';
 /**
  * The configuration for a websocket controller route.
  */
@@ -10,5 +11,10 @@ export type WebsocketControllerRouteConfiguration = {
      * The name of the method on the controller that is responsible for handling messages to the websocket event.
      */
     controllerMethod: string;
+    /**
+     * The supported versions of this route.
+     * Defaults to '^latest'.
+     */
+    versions: SupportedVersionsOptions | undefined;
 };
 //# sourceMappingURL=websocket-controller-route-configuration.model.d.ts.map

package/dist/cjs/websocket/models/websocket-controller-route-configuration.model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"websocket-controller-route-configuration.model.d.ts","sourceRoot":"","sources":["../../../../src/websocket/models/websocket-controller-route-configuration.model.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,qCAAqC,GAAG;IAChD;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAA;CAC3B,CAAC"}
+{"version":3,"file":"websocket-controller-route-configuration.model.d.ts","sourceRoot":"","sources":["../../../../src/websocket/models/websocket-controller-route-configuration.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mDAAmD,CAAC;AAE7F;;GAEG;AACH,MAAM,MAAM,qCAAqC,GAAG;IAChD;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,EAAE,wBAAwB,GAAG,SAAS,CAAA;CACjD,CAAC"}

package/dist/cjs/websocket/models/websocket-message.model.d.ts

@@ -37,11 +37,11 @@ export declare class WebsocketMessage extends BaseEntity {
     /**
      * The id of the user that has sent the message.
      */
-    senderUserId: string | undefined;
+    senderUserId: string | undefined | null;
     /**
      * The of the connection that has sent the message.
      */
-    senderConnectionId: string | undefined;
+    senderConnectionId: string | undefined | null;
     /**
      * The actual data of the message.
      */