@atmosx/event-product-parser 3.0.4 → 3.0.7

package/src/components/images/modules/GetSVGPath.ts

@@ -0,0 +1,53 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
+    Discord: https://atmosphericx-discord.scriptkitty.cafe
+    Ko-Fi: https://ko-fi.com/k3yomi
+    Documentation: https://atmosphericx.scriptkitty.cafe/documentation
+
+    Independent Package: @atmosx/event-product-parser
+
+*/
+
+import { NormalizePolygon } from "@Image/modules/NormalizePolygon"
+
+interface GenerateEventPolygonsOptions {
+    Polygons: GeoJSON.Polygon | GeoJSON.MultiPolygon | null
+    IPath: (feature: GeoJSON.Feature) => string | null
+    Map: boolean
+    Settings: {
+        BorderColor: string
+        BorderWidth: number
+        FillColor: string
+        FillOpacity: number
+    }
+}
+
+export const GetSVGPath = ({ Polygons, IPath, Settings, Map }: GenerateEventPolygonsOptions): string => {
+    if (!Polygons) return
+    const feature: GeoJSON.Feature = {
+        type: `Feature`,
+        properties: {},
+        geometry: !Map ? NormalizePolygon(Polygons) : Polygons,
+    };
+    const d = IPath(feature);
+    if (!d) return ``;
+    return `<path
+        d="${d}"
+        fill="${Settings.FillColor}"
+        fill-opacity="${Settings.FillOpacity}"
+        fill-rule="evenodd"
+        stroke="${Settings.BorderColor}"
+        stroke-width="${Settings.BorderWidth}"
+        stroke-linejoin="round"
+        stroke-linecap="round"
+    />`;
+};

package/src/components/images/modules/NormalizePolygon.ts

@@ -0,0 +1,57 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
+    Discord: https://atmosphericx-discord.scriptkitty.cafe
+    Ko-Fi: https://ko-fi.com/k3yomi
+    Documentation: https://atmosphericx.scriptkitty.cafe/documentation
+
+    Independent Package: @atmosx/event-product-parser
+
+*/
+
+import { geoArea } from "d3-geo";
+
+export const NormalizeD3Polygon = (geometry: GeoJSON.Polygon | GeoJSON.MultiPolygon): GeoJSON.Polygon | GeoJSON.MultiPolygon => {
+    const area = geoArea(geometry);
+    if (area > 2 * Math.PI) {
+        if (geometry.type === `Polygon`) {
+            return {
+                type: `Polygon`,
+                coordinates: geometry.coordinates.map(ring => ring.slice().reverse())
+            };
+        }
+        return {
+            type: `MultiPolygon`,
+            coordinates: geometry.coordinates.map(polygon => polygon.map(ring => ring.slice().reverse()))
+        };
+    }
+    return geometry;
+};
+
+export const NormalizePolygon = (geometry: GeoJSON.Geometry): GeoJSON.Geometry => {
+    if (geometry.type !== `Polygon` && geometry.type !== `MultiPolygon`) {
+        return geometry;
+    }
+    const reverseRing = (ring: number[][]) => {
+        const reversed = ring.slice().reverse();
+        return reversed;
+    };
+    if (geometry.type === `Polygon`) {
+        return {
+            type: `Polygon`,
+            coordinates: geometry.coordinates.map((ring, index) => index === 0 ? reverseRing(ring) : ring.slice().reverse())
+        };
+    }
+    return {
+        type: `MultiPolygon`,
+        coordinates: geometry.coordinates.map(polygon => polygon.map((ring, index) => index === 0 ? reverseRing(ring) : ring.slice().reverse()))
+    };
+}

package/src/{@modules/@stanza/stanza.getAwipsType.ts → components/stanza/GetAwipsType.ts}

@@ -11,36 +11,37 @@
     Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
     Discord: https://atmosphericx-discord.scriptkitty.cafe
     Ko-Fi: https://ko-fi.com/k3yomi
-    Documentation: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+    Documentation: https://atmosphericx.scriptkitty.cafe/documentation
 
-    Internal Package: @atmosx/event-product-parser
+    Independent Package: @atmosx/event-product-parser
 
 */
 
-import { TypeAttributes } from "../../@types/types.attributes"
-import { eventAwipAbreviations } from "../../@dictionaries/dictionaries.eventAwipAbreviations"
+import { TypeAttributes } from "StaticTypes/Attributes"
+import { EnumAWIPS } from "@Enums/AWIPS"
 
-interface ValidateOptions { 
-    attributes: TypeAttributes
+interface GetAwipsTypeOptions { 
+    Attributes: TypeAttributes
 }
 
-interface ValidiateResponse { 
-    type: string
-    prefix: string
+interface GetAwipsTypeResponse { 
+    Type: string
+    Prefix: string
+    Discovered: boolean
 }
 
-export const getAwipsType = (options: ValidateOptions): ValidiateResponse => {
-    const attributes = options.attributes;
-    if (!attributes.awipsid) { 
+export const GetAwipsType = ({ Attributes }: GetAwipsTypeOptions): GetAwipsTypeResponse => {
+    if (!Attributes.awipsid) { 
         return { 
-            type: null, 
-            prefix: null
+            Type: null, 
+            Prefix: null,
+            Discovered: false
         }
     }
-    for (const [prefix, type] of Object.entries(eventAwipAbreviations)) {
-        if (attributes.awipsid.startsWith(prefix)) {
-            return { type, prefix }
+    for (const [prefix, type] of Object.entries(EnumAWIPS)) {
+        if (Attributes.awipsid.startsWith(prefix)) {
+            return { Type: type, Prefix: prefix, Discovered: true }
         }
     }
-    return { type: null, prefix: null }
+    return { Type: Attributes.awipsid, Prefix: Attributes.awipsid, Discovered: false }
 }

package/src/components/stanza/ValidateStanza.ts

@@ -0,0 +1,62 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
+    Discord: https://atmosphericx-discord.scriptkitty.cafe
+    Ko-Fi: https://ko-fi.com/k3yomi
+    Documentation: https://atmosphericx.scriptkitty.cafe/documentation
+
+    Independent Package: @atmosx/event-product-parser
+
+*/
+
+import { TypeStanza } from "StaticTypes/Stanza"
+import { TypeStanzaCompiled } from "Types/StanzaCompiled"
+import { EnumExpressions } from "@Enums/Expressions"
+import { GetAwipsType } from "@Stanza/GetAwipsType"
+
+interface ValidateStanzaOptions { 
+    Stanza: TypeStanza
+}
+
+export const ValidateStanza = ({ Stanza }: ValidateStanzaOptions): TypeStanzaCompiled => {
+    if (Stanza.is(`message`)) {
+        const cb = Stanza.getChild(`x`) as TypeStanza;
+        if (cb && cb.children) {
+            const message = unescape(cb.children[0]);
+            const attributes = cb.attrs;
+            if (attributes.awipsid && attributes.awipsid.length > 1) { 
+                const isCapEvent = message.includes(`<?xml`);
+                const isCapAreaDescription = message.includes(`<areaDesc>`)
+                const isVTEC = message.match(EnumExpressions.vtec) != null;
+                const isUGC = message.match(EnumExpressions.ugc1) != null;
+                const getType = GetAwipsType({ Attributes: attributes})
+                if (getType.Type != null) {
+                    return { 
+                        Message: message, 
+                        Attributes: attributes, 
+                        CapEvent: isCapEvent, 
+                        VTEC: isVTEC, 
+                        UGC: isUGC, 
+                        CapAreaDescription: isCapAreaDescription, 
+                        Ignored: false, 
+                        NWWS: true, 
+                        Type: {
+                            Type: getType.Type, 
+                            Prefix: getType.Prefix,
+                            Discovered: getType.Discovered
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return { Ignored: true}
+}

package/src/components/utilities/CreateHttp.ts

@@ -0,0 +1,83 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
+    Discord: https://atmosphericx-discord.scriptkitty.cafe
+    Ko-Fi: https://ko-fi.com/k3yomi
+    Documentation: https://atmosphericx.scriptkitty.cafe/documentation
+
+    Independent Package: @atmosx/event-product-parser
+
+*/
+
+interface CreateHttpOptions { 
+    URL: string
+    Headers?: any
+    Timeout?: number
+    Auth?: {
+        Username: string
+        Password: string
+    }
+    Method?: `GET` | `POST` | `PUT` | `DELETE`
+    Body?: any;
+    Form?: any;
+}
+
+export const CreateHttp = async ({ URL, Headers, Timeout, Auth, Method, Body, Form }: CreateHttpOptions): Promise<any> => {
+	const requestOptions: RequestInit = {
+        method: Method ?? "GET",
+        headers: Headers ?? {
+            "User-Agent": "AtmosphericX",
+            "Accept": "application/geo+json, text/plain, */*; q=0.9",
+            "Accept-Language": "en-US,en;q=0.9",
+        },
+        signal: AbortSignal.timeout(Timeout ?? 10_000),
+        redirect: "follow"
+    };
+
+
+	const returnHttp = function(error: boolean,status: number, message: string) {
+		return { error: error, options: requestOptions, status, message };
+	}
+
+    if (Auth) {
+        const authString = `${Auth.Username}:${Auth.Password}`;
+        const encodedAuth = Buffer.from(authString).toString("base64");
+        requestOptions.headers = {
+            ...requestOptions.headers,
+            "Authorization": `Basic ${encodedAuth}`
+        };
+    }
+
+	if (Form) { 
+		requestOptions.body = Form;
+	} else if (Body != undefined) {
+        requestOptions.body =
+        Body instanceof FormData
+            ? Body
+            : typeof Body === "string"
+                ? Body
+                : JSON.stringify(Body);
+	}
+
+	try { 
+		const response = await fetch(
+			URL ?? `https://api.weather.gov/alerts/active`,
+			requestOptions
+		)
+		const body = await response.text();
+		if (!response.ok) { 
+			return returnHttp(true, response.status, `HTTP Status Code ${response.status} (${response.statusText})`)
+		}
+		return returnHttp(false, response.status, body)
+	} catch (error) {
+		return returnHttp(true, 500, `Internal Server Error: ${error}`)
+	}
+}

package/src/{@modules/@utilities/utilities.getFormattedTime.ts → components/utilities/GetFormattedTime.ts}

@@ -11,14 +11,14 @@
     Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
     Discord: https://atmosphericx-discord.scriptkitty.cafe
     Ko-Fi: https://ko-fi.com/k3yomi
-    Documentation: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+    Documentation: https://atmosphericx.scriptkitty.cafe/documentation
 
-    Internal Package: @atmosx/event-product-parser
+    Independent Package: @atmosx/event-product-parser
 
     
 */
 
-export const getFormattedTime = (date: string): string => {
+export const GetFormattedTime = (date: string): string => {
     const now = Date.now();
     const then = typeof date === "number" ? date : new Date(date).getTime()
     const seconds = Math.floor((now - then) / 1000);

package/src/components/utilities/GetLatestIssuance.ts

@@ -0,0 +1,32 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
+    Discord: https://atmosphericx-discord.scriptkitty.cafe
+    Ko-Fi: https://ko-fi.com/k3yomi
+    Documentation: https://atmosphericx.scriptkitty.cafe/documentation
+
+    Independent Package: @atmosx/event-product-parser
+
+    
+*/
+
+export const GetLatestIssuance = (): string => {
+    const now = new Date();
+    const current = now.getUTCHours() * 100 + now.getUTCMinutes();
+    const issuances = [100, 600, 1300, 1630, 2000];
+    let latest = issuances[0];
+    for (const issuance of issuances) {
+        if (current >= issuance) {
+            latest = issuance;
+        }
+    }
+    return latest.toString().padStart(4, "0");
+}

package/src/components/utilities/GetMatched.ts

@@ -0,0 +1,38 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
+    Discord: https://atmosphericx-discord.scriptkitty.cafe
+    Ko-Fi: https://ko-fi.com/k3yomi
+    Documentation: https://atmosphericx.scriptkitty.cafe/documentation
+
+    Independent Package: @atmosx/event-product-parser
+
+*/
+
+interface GetMatchedOptions {
+    Strings: string[]
+    String: string
+}
+
+export const GetMatched = ({ Strings, String }: GetMatchedOptions): boolean => {
+    const isMatched = Strings.some(pattern => {
+        if (!pattern) return false;
+        const lowerP = pattern.toLowerCase();
+        const lowerS = String.toLowerCase()
+        if (lowerP === "*" || lowerP === lowerS) return true;
+        if (lowerP.includes("*")) {
+            const regex = "^" + lowerP.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*") + "$";
+            return new RegExp(regex).test(lowerS);
+        }
+        return false;
+    });
+    return isMatched;
+}

package/src/{@modules/@utilities/utilities.getShapeNearestPoint.ts → components/utilities/GetShapeNearestPoint.ts}

@@ -11,23 +11,28 @@
     Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
     Discord: https://atmosphericx-discord.scriptkitty.cafe
     Ko-Fi: https://ko-fi.com/k3yomi
-    Documentation: http://localhost/documentation | https://atmosphericx.scriptkitty.cafe/documentation
+    Documentation: https://atmosphericx.scriptkitty.cafe/documentation
 
-    Internal Package: @atmosx/event-product-parser
+    Independent Package: @atmosx/event-product-parser
 
 */
 
+interface GetShapeNearestPointOptions {
+    Coordinates: number[][]
+    Point: [number, number]
+}
+
 interface GetShapeNearestPointResponse { 
-    proximity: boolean
-    point: [number, number]
-    distance: number | null 
-    distanceKm?: number | null
-    distanceMeters?: number | null
+    Proximity: boolean
+    Point: [number, number]
+    Distance: number | null 
+    DistanceKm?: number | null
+    DistanceMeters?: number | null
 }
 
-export const getShapeNearestPoint = (coordinates: number[][], point: [number, number]): GetShapeNearestPointResponse => {
-    if (!coordinates || !point) { 
-        return { proximity: false, point: [0, 0], distance: null }
+export const GetShapeNearestPoint = ({ Coordinates, Point }: GetShapeNearestPointOptions): GetShapeNearestPointResponse => {
+    if (!Coordinates || !Point) { 
+        return { Proximity: false, Point: [0, 0], Distance: null }
     }
     const normalize = (coords: any): any[] => {
         if (!Array.isArray(coords)) return [];
@@ -43,10 +48,10 @@ export const getShapeNearestPoint = (coordinates: number[][], point: [number, nu
         }
         return [];
     }
-    const polys = normalize(coordinates);
-    if (polys.length === 0) return { proximity: false, point: [0, 0], distance: null };
-    const lon = point[0];
-    const lat = point[1];
+    const polys = normalize(Coordinates);
+    if (polys.length === 0) return { Proximity: false, Point: [0, 0], Distance: null };
+    const lon = Point[0];
+    const lat = Point[1];
     const pointInRing = (pt: [number, number], ring: number[][]): boolean => {
         let x = pt[0], y = pt[1];
         let inside = false;
@@ -76,13 +81,13 @@ export const getShapeNearestPoint = (coordinates: number[][], point: [number, nu
     for (const poly of polys) {
         const outer = poly[0];
         const holes = poly.slice(1);
-        if (pointInRing(point, outer)) {
+        if (pointInRing(Point, outer)) {
             let inHole = false;
             for (const hole of holes) {
-                if (pointInRing(point, hole)) { inHole = true; break; }
+                if (pointInRing(Point, hole)) { inHole = true; break; }
             }
             if (!inHole) {
-                return { proximity: true, point, distance: 0 };
+                return { Proximity: true, Point, Distance: 0 };
             }
         }
         for (const ring of poly) {
@@ -105,10 +110,10 @@ export const getShapeNearestPoint = (coordinates: number[][], point: [number, nu
         }
     }
     if (!isFinite(minDistance) || closestPoint == null) {
-        return { proximity: false, point: [0,0], distance: null };
+        return { Proximity: false, Point: [0,0], Distance: null };
     }
     const distanceMiles = minDistance;
     const distanceKm = Number((distanceMiles * 1.609344).toFixed(3));
     const distanceMeters = Math.round(distanceKm * 1000);
-    return { proximity: distanceMiles === 0, point: closestPoint, distance: distanceMiles, distanceKm, distanceMeters };
+    return { Proximity: distanceMiles === 0, Point: closestPoint, Distance: distanceMiles, DistanceKm: distanceKm, DistanceMeters: distanceMeters };
 }

package/src/components/utilities/GetUnionPolygon.ts

@@ -0,0 +1,36 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
+    Discord: https://atmosphericx-discord.scriptkitty.cafe
+    Ko-Fi: https://ko-fi.com/k3yomi
+    Documentation: https://atmosphericx.scriptkitty.cafe/documentation
+
+    Independent Package: @atmosx/event-product-parser
+
+*/
+
+import { union } from "polygon-clipping";
+
+interface GetUnionPolygonOptions {
+    Polygons: number[][][][] | null;
+}
+
+export const GetUnionPolygon = ({ Polygons }: GetUnionPolygonOptions): GeoJSON.MultiPolygon | null => {
+    if (!Polygons || Polygons.length === 0) {
+        return null;
+    }
+    const unionFn = union as unknown as (...polygons: number[][][][]) => number[][][][];
+    const unioned = unionFn(...Polygons)
+    return {
+        type: `MultiPolygon`,
+        coordinates: unioned
+    }
+};

package/src/components/utilities/QueueManager.ts

@@ -0,0 +1,70 @@
+/*
+              _                             _               _     __   __
+         /\  | |                           | |             (_)    \ \ / /
+        /  \ | |_ _ __ ___   ___  ___ _ __ | |__   ___ _ __ _  ___ \ V / 
+       / /\ \| __| '_ ` _ \ / _ \/ __| '_ \| '_ \ / _ \ '__| |/ __| > <  
+      / ____ \ |_| | | | | | (_) \__ \ |_) | | | |  __/ |  | | (__ / . \ 
+     /_/    \_\__|_| |_| |_|\___/|___/ .__/|_| |_|\___|_|  |_|\___/_/ \_\
+                                     | |                            
+                                     |_|                                                                                                                
+
+    Created with ♥ by the AtmosphericX Team (KiyoWx, StarflightWx, & CJ Ziegler)
+    Discord: https://atmosphericx-discord.scriptkitty.cafe
+    Ko-Fi: https://ko-fi.com/k3yomi
+    Documentation: https://atmosphericx.scriptkitty.cafe/documentation
+
+    Independent Package: @atmosx/event-product-parser
+*/
+
+export type QueueTask = () => Promise<void>;
+
+export interface QueueManagerOptions {
+    Concurrency?: number;
+    Error?: (error: unknown) => void;
+}
+
+export class QueueManager {
+    private readonly queue: QueueTask[] = [];
+    private readonly concurrency: number;
+    private readonly onError: (error: unknown) => void;
+
+    private running = 0;
+    private draining = false;
+
+    public constructor({ Concurrency, Error }: QueueManagerOptions = {}) {
+        this.concurrency = Concurrency ?? 1;
+        this.onError = Error ?? ((error) => {
+            console.error("[QueueManager] Task failed:", error);
+        });
+    }
+
+    public enqueue(task: QueueTask): void {
+        this.queue.push(task);
+        this.drain();
+    }
+
+    private drain(): void {
+        if (this.draining) { return; }
+        this.draining = true;
+        while (this.running < this.concurrency && this.queue.length > 0) {
+            const task = this.queue.shift();
+            if (!task) { continue; }
+            this.running++;
+            void this.execute(task);
+        }
+        this.draining = false;
+    }
+
+    private async execute(task: QueueTask): Promise<void> {
+        try {
+            await task();
+        } catch (error) {
+            try {
+                this.onError(error);
+            } catch (handlerError) {}
+        } finally {
+            this.running--;
+            this.drain();
+        }
+    }
+}