@open-core/framework 1.0.5-beta.1 → 1.0.5

package/dist/runtime/client/api.d.ts

@@ -1,8 +1,9 @@
 export * from './client-core';
 export * from './client-runtime';
+export * from './adapter';
 export * from './decorators';
 export * from './library';
-export * from './player/player';
 export * from './services';
 export * from './types';
+export * from './webview-bridge';
 export * from './ui-bridge';

package/dist/runtime/client/api.js

@@ -1,8 +1,9 @@
 export * from './client-core';
 export * from './client-runtime';
+export * from './adapter';
 export * from './decorators';
 export * from './library';
-export * from './player/player';
 export * from './services';
 export * from './types';
+export * from './webview-bridge';
 export * from './ui-bridge';

package/dist/runtime/client/client-bootstrap.js

@@ -1,13 +1,13 @@
-import { registerClientCapabilities } from '../../adapters/register-client-capabilities';
 import { MetadataScanner } from '../../kernel/di/metadata.scanner';
 import { loggers } from '../../kernel/logger';
+import { assertClientAdapterCompatibility, getActiveClientAdapterName, getCurrentClientResourceName, installClientAdapter, } from './adapter/registry';
 import { di } from './client-container';
 import { getClientRuntimeContext, setClientRuntimeContext, } from './client-runtime';
 import { getClientControllerRegistry } from './decorators';
-import { playerClientLoader } from './player/player.loader';
-import { BlipService, Camera, CameraEffectsRegistry, Cinematic, MarkerService, NotificationService, PedService, ProgressService, SpawnService, StreamingService, TextUIService, VehicleClientService, VehicleService, } from './services';
+import { BlipService, Camera, CameraEffectsRegistry, Cinematic, MarkerService, NotificationService, PedService, ProgressService, ClientSessionBridgeService, SpawnService, StreamingService, TextUIService, VehicleClientService, VehicleService, } from './services';
 import { registerSystemClient } from './system/processors.register';
-import { NuiBridge } from './ui-bridge';
+import { WebViewBridge } from './webview-bridge';
+import { WebViewService } from './webview.service';
 /**
  * Services that have an init() method which registers global runtime event listeners.
  *
@@ -15,13 +15,13 @@ import { NuiBridge } from './ui-bridge';
  * - Registered in DI for ALL modes (so they can be injected and used)
  * - Only initialized (.init() called) in CORE mode to avoid duplicate event handlers
  */
-const SERVICES_WITH_GLOBAL_LISTENERS = [SpawnService];
+const SERVICES_WITH_GLOBAL_LISTENERS = [SpawnService, ClientSessionBridgeService];
 /**
  * All client services that should be available in the DI container
  */
 // const ALL_CLIENT_SERVICES = [
 //   SpawnService,
-//   NuiBridge,
+//   WebViewBridge,
 //   NotificationService,
 //   TextUIService,
 //   ProgressService,
@@ -32,18 +32,6 @@ const SERVICES_WITH_GLOBAL_LISTENERS = [SpawnService];
 //   PedService,
 //   StreamingService,
 // ] as const
-/**
- * Get current resource name safely
- */
-function getCurrentResourceNameSafe() {
-    const fn = globalThis.GetCurrentResourceName;
-    if (typeof fn === 'function') {
-        const name = fn();
-        if (typeof name === 'string' && name.trim())
-            return name;
-    }
-    return 'default';
-}
 /**
  * Register singleton services in the DI container
  *
@@ -53,20 +41,38 @@ function getCurrentResourceNameSafe() {
  */
 function registerServices() {
     // Register all client services in DI (available in all modes)
-    di.registerSingleton(SpawnService, SpawnService);
-    di.registerSingleton(NuiBridge, NuiBridge);
-    di.registerSingleton(NotificationService, NotificationService);
-    di.registerSingleton(TextUIService, TextUIService);
-    di.registerSingleton(ProgressService, ProgressService);
-    di.registerSingleton(MarkerService, MarkerService);
-    di.registerSingleton(BlipService, BlipService);
-    di.registerSingleton(Camera, Camera);
-    di.registerSingleton(CameraEffectsRegistry, CameraEffectsRegistry);
-    di.registerSingleton(Cinematic, Cinematic);
-    di.registerSingleton(VehicleClientService, VehicleClientService);
-    di.registerSingleton(VehicleService, VehicleService);
-    di.registerSingleton(PedService, PedService);
-    di.registerSingleton(StreamingService, StreamingService);
+    if (!di.isRegistered(SpawnService))
+        di.registerSingleton(SpawnService, SpawnService);
+    if (!di.isRegistered(WebViewService))
+        di.registerSingleton(WebViewService, WebViewService);
+    if (!di.isRegistered(WebViewBridge))
+        di.registerSingleton(WebViewBridge, WebViewBridge);
+    if (!di.isRegistered(NotificationService))
+        di.registerSingleton(NotificationService, NotificationService);
+    if (!di.isRegistered(TextUIService))
+        di.registerSingleton(TextUIService, TextUIService);
+    if (!di.isRegistered(ProgressService))
+        di.registerSingleton(ProgressService, ProgressService);
+    if (!di.isRegistered(ClientSessionBridgeService))
+        di.registerSingleton(ClientSessionBridgeService, ClientSessionBridgeService);
+    if (!di.isRegistered(MarkerService))
+        di.registerSingleton(MarkerService, MarkerService);
+    if (!di.isRegistered(BlipService))
+        di.registerSingleton(BlipService, BlipService);
+    if (!di.isRegistered(Camera))
+        di.registerSingleton(Camera, Camera);
+    if (!di.isRegistered(CameraEffectsRegistry))
+        di.registerSingleton(CameraEffectsRegistry, CameraEffectsRegistry);
+    if (!di.isRegistered(Cinematic))
+        di.registerSingleton(Cinematic, Cinematic);
+    if (!di.isRegistered(VehicleClientService))
+        di.registerSingleton(VehicleClientService, VehicleClientService);
+    if (!di.isRegistered(VehicleService))
+        di.registerSingleton(VehicleService, VehicleService);
+    if (!di.isRegistered(PedService))
+        di.registerSingleton(PedService, PedService);
+    if (!di.isRegistered(StreamingService))
+        di.registerSingleton(StreamingService, StreamingService);
 }
 /**
  * Bootstrap services that need initialization
@@ -109,14 +115,13 @@ async function tryImportAutoLoad() {
  */
 export async function initClientCore(options = {}) {
     const mode = options.mode ?? 'CORE';
-    const resourceName = getCurrentResourceNameSafe();
-    // Register system processors early (needed for MetadataScanner)
-    // These processors are safe - they just process metadata, they don't register event handlers
-    // Each resource bundle needs its own copy registered in its DI container
-    registerSystemClient();
     // Check if already initialized
     const existingContext = getClientRuntimeContext();
     if (existingContext?.isInitialized) {
+        assertClientAdapterCompatibility(options.adapter);
+        // Register system processors for the active bundle if needed.
+        registerSystemClient();
+        const resourceName = getCurrentClientResourceName();
         // If already initialized, only scan controllers for this resource
         if (mode === 'RESOURCE' || mode === 'STANDALONE') {
             await tryImportAutoLoad();
@@ -128,29 +133,31 @@ export async function initClientCore(options = {}) {
         // If trying to initialize CORE mode twice, throw error
         throw new Error(`Client already initialized in ${existingContext.mode} mode by resource "${existingContext.resourceName}". Cannot initialize again in ${mode} mode.`);
     }
+    await installClientAdapter(options.adapter);
+    loggers.bootstrap.debug('Client adapter registered', {
+        adapter: getActiveClientAdapterName() ?? 'unknown',
+    });
+    const resourceName = getCurrentClientResourceName();
+    // Register system processors early (needed for MetadataScanner)
+    // These processors are safe - they just process metadata, they don't register event handlers
+    // Each resource bundle needs its own copy registered in its DI container
+    registerSystemClient();
     // Set runtime context
     setClientRuntimeContext({
         mode,
         resourceName,
         isInitialized: true,
     });
-    // Register client-side adapters (IPedAppearanceClient, IHasher)
-    await registerClientCapabilities();
     // Register all services in DI (available in all modes)
     registerServices();
     // Bootstrap services (only in CORE mode)
     // This is where services that register global event handlers are initialized
     await bootstrapServices(mode);
-    // Player loader (only in CORE mode)
-    if (mode === 'CORE') {
-        playerClientLoader();
-    }
     // Import framework controllers (only in CORE mode)
     // These controllers listen to global events and should only be registered once
     if (mode === 'CORE') {
         await import('./controllers/spawner.controller');
         await import('./controllers/appearance.controller');
-        await import('./controllers/player-sync.controller');
     }
     await tryImportAutoLoad();
     // Scan and register controllers

package/dist/runtime/client/client-core.d.ts

@@ -1,4 +1,6 @@
+import type { OpenCoreClientAdapter } from './adapter';
 import { ClientInitOptions } from './client-runtime';
+export declare function useAdapter(adapter: OpenCoreClientAdapter): void;
 /**
  * Initialize the OpenCore client framework
  *

package/dist/runtime/client/client-core.js

@@ -1,5 +1,10 @@
 import { initClientCore } from './client-bootstrap';
+import { installClientAdapter } from './adapter/registry';
 import { installClientPlugins } from './library/plugin/install-client-plugins';
+let pendingAdapter;
+export function useAdapter(adapter) {
+    pendingAdapter = adapter;
+}
 /**
  * Initialize the OpenCore client framework
  *
@@ -18,6 +23,10 @@ import { installClientPlugins } from './library/plugin/install-client-plugins';
  * ```
  */
 export async function init(options = {}) {
+    if (!options.adapter && pendingAdapter) {
+        options = { ...options, adapter: pendingAdapter };
+    }
+    await installClientAdapter(options.adapter);
     await installClientPlugins(options.plugins ?? [], options);
     await initClientCore(options);
 }

package/dist/runtime/client/client-runtime.d.ts

@@ -34,6 +34,8 @@ export interface ClientInitOptions {
      * Defaults to 'CORE' if not specified (for backwards compatibility).
      */
     mode?: ClientMode;
+    /** Optional runtime adapter for non-node client environments. */
+    adapter?: import('./adapter').OpenCoreClientAdapter;
     /**
      * Optional client plugins installed before bootstrap.
      */
@@ -61,3 +63,4 @@ export declare function setClientRuntimeContext(ctx: ClientRuntimeContext): void
  * Check if the client has been initialized
  */
 export declare function isClientInitialized(): boolean;
+export declare function __resetClientRuntimeContextForTests(): void;

package/dist/runtime/client/client-runtime.js

@@ -19,3 +19,6 @@ export function setClientRuntimeContext(ctx) {
 export function isClientInitialized() {
     return runtimeContext?.isInitialized ?? false;
 }
+export function __resetClientRuntimeContextForTests() {
+    runtimeContext = null;
+}

package/dist/runtime/client/controllers/appearance.controller.d.ts

@@ -1,8 +1,10 @@
 import { PlayerAppearance } from '../../../kernel/shared';
+import { IClientLocalPlayerBridge } from '../adapter/local-player-bridge';
 import { AppearanceService } from '../services/appearance.service';
 export declare class AppearanceTestClientController {
     private readonly appearanceService;
-    constructor(appearanceService: AppearanceService);
+    private readonly localPlayer;
+    constructor(appearanceService: AppearanceService, localPlayer: IClientLocalPlayerBridge);
     onApply(appearance: PlayerAppearance): Promise<void>;
     onReset(): void;
 }

package/dist/runtime/client/controllers/appearance.controller.js

@@ -11,31 +11,40 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { inject } from 'tsyringe';
+import { SYSTEM_EVENTS } from '../../shared/types/system-types';
 import { Controller, OnNet } from '../decorators';
+import { IClientLocalPlayerBridge } from '../adapter/local-player-bridge';
 import { AppearanceService } from '../services/appearance.service';
+import { loggers } from '../../../kernel/logger';
 let AppearanceTestClientController = class AppearanceTestClientController {
     appearanceService;
-    constructor(appearanceService) {
+    localPlayer;
+    constructor(appearanceService, localPlayer) {
         this.appearanceService = appearanceService;
+        this.localPlayer = localPlayer;
     }
     async onApply(appearance) {
-        const ped = PlayerPedId();
+        loggers.netEvent.debug('appearance:apply received', {
+            appearance,
+        });
+        const ped = this.localPlayer.getHandle();
         await this.appearanceService.applyAppearance(ped, appearance);
     }
     onReset() {
-        const ped = PlayerPedId();
+        loggers.netEvent.debug('appearance:reset received');
+        const ped = this.localPlayer.getHandle();
         this.appearanceService.setDefaultAppearance(ped);
         this.appearanceService.clearTattoos(ped);
     }
 };
 __decorate([
-    OnNet('opencore:appearance:apply'),
+    OnNet(SYSTEM_EVENTS.appearance.apply),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object]),
     __metadata("design:returntype", Promise)
 ], AppearanceTestClientController.prototype, "onApply", null);
 __decorate([
-    OnNet('opencore:appearance:reset'),
+    OnNet(SYSTEM_EVENTS.appearance.reset),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", []),
     __metadata("design:returntype", void 0)
@@ -43,6 +52,8 @@ __decorate([
 AppearanceTestClientController = __decorate([
     Controller(),
     __param(0, inject(AppearanceService)),
-    __metadata("design:paramtypes", [AppearanceService])
+    __param(1, inject(IClientLocalPlayerBridge)),
+    __metadata("design:paramtypes", [AppearanceService,
+        IClientLocalPlayerBridge])
 ], AppearanceTestClientController);
 export { AppearanceTestClientController };

package/dist/runtime/client/controllers/spawner.controller.js

@@ -7,6 +7,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
+import { loggers } from '../../../kernel/logger';
+import { SYSTEM_EVENTS } from '../../shared/types/system-types';
 import { Controller, OnNet } from '../decorators';
 import { SpawnService } from '../services';
 let SpawnerController = class SpawnerController {
@@ -15,6 +17,7 @@ let SpawnerController = class SpawnerController {
         this.spawnService = spawnService;
     }
     async handleSpawn(data) {
+        loggers.spawn.debug('Spawn event received', data);
         await this.spawnService.spawn(data.position, data.model);
     }
     async handleRespawn(position, heading = 0.0) {
@@ -25,19 +28,19 @@ let SpawnerController = class SpawnerController {
     }
 };
 __decorate([
-    OnNet('opencore:spawner:spawn'),
+    OnNet(SYSTEM_EVENTS.spawner.spawn),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object]),
     __metadata("design:returntype", Promise)
 ], SpawnerController.prototype, "handleSpawn", null);
 __decorate([
-    OnNet('opencore:spawner:respawn'),
+    OnNet(SYSTEM_EVENTS.spawner.respawn),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, Object]),
     __metadata("design:returntype", Promise)
 ], SpawnerController.prototype, "handleRespawn", null);
 __decorate([
-    OnNet('opencore:spawner:teleport'),
+    OnNet(SYSTEM_EVENTS.spawner.teleport),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, Number]),
     __metadata("design:returntype", Promise)

package/dist/runtime/client/decorators/controller.js

@@ -1,16 +1,8 @@
 import { injectable } from 'tsyringe';
+import { getCurrentClientResourceName } from '../adapter/registry';
 import { METADATA_KEYS } from '../system/metadata-client.keys';
 import { getClientRuntimeContext } from '../client-runtime';
 const clientControllerRegistryByResource = new Map();
-function getCurrentResourceNameSafe() {
-    const fn = globalThis.GetCurrentResourceName;
-    if (typeof fn === 'function') {
-        const name = fn();
-        if (typeof name === 'string' && name.trim())
-            return name;
-    }
-    return 'default';
-}
 function resolveRegistryKey(resourceName) {
     if (resourceName?.trim()) {
         return resourceName;
@@ -19,7 +11,7 @@ function resolveRegistryKey(resourceName) {
     if (runtime?.resourceName?.trim()) {
         return runtime.resourceName;
     }
-    return getCurrentResourceNameSafe();
+    return getCurrentClientResourceName();
 }
 export function getClientControllerRegistry(resourceName) {
     const key = resolveRegistryKey(resourceName);

package/dist/runtime/client/decorators/onView.d.ts

@@ -1,11 +1,11 @@
 /**
- * Registers a method as an onView callback handler. View are equal to NUI
+ * Registers a method as a WebView callback handler.
  *
  * @remarks
  * This decorator only stores metadata. During bootstrap, the framework binds the decorated method
- * to the NUI callback event name.
+ * to the active WebView runtime callback.
  *
- * @param eventName - onView callback name.
+ * @param eventName - Callback name.
  *
  * @example
  * ```ts

package/dist/runtime/client/decorators/onView.js

@@ -1,12 +1,12 @@
 import { METADATA_KEYS } from '../system/metadata-client.keys';
 /**
- * Registers a method as an onView callback handler. View are equal to NUI
+ * Registers a method as a WebView callback handler.
  *
  * @remarks
  * This decorator only stores metadata. During bootstrap, the framework binds the decorated method
- * to the NUI callback event name.
+ * to the active WebView runtime callback.
  *
- * @param eventName - onView callback name.
+ * @param eventName - Callback name.
  *
  * @example
  * ```ts

package/dist/runtime/client/index.d.ts

@@ -1,4 +1,5 @@
 export * from './api';
+export * from './adapter';
 export { Client, createClientRuntime } from './client-api-runtime';
 export type { ClientApi } from './client-api-runtime';
 export type { ClientPluginApi, OpenCoreClientPlugin, PluginInstallContext as ClientPluginInstallContext, } from './library/plugin';

package/dist/runtime/client/index.js

@@ -1,2 +1,3 @@
 export * from './api';
+export * from './adapter';
 export { Client, createClientRuntime } from './client-api-runtime';

package/dist/runtime/client/library/create-client-library.js

@@ -1,3 +1,5 @@
+import { EventsAPI } from '../../../adapters/contracts/transport/events.api';
+import { di } from '../client-container';
 import { coreLogger } from '../../../kernel/logger';
 import { buildLibraryEventId, createLibraryBase, createLibraryConfigAccessor, } from '../../core/library';
 import { emitLibraryEvent } from '../bus/library-event.bus';
@@ -14,6 +16,9 @@ export function createClientLibrary(name, opts) {
     const base = createLibraryBase(name, opts);
     const logger = coreLogger.client(`Library:${base.name}`);
     const emitInternal = base.emit;
+    const events = di.isRegistered(EventsAPI)
+        ? di.resolve(EventsAPI)
+        : null;
     return {
         ...base,
         side: 'client',
@@ -33,7 +38,10 @@ export function createClientLibrary(name, opts) {
             emitLibraryEvent(eventId, envelope);
         },
         emitServer(eventName, payload) {
-            emitNet(base.buildEventName(eventName), payload);
+            if (!events) {
+                throw new Error('[OpenCore] Client events transport is not registered.');
+            }
+            events.emit(base.buildEventName(eventName), payload);
         },
         getLogger() {
             return logger;

package/dist/runtime/client/services/appearance.service.d.ts

@@ -1,4 +1,4 @@
-import { IPedAppearanceClient } from '../../../adapters/contracts/client/IPedAppearanceClient';
+import { IGtaPedAppearanceBridge } from '../../../adapters/contracts/client/IGtaPedAppearanceBridge';
 import { IHasher } from '../../../adapters/contracts/IHasher';
 import { AppearanceValidationResult, PlayerAppearance } from '../../../kernel/shared';
 /**
@@ -23,7 +23,7 @@ import { AppearanceValidationResult, PlayerAppearance } from '../../../kernel/sh
 export declare class AppearanceService {
     private pedAdapter;
     private hasher;
-    constructor(pedAdapter: IPedAppearanceClient, hasher: IHasher);
+    constructor(pedAdapter: IGtaPedAppearanceBridge, hasher: IHasher);
     /**
      * Applies a complete appearance to a ped.
      *

package/dist/runtime/client/services/appearance.service.js

@@ -11,7 +11,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { inject, injectable } from 'tsyringe';
-import { IPedAppearanceClient } from '../../../adapters/contracts/client/IPedAppearanceClient';
+import { IGtaPedAppearanceBridge } from '../../../adapters/contracts/client/IGtaPedAppearanceBridge';
 import { IHasher } from '../../../adapters/contracts/IHasher';
 /**
  * Client-side appearance management service.
@@ -309,7 +309,10 @@ let AppearanceService = class AppearanceService {
      * @param ped - Ped entity handle
      */
     setDefaultAppearance(ped) {
-        this.pedAdapter.setDefaultComponentVariation(ped);
+        const adapter = this.pedAdapter;
+        if (typeof adapter?.setDefaultComponentVariation === 'function') {
+            adapter.setDefaultComponentVariation(ped);
+        }
     }
     /**
      * Clears all tattoos from a ped.
@@ -322,9 +325,9 @@ let AppearanceService = class AppearanceService {
 };
 AppearanceService = __decorate([
     injectable(),
-    __param(0, inject(IPedAppearanceClient)),
+    __param(0, inject(IGtaPedAppearanceBridge)),
     __param(1, inject(IHasher)),
-    __metadata("design:paramtypes", [IPedAppearanceClient,
+    __metadata("design:paramtypes", [IGtaPedAppearanceBridge,
         IHasher])
 ], AppearanceService);
 export { AppearanceService };

package/dist/runtime/client/services/blip.service.d.ts

@@ -1,112 +1,25 @@
 import { Vector3 } from '../../../kernel/utils/vector3';
-export interface BlipOptions {
-    /** Blip sprite ID (icon) */
-    sprite?: number;
-    /** Blip color ID */
-    color?: number;
-    /** Blip scale */
-    scale?: number;
-    /** Short range blip (only visible nearby) */
-    shortRange?: boolean;
-    /** Blip label/name */
-    label?: string;
-    /** Display category (affects visibility on map) */
-    display?: number;
-    /** Blip category */
-    category?: number;
-    /** Flash the blip */
-    flash?: boolean;
-    /** Blip alpha (0-255) */
-    alpha?: number;
-    /** Route to this blip */
-    route?: boolean;
-    /** Route color */
-    routeColor?: number;
-}
+import { IClientBlipBridge, type ClientBlipDefinition, type ClientBlipOptions as BlipOptions } from '../../../adapters/contracts/client/ui/IClientBlipBridge';
 export interface ManagedBlip {
     id: string;
-    handle: number;
-    position: Vector3;
-    options: BlipOptions;
+    definition: ClientBlipDefinition;
 }
-/**
- * Service for creating and managing map blips.
- */
 export declare class BlipService {
+    private readonly bridge;
     private blips;
     private idCounter;
-    /**
-     * Create a blip at a world position.
-     *
-     * @param position - World position
-     * @param options - Blip options
-     * @returns The blip ID
-     */
+    constructor(bridge: IClientBlipBridge);
     create(position: Vector3, options?: BlipOptions): string;
-    /**
-     * Create a blip attached to an entity.
-     *
-     * @param entity - Entity handle
-     * @param options - Blip options
-     * @returns The blip ID
-     */
     createForEntity(entity: number, options?: BlipOptions): string;
-    /**
-     * Create a blip for a radius/area.
-     *
-     * @param position - Center position
-     * @param radius - Radius of the area
-     * @param options - Blip options
-     * @returns The blip ID
-     */
     createForRadius(position: Vector3, radius: number, options?: BlipOptions): string;
-    /**
-     * Remove a blip by ID.
-     *
-     * @param id - The blip ID
-     */
     remove(id: string): boolean;
-    /**
-     * Remove all managed blips.
-     */
     removeAll(): void;
-    /**
-     * Update blip options.
-     *
-     * @param id - The blip ID
-     * @param options - New options to apply
-     */
     update(id: string, options: Partial<BlipOptions>): boolean;
-    /**
-     * Set blip position.
-     *
-     * @param id - The blip ID
-     * @param position - New position
-     */
     setPosition(id: string, position: Vector3): boolean;
-    /**
-     * Set whether a route should be drawn to the blip.
-     *
-     * @param id - The blip ID
-     * @param enabled - Whether to show the route
-     * @param color - Optional route color
-     */
     setRoute(id: string, enabled: boolean, color?: number): boolean;
-    /**
-     * Get blip by ID.
-     */
     get(id: string): ManagedBlip | undefined;
-    /**
-     * Get all managed blips.
-     */
     getAll(): ManagedBlip[];
-    /**
-     * Get the native blip handle by ID.
-     */
-    getHandle(id: string): number | undefined;
-    /**
-     * Check if a blip still exists in the game world.
-     */
     exists(id: string): boolean;
-    private applyOptions;
+    private buildDefinition;
+    private normalizeOptions;
 }