@neohm/nestend 1.0.0

package/dist/document/document.module.js

@@ -0,0 +1,54 @@
+"use strict";
+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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var DocumentModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentModule = void 0;
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("@nestjs/typeorm");
+const es6_classes_1 = __importDefault(require("./es6.classes"));
+const [DocumentService, S3BucketDocumentService, MinioBucketDocumentService] = es6_classes_1.default.services;
+function createDocumentProviders(options = {}) {
+    return [
+        S3BucketDocumentService,
+        MinioBucketDocumentService,
+        {
+            provide: DocumentService,
+            useFactory: (s3Service, minioService, dataSource) => new DocumentService(s3Service, minioService, dataSource),
+            inject: [
+                S3BucketDocumentService,
+                MinioBucketDocumentService,
+                (0, typeorm_1.getDataSourceToken)(options.dataSourceName),
+            ],
+        },
+    ];
+}
+const documentExports = [
+    DocumentService,
+    S3BucketDocumentService,
+    MinioBucketDocumentService,
+];
+let DocumentModule = DocumentModule_1 = class DocumentModule {
+    static register(options = {}) {
+        return {
+            module: DocumentModule_1,
+            providers: createDocumentProviders(options),
+            exports: documentExports,
+        };
+    }
+};
+exports.DocumentModule = DocumentModule;
+exports.DocumentModule = DocumentModule = DocumentModule_1 = __decorate([
+    (0, common_1.Module)({
+        providers: createDocumentProviders(),
+        exports: documentExports,
+    })
+], DocumentModule);
+//# sourceMappingURL=document.module.js.map

package/dist/document/document.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.module.js","sourceRoot":"","sources":["../../src/document/document.module.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAiE;AACjE,6CAAqD;AAErD,gEAAuC;AAEvC,MAAM,CAAC,eAAe,EAAE,uBAAuB,EAAE,0BAA0B,CAAC,GAC1E,qBAAU,CAAC,QAAQ,CAAC;AAMtB,SAAS,uBAAuB,CAC9B,UAAiC,EAAE;IAEnC,OAAO;QACL,uBAAuB;QACvB,0BAA0B;QAC1B;YACE,OAAO,EAAE,eAAe;YACxB,UAAU,EAAE,CAAC,SAAc,EAAE,YAAiB,EAAE,UAAsB,EAAE,EAAE,CACxE,IAAI,eAAe,CAAC,SAAS,EAAE,YAAY,EAAE,UAAU,CAAC;YAC1D,MAAM,EAAE;gBACN,uBAAuB;gBACvB,0BAA0B;gBAC1B,IAAA,4BAAkB,EAAC,OAAO,CAAC,cAAc,CAAC;aAC3C;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,eAAe,GAAG;IACtB,eAAe;IACf,uBAAuB;IACvB,0BAA0B;CAC3B,CAAC;AAWK,IAAM,cAAc,sBAApB,MAAM,cAAc;IACzB,MAAM,CAAC,QAAQ,CAAC,UAAiC,EAAE;QACjD,OAAO;YACL,MAAM,EAAE,gBAAc;YACtB,SAAS,EAAE,uBAAuB,CAAC,OAAO,CAAC;YAC3C,OAAO,EAAE,eAAe;SACzB,CAAC;IACJ,CAAC;CACF,CAAA;AARY,wCAAc;yBAAd,cAAc;IAJ1B,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,uBAAuB,EAAE;QACpC,OAAO,EAAE,eAAe;KACzB,CAAC;GACW,cAAc,CAQ1B"}

package/dist/document/enums/document.default.enum.d.ts

@@ -0,0 +1,4 @@
+export declare enum DocumentDefault {
+    PRESIGNED_URL_EXPIRY_SECONDS = 3600
+}
+//# sourceMappingURL=document.default.enum.d.ts.map

package/dist/document/enums/document.default.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.default.enum.d.ts","sourceRoot":"","sources":["../../../src/document/enums/document.default.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,eAAe;IACzB,4BAA4B,OAAO;CACpC"}

package/dist/document/enums/document.default.enum.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentDefault = void 0;
+var DocumentDefault;
+(function (DocumentDefault) {
+    DocumentDefault[DocumentDefault["PRESIGNED_URL_EXPIRY_SECONDS"] = 3600] = "PRESIGNED_URL_EXPIRY_SECONDS";
+})(DocumentDefault || (exports.DocumentDefault = DocumentDefault = {}));
+//# sourceMappingURL=document.default.enum.js.map

package/dist/document/enums/document.default.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.default.enum.js","sourceRoot":"","sources":["../../../src/document/enums/document.default.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,eAEX;AAFD,WAAY,eAAe;IACzB,wGAAmC,CAAA;AACrC,CAAC,EAFW,eAAe,+BAAf,eAAe,QAE1B"}

package/dist/document/es6.classes.d.ts

@@ -0,0 +1,8 @@
+import { DocumentService } from './services/document.service';
+import { MinioBucketDocumentService } from './services/minio.bucket.document.service';
+import { S3BucketDocumentService } from './services/s3.bucket.document.service';
+declare const es6Classes: {
+    services: readonly [typeof DocumentService, typeof S3BucketDocumentService, typeof MinioBucketDocumentService];
+};
+export default es6Classes;
+//# sourceMappingURL=es6.classes.d.ts.map

package/dist/document/es6.classes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"es6.classes.d.ts","sourceRoot":"","sources":["../../src/document/es6.classes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAEhF,QAAA,MAAM,UAAU;;CAMf,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/document/es6.classes.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const document_service_1 = require("./services/document.service");
+const minio_bucket_document_service_1 = require("./services/minio.bucket.document.service");
+const s3_bucket_document_service_1 = require("./services/s3.bucket.document.service");
+const es6Classes = {
+    services: [
+        document_service_1.DocumentService,
+        s3_bucket_document_service_1.S3BucketDocumentService,
+        minio_bucket_document_service_1.MinioBucketDocumentService,
+    ],
+};
+exports.default = es6Classes;
+//# sourceMappingURL=es6.classes.js.map

package/dist/document/es6.classes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"es6.classes.js","sourceRoot":"","sources":["../../src/document/es6.classes.ts"],"names":[],"mappings":";;AAAA,kEAA8D;AAC9D,4FAAsF;AACtF,sFAAgF;AAEhF,MAAM,UAAU,GAAG;IACjB,QAAQ,EAAE;QACR,kCAAe;QACf,oDAAuB;QACvB,0DAA0B;KAClB;CACX,CAAC;AAEF,kBAAe,UAAU,CAAC"}

package/dist/document/services/document.service.d.ts

@@ -0,0 +1,32 @@
+import { Logger } from '@nestjs/common';
+import { Readable } from 'stream';
+import { DataSource } from 'typeorm';
+import { DocumentEntity } from '../../common/entities/document.entity';
+import { MinioBucketDocumentService } from './minio.bucket.document.service';
+import { S3BucketDocumentService } from './s3.bucket.document.service';
+import { BucketDocumentStorage, DocumentLinkOptions, PresignedUrlOptions, StoredDocument, UploadDocumentOptions, UploadableFile } from '../types/document.types';
+export declare class DocumentService {
+    private readonly s3BucketDocumentService;
+    private readonly minioBucketDocumentService;
+    private readonly dataSource;
+    protected readonly logger: Logger;
+    constructor(s3BucketDocumentService: S3BucketDocumentService, minioBucketDocumentService: MinioBucketDocumentService, dataSource: DataSource);
+    uploadDocument(files: UploadableFile[], options?: UploadDocumentOptions): Promise<string[]>;
+    uploadDocuments(files: UploadableFile[], options?: UploadDocumentOptions): Promise<StoredDocument[]>;
+    uploadSingleDocument(file: UploadableFile, options?: UploadDocumentOptions): Promise<StoredDocument>;
+    persistDocumentRecord(storedDocument: StoredDocument, options: Pick<UploadDocumentOptions, 'createdBy' | 'sourceType' | 'sourceId' | 'isPublic'>): Promise<DocumentEntity>;
+    deleteDocument(documentUuid: string, options?: {
+        hard?: boolean;
+    }): Promise<void>;
+    getDocumentLink(document: DocumentEntity, options?: DocumentLinkOptions): Promise<string>;
+    getPresignedUrl(objectPath: string, options?: PresignedUrlOptions): Promise<string>;
+    documentExists(objectPath: string): Promise<boolean>;
+    getDocumentStream(document: DocumentEntity): Promise<Readable>;
+    findDocumentsBySource(sourceType: string, sourceId: string): Promise<DocumentEntity[]>;
+    getActiveStorage(): BucketDocumentStorage;
+    getStorageByDriver(driver: string): BucketDocumentStorage;
+    generateStoredName(originalName: string): string;
+    private buildObjectPath;
+    private get documentRepository();
+}
+//# sourceMappingURL=document.service.d.ts.map

package/dist/document/services/document.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.service.d.ts","sourceRoot":"","sources":["../../../src/document/services/document.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGpD,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,UAAU,EAAc,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAKvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,cAAc,EACf,MAAM,yBAAyB,CAAC;AAOjC,qBACa,eAAe;IAIxB,OAAO,CAAC,QAAQ,CAAC,uBAAuB;IACxC,OAAO,CAAC,QAAQ,CAAC,0BAA0B;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU;IAL7B,SAAS,CAAC,QAAQ,CAAC,MAAM,SAAoC;gBAG1C,uBAAuB,EAAE,uBAAuB,EAChD,0BAA0B,EAAE,0BAA0B,EACtD,UAAU,EAAE,UAAU;IAInC,cAAc,CAClB,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,MAAM,EAAE,CAAC;IAMd,eAAe,CACnB,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,cAAc,EAAE,CAAC;IAMtB,oBAAoB,CACxB,IAAI,EAAE,cAAc,EACpB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,cAAc,CAAC;IAsBpB,qBAAqB,CACzB,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,IAAI,CACX,qBAAqB,EACrB,WAAW,GAAG,YAAY,GAAG,UAAU,GAAG,UAAU,CACrD,GACA,OAAO,CAAC,cAAc,CAAC;IAuBpB,cAAc,CAClB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAC3B,OAAO,CAAC,IAAI,CAAC;IAgBV,eAAe,CACnB,QAAQ,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,MAAM,CAAC;IAOZ,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,MAAM,CAAC;IAIZ,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpD,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAM9D,qBAAqB,CACzB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,EAAE,CAAC;IAQ5B,gBAAgB,IAAI,qBAAqB;IAOzC,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB;IAezD,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAOhD,OAAO,CAAC,eAAe;IAKvB,OAAO,KAAK,kBAAkB,GAE7B;CACF"}

package/dist/document/services/document.service.js

@@ -0,0 +1,148 @@
+"use strict";
+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 __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var DocumentService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentService = void 0;
+const common_1 = require("@nestjs/common");
+const crypto_1 = require("crypto");
+const path_1 = require("path");
+const typeorm_1 = require("typeorm");
+const document_entity_1 = require("../../common/entities/document.entity");
+const storage_driver_enum_1 = require("../../common/enums/storage.driver.enum");
+const bad_request_exception_1 = require("../../global/exceptions/bad.request.exception");
+const not_found_exception_1 = require("../../global/exceptions/not.found.exception");
+const operation_exception_1 = require("../../global/exceptions/operation.exception");
+const minio_bucket_document_service_1 = require("./minio.bucket.document.service");
+const s3_bucket_document_service_1 = require("./s3.bucket.document.service");
+let DocumentService = DocumentService_1 = class DocumentService {
+    s3BucketDocumentService;
+    minioBucketDocumentService;
+    dataSource;
+    logger = new common_1.Logger(DocumentService_1.name);
+    constructor(s3BucketDocumentService, minioBucketDocumentService, dataSource) {
+        this.s3BucketDocumentService = s3BucketDocumentService;
+        this.minioBucketDocumentService = minioBucketDocumentService;
+        this.dataSource = dataSource;
+    }
+    async uploadDocument(files, options) {
+        const storedDocuments = await this.uploadDocuments(files, options);
+        return storedDocuments.map((storedDocument) => storedDocument.link);
+    }
+    async uploadDocuments(files, options) {
+        return Promise.all(files.map((file) => this.uploadSingleDocument(file, options)));
+    }
+    async uploadSingleDocument(file, options) {
+        const storage = this.getActiveStorage();
+        const storedName = this.generateStoredName(file.originalname);
+        const objectPath = this.buildObjectPath(storedName, options?.pathPrefix);
+        const link = await storage.upload(objectPath, file.buffer, file.mimetype);
+        const storedDocument = {
+            link,
+            path: objectPath,
+            storedName,
+            originalName: file.originalname,
+            mimeType: file.mimetype,
+            sizeBytes: file.size,
+            storageDriver: storage.driver,
+        };
+        if (options?.persist)
+            await this.persistDocumentRecord(storedDocument, options);
+        return storedDocument;
+    }
+    async persistDocumentRecord(storedDocument, options) {
+        if (!options.createdBy || !options.sourceType || !options.sourceId) {
+            throw new bad_request_exception_1.BadRequestException('Persisting a document record requires createdBy, sourceType and sourceId options.');
+        }
+        return this.documentRepository.save(this.documentRepository.create({
+            original_name: storedDocument.originalName,
+            stored_name: storedDocument.storedName,
+            mime_type: storedDocument.mimeType,
+            size_bytes: storedDocument.sizeBytes,
+            storage_driver: storedDocument.storageDriver,
+            path: storedDocument.path,
+            is_public: options.isPublic ?? false,
+            source_type: options.sourceType,
+            source_id: options.sourceId,
+            created_by: options.createdBy,
+        }));
+    }
+    async deleteDocument(documentUuid, options) {
+        const document = await this.documentRepository.findOne({
+            where: { uuid: documentUuid },
+        });
+        if (!document)
+            throw new not_found_exception_1.NotFoundException(`Document "${documentUuid}" was not found.`);
+        await this.getStorageByDriver(document.storage_driver).delete(document.path);
+        if (options?.hard)
+            await this.documentRepository.delete({ uuid: documentUuid });
+        else
+            await this.documentRepository.softDelete({ uuid: documentUuid });
+    }
+    async getDocumentLink(document, options) {
+        const storage = this.getStorageByDriver(document.storage_driver);
+        if (document.is_public && !options?.signed)
+            return storage.getPublicUrl(document.path);
+        return storage.getPresignedUrl(document.path, options);
+    }
+    async getPresignedUrl(objectPath, options) {
+        return this.getActiveStorage().getPresignedUrl(objectPath, options);
+    }
+    async documentExists(objectPath) {
+        return this.getActiveStorage().exists(objectPath);
+    }
+    async getDocumentStream(document) {
+        return this.getStorageByDriver(document.storage_driver).getStream(document.path);
+    }
+    async findDocumentsBySource(sourceType, sourceId) {
+        return this.documentRepository.find({
+            where: { source_type: sourceType, source_id: sourceId },
+            order: { created_at: 'DESC' },
+        });
+    }
+    getActiveStorage() {
+        const driver = (process.env.DOCUMENT_STORAGE_DRIVER || storage_driver_enum_1.StorageDriver.MINIO).toLowerCase();
+        return this.getStorageByDriver(driver);
+    }
+    getStorageByDriver(driver) {
+        const storageByDriver = {
+            [storage_driver_enum_1.StorageDriver.S3]: this.s3BucketDocumentService,
+            [storage_driver_enum_1.StorageDriver.MINIO]: this.minioBucketDocumentService,
+            [storage_driver_enum_1.StorageDriver.LOCAL]: this.minioBucketDocumentService,
+        };
+        const storage = storageByDriver[driver];
+        if (!storage) {
+            throw new operation_exception_1.OperationException(`Unsupported document storage driver "${driver}".`);
+        }
+        return storage;
+    }
+    generateStoredName(originalName) {
+        const extension = (0, path_1.extname)(originalName)
+            .toLowerCase()
+            .replace(/[^.a-z0-9]/g, '');
+        return `${(0, crypto_1.randomUUID)()}${extension}`;
+    }
+    buildObjectPath(storedName, pathPrefix) {
+        if (!pathPrefix)
+            return storedName;
+        return `${pathPrefix.replace(/^\/+|\/+$/g, '')}/${storedName}`;
+    }
+    get documentRepository() {
+        return this.dataSource.getRepository(document_entity_1.DocumentEntity);
+    }
+};
+exports.DocumentService = DocumentService;
+exports.DocumentService = DocumentService = DocumentService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [s3_bucket_document_service_1.S3BucketDocumentService,
+        minio_bucket_document_service_1.MinioBucketDocumentService,
+        typeorm_1.DataSource])
+], DocumentService);
+//# sourceMappingURL=document.service.js.map

package/dist/document/services/document.service.js.map

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

package/dist/document/services/minio.bucket.document.service.d.ts

@@ -0,0 +1,23 @@
+import { Logger } from '@nestjs/common';
+import { Readable } from 'stream';
+import { StorageDriver } from '../../common/enums/storage.driver.enum';
+import { BucketDocumentStorage, PresignedUrlOptions } from '../types/document.types';
+export declare class MinioBucketDocumentService implements BucketDocumentStorage {
+    readonly driver = StorageDriver.MINIO;
+    protected readonly logger: Logger;
+    private client;
+    private bucketEnsured;
+    upload(objectPath: string, content: Buffer, mimeType: string): Promise<string>;
+    delete(objectPath: string): Promise<void>;
+    exists(objectPath: string): Promise<boolean>;
+    getPresignedUrl(objectPath: string, options?: PresignedUrlOptions): Promise<string>;
+    getPublicUrl(objectPath: string): string;
+    getStream(objectPath: string): Promise<Readable>;
+    private ensureBucketExists;
+    private getClient;
+    private getBucketName;
+    private getEndpoint;
+    private getPort;
+    private getDefaultPresignedUrlExpiry;
+}
+//# sourceMappingURL=minio.bucket.document.service.d.ts.map

package/dist/document/services/minio.bucket.document.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minio.bucket.document.service.d.ts","sourceRoot":"","sources":["../../../src/document/services/minio.bucket.document.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAGvE,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AAOjC,qBACa,0BAA2B,YAAW,qBAAqB;IACtE,QAAQ,CAAC,MAAM,uBAAuB;IACtC,SAAS,CAAC,QAAQ,CAAC,MAAM,SAA+C;IACxE,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,aAAa,CAAS;IAExB,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC;IAcZ,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS5C,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,MAAM,CAAC;IAQlB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IASlC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;YAIxC,kBAAkB;IAWhC,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,4BAA4B;CAMrC"}

package/dist/document/services/minio.bucket.document.service.js

@@ -0,0 +1,98 @@
+"use strict";
+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 MinioBucketDocumentService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MinioBucketDocumentService = void 0;
+const common_1 = require("@nestjs/common");
+const minio_1 = require("minio");
+const storage_driver_enum_1 = require("../../common/enums/storage.driver.enum");
+const operation_exception_1 = require("../../global/exceptions/operation.exception");
+const document_default_enum_1 = require("../enums/document.default.enum");
+let MinioBucketDocumentService = MinioBucketDocumentService_1 = class MinioBucketDocumentService {
+    driver = storage_driver_enum_1.StorageDriver.MINIO;
+    logger = new common_1.Logger(MinioBucketDocumentService_1.name);
+    client = null;
+    bucketEnsured = false;
+    async upload(objectPath, content, mimeType) {
+        await this.ensureBucketExists();
+        await this.getClient().putObject(this.getBucketName(), objectPath, content, content.length, {
+            'Content-Type': mimeType,
+        });
+        return this.getPublicUrl(objectPath);
+    }
+    async delete(objectPath) {
+        await this.getClient().removeObject(this.getBucketName(), objectPath);
+    }
+    async exists(objectPath) {
+        try {
+            await this.getClient().statObject(this.getBucketName(), objectPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async getPresignedUrl(objectPath, options) {
+        return this.getClient().presignedGetObject(this.getBucketName(), objectPath, options?.expirySeconds ?? this.getDefaultPresignedUrlExpiry());
+    }
+    getPublicUrl(objectPath) {
+        const publicBaseUrl = process.env.MINIO_PUBLIC_URL;
+        if (publicBaseUrl) {
+            return `${publicBaseUrl.replace(/\/+$/, '')}/${this.getBucketName()}/${objectPath}`;
+        }
+        const protocol = process.env.MINIO_USE_SSL === 'true' ? 'https' : 'http';
+        return `${protocol}://${this.getEndpoint()}:${this.getPort()}/${this.getBucketName()}/${objectPath}`;
+    }
+    async getStream(objectPath) {
+        return this.getClient().getObject(this.getBucketName(), objectPath);
+    }
+    async ensureBucketExists() {
+        if (this.bucketEnsured)
+            return;
+        const bucketName = this.getBucketName();
+        const exists = await this.getClient().bucketExists(bucketName);
+        if (!exists) {
+            await this.getClient().makeBucket(bucketName);
+            this.logger.log(`Created MinIO bucket "${bucketName}"`);
+        }
+        this.bucketEnsured = true;
+    }
+    getClient() {
+        if (!this.client) {
+            this.client = new minio_1.Client({
+                endPoint: this.getEndpoint(),
+                port: this.getPort(),
+                useSSL: process.env.MINIO_USE_SSL === 'true',
+                accessKey: process.env.MINIO_ACCESS_KEY || '',
+                secretKey: process.env.MINIO_SECRET_KEY || '',
+            });
+        }
+        return this.client;
+    }
+    getBucketName() {
+        const bucketName = process.env.MINIO_BUCKET;
+        if (!bucketName)
+            throw new operation_exception_1.OperationException('MINIO_BUCKET env variable is not set.');
+        return bucketName;
+    }
+    getEndpoint() {
+        return process.env.MINIO_ENDPOINT || 'localhost';
+    }
+    getPort() {
+        return parseInt(process.env.MINIO_PORT || '9000', 10);
+    }
+    getDefaultPresignedUrlExpiry() {
+        return (parseInt(process.env.DOCUMENT_PRESIGNED_URL_EXPIRY_SECONDS || '', 10) ||
+            document_default_enum_1.DocumentDefault.PRESIGNED_URL_EXPIRY_SECONDS);
+    }
+};
+exports.MinioBucketDocumentService = MinioBucketDocumentService;
+exports.MinioBucketDocumentService = MinioBucketDocumentService = MinioBucketDocumentService_1 = __decorate([
+    (0, common_1.Injectable)()
+], MinioBucketDocumentService);
+//# sourceMappingURL=minio.bucket.document.service.js.map

package/dist/document/services/minio.bucket.document.service.js.map

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

package/dist/document/services/s3.bucket.document.service.d.ts

@@ -0,0 +1,20 @@
+import { Logger } from '@nestjs/common';
+import { Readable } from 'stream';
+import { StorageDriver } from '../../common/enums/storage.driver.enum';
+import { BucketDocumentStorage, PresignedUrlOptions } from '../types/document.types';
+export declare class S3BucketDocumentService implements BucketDocumentStorage {
+    readonly driver = StorageDriver.S3;
+    protected readonly logger: Logger;
+    private client;
+    upload(objectPath: string, content: Buffer, mimeType: string): Promise<string>;
+    delete(objectPath: string): Promise<void>;
+    exists(objectPath: string): Promise<boolean>;
+    getPresignedUrl(objectPath: string, options?: PresignedUrlOptions): Promise<string>;
+    getPublicUrl(objectPath: string): string;
+    getStream(objectPath: string): Promise<Readable>;
+    private getClient;
+    private getBucketName;
+    private getRegion;
+    private getDefaultPresignedUrlExpiry;
+}
+//# sourceMappingURL=s3.bucket.document.service.d.ts.map

package/dist/document/services/s3.bucket.document.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.bucket.document.service.d.ts","sourceRoot":"","sources":["../../../src/document/services/s3.bucket.document.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,MAAM,EAAE,MAAM,gBAAgB,CAAC;AASpD,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAGvE,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AAOjC,qBACa,uBAAwB,YAAW,qBAAqB;IACnE,QAAQ,CAAC,MAAM,oBAAoB;IACnC,SAAS,CAAC,QAAQ,CAAC,MAAM,SAA4C;IACrE,OAAO,CAAC,MAAM,CAAyB;IAEjC,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC;IAYZ,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASzC,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAc5C,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,MAAM,CAAC;IAUlB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAUlC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAOtD,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,4BAA4B;CAMrC"}

package/dist/document/services/s3.bucket.document.service.js

@@ -0,0 +1,98 @@
+"use strict";
+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 S3BucketDocumentService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3BucketDocumentService = void 0;
+const common_1 = require("@nestjs/common");
+const client_s3_1 = require("@aws-sdk/client-s3");
+const s3_request_presigner_1 = require("@aws-sdk/s3-request-presigner");
+const storage_driver_enum_1 = require("../../common/enums/storage.driver.enum");
+const operation_exception_1 = require("../../global/exceptions/operation.exception");
+const document_default_enum_1 = require("../enums/document.default.enum");
+let S3BucketDocumentService = S3BucketDocumentService_1 = class S3BucketDocumentService {
+    driver = storage_driver_enum_1.StorageDriver.S3;
+    logger = new common_1.Logger(S3BucketDocumentService_1.name);
+    client = null;
+    async upload(objectPath, content, mimeType) {
+        await this.getClient().send(new client_s3_1.PutObjectCommand({
+            Bucket: this.getBucketName(),
+            Key: objectPath,
+            Body: content,
+            ContentType: mimeType,
+        }));
+        return this.getPublicUrl(objectPath);
+    }
+    async delete(objectPath) {
+        await this.getClient().send(new client_s3_1.DeleteObjectCommand({
+            Bucket: this.getBucketName(),
+            Key: objectPath,
+        }));
+    }
+    async exists(objectPath) {
+        try {
+            await this.getClient().send(new client_s3_1.HeadObjectCommand({
+                Bucket: this.getBucketName(),
+                Key: objectPath,
+            }));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async getPresignedUrl(objectPath, options) {
+        const command = new client_s3_1.GetObjectCommand({
+            Bucket: this.getBucketName(),
+            Key: objectPath,
+        });
+        return (0, s3_request_presigner_1.getSignedUrl)(this.getClient(), command, {
+            expiresIn: options?.expirySeconds ?? this.getDefaultPresignedUrlExpiry(),
+        });
+    }
+    getPublicUrl(objectPath) {
+        const publicBaseUrl = process.env.AWS_S3_PUBLIC_URL;
+        if (publicBaseUrl)
+            return `${publicBaseUrl.replace(/\/+$/, '')}/${objectPath}`;
+        const endpoint = process.env.AWS_S3_ENDPOINT;
+        if (endpoint)
+            return `${endpoint.replace(/\/+$/, '')}/${this.getBucketName()}/${objectPath}`;
+        return `https://${this.getBucketName()}.s3.${this.getRegion()}.amazonaws.com/${objectPath}`;
+    }
+    async getStream(objectPath) {
+        const response = await this.getClient().send(new client_s3_1.GetObjectCommand({ Bucket: this.getBucketName(), Key: objectPath }));
+        return response.Body;
+    }
+    getClient() {
+        if (!this.client) {
+            this.client = new client_s3_1.S3Client({
+                region: this.getRegion(),
+                endpoint: process.env.AWS_S3_ENDPOINT || undefined,
+                forcePathStyle: process.env.AWS_S3_FORCE_PATH_STYLE === 'true',
+            });
+        }
+        return this.client;
+    }
+    getBucketName() {
+        const bucketName = process.env.AWS_S3_BUCKET;
+        if (!bucketName)
+            throw new operation_exception_1.OperationException('AWS_S3_BUCKET env variable is not set.');
+        return bucketName;
+    }
+    getRegion() {
+        return process.env.AWS_S3_REGION || process.env.AWS_REGION || 'us-east-1';
+    }
+    getDefaultPresignedUrlExpiry() {
+        return (parseInt(process.env.DOCUMENT_PRESIGNED_URL_EXPIRY_SECONDS || '', 10) ||
+            document_default_enum_1.DocumentDefault.PRESIGNED_URL_EXPIRY_SECONDS);
+    }
+};
+exports.S3BucketDocumentService = S3BucketDocumentService;
+exports.S3BucketDocumentService = S3BucketDocumentService = S3BucketDocumentService_1 = __decorate([
+    (0, common_1.Injectable)()
+], S3BucketDocumentService);
+//# sourceMappingURL=s3.bucket.document.service.js.map

package/dist/document/services/s3.bucket.document.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.bucket.document.service.js","sourceRoot":"","sources":["../../../src/document/services/s3.bucket.document.service.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAoD;AACpD,kDAM4B;AAC5B,wEAA6D;AAE7D,gFAAuE;AACvE,qFAAiF;AACjF,0EAAiE;AAY1D,IAAM,uBAAuB,+BAA7B,MAAM,uBAAuB;IACzB,MAAM,GAAG,mCAAa,CAAC,EAAE,CAAC;IAChB,MAAM,GAAG,IAAI,eAAM,CAAC,yBAAuB,CAAC,IAAI,CAAC,CAAC;IAC7D,MAAM,GAAoB,IAAI,CAAC;IAEvC,KAAK,CAAC,MAAM,CACV,UAAkB,EAClB,OAAe,EACf,QAAgB;QAEhB,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CACzB,IAAI,4BAAgB,CAAC;YACnB,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE;YAC5B,GAAG,EAAE,UAAU;YACf,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,QAAQ;SACtB,CAAC,CACH,CAAC;QACF,OAAO,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,UAAkB;QAC7B,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CACzB,IAAI,+BAAmB,CAAC;YACtB,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE;YAC5B,GAAG,EAAE,UAAU;SAChB,CAAC,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,UAAkB;QAC7B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CACzB,IAAI,6BAAiB,CAAC;gBACpB,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE;gBAC5B,GAAG,EAAE,UAAU;aAChB,CAAC,CACH,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,UAAkB,EAClB,OAA6B;QAE7B,MAAM,OAAO,GAAG,IAAI,4BAAgB,CAAC;YACnC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE;YAC5B,GAAG,EAAE,UAAU;SAChB,CAAC,CAAC;QACH,OAAO,IAAA,mCAAY,EAAC,IAAI,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE;YAC7C,SAAS,EAAE,OAAO,EAAE,aAAa,IAAI,IAAI,CAAC,4BAA4B,EAAE;SACzE,CAAC,CAAC;IACL,CAAC;IAED,YAAY,CAAC,UAAkB;QAC7B,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QACpD,IAAI,aAAa;YACf,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC;QAC9D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAC7C,IAAI,QAAQ;YACV,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,IAAI,UAAU,EAAE,CAAC;QACjF,OAAO,WAAW,IAAI,CAAC,aAAa,EAAE,OAAO,IAAI,CAAC,SAAS,EAAE,kBAAkB,UAAU,EAAE,CAAC;IAC9F,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,UAAkB;QAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAC1C,IAAI,4BAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CACxE,CAAC;QACF,OAAO,QAAQ,CAAC,IAAgB,CAAC;IACnC,CAAC;IAEO,SAAS;QACf,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,IAAI,oBAAQ,CAAC;gBACzB,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE;gBACxB,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,SAAS;gBAClD,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,MAAM;aAC/D,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAEO,aAAa;QACnB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;QAC7C,IAAI,CAAC,UAAU;YACb,MAAM,IAAI,wCAAkB,CAAC,wCAAwC,CAAC,CAAC;QACzE,OAAO,UAAU,CAAC;IACpB,CAAC;IAEO,SAAS;QACf,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,WAAW,CAAC;IAC5E,CAAC;IAEO,4BAA4B;QAClC,OAAO,CACL,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,qCAAqC,IAAI,EAAE,EAAE,EAAE,CAAC;YACrE,uCAAe,CAAC,4BAA4B,CAC7C,CAAC;IACJ,CAAC;CACF,CAAA;AAtGY,0DAAuB;kCAAvB,uBAAuB;IADnC,IAAA,mBAAU,GAAE;GACA,uBAAuB,CAsGnC"}

package/dist/document/types/document.types.d.ts

@@ -0,0 +1,40 @@
+import { Readable } from 'stream';
+export interface UploadableFile {
+    originalname: string;
+    mimetype: string;
+    size: number;
+    buffer: Buffer;
+}
+export interface UploadDocumentOptions {
+    pathPrefix?: string;
+    isPublic?: boolean;
+    persist?: boolean;
+    createdBy?: string;
+    sourceType?: string;
+    sourceId?: string;
+}
+export interface StoredDocument {
+    link: string;
+    path: string;
+    storedName: string;
+    originalName: string;
+    mimeType: string;
+    sizeBytes: number;
+    storageDriver: string;
+}
+export interface PresignedUrlOptions {
+    expirySeconds?: number;
+}
+export interface DocumentLinkOptions extends PresignedUrlOptions {
+    signed?: boolean;
+}
+export interface BucketDocumentStorage {
+    readonly driver: string;
+    upload(objectPath: string, content: Buffer, mimeType: string): Promise<string>;
+    delete(objectPath: string): Promise<void>;
+    exists(objectPath: string): Promise<boolean>;
+    getPresignedUrl(objectPath: string, options?: PresignedUrlOptions): Promise<string>;
+    getPublicUrl(objectPath: string): string;
+    getStream(objectPath: string): Promise<Readable>;
+}
+//# sourceMappingURL=document.types.d.ts.map

package/dist/document/types/document.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.types.d.ts","sourceRoot":"","sources":["../../../src/document/types/document.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAMlC,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IAEpC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAElC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAE9D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAGD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,eAAe,CACb,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IACzC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAClD"}

package/dist/document/types/document.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=document.types.js.map

package/dist/document/types/document.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.types.js","sourceRoot":"","sources":["../../../src/document/types/document.types.ts"],"names":[],"mappings":""}