@open-core/framework 0.2.1-beta.1 → 0.2.4

package/dist/runtime/server/services/core/vehicle.service.d.ts

@@ -1,128 +0,0 @@
-import { Vehicle } from '../../entities/vehicle'
-import type {
-  VehicleCreateOptions,
-  VehicleSpawnResult,
-  SerializedVehicleData,
-} from '../../types/vehicle.types'
-import { PlayerDirectoryPort } from '../ports/player-directory.port'
-/**
- * Server-side service for managing vehicle entities.
- *
- * This service is the central authority for all vehicle operations:
- * - Creating vehicles server-side (prevents client-side spawning abuse)
- * - Managing vehicle registry by Network ID
- * - Validating permissions and positions
- * - Synchronizing vehicle state across clients
- *
- * @remarks
- * All vehicle creation MUST go through this service to ensure security.
- * Uses CreateVehicleServerSetter for server-authoritative spawning.
- */
-export declare class VehicleService {
-  private readonly playerDirectory
-  /**
-   * Internal registry of all managed vehicles indexed by Network ID
-   */
-  private vehiclesByNetworkId
-  constructor(playerDirectory: PlayerDirectoryPort)
-  /**
-   * Creates a new vehicle on the server.
-   *
-   * This method uses CreateVehicleServerSetter to spawn the vehicle server-side,
-   * preventing client-side spawning exploits.
-   *
-   * @param options - Vehicle creation options
-   * @returns Spawn result with network ID and handle
-   */
-  create(options: VehicleCreateOptions): Promise<VehicleSpawnResult>
-  /**
-   * Creates a vehicle for a specific player.
-   *
-   * @param clientID - Client ID of the requesting player
-   * @param options - Vehicle creation options
-   * @returns Spawn result
-   */
-  createForPlayer(clientID: number, options: VehicleCreateOptions): Promise<VehicleSpawnResult>
-  /**
-   * Retrieves a vehicle by its Network ID.
-   *
-   * @param networkId - Network ID of the vehicle
-   * @returns Vehicle entity or undefined
-   */
-  getByNetworkId(networkId: number): Vehicle | undefined
-  /**
-   * Retrieves a vehicle by its entity handle.
-   *
-   * @param handle - Entity handle
-   * @returns Vehicle entity or undefined
-   */
-  getByHandle(handle: number): Vehicle | undefined
-  /**
-   * Gets all vehicles owned by a specific player.
-   *
-   * @param clientID - Client ID of the owner
-   * @returns Array of vehicles
-   */
-  getPlayerVehicles(clientID: number): Vehicle[]
-  /**
-   * Gets all vehicles in a specific routing bucket.
-   *
-   * @param bucket - Routing bucket ID
-   * @returns Array of vehicles
-   */
-  getVehiclesInBucket(bucket: number): Vehicle[]
-  /**
-   * Gets all managed vehicles.
-   *
-   * @returns Array of all vehicles
-   */
-  getAll(): Vehicle[]
-  /**
-   * Deletes a vehicle from the server.
-   *
-   * @param networkId - Network ID of the vehicle to delete
-   * @param requestedBy - Optional client ID for permission validation
-   * @returns Success status
-   */
-  delete(networkId: number, requestedBy?: number): boolean
-  /**
-   * Deletes all vehicles owned by a player.
-   * Useful when a player disconnects.
-   *
-   * @param clientID - Client ID of the owner
-   */
-  deletePlayerVehicles(clientID: number): void
-  /**
-   * Validates if a player can perform an action on a vehicle.
-   *
-   * @param networkId - Network ID of the vehicle
-   * @param clientID - Client ID of the player
-   * @returns True if authorized
-   */
-  validateOwnership(networkId: number, clientID: number): boolean
-  /**
-   * Validates if a player is near a vehicle.
-   *
-   * @param networkId - Network ID of the vehicle
-   * @param clientID - Client ID of the player
-   * @param maxDistance - Maximum distance in units
-   * @returns True if within range
-   */
-  validateProximity(networkId: number, clientID: number, maxDistance?: number): boolean
-  /**
-   * Cleans up orphaned vehicles that no longer exist.
-   */
-  cleanup(): void
-  /**
-   * Gets the total count of managed vehicles.
-   *
-   * @returns Vehicle count
-   */
-  getCount(): number
-  /**
-   * Serializes all vehicles for data transfer.
-   *
-   * @returns Array of serialized vehicle data
-   */
-  serializeAll(): SerializedVehicleData[]
-}

package/dist/runtime/server/services/core/vehicle.service.js

@@ -1,391 +0,0 @@
-'use strict'
-var __decorate =
-  (this && this.__decorate) ||
-  function (decorators, target, key, desc) {
-    var c = arguments.length,
-      r =
-        c < 3
-          ? target
-          : desc === null
-            ? (desc = Object.getOwnPropertyDescriptor(target, key))
-            : desc,
-      d
-    if (typeof Reflect === 'object' && typeof Reflect.decorate === 'function')
-      r = Reflect.decorate(decorators, target, key, desc)
-    else
-      for (var i = decorators.length - 1; i >= 0; i--)
-        if ((d = decorators[i]))
-          r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r
-    return c > 3 && r && Object.defineProperty(target, key, r), r
-  }
-var __metadata =
-  (this && this.__metadata) ||
-  ((k, v) => {
-    if (typeof Reflect === 'object' && typeof Reflect.metadata === 'function')
-      return Reflect.metadata(k, v)
-  })
-var __param =
-  (this && this.__param) ||
-  ((paramIndex, decorator) => (target, key) => {
-    decorator(target, key, paramIndex)
-  })
-Object.defineProperty(exports, '__esModule', { value: true })
-exports.VehicleService = void 0
-const tsyringe_1 = require('tsyringe')
-const vehicle_1 = require('../../entities/vehicle')
-const logger_1 = require('../../../../kernel/shared/logger')
-const player_directory_port_1 = require('../ports/player-directory.port')
-/**
- * Server-side service for managing vehicle entities.
- *
- * This service is the central authority for all vehicle operations:
- * - Creating vehicles server-side (prevents client-side spawning abuse)
- * - Managing vehicle registry by Network ID
- * - Validating permissions and positions
- * - Synchronizing vehicle state across clients
- *
- * @remarks
- * All vehicle creation MUST go through this service to ensure security.
- * Uses CreateVehicleServerSetter for server-authoritative spawning.
- */
-let VehicleService = class VehicleService {
-  constructor(playerDirectory) {
-    this.playerDirectory = playerDirectory
-    /**
-     * Internal registry of all managed vehicles indexed by Network ID
-     */
-    this.vehiclesByNetworkId = new Map()
-  }
-  /**
-   * Creates a new vehicle on the server.
-   *
-   * This method uses CreateVehicleServerSetter to spawn the vehicle server-side,
-   * preventing client-side spawning exploits.
-   *
-   * @param options - Vehicle creation options
-   * @returns Spawn result with network ID and handle
-   */
-  async create(options) {
-    var _a
-    try {
-      const {
-        model,
-        position,
-        heading = 0,
-        plate,
-        primaryColor,
-        secondaryColor,
-        mods,
-        persistent = false,
-        ownership,
-        metadata,
-        routingBucket = 0,
-        locked = false,
-        fuel = 1.0,
-      } = options
-      const modelHash = typeof model === 'string' ? GetHashKey(model) : model
-      if (!IsModelInCdimage(modelHash) || !IsModelAVehicle(modelHash)) {
-        logger_1.coreLogger.error('Invalid vehicle model', { model, modelHash })
-        return {
-          networkId: 0,
-          handle: 0,
-          success: false,
-          error: `Invalid vehicle model: ${model}`,
-        }
-      }
-      const vehicleType = 'automobile'
-      const handle = CreateVehicleServerSetter(
-        modelHash,
-        vehicleType,
-        position.x,
-        position.y,
-        position.z,
-        heading,
-      )
-      if (!handle || handle === 0) {
-        logger_1.coreLogger.error('Failed to create vehicle', { model, position })
-        return {
-          networkId: 0,
-          handle: 0,
-          success: false,
-          error: 'Failed to create vehicle entity',
-        }
-      }
-      while (!DoesEntityExist(handle)) {
-        await new Promise((resolve) => setTimeout(resolve, 0))
-      }
-      const networkId = NetworkGetNetworkIdFromEntity(handle)
-      const vehicleOwnership = {
-        clientID: ownership === null || ownership === void 0 ? void 0 : ownership.clientID,
-        accountID: ownership === null || ownership === void 0 ? void 0 : ownership.accountID,
-        type:
-          (_a = ownership === null || ownership === void 0 ? void 0 : ownership.type) !== null &&
-          _a !== void 0
-            ? _a
-            : 'temporary',
-      }
-      const vehicle = new vehicle_1.Vehicle(
-        handle,
-        networkId,
-        vehicleOwnership,
-        persistent,
-        routingBucket,
-      )
-      if (plate) {
-        SetVehicleNumberPlateText(handle, plate)
-      }
-      if (primaryColor !== undefined || secondaryColor !== undefined) {
-        const [currentPrimary, currentSecondary] = GetVehicleColours(handle)
-        SetVehicleColours(
-          handle,
-          primaryColor !== null && primaryColor !== void 0 ? primaryColor : currentPrimary,
-          secondaryColor !== null && secondaryColor !== void 0 ? secondaryColor : currentSecondary,
-        )
-      }
-      if (mods) {
-        vehicle.applyMods(mods)
-      }
-      if (metadata) {
-        for (const [key, value] of Object.entries(metadata)) {
-          vehicle.setMetadata(key, value)
-        }
-      }
-      vehicle.setDoorsLocked(locked)
-      vehicle.setFuel(fuel)
-      if (routingBucket !== 0) {
-        vehicle.setRoutingBucket(routingBucket)
-      }
-      this.vehiclesByNetworkId.set(networkId, vehicle)
-      logger_1.coreLogger.info('Vehicle created', {
-        networkId,
-        model,
-        ownership: vehicleOwnership.type,
-        persistent,
-        totalVehicles: this.vehiclesByNetworkId.size,
-      })
-      emitNet('opencore:vehicle:created', -1, vehicle.serialize())
-      return {
-        networkId,
-        handle,
-        success: true,
-      }
-    } catch (error) {
-      logger_1.coreLogger.error('Error creating vehicle', { error, options })
-      return {
-        networkId: 0,
-        handle: 0,
-        success: false,
-        error: error instanceof Error ? error.message : 'Unknown error',
-      }
-    }
-  }
-  /**
-   * Creates a vehicle for a specific player.
-   *
-   * @param clientID - Client ID of the requesting player
-   * @param options - Vehicle creation options
-   * @returns Spawn result
-   */
-  async createForPlayer(clientID, options) {
-    const player = this.playerDirectory.getByClient(clientID)
-    if (!player) {
-      return {
-        networkId: 0,
-        handle: 0,
-        success: false,
-        error: 'Player not found',
-      }
-    }
-    const ownership = {
-      clientID,
-      accountID: player.accountID,
-      type: 'player',
-    }
-    return this.create(Object.assign(Object.assign({}, options), { ownership }))
-  }
-  /**
-   * Retrieves a vehicle by its Network ID.
-   *
-   * @param networkId - Network ID of the vehicle
-   * @returns Vehicle entity or undefined
-   */
-  getByNetworkId(networkId) {
-    return this.vehiclesByNetworkId.get(networkId)
-  }
-  /**
-   * Retrieves a vehicle by its entity handle.
-   *
-   * @param handle - Entity handle
-   * @returns Vehicle entity or undefined
-   */
-  getByHandle(handle) {
-    const networkId = NetworkGetNetworkIdFromEntity(handle)
-    return this.vehiclesByNetworkId.get(networkId)
-  }
-  /**
-   * Gets all vehicles owned by a specific player.
-   *
-   * @param clientID - Client ID of the owner
-   * @returns Array of vehicles
-   */
-  getPlayerVehicles(clientID) {
-    const vehicles = []
-    for (const vehicle of this.vehiclesByNetworkId.values()) {
-      if (vehicle.ownership.clientID === clientID) {
-        vehicles.push(vehicle)
-      }
-    }
-    return vehicles
-  }
-  /**
-   * Gets all vehicles in a specific routing bucket.
-   *
-   * @param bucket - Routing bucket ID
-   * @returns Array of vehicles
-   */
-  getVehiclesInBucket(bucket) {
-    const vehicles = []
-    for (const vehicle of this.vehiclesByNetworkId.values()) {
-      if (vehicle.routingBucket === bucket) {
-        vehicles.push(vehicle)
-      }
-    }
-    return vehicles
-  }
-  /**
-   * Gets all managed vehicles.
-   *
-   * @returns Array of all vehicles
-   */
-  getAll() {
-    return Array.from(this.vehiclesByNetworkId.values())
-  }
-  /**
-   * Deletes a vehicle from the server.
-   *
-   * @param networkId - Network ID of the vehicle to delete
-   * @param requestedBy - Optional client ID for permission validation
-   * @returns Success status
-   */
-  delete(networkId, requestedBy) {
-    const vehicle = this.vehiclesByNetworkId.get(networkId)
-    if (!vehicle) {
-      return false
-    }
-    if (requestedBy !== undefined) {
-      if (vehicle.ownership.clientID !== requestedBy) {
-        logger_1.coreLogger.warn('Unauthorized vehicle deletion attempt', {
-          networkId,
-          requestedBy,
-          owner: vehicle.ownership.clientID,
-        })
-        return false
-      }
-    }
-    vehicle.delete()
-    this.vehiclesByNetworkId.delete(networkId)
-    logger_1.coreLogger.info('Vehicle deleted', {
-      networkId,
-      totalVehicles: this.vehiclesByNetworkId.size,
-    })
-    emitNet('opencore:vehicle:deleted', -1, networkId)
-    return true
-  }
-  /**
-   * Deletes all vehicles owned by a player.
-   * Useful when a player disconnects.
-   *
-   * @param clientID - Client ID of the owner
-   */
-  deletePlayerVehicles(clientID) {
-    const vehicles = this.getPlayerVehicles(clientID)
-    for (const vehicle of vehicles) {
-      this.delete(vehicle.networkId)
-    }
-  }
-  /**
-   * Validates if a player can perform an action on a vehicle.
-   *
-   * @param networkId - Network ID of the vehicle
-   * @param clientID - Client ID of the player
-   * @returns True if authorized
-   */
-  validateOwnership(networkId, clientID) {
-    const vehicle = this.vehiclesByNetworkId.get(networkId)
-    if (!vehicle) return false
-    if (vehicle.ownership.type === 'server' || vehicle.ownership.type === 'shared') {
-      return true
-    }
-    return vehicle.ownership.clientID === clientID
-  }
-  /**
-   * Validates if a player is near a vehicle.
-   *
-   * @param networkId - Network ID of the vehicle
-   * @param clientID - Client ID of the player
-   * @param maxDistance - Maximum distance in units
-   * @returns True if within range
-   */
-  validateProximity(networkId, clientID, maxDistance = 10.0) {
-    const vehicle = this.vehiclesByNetworkId.get(networkId)
-    if (!vehicle || !vehicle.exists) return false
-    const player = this.playerDirectory.getByClient(clientID)
-    if (!player) return false
-    const playerPed = GetPlayerPed(player.clientIDStr)
-    if (!playerPed || playerPed === 0) return false
-    const playerPos = GetEntityCoords(playerPed)
-    const vehiclePos = vehicle.position
-    const distance = Math.sqrt(
-      (playerPos[0] - vehiclePos.x) ** 2 +
-        (playerPos[1] - vehiclePos.y) ** 2 +
-        (playerPos[2] - vehiclePos.z) ** 2,
-    )
-    return distance <= maxDistance
-  }
-  /**
-   * Cleans up orphaned vehicles that no longer exist.
-   */
-  cleanup() {
-    const toDelete = []
-    for (const [networkId, vehicle] of this.vehiclesByNetworkId.entries()) {
-      if (!vehicle.exists) {
-        toDelete.push(networkId)
-      }
-    }
-    for (const networkId of toDelete) {
-      this.vehiclesByNetworkId.delete(networkId)
-      logger_1.coreLogger.debug('Cleaned up orphaned vehicle', { networkId })
-    }
-    if (toDelete.length > 0) {
-      logger_1.coreLogger.info('Vehicle cleanup completed', {
-        cleaned: toDelete.length,
-        remaining: this.vehiclesByNetworkId.size,
-      })
-    }
-  }
-  /**
-   * Gets the total count of managed vehicles.
-   *
-   * @returns Vehicle count
-   */
-  getCount() {
-    return this.vehiclesByNetworkId.size
-  }
-  /**
-   * Serializes all vehicles for data transfer.
-   *
-   * @returns Array of serialized vehicle data
-   */
-  serializeAll() {
-    return Array.from(this.vehiclesByNetworkId.values()).map((v) => v.serialize())
-  }
-}
-exports.VehicleService = VehicleService
-exports.VehicleService = VehicleService = __decorate(
-  [
-    (0, tsyringe_1.injectable)(),
-    __param(0, (0, tsyringe_1.inject)(player_directory_port_1.PlayerDirectoryPort)),
-    __metadata('design:paramtypes', [player_directory_port_1.PlayerDirectoryPort]),
-  ],
-  VehicleService,
-)

package/dist/runtime/server/services/remote/remote-principal.provider.d.ts

@@ -1,55 +0,0 @@
-import { Player } from '../../entities'
-import { Principal, PrincipalProviderContract } from '../../contracts'
-import { IExports } from '../../../../adapters'
-import type { LinkedID } from '../types/linked-id'
-/**
- * Principal provider implementation for `RESOURCE` mode.
- *
- * @remarks
- * This provider delegates all principal/permission operations to CORE via exports.
- * It provides the full PrincipalProviderContract interface for RESOURCE mode.
- */
-export declare class RemotePrincipalProvider extends PrincipalProviderContract {
-  private readonly exportsService
-  constructor(exportsService: IExports)
-  /**
-   * Gets typed access to CORE resource exports.
-   */
-  private get core()
-  /**
-   * Gets the Principal for a connected player.
-   */
-  getPrincipal(player: Player): Promise<Principal | null>
-  /**
-   * Forces a refresh of the player's permissions from persistence.
-   */
-  refreshPrincipal(player: Player): Promise<void>
-  /**
-   * Gets Principal by account ID (works for offline players too).
-   */
-  getPrincipalByLinkedID(linkedID: LinkedID): Promise<Principal | null>
-  /**
-   * Quick permission check without fetching full Principal.
-   */
-  hasPermission(clientID: number, permission: string): Promise<boolean>
-  /**
-   * Quick rank check without fetching full Principal.
-   */
-  hasRank(clientID: number, requiredRank: number): Promise<boolean>
-  /**
-   * Check if player has any of the specified permissions.
-   */
-  hasAnyPermission(clientID: number, permissions: string[]): Promise<boolean>
-  /**
-   * Check if player has all of the specified permissions.
-   */
-  hasAllPermissions(clientID: number, permissions: string[]): Promise<boolean>
-  /**
-   * Get all permissions for a player.
-   */
-  getPermissions(clientID: number): Promise<string[]>
-  /**
-   * Get the rank value for a player.
-   */
-  getRank(clientID: number): Promise<number | null>
-}

package/dist/runtime/server/services/remote/remote-principal.provider.js

@@ -1,130 +0,0 @@
-'use strict'
-var __decorate =
-  (this && this.__decorate) ||
-  function (decorators, target, key, desc) {
-    var c = arguments.length,
-      r =
-        c < 3
-          ? target
-          : desc === null
-            ? (desc = Object.getOwnPropertyDescriptor(target, key))
-            : desc,
-      d
-    if (typeof Reflect === 'object' && typeof Reflect.decorate === 'function')
-      r = Reflect.decorate(decorators, target, key, desc)
-    else
-      for (var i = decorators.length - 1; i >= 0; i--)
-        if ((d = decorators[i]))
-          r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r
-    return c > 3 && r && Object.defineProperty(target, key, r), r
-  }
-var __metadata =
-  (this && this.__metadata) ||
-  ((k, v) => {
-    if (typeof Reflect === 'object' && typeof Reflect.metadata === 'function')
-      return Reflect.metadata(k, v)
-  })
-var __param =
-  (this && this.__param) ||
-  ((paramIndex, decorator) => (target, key) => {
-    decorator(target, key, paramIndex)
-  })
-Object.defineProperty(exports, '__esModule', { value: true })
-exports.RemotePrincipalProvider = void 0
-const tsyringe_1 = require('tsyringe')
-const runtime_1 = require('../../runtime')
-const contracts_1 = require('../../contracts')
-const adapters_1 = require('../../../../adapters')
-/**
- * Principal provider implementation for `RESOURCE` mode.
- *
- * @remarks
- * This provider delegates all principal/permission operations to CORE via exports.
- * It provides the full PrincipalProviderContract interface for RESOURCE mode.
- */
-let RemotePrincipalProvider = class RemotePrincipalProvider extends contracts_1.PrincipalProviderContract {
-  constructor(exportsService) {
-    super()
-    this.exportsService = exportsService
-  }
-  /**
-   * Gets typed access to CORE resource exports.
-   */
-  get core() {
-    const { coreResourceName } = (0, runtime_1.getRuntimeContext)()
-    const coreExports = this.exportsService.getResource(coreResourceName)
-    if (!coreExports) {
-      throw new Error(
-        `[OpenCore] CORE resource '${coreResourceName}' exports not found. ` +
-          `Ensure the CORE resource is started BEFORE RESOURCE mode resources.`,
-      )
-    }
-    return coreExports
-  }
-  /**
-   * Gets the Principal for a connected player.
-   */
-  async getPrincipal(player) {
-    return await this.core.getPrincipal(player.clientID)
-  }
-  /**
-   * Forces a refresh of the player's permissions from persistence.
-   */
-  async refreshPrincipal(player) {
-    await this.core.refreshPrincipal(player.clientID)
-  }
-  /**
-   * Gets Principal by account ID (works for offline players too).
-   */
-  async getPrincipalByLinkedID(linkedID) {
-    return await this.core.getPrincipalByAccountId(linkedID.toString())
-  }
-  // ═══════════════════════════════════════════════════════════════
-  // Convenience methods (not part of contract, but useful)
-  // ═══════════════════════════════════════════════════════════════
-  /**
-   * Quick permission check without fetching full Principal.
-   */
-  async hasPermission(clientID, permission) {
-    return await this.core.hasPermission(clientID, permission)
-  }
-  /**
-   * Quick rank check without fetching full Principal.
-   */
-  async hasRank(clientID, requiredRank) {
-    return await this.core.hasRank(clientID, requiredRank)
-  }
-  /**
-   * Check if player has any of the specified permissions.
-   */
-  async hasAnyPermission(clientID, permissions) {
-    return await this.core.hasAnyPermission(clientID, permissions)
-  }
-  /**
-   * Check if player has all of the specified permissions.
-   */
-  async hasAllPermissions(clientID, permissions) {
-    return await this.core.hasAllPermissions(clientID, permissions)
-  }
-  /**
-   * Get all permissions for a player.
-   */
-  async getPermissions(clientID) {
-    return await this.core.getPermissions(clientID)
-  }
-  /**
-   * Get the rank value for a player.
-   */
-  async getRank(clientID) {
-    return await this.core.getRank(clientID)
-  }
-}
-exports.RemotePrincipalProvider = RemotePrincipalProvider
-exports.RemotePrincipalProvider = RemotePrincipalProvider = __decorate(
-  [
-    (0, tsyringe_1.injectable)(),
-    __param(0, (0, tsyringe_1.inject)(adapters_1.IExports)),
-    __metadata('design:paramtypes', [adapters_1.IExports]),
-  ],
-  RemotePrincipalProvider,
-)