@nice2dev/game-engine 1.1.5 → 1.1.6

package/dist/types/unity-integration/UnityAssetStore.d.ts

@@ -0,0 +1,365 @@
+/**
+ * @file UnityAssetStore.ts
+ * @description Unity Asset Store Integration for Nice2Dev Game Engine
+ * PRO-1.8.3: Unity Asset Store Integration
+ *
+ * Features:
+ * - Asset Store Browser (search, preview, categories)
+ * - Unity Package Manager integration (UPM)
+ * - Package version selection
+ * - Dependency management
+ * - Git package support
+ */
+export type AssetStoreCategory = '3d' | '2d' | 'add-ons' | 'audio' | 'templates' | 'tools' | 'vfx' | 'ai';
+export type AssetStorePricing = 'free' | 'paid' | 'plus';
+export type AssetStoreRating = 1 | 2 | 3 | 4 | 5;
+export type PackageSource = 'registry' | 'git' | 'local' | 'tarball' | 'embedded';
+export type PackageResolutionType = 'release' | 'prerelease' | 'preview' | 'experimental';
+export interface AssetStoreAsset {
+    /** Asset ID */
+    id: string;
+    /** Asset name */
+    name: string;
+    /** Publisher name */
+    publisher: string;
+    /** Publisher ID */
+    publisherId: string;
+    /** Category */
+    category: AssetStoreCategory;
+    /** Subcategory */
+    subcategory?: string;
+    /** Description (short) */
+    shortDescription: string;
+    /** Description (full) */
+    description: string;
+    /** Price in USD */
+    price: number;
+    /** Currency */
+    currency: string;
+    /** Is free */
+    isFree: boolean;
+    /** Average rating */
+    rating: number;
+    /** Rating count */
+    ratingCount: number;
+    /** Thumbnail URL */
+    thumbnailUrl: string;
+    /** Preview images */
+    previewImages: string[];
+    /** Preview video URL */
+    previewVideoUrl?: string;
+    /** Unity versions supported */
+    unityVersions: string[];
+    /** Minimum Unity version */
+    minUnityVersion: string;
+    /** File size (bytes) */
+    fileSize: number;
+    /** Last updated */
+    lastUpdated: string;
+    /** Release date */
+    releaseDate: string;
+    /** Version */
+    version: string;
+    /** Tags */
+    tags: string[];
+    /** Is in user's purchases */
+    isOwned: boolean;
+    /** Render pipeline compatibility */
+    renderPipelines: ('builtin' | 'urp' | 'hdrp')[];
+    /** Asset Store URL */
+    url: string;
+}
+export interface AssetStoreSearchQuery {
+    /** Search text */
+    query?: string;
+    /** Category filter */
+    category?: AssetStoreCategory;
+    /** Subcategory filter */
+    subcategory?: string;
+    /** Price filter */
+    pricing?: AssetStorePricing;
+    /** Minimum rating */
+    minRating?: AssetStoreRating;
+    /** Publisher ID filter */
+    publisherId?: string;
+    /** Unity version filter */
+    unityVersion?: string;
+    /** Render pipeline filter */
+    renderPipeline?: 'builtin' | 'urp' | 'hdrp';
+    /** Tags filter */
+    tags?: string[];
+    /** Sort by */
+    sortBy?: 'relevance' | 'popularity' | 'rating' | 'price_asc' | 'price_desc' | 'newest' | 'updated';
+    /** Page */
+    page?: number;
+    /** Page size */
+    pageSize?: number;
+}
+export interface AssetStoreSearchResult {
+    /** Total results */
+    total: number;
+    /** Current page */
+    page: number;
+    /** Page size */
+    pageSize: number;
+    /** Total pages */
+    totalPages: number;
+    /** Results */
+    assets: AssetStoreAsset[];
+}
+export interface AssetStoreReview {
+    /** Review ID */
+    id: string;
+    /** User name */
+    userName: string;
+    /** Rating */
+    rating: AssetStoreRating;
+    /** Review text */
+    text: string;
+    /** Date */
+    date: string;
+    /** Is verified purchase */
+    isVerifiedPurchase: boolean;
+    /** Publisher response */
+    publisherResponse?: string;
+    /** Helpful count */
+    helpfulCount: number;
+}
+export interface UPMPackage {
+    /** Package name (e.g., com.unity.render-pipelines.universal) */
+    name: string;
+    /** Display name */
+    displayName: string;
+    /** Version */
+    version: string;
+    /** Description */
+    description: string;
+    /** Unity version compatibility */
+    unity: string;
+    /** Author */
+    author?: {
+        name: string;
+        email?: string;
+        url?: string;
+    };
+    /** Repository */
+    repository?: {
+        type: 'git';
+        url: string;
+    };
+    /** Documentation URL */
+    documentationUrl?: string;
+    /** Changelog URL */
+    changelogUrl?: string;
+    /** License */
+    license?: string;
+    /** Keywords */
+    keywords?: string[];
+    /** Dependencies */
+    dependencies: Record<string, string>;
+    /** Package source */
+    source: PackageSource;
+    /** Is from Unity registry */
+    isUnityPackage: boolean;
+    /** All available versions */
+    versions?: string[];
+    /** Current resolved version */
+    resolvedVersion?: string;
+    /** Is installed */
+    isInstalled: boolean;
+    /** Has update available */
+    hasUpdate: boolean;
+    /** Latest version */
+    latestVersion?: string;
+    /** Samples */
+    samples?: PackageSample[];
+}
+export interface PackageSample {
+    /** Sample display name */
+    displayName: string;
+    /** Sample description */
+    description: string;
+    /** Sample path in package */
+    path: string;
+    /** Is imported */
+    isImported: boolean;
+}
+export interface PackageManifest {
+    /** Dependencies */
+    dependencies: Record<string, string>;
+    /** Scoped registries */
+    scopedRegistries?: ScopedRegistry[];
+    /** Enable lock file */
+    enableLockFile?: boolean;
+    /** Resolution overrides */
+    resolutions?: Record<string, string>;
+    /** Test dependencies */
+    testDependencies?: Record<string, string>;
+}
+export interface ScopedRegistry {
+    /** Registry name */
+    name: string;
+    /** Registry URL */
+    url: string;
+    /** Scopes (package name prefixes) */
+    scopes: string[];
+}
+export interface PackageLock {
+    /** Dependencies with locked versions */
+    dependencies: Record<string, PackageLockEntry>;
+}
+export interface PackageLockEntry {
+    /** Resolved version */
+    version: string;
+    /** Depth in dependency tree */
+    depth: number;
+    /** Source */
+    source: PackageSource;
+    /** Resolved dependencies */
+    dependencies: Record<string, string>;
+    /** URL (for git packages) */
+    url?: string;
+    /** Hash (for git packages) */
+    hash?: string;
+}
+export interface AssetStoreBrowserConfig {
+    /** API base URL */
+    apiBaseUrl: string;
+    /** User session token */
+    sessionToken?: string;
+    /** Cache duration (ms) */
+    cacheDuration: number;
+    /** Results per page */
+    defaultPageSize: number;
+}
+export declare class AssetStoreBrowser {
+    private config;
+    private cache;
+    private callbacks;
+    private currentUser;
+    constructor(config?: Partial<AssetStoreBrowserConfig>);
+    login(sessionToken: string): Promise<AssetStoreUser>;
+    logout(): void;
+    isLoggedIn(): boolean;
+    getCurrentUser(): AssetStoreUser | null;
+    search(query: AssetStoreSearchQuery): Promise<AssetStoreSearchResult>;
+    getAsset(assetId: string): Promise<AssetStoreAsset | null>;
+    getAssetReviews(assetId: string, page?: number): Promise<{
+        reviews: AssetStoreReview[];
+        total: number;
+        page: number;
+    }>;
+    getCategories(): Promise<Array<{
+        id: AssetStoreCategory;
+        name: string;
+        count: number;
+    }>>;
+    getPopularAssets(count?: number): Promise<AssetStoreAsset[]>;
+    getNewAssets(count?: number): Promise<AssetStoreAsset[]>;
+    getFreeAssets(count?: number): Promise<AssetStoreAsset[]>;
+    getPurchasedAssets(): Promise<AssetStoreAsset[]>;
+    getFavorites(): Promise<AssetStoreAsset[]>;
+    addToFavorites(assetId: string): Promise<void>;
+    removeFromFavorites(assetId: string): Promise<void>;
+    initiateDownload(assetId: string): Promise<AssetDownloadInfo>;
+    importToProject(assetId: string, _projectPath: string, _options?: ImportOptions): Promise<ImportResult>;
+    private getFromCache;
+    private setCache;
+    clearCache(): void;
+    private mockSearch;
+    private mockGetAsset;
+    setCallbacks(callbacks: AssetStoreCallbacks): void;
+}
+export declare class UnityPackageManager {
+    private manifest;
+    private lockFile;
+    private installedPackages;
+    private registryCache;
+    private callbacks;
+    constructor();
+    private addDefaultPackages;
+    searchPackages(query: string): Promise<UPMPackage[]>;
+    getPackage(packageName: string): Promise<UPMPackage | null>;
+    getPackageVersions(packageName: string): Promise<string[]>;
+    getInstalledPackages(): UPMPackage[];
+    installPackage(packageName: string, version?: string): Promise<InstallResult>;
+    uninstallPackage(packageName: string): Promise<UninstallResult>;
+    updatePackage(packageName: string, version?: string): Promise<InstallResult>;
+    updateAllPackages(): Promise<Array<InstallResult>>;
+    installGitPackage(url: string, ref?: string): Promise<InstallResult>;
+    addScopedRegistry(registry: ScopedRegistry): void;
+    removeScopedRegistry(name: string): boolean;
+    getScopedRegistries(): ScopedRegistry[];
+    private resolveDependencies;
+    private findDependents;
+    getManifest(): PackageManifest;
+    getLockFile(): PackageLock;
+    generateManifestJson(): string;
+    generateLockFileJson(): string;
+    setCallbacks(callbacks: PackageManagerCallbacks): void;
+}
+export interface AssetStoreUser {
+    id: string;
+    name: string;
+    email: string;
+    purchases: string[];
+    favorites: string[];
+}
+export interface AssetDownloadInfo {
+    assetId: string;
+    downloadUrl: string;
+    fileName: string;
+    fileSize: number;
+    checksum: string;
+    expiresAt: number;
+}
+export interface ImportOptions {
+    /** Import only specific folders */
+    includeFolders?: string[];
+    /** Exclude specific folders */
+    excludeFolders?: string[];
+    /** Overwrite existing files */
+    overwrite?: boolean;
+    /** Run Unity refresh after import */
+    refreshAfterImport?: boolean;
+}
+export interface ImportResult {
+    success: boolean;
+    assetId: string;
+    importedFiles: string[];
+    skippedFiles: string[];
+    errors: string[];
+}
+export interface InstallResult {
+    success: boolean;
+    packageName: string;
+    version?: string;
+    error?: string;
+    message?: string;
+    dependencies?: string[];
+}
+export interface UninstallResult {
+    success: boolean;
+    packageName: string;
+    error?: string;
+    dependents?: string[];
+}
+export interface AssetStoreCallbacks {
+    onLogin?: (user: AssetStoreUser) => void;
+    onLogout?: () => void;
+    onSearchComplete?: (result: AssetStoreSearchResult) => void;
+    onDownloadStart?: (info: AssetDownloadInfo) => void;
+    onDownloadProgress?: (assetId: string, progress: number) => void;
+    onDownloadComplete?: (assetId: string) => void;
+    onImportComplete?: (result: ImportResult) => void;
+    onError?: (error: Error) => void;
+}
+export interface PackageManagerCallbacks {
+    onPackageInstalled?: (pkg: UPMPackage) => void;
+    onPackageUninstalled?: (packageName: string) => void;
+    onPackageUpdated?: (pkg: UPMPackage) => void;
+    onRegistryAdded?: (registry: ScopedRegistry) => void;
+    onResolutionError?: (error: Error) => void;
+}
+export declare function createAssetStoreBrowser(config?: Partial<AssetStoreBrowserConfig>): AssetStoreBrowser;
+export declare function createUnityPackageManager(): UnityPackageManager;