@nice2dev/game-engine 1.1.5 → 1.1.6

package/dist/types/build-cloud/UnityBuildCloud.d.ts

@@ -0,0 +1,531 @@
+/**
+ * @file UnityBuildCloud.ts
+ * @description Unity Build Cloud system for remote compilation
+ * PRO-1.7.1: Unity Build Cloud
+ *
+ * Features:
+ * - Unity Docker Image configuration
+ * - Multi-version support (2021 LTS, 2022 LTS, 6000 LTS)
+ * - IL2CPP toolchain support
+ * - Platform-specific builds (Android, iOS, WebGL, Linux Server)
+ * - License activation automation
+ * - REST API for build jobs
+ * - Project conversion (Nice2Dev → Unity)
+ * - Package generation (.unitypackage)
+ * - Build caching (Library folder, IL2CPP)
+ */
+export type UnityVersion = '2021.3' | '2022.3' | '6000.0' | 'custom';
+export type UnityPlatform = 'StandaloneWindows64' | 'StandaloneLinux64' | 'StandaloneOSX' | 'Android' | 'iOS' | 'WebGL' | 'LinuxHeadlessSimulation' | 'WindowsServer' | 'LinuxServer' | 'PS4' | 'PS5' | 'XboxOne' | 'Switch';
+export type UnityRenderPipeline = 'BuiltIn' | 'URP' | 'HDRP';
+export type UnityScriptingBackend = 'Mono' | 'IL2CPP';
+export type BuildStatus = 'pending' | 'queued' | 'preparing' | 'building' | 'packaging' | 'uploading' | 'completed' | 'failed' | 'cancelled';
+export type LicenseType = 'Personal' | 'Plus' | 'Pro' | 'Enterprise' | 'BuildServer';
+export interface UnityDockerImage {
+    /** Base image tag */
+    tag: string;
+    /** Unity version */
+    unityVersion: UnityVersion;
+    /** Custom version string if unityVersion is 'custom' */
+    customVersion?: string;
+    /** Installed modules */
+    modules: UnityModule[];
+    /** Android SDK version */
+    androidSdkVersion?: string;
+    /** Android NDK version */
+    androidNdkVersion?: string;
+    /** iOS build support */
+    iosSupport: boolean;
+    /** IL2CPP installed */
+    il2cppSupport: boolean;
+    /** WebGL module */
+    webglSupport: boolean;
+    /** Linux server module */
+    linuxServerSupport: boolean;
+    /** Image size in bytes */
+    size: number;
+    /** Last updated timestamp */
+    lastUpdated: number;
+}
+export interface UnityModule {
+    name: string;
+    id: string;
+    size: number;
+    installed: boolean;
+}
+export declare const UNITY_MODULES: UnityModule[];
+export declare const UNITY_DOCKER_IMAGES: Record<UnityVersion, UnityDockerImage>;
+export interface UnityLicense {
+    type: LicenseType;
+    serial?: string;
+    username?: string;
+    password?: string;
+    /** License file content (base64) */
+    licenseFile?: string;
+    /** Floating license server URL */
+    licenseServerUrl?: string;
+    /** License expiration date */
+    expiresAt?: number;
+    /** Is license activated */
+    activated: boolean;
+}
+export interface LicenseActivationResult {
+    success: boolean;
+    message: string;
+    licenseFile?: string;
+    expiresAt?: number;
+}
+export interface UnityBuildConfig {
+    /** Unique build ID */
+    id: string;
+    /** Project name */
+    projectName: string;
+    /** Unity version to use */
+    unityVersion: UnityVersion;
+    /** Custom Unity version string */
+    customUnityVersion?: string;
+    /** Target platform */
+    platform: UnityPlatform;
+    /** Render pipeline */
+    renderPipeline: UnityRenderPipeline;
+    /** Scripting backend */
+    scriptingBackend: UnityScriptingBackend;
+    /** Build scenes (paths) */
+    scenes: string[];
+    /** Output path */
+    outputPath: string;
+    /** Build options */
+    options: UnityBuildOptions;
+    /** Player settings overrides */
+    playerSettings?: Partial<UnityPlayerSettings>;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Pre-build commands */
+    preBuildCommands?: string[];
+    /** Post-build commands */
+    postBuildCommands?: string[];
+    /** Cache settings */
+    cacheConfig?: UnityCacheConfig;
+    /** License to use */
+    license?: UnityLicense;
+}
+export interface UnityBuildOptions {
+    /** Development build */
+    development: boolean;
+    /** Allow debugging */
+    allowDebugging: boolean;
+    /** Enable deep profiling */
+    deepProfiling: boolean;
+    /** Script debugging */
+    scriptDebugging: boolean;
+    /** Strict mode */
+    strictMode: boolean;
+    /** Compression method */
+    compression: 'None' | 'LZ4' | 'LZ4HC';
+    /** Build scripts only */
+    scriptsOnly: boolean;
+    /** Force rebuild */
+    cleanBuild: boolean;
+    /** Enable addressables */
+    buildAddressables: boolean;
+    /** Show built player */
+    showBuiltPlayer: boolean;
+    /** Auto run player */
+    autoRunPlayer: boolean;
+}
+export interface UnityPlayerSettings {
+    /** Company name */
+    companyName: string;
+    /** Product name */
+    productName: string;
+    /** Bundle version */
+    bundleVersion: string;
+    /** Android bundle version code */
+    androidBundleVersionCode?: number;
+    /** iOS build number */
+    buildNumber?: string;
+    /** Application identifier */
+    applicationIdentifier: string;
+    /** Android package name */
+    androidPackageName?: string;
+    /** iOS bundle identifier */
+    iosBundleIdentifier?: string;
+    /** Default icon path */
+    defaultIcon?: string;
+    /** Splash screen settings */
+    splashScreen?: UnitySplashScreen;
+    /** Graphics API */
+    graphicsApi?: string[];
+    /** Color space */
+    colorSpace: 'Gamma' | 'Linear';
+    /** API compatibility level */
+    apiCompatibilityLevel: 'NET_2_0' | 'NET_2_0_Subset' | 'NET_Standard_2_0' | 'NET_Standard_2_1';
+    /** Scripting defines */
+    scriptingDefineSymbols?: string[];
+    /** Keystore settings (Android) */
+    keystore?: AndroidKeystore;
+    /** Code signing (iOS) */
+    codeSigning?: iOSCodeSigning;
+}
+export interface UnitySplashScreen {
+    enabled: boolean;
+    showUnityLogo: boolean;
+    backgroundColor: string;
+    logos: Array<{
+        logo: string;
+        duration: number;
+    }>;
+}
+export interface AndroidKeystore {
+    path: string;
+    password: string;
+    alias: string;
+    aliasPassword: string;
+}
+export interface iOSCodeSigning {
+    teamId: string;
+    provisioningProfileId: string;
+    signingIdentity: string;
+    automaticSigning: boolean;
+}
+export interface UnityCacheConfig {
+    /** Use Library folder cache */
+    useLibraryCache: boolean;
+    /** Cache key (for sharing) */
+    cacheKey?: string;
+    /** Library cache path */
+    libraryCachePath?: string;
+    /** Use asset import cache */
+    useAssetImportCache: boolean;
+    /** Asset import cache path */
+    assetImportCachePath?: string;
+    /** Use IL2CPP cache */
+    useIl2CppCache: boolean;
+    /** IL2CPP cache path */
+    il2cppCachePath?: string;
+    /** Cache TTL in hours */
+    cacheTtlHours: number;
+}
+export interface UnityBuildJob {
+    id: string;
+    config: UnityBuildConfig;
+    status: BuildStatus;
+    progress: number;
+    logs: BuildLogEntry[];
+    startedAt?: number;
+    completedAt?: number;
+    error?: string;
+    warnings: string[];
+    artifacts?: BuildArtifact[];
+    metrics?: BuildMetrics;
+    workerId?: string;
+}
+export interface BuildLogEntry {
+    timestamp: number;
+    level: 'info' | 'warning' | 'error' | 'debug';
+    message: string;
+    source?: string;
+}
+export interface BuildArtifact {
+    name: string;
+    path: string;
+    size: number;
+    checksum: string;
+    downloadUrl?: string;
+    expiresAt?: number;
+}
+export interface BuildMetrics {
+    totalTime: number;
+    prepareTime: number;
+    buildTime: number;
+    packagingTime: number;
+    uploadTime: number;
+    scriptCompileTime: number;
+    assetImportTime: number;
+    il2cppTime?: number;
+    cacheHits: number;
+    cacheMisses: number;
+    peakMemory: number;
+    artifactSize: number;
+}
+export interface NiceToUnityConversionConfig {
+    /** Source Nice2Dev project path */
+    sourcePath: string;
+    /** Output Unity project path */
+    outputPath: string;
+    /** Unity version target */
+    targetUnityVersion: UnityVersion;
+    /** Render pipeline */
+    renderPipeline: UnityRenderPipeline;
+    /** Generate C# scripts */
+    generateScripts: boolean;
+    /** Convert visual scripts to C# */
+    convertVisualScripts: boolean;
+    /** Material conversion settings */
+    materialConversion: MaterialConversionSettings;
+    /** Animation conversion settings */
+    animationConversion: AnimationConversionSettings;
+    /** Physics settings mapping */
+    physicsMapping: PhysicsMappingSettings;
+    /** Input system setup */
+    inputSystemSetup: InputSystemSettings;
+    /** Addressables setup */
+    addressablesSetup?: AddressablesSettings;
+}
+export interface MaterialConversionSettings {
+    /** Target shader */
+    targetShader: 'Standard' | 'URP/Lit' | 'HDRP/Lit' | 'Custom';
+    /** Custom shader name if targetShader is 'Custom' */
+    customShaderName?: string;
+    /** Preserve material maps */
+    preserveAlbedo: boolean;
+    preserveNormal: boolean;
+    preserveMetallic: boolean;
+    preserveEmission: boolean;
+    preserveOcclusion: boolean;
+    /** Texture import settings */
+    textureImportSettings: TextureImportSettings;
+}
+export interface TextureImportSettings {
+    maxSize: 128 | 256 | 512 | 1024 | 2048 | 4096 | 8192;
+    compression: 'None' | 'LowQuality' | 'NormalQuality' | 'HighQuality';
+    generateMips: boolean;
+    filterMode: 'Point' | 'Bilinear' | 'Trilinear';
+    wrapMode: 'Repeat' | 'Clamp' | 'Mirror' | 'MirrorOnce';
+    sRGB: boolean;
+}
+export interface AnimationConversionSettings {
+    /** Import animation clips */
+    importClips: boolean;
+    /** Import animation controllers */
+    importControllers: boolean;
+    /** Import avatar masks */
+    importAvatarMasks: boolean;
+    /** Convert animation events */
+    convertEvents: boolean;
+    /** Animation compression */
+    compression: 'Off' | 'KeyframeReduction' | 'Optimal';
+    /** Root motion settings */
+    rootMotion: {
+        bakeIntoPoseY: boolean;
+        bakeIntoPoseXZ: boolean;
+        motionY: 'Original' | 'Bake' | 'None';
+        motionXZ: 'Original' | 'Bake' | 'None';
+    };
+}
+export interface PhysicsMappingSettings {
+    /** Convert 2D physics */
+    convert2D: boolean;
+    /** Convert 3D physics */
+    convert3D: boolean;
+    /** Physics layer mapping */
+    layerMapping: Record<number, number>;
+    /** Default physics material */
+    defaultPhysicsMaterial?: string;
+}
+export interface InputSystemSettings {
+    /** Use new Input System */
+    useNewInputSystem: boolean;
+    /** Generate input actions asset */
+    generateInputActions: boolean;
+    /** Action maps to generate */
+    actionMaps: InputActionMap[];
+}
+export interface InputActionMap {
+    name: string;
+    actions: InputAction[];
+}
+export interface InputAction {
+    name: string;
+    type: 'Button' | 'Value' | 'PassThrough';
+    bindings: InputBinding[];
+}
+export interface InputBinding {
+    path: string;
+    interactions?: string;
+    processors?: string;
+}
+export interface AddressablesSettings {
+    /** Enable Addressables */
+    enabled: boolean;
+    /** Default group name */
+    defaultGroup: string;
+    /** Bundle mode */
+    bundleMode: 'PackTogether' | 'PackSeparately' | 'PackTogetherByLabel';
+    /** Remote load path */
+    remoteBuildPath?: string;
+    /** Remote load path */
+    remoteLoadPath?: string;
+}
+export interface UnityPackageConfig {
+    /** Package name */
+    name: string;
+    /** Display name */
+    displayName: string;
+    /** Version */
+    version: string;
+    /** Description */
+    description: string;
+    /** Author */
+    author: PackageAuthor;
+    /** Unity version compatibility */
+    unity: string;
+    /** Unity release compatibility */
+    unityRelease?: string;
+    /** Dependencies */
+    dependencies: Record<string, string>;
+    /** Keywords */
+    keywords: string[];
+    /** Category */
+    category: string;
+    /** Assets to include */
+    assets: PackageAsset[];
+    /** Assembly definitions */
+    assemblies: AssemblyDefinition[];
+    /** Samples */
+    samples?: PackageSample[];
+    /** Documentation */
+    documentationUrl?: string;
+    /** Changelog */
+    changelogUrl?: string;
+    /** License */
+    licensesUrl?: string;
+}
+export interface PackageAuthor {
+    name: string;
+    email?: string;
+    url?: string;
+}
+export interface PackageAsset {
+    /** Source path */
+    source: string;
+    /** Destination path in package */
+    destination: string;
+    /** Asset type */
+    type: 'script' | 'prefab' | 'material' | 'texture' | 'model' | 'audio' | 'animation' | 'other';
+    /** Meta file GUID (will be generated if not provided) */
+    guid?: string;
+}
+export interface AssemblyDefinition {
+    /** Assembly name */
+    name: string;
+    /** Root namespace */
+    rootNamespace: string;
+    /** References */
+    references: string[];
+    /** Include platforms */
+    includePlatforms: string[];
+    /** Exclude platforms */
+    excludePlatforms: string[];
+    /** Allow unsafe code */
+    allowUnsafeCode: boolean;
+    /** Auto referenced */
+    autoReferenced: boolean;
+    /** Define constraints */
+    defineConstraints: string[];
+    /** Version defines */
+    versionDefines: VersionDefine[];
+    /** Is editor assembly */
+    isEditor: boolean;
+}
+export interface VersionDefine {
+    name: string;
+    expression: string;
+    define: string;
+}
+export interface PackageSample {
+    displayName: string;
+    description: string;
+    path: string;
+}
+export interface BuildApiEndpoints {
+    /** Submit new build job */
+    submitBuild: '/api/build/unity';
+    /** Get build status */
+    getBuildStatus: '/api/build/unity/{id}';
+    /** Get build logs */
+    getBuildLogs: '/api/build/unity/{id}/logs';
+    /** Stream build logs (WebSocket) */
+    streamBuildLogs: '/api/build/unity/{id}/logs/stream';
+    /** Get build artifacts */
+    getArtifacts: '/api/build/unity/{id}/artifacts';
+    /** Download artifact */
+    downloadArtifact: '/api/build/unity/{id}/artifacts/{artifactId}';
+    /** Cancel build */
+    cancelBuild: '/api/build/unity/{id}/cancel';
+    /** List builds */
+    listBuilds: '/api/build/unity';
+    /** Get build metrics */
+    getMetrics: '/api/build/unity/{id}/metrics';
+}
+export declare const BUILD_API_ENDPOINTS: BuildApiEndpoints;
+export interface UnityBuildCloudCallbacks {
+    onBuildSubmitted?: (job: UnityBuildJob) => void;
+    onBuildStarted?: (job: UnityBuildJob) => void;
+    onBuildProgress?: (job: UnityBuildJob, progress: number) => void;
+    onBuildLog?: (job: UnityBuildJob, log: BuildLogEntry) => void;
+    onBuildCompleted?: (job: UnityBuildJob) => void;
+    onBuildFailed?: (job: UnityBuildJob, error: string) => void;
+    onBuildCancelled?: (job: UnityBuildJob) => void;
+    onArtifactReady?: (job: UnityBuildJob, artifact: BuildArtifact) => void;
+    onLicenseActivated?: (license: UnityLicense) => void;
+    onLicenseError?: (error: string) => void;
+}
+export declare class UnityBuildCloud {
+    private config;
+    private jobs;
+    private license;
+    private callbacks;
+    private wsConnections;
+    constructor(config?: Partial<UnityBuildCloud['config']>);
+    activateLicense(license: UnityLicense): Promise<LicenseActivationResult>;
+    private generateActivationRequest;
+    private generateHardwareId;
+    private simulateLicenseActivation;
+    getLicense(): UnityLicense | null;
+    isLicenseValid(): boolean;
+    submitBuild(config: Partial<UnityBuildConfig>): Promise<UnityBuildJob>;
+    private createFullBuildConfig;
+    private generateJobId;
+    private startBuildSimulation;
+    private generateChecksum;
+    private addLog;
+    cancelBuild(jobId: string): Promise<boolean>;
+    getJob(jobId: string): UnityBuildJob | undefined;
+    getJobs(): UnityBuildJob[];
+    getJobsByStatus(status: BuildStatus): UnityBuildJob[];
+    subscribeToLogs(jobId: string, callback: (log: BuildLogEntry) => void): () => void;
+    convertProject(config: NiceToUnityConversionConfig): Promise<ConversionResult>;
+    generatePackage(config: UnityPackageConfig): Promise<PackageGenerationResult>;
+    private generatePackageJson;
+    private generateAssemblyDefinition;
+    setCallbacks(callbacks: UnityBuildCloudCallbacks): void;
+    clearJobs(): void;
+    clearCompletedJobs(): void;
+}
+export interface ConversionResult {
+    success: boolean;
+    convertedFiles: Array<{
+        path: string;
+        type: string;
+    }>;
+    warnings: string[];
+    errors: string[];
+}
+export interface PackageGenerationResult {
+    success: boolean;
+    packagePath: string;
+    size: number;
+    warnings: string[];
+}
+export declare function generateUnityDockerfile(image: UnityDockerImage): string;
+export declare function generateBuildScript(): string;
+export declare function createUnityBuildCloud(config?: Partial<{
+    apiBaseUrl: string;
+    apiKey: string;
+    defaultUnityVersion: UnityVersion;
+    maxConcurrentBuilds: number;
+    buildTimeout: number;
+}>): UnityBuildCloud;
+export declare function createUnityBuildConfig(projectName: string, platform: UnityPlatform, options?: Partial<UnityBuildConfig>): Partial<UnityBuildConfig>;
+export declare function createUnityPackageConfig(name: string, version: string, options?: Partial<UnityPackageConfig>): UnityPackageConfig;
+export declare function createNiceToUnityConfig(sourcePath: string, outputPath: string, options?: Partial<NiceToUnityConversionConfig>): NiceToUnityConversionConfig;