@rapidrest/service-core 1.0.0-beta.1

package/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (C) 2020-2026 Jean-Philippe Steinmetz <caskater47@gmail.com>
+Copyright (C) 2020-2026 Arthur Thompson
+Copyright (C) 2024 Thomas Buscaglia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,16 @@
+# RapidREST: service-core
+
+[![pipeline status](https://gitlab.rapidrest.com/rapidrest/rapidrestjs/service-core/badges/master/pipeline.svg)](https://gitlab.rapidrest.com/rapidrest/rapidrestjs/service-core/-/commits/master)
+[![coverage report](https://gitlab.rapidrest.com/rapidrest/rapidrestjs/service-core/badges/master/coverage.svg)](https://gitlab.rapidrest.com/rapidrest/rapidrestjs/service-core/-/commits/master)
+
+Provides common functionality and utilities for RapidREST based REST API service projects.
+
+## NPM
+```
+npm i @rapidrest/service-core
+```
+
+## Yarn
+```
+yarn add @rapidrest/service-core
+```

package/dist/lib/ApiErrors.js

@@ -0,0 +1,41 @@
+/**
+ * Defines the unique codes for all common API errors.
+ */
+export var ApiErrors;
+(function (ApiErrors) {
+    ApiErrors["UNKNOWN"] = "api-001";
+    ApiErrors["INTERNAL_ERROR"] = "api-002";
+    ApiErrors["INVALID_REQUEST"] = "api-003";
+    ApiErrors["NOT_FOUND"] = "api-010";
+    ApiErrors["IDENTIFIER_EXISTS"] = "api-011";
+    ApiErrors["INVALID_OBJECT_VERSION"] = "api-012";
+    ApiErrors["OBJECT_ID_MISMATCH"] = "api-013";
+    ApiErrors["SEARCH_INVALID_RANGE"] = "api-014";
+    ApiErrors["SEARCH_INVALID_ME_REFERENCE"] = "api-015";
+    ApiErrors["BULK_CREATE_FAILURE"] = "api-021";
+    ApiErrors["BULK_UPDATE_FAILURE"] = "api-022";
+    ApiErrors["AUTH_REQUIRED"] = "api-100";
+    ApiErrors["AUTH_FAILED"] = "api-101";
+    ApiErrors["AUTH_PERMISSION_FAILURE"] = "api-102";
+})(ApiErrors || (ApiErrors = {}));
+/**
+ * Defines the default message of all common API errors.
+ */
+export var ApiErrorMessages;
+(function (ApiErrorMessages) {
+    ApiErrorMessages["UNKNOWN"] = "An unknown error has occurred. Please try again.";
+    ApiErrorMessages["INTERNAL_ERROR"] = "An internal error has occurred. Please contact the adminstrator.";
+    ApiErrorMessages["INVALID_REQUEST"] = "Invalid message or request.";
+    ApiErrorMessages["NOT_FOUND"] = "No resource could be found with the specified identifier.";
+    ApiErrorMessages["IDENTIFIER_EXISTS"] = "A resource with that identifier already exists.";
+    ApiErrorMessages["INVALID_OBJECT_VERSION"] = "Invalid object version. Do you have the latest version?";
+    ApiErrorMessages["OBJECT_ID_MISMATCH"] = "The object provided does not match the identifier given.";
+    ApiErrorMessages["SEARCH_INVALID_RANGE"] = "Invalid range value: '{{value}}'. Expected 2 arguments, got {{length}}";
+    ApiErrorMessages["SEARCH_INVALID_ME_REFERENCE"] = "Use of the `me` reference requires authentication.";
+    ApiErrorMessages["BULK_CREATE_FAILURE"] = "Failed to create one or more objects.";
+    ApiErrorMessages["BULK_UPDATE_FAILURE"] = "Failed to update one or more objects.";
+    ApiErrorMessages["AUTH_REQUIRED"] = "Authorization is required to access this resource.";
+    ApiErrorMessages["AUTH_FAILED"] = "Invalid or missing authentication token.";
+    ApiErrorMessages["AUTH_PERMISSION_FAILURE"] = "User does not have permission to perform this action.";
+})(ApiErrorMessages || (ApiErrorMessages = {}));
+//# sourceMappingURL=ApiErrors.js.map

package/dist/lib/ApiErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiErrors.js","sourceRoot":"","sources":["../../src/ApiErrors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,SAeX;AAfD,WAAY,SAAS;IACjB,gCAAmB,CAAA;IACnB,uCAA0B,CAAA;IAC1B,wCAA2B,CAAA;IAC3B,kCAAqB,CAAA;IACrB,0CAA6B,CAAA;IAC7B,+CAAkC,CAAA;IAClC,2CAA8B,CAAA;IAC9B,6CAAgC,CAAA;IAChC,oDAAuC,CAAA;IACvC,4CAA+B,CAAA;IAC/B,4CAA+B,CAAA;IAC/B,sCAAyB,CAAA;IACzB,oCAAuB,CAAA;IACvB,gDAAmC,CAAA;AACvC,CAAC,EAfW,SAAS,KAAT,SAAS,QAepB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,gBAeX;AAfD,WAAY,gBAAgB;IACxB,gFAA4D,CAAA;IAC5D,uGAAmF,CAAA;IACnF,mEAA+C,CAAA;IAC/C,2FAAuE,CAAA;IACvE,yFAAqE,CAAA;IACrE,sGAAkF,CAAA;IAClF,mGAA+E,CAAA;IAC/E,mHAA+F,CAAA;IAC/F,sGAAkF,CAAA;IAClF,iFAA6D,CAAA;IAC7D,iFAA6D,CAAA;IAC7D,wFAAoE,CAAA;IACpE,4EAAwD,CAAA;IACxD,qGAAiF,CAAA;AACrF,CAAC,EAfW,gBAAgB,KAAhB,gBAAgB,QAe3B"}

package/dist/lib/BackgroundService.js

@@ -0,0 +1,16 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2020-2026 Jean-Philippe Steinmetz
+///////////////////////////////////////////////////////////////////////////////
+/**
+ * The `BackgroundService` is an abstract base class for defining scheduled background services. A background service
+ * executes in the background once on startup or on a set schedule (like a cron job) and performs additional processing.
+ *
+ * @author Jean-Philippe Steinmetz <rapidrests@gmail.com>
+ */
+export class BackgroundService {
+    constructor(config, logger) {
+        this.config = config;
+        this.logger = logger;
+    }
+}
+//# sourceMappingURL=BackgroundService.js.map

package/dist/lib/BackgroundService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackgroundService.js","sourceRoot":"","sources":["../../src/BackgroundService.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kDAAkD;AAClD,+EAA+E;AAC/E;;;;;GAKG;AACH,MAAM,OAAgB,iBAAiB;IAMnC,YAAY,MAAW,EAAE,MAAW;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;CAsBJ"}

package/dist/lib/BackgroundServiceManager.js

@@ -0,0 +1,135 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2020-2026 Jean-Philippe Steinmetz
+///////////////////////////////////////////////////////////////////////////////
+import { BackgroundService } from "./BackgroundService.js";
+import * as schedule from "node-schedule";
+/**
+ * The `BackgroundServiceManager` manages all configured background services in the application. It is responsible for
+ * initializing the jobs, scheduling them and performing any related shutdown tasks. See the `BackgroundService`
+ * class for details on how to create a background service class to be used by this manager.
+ *
+ * ## Usage
+ * To use the manager instantiate a new object and provide the required constructor arguments. Then simply call the
+ * `startAll` function. When shutting your application down you should call the `stopAll` function.
+ *
+ * ```
+ * import { BackgroundServiceManager } from "@rapidrest/service-core";
+ *
+ * const manager: BackgroundServiceManager = new BackgroundServiceManager(objectFactory, serviceClasses, config, logger);
+ * await manager.startAll();
+ * ...
+ * await manager.stopAll();
+ * ```
+ *
+ * You may optionally start and stop individual services using the `start` and `stop` functions respectively.
+ *
+ * ```
+ * await manager.start("MyService");
+ * ...
+ * await manger.stop("MyService");
+ * ```
+ * @author Jean-Philippe Steinmetz <rapidrests@gmail.com>
+ */
+export class BackgroundServiceManager {
+    constructor(objectFactory, classes, config, logger) {
+        this.jobs = {};
+        this.services = {};
+        this.classes = classes;
+        this.config = config;
+        this.logger = logger;
+        this.objectFactory = objectFactory;
+    }
+    /**
+     * Returns the service instance with the given name.
+     *
+     * @param name The name of the background service to retrieve.
+     */
+    getService(name) {
+        return this.services[name];
+    }
+    /**
+     * Starts all configured background services.
+     */
+    async startAll() {
+        // Go through all loaded background job classes and start each one
+        if (this.classes) {
+            for (const name in this.classes) {
+                const clazz = this.classes[name];
+                if (clazz.prototype instanceof BackgroundService) {
+                    await this.start(name, clazz);
+                }
+            }
+        }
+    }
+    /**
+     * Starts the background service with the given name.
+     *
+     * @param serviceName The name of the background service to start.
+     * @param clazz The class type of the service to start. If not specified the name is used to lookup the class type.
+     * @param args The list of arguments to pass into the service constructor
+     */
+    async start(serviceName, clazz, ...args) {
+        // Check that the job hasn't already been started
+        if (this.jobs[serviceName]) {
+            return;
+        }
+        // Look for the class definition with the given name if not already given
+        clazz = clazz ? clazz : this.classes[serviceName];
+        if (clazz) {
+            try {
+                this.logger.info("Starting service " + serviceName + "...");
+                // Instantiate the service class
+                const service = await this.objectFactory.newInstance(clazz, {
+                    name: serviceName,
+                    initialize: true,
+                    args: [this.config, this.logger, ...args],
+                });
+                this.services[serviceName] = service;
+                // Initialize the service
+                await service.start();
+                // Schedule the service for background execution
+                if (service.schedule) {
+                    this.jobs[serviceName] = schedule.scheduleJob(service.schedule, service.run.bind(service));
+                }
+                else {
+                    // One time execution services are run once and then immediately cleaned up
+                    await service.run();
+                    await service.stop();
+                    await this.objectFactory.destroy(service);
+                }
+            }
+            catch (err) {
+                this.logger.error(`Failed to start service: ${serviceName}`);
+                this.logger.debug(err);
+            }
+        }
+    }
+    /**
+     * Stops all currently active background services that are owned by the manager.
+     */
+    async stopAll() {
+        for (const jobName in this.jobs) {
+            await this.stop(jobName);
+        }
+        // Clear the local state
+        this.jobs = {};
+        this.services = {};
+    }
+    /**
+     * Stops the background service with the given name.
+     *
+     * @param serviceName The name of the background service to stop.
+     */
+    async stop(serviceName) {
+        this.logger.info("Stopping background service " + serviceName + "...");
+        // Cancel the background execution schedule
+        if (this.jobs[serviceName]) {
+            this.jobs[serviceName].cancel(false);
+        }
+        // Shut it down
+        if (this.services[serviceName]) {
+            await this.services[serviceName].stop();
+        }
+    }
+}
+//# sourceMappingURL=BackgroundServiceManager.js.map

package/dist/lib/BackgroundServiceManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackgroundServiceManager.js","sourceRoot":"","sources":["../../src/BackgroundServiceManager.ts"],"names":[],"mappings":"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"}

package/dist/lib/BulkError.js

@@ -0,0 +1,24 @@
+import { ApiError } from "@rapidrest/core";
+/**
+ * An error take that takes an array of other errors.
+ */
+export class BulkError extends ApiError {
+    constructor(errs, code, defaultStatus, message) {
+        super(code, defaultStatus, message);
+        /**
+         * The list of errors that have been thrown.
+         */
+        this.errors = [];
+        // Per: https://github.com/microsoft/TypeScript-wiki/blob/81fe7b91664de43c02ea209492ec1cea7f3661d0/Breaking-Changes.md#extending-built-ins-like-error-array-and-map-may-no-longer-work
+        Object.setPrototypeOf(this, BulkError.prototype);
+        this.errors = errs;
+        // Override default from the first valid status code
+        for (const err of errs) {
+            if (err && "status" in err) {
+                this.status = err.status;
+                break;
+            }
+        }
+    }
+}
+//# sourceMappingURL=BulkError.js.map

package/dist/lib/BulkError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BulkError.js","sourceRoot":"","sources":["../../src/BulkError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,QAAQ;IAMnC,YAAY,IAAsB,EAAE,IAAY,EAAE,aAAqB,EAAE,OAAgB;QACrF,KAAK,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;QANxC;;WAEG;QACa,WAAM,GAAqB,EAAE,CAAC;QAI1C,sLAAsL;QACtL,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,oDAAoD;QACpD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,IAAI,GAAG,IAAI,QAAQ,IAAI,GAAG,EAAE,CAAC;gBACzB,IAAI,CAAC,MAAM,GAAI,GAAW,CAAC,MAAM,CAAC;gBAClC,MAAM;YACV,CAAC;QACL,CAAC;IACL,CAAC;CACJ"}

package/dist/lib/EventListenerManager.js

@@ -0,0 +1,161 @@
+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);
+};
+import { ObjectDecorators } from "@rapidrest/core";
+const { Config, Destroy, Init, Logger } = ObjectDecorators;
+/**
+ * The `EventListenerManager` is responsible for managing event handlers and processing of incoming
+ * events from the configured redis pubsub channels. An event handler is any function that has been
+ * decorated with the `@OnEvent` decorator and registered with this manager. Once registered, any event
+ * that is received corresponding to the list of types specified in the decorator arguments will be
+ * sent to the designated function(s). If no type is specified, the handler function will be called
+ * for any event that is received.
+ * @author Jean-Philippe Steinmetz <rapidrests@gmail.com>
+ */
+export class EventListenerManager {
+    constructor(objectFactory, redis) {
+        this.channels = [];
+        this.handlers = new Map();
+        this.objectFactory = objectFactory;
+        this.redis = redis;
+    }
+    async init() {
+        try {
+            await this.redis.subscribe(...this.channels);
+        }
+        catch (err) {
+            this.logger.error("EventManager: Failed to subscribe to pubsub channels: " + this.channels);
+            this.logger.debug(err);
+        }
+        this.redis.on("message", (channel, message) => {
+            try {
+                const decoded = JSON.parse(message);
+                this.onEvent(decoded);
+            }
+            catch (err) {
+                this.logger.error("EventManager: Received event but could not parse it.");
+                this.logger.debug(`EventManager: Channel=${channel}, Event=${message}, Error=${err}`);
+            }
+        });
+        // Go through each class in the ObjectFactory and create any with event listener decorator.
+        const classes = this.objectFactory.classes;
+        if (classes) {
+            for (const clazz of classes.values()) {
+                try {
+                    if (Reflect.hasOwnMetadata("rrst:eventListeners", clazz) &&
+                        clazz.prototype.constructor.length === 0) {
+                        const obj = await this.objectFactory.newInstance(clazz, { name: "default" });
+                        this.register(obj);
+                    }
+                }
+                catch (err) {
+                    this.logger.debug(`EventListeners: Unable to process class[${clazz}], Error=${err}`);
+                }
+            }
+        }
+        // Go through each object instance in the ObjectFactory that is an event processor.
+        const objs = this.objectFactory.instances;
+        if (objs) {
+            for (const obj of objs.values()) {
+                this.register(obj);
+            }
+        }
+    }
+    async destroy() {
+        await this.redis.unsubscribe(...this.channels);
+        this.handlers.clear();
+    }
+    /**
+     * Handler function for events that arrive from redis.
+     */
+    onEvent(evt) {
+        // The registered event types can be regular expression patterns so we
+        // need to test each one against our type in order to idenity which
+        // handlers to send to.
+        for (const entry of this.handlers.entries()) {
+            // We'll perform regex comparisons with case-insentivity to make it easier
+            if (evt.type.match(new RegExp(entry[0], "i"))) {
+                const handlers = entry[1];
+                if (handlers) {
+                    for (const handler of handlers) {
+                        handler(evt);
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Adds the given function to the list of designated event handlers for the specified type.
+     * @param event The type of event to add a handler for
+     * @param func The function to add
+     */
+    addEventHandler(event, func) {
+        let handlers = this.handlers.get(event);
+        // Create the list if not already exists
+        if (!handlers) {
+            handlers = [];
+        }
+        // Add the handler to the list if not already registered
+        if (!handlers.includes(func)) {
+            handlers.push(func);
+        }
+        // Update the list in the map
+        this.handlers.set(event, handlers);
+    }
+    /**
+     * Registers the given object to be notified of events that arrive.
+     * @param obj The object to register for event handling.
+     */
+    register(obj) {
+        const members = [];
+        // Search through the object looking for all functions that have
+        // the @Event decorator.
+        let proto = Object.getPrototypeOf(obj);
+        while (proto) {
+            for (const member of Object.getOwnPropertyNames(proto)) {
+                const events = Reflect.getMetadata("rrst:events", proto, member);
+                // Don't register the same member more than once
+                if (events && !members.includes(member)) {
+                    const func = obj[member].bind(obj);
+                    if (Array.isArray(events)) {
+                        for (const event of events) {
+                            this.addEventHandler(event, func);
+                        }
+                    }
+                    else {
+                        this.addEventHandler(events, func);
+                    }
+                    members.push(member);
+                }
+            }
+            proto = Object.getPrototypeOf(proto);
+        }
+    }
+}
+__decorate([
+    Config("events:channels", []),
+    __metadata("design:type", Array)
+], EventListenerManager.prototype, "channels", void 0);
+__decorate([
+    Logger,
+    __metadata("design:type", Object)
+], EventListenerManager.prototype, "logger", void 0);
+__decorate([
+    Init,
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], EventListenerManager.prototype, "init", null);
+__decorate([
+    Destroy,
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], EventListenerManager.prototype, "destroy", null);
+//# sourceMappingURL=EventListenerManager.js.map

package/dist/lib/EventListenerManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventListenerManager.js","sourceRoot":"","sources":["../../src/EventListenerManager.ts"],"names":[],"mappings":"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"}

package/dist/lib/NetUtils.js

@@ -0,0 +1,103 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2020-2026 Jean-Philippe Steinmetz
+///////////////////////////////////////////////////////////////////////////////
+import { promises as dns } from "dns";
+/**
+ * Provides common utilities and functions for working with networking related problems.
+ *
+ * @author Jean-Philippe Steinmetz <rapidrests@gmail.com>
+ */
+export class NetUtils {
+    /**
+     * Performs DNS lookup of the IP address from a given url.
+     *
+     * @param url The url to lookup the IP from.
+     * @param family ip family used for dns lookup
+     * @returns A `string` containing the IP address if found, otherwise `undefined`.
+     */
+    static async lookupIPAddress(url, family = 4) {
+        let result = undefined;
+        try {
+            const tmp = new URL(url);
+            // Check that the host isn't already an IPv4/IPv6 address
+            let matches = null;
+            if ((matches = tmp.host.match(/^((?:[0-9]{1,3}\.){3}[0-9]{1,3}):?([0-9]+)?$/)) ||
+                (matches = tmp.host.match(/^\[?((::)?([0-9a-fA-F]{1,4}:){0,7}:?([0-9a-fA-F]{1,4}:?){1,7})\]?:?([0-9]+)?$/))) {
+                result = matches[1];
+            }
+            else {
+                // Attempt to resolve the domain name
+                matches = tmp.host.match(/^((?:[A-Za-z0-9-]+\.?)+[A-Za-z0-9]{1,3})(:\d{1,5})?$/);
+                if (matches) {
+                    const lookup = await dns.lookup(matches[1], family);
+                    result = lookup.address;
+                }
+            }
+        }
+        catch (err) {
+            // Do nothing
+        }
+        return result;
+    }
+    /**
+     * Extracts the IP address from a given url or HTTP request.
+     *
+     * When `trustedProxies` is provided, forwarding headers (`X-Forwarded-For`, etc.) are
+     * only trusted when the direct connection's `remoteAddress` is in that list. Without a
+     * trusted-proxy list the headers are ignored and the socket address is returned directly,
+     * preventing clients from spoofing their IP in audit logs.
+     *
+     * @param urlOrRequest The url or HTTP request to extract the IP from.
+     * @param trustedProxies Optional list of proxy IP addresses whose forwarding headers should be trusted.
+     * @returns A `string` containing the IP address if found, otherwise `undefined`.
+     */
+    static getIPAddress(urlOrRequest, trustedProxies) {
+        let result = undefined;
+        if (typeof urlOrRequest === "string") {
+            // Check that for IPv4/IPv6 addresses
+            let matches = null;
+            if ((matches = urlOrRequest.match(/^((?:[0-9]{1,3}\.){3}[0-9]{1,3}):?([0-9]+)?$/)) ||
+                (matches = urlOrRequest.match(/^\[?((::)?([0-9a-fA-F]{1,4}:){0,7}:?([0-9a-fA-F]{1,4}:?){1,7})\]?:?([0-9]+)?$/))) {
+                result = matches[1];
+            }
+            // Maybe it's a URL?
+            else {
+                try {
+                    const tmp = new URL(urlOrRequest);
+                    // Check that the host isn't already an IPv4/IPv6 address
+                    let matches = null;
+                    if ((matches = tmp.host.match(/^((?:[0-9]{1,3}\.){3}[0-9]{1,3}):?([0-9]+)?$/)) ||
+                        (matches = tmp.host.match(/^\[?((::)?([0-9a-fA-F]{1,4}:){0,7}:?([0-9a-fA-F]{1,4}:?){1,7})\]?:?([0-9]+)?$/))) {
+                        result = matches[1];
+                    }
+                    else {
+                        result = tmp.host;
+                    }
+                }
+                catch (err) {
+                    // Do nothing
+                }
+            }
+        }
+        else {
+            const remoteAddr = urlOrRequest.socket?.remoteAddress;
+            const proxyTrusted = trustedProxies && trustedProxies.length > 0
+                ? remoteAddr !== undefined && trustedProxies.includes(remoteAddr)
+                : false;
+            if (proxyTrusted) {
+                if (urlOrRequest.headers["x-original-forwarded-for"]) {
+                    result = urlOrRequest.headers["x-original-forwarded-for"];
+                }
+                else if (urlOrRequest.headers["x-forwarded-for"]) {
+                    result = urlOrRequest.headers["x-forwarded-for"];
+                }
+                else if (urlOrRequest.headers["x-real-ip"]) {
+                    result = urlOrRequest.headers["x-real-ip"];
+                }
+            }
+            result = result ?? remoteAddr;
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=NetUtils.js.map

package/dist/lib/NetUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetUtils.js","sourceRoot":"","sources":["../../src/NetUtils.ts"],"names":[],"mappings":"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"}

package/dist/lib/NotificationUtils.js

@@ -0,0 +1,34 @@
+/**
+ * Utility functions for sending push notifications to registered clients.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class NotificationUtils {
+    /**
+     * Initializes the utility using the given redis connection.
+     *
+     * @param {any} redis The redis connection to publish to.
+     */
+    constructor(redis) {
+        this.redis = redis;
+    }
+    /**
+     * Sends a given message to the room or user with the specified uid(s).
+     *
+     * @param {string} uids The universally unique identifier of the room or user to send the message to.
+     * @param {string} type The type of message being sent.
+     * @param {string} action The action performed on the data (if applicable).
+     * @param {string} data The contents of the message to send to the room or user.
+     */
+    sendMessage(uids, type, action, data) {
+        if (Array.isArray(uids)) {
+            for (const uid of uids) {
+                void this.redis?.publish(uid, JSON.stringify({ type, action, data }));
+            }
+        }
+        else {
+            void this.redis?.publish(uids, JSON.stringify({ type, action, data }));
+        }
+    }
+}
+//# sourceMappingURL=NotificationUtils.js.map

package/dist/lib/NotificationUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationUtils.js","sourceRoot":"","sources":["../../src/NotificationUtils.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAI1B;;;;OAIG;IACH,YAAY,KAAY;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED;;;;;;;OAOG;IACI,WAAW,CAAC,IAAuB,EAAE,IAAY,EAAE,MAAc,EAAE,IAAS;QAC/E,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACrB,KAAK,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC1E,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,KAAK,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3E,CAAC;IACL,CAAC;CACJ"}