@solidxai/core 0.1.10-beta.25 → 0.1.10-beta.26

package/dist/services/module-package.service.d.ts

@@ -0,0 +1,266 @@
+import { ConfirmModulePackageImportDto } from '../dtos/confirm-module-package-import.dto';
+import { RunModulePackageBuildDto } from '../dtos/run-module-package-build.dto';
+import { RunModulePackageSeedDto } from '../dtos/run-module-package-seed.dto';
+import { CommandService } from '../helpers/command.service';
+import { ModuleMetadataHelperService } from '../helpers/module-metadata-helper.service';
+type ModulePackageManifest = {
+    schemaVersion: string;
+    packageType: string;
+    exportedAt?: string;
+    generatedBy?: {
+        name: string;
+        version?: string;
+    };
+    module: {
+        name: string;
+        displayName?: string;
+        description?: string;
+    };
+    contents: {
+        metadataPath: string;
+        apiModulePath: string;
+        uiModulePath: string;
+    };
+    compatibility?: Record<string, unknown>;
+    postImport?: Record<string, unknown>;
+    checksums?: Record<string, string>;
+};
+type ValidationPayload = {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+};
+type PreviewPayload = {
+    module: {
+        name: string;
+        displayName?: string;
+        description?: string;
+    };
+    manifest: ModulePackageManifest;
+    contentsSummary: {
+        totalEntries: number;
+        solidApiEntries: number;
+        solidUiEntries: number;
+    };
+    requiredPaths: {
+        metadataPath: string;
+        apiModulePath: string;
+        uiModulePath: string;
+    };
+    conflicts: string[];
+    fileTree: string[];
+    nextActions: string[];
+};
+type ModulePackageExportFile = {
+    fileName: string;
+    filePath: string;
+    mimeType: string;
+};
+type ModulePackageRuntimeCleanupResult = {
+    runtimeRoot: string;
+    removedImportTransactions: number;
+    removedExportTransactions: number;
+    removedImportLooseEntries: number;
+    removedExportLooseEntries: number;
+    clearedActiveTransactionPointer: boolean;
+    clearedAt: string;
+};
+export declare class ModulePackageService {
+    private readonly commandService;
+    private readonly moduleMetadataHelperService;
+    private readonly logger;
+    private static readonly SUPPORTED_SCHEMA_VERSION;
+    private static readonly SUPPORTED_PACKAGE_TYPE;
+    constructor(commandService: CommandService, moduleMetadataHelperService: ModuleMetadataHelperService);
+    validateUpload(file: Express.Multer.File): Promise<{
+        transactionKey: string;
+        status: string;
+        currentStep: string;
+        moduleName: string;
+        moduleDisplayName: string;
+        archiveFileName: string;
+        manifest: ModulePackageManifest;
+        preview: PreviewPayload;
+        validation: ValidationPayload;
+        conflicts: string[];
+        outputs: {
+            import: string | null;
+            build: string | null;
+            seed: string | null;
+        };
+        errorMessage: string;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    getStatus(transactionKey: string): Promise<{
+        transactionKey: string;
+        status: string;
+        currentStep: string;
+        moduleName: string;
+        moduleDisplayName: string;
+        archiveFileName: string;
+        manifest: ModulePackageManifest;
+        preview: PreviewPayload;
+        validation: ValidationPayload;
+        conflicts: string[];
+        outputs: {
+            import: string | null;
+            build: string | null;
+            seed: string | null;
+        };
+        errorMessage: string;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    getLatestResumableImport(): Promise<{
+        transactionKey: string;
+        status: string;
+        currentStep: string;
+        moduleName: string;
+        moduleDisplayName: string;
+        archiveFileName: string;
+        manifest: ModulePackageManifest;
+        preview: PreviewPayload;
+        validation: ValidationPayload;
+        conflicts: string[];
+        outputs: {
+            import: string | null;
+            build: string | null;
+            seed: string | null;
+        };
+        errorMessage: string;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    dismissImport(transactionKey: string): Promise<{
+        transactionKey: string;
+        status: string;
+        currentStep: string;
+        moduleName: string;
+        moduleDisplayName: string;
+        archiveFileName: string;
+        manifest: ModulePackageManifest;
+        preview: PreviewPayload;
+        validation: ValidationPayload;
+        conflicts: string[];
+        outputs: {
+            import: string | null;
+            build: string | null;
+            seed: string | null;
+        };
+        errorMessage: string;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    clearPackageRuntime(): Promise<ModulePackageRuntimeCleanupResult>;
+    exportModulePackage(moduleNameInput: string): Promise<ModulePackageExportFile>;
+    confirmImport(transactionKey: string, dto?: ConfirmModulePackageImportDto): Promise<{
+        transactionKey: string;
+        status: string;
+        currentStep: string;
+        moduleName: string;
+        moduleDisplayName: string;
+        archiveFileName: string;
+        manifest: ModulePackageManifest;
+        preview: PreviewPayload;
+        validation: ValidationPayload;
+        conflicts: string[];
+        outputs: {
+            import: string | null;
+            build: string | null;
+            seed: string | null;
+        };
+        errorMessage: string;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    runBuild(transactionKey: string, dto?: RunModulePackageBuildDto): Promise<{
+        transactionKey: string;
+        status: string;
+        currentStep: string;
+        moduleName: string;
+        moduleDisplayName: string;
+        archiveFileName: string;
+        manifest: ModulePackageManifest;
+        preview: PreviewPayload;
+        validation: ValidationPayload;
+        conflicts: string[];
+        outputs: {
+            import: string | null;
+            build: string | null;
+            seed: string | null;
+        };
+        errorMessage: string;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    runSeed(transactionKey: string, dto?: RunModulePackageSeedDto): Promise<{
+        transactionKey: string;
+        status: string;
+        currentStep: string;
+        moduleName: string;
+        moduleDisplayName: string;
+        archiveFileName: string;
+        manifest: ModulePackageManifest;
+        preview: PreviewPayload;
+        validation: ValidationPayload;
+        conflicts: string[];
+        outputs: {
+            import: string | null;
+            build: string | null;
+            seed: string | null;
+        };
+        errorMessage: string;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    private parseArchive;
+    private parseManifest;
+    private parseMetadataDocument;
+    private listArchiveEntries;
+    private readArchiveEntry;
+    private extractArchive;
+    private detectConflicts;
+    private buildExpectedPaths;
+    private detectArchiveRootPrefix;
+    private normalizeArchiveEntries;
+    private toArchiveEntryPath;
+    private isUnsafeArchivePath;
+    private isMacOsMetadataEntry;
+    private getFallbackManifest;
+    private loadTransaction;
+    private isResumableStatus;
+    private createWorkingDir;
+    private getSolidApiRoot;
+    private getProjectRoot;
+    private getSolidUiRoot;
+    private getModulePackageImportsRoot;
+    private getModulePackageExportsRoot;
+    private getModulePackageRuntimeRoot;
+    private getSolidApiModuleTargetPath;
+    private getSolidUiModuleTargetPath;
+    private pathExists;
+    private assertPathExists;
+    private readDirSafe;
+    private assertSafeTransactionKey;
+    private getStatusFilePath;
+    private getActiveTransactionFilePath;
+    private writeStatusFile;
+    private markActiveTransaction;
+    private clearActiveTransactionIfMatches;
+    private loadActiveTransactionPointer;
+    private syncActiveTransactionPointer;
+    private collectRuntimeCleanupSnapshot;
+    private getCompletedTransactionRetentionMs;
+    private getPendingTransactionRetentionMs;
+    private cleanupModulePackageTransactions;
+    private resolveLatestResumableTransaction;
+    private toStatusResponse;
+    private buildExportManifest;
+    private computeDirectoryChecksums;
+    private collectFilePathsRecursively;
+    private createArchiveFromDirectory;
+    private computeSha256;
+}
+export {};
+//# sourceMappingURL=module-package.service.d.ts.map

package/dist/services/module-package.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-package.service.d.ts","sourceRoot":"","sources":["../../src/services/module-package.service.ts"],"names":[],"mappings":"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"}