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

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;
 }

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

@@ -4,145 +4,110 @@ 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';
+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 { IClientMarkerBridge, } from '../../../adapters/contracts/client/ui/IClientMarkerBridge';
 const DEFAULT_OPTIONS = {
+    variant: 1,
     type: 1,
+    size: { x: 1.0, y: 1.0, z: 1.0 },
     scale: { x: 1.0, y: 1.0, z: 1.0 },
     rotation: { x: 0, y: 0, z: 0 },
     color: { r: 255, g: 0, b: 0, a: 200 },
+    bob: false,
     bobUpAndDown: false,
     faceCamera: false,
     rotate: false,
     drawOnEnts: false,
+    visible: true,
 };
-/**
- * Service for managing and rendering markers in the game world.
- * Handles automatic rendering via tick.
- */
 let MarkerService = class MarkerService {
-    markers = new Map();
-    tickHandle = null;
+    markers;
+    activeMarkers = new Map();
     idCounter = 0;
-    /**
-     * Create a new managed marker.
-     *
-     * @param position - World position for the marker
-     * @param options - Marker appearance options
-     * @returns The marker ID
-     */
+    constructor(markers) {
+        this.markers = markers;
+    }
     create(position, options = {}) {
         const id = `marker_${++this.idCounter}`;
-        const marker = {
+        const definition = this.buildDefinition(position, options);
+        this.markers.create(id, definition);
+        this.activeMarkers.set(id, {
             id,
-            position,
-            options: { ...DEFAULT_OPTIONS, ...options },
-            visible: true,
-        };
-        this.markers.set(id, marker);
-        this.ensureTickRunning();
+            definition,
+        });
         return id;
     }
-    /**
-     * Remove a marker by ID.
-     *
-     * @param id - The marker ID to remove
-     */
     remove(id) {
-        const deleted = this.markers.delete(id);
-        this.checkTickNeeded();
-        return deleted;
+        const removed = this.markers.remove(id);
+        if (removed)
+            this.activeMarkers.delete(id);
+        return removed;
     }
-    /**
-     * Remove all markers.
-     */
     removeAll() {
         this.markers.clear();
-        this.stopTick();
+        this.activeMarkers.clear();
     }
-    /**
-     * Update a marker's position.
-     *
-     * @param id - The marker ID
-     * @param position - New position
-     */
     setPosition(id, position) {
-        const marker = this.markers.get(id);
+        const marker = this.activeMarkers.get(id);
         if (!marker)
             return false;
-        marker.position = position;
-        return true;
+        const updated = this.markers.update(id, { position });
+        if (!updated)
+            return false;
+        marker.definition = { ...marker.definition, position };
+        return updated;
     }
-    /**
-     * Update marker options.
-     *
-     * @param id - The marker ID
-     * @param options - Options to update
-     */
     setOptions(id, options) {
-        const marker = this.markers.get(id);
+        const marker = this.activeMarkers.get(id);
         if (!marker)
             return false;
-        marker.options = { ...marker.options, ...options };
-        return true;
+        const patch = this.normalizeOptions(options);
+        const updated = this.markers.update(id, patch);
+        if (!updated)
+            return false;
+        marker.definition = { ...marker.definition, ...patch };
+        return updated;
     }
-    /**
-     * Set marker visibility.
-     *
-     * @param id - The marker ID
-     * @param visible - Whether the marker should be visible
-     */
     setVisible(id, visible) {
-        const marker = this.markers.get(id);
-        if (!marker)
-            return false;
-        marker.visible = visible;
-        return true;
+        return this.setOptions(id, { visible });
     }
-    /**
-     * Get a marker by ID.
-     */
     get(id) {
-        return this.markers.get(id);
+        return this.activeMarkers.get(id);
     }
-    /**
-     * Get all managed markers.
-     */
     getAll() {
-        return Array.from(this.markers.values());
+        return Array.from(this.activeMarkers.values());
     }
-    /**
-     * Draw a marker immediately (one frame only).
-     * For persistent markers, use create() instead.
-     */
     drawOnce(position, options = {}) {
-        const opts = { ...DEFAULT_OPTIONS, ...options };
-        DrawMarker(opts.type, position.x, position.y, position.z, 0, 0, 0, opts.rotation.x, opts.rotation.y, opts.rotation.z, opts.scale.x, opts.scale.y, opts.scale.z, opts.color.r, opts.color.g, opts.color.b, opts.color.a, opts.bobUpAndDown, opts.faceCamera, 2, opts.rotate, null, null, opts.drawOnEnts);
+        this.markers.draw(this.buildDefinition(position, options));
     }
-    ensureTickRunning() {
-        if (this.tickHandle !== null)
-            return;
-        this.tickHandle = setTick(() => {
-            for (const marker of this.markers.values()) {
-                if (!marker.visible)
-                    continue;
-                const { position, options } = marker;
-                DrawMarker(options.type, position.x, position.y, position.z, 0, 0, 0, options.rotation.x, options.rotation.y, options.rotation.z, options.scale.x, options.scale.y, options.scale.z, options.color.r, options.color.g, options.color.b, options.color.a, options.bobUpAndDown, options.faceCamera, 2, options.rotate, null, null, options.drawOnEnts);
-            }
-        });
+    exists(id) {
+        return this.markers.exists(id);
     }
-    stopTick() {
-        if (this.tickHandle !== null) {
-            clearTick(this.tickHandle);
-            this.tickHandle = null;
-        }
+    buildDefinition(position, options) {
+        return {
+            position,
+            ...this.normalizeOptions({ ...DEFAULT_OPTIONS, ...options }),
+        };
     }
-    checkTickNeeded() {
-        if (this.markers.size === 0) {
-            this.stopTick();
-        }
+    normalizeOptions(options) {
+        const { type, variant, scale, size, bob, bobUpAndDown, ...rest } = options;
+        return {
+            ...rest,
+            variant: variant ?? type,
+            size: size ?? scale,
+            bob: bob ?? bobUpAndDown,
+        };
     }
 };
 MarkerService = __decorate([
-    injectable()
+    injectable(),
+    __param(0, inject(IClientMarkerBridge)),
+    __metadata("design:paramtypes", [IClientMarkerBridge])
 ], MarkerService);
 export { MarkerService };

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

@@ -1,76 +1,25 @@
+import { IClientNotificationBridge, type ClientNotificationDefinition } from '../../../adapters/contracts/client/ui/IClientNotificationBridge';
+import { IClientLocalPlayerBridge } from '../adapter/local-player-bridge';
 export type NotificationType = 'info' | 'success' | 'warning' | 'error';
 export interface AdvancedNotificationOptions {
-    /** Notification title */
     title: string;
-    /** Notification subtitle */
     subtitle?: string;
-    /** Message text */
     message: string;
-    /** Texture dictionary for the icon */
-    textureDict?: string;
-    /** Texture name for the icon */
-    textureName?: string;
-    /** Icon type (1-7) */
-    iconType?: number;
-    /** Flash the notification */
     flash?: boolean;
-    /** Save to brief (map menu) */
     saveToBrief?: boolean;
-    /** Background color index */
     backgroundColor?: number;
 }
-/**
- * Service for displaying native GTA V notifications.
- */
 export declare class NotificationService {
-    /**
-     * Show a simple notification on screen.
-     *
-     * @param message - The message to display
-     * @param blink - Whether the notification should blink
-     */
+    private readonly notifications;
+    private readonly localPlayer;
+    constructor(notifications: IClientNotificationBridge, localPlayer: IClientLocalPlayerBridge);
     show(message: string, blink?: boolean): void;
-    /**
-     * Show a notification with a type indicator using throbber icons.
-     *
-     * @param message - The message to display
-     * @param type - The notification type
-     */
     showWithType(message: string, type?: NotificationType): void;
-    /**
-     * Show an advanced notification with picture/icon.
-     *
-     * @param options - Advanced notification options
-     */
     showAdvanced(options: AdvancedNotificationOptions): void;
-    /**
-     * Show a help notification (appears at top-left).
-     *
-     * @param message - The help message
-     * @param duration - How long to show in milliseconds (-1 for indefinite)
-     * @param beep - Play a beep sound
-     * @param looped - Keep showing until cleared
-     */
     showHelp(message: string, duration?: number, beep?: boolean, looped?: boolean): void;
-    /**
-     * Clear all help messages.
-     */
     clearHelp(): void;
-    /**
-     * Show a subtitle (centered at bottom of screen).
-     *
-     * @param message - The subtitle text
-     * @param duration - Duration in milliseconds
-     */
     showSubtitle(message: string, duration?: number): void;
-    /**
-     * Clear the current subtitle.
-     */
     clearSubtitle(): void;
-    /**
-     * Show a floating help text above the player's head.
-     *
-     * @param message - The message to display
-     */
     showFloatingHelp(message: string): void;
+    showRaw(definition: ClientNotificationDefinition): void;
 }