@ims-view/server 1.1.0 → 1.2.1

package/lib/server/src/excel/excel-storage.service.js

@@ -0,0 +1,258 @@
+"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 __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;
+};
+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;
+    };
+})();
+var ExcelStorageService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExcelStorageService = exports.preserveUploadFileName = exports.EXCEL_STATIC_PREFIX = exports.getExcelUploadDir = void 0;
+const common_1 = require("@nestjs/common");
+const crypto_1 = require("crypto");
+const promises_1 = require("fs/promises");
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const getExcelUploadDir = () => process.env.IMS_EXCEL_UPLOAD_DIR || path.join(os.tmpdir(), 'ims-excel-uploads');
+exports.getExcelUploadDir = getExcelUploadDir;
+exports.EXCEL_STATIC_PREFIX = '/excel/static';
+const getTtlMs = () => {
+    const raw = Number(process.env.IMS_EXCEL_UPLOAD_TTL_MS || 60 * 60 * 1000);
+    return Number.isFinite(raw) && raw > 0 ? raw : 60 * 60 * 1000;
+};
+const getCleanupIntervalMs = () => {
+    const raw = Number(process.env.IMS_EXCEL_UPLOAD_CLEANUP_MS || 10 * 60 * 1000);
+    return Number.isFinite(raw) && raw > 0 ? raw : 10 * 60 * 1000;
+};
+const preserveUploadFileName = (raw) => {
+    let name = (raw || '').trim() || 'workbook.xlsx';
+    const looksMojibake = /[\u00c0-\u00ff]/.test(name) && !/[\u4e00-\u9fff]/.test(name);
+    if (looksMojibake) {
+        try {
+            name = Buffer.from(name, 'latin1').toString('utf8');
+        }
+        catch {
+        }
+    }
+    name = path.basename(name.replace(/\\/g, '/'));
+    name = name.replace(/[<>:"/\\|?*\u0000-\u001f]+/g, '_').trim();
+    name = name.replace(/^\.+/, '') || 'workbook.xlsx';
+    if (!/\.xlsx$/i.test(name)) {
+        name = `${name.replace(/\.xls$/i, '') || 'workbook'}.xlsx`;
+    }
+    return name;
+};
+exports.preserveUploadFileName = preserveUploadFileName;
+let ExcelStorageService = ExcelStorageService_1 = class ExcelStorageService {
+    constructor() {
+        this.logger = new common_1.Logger(ExcelStorageService_1.name);
+        this.uploadDir = (0, exports.getExcelUploadDir)();
+        this.cleanupTimer = null;
+        this.tasks = new Map();
+    }
+    async onModuleInit() {
+        await (0, promises_1.mkdir)(this.uploadDir, { recursive: true });
+        this.logger.log(`upload dir=${this.uploadDir} ttl=${getTtlMs()}ms`);
+        await this.cleanupExpired().catch((error) => {
+            this.logger.warn(`initial cleanup failed: ${error instanceof Error ? error.message : error}`);
+        });
+        this.cleanupTimer = setInterval(() => {
+            void this.cleanupExpired();
+        }, getCleanupIntervalMs());
+        this.cleanupTimer.unref?.();
+    }
+    onModuleDestroy() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+    }
+    getUploadDir() {
+        return this.uploadDir;
+    }
+    getTask(id) {
+        return this.tasks.get(id);
+    }
+    getXlsxFullPath(id) {
+        return path.join(this.uploadDir, `${id}.xlsx`);
+    }
+    async saveXlsx(buffer, originalName) {
+        await (0, promises_1.mkdir)(this.uploadDir, { recursive: true });
+        const id = (0, crypto_1.randomUUID)().replace(/-/g, '');
+        const storedName = `${id}.xlsx`;
+        const fullPath = path.join(this.uploadDir, storedName);
+        await (0, promises_1.writeFile)(fullPath, buffer);
+        const ttl = getTtlMs();
+        const expiresAt = Date.now() + ttl;
+        const fileName = (0, exports.preserveUploadFileName)(originalName);
+        const xlsxPath = `${exports.EXCEL_STATIC_PREFIX}/${storedName}`;
+        this.tasks.set(id, {
+            id,
+            status: 'pending',
+            fileName,
+            xlsxPath,
+            progress: 0,
+            startedAt: Date.now(),
+        });
+        this.logger.log(`stored id=${id} name=${fileName} size=${(buffer.byteLength / 1024).toFixed(1)}KB expiresIn=${Math.round(ttl / 1000)}s`);
+        return {
+            id,
+            fileName,
+            path: xlsxPath,
+            size: buffer.byteLength,
+            expiresAt,
+        };
+    }
+    setTaskMode(id, mode) {
+        const task = this.tasks.get(id);
+        if (task) {
+            task.mode = mode;
+            this.tasks.set(id, task);
+        }
+    }
+    updateTaskProgress(id, progress, parsedBlocks, totalBlocks) {
+        const task = this.tasks.get(id);
+        if (!task || task.status !== 'pending')
+            return;
+        task.progress = Math.max(0, Math.min(100, progress));
+        if (parsedBlocks != null)
+            task.parsedBlocks = parsedBlocks;
+        if (totalBlocks != null)
+            task.totalBlocks = totalBlocks;
+        this.tasks.set(id, task);
+    }
+    async saveSnapshot(id, workbookData) {
+        const snapshotName = `${id}.snapshot.json`;
+        const fullPath = path.join(this.uploadDir, snapshotName);
+        await (0, promises_1.writeFile)(fullPath, JSON.stringify(workbookData), 'utf8');
+        const snapshotPath = `${exports.EXCEL_STATIC_PREFIX}/${snapshotName}`;
+        const task = this.tasks.get(id);
+        if (task) {
+            task.status = 'done';
+            task.mode = 'snapshot';
+            task.snapshotPath = snapshotPath;
+            task.progress = 100;
+            task.finishedAt = Date.now();
+            this.tasks.set(id, task);
+        }
+        return snapshotPath;
+    }
+    markTaskChunkedDone(id, metaFileName, extras) {
+        const metaPath = `${exports.EXCEL_STATIC_PREFIX}/${metaFileName}`;
+        const task = this.tasks.get(id);
+        if (task) {
+            task.status = 'done';
+            task.mode = 'chunked';
+            task.metaPath = metaPath;
+            task.progress = 100;
+            task.parsedBlocks = extras?.parsedBlocks;
+            task.totalBlocks = extras?.totalBlocks;
+            task.truncated = extras?.truncated;
+            task.finishedAt = Date.now();
+            this.tasks.set(id, task);
+        }
+        return metaPath;
+    }
+    markTaskError(id, error) {
+        const task = this.tasks.get(id);
+        if (task) {
+            task.status = 'error';
+            task.error = error;
+            task.finishedAt = Date.now();
+            this.tasks.set(id, task);
+        }
+    }
+    async readSnapshot(id) {
+        const fullPath = path.join(this.uploadDir, `${id}.snapshot.json`);
+        try {
+            await (0, promises_1.access)(fullPath);
+            const raw = await (0, promises_1.readFile)(fullPath, 'utf8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    isManagedFile(name) {
+        return (name.endsWith('.xlsx') ||
+            name.endsWith('.snapshot.json') ||
+            name.endsWith('.meta.json') ||
+            /\.block\.\d+\.\d+\.json$/i.test(name));
+    }
+    idFromFileName(name) {
+        return name
+            .replace(/\.xlsx$/i, '')
+            .replace(/\.snapshot\.json$/i, '')
+            .replace(/\.meta\.json$/i, '')
+            .replace(/\.block\.\d+\.\d+\.json$/i, '');
+    }
+    async cleanupExpired() {
+        const ttl = getTtlMs();
+        const now = Date.now();
+        let removed = 0;
+        let entries;
+        try {
+            entries = await (0, promises_1.readdir)(this.uploadDir);
+        }
+        catch {
+            return 0;
+        }
+        await Promise.all(entries.map(async (name) => {
+            if (!this.isManagedFile(name))
+                return;
+            const fullPath = path.join(this.uploadDir, name);
+            try {
+                const info = await (0, promises_1.stat)(fullPath);
+                if (now - info.mtimeMs > ttl) {
+                    await (0, promises_1.unlink)(fullPath);
+                    removed += 1;
+                    this.tasks.delete(this.idFromFileName(name));
+                }
+            }
+            catch {
+            }
+        }));
+        if (removed > 0) {
+            this.logger.log(`cleanup removed ${removed} expired file(s)`);
+        }
+        return removed;
+    }
+};
+exports.ExcelStorageService = ExcelStorageService;
+exports.ExcelStorageService = ExcelStorageService = ExcelStorageService_1 = __decorate([
+    (0, common_1.Injectable)()
+], ExcelStorageService);
+//# sourceMappingURL=excel-storage.service.js.map

package/lib/server/src/excel/excel-storage.service.js.map

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

package/lib/server/src/excel/excel.controller.d.ts

@@ -0,0 +1,17 @@
+import type { Request, Response } from 'express';
+import { ResponseEntity } from '../shared';
+import { ExcelTaskIdDto } from './dto/excel-task-id.dto';
+import { ExportExcelDto } from './dto/export-excel.dto';
+import { ExcelService } from './excel.service';
+export declare class ExcelController {
+    private readonly excelService;
+    constructor(excelService: ExcelService);
+    health(): ResponseEntity<{
+        ok: boolean;
+        service: string;
+        importMode: string;
+    }>;
+    uploadExcel(file: Express.Multer.File, req: Request): Promise<ResponseEntity<import("./excel.service").ExcelUploadResult>>;
+    getTask(params: ExcelTaskIdDto, req: Request): ResponseEntity<import("./excel.service").ExcelTaskResult>;
+    exportExcel(body: ExportExcelDto, res: Response): Promise<void>;
+}

package/lib/{excel → server/src/excel}/excel.controller.js

@@ -16,16 +16,37 @@ exports.ExcelController = void 0;
 const common_1 = require("@nestjs/common");
 const platform_express_1 = require("@nestjs/platform-express");
 const multer_1 = require("multer");
+const shared_1 = require("../shared");
+const excel_task_id_dto_1 = require("./dto/excel-task-id.dto");
+const export_excel_dto_1 = require("./dto/export-excel.dto");
 const excel_service_1 = require("./excel.service");
+const uploadInterceptor = (0, platform_express_1.FileInterceptor)('file', {
+    storage: (0, multer_1.memoryStorage)(),
+    limits: { fileSize: 50 * 1024 * 1024 },
+});
+const publicBaseUrl = (req) => {
+    const proto = req.headers['x-forwarded-proto'] || req.protocol;
+    const host = req.get('host');
+    return host ? `${proto}://${host}` : undefined;
+};
 let ExcelController = class ExcelController {
     constructor(excelService) {
         this.excelService = excelService;
     }
     health() {
-        return { ok: true, service: 'excel-exchange' };
+        return shared_1.ResponseEntity.ofSuccess({
+            ok: true,
+            service: 'excel-exchange',
+            importMode: 'async-snapshot-or-chunked',
+        });
+    }
+    async uploadExcel(file, req) {
+        const data = await this.excelService.uploadFile(file, publicBaseUrl(req));
+        return shared_1.ResponseEntity.ofSuccess(data);
     }
-    async importExcel(file) {
-        return this.excelService.importFile(file);
+    getTask(params, req) {
+        const data = this.excelService.getTask(params.id, publicBaseUrl(req));
+        return shared_1.ResponseEntity.ofSuccess(data);
     }
     async exportExcel(body, res) {
         const { buffer, fileName } = await this.excelService.exportFile(body);
@@ -42,26 +63,34 @@ __decorate([
     __metadata("design:returntype", void 0)
 ], ExcelController.prototype, "health", null);
 __decorate([
-    (0, common_1.Post)('import'),
-    (0, common_1.UseInterceptors)((0, platform_express_1.FileInterceptor)('file', {
-        storage: (0, multer_1.memoryStorage)(),
-        limits: { fileSize: 20 * 1024 * 1024 },
-    })),
+    (0, common_1.Post)('upload'),
+    (0, common_1.UseInterceptors)(uploadInterceptor),
     __param(0, (0, common_1.UploadedFile)()),
+    __param(1, (0, common_1.Req)()),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object]),
+    __metadata("design:paramtypes", [Object, Object]),
     __metadata("design:returntype", Promise)
-], ExcelController.prototype, "importExcel", null);
+], ExcelController.prototype, "uploadExcel", null);
+__decorate([
+    (0, common_1.Get)('task/:id'),
+    __param(0, (0, common_1.Param)()),
+    __param(1, (0, common_1.Req)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [excel_task_id_dto_1.ExcelTaskIdDto, Object]),
+    __metadata("design:returntype", void 0)
+], ExcelController.prototype, "getTask", null);
 __decorate([
     (0, common_1.Post)('export'),
     __param(0, (0, common_1.Body)()),
     __param(1, (0, common_1.Res)()),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:paramtypes", [export_excel_dto_1.ExportExcelDto, Object]),
     __metadata("design:returntype", Promise)
 ], ExcelController.prototype, "exportExcel", null);
 exports.ExcelController = ExcelController = __decorate([
     (0, common_1.Controller)('excel'),
+    (0, common_1.UsePipes)(shared_1.ZodValidationPipe),
+    __param(0, (0, common_1.Inject)(excel_service_1.ExcelService)),
     __metadata("design:paramtypes", [excel_service_1.ExcelService])
 ], ExcelController);
 //# sourceMappingURL=excel.controller.js.map

package/lib/server/src/excel/excel.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel.controller.js","sourceRoot":"","sources":["../../../../src/excel/excel.controller.ts"],"names":[],"mappings":"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"}

package/lib/server/src/excel/excel.converter.d.ts

@@ -0,0 +1,15 @@
+export type { ICellData, IRange, IWorkbookData, IWorksheetData, ChunkedBlock, ChunkedWorkbookMeta, } from '../../../utils/src/excel';
+export declare const CellValueType: any;
+export declare const importExcelBinary: any;
+export declare const workbookDataToExcelBuffer: any;
+export declare const excelBufferToChunkedWorkbook: any;
+export declare const splitWorkbookDataToChunks: any;
+export declare const shouldUseChunkedImport: any;
+export declare const skeletonWorkbookFromMeta: any;
+export declare const chunkedBlockFileName: any;
+export declare const chunkedMetaFileName: any;
+export declare const CHUNKED_FILE_BYTES: any;
+export declare const CHUNKED_ROW_THRESHOLD: any;
+export declare const DEFAULT_BLOCK_ROW_SIZE: any;
+export declare const DEFAULT_MAX_ROWS: any;
+export declare const DEFAULT_PARSE_TIMEOUT_MS: any;

package/lib/server/src/excel/excel.converter.js

@@ -0,0 +1,53 @@
+"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.DEFAULT_PARSE_TIMEOUT_MS = exports.DEFAULT_MAX_ROWS = exports.DEFAULT_BLOCK_ROW_SIZE = exports.CHUNKED_ROW_THRESHOLD = exports.CHUNKED_FILE_BYTES = exports.chunkedMetaFileName = exports.chunkedBlockFileName = exports.skeletonWorkbookFromMeta = exports.shouldUseChunkedImport = exports.splitWorkbookDataToChunks = exports.excelBufferToChunkedWorkbook = exports.workbookDataToExcelBuffer = exports.importExcelBinary = exports.CellValueType = void 0;
+const ExcelNS = __importStar(require("../../../utils/src/excel"));
+const Excel = ExcelNS.default ?? ExcelNS;
+exports.CellValueType = Excel.CellValueType;
+exports.importExcelBinary = Excel.importExcelBinary;
+exports.workbookDataToExcelBuffer = Excel.workbookDataToExcelBuffer;
+exports.excelBufferToChunkedWorkbook = Excel.excelBufferToChunkedWorkbook;
+exports.splitWorkbookDataToChunks = Excel.splitWorkbookDataToChunks;
+exports.shouldUseChunkedImport = Excel.shouldUseChunkedImport;
+exports.skeletonWorkbookFromMeta = Excel.skeletonWorkbookFromMeta;
+exports.chunkedBlockFileName = Excel.chunkedBlockFileName;
+exports.chunkedMetaFileName = Excel.chunkedMetaFileName;
+exports.CHUNKED_FILE_BYTES = Excel.CHUNKED_FILE_BYTES;
+exports.CHUNKED_ROW_THRESHOLD = Excel.CHUNKED_ROW_THRESHOLD;
+exports.DEFAULT_BLOCK_ROW_SIZE = Excel.DEFAULT_BLOCK_ROW_SIZE;
+exports.DEFAULT_MAX_ROWS = Excel.DEFAULT_MAX_ROWS;
+exports.DEFAULT_PARSE_TIMEOUT_MS = Excel.DEFAULT_PARSE_TIMEOUT_MS;
+//# sourceMappingURL=excel.converter.js.map

package/lib/server/src/excel/excel.converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel.converter.js","sourceRoot":"","sources":["../../../../src/excel/excel.converter.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,kEAAoD;AAEpD,MAAM,KAAK,GAAS,OAAe,CAAC,OAAO,IAAI,OAAO,CAAC;AAW1C,QAAA,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;AACpC,QAAA,iBAAiB,GAAG,KAAK,CAAC,iBAAiB,CAAC;AAC5C,QAAA,yBAAyB,GAAG,KAAK,CAAC,yBAAyB,CAAC;AAC5D,QAAA,4BAA4B,GAAG,KAAK,CAAC,4BAA4B,CAAC;AAClE,QAAA,yBAAyB,GAAG,KAAK,CAAC,yBAAyB,CAAC;AAC5D,QAAA,sBAAsB,GAAG,KAAK,CAAC,sBAAsB,CAAC;AACtD,QAAA,wBAAwB,GAAG,KAAK,CAAC,wBAAwB,CAAC;AAC1D,QAAA,oBAAoB,GAAG,KAAK,CAAC,oBAAoB,CAAC;AAClD,QAAA,mBAAmB,GAAG,KAAK,CAAC,mBAAmB,CAAC;AAChD,QAAA,kBAAkB,GAAG,KAAK,CAAC,kBAAkB,CAAC;AAC9C,QAAA,qBAAqB,GAAG,KAAK,CAAC,qBAAqB,CAAC;AACpD,QAAA,sBAAsB,GAAG,KAAK,CAAC,sBAAsB,CAAC;AACtD,QAAA,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,CAAC;AAC1C,QAAA,wBAAwB,GAAG,KAAK,CAAC,wBAAwB,CAAC"}

package/lib/{excel → server/src/excel}/excel.module.js

@@ -10,14 +10,15 @@ exports.ExcelModule = void 0;
 const common_1 = require("@nestjs/common");
 const excel_controller_1 = require("./excel.controller");
 const excel_service_1 = require("./excel.service");
+const excel_storage_service_1 = require("./excel-storage.service");
 let ExcelModule = class ExcelModule {
 };
 exports.ExcelModule = ExcelModule;
 exports.ExcelModule = ExcelModule = __decorate([
     (0, common_1.Module)({
         controllers: [excel_controller_1.ExcelController],
-        providers: [excel_service_1.ExcelService],
-        exports: [excel_service_1.ExcelService],
+        providers: [excel_storage_service_1.ExcelStorageService, excel_service_1.ExcelService],
+        exports: [excel_service_1.ExcelService, excel_storage_service_1.ExcelStorageService],
     })
 ], ExcelModule);
 //# sourceMappingURL=excel.module.js.map

package/lib/server/src/excel/excel.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel.module.js","sourceRoot":"","sources":["../../../../src/excel/excel.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,yDAAqD;AACrD,mDAA+C;AAC/C,mEAA8D;AAOvD,IAAM,WAAW,GAAjB,MAAM,WAAW;CAAG,CAAA;AAAd,kCAAW;sBAAX,WAAW;IALvB,IAAA,eAAM,EAAC;QACN,WAAW,EAAE,CAAC,kCAAe,CAAC;QAC9B,SAAS,EAAE,CAAC,2CAAmB,EAAE,4BAAY,CAAC;QAC9C,OAAO,EAAE,CAAC,4BAAY,EAAE,2CAAmB,CAAC;KAC7C,CAAC;GACW,WAAW,CAAG"}

package/lib/server/src/excel/excel.service.d.ts

@@ -0,0 +1,33 @@
+import { ExcelStorageService } from './excel-storage.service';
+import type { ExcelParseTask } from './excel-storage.service';
+import type { ExportExcelDto } from './dto/export-excel.dto';
+export type ExcelUploadResult = {
+    mode: 'async-snapshot';
+    id: string;
+    fileName: string;
+    path: string;
+    url: string;
+    taskPath: string;
+    taskUrl: string;
+    size: number;
+    expiresAt: number;
+    parseHint?: 'snapshot' | 'chunked';
+};
+export type ExcelTaskResult = ExcelParseTask & {
+    snapshotUrl?: string;
+    metaUrl?: string;
+    xlsxUrl?: string;
+};
+export declare class ExcelService {
+    private readonly storage;
+    private readonly logger;
+    constructor(storage: ExcelStorageService);
+    uploadFile(file?: Express.Multer.File, publicBaseUrl?: string): Promise<ExcelUploadResult>;
+    getTask(id: string, publicBaseUrl?: string): ExcelTaskResult;
+    private parseToSnapshot;
+    private parseChunkedLuckyExcel;
+    exportFile(body: ExportExcelDto): Promise<{
+        buffer: Buffer;
+        fileName: string;
+    }>;
+}