@darkclaw921/umgt 0.0.0-stage → 0.2.0

package/dist/server/assets.d.ts

@@ -0,0 +1,69 @@
+import { Readable } from 'node:stream';
+import type { FastifyInstance } from 'fastify';
+import type { Asset, AssetSearchResult, Project } from '../shared/types.js';
+import type { HubContext } from './app.js';
+import { type ManagedMedia } from './asset-media.js';
+/** Eligibility for recommendations is stricter than an unknown user-upload license. */
+export declare function isAutoSelectableAsset(asset: Asset): boolean;
+export declare function searchAssets(query: string, options?: {
+    provider?: string;
+    type?: string;
+    signal?: AbortSignal;
+}): Promise<AssetSearchResult>;
+export declare function assetDetails(provider: string, id: string, options?: {
+    signal?: AbortSignal;
+}): Promise<Asset>;
+export declare function safeAssetPath(root: string, name: string): string;
+export declare function extractZip(archive: string, destination: string, signal?: AbortSignal): Promise<string[]>;
+export interface ImportOptions {
+    maxBytes?: number;
+    cacheDir?: string;
+    signal?: AbortSignal;
+    emit?: (progress: {
+        downloaded: number;
+        total?: number;
+        file: string;
+    }) => void;
+}
+export interface ImportedAsset extends Asset {
+    importedAt: string;
+    directory: string;
+    files: string[];
+    sourceId?: string;
+}
+/** Resolve authoritative metadata, then reuse a verified previous import for the same source. */
+export declare function importAsset(project: Project, requestedAsset: Asset, options?: ImportOptions): Promise<ImportedAsset>;
+export interface LocalAssetMetadata {
+    name?: string;
+    type?: string;
+    sourceUrl?: string;
+    author?: string;
+    license?: string;
+    licenseUrl?: string;
+    attribution?: string;
+    provenanceUrl?: string;
+    verifiedAt?: string;
+    formats?: string[];
+    tags?: string[];
+}
+export interface StagingOptions extends ImportOptions {
+    stagingDir: string;
+}
+/** Validate an upload outside the game project; only return an opaque project-bound handle. */
+export declare function stageLocalAsset(project: Project, filename: string, stream: Readable, metadata: LocalAssetMetadata | undefined, options: StagingOptions): Promise<{
+    handle: string;
+    asset: Asset;
+}>;
+/** Commit validated staged files after the plan gate. Repeated handles reuse verified results. */
+export declare function importStagedAsset(project: Project, handle: string, options: StagingOptions): Promise<ImportedAsset>;
+export declare function importLocalAsset(project: Project, filename: string, stream: Readable, metadata?: LocalAssetMetadata): Promise<ImportedAsset>;
+export declare function catalogMediaMetadata(asset: Asset): Asset;
+/** Lazy official-source preview cache. Never creates a game project or touches its files. */
+export declare function prepareProviderMedia(provider: string, id: string, options: {
+    mediaDir: string;
+    cacheDir: string;
+    signal?: AbortSignal;
+}): Promise<ManagedMedia>;
+export declare function registerAssetRoutes(app: FastifyInstance, hub: HubContext, guards?: {
+    assertIdle?: (projectId: string) => void;
+}): Promise<void>;