@open-core/framework 0.2.9 → 0.3.0

package/dist/adapters/node/node-entity-server.d.ts

@@ -1,5 +1,5 @@
-import { Vector3 } from '../../kernel/utils';
-import { type EntityStateBag, IEntityServer } from '../contracts/IEntityServer';
+import { Vector3 } from '../../kernel/utils/vector3';
+import { type EntityStateBag, IEntityServer, type SetPositionOptions } from '../contracts/server/IEntityServer';
 /**
  * Node.js mock implementation of server-side entity operations.
  * Used for testing and standalone mode.
@@ -9,6 +9,10 @@ export declare class NodeEntityServer extends IEntityServer {
     private stateBags;
     doesExist(handle: number): boolean;
     getCoords(handle: number): Vector3;
+    setPosition(handle: number, position: Vector3, _options?: SetPositionOptions): void;
+    /**
+     * @deprecated Use setPosition() for cross-platform compatibility.
+     */
     setCoords(handle: number, x: number, y: number, z: number): void;
     getHeading(handle: number): number;
     setHeading(handle: number, heading: number): void;
@@ -18,9 +22,16 @@ export declare class NodeEntityServer extends IEntityServer {
     setRoutingBucket(handle: number, bucket: number): void;
     getRoutingBucket(handle: number): number;
     getStateBag(handle: number): EntityStateBag;
-    getHealth(_handle: number): number;
-    setHealth(_handle: number, _health: number): void;
-    getArmor(_handle: number): number;
-    setArmor(_handle: number, _armor: number): void;
+    getHealth(handle: number): number;
+    setHealth(handle: number, health: number): void;
+    getArmor(handle: number): number;
+    setArmor(handle: number, armor: number): void;
+    /**
+     * Create a mock entity for testing.
+     */
     _createMockEntity(handle: number, model: number, coords: Vector3, heading?: number): void;
+    /**
+     * Clear all mock entities.
+     */
+    _clearAll(): void;
 }

package/dist/adapters/node/node-entity-server.js

@@ -8,7 +8,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NodeEntityServer = void 0;
 const tsyringe_1 = require("tsyringe");
-const IEntityServer_1 = require("../contracts/IEntityServer");
+const IEntityServer_1 = require("../contracts/server/IEntityServer");
 /**
  * Node.js mock implementation of server-side entity operations.
  * Used for testing and standalone mode.
@@ -26,6 +26,15 @@ let NodeEntityServer = class NodeEntityServer extends IEntityServer_1.IEntitySer
         var _a, _b;
         return (_b = (_a = this.entities.get(handle)) === null || _a === void 0 ? void 0 : _a.coords) !== null && _b !== void 0 ? _b : { x: 0, y: 0, z: 0 };
     }
+    setPosition(handle, position, _options) {
+        const entity = this.entities.get(handle);
+        if (entity) {
+            entity.coords = Object.assign({}, position);
+        }
+    }
+    /**
+     * @deprecated Use setPosition() for cross-platform compatibility.
+     */
     setCoords(handle, x, y, z) {
         const entity = this.entities.get(handle);
         if (entity) {
@@ -80,23 +89,40 @@ let NodeEntityServer = class NodeEntityServer extends IEntityServer_1.IEntitySer
             },
         };
     }
-    // TODO
-    getHealth(_handle) {
-        throw new Error('Method not implemented.');
-    }
-    setHealth(_handle, _health) {
-        throw new Error('Method not implemented.');
-    }
-    getArmor(_handle) {
-        throw new Error('Method not implemented.');
-    }
-    setArmor(_handle, _armor) {
-        throw new Error('Method not implemented.');
-    }
-    // Test helper: Create a mock entity
+    getHealth(handle) {
+        var _a;
+        const bag = this.getStateBag(handle);
+        return (_a = bag.get('health')) !== null && _a !== void 0 ? _a : 200;
+    }
+    setHealth(handle, health) {
+        const bag = this.getStateBag(handle);
+        bag.set('health', health, true);
+    }
+    getArmor(handle) {
+        var _a;
+        const bag = this.getStateBag(handle);
+        return (_a = bag.get('armor')) !== null && _a !== void 0 ? _a : 0;
+    }
+    setArmor(handle, armor) {
+        const bag = this.getStateBag(handle);
+        bag.set('armor', armor, true);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Test Helpers
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Create a mock entity for testing.
+     */
     _createMockEntity(handle, model, coords, heading = 0) {
         this.entities.set(handle, { coords, heading, model, bucket: 0 });
     }
+    /**
+     * Clear all mock entities.
+     */
+    _clearAll() {
+        this.entities.clear();
+        this.stateBags.clear();
+    }
 };
 exports.NodeEntityServer = NodeEntityServer;
 exports.NodeEntityServer = NodeEntityServer = __decorate([

package/dist/adapters/node/node-net-transport.js

@@ -9,7 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.NodeNetTransport = void 0;
 const node_events_1 = require("node:events");
 const tsyringe_1 = require("tsyringe");
-const shared_1 = require("../../kernel/shared");
+const logger_1 = require("../../kernel/logger");
 /**
  * Node.js implementation of INetTransport using EventEmitter.
  * Suitable for testing and non-FiveM runtime environments.
@@ -21,7 +21,7 @@ let NodeNetTransport = class NodeNetTransport {
     onNet(eventName, handler) {
         this.eventEmitter.on(eventName, (ctx, ...args) => {
             void Promise.resolve(handler(ctx, ...args)).catch((err) => {
-                shared_1.loggers.netEvent.error(`handler error for '${eventName}'`, {}, err);
+                logger_1.loggers.netEvent.error(`handler error for '${eventName}'`, {}, err);
             });
         });
     }

package/dist/adapters/node/node-ped-appearance-client.d.ts

@@ -1,5 +1,5 @@
 import { HeadBlendData } from '../../kernel/shared';
-import { IPedAppearanceClient } from '../contracts/IPedAppearanceClient';
+import { IPedAppearanceClient } from '../contracts/client/IPedAppearanceClient';
 /**
  * Node.js stub implementation of client-side ped appearance adapter.
  *

package/dist/adapters/node/node-ped-appearance-client.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NodePedAppearanceClient = void 0;
-const IPedAppearanceClient_1 = require("../contracts/IPedAppearanceClient");
+const IPedAppearanceClient_1 = require("../contracts/client/IPedAppearanceClient");
 /**
  * Node.js stub implementation of client-side ped appearance adapter.
  *

package/dist/adapters/node/node-ped-appearance-server.d.ts

@@ -1,4 +1,4 @@
-import { IPedAppearanceServer } from '../contracts/IPedAppearanceServer';
+import { IPedAppearanceServer } from '../contracts/server/IPedAppearanceServer';
 /**
  * Node.js stub implementation of server-side ped appearance adapter.
  *

package/dist/adapters/node/node-ped-appearance-server.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NodePedAppearanceServer = void 0;
-const IPedAppearanceServer_1 = require("../contracts/IPedAppearanceServer");
+const IPedAppearanceServer_1 = require("../contracts/server/IPedAppearanceServer");
 /**
  * Node.js stub implementation of server-side ped appearance adapter.
  *

package/dist/adapters/node/node-platform.d.ts

@@ -0,0 +1,5 @@
+import type { PlatformAdapter } from '../platform/platform-registry';
+/**
+ * Node.js mock platform adapter for testing and standalone development.
+ */
+export declare const NodePlatform: PlatformAdapter;

package/dist/adapters/node/node-platform.js

@@ -0,0 +1,103 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodePlatform = void 0;
+const IEngineEvents_1 = require("../contracts/IEngineEvents");
+const IExports_1 = require("../contracts/IExports");
+const IHasher_1 = require("../contracts/IHasher");
+const INetTransport_1 = require("../contracts/INetTransport");
+const IPlatformCapabilities_1 = require("../contracts/IPlatformCapabilities");
+const IPlayerInfo_1 = require("../contracts/IPlayerInfo");
+const IResourceInfo_1 = require("../contracts/IResourceInfo");
+const ITick_1 = require("../contracts/ITick");
+const IEntityServer_1 = require("../contracts/server/IEntityServer");
+const IPedAppearanceServer_1 = require("../contracts/server/IPedAppearanceServer");
+const IPlayerServer_1 = require("../contracts/server/IPlayerServer");
+const IVehicleServer_1 = require("../contracts/server/IVehicleServer");
+/**
+ * Node.js mock platform adapter for testing and standalone development.
+ */
+exports.NodePlatform = {
+    name: 'node',
+    priority: 0, // Lowest priority - fallback platform
+    detect() {
+        var _a;
+        // Node is the fallback platform when no other platform is detected
+        // It should only match if we're running in pure Node.js
+        return typeof process !== 'undefined' && ((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node) !== undefined;
+    },
+    async register(container) {
+        // Dynamically import Node.js mock implementations
+        const [{ NodeNetTransport }, { NodeEngineEvents }, { NodeExports }, { NodeResourceInfo }, { NodeTick }, { NodePlayerInfo }, { NodeEntityServer }, { NodeVehicleServer }, { NodePlayerServer }, { NodeHasher }, { NodePedAppearanceServer }, { NodeCapabilities },] = await Promise.all([
+            Promise.resolve().then(() => __importStar(require('./node-net-transport'))),
+            Promise.resolve().then(() => __importStar(require('./node-engine-events'))),
+            Promise.resolve().then(() => __importStar(require('./node-exports'))),
+            Promise.resolve().then(() => __importStar(require('./node-resourceinfo'))),
+            Promise.resolve().then(() => __importStar(require('./node-tick'))),
+            Promise.resolve().then(() => __importStar(require('./node-playerinfo'))),
+            Promise.resolve().then(() => __importStar(require('./node-entity-server'))),
+            Promise.resolve().then(() => __importStar(require('./node-vehicle-server'))),
+            Promise.resolve().then(() => __importStar(require('./node-player-server'))),
+            Promise.resolve().then(() => __importStar(require('./node-hasher'))),
+            Promise.resolve().then(() => __importStar(require('./node-ped-appearance-server'))),
+            Promise.resolve().then(() => __importStar(require('./node-capabilities'))),
+        ]);
+        // Register all Node.js mock implementations
+        if (!container.isRegistered(IPlatformCapabilities_1.IPlatformCapabilities))
+            container.registerSingleton(IPlatformCapabilities_1.IPlatformCapabilities, NodeCapabilities);
+        if (!container.isRegistered(INetTransport_1.INetTransport))
+            container.registerSingleton(INetTransport_1.INetTransport, NodeNetTransport);
+        if (!container.isRegistered(IEngineEvents_1.IEngineEvents))
+            container.registerSingleton(IEngineEvents_1.IEngineEvents, NodeEngineEvents);
+        if (!container.isRegistered(IExports_1.IExports))
+            container.registerSingleton(IExports_1.IExports, NodeExports);
+        if (!container.isRegistered(IResourceInfo_1.IResourceInfo))
+            container.registerSingleton(IResourceInfo_1.IResourceInfo, NodeResourceInfo);
+        if (!container.isRegistered(ITick_1.ITick))
+            container.registerSingleton(ITick_1.ITick, NodeTick);
+        if (!container.isRegistered(IPlayerInfo_1.IPlayerInfo))
+            container.registerSingleton(IPlayerInfo_1.IPlayerInfo, NodePlayerInfo);
+        if (!container.isRegistered(IEntityServer_1.IEntityServer))
+            container.registerSingleton(IEntityServer_1.IEntityServer, NodeEntityServer);
+        if (!container.isRegistered(IVehicleServer_1.IVehicleServer))
+            container.registerSingleton(IVehicleServer_1.IVehicleServer, NodeVehicleServer);
+        if (!container.isRegistered(IPlayerServer_1.IPlayerServer))
+            container.registerSingleton(IPlayerServer_1.IPlayerServer, NodePlayerServer);
+        if (!container.isRegistered(IHasher_1.IHasher))
+            container.registerSingleton(IHasher_1.IHasher, NodeHasher);
+        if (!container.isRegistered(IPedAppearanceServer_1.IPedAppearanceServer))
+            container.registerSingleton(IPedAppearanceServer_1.IPedAppearanceServer, NodePedAppearanceServer);
+    },
+};

package/dist/adapters/node/node-player-server.d.ts

@@ -1,4 +1,5 @@
-import { IPlayerServer } from '../contracts/IPlayerServer';
+import { IPlayerServer } from '../contracts/server/IPlayerServer';
+import { type PlayerIdentifier } from '../contracts/types/identifier';
 /**
  * Node.js mock implementation of server-side player operations.
  * Used for testing and standalone mode.
@@ -9,20 +10,35 @@ export declare class NodePlayerServer extends IPlayerServer {
     getPed(playerSrc: string): number;
     drop(playerSrc: string, _reason: string): void;
     getIdentifier(playerSrc: string, identifierType: string): string | undefined;
+    /**
+     * @deprecated Use getPlayerIdentifiers() for structured identifier data.
+     */
     getIdentifiers(playerSrc: string): string[];
+    getPlayerIdentifiers(playerSrc: string): PlayerIdentifier[];
     getNumIdentifiers(playerSrc: string): number;
     getName(playerSrc: string): string;
     getPing(playerSrc: string): number;
     getEndpoint(playerSrc: string): string;
+    setRoutingBucket(playerSrc: string, bucket: number): void;
+    getRoutingBucket(playerSrc: string): number;
+    getConnectedPlayers(): string[];
+    /**
+     * Add a mock player for testing.
+     */
     _addMockPlayer(playerSrc: string, data: {
         ped?: number;
         name?: string;
         identifiers?: string[];
         ping?: number;
         endpoint?: string;
+        routingBucket?: number;
     }): void;
+    /**
+     * Check if a player was dropped.
+     */
     _wasDropped(playerSrc: string): boolean;
-    setRoutingBucket(_playerSrc: string, _bucket: number): void;
-    getConnectedPlayers(): string[];
+    /**
+     * Clear all mock data.
+     */
     _clear(): void;
 }

package/dist/adapters/node/node-player-server.js

@@ -8,7 +8,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NodePlayerServer = void 0;
 const tsyringe_1 = require("tsyringe");
-const IPlayerServer_1 = require("../contracts/IPlayerServer");
+const IPlayerServer_1 = require("../contracts/server/IPlayerServer");
+const identifier_1 = require("../contracts/types/identifier");
 /**
  * Node.js mock implementation of server-side player operations.
  * Used for testing and standalone mode.
@@ -34,10 +35,24 @@ let NodePlayerServer = class NodePlayerServer extends IPlayerServer_1.IPlayerSer
         const prefix = `${identifierType}:`;
         return player.identifiers.find((id) => id.startsWith(prefix));
     }
+    /**
+     * @deprecated Use getPlayerIdentifiers() for structured identifier data.
+     */
     getIdentifiers(playerSrc) {
         var _a, _b;
         return (_b = (_a = this.players.get(playerSrc)) === null || _a === void 0 ? void 0 : _a.identifiers) !== null && _b !== void 0 ? _b : [];
     }
+    getPlayerIdentifiers(playerSrc) {
+        const rawIdentifiers = this.getIdentifiers(playerSrc);
+        const identifiers = [];
+        for (const raw of rawIdentifiers) {
+            const parsed = (0, identifier_1.parseIdentifier)(raw);
+            if (parsed) {
+                identifiers.push(parsed);
+            }
+        }
+        return identifiers;
+    }
     getNumIdentifiers(playerSrc) {
         var _a, _b;
         return (_b = (_a = this.players.get(playerSrc)) === null || _a === void 0 ? void 0 : _a.identifiers.length) !== null && _b !== void 0 ? _b : 0;
@@ -54,26 +69,45 @@ let NodePlayerServer = class NodePlayerServer extends IPlayerServer_1.IPlayerSer
         var _a, _b;
         return (_b = (_a = this.players.get(playerSrc)) === null || _a === void 0 ? void 0 : _a.endpoint) !== null && _b !== void 0 ? _b : '';
     }
-    // Test helpers
+    setRoutingBucket(playerSrc, bucket) {
+        const player = this.players.get(playerSrc);
+        if (player) {
+            player.routingBucket = bucket;
+        }
+    }
+    getRoutingBucket(playerSrc) {
+        var _a, _b;
+        return (_b = (_a = this.players.get(playerSrc)) === null || _a === void 0 ? void 0 : _a.routingBucket) !== null && _b !== void 0 ? _b : 0;
+    }
+    getConnectedPlayers() {
+        return Array.from(this.players.keys());
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Test Helpers
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Add a mock player for testing.
+     */
     _addMockPlayer(playerSrc, data) {
-        var _a, _b, _c, _d, _e;
+        var _a, _b, _c, _d, _e, _f;
         this.players.set(playerSrc, {
             ped: (_a = data.ped) !== null && _a !== void 0 ? _a : 0,
             name: (_b = data.name) !== null && _b !== void 0 ? _b : 'TestPlayer',
             identifiers: (_c = data.identifiers) !== null && _c !== void 0 ? _c : [],
             ping: (_d = data.ping) !== null && _d !== void 0 ? _d : 50,
             endpoint: (_e = data.endpoint) !== null && _e !== void 0 ? _e : '127.0.0.1:30120',
+            routingBucket: (_f = data.routingBucket) !== null && _f !== void 0 ? _f : 0,
         });
     }
+    /**
+     * Check if a player was dropped.
+     */
     _wasDropped(playerSrc) {
         return this.droppedPlayers.includes(playerSrc);
     }
-    setRoutingBucket(_playerSrc, _bucket) {
-        // Mock: no-op in Node.js
-    }
-    getConnectedPlayers() {
-        return Array.from(this.players.keys());
-    }
+    /**
+     * Clear all mock data.
+     */
     _clear() {
         this.players.clear();
         this.droppedPlayers = [];

package/dist/adapters/node/node-playerinfo.d.ts

@@ -1,6 +1,6 @@
 import { Vector3 } from '../../kernel';
 import { IPlayerInfo } from '../contracts/IPlayerInfo';
-export declare class NodePlayerInfo implements IPlayerInfo {
+export declare class NodePlayerInfo extends IPlayerInfo {
     getPlayerName(clientId: number): string | null;
-    getPlayerPosition(_clientId: number): Vector3 | undefined;
+    getPlayerPosition(_clientId: number): Vector3;
 }

package/dist/adapters/node/node-playerinfo.js

@@ -1,12 +1,23 @@
 "use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NodePlayerInfo = void 0;
-class NodePlayerInfo {
+const tsyringe_1 = require("tsyringe");
+const IPlayerInfo_1 = require("../contracts/IPlayerInfo");
+let NodePlayerInfo = class NodePlayerInfo extends IPlayerInfo_1.IPlayerInfo {
     getPlayerName(clientId) {
         return `Player${clientId.toString()}`;
     }
     getPlayerPosition(_clientId) {
-        return { x: 6, y: 7, z: 6 };
+        return { x: 0, y: 0, z: 0 };
     }
-}
+};
 exports.NodePlayerInfo = NodePlayerInfo;
+exports.NodePlayerInfo = NodePlayerInfo = __decorate([
+    (0, tsyringe_1.injectable)()
+], NodePlayerInfo);

package/dist/adapters/node/node-vehicle-server.d.ts

@@ -1,4 +1,4 @@
-import { IVehicleServer } from '../contracts/IVehicleServer';
+import { IVehicleServer } from '../contracts/server/IVehicleServer';
 /**
  * Node.js mock implementation of server-side vehicle operations.
  * Used for testing and standalone mode.

package/dist/adapters/node/node-vehicle-server.js

@@ -8,7 +8,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NodeVehicleServer = void 0;
 const tsyringe_1 = require("tsyringe");
-const IVehicleServer_1 = require("../contracts/IVehicleServer");
+const IVehicleServer_1 = require("../contracts/server/IVehicleServer");
 /**
  * Node.js mock implementation of server-side vehicle operations.
  * Used for testing and standalone mode.

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

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

package/dist/{runtime/server/database.js → adapters/platform/index.js}

@@ -14,10 +14,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Database Module Re-export
- *
- * This file re-exports the database module for backwards compatibility.
- * Prefer importing directly from '@open-core/framework/server' or './database/index'
- */
-__exportStar(require("./database/index"), exports);
+__exportStar(require("./platform-registry"), exports);

package/dist/adapters/platform/platform-registry.d.ts

@@ -0,0 +1,101 @@
+import type { DependencyContainer } from 'tsyringe';
+/**
+ * Platform adapter interface for registering platform-specific implementations.
+ *
+ * @remarks
+ * Each supported platform (FiveM, RageMP, alt:V, etc.) should implement this
+ * interface to provide automatic detection and dependency registration.
+ */
+export interface PlatformAdapter {
+    /**
+     * Unique platform identifier.
+     * @example 'fivem', 'ragemp', 'altv', 'node'
+     */
+    readonly name: string;
+    /**
+     * Priority for platform detection (higher = checked first).
+     * Useful when multiple platforms might match.
+     * @default 0
+     */
+    readonly priority?: number;
+    /**
+     * Detect if the current runtime is this platform.
+     * @returns true if running on this platform
+     */
+    detect(): boolean;
+    /**
+     * Register all platform-specific adapters in the DI container.
+     * @param container - The dependency injection container
+     */
+    register(container: DependencyContainer): Promise<void>;
+}
+/**
+ * Registry for platform adapters.
+ * Allows dynamic registration and detection of platforms.
+ */
+declare class PlatformRegistry {
+    private adapters;
+    private currentPlatform;
+    /**
+     * Register a platform adapter.
+     * @param adapter - Platform adapter to register
+     */
+    register(adapter: PlatformAdapter): void;
+    /**
+     * Unregister a platform adapter.
+     * @param name - Platform name to unregister
+     */
+    unregister(name: string): void;
+    /**
+     * Get all registered platform adapters.
+     */
+    getAll(): readonly PlatformAdapter[];
+    /**
+     * Get a specific platform adapter by name.
+     * @param name - Platform name
+     */
+    get(name: string): PlatformAdapter | undefined;
+    /**
+     * Detect the current platform from registered adapters.
+     * @returns The detected platform adapter or undefined
+     */
+    detect(): PlatformAdapter | undefined;
+    /**
+     * Detect and register platform capabilities in the container.
+     *
+     * @param container - DI container to register adapters in
+     * @param forcePlatform - Optional platform name to force (skip detection)
+     * @returns The registered platform adapter
+     * @throws Error if no platform is detected
+     */
+    detectAndRegister(container: DependencyContainer, forcePlatform?: string): Promise<PlatformAdapter>;
+    /**
+     * Get the currently active platform.
+     * Only available after detectAndRegister has been called.
+     */
+    getCurrent(): PlatformAdapter | null;
+    /**
+     * Check if a specific platform is currently active.
+     * @param name - Platform name to check
+     */
+    isCurrentPlatform(name: string): boolean;
+    /**
+     * Clear all registered adapters (mainly for testing).
+     */
+    clear(): void;
+}
+/**
+ * Global platform registry instance.
+ */
+export declare const platformRegistry: PlatformRegistry;
+/**
+ * Convenience function to register a platform adapter.
+ * @param adapter - Platform adapter to register
+ */
+export declare function registerPlatform(adapter: PlatformAdapter): void;
+/**
+ * Get the current platform name.
+ * @returns Platform name or 'unknown' if not detected
+ */
+export declare function getCurrentPlatformName(): string;
+export {};