@panda0day/fivex 0.2.1

package/dist/shared/math/vector3.d.ts

@@ -0,0 +1,200 @@
+/**
+ * 3D vector type and math, shared by the client and server.
+ *
+ * @remarks
+ * This module contains no natives, so both runtimes import it. Use {@link IVector3}
+ * for anything that crosses the wire (event payloads, stored data) and {@link Vector3}
+ * for computation.
+ *
+ * @packageDocumentation
+ */
+/**
+ * A plain 3D coordinate shape: `{ x, y, z }` with no methods.
+ *
+ * @remarks
+ * This is the type to use for data that is serialized — sent through `emitNet`,
+ * written to a state bag, or stored — because serialization strips class
+ * prototypes, so a {@link Vector3} arrives on the other side as a plain object
+ * anyway. Re-wrap with {@link Vector3.from} if you need the methods back.
+ */
+export interface IVector3 {
+    /** Position along the world X axis (east/west). */
+    x: number;
+    /** Position along the world Y axis (north/south). */
+    y: number;
+    /** Position along the world Z axis (up/down). */
+    z: number;
+}
+/**
+ * An immutable-by-convention 3D vector with common math operations.
+ *
+ * @remarks
+ * Every operation returns a **new** `Vector3` rather than mutating in place, so
+ * instances are safe to share. Because the public `x`/`y`/`z` fields satisfy
+ * {@link IVector3}, an instance can be passed directly to any native that expects
+ * a coordinate shape (e.g. `SetEntityCoords`).
+ *
+ * @example
+ * ```ts
+ * const a = new Vector3(0, 0, 0);
+ * const b = new Vector3(10, 0, 0);
+ *
+ * a.distanceTo(b);          // 10
+ * a.lerp(b, 0.5);           // Vector3(5, 0, 0)
+ * a.add(new Vector3(0, 0, 5)); // Vector3(0, 0, 5)
+ * ```
+ */
+export declare class Vector3 implements IVector3 {
+    x: number;
+    y: number;
+    z: number;
+    /**
+     * Creates a vector from its components.
+     *
+     * @param x - X component. @defaultValue 0
+     * @param y - Y component. @defaultValue 0
+     * @param z - Z component. @defaultValue 0
+     */
+    constructor(x?: number, y?: number, z?: number);
+    /**
+     * Builds a `Vector3` from a plain object or a `[x, y, z]` tuple.
+     *
+     * @param value - Either an `{ x, y, z }` object or a numeric array in `[x, y, z]` order.
+     * @returns A new `Vector3`.
+     *
+     * @example
+     * ```ts
+     * Vector3.from({ x: 1, y: 2, z: 3 });
+     * Vector3.from(GetEntityCoords(ped, true)); // wrap a native result
+     * Vector3.from([1, 2, 3]);
+     * ```
+     */
+    static from(value: IVector3 | number[]): Vector3;
+    /**
+     * The zero vector, `(0, 0, 0)`.
+     *
+     * @returns A new zero `Vector3`.
+     */
+    static zero(): Vector3;
+    /**
+     * Adds a vector or a scalar to this vector.
+     *
+     * @param value - A `Vector3` (component-wise) or a number (added to every component).
+     * @returns The resulting vector.
+     */
+    add(value: Vector3 | number): Vector3;
+    /**
+     * Subtracts a vector or a scalar from this vector.
+     *
+     * @param value - A `Vector3` (component-wise) or a number (subtracted from every component).
+     * @returns The resulting vector.
+     */
+    subtract(value: Vector3 | number): Vector3;
+    /**
+     * Multiplies this vector by a vector or a scalar.
+     *
+     * @remarks
+     * Vector input is a **component-wise** (Hadamard) product, not a dot or cross
+     * product. Pass a scalar to uniformly scale — e.g. `v.multiply(2)` doubles the length.
+     *
+     * @param value - A `Vector3` (component-wise) or a number (scales every component).
+     * @returns The resulting vector.
+     */
+    multiply(value: Vector3 | number): Vector3;
+    /**
+     * Dot product with another vector.
+     *
+     * @param value - The other vector.
+     * @returns The scalar dot product. `0` means the vectors are perpendicular.
+     */
+    dot(value: Vector3): number;
+    /**
+     * Cross product with another vector.
+     *
+     * @param value - The other vector.
+     * @returns A new vector perpendicular to both inputs.
+     */
+    cross(value: Vector3): Vector3;
+    /**
+     * The magnitude (Euclidean length) of the vector.
+     *
+     * @remarks
+     * Involves a square root. If you only need to compare magnitudes, prefer
+     * {@link Vector3.lengthSquared} to avoid the `Math.sqrt` call.
+     */
+    get length(): number;
+    /**
+     * The squared magnitude of the vector.
+     *
+     * @remarks
+     * Cheaper than {@link Vector3.length} because it skips the square root. Order is
+     * preserved, so it is ideal for "which is closer" comparisons.
+     */
+    get lengthSquared(): number;
+    /**
+     * Returns a unit vector pointing in the same direction.
+     *
+     * @returns A new vector with length `1`, or {@link Vector3.zero} if this vector
+     * has zero length (avoids dividing by zero).
+     */
+    normalize(): Vector3;
+    /**
+     * Euclidean distance to another point.
+     *
+     * @param v - The other point.
+     * @returns The distance.
+     * @see {@link Vector3.distanceToSquared} for a cheaper comparison-only variant.
+     */
+    distanceTo(v: Vector3): number;
+    /**
+     * Squared Euclidean distance to another point.
+     *
+     * @remarks
+     * Skips the square root, so use this when ranking or thresholding distances
+     * (compare against a squared radius) rather than reporting an actual distance.
+     *
+     * @param v - The other point.
+     * @returns The squared distance.
+     */
+    distanceToSquared(v: Vector3): number;
+    /**
+     * Linearly interpolates from this vector toward another.
+     *
+     * @param v - The target vector.
+     * @param t - Interpolation factor. `0` returns this vector, `1` returns `v`;
+     * values outside `[0, 1]` extrapolate.
+     * @returns The interpolated vector.
+     */
+    lerp(v: Vector3, t: number): Vector3;
+    /**
+     * Creates an independent copy of this vector.
+     *
+     * @returns A new `Vector3` with the same components.
+     */
+    clone(): Vector3;
+    /**
+     * Compares two vectors for approximate equality.
+     *
+     * @remarks
+     * Uses a tolerance because floating-point math rarely produces exactly equal
+     * components after arithmetic.
+     *
+     * @param v - The vector to compare against.
+     * @param epsilon - Maximum allowed per-component difference. @defaultValue 1e-6
+     * @returns `true` if every component is within `epsilon` of `v`.
+     */
+    equals(v: Vector3, epsilon?: number): boolean;
+    /**
+     * Converts to a plain `[x, y, z]` tuple.
+     *
+     * @returns The components as a fixed-length array.
+     */
+    toArray(): [number, number, number];
+    /**
+     * A human-readable representation, e.g. `"Vector3(1, 2, 3)"`.
+     *
+     * @returns The formatted string.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=vector3.d.ts.map

package/dist/shared/math/vector3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector3.d.ts","sourceRoot":"","sources":["../../../src/shared/math/vector3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ;IACxB,mDAAmD;IACnD,CAAC,EAAE,MAAM,CAAC;IACV,qDAAqD;IACrD,CAAC,EAAE,MAAM,CAAC;IACV,iDAAiD;IACjD,CAAC,EAAE,MAAM,CAAC;CACV;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,OAAQ,YAAW,QAAQ;IAS/B,CAAC;IACD,CAAC;IACD,CAAC;IAVT;;;;;;OAMG;gBAEK,CAAC,SAAI,EACL,CAAC,SAAI,EACL,CAAC,SAAI;IAGb;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,EAAE,GAAG,OAAO;IAMhD;;;;OAIG;IACH,MAAM,CAAC,IAAI,IAAI,OAAO;IAItB;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO;IAMrC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO;IAM1C;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO;IAM1C;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAI3B;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAQ9B;;;;;;OAMG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;;;;OAMG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;;;;OAKG;IACH,SAAS,IAAI,OAAO;IAKpB;;;;;;OAMG;IACH,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM;IAI9B;;;;;;;;;OASG;IACH,iBAAiB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM;IAIrC;;;;;;;OAOG;IACH,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IAIpC;;;;OAIG;IACH,KAAK,IAAI,OAAO;IAIhB;;;;;;;;;;OAUG;IACH,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,SAAO,GAAG,OAAO;IAQ3C;;;;OAIG;IACH,OAAO,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAInC;;;;OAIG;IACH,QAAQ,IAAI,MAAM;CAGlB"}

package/dist/shared/math/vector3.js

@@ -0,0 +1,232 @@
+/**
+ * 3D vector type and math, shared by the client and server.
+ *
+ * @remarks
+ * This module contains no natives, so both runtimes import it. Use {@link IVector3}
+ * for anything that crosses the wire (event payloads, stored data) and {@link Vector3}
+ * for computation.
+ *
+ * @packageDocumentation
+ */
+/**
+ * An immutable-by-convention 3D vector with common math operations.
+ *
+ * @remarks
+ * Every operation returns a **new** `Vector3` rather than mutating in place, so
+ * instances are safe to share. Because the public `x`/`y`/`z` fields satisfy
+ * {@link IVector3}, an instance can be passed directly to any native that expects
+ * a coordinate shape (e.g. `SetEntityCoords`).
+ *
+ * @example
+ * ```ts
+ * const a = new Vector3(0, 0, 0);
+ * const b = new Vector3(10, 0, 0);
+ *
+ * a.distanceTo(b);          // 10
+ * a.lerp(b, 0.5);           // Vector3(5, 0, 0)
+ * a.add(new Vector3(0, 0, 5)); // Vector3(0, 0, 5)
+ * ```
+ */
+export class Vector3 {
+    x;
+    y;
+    z;
+    /**
+     * Creates a vector from its components.
+     *
+     * @param x - X component. @defaultValue 0
+     * @param y - Y component. @defaultValue 0
+     * @param z - Z component. @defaultValue 0
+     */
+    constructor(x = 0, y = 0, z = 0) {
+        this.x = x;
+        this.y = y;
+        this.z = z;
+    }
+    /**
+     * Builds a `Vector3` from a plain object or a `[x, y, z]` tuple.
+     *
+     * @param value - Either an `{ x, y, z }` object or a numeric array in `[x, y, z]` order.
+     * @returns A new `Vector3`.
+     *
+     * @example
+     * ```ts
+     * Vector3.from({ x: 1, y: 2, z: 3 });
+     * Vector3.from(GetEntityCoords(ped, true)); // wrap a native result
+     * Vector3.from([1, 2, 3]);
+     * ```
+     */
+    static from(value) {
+        return Array.isArray(value)
+            ? new Vector3(value[0], value[1], value[2])
+            : new Vector3(value.x, value.y, value.z);
+    }
+    /**
+     * The zero vector, `(0, 0, 0)`.
+     *
+     * @returns A new zero `Vector3`.
+     */
+    static zero() {
+        return new Vector3(0, 0, 0);
+    }
+    /**
+     * Adds a vector or a scalar to this vector.
+     *
+     * @param value - A `Vector3` (component-wise) or a number (added to every component).
+     * @returns The resulting vector.
+     */
+    add(value) {
+        return typeof value === "number"
+            ? new Vector3(this.x + value, this.y + value, this.z + value)
+            : new Vector3(this.x + value.x, this.y + value.y, this.z + value.z);
+    }
+    /**
+     * Subtracts a vector or a scalar from this vector.
+     *
+     * @param value - A `Vector3` (component-wise) or a number (subtracted from every component).
+     * @returns The resulting vector.
+     */
+    subtract(value) {
+        return typeof value === "number"
+            ? new Vector3(this.x - value, this.y - value, this.z - value)
+            : new Vector3(this.x - value.x, this.y - value.y, this.z - value.z);
+    }
+    /**
+     * Multiplies this vector by a vector or a scalar.
+     *
+     * @remarks
+     * Vector input is a **component-wise** (Hadamard) product, not a dot or cross
+     * product. Pass a scalar to uniformly scale — e.g. `v.multiply(2)` doubles the length.
+     *
+     * @param value - A `Vector3` (component-wise) or a number (scales every component).
+     * @returns The resulting vector.
+     */
+    multiply(value) {
+        return typeof value === "number"
+            ? new Vector3(this.x * value, this.y * value, this.z * value)
+            : new Vector3(this.x * value.x, this.y * value.y, this.z * value.z);
+    }
+    /**
+     * Dot product with another vector.
+     *
+     * @param value - The other vector.
+     * @returns The scalar dot product. `0` means the vectors are perpendicular.
+     */
+    dot(value) {
+        return this.x * value.x + this.y * value.y + this.z * value.z;
+    }
+    /**
+     * Cross product with another vector.
+     *
+     * @param value - The other vector.
+     * @returns A new vector perpendicular to both inputs.
+     */
+    cross(value) {
+        return new Vector3(this.y * value.z - this.z * value.y, this.z * value.x - this.x * value.z, this.x * value.y - this.y * value.x);
+    }
+    /**
+     * The magnitude (Euclidean length) of the vector.
+     *
+     * @remarks
+     * Involves a square root. If you only need to compare magnitudes, prefer
+     * {@link Vector3.lengthSquared} to avoid the `Math.sqrt` call.
+     */
+    get length() {
+        return Math.sqrt(this.dot(this));
+    }
+    /**
+     * The squared magnitude of the vector.
+     *
+     * @remarks
+     * Cheaper than {@link Vector3.length} because it skips the square root. Order is
+     * preserved, so it is ideal for "which is closer" comparisons.
+     */
+    get lengthSquared() {
+        return this.dot(this);
+    }
+    /**
+     * Returns a unit vector pointing in the same direction.
+     *
+     * @returns A new vector with length `1`, or {@link Vector3.zero} if this vector
+     * has zero length (avoids dividing by zero).
+     */
+    normalize() {
+        const length = this.length;
+        return length === 0 ? Vector3.zero() : this.multiply(1 / length);
+    }
+    /**
+     * Euclidean distance to another point.
+     *
+     * @param v - The other point.
+     * @returns The distance.
+     * @see {@link Vector3.distanceToSquared} for a cheaper comparison-only variant.
+     */
+    distanceTo(v) {
+        return this.subtract(v).length;
+    }
+    /**
+     * Squared Euclidean distance to another point.
+     *
+     * @remarks
+     * Skips the square root, so use this when ranking or thresholding distances
+     * (compare against a squared radius) rather than reporting an actual distance.
+     *
+     * @param v - The other point.
+     * @returns The squared distance.
+     */
+    distanceToSquared(v) {
+        return this.subtract(v).lengthSquared;
+    }
+    /**
+     * Linearly interpolates from this vector toward another.
+     *
+     * @param v - The target vector.
+     * @param t - Interpolation factor. `0` returns this vector, `1` returns `v`;
+     * values outside `[0, 1]` extrapolate.
+     * @returns The interpolated vector.
+     */
+    lerp(v, t) {
+        return this.add(v.subtract(this).multiply(t));
+    }
+    /**
+     * Creates an independent copy of this vector.
+     *
+     * @returns A new `Vector3` with the same components.
+     */
+    clone() {
+        return new Vector3(this.x, this.y, this.z);
+    }
+    /**
+     * Compares two vectors for approximate equality.
+     *
+     * @remarks
+     * Uses a tolerance because floating-point math rarely produces exactly equal
+     * components after arithmetic.
+     *
+     * @param v - The vector to compare against.
+     * @param epsilon - Maximum allowed per-component difference. @defaultValue 1e-6
+     * @returns `true` if every component is within `epsilon` of `v`.
+     */
+    equals(v, epsilon = 1e-6) {
+        return (Math.abs(this.x - v.x) < epsilon &&
+            Math.abs(this.y - v.y) < epsilon &&
+            Math.abs(this.z - v.z) < epsilon);
+    }
+    /**
+     * Converts to a plain `[x, y, z]` tuple.
+     *
+     * @returns The components as a fixed-length array.
+     */
+    toArray() {
+        return [this.x, this.y, this.z];
+    }
+    /**
+     * A human-readable representation, e.g. `"Vector3(1, 2, 3)"`.
+     *
+     * @returns The formatted string.
+     */
+    toString() {
+        return `Vector3(${this.x}, ${this.y}, ${this.z})`;
+    }
+}
+//# sourceMappingURL=vector3.js.map

package/dist/shared/math/vector3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector3.js","sourceRoot":"","sources":["../../../src/shared/math/vector3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoBH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,OAAO;IASX;IACA;IACA;IAVR;;;;;;OAMG;IACH,YACQ,IAAI,CAAC,EACL,IAAI,CAAC,EACL,IAAI,CAAC;QAFL,MAAC,GAAD,CAAC,CAAI;QACL,MAAC,GAAD,CAAC,CAAI;QACL,MAAC,GAAD,CAAC,CAAI;IACV,CAAC;IAEJ;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAI,CAAC,KAA0B;QACrC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAC1B,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3C,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAI;QACV,OAAO,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,KAAuB;QAC1B,OAAO,OAAO,KAAK,KAAK,QAAQ;YAC/B,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;YAC7D,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,KAAuB;QAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ;YAC/B,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;YAC7D,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAuB;QAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ;YAC/B,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;YAC7D,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,KAAc;QACjB,OAAO,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAc;QACnB,OAAO,IAAI,OAAO,CACjB,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EACnC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EACnC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CACnC,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,aAAa;QAChB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACH,SAAS;QACR,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,OAAO,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,CAAU;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAChC,CAAC;IAED;;;;;;;;;OASG;IACH,iBAAiB,CAAC,CAAU;QAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;IACvC,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,CAAU,EAAE,CAAS;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACH,KAAK;QACJ,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,CAAU,EAAE,OAAO,GAAG,IAAI;QAChC,OAAO,CACN,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO;YAChC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO;YAChC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAChC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,OAAO;QACN,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACP,OAAO,WAAW,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC;IACnD,CAAC;CACD"}

package/dist/shared/net.d.ts

@@ -0,0 +1,7 @@
+export declare const Net: {
+    readonly setHealth: "__fx:setHealth";
+    readonly setArmour: "__fx:setArmour";
+    readonly setPosition: "__fx:setPosition";
+    readonly setRotation: "__fx:setRotation";
+};
+//# sourceMappingURL=net.d.ts.map

package/dist/shared/net.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"net.d.ts","sourceRoot":"","sources":["../../src/shared/net.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,GAAG;;;;;CAKN,CAAC"}

package/dist/shared/net.js

@@ -0,0 +1,7 @@
+export const Net = {
+    setHealth: "__fx:setHealth",
+    setArmour: "__fx:setArmour",
+    setPosition: "__fx:setPosition",
+    setRotation: "__fx:setRotation",
+};
+//# sourceMappingURL=net.js.map

package/dist/shared/net.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"net.js","sourceRoot":"","sources":["../../src/shared/net.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,GAAG,GAAG;IAClB,SAAS,EAAE,gBAAgB;IAC3B,SAAS,EAAE,gBAAgB;IAC3B,WAAW,EAAE,kBAAkB;IAC/B,WAAW,EAAE,kBAAkB;CACtB,CAAC"}

package/dist/shared/pool-base.d.ts

@@ -0,0 +1,11 @@
+export declare abstract class Pool<T> {
+    protected abstract ids(): number[];
+    protected abstract wrap(id: number): T;
+    toArray(): T[];
+    get length(): number;
+    forEach(fn: (item: T) => void): void;
+    map<R>(fn: (item: T) => R): R[];
+    filter(fn: (item: T) => boolean): T[];
+    find(fn: (item: T) => boolean): T | undefined;
+}
+//# sourceMappingURL=pool-base.d.ts.map

package/dist/shared/pool-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool-base.d.ts","sourceRoot":"","sources":["../../src/shared/pool-base.ts"],"names":[],"mappings":"AAAA,8BAAsB,IAAI,CAAC,CAAC;IAC3B,SAAS,CAAC,QAAQ,CAAC,GAAG,IAAI,MAAM,EAAE;IAElC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC;IAEtC,OAAO,IAAI,CAAC,EAAE;IAId,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,OAAO,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAIpC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;IAI/B,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,CAAC,EAAE;IAIrC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,CAAC,GAAG,SAAS;CAO7C"}

package/dist/shared/pool-base.js

@@ -0,0 +1,27 @@
+export class Pool {
+    toArray() {
+        return this.ids().map(this.wrap);
+    }
+    get length() {
+        return this.ids().length;
+    }
+    forEach(fn) {
+        for (const id of this.ids())
+            fn(this.wrap(id));
+    }
+    map(fn) {
+        return this.toArray().map(fn);
+    }
+    filter(fn) {
+        return this.toArray().filter(fn);
+    }
+    find(fn) {
+        for (const id of this.ids()) {
+            const item = this.wrap(id);
+            if (fn(item))
+                return item;
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=pool-base.js.map

package/dist/shared/pool-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool-base.js","sourceRoot":"","sources":["../../src/shared/pool-base.ts"],"names":[],"mappings":"AAAA,MAAM,OAAgB,IAAI;IAKzB,OAAO;QACN,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IAC1B,CAAC;IAED,OAAO,CAAC,EAAqB;QAC5B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE;YAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,GAAG,CAAI,EAAkB;QACxB,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,EAAwB;QAC9B,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,CAAC,EAAwB;QAC5B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC3B,IAAI,EAAE,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC3B,CAAC;QACD,OAAO,SAAS,CAAC;IAClB,CAAC;CACD"}

package/dist/shared/rpc-core.d.ts

@@ -0,0 +1,23 @@
+export declare const RpcNet: {
+    readonly req: "__fx:rpc:req";
+    readonly res: "__fx:rpc:res";
+};
+export interface RpcRequest {
+    id: string;
+    name: string;
+    args: unknown[];
+}
+export interface RpcResponse {
+    id: string;
+    ok: boolean;
+    result?: unknown;
+    error?: string;
+}
+export declare const RPC_TIMEOUT_MS = 10000;
+export declare function nextRpcId(): string;
+export declare class PendingRequests {
+    private map;
+    waitFor<T>(id: string, timeoutMs?: number): Promise<T>;
+    settle(res: RpcResponse): void;
+}
+//# sourceMappingURL=rpc-core.d.ts.map

package/dist/shared/rpc-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-core.d.ts","sourceRoot":"","sources":["../../src/shared/rpc-core.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;CAGT,CAAC;AAEX,MAAM,WAAW,UAAU;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,cAAc,QAAS,CAAC;AAIrC,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAQD,qBAAa,eAAe;IAC3B,OAAO,CAAC,GAAG,CAA6B;IAExC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,SAAiB,GAAG,OAAO,CAAC,CAAC,CAAC;IAU9D,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAU9B"}

package/dist/shared/rpc-core.js

@@ -0,0 +1,33 @@
+export const RpcNet = {
+    req: "__fx:rpc:req",
+    res: "__fx:rpc:res",
+};
+export const RPC_TIMEOUT_MS = 10_000;
+let counter = 0;
+export function nextRpcId() {
+    return `${Date.now().toString(36)}-${(counter++).toString(36)}`;
+}
+export class PendingRequests {
+    map = new Map();
+    waitFor(id, timeoutMs = RPC_TIMEOUT_MS) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.map.delete(id);
+                reject(new Error(`[fx] rpc '${id}' timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this.map.set(id, { resolve, reject, timer });
+        });
+    }
+    settle(res) {
+        const waiter = this.map.get(res.id);
+        if (!waiter)
+            return;
+        clearTimeout(waiter.timer);
+        this.map.delete(res.id);
+        if (res.ok)
+            waiter.resolve(res.result);
+        else
+            waiter.reject(new Error(res.error ?? "[fx] rpc failed"));
+    }
+}
+//# sourceMappingURL=rpc-core.js.map

package/dist/shared/rpc-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-core.js","sourceRoot":"","sources":["../../src/shared/rpc-core.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;IACrB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,cAAc;CACV,CAAC;AAeX,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AAErC,IAAI,OAAO,GAAG,CAAC,CAAC;AAEhB,MAAM,UAAU,SAAS;IACxB,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AACjE,CAAC;AAQD,MAAM,OAAO,eAAe;IACnB,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IAExC,OAAO,CAAI,EAAU,EAAE,SAAS,GAAG,cAAc;QAChD,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC7B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACpB,MAAM,CAAC,IAAI,KAAK,CAAC,aAAa,EAAE,qBAAqB,SAAS,IAAI,CAAC,CAAC,CAAC;YACtE,CAAC,EAAE,SAAS,CAAC,CAAC;YACd,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAgB;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAExB,IAAI,GAAG,CAAC,EAAE;YAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;;YAClC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,iBAAiB,CAAC,CAAC,CAAC;IAC/D,CAAC;CACD"}

package/package.json

@@ -0,0 +1,46 @@
+{
+	"name": "@panda0day/fivex",
+	"version": "0.2.1",
+	"type": "module",
+	"publishConfig": {
+		"access": "public"
+	},
+	"files": [
+		"dist"
+	],
+	"exports": {
+		"./client": {
+			"types": "./dist/client/index.d.ts",
+			"default": "./dist/client/index.js"
+		},
+		"./server": {
+			"types": "./dist/server/index.d.ts",
+			"default": "./dist/server/index.js"
+		},
+		"./shared": {
+			"types": "./dist/shared/index.d.ts",
+			"default": "./dist/shared/index.js"
+		}
+	},
+	"scripts": {
+		"build": "tsc -p tsconfig.client.json && tsc -p tsconfig.server.json",
+		"prepare": "npm run build",
+		"typecheck": "tsc --noEmit -p tsconfig.client.json && tsc --noEmit -p tsconfig.server.json",
+		"lint": "biome check .",
+		"format": "biome check --write .",
+		"docs": "typedoc",
+		"check": "npm run format && npm run typecheck && npm run build"
+	},
+	"peerDependencies": {
+		"@citizenfx/client": "*",
+		"@citizenfx/server": "*"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "2.5.12",
+		"@changesets/cli": "^3.0.2",
+		"@citizenfx/client": "^2.0.35214-1",
+		"@citizenfx/server": "^2.0.35214-1",
+		"typedoc": "^0.28.20",
+		"typescript": "^6.0.3"
+	}
+}