@open-core/framework 1.0.1-beta.1

package/dist/client/decorators/interval.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Decorator for creating interval-based ticks.
+ * Unlike @Tick which runs every frame, @Interval runs at specified intervals.
+ *
+ * @param ms - Interval in milliseconds between executions
+ */
+export declare function Interval(ms: number): (target: any, propertyKey: string) => void;

package/dist/client/decorators/interval.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Interval = Interval;
+const metadata_client_keys_1 = require("../system/metadata-client.keys");
+/**
+ * Decorator for creating interval-based ticks.
+ * Unlike @Tick which runs every frame, @Interval runs at specified intervals.
+ *
+ * @param ms - Interval in milliseconds between executions
+ */
+function Interval(ms) {
+    return (target, propertyKey) => {
+        Reflect.defineMetadata(metadata_client_keys_1.METADATA_KEYS.INTERVAL, { interval: ms }, target, propertyKey);
+    };
+}

package/dist/client/decorators/key.d.ts

@@ -0,0 +1,2 @@
+import 'reflect-metadata';
+export declare function KeyMapping(key: string, description: string): (target: any, propertyKey: string) => void;

package/dist/client/decorators/key.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeyMapping = KeyMapping;
+require("reflect-metadata");
+const metadata_client_keys_1 = require("../system/metadata-client.keys");
+function KeyMapping(key, description) {
+    return (target, propertyKey) => {
+        Reflect.defineMetadata(metadata_client_keys_1.METADATA_KEYS.KEY, { key, description }, target, propertyKey);
+    };
+}

package/dist/client/decorators/localEvent.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Decorator for handling local events (non-networked).
+ * Use this for client-side only events.
+ *
+ * @param eventName - The name of the local event to listen for
+ */
+export declare function OnLocalEvent(eventName: string): (target: any, propertyKey: string) => void;

package/dist/client/decorators/localEvent.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OnLocalEvent = OnLocalEvent;
+const metadata_client_keys_1 = require("../system/metadata-client.keys");
+/**
+ * Decorator for handling local events (non-networked).
+ * Use this for client-side only events.
+ *
+ * @param eventName - The name of the local event to listen for
+ */
+function OnLocalEvent(eventName) {
+    return (target, propertyKey) => {
+        Reflect.defineMetadata(metadata_client_keys_1.METADATA_KEYS.LOCAL_EVENT, { eventName }, target, propertyKey);
+    };
+}

package/dist/client/decorators/nui.d.ts

@@ -0,0 +1 @@
+export declare function NuiCallback(eventName: string): (target: any, propertyKey: string) => void;

package/dist/client/decorators/nui.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NuiCallback = NuiCallback;
+const metadata_client_keys_1 = require("../system/metadata-client.keys");
+function NuiCallback(eventName) {
+    return (target, propertyKey) => {
+        Reflect.defineMetadata(metadata_client_keys_1.METADATA_KEYS.NUI, { eventName }, target, propertyKey);
+    };
+}

package/dist/client/decorators/onNet.d.ts

@@ -0,0 +1 @@
+export declare function OnNet(eventName: string): (target: any, propertyKey: string) => void;

package/dist/client/decorators/onNet.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OnNet = OnNet;
+const metadata_client_keys_1 = require("../system/metadata-client.keys");
+function OnNet(eventName) {
+    return (target, propertyKey) => {
+        Reflect.defineMetadata(metadata_client_keys_1.METADATA_KEYS.NET_EVENT, { eventName }, target, propertyKey);
+    };
+}

package/dist/client/decorators/resourceLifecycle.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Decorator for handling resource start events.
+ * Called when this resource starts.
+ */
+export declare function OnResourceStart(): (target: any, propertyKey: string) => void;
+/**
+ * Decorator for handling resource stop events.
+ * Called when this resource is about to stop.
+ * Useful for cleanup operations.
+ */
+export declare function OnResourceStop(): (target: any, propertyKey: string) => void;

package/dist/client/decorators/resourceLifecycle.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OnResourceStart = OnResourceStart;
+exports.OnResourceStop = OnResourceStop;
+const metadata_client_keys_1 = require("../system/metadata-client.keys");
+/**
+ * Decorator for handling resource start events.
+ * Called when this resource starts.
+ */
+function OnResourceStart() {
+    return (target, propertyKey) => {
+        Reflect.defineMetadata(metadata_client_keys_1.METADATA_KEYS.RESOURCE_START, {}, target, propertyKey);
+    };
+}
+/**
+ * Decorator for handling resource stop events.
+ * Called when this resource is about to stop.
+ * Useful for cleanup operations.
+ */
+function OnResourceStop() {
+    return (target, propertyKey) => {
+        Reflect.defineMetadata(metadata_client_keys_1.METADATA_KEYS.RESOURCE_STOP, {}, target, propertyKey);
+    };
+}

package/dist/client/decorators/tick.d.ts

@@ -0,0 +1 @@
+export declare function Tick(): (target: any, propertyKey: string) => void;

package/dist/client/decorators/tick.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tick = Tick;
+const metadata_client_keys_1 = require("../system/metadata-client.keys");
+function Tick() {
+    return (target, propertyKey) => {
+        Reflect.defineMetadata(metadata_client_keys_1.METADATA_KEYS.TICK, {}, target, propertyKey);
+    };
+}

package/dist/client/index.d.ts

@@ -0,0 +1,6 @@
+export * from './client-core';
+export * from './decorators';
+export * from './player/player';
+export * from './ui-bridge';
+export * from './services';
+export * from './types';

package/dist/client/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./client-core"), exports);
+__exportStar(require("./decorators"), exports);
+__exportStar(require("./player/player"), exports);
+__exportStar(require("./ui-bridge"), exports);
+__exportStar(require("./services"), exports);
+__exportStar(require("./types"), exports);

package/dist/client/loaders/exports.loader.d.ts

@@ -0,0 +1 @@
+export declare const loadClientExports: () => void;

package/dist/client/loaders/exports.loader.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadClientExports = void 0;
+const logger_1 = require("../../shared/logger");
+const clientExports = logger_1.coreLogger.child('Exports', logger_1.LogDomain.CLIENT);
+const loadClientExports = () => {
+    exports('core:sendcommand', (commandName, args = []) => {
+        const rawCommand = `/${commandName} ${args.join(' ')}`;
+        emitNet('core:internal:executeCommand', commandName, args, rawCommand);
+    });
+    clientExports.debug('Client exports loaded: SendCommand');
+};
+exports.loadClientExports = loadClientExports;

package/dist/client/player/player.d.ts

@@ -0,0 +1,262 @@
+import type { Vector3 } from '../../utils';
+interface PlayerSessionMeta {
+    playerId?: string;
+    [key: string]: unknown;
+}
+/**
+ * Client-side player representation with convenient accessors and methods.
+ */
+declare class Player {
+    private meta;
+    /** Get the player's ped handle */
+    get ped(): number;
+    /** Get the player ID */
+    get id(): number;
+    /** Get the server ID (source) */
+    get serverId(): number;
+    /** Get the player's current coordinates */
+    get coords(): Vector3;
+    /** Get the player's current heading (rotation) */
+    get heading(): number;
+    /** Get current health (0-200, 100 = dead) */
+    get health(): number;
+    /** Get max health */
+    get maxHealth(): number;
+    /** Get current armor (0-100) */
+    get armor(): number;
+    /** Check if the player is dead */
+    get isDead(): boolean;
+    /** Check if player is in water */
+    get isInWater(): boolean;
+    /** Check if player is swimming */
+    get isSwimming(): boolean;
+    /** Check if player is falling */
+    get isFalling(): boolean;
+    /** Check if player is climbing */
+    get isClimbing(): boolean;
+    /** Check if player is ragdolling */
+    get isRagdoll(): boolean;
+    /** Check if player is parachuting */
+    get isParachuting(): boolean;
+    /** Check if player is in any vehicle */
+    get isInVehicle(): boolean;
+    /** Get current vehicle handle (or null if not in vehicle) */
+    get currentVehicle(): number | null;
+    /** Get last vehicle the player was in */
+    get lastVehicle(): number | null;
+    /** Check if player is the driver of current vehicle */
+    get isDriver(): boolean;
+    /** Get current vehicle seat index (-1 = driver, 0+ = passengers) */
+    get vehicleSeat(): number | null;
+    /** Check if player is shooting */
+    get isShooting(): boolean;
+    /** Check if player is aiming */
+    get isAiming(): boolean;
+    /** Check if player is reloading */
+    get isReloading(): boolean;
+    /** Check if player is in cover */
+    get isInCover(): boolean;
+    /** Check if player is in melee combat */
+    get isInMeleeCombat(): boolean;
+    /** Get currently equipped weapon hash */
+    get currentWeapon(): number;
+    /** Get ammo count for current weapon */
+    get currentWeaponAmmo(): number;
+    /** Check if player is walking */
+    get isWalking(): boolean;
+    /** Check if player is running */
+    get isRunning(): boolean;
+    /** Check if player is sprinting */
+    get isSprinting(): boolean;
+    /** Check if player is on foot */
+    get isOnFoot(): boolean;
+    /** Check if player is stationary */
+    get isStill(): boolean;
+    /** Get movement speed in m/s */
+    get speed(): number;
+    /**
+     * Set player health.
+     * @param value - Health value (100 = dead, 200 = full)
+     */
+    setHealth(value: number): void;
+    /**
+     * Set player armor.
+     * @param value - Armor value (0-100)
+     */
+    setArmor(value: number): void;
+    /**
+     * Heal the player to full health and armor.
+     */
+    heal(): void;
+    /**
+     * Revive the player at current position.
+     */
+    revive(): void;
+    /**
+     * Set player coordinates.
+     * @param vector3 - Target position
+     * @param heading - Optional heading
+     */
+    setCoords(vector3: Vector3, heading?: number): void;
+    /**
+     * Set player heading/rotation.
+     * @param heading - Heading in degrees
+     */
+    setHeading(heading: number): void;
+    /**
+     * Freeze/unfreeze the player in place.
+     * @param freeze - Whether to freeze
+     */
+    freeze(freeze: boolean): void;
+    /**
+     * Set player invincibility.
+     * @param invincible - Whether invincible
+     */
+    setInvincible(invincible: boolean): void;
+    /**
+     * Set player visibility.
+     * @param visible - Whether visible
+     */
+    setVisible(visible: boolean): void;
+    /**
+     * Set player alpha/transparency.
+     * @param alpha - Alpha value (0-255)
+     */
+    setAlpha(alpha: number): void;
+    /**
+     * Give a weapon to the player.
+     * @param weapon - Weapon name (e.g., 'WEAPON_PISTOL')
+     * @param ammo - Ammo count
+     * @param equipNow - Whether to equip immediately
+     */
+    giveWeapon(weapon: string, ammo?: number, equipNow?: boolean): void;
+    /**
+     * Remove a weapon from the player.
+     * @param weapon - Weapon name
+     */
+    removeWeapon(weapon: string): void;
+    /**
+     * Remove all weapons from the player.
+     */
+    removeAllWeapons(): void;
+    /**
+     * Set current weapon ammo.
+     * @param weapon - Weapon name
+     * @param ammo - Ammo count
+     */
+    setWeaponAmmo(weapon: string, ammo: number): void;
+    /**
+     * Check if player has a specific weapon.
+     * @param weapon - Weapon name
+     */
+    hasWeapon(weapon: string): boolean;
+    /**
+     * Play an animation on the player.
+     * @param dict - Animation dictionary
+     * @param name - Animation name
+     * @param duration - Duration (-1 for looped)
+     * @param flags - Animation flags
+     */
+    playAnimation(dict: string, name: string, duration?: number, flags?: number): Promise<void>;
+    /**
+     * Stop current animation.
+     */
+    stopAnimation(): void;
+    /**
+     * Stop animation immediately.
+     */
+    stopAnimationImmediately(): void;
+    /**
+     * Check if player is playing a specific animation.
+     * @param dict - Animation dictionary
+     * @param name - Animation name
+     */
+    isPlayingAnimation(dict: string, name: string): boolean;
+    /**
+     * Warp player into a vehicle.
+     * @param vehicle - Vehicle handle
+     * @param seat - Seat index (-1 = driver)
+     */
+    warpIntoVehicle(vehicle: number, seat?: number): void;
+    /**
+     * Task player to exit current vehicle.
+     * @param flags - Exit flags (0 = normal, 16 = immediately)
+     */
+    exitVehicle(flags?: number): void;
+    /**
+     * Set can ragdoll.
+     * @param canRagdoll - Whether player can ragdoll
+     */
+    setCanRagdoll(canRagdoll: boolean): void;
+    /**
+     * Set ped config flag.
+     * @param flag - Flag ID
+     * @param value - Flag value
+     */
+    setConfigFlag(flag: number, value: boolean): void;
+    /**
+     * Get ped config flag.
+     * @param flag - Flag ID
+     */
+    getConfigFlag(flag: number): boolean;
+    /**
+     * Set a metadata value.
+     * @param key - Meta key
+     * @param value - Meta value
+     */
+    setMeta(key: string, value: unknown): void;
+    /**
+     * Get a metadata value.
+     * @param key - Meta key
+     */
+    getMeta<T = unknown>(key: string): T | undefined;
+    /**
+     * Delete a metadata value.
+     * @param key - Meta key
+     */
+    deleteMeta(key: string): void;
+    /**
+     * Get all metadata.
+     */
+    getAllMeta(): PlayerSessionMeta;
+    /**
+     * Clear all metadata.
+     */
+    clearMeta(): void;
+    /**
+     * Get distance to a position.
+     * @param position - Target position
+     */
+    distanceTo(position: Vector3): number;
+    /**
+     * Check if player is within range of a position.
+     * @param position - Target position
+     * @param range - Maximum range
+     */
+    isNearPosition(position: Vector3, range: number): boolean;
+    /**
+     * Get the entity the player is looking at.
+     * @param maxDistance - Maximum detection distance
+     */
+    getEntityLookingAt(maxDistance?: number): number | null;
+    /**
+     * Disable a control action.
+     * @param control - Control ID
+     * @param padIndex - Pad index (usually 0)
+     */
+    disableControl(control: number, padIndex?: number): void;
+    /**
+     * Check if a control is pressed.
+     * @param control - Control ID
+     * @param padIndex - Pad index (usually 0)
+     */
+    isControlPressed(control: number, padIndex?: number): boolean;
+    /**
+     * Check if a control was just pressed.
+     * @param control - Control ID
+     * @param padIndex - Pad index (usually 0)
+     */
+    isControlJustPressed(control: number, padIndex?: number): boolean;
+}
+export declare const ClientPlayer: Player;
+export {};