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

package/dist/adapters/contracts/client/spawn/IClientSpawnBridge.js

@@ -0,0 +1,2 @@
+export class IClientSpawnBridge {
+}

package/dist/adapters/contracts/client/spawn/index.d.ts

@@ -0,0 +1,2 @@
+export * from './IClientSpawnBridge';
+export * from './types';

package/dist/adapters/contracts/client/spawn/index.js

@@ -0,0 +1,2 @@
+export * from './IClientSpawnBridge';
+export * from './types';

package/dist/adapters/contracts/client/spawn/types.d.ts

@@ -0,0 +1,14 @@
+import type { Vector3 } from '../../../../kernel/utils/vector3';
+export interface SpawnRequest {
+    position: Vector3;
+    model: string;
+    heading?: number;
+}
+export interface TeleportRequest {
+    position: Vector3;
+    heading?: number;
+}
+export interface RespawnRequest {
+    position: Vector3;
+    heading?: number;
+}

package/dist/adapters/contracts/client/ui/IClientBlipBridge.d.ts

@@ -0,0 +1,25 @@
+import type { Vector3 } from '../../../../kernel/utils/vector3';
+export interface ClientBlipOptions {
+    icon?: number;
+    sprite?: number;
+    color?: number;
+    scale?: number;
+    shortRange?: boolean;
+    label?: string;
+    alpha?: number;
+    route?: boolean;
+    routeColor?: number;
+    visible?: boolean;
+}
+export interface ClientBlipDefinition extends ClientBlipOptions {
+    position?: Vector3;
+    entity?: number;
+    radius?: number;
+}
+export declare abstract class IClientBlipBridge {
+    abstract create(id: string, definition: ClientBlipDefinition): void;
+    abstract update(id: string, patch: Partial<ClientBlipDefinition>): boolean;
+    abstract exists(id: string): boolean;
+    abstract remove(id: string): boolean;
+    abstract clear(): void;
+}

package/dist/adapters/contracts/client/ui/IClientBlipBridge.js

@@ -0,0 +1,2 @@
+export class IClientBlipBridge {
+}

package/dist/adapters/contracts/client/ui/IClientMarkerBridge.d.ts

@@ -0,0 +1,31 @@
+import type { Vector3 } from '../../../../kernel/utils/vector3';
+export interface ClientMarkerOptions {
+    variant?: number;
+    type?: number;
+    size?: Vector3;
+    scale?: Vector3;
+    visible?: boolean;
+    bob?: boolean;
+    bobUpAndDown?: boolean;
+    faceCamera?: boolean;
+    rotate?: boolean;
+    drawOnEnts?: boolean;
+    color?: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    };
+}
+export interface ClientMarkerDefinition extends ClientMarkerOptions {
+    position: Vector3;
+    rotation?: Vector3;
+}
+export declare abstract class IClientMarkerBridge {
+    abstract create(id: string, definition: ClientMarkerDefinition): void;
+    abstract update(id: string, patch: Partial<ClientMarkerDefinition>): boolean;
+    abstract remove(id: string): boolean;
+    abstract exists(id: string): boolean;
+    abstract clear(): void;
+    abstract draw(definition: ClientMarkerDefinition): void;
+}

package/dist/adapters/contracts/client/ui/IClientMarkerBridge.js

@@ -0,0 +1,2 @@
+export class IClientMarkerBridge {
+}

package/dist/adapters/contracts/client/ui/IClientNotificationBridge.d.ts

@@ -0,0 +1,21 @@
+import type { Vector3 } from '../../../../kernel/utils/vector3';
+export type ClientNotificationKind = 'feed' | 'typed' | 'advanced' | 'help' | 'subtitle' | 'floating';
+export interface ClientNotificationDefinition {
+    kind: ClientNotificationKind;
+    message: string;
+    title?: string;
+    subtitle?: string;
+    type?: 'info' | 'success' | 'warning' | 'error';
+    blink?: boolean;
+    duration?: number;
+    beep?: boolean;
+    looped?: boolean;
+    flash?: boolean;
+    saveToBrief?: boolean;
+    backgroundColor?: number;
+    worldPosition?: Vector3;
+}
+export declare abstract class IClientNotificationBridge {
+    abstract show(definition: ClientNotificationDefinition): void;
+    abstract clear(scope?: 'help' | 'subtitle' | 'all'): void;
+}

package/dist/adapters/contracts/client/ui/IClientNotificationBridge.js

@@ -0,0 +1,2 @@
+export class IClientNotificationBridge {
+}

package/dist/adapters/contracts/client/ui/index.d.ts

@@ -0,0 +1,4 @@
+export * from './IClientBlipBridge';
+export * from './IClientMarkerBridge';
+export * from './IClientNotificationBridge';
+export * from './webview';

package/dist/adapters/contracts/client/ui/index.js

@@ -0,0 +1,4 @@
+export * from './IClientBlipBridge';
+export * from './IClientMarkerBridge';
+export * from './IClientNotificationBridge';
+export * from './webview';

package/dist/adapters/contracts/client/ui/webview/IClientWebViewBridge.d.ts

@@ -0,0 +1,13 @@
+import type { WebViewCapabilities, WebViewDefinition, WebViewFocusOptions, WebViewMessage } from './types';
+export declare abstract class IClientWebViewBridge {
+    abstract getCapabilities(): WebViewCapabilities;
+    abstract create(definition: WebViewDefinition): void;
+    abstract destroy(viewId: string): void;
+    abstract exists(viewId: string): boolean;
+    abstract show(viewId: string): void;
+    abstract hide(viewId: string): void;
+    abstract focus(viewId: string, options?: WebViewFocusOptions): void;
+    abstract blur(viewId: string): void;
+    abstract send(viewId: string, event: string, payload: unknown): void;
+    abstract onMessage(handler: (message: WebViewMessage) => void | Promise<void>): () => void;
+}

package/dist/adapters/contracts/client/ui/webview/IClientWebViewBridge.js

@@ -0,0 +1,2 @@
+export class IClientWebViewBridge {
+}

package/dist/adapters/contracts/client/ui/webview/index.d.ts

@@ -0,0 +1,2 @@
+export * from './IClientWebViewBridge';
+export * from './types';

package/dist/adapters/contracts/client/ui/webview/index.js

@@ -0,0 +1,2 @@
+export * from './IClientWebViewBridge';
+export * from './types';

package/dist/adapters/contracts/client/ui/webview/types.d.ts

@@ -0,0 +1,25 @@
+export interface WebViewCapabilities {
+    supportsFocus: boolean;
+    supportsCursor: boolean;
+    supportsInputPassthrough: boolean;
+    supportsBidirectionalMessaging: boolean;
+    supportsExecute: boolean;
+    supportsHeadless: boolean;
+}
+export interface WebViewDefinition {
+    id: string;
+    url: string;
+    visible?: boolean;
+    focused?: boolean;
+    cursor?: boolean;
+    inputPassthrough?: boolean;
+}
+export interface WebViewFocusOptions {
+    cursor?: boolean;
+    inputPassthrough?: boolean;
+}
+export interface WebViewMessage {
+    viewId: string;
+    event: string;
+    payload: unknown;
+}

package/dist/adapters/contracts/index.d.ts

@@ -1,2 +1,4 @@
-export * from './transport/events.api';
-export * from './transport/rpc.api';
+export * from './IHasher';
+export * from './types';
+export * from './transport';
+export * from './runtime';

package/dist/adapters/contracts/index.js

@@ -1,3 +1,4 @@
-// Transport API
-export * from './transport/events.api';
-export * from './transport/rpc.api';
+export * from './IHasher';
+export * from './types';
+export * from './transport';
+export * from './runtime';

package/dist/adapters/contracts/runtime/index.d.ts

@@ -0,0 +1 @@
+export * from './runtime-events';

package/dist/adapters/contracts/runtime/index.js

@@ -0,0 +1 @@
+export * from './runtime-events';

package/dist/adapters/contracts/runtime/runtime-events.d.ts

@@ -0,0 +1,9 @@
+export declare const RUNTIME_EVENTS: {
+    readonly playerJoining: "playerJoining";
+    readonly playerDropped: "playerDropped";
+    readonly serverResourceStop: "onServerResourceStop";
+    readonly playerCommand: "playerCommand";
+};
+export type RuntimeEventName = (typeof RUNTIME_EVENTS)[keyof typeof RUNTIME_EVENTS];
+export type RuntimeEventMap = Record<RuntimeEventName, string>;
+export declare const DEFAULT_RUNTIME_EVENT_MAP: RuntimeEventMap;

package/dist/adapters/contracts/runtime/runtime-events.js

@@ -0,0 +1,7 @@
+export const RUNTIME_EVENTS = {
+    playerJoining: 'playerJoining',
+    playerDropped: 'playerDropped',
+    serverResourceStop: 'onServerResourceStop',
+    playerCommand: 'playerCommand',
+};
+export const DEFAULT_RUNTIME_EVENT_MAP = Object.fromEntries(Object.values(RUNTIME_EVENTS).map((e) => [e, e]));

package/dist/adapters/contracts/server/IEntityServer.d.ts

@@ -98,25 +98,23 @@ export declare abstract class IEntityServer {
      * Sets entity routing bucket (virtual world/dimension).
      *
      * @remarks
-     * Not all platforms support routing buckets.
-     * Use IPlatformCapabilities.supportsRoutingBuckets to check support.
+     * Platform-specific behavior may vary.
      *
      * @param handle - Entity handle
      * @param bucket - Routing bucket ID
      */
-    abstract setRoutingBucket(handle: number, bucket: number): void;
+    abstract setDimension(handle: number, bucket: number): void;
     /**
      * Gets entity routing bucket (virtual world/dimension).
      * @param handle - Entity handle
      * @returns Routing bucket ID (0 is default world)
      */
-    abstract getRoutingBucket(handle: number): number;
+    abstract getDimension(handle: number): number;
     /**
      * Gets the state bag interface for an entity.
      *
      * @remarks
-     * Not all platforms support state bags.
-     * Use IPlatformCapabilities.supportsStateBags to check support.
+     * Platform-specific behavior may vary.
      *
      * @param handle - Entity handle
      */
@@ -145,28 +143,6 @@ export declare abstract class IEntityServer {
      * @param armor - Armor value
      */
     abstract setArmor(handle: number, armor: number): void;
-    /**
-     * Gets entity dimension (alias for getRoutingBucket).
-     *
-     * @remarks
-     * This is a cross-platform alias. Some platforms call it "dimension",
-     * others call it "routing bucket" or "virtual world".
-     *
-     * @param handle - Entity handle
-     * @returns Dimension ID
-     */
-    getDimension(handle: number): number;
-    /**
-     * Sets entity dimension (alias for setRoutingBucket).
-     *
-     * @remarks
-     * This is a cross-platform alias. Some platforms call it "dimension",
-     * others call it "routing bucket" or "virtual world".
-     *
-     * @param handle - Entity handle
-     * @param dimension - Dimension ID
-     */
-    setDimension(handle: number, dimension: number): void;
 }
 /**
  * State bag interface for entity state synchronization.

package/dist/adapters/contracts/server/IEntityServer.js

@@ -6,30 +6,4 @@
  * Allows the runtime to work without direct platform dependencies.
  */
 export class IEntityServer {
-    /**
-     * Gets entity dimension (alias for getRoutingBucket).
-     *
-     * @remarks
-     * This is a cross-platform alias. Some platforms call it "dimension",
-     * others call it "routing bucket" or "virtual world".
-     *
-     * @param handle - Entity handle
-     * @returns Dimension ID
-     */
-    getDimension(handle) {
-        return this.getRoutingBucket(handle);
-    }
-    /**
-     * Sets entity dimension (alias for setRoutingBucket).
-     *
-     * @remarks
-     * This is a cross-platform alias. Some platforms call it "dimension",
-     * others call it "routing bucket" or "virtual world".
-     *
-     * @param handle - Entity handle
-     * @param dimension - Dimension ID
-     */
-    setDimension(handle, dimension) {
-        this.setRoutingBucket(handle, dimension);
-    }
 }

package/dist/adapters/contracts/server/IPlayerServer.d.ts

@@ -21,6 +21,10 @@ export declare abstract class IPlayerServer {
      * @param reason - Kick reason message
      */
     abstract drop(playerSrc: string, reason: string): void;
+    /**
+     * Sets the active player model when the runtime supports it.
+     */
+    abstract setModel(playerSrc: string, model: string): void;
     /**
      * Gets a player identifier by type.
      *
@@ -68,20 +72,19 @@ export declare abstract class IPlayerServer {
      * Sets player routing bucket (virtual world/dimension).
      *
      * @remarks
-     * Not all platforms support routing buckets.
-     * Use IPlatformCapabilities.supportsRoutingBuckets to check support.
+     * Platform-specific behavior may vary.
      *
      * @param playerSrc - Player source/client ID (as string)
      * @param bucket - Routing bucket ID
      */
-    abstract setRoutingBucket(playerSrc: string, bucket: number): void;
+    abstract setDimension(playerSrc: string, bucket: number): void;
     /**
      * Gets player routing bucket (virtual world/dimension).
      *
      * @param playerSrc - Player source/client ID (as string)
      * @returns Routing bucket ID (0 is default world)
      */
-    abstract getRoutingBucket(playerSrc: string): number;
+    abstract getDimension(playerSrc: string): number;
     /**
      * Gets all currently connected player sources.
      *
@@ -92,26 +95,4 @@ export declare abstract class IPlayerServer {
      * @returns Array of player source strings
      */
     abstract getConnectedPlayers(): string[];
-    /**
-     * Gets player dimension (alias for getRoutingBucket).
-     *
-     * @remarks
-     * Cross-platform alias. Some platforms call it "dimension",
-     * others call it "routing bucket" or "virtual world".
-     *
-     * @param playerSrc - Player source/client ID (as string)
-     * @returns Dimension ID
-     */
-    getDimension(playerSrc: string): number;
-    /**
-     * Sets player dimension (alias for setRoutingBucket).
-     *
-     * @remarks
-     * Cross-platform alias. Some platforms call it "dimension",
-     * others call it "routing bucket" or "virtual world".
-     *
-     * @param playerSrc - Player source/client ID (as string)
-     * @param dimension - Dimension ID
-     */
-    setDimension(playerSrc: string, dimension: number): void;
 }

package/dist/adapters/contracts/server/IPlayerServer.js

@@ -6,30 +6,4 @@
  * Allows the runtime to work without direct platform dependencies.
  */
 export class IPlayerServer {
-    /**
-     * Gets player dimension (alias for getRoutingBucket).
-     *
-     * @remarks
-     * Cross-platform alias. Some platforms call it "dimension",
-     * others call it "routing bucket" or "virtual world".
-     *
-     * @param playerSrc - Player source/client ID (as string)
-     * @returns Dimension ID
-     */
-    getDimension(playerSrc) {
-        return this.getRoutingBucket(playerSrc);
-    }
-    /**
-     * Sets player dimension (alias for setRoutingBucket).
-     *
-     * @remarks
-     * Cross-platform alias. Some platforms call it "dimension",
-     * others call it "routing bucket" or "virtual world".
-     *
-     * @param playerSrc - Player source/client ID (as string)
-     * @param dimension - Dimension ID
-     */
-    setDimension(playerSrc, dimension) {
-        this.setRoutingBucket(playerSrc, dimension);
-    }
 }

package/dist/adapters/contracts/server/index.d.ts

@@ -0,0 +1,10 @@
+export * from './IEntityServer';
+export * from './npc-lifecycle';
+export * from './IPedAppearanceServer';
+export * from './IPedServer';
+export * from './player-appearance';
+export * from './player-state';
+export * from './IPlayerServer';
+export * from './IVehicleServer';
+export * from './player-lifecycle';
+export * from './vehicle-lifecycle';

package/dist/adapters/contracts/server/index.js

@@ -0,0 +1,10 @@
+export * from './IEntityServer';
+export * from './npc-lifecycle';
+export * from './IPedAppearanceServer';
+export * from './IPedServer';
+export * from './player-appearance';
+export * from './player-state';
+export * from './IPlayerServer';
+export * from './IVehicleServer';
+export * from './player-lifecycle';
+export * from './vehicle-lifecycle';

package/dist/adapters/contracts/server/npc-lifecycle/INpcLifecycleServer.d.ts

@@ -0,0 +1,5 @@
+import type { CreateNpcServerRequest, CreateNpcServerResult, DeleteNpcServerRequest } from './types';
+export declare abstract class INpcLifecycleServer {
+    abstract create(request: CreateNpcServerRequest): Promise<CreateNpcServerResult> | CreateNpcServerResult;
+    abstract delete(request: DeleteNpcServerRequest): Promise<void> | void;
+}

package/dist/adapters/contracts/server/npc-lifecycle/INpcLifecycleServer.js

@@ -0,0 +1,2 @@
+export class INpcLifecycleServer {
+}

package/dist/adapters/contracts/server/npc-lifecycle/index.d.ts

@@ -0,0 +1,2 @@
+export * from './INpcLifecycleServer';
+export * from './types';

package/dist/adapters/contracts/server/npc-lifecycle/index.js

@@ -0,0 +1,2 @@
+export * from './INpcLifecycleServer';
+export * from './types';

package/dist/adapters/contracts/server/npc-lifecycle/types.d.ts

@@ -0,0 +1,17 @@
+import type { Vector3 } from '../../../../kernel/utils/vector3';
+export interface CreateNpcServerRequest {
+    model: string;
+    modelHash: number;
+    position: Vector3;
+    heading: number;
+    networked: boolean;
+    routingBucket?: number;
+    persistent?: boolean;
+}
+export interface CreateNpcServerResult {
+    handle: number;
+    netId?: number;
+}
+export interface DeleteNpcServerRequest {
+    handle: number;
+}

package/dist/adapters/contracts/server/player-appearance/IPlayerAppearanceLifecycleServer.d.ts

@@ -0,0 +1,11 @@
+import type { PlayerAppearance } from '../../../../kernel/shared';
+export interface ApplyPlayerAppearanceResult {
+    success: boolean;
+    appearance?: PlayerAppearance;
+    errors?: string[];
+}
+export declare abstract class IPlayerAppearanceLifecycleServer {
+    abstract apply(playerSrc: string, appearance: PlayerAppearance): Promise<ApplyPlayerAppearanceResult> | ApplyPlayerAppearanceResult;
+    abstract applyClothing(playerSrc: string, appearance: Pick<PlayerAppearance, 'components' | 'props'>): Promise<boolean> | boolean;
+    abstract reset(playerSrc: string): Promise<boolean> | boolean;
+}

package/dist/adapters/contracts/server/player-appearance/IPlayerAppearanceLifecycleServer.js

@@ -0,0 +1,2 @@
+export class IPlayerAppearanceLifecycleServer {
+}

package/dist/adapters/contracts/server/player-appearance/index.d.ts

@@ -0,0 +1 @@
+export * from './IPlayerAppearanceLifecycleServer';

package/dist/adapters/contracts/server/player-appearance/index.js

@@ -0,0 +1 @@
+export * from './IPlayerAppearanceLifecycleServer';

package/dist/adapters/contracts/server/player-lifecycle/IPlayerLifecycleServer.d.ts

@@ -0,0 +1,6 @@
+import type { RespawnPlayerRequest, SpawnPlayerRequest, TeleportPlayerRequest } from './types';
+export declare abstract class IPlayerLifecycleServer {
+    abstract spawn(playerSrc: string, request: SpawnPlayerRequest): Promise<void> | void;
+    abstract teleport(playerSrc: string, request: TeleportPlayerRequest): Promise<void> | void;
+    abstract respawn(playerSrc: string, request: RespawnPlayerRequest): Promise<void> | void;
+}

package/dist/adapters/contracts/server/player-lifecycle/IPlayerLifecycleServer.js

@@ -0,0 +1,2 @@
+export class IPlayerLifecycleServer {
+}

package/dist/adapters/contracts/server/player-lifecycle/index.d.ts

@@ -0,0 +1,2 @@
+export * from './IPlayerLifecycleServer';
+export * from './types';

package/dist/adapters/contracts/server/player-lifecycle/index.js

@@ -0,0 +1,2 @@
+export * from './IPlayerLifecycleServer';
+export * from './types';

package/dist/adapters/contracts/server/player-lifecycle/types.d.ts

@@ -0,0 +1,17 @@
+import type { PlayerAppearance } from '../../../../kernel';
+import type { Vector3 } from '../../../../kernel/utils/vector3';
+export interface SpawnPlayerRequest {
+    position: Vector3;
+    model?: string;
+    heading?: number;
+    appearance?: PlayerAppearance;
+}
+export interface TeleportPlayerRequest {
+    position: Vector3;
+    heading?: number;
+}
+export interface RespawnPlayerRequest {
+    position: Vector3;
+    heading?: number;
+    model?: string;
+}

package/dist/adapters/contracts/server/player-state/IPlayerStateSyncServer.d.ts

@@ -0,0 +1,6 @@
+export declare abstract class IPlayerStateSyncServer {
+    abstract getHealth(playerSrc: string): number;
+    abstract setHealth(playerSrc: string, health: number): void;
+    abstract getArmor(playerSrc: string): number;
+    abstract setArmor(playerSrc: string, armor: number): void;
+}

package/dist/adapters/contracts/server/player-state/IPlayerStateSyncServer.js

@@ -0,0 +1,2 @@
+export class IPlayerStateSyncServer {
+}

package/dist/adapters/contracts/server/player-state/index.d.ts

@@ -0,0 +1 @@
+export * from './IPlayerStateSyncServer';

package/dist/adapters/contracts/server/player-state/index.js

@@ -0,0 +1 @@
+export * from './IPlayerStateSyncServer';

package/dist/adapters/contracts/server/vehicle-lifecycle/IVehicleLifecycleServer.d.ts

@@ -0,0 +1,5 @@
+import type { CreateVehicleServerRequest, CreateVehicleServerResult, WarpPlayerIntoVehicleRequest } from './types';
+export declare abstract class IVehicleLifecycleServer {
+    abstract create(request: CreateVehicleServerRequest): Promise<CreateVehicleServerResult> | CreateVehicleServerResult;
+    abstract warpPlayerIntoVehicle(request: WarpPlayerIntoVehicleRequest): Promise<void> | void;
+}

package/dist/adapters/contracts/server/vehicle-lifecycle/IVehicleLifecycleServer.js

@@ -0,0 +1,2 @@
+export class IVehicleLifecycleServer {
+}

package/dist/adapters/contracts/server/vehicle-lifecycle/index.d.ts

@@ -0,0 +1,2 @@
+export * from './IVehicleLifecycleServer';
+export * from './types';

package/dist/adapters/contracts/server/vehicle-lifecycle/index.js

@@ -0,0 +1,2 @@
+export * from './IVehicleLifecycleServer';
+export * from './types';

package/dist/adapters/contracts/server/vehicle-lifecycle/types.d.ts

@@ -0,0 +1,16 @@
+import type { Vector3 } from '../../../../kernel/utils/vector3';
+export interface CreateVehicleServerRequest {
+    model: string;
+    modelHash: number;
+    position: Vector3;
+    heading: number;
+}
+export interface CreateVehicleServerResult {
+    handle: number;
+    networkId: number;
+}
+export interface WarpPlayerIntoVehicleRequest {
+    playerSrc: string;
+    networkId: number;
+    seatIndex: number;
+}

package/dist/adapters/contracts/transport/index.d.ts

@@ -0,0 +1,4 @@
+export * from './context';
+export * from './events.api';
+export * from './rpc.api';
+export * from './messaging.transport';

package/dist/adapters/contracts/transport/index.js

@@ -0,0 +1,4 @@
+export * from './context';
+export * from './events.api';
+export * from './rpc.api';
+export * from './messaging.transport';