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

package/dist/runtime/client/services/camera.js

@@ -4,155 +4,99 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     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;
 };
-import { injectable } from 'tsyringe';
-/**
- * Injectable camera API that wraps FiveM scripted camera natives.
- *
- * @remarks
- * This class intentionally exposes low-level camera primitives so higher-level
- * systems can build cinematic workflows on top of it.
- */
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from 'tsyringe';
+import { IClientPlatformBridge } from '../adapter/platform-bridge';
 let Camera = class Camera {
+    platform;
     activeCam = null;
     rendering = false;
-    /**
-     * Creates a scripted camera and optionally initializes its transform.
-     */
+    constructor(platform) {
+        this.platform = platform;
+    }
     create(options = {}) {
-        const cam = CreateCam(options.camName ?? 'DEFAULT_SCRIPTED_CAMERA', options.active ?? false);
-        if (options.transform) {
+        const cam = this.platform.createCam(options.camName ?? 'DEFAULT_SCRIPTED_CAMERA', options.active ?? false);
+        if (options.transform)
             this.setTransform(cam, options.transform);
-        }
-        if (options.active) {
+        if (options.active)
             this.activeCam = cam;
-        }
         return cam;
     }
-    /**
-     * Returns the currently tracked active camera handle.
-     */
     getActiveCam() {
         return this.activeCam;
     }
-    /**
-     * Sets camera active state and tracks active handle.
-     */
     setActive(cam, active) {
-        SetCamActive(cam, active);
-        if (active) {
+        this.platform.setCamActive(cam, active);
+        if (active)
             this.activeCam = cam;
-        }
-        else if (this.activeCam === cam) {
+        else if (this.activeCam === cam)
             this.activeCam = null;
-        }
     }
-    /**
-     * Enables or disables scripted camera rendering.
-     */
     render(enable, options = {}) {
-        RenderScriptCams(enable, options.ease ?? false, options.easeTimeMs ?? 0, true, true);
+        this.platform.renderScriptCams(enable, options.ease ?? false, options.easeTimeMs ?? 0, true, true);
         this.rendering = enable;
     }
-    /**
-     * Returns whether scripted camera rendering is currently enabled.
-     */
     isRendering() {
         return this.rendering;
     }
-    /**
-     * Destroys a single camera.
-     */
     destroy(cam, destroyActiveCam = false) {
-        DestroyCam(cam, destroyActiveCam);
-        if (this.activeCam === cam) {
+        this.platform.destroyCam(cam, destroyActiveCam);
+        if (this.activeCam === cam)
             this.activeCam = null;
-        }
     }
-    /**
-     * Destroys all scripted cameras managed by the game runtime.
-     */
     destroyAll(destroyActiveCam = false) {
-        DestroyAllCams(destroyActiveCam);
+        this.platform.destroyAllCams(destroyActiveCam);
         this.activeCam = null;
     }
-    /**
-     * Sets camera world position.
-     */
     setPosition(cam, position) {
-        SetCamCoord(cam, position.x, position.y, position.z);
+        this.platform.setCamCoord(cam, position);
     }
-    /**
-     * Sets camera world rotation.
-     */
     setRotation(cam, rotation, rotationOrder = 2) {
-        SetCamRot(cam, rotation.x, rotation.y, rotation.z, rotationOrder);
+        this.platform.setCamRot(cam, rotation, rotationOrder);
     }
-    /**
-     * Sets camera field of view.
-     */
     setFov(cam, fov) {
-        SetCamFov(cam, fov);
+        this.platform.setCamFov(cam, fov);
     }
-    /**
-     * Applies a full transform to a camera in a single call path.
-     */
     setTransform(cam, transform) {
         this.setPosition(cam, transform.position);
-        if (transform.rotation) {
+        if (transform.rotation)
             this.setRotation(cam, transform.rotation);
-        }
-        if (typeof transform.fov === 'number') {
+        if (typeof transform.fov === 'number')
             this.setFov(cam, transform.fov);
-        }
     }
-    /**
-     * Points a camera at world coordinates.
-     */
     pointAtCoords(cam, position) {
-        PointCamAtCoord(cam, position.x, position.y, position.z);
+        this.platform.pointCamAtCoord(cam, position);
     }
-    /**
-     * Points a camera at an entity with an optional offset.
-     */
     pointAtEntity(cam, entity, offset = { x: 0, y: 0, z: 0 }) {
-        PointCamAtEntity(cam, entity, offset.x, offset.y, offset.z, true);
+        this.platform.pointCamAtEntity(cam, entity, offset);
     }
-    /**
-     * Removes point-at target from the camera.
-     */
     stopPointing(cam) {
-        StopCamPointing(cam);
+        this.platform.stopCamPointing(cam);
     }
-    /**
-     * Interpolates from one camera to another using native interpolation.
-     */
     interpolate(fromCam, toCam, durationMs, easeLocation = true, easeRotation = true) {
-        SetCamActiveWithInterp(toCam, fromCam, durationMs, easeLocation ? 1 : 0, easeRotation ? 1 : 0);
+        this.platform.setCamActiveWithInterp(toCam, fromCam, durationMs, easeLocation ? 1 : 0, easeRotation ? 1 : 0);
         this.activeCam = toCam;
     }
-    /**
-     * Starts a camera shake effect.
-     */
     shake(cam, options) {
-        ShakeCam(cam, options.type, options.amplitude);
+        this.platform.shakeCam(cam, options.type, options.amplitude);
     }
-    /**
-     * Stops camera shake for a camera.
-     */
     stopShaking(cam, stopImmediately = true) {
-        StopCamShaking(cam, stopImmediately);
+        this.platform.stopCamShaking(cam, stopImmediately);
     }
-    /**
-     * Fully resets camera rendering and internal camera tracking.
-     */
     reset(options = {}) {
-        if (this.rendering) {
+        if (this.rendering)
             this.render(false, options);
-        }
         this.destroyAll(false);
     }
 };
 Camera = __decorate([
-    injectable()
+    injectable(),
+    __param(0, inject(IClientPlatformBridge)),
+    __metadata("design:paramtypes", [IClientPlatformBridge])
 ], Camera);
 export { Camera };

package/dist/runtime/client/services/cinematic.d.ts

@@ -1,4 +1,6 @@
 import { Vector3 } from '../../../kernel/utils/vector3';
+import { IClientPlatformBridge } from '../adapter/platform-bridge';
+import { IClientRuntimeBridge } from '../adapter/runtime-bridge';
 import { type CameraEffectDefinition, type CameraEffectReference, CameraEffectsRegistry } from './camera-effects.registry';
 import { type CameraRotation, Camera } from './camera';
 import { SceneBuilder, type SceneBuildable } from './cinematic-builder';
@@ -227,12 +229,14 @@ export declare class CinematicHandle {
  */
 export declare class Cinematic {
     private readonly camera;
+    private readonly platform;
+    private readonly runtimeBridge;
     /**
      * Exposes the registry so consumers can add custom effects and presets.
      */
     readonly effects: CameraEffectsRegistry;
     private activeRuntime;
-    constructor(camera: Camera, effectsRegistry: CameraEffectsRegistry);
+    constructor(camera: Camera, effectsRegistry: CameraEffectsRegistry, platform: IClientPlatformBridge, runtimeBridge: IClientRuntimeBridge);
     /**
      * Creates a fluent cinematic scene builder bound to this service.
      */

package/dist/runtime/client/services/cinematic.js

@@ -7,7 +7,12 @@ 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 { injectable } from 'tsyringe';
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from 'tsyringe';
+import { IClientPlatformBridge } from '../adapter/platform-bridge';
+import { IClientRuntimeBridge } from '../adapter/runtime-bridge';
 import { CameraEffectsRegistry, } from './camera-effects.registry';
 import { Camera } from './camera';
 import { SceneBuilder } from './cinematic-builder';
@@ -46,7 +51,7 @@ export class CinematicHandle {
         if (this.runtime.paused)
             return;
         this.runtime.paused = true;
-        this.runtime.pauseStartedAt = GetGameTimer();
+        this.runtime.pauseStartedAt = Date.now();
         this.emit('paused', undefined);
     }
     /**
@@ -144,19 +149,23 @@ export class CinematicHandle {
  */
 let Cinematic = class Cinematic {
     camera;
+    platform;
+    runtimeBridge;
     /**
      * Exposes the registry so consumers can add custom effects and presets.
      */
     effects;
     activeRuntime = null;
-    constructor(camera, effectsRegistry) {
+    constructor(camera, effectsRegistry, platform, runtimeBridge) {
         this.camera = camera;
+        this.platform = platform;
+        this.runtimeBridge = runtimeBridge;
         this.effects = effectsRegistry;
         if (!this.effects.has('fadeIn')) {
             this.effects.registerBuiltins();
         }
-        const currentResource = GetCurrentResourceName();
-        on('onClientResourceStop', (resourceName) => {
+        const currentResource = this.runtimeBridge.getCurrentResourceName();
+        this.runtimeBridge.on('onClientResourceStop', (resourceName) => {
             if (resourceName !== currentResource)
                 return;
             this.cancel();
@@ -254,7 +263,7 @@ let Cinematic = class Cinematic {
         this.effects.register(effect);
     }
     async run(runtime, handle) {
-        const ped = PlayerPedId();
+        const ped = this.platform.getLocalPlayerPed();
         try {
             this.applyRuntimeFlags(runtime.definition, ped);
             let shotIndex = 0;
@@ -317,16 +326,16 @@ let Cinematic = class Cinematic {
     }
     applyRuntimeFlags(definition, ped) {
         if (definition.freezePlayer) {
-            FreezeEntityPosition(ped, true);
+            this.platform.freezeEntityPosition(ped, true);
         }
         if (definition.invinciblePlayer) {
-            SetEntityInvincible(ped, true);
+            this.platform.setEntityInvincible(ped, true);
         }
         if (definition.hideHud) {
-            DisplayHud(false);
+            this.platform.displayHud(false);
         }
         if (definition.hideRadar) {
-            DisplayRadar(false);
+            this.platform.displayRadar(false);
         }
     }
     cleanupRuntime(runtime, ped) {
@@ -335,18 +344,18 @@ let Cinematic = class Cinematic {
         this.camera.render(false, { ease: true, easeTimeMs: 250 });
         this.camera.destroy(runtime.camHandle, false);
         if (runtime.definition.freezePlayer) {
-            FreezeEntityPosition(ped, false);
+            this.platform.freezeEntityPosition(ped, false);
         }
         if (runtime.definition.invinciblePlayer) {
-            SetEntityInvincible(ped, false);
+            this.platform.setEntityInvincible(ped, false);
         }
         if (runtime.definition.hideHud) {
-            DisplayHud(true);
+            this.platform.displayHud(true);
         }
         if (runtime.definition.hideRadar) {
-            DisplayRadar(true);
+            this.platform.displayRadar(true);
         }
-        ClearTimecycleModifier();
+        this.platform.clearTimecycleModifier();
     }
     resolveGlobalEffects(definition) {
         const direct = definition.effects ?? [];
@@ -373,7 +382,7 @@ let Cinematic = class Cinematic {
         return effects;
     }
     async runShot(runtime, handle, shotIndex, shot, nodes, effects, durationMs) {
-        const start = GetGameTimer();
+        const start = this.runtimeBridge.getGameTimer();
         let previousTime = start;
         while (true) {
             if (runtime.cancelled) {
@@ -381,17 +390,18 @@ let Cinematic = class Cinematic {
                 return;
             }
             if (runtime.paused) {
-                previousTime = GetGameTimer();
+                previousTime = this.runtimeBridge.getGameTimer();
                 await delay(0);
                 continue;
             }
-            if (runtime.definition.skippable && IsControlJustPressed(0, runtime.options.skipControlId)) {
+            if (runtime.definition.skippable &&
+                this.platform.isControlJustPressed(0, runtime.options.skipControlId)) {
                 runtime.cancelled = true;
                 runtime.interruptStatus = 'cancelled';
                 await this.finalizeEffects(runtime, effects, 'cancelled', durationMs);
                 return;
             }
-            const now = GetGameTimer();
+            const now = this.runtimeBridge.getGameTimer();
             const elapsedMs = now - start;
             const deltaMs = now - previousTime;
             previousTime = now;
@@ -418,15 +428,16 @@ let Cinematic = class Cinematic {
         }
     }
     async waitStep(runtime, waitMs) {
-        const started = GetGameTimer();
-        while (GetGameTimer() - started < waitMs) {
+        const started = this.runtimeBridge.getGameTimer();
+        while (this.runtimeBridge.getGameTimer() - started < waitMs) {
             if (runtime.cancelled)
                 return;
             if (runtime.paused) {
                 await delay(0);
                 continue;
             }
-            if (runtime.definition.skippable && IsControlJustPressed(0, runtime.options.skipControlId)) {
+            if (runtime.definition.skippable &&
+                this.platform.isControlJustPressed(0, runtime.options.skipControlId)) {
                 runtime.cancelled = true;
                 runtime.interruptStatus = 'cancelled';
                 return;
@@ -476,15 +487,15 @@ let Cinematic = class Cinematic {
             normalized,
             deltaMs,
             drawSubtitle: (text) => {
-                BeginTextCommandDisplayText('STRING');
-                AddTextComponentSubstringPlayerName(text);
-                EndTextCommandDisplayText(0.5, 0.92);
+                this.platform.beginTextCommandDisplayText('STRING');
+                this.platform.addTextComponentSubstringPlayerName(text);
+                this.platform.endTextCommandDisplayText(0.5, 0.92);
             },
             drawLetterbox: (top, bottom, alpha = 230) => {
                 const topHeight = Math.max(0, Math.min(0.5, top));
                 const bottomHeight = Math.max(0, Math.min(0.5, bottom));
-                DrawRect(0.5, topHeight / 2, 1.0, topHeight, 0, 0, 0, alpha);
-                DrawRect(0.5, 1 - bottomHeight / 2, 1.0, bottomHeight, 0, 0, 0, alpha);
+                this.platform.drawRect(0.5, topHeight / 2, 1.0, topHeight, 0, 0, 0, alpha);
+                this.platform.drawRect(0.5, 1 - bottomHeight / 2, 1.0, bottomHeight, 0, 0, 0, alpha);
             },
         };
     }
@@ -536,7 +547,7 @@ let Cinematic = class Cinematic {
             case 'coords':
                 return { x: input.x, y: input.y, z: input.z };
             case 'entity': {
-                const [x, y, z] = GetEntityCoords(input.entity, true);
+                const { x, y, z } = this.platform.getEntityCoords(input.entity);
                 return {
                     x: x + (input.offset?.x ?? 0),
                     y: y + (input.offset?.y ?? 0),
@@ -544,7 +555,7 @@ let Cinematic = class Cinematic {
                 };
             }
             case 'entityBone': {
-                const [x, y, z] = GetWorldPositionOfEntityBone(input.entity, input.bone);
+                const { x, y, z } = this.platform.getWorldPositionOfEntityBone(input.entity, input.bone);
                 return {
                     x: x + (input.offset?.x ?? 0),
                     y: y + (input.offset?.y ?? 0),
@@ -777,7 +788,11 @@ let Cinematic = class Cinematic {
 };
 Cinematic = __decorate([
     injectable(),
+    __param(2, inject(IClientPlatformBridge)),
+    __param(3, inject(IClientRuntimeBridge)),
     __metadata("design:paramtypes", [Camera,
-        CameraEffectsRegistry])
+        CameraEffectsRegistry,
+        IClientPlatformBridge,
+        IClientRuntimeBridge])
 ], Cinematic);
 export { Cinematic };

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

@@ -7,6 +7,7 @@ export * from './marker.service';
 export * from './notification.service';
 export * from './ped.service';
 export * from './progress.service';
+export * from './session-bridge.service';
 export * from './spawn.service';
 export * from './streaming.service';
 export * from './textui.service';

package/dist/runtime/client/services/index.js

@@ -7,6 +7,7 @@ export * from './marker.service';
 export * from './notification.service';
 export * from './ped.service';
 export * from './progress.service';
+export * from './session-bridge.service';
 export * from './spawn.service';
 export * from './streaming.service';
 export * from './textui.service';

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

@@ -1,94 +1,43 @@
 import { Vector3 } from '../../../kernel/utils/vector3';
+import { IClientMarkerBridge, type ClientMarkerDefinition } from '../../../adapters/contracts/client/ui/IClientMarkerBridge';
 export interface MarkerOptions {
-    /** Marker type (0-43) */
+    variant?: number;
     type?: number;
-    /** Scale of the marker */
+    size?: Vector3;
     scale?: Vector3;
-    /** Rotation of the marker */
     rotation?: Vector3;
-    /** Color (RGBA) */
     color?: {
         r: number;
         g: number;
         b: number;
         a: number;
     };
-    /** Whether the marker should bob up and down */
+    bob?: boolean;
     bobUpAndDown?: boolean;
-    /** Whether the marker should face the camera */
     faceCamera?: boolean;
-    /** Whether the marker should rotate */
     rotate?: boolean;
-    /** Draw on entities */
     drawOnEnts?: boolean;
+    visible?: boolean;
 }
 export interface ManagedMarker {
     id: string;
-    position: Vector3;
-    options: Required<MarkerOptions>;
-    visible: boolean;
+    definition: ClientMarkerDefinition;
 }
-/**
- * Service for managing and rendering markers in the game world.
- * Handles automatic rendering via tick.
- */
 export declare class MarkerService {
-    private markers;
-    private tickHandle;
+    private readonly markers;
+    private activeMarkers;
     private idCounter;
-    /**
-     * Create a new managed marker.
-     *
-     * @param position - World position for the marker
-     * @param options - Marker appearance options
-     * @returns The marker ID
-     */
+    constructor(markers: IClientMarkerBridge);
     create(position: Vector3, options?: MarkerOptions): string;
-    /**
-     * Remove a marker by ID.
-     *
-     * @param id - The marker ID to remove
-     */
     remove(id: string): boolean;
-    /**
-     * Remove all markers.
-     */
     removeAll(): void;
-    /**
-     * Update a marker's position.
-     *
-     * @param id - The marker ID
-     * @param position - New position
-     */
     setPosition(id: string, position: Vector3): boolean;
-    /**
-     * Update marker options.
-     *
-     * @param id - The marker ID
-     * @param options - Options to update
-     */
     setOptions(id: string, options: Partial<MarkerOptions>): boolean;
-    /**
-     * Set marker visibility.
-     *
-     * @param id - The marker ID
-     * @param visible - Whether the marker should be visible
-     */
     setVisible(id: string, visible: boolean): boolean;
-    /**
-     * Get a marker by ID.
-     */
     get(id: string): ManagedMarker | undefined;
-    /**
-     * Get all managed markers.
-     */
     getAll(): ManagedMarker[];
-    /**
-     * Draw a marker immediately (one frame only).
-     * For persistent markers, use create() instead.
-     */
     drawOnce(position: Vector3, options?: MarkerOptions): void;
-    private ensureTickRunning;
-    private stopTick;
-    private checkTickNeeded;
+    exists(id: string): boolean;
+    private buildDefinition;
+    private normalizeOptions;
 }