@carlonicora/nestjs-neo4jsonapi 1.98.0 → 1.100.0

package/dist/foundations/chunker/services/types/email.service.js

@@ -0,0 +1,124 @@
+"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 EmailParserService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailParserService = void 0;
+const common_1 = require("@nestjs/common");
+const mailparser_1 = require("mailparser");
+let EmailParserService = EmailParserService_1 = class EmailParserService {
+    constructor() {
+        this.logger = new common_1.Logger(EmailParserService_1.name);
+    }
+    async parseEml(buffer) {
+        const parsed = await (0, mailparser_1.simpleParser)(buffer);
+        const formatAddress = (addr) => {
+            if (!addr)
+                return "";
+            if (typeof addr === "string")
+                return addr;
+            if (addr.text)
+                return addr.text;
+            if (addr.value) {
+                return addr.value.map((v) => v.address || v.name || "").join(", ");
+            }
+            return String(addr);
+        };
+        return {
+            subject: parsed.subject || "(No Subject)",
+            from: formatAddress(parsed.from),
+            to: formatAddress(parsed.to),
+            cc: parsed.cc ? formatAddress(parsed.cc) : undefined,
+            date: parsed.date?.toISOString() || "",
+            textBody: parsed.text || "",
+            htmlBody: parsed.html || undefined,
+            attachments: (parsed.attachments || []).map((att) => ({
+                filename: att.filename || "unnamed",
+                contentType: att.contentType || "application/octet-stream",
+                content: att.content,
+            })),
+        };
+    }
+    async parseMsg(buffer) {
+        // Dynamic import since msgreader uses default export
+        const MsgReaderModule = await import("@kenjiuno/msgreader");
+        const MsgReader = MsgReaderModule.default;
+        const arrayBuffer = new Uint8Array(buffer).buffer;
+        const reader = new MsgReader(arrayBuffer);
+        const msgData = reader.getFileData();
+        const toRecipients = (msgData.recipients || [])
+            .filter((r) => !r.recipType || r.recipType === "to" || r.recipType === 1)
+            .map((r) => {
+            const name = r.name || "";
+            const email = r.email || "";
+            return email ? (name ? `${name} <${email}>` : email) : name;
+        })
+            .join(", ");
+        const ccRecipients = (msgData.recipients || [])
+            .filter((r) => r.recipType === "cc" || r.recipType === 2)
+            .map((r) => {
+            const name = r.name || "";
+            const email = r.email || "";
+            return email ? (name ? `${name} <${email}>` : email) : name;
+        })
+            .join(", ");
+        const senderName = msgData.senderName || "";
+        const senderEmail = msgData.senderEmail || "";
+        const from = senderEmail ? (senderName ? `${senderName} <${senderEmail}>` : senderEmail) : senderName;
+        const attachments = [];
+        if (msgData.attachments) {
+            for (const attMeta of msgData.attachments) {
+                const att = reader.getAttachment(attMeta);
+                if (att) {
+                    attachments.push({
+                        filename: att.fileName || "unnamed",
+                        contentType: "application/octet-stream",
+                        content: Buffer.from(att.content),
+                    });
+                }
+            }
+        }
+        return {
+            subject: msgData.subject || "(No Subject)",
+            from,
+            to: toRecipients,
+            cc: ccRecipients || undefined,
+            date: msgData.clientSubmitTime || msgData.creationTime || "",
+            textBody: msgData.body || "",
+            attachments,
+        };
+    }
+    assembleMarkdown(params) {
+        const sections = [];
+        sections.push(`# Email: ${params.subject}`);
+        sections.push(`**From:** ${params.from}`);
+        sections.push(`**To:** ${params.to}`);
+        if (params.cc) {
+            sections.push(`**CC:** ${params.cc}`);
+        }
+        if (params.date) {
+            sections.push(`**Date:** ${params.date}`);
+        }
+        sections.push("---");
+        if (params.textBody) {
+            sections.push(params.textBody);
+        }
+        if (params.attachmentContents && params.attachmentContents.length > 0) {
+            sections.push("---");
+            for (const att of params.attachmentContents) {
+                sections.push(`## Attachment: ${att.filename}`);
+                sections.push(att.content);
+            }
+        }
+        return sections.join("\n\n");
+    }
+};
+exports.EmailParserService = EmailParserService;
+exports.EmailParserService = EmailParserService = EmailParserService_1 = __decorate([
+    (0, common_1.Injectable)()
+], EmailParserService);
+//# sourceMappingURL=email.service.js.map

package/dist/foundations/chunker/services/types/email.service.js.map

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

package/dist/foundations/foundations.modules.d.ts

@@ -1,4 +1,4 @@
-import { DynamicModule } from "@nestjs/common";
+import { DynamicModule, Type } from "@nestjs/common";
 import { ContentExtensionConfig } from "./content/interfaces/content.extension.interface";
 import { ReferralModuleConfig } from "./referral/interfaces/referral.config.interface";
 /**
@@ -9,6 +9,11 @@ export interface FoundationsModuleConfig {
     contentExtension?: ContentExtensionConfig;
     /** Optional configuration for the referral feature module */
     referral?: ReferralModuleConfig;
+    /**
+     * Foundation module classes to exclude from registration.
+     * Default [] keeps all modules registered (neural-erp behavior unchanged).
+     */
+    exclude?: Type<any>[];
 }
 /**
  * FoundationsModule - Centralized module for all foundation/domain modules

package/dist/foundations/foundations.modules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"foundations.modules.d.ts","sourceRoot":"","sources":["../../src/foundations/foundations.modules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,MAAM,gBAAgB,CAAC;AASvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kDAAkD,CAAC;AAE1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AA0BvF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CACjC;AAwCD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBACa,iBAAiB;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,aAAa;CAWhE"}
+{"version":3,"file":"foundations.modules.d.ts","sourceRoot":"","sources":["../../src/foundations/foundations.modules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAS7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,kDAAkD,CAAC;AAE1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AA0BvF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC;;;OAGG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;CACvB;AAwCD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBACa,iBAAiB;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,aAAa;CAShE"}

package/dist/foundations/foundations.modules.js

@@ -114,14 +114,12 @@ let FoundationsModule = FoundationsModule_1 = class FoundationsModule {
      * @returns DynamicModule with all foundation modules configured
      */
     static forRoot(config) {
+        const excluded = new Set(config?.exclude ?? []);
+        const modules = STATIC_FOUNDATION_MODULES.filter((m) => !excluded.has(m));
         return {
             module: FoundationsModule_1,
-            imports: [
-                ...STATIC_FOUNDATION_MODULES,
-                content_module_1.ContentModule.forRoot(config?.contentExtension),
-                referral_module_1.ReferralModule.forRoot(config?.referral),
-            ],
-            exports: [...STATIC_FOUNDATION_MODULES, content_module_1.ContentModule, referral_module_1.ReferralModule],
+            imports: [...modules, content_module_1.ContentModule.forRoot(config?.contentExtension), referral_module_1.ReferralModule.forRoot(config?.referral)],
+            exports: [...modules, content_module_1.ContentModule, referral_module_1.ReferralModule],
         };
     }
 };

package/dist/foundations/foundations.modules.js.map

@@ -1 +1 @@
-{"version":3,"file":"foundations.modules.js","sourceRoot":"","sources":["../../src/foundations/foundations.modules.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuD;AACvD,mEAA+D;AAC/D,sEAAkE;AAClE,uDAAmD;AACnD,oDAAgD;AAChD,uDAAmD;AACnD,6DAAyD;AACzD,6DAAyD;AACzD,6DAAyD;AAEzD,gEAA4D;AAE5D,4EAAuE;AACvE,6DAAyD;AACzD,0DAAqD;AACrD,sEAAkE;AAClE,0DAAsD;AACtD,4EAAwE;AACxE,uDAAmD;AACnD,oDAAgD;AAChD,mEAA+D;AAC/D,oDAAgD;AAChD,8CAA0C;AAC1C,kFAA6E;AAC7E,iDAAmD;AACnD,qDAAuD;AACvD,mEAAoE;AACpE,+DAAiE;AACjE,4EAAuE;AACvE,kFAA6E;AAC7E,0DAAsD;AACtD,4EAAuE;AACvE,sEAAkE;AAClE,sEAAiE;AACjE,oDAAgD;AAChD,gEAA4D;AAY5D;;;GAGG;AACH,MAAM,yBAAyB,GAAG;IAChC,kCAAe;IACf,oCAAgB;IAChB,0BAAW;IACX,wBAAU;IACV,0BAAW;IACX,8BAAa;IACb,8BAAa;IACb,uCAAiB;IACjB,8BAAa;IACb,2BAAW;IACX,oCAAgB;IAChB,4BAAY;IACZ,wCAAkB;IAClB,0BAAW;IACX,wBAAU;IACV,kCAAe;IACf,wBAAU;IACV,oBAAQ;IACR,oCAAgB;IAChB,mCAAe;IACf,wBAAU;IACV,gCAAc;IACd,4BAAY;IACZ,iDAAyB;IACzB,8CAAwB;IACxB,gCAAiB;IACjB,oCAAmB;IACnB,2CAAmB;IACnB,uCAAiB;IACjB,2CAAmB;IACnB,uCAAiB;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEI,IAAM,iBAAiB,yBAAvB,MAAM,iBAAiB;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,MAAgC;QAC7C,OAAO;YACL,MAAM,EAAE,mBAAiB;YACzB,OAAO,EAAE;gBACP,GAAG,yBAAyB;gBAC5B,8BAAa,CAAC,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC;gBAC/C,gCAAc,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC;aACzC;YACD,OAAO,EAAE,CAAC,GAAG,yBAAyB,EAAE,8BAAa,EAAE,gCAAc,CAAC;SACvE,CAAC;IACJ,CAAC;CACF,CAAA;AAlBY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,iBAAiB,CAkB7B"}
+{"version":3,"file":"foundations.modules.js","sourceRoot":"","sources":["../../src/foundations/foundations.modules.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAA6D;AAC7D,mEAA+D;AAC/D,sEAAkE;AAClE,uDAAmD;AACnD,oDAAgD;AAChD,uDAAmD;AACnD,6DAAyD;AACzD,6DAAyD;AACzD,6DAAyD;AAEzD,gEAA4D;AAE5D,4EAAuE;AACvE,6DAAyD;AACzD,0DAAqD;AACrD,sEAAkE;AAClE,0DAAsD;AACtD,4EAAwE;AACxE,uDAAmD;AACnD,oDAAgD;AAChD,mEAA+D;AAC/D,oDAAgD;AAChD,8CAA0C;AAC1C,kFAA6E;AAC7E,iDAAmD;AACnD,qDAAuD;AACvD,mEAAoE;AACpE,+DAAiE;AACjE,4EAAuE;AACvE,kFAA6E;AAC7E,0DAAsD;AACtD,4EAAuE;AACvE,sEAAkE;AAClE,sEAAiE;AACjE,oDAAgD;AAChD,gEAA4D;AAiB5D;;;GAGG;AACH,MAAM,yBAAyB,GAAG;IAChC,kCAAe;IACf,oCAAgB;IAChB,0BAAW;IACX,wBAAU;IACV,0BAAW;IACX,8BAAa;IACb,8BAAa;IACb,uCAAiB;IACjB,8BAAa;IACb,2BAAW;IACX,oCAAgB;IAChB,4BAAY;IACZ,wCAAkB;IAClB,0BAAW;IACX,wBAAU;IACV,kCAAe;IACf,wBAAU;IACV,oBAAQ;IACR,oCAAgB;IAChB,mCAAe;IACf,wBAAU;IACV,gCAAc;IACd,4BAAY;IACZ,iDAAyB;IACzB,8CAAwB;IACxB,gCAAiB;IACjB,oCAAmB;IACnB,2CAAmB;IACnB,uCAAiB;IACjB,2CAAmB;IACnB,uCAAiB;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEI,IAAM,iBAAiB,yBAAvB,MAAM,iBAAiB;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,MAAgC;QAC7C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAY,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,OAAO;YACL,MAAM,EAAE,mBAAiB;YACzB,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,8BAAa,CAAC,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,gCAAc,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAChH,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,8BAAa,EAAE,gCAAc,CAAC;SACrD,CAAC;IACJ,CAAC;CACF,CAAA;AAhBY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,iBAAiB,CAgB7B"}

package/dist/foundations/s3/services/s3.service.d.ts

@@ -1,3 +1,4 @@
+import { Readable } from "stream";
 import { ConfigService } from "@nestjs/config";
 import { ClsService } from "nestjs-cls";
 import { BaseConfigInterface } from "../../../config/interfaces";
@@ -78,5 +79,87 @@ export declare class S3Service {
         key: string;
     }): Promise<string>;
     private _getAzureObjectContent;
+    /**
+     * Single-page list for streaming consumers. Unlike listObjects (which accumulates every page
+     * into one array), this returns one page plus the continuation token so the caller can resume
+     * on demand. StartAfter lets a caller resume after a known key; it is ignored when
+     * ContinuationToken is set.
+     */
+    listObjectsPage(params: {
+        prefix: string;
+        startAfter?: string;
+        continuationToken?: string;
+        maxKeys?: number;
+    }): Promise<{
+        objects: {
+            key: string;
+            size: number;
+        }[];
+        nextContinuationToken?: string;
+    }>;
+    /**
+     * Download a file from S3/Azure and return both its buffer and the response Content-Type.
+     * Used by workers that hash + re-upload while preserving the original content type.
+     */
+    downloadFileBuffer(params: {
+        key: string;
+    }): Promise<{
+        buffer: Buffer;
+        contentType?: string;
+    }>;
+    /**
+     * Upload a readable stream with an exact key using multipart upload.
+     * Unlike uploadBufferWithKey, this streams data without holding the full content in memory.
+     */
+    uploadStream(params: {
+        key: string;
+        contentType: string;
+        stream: Readable;
+    }): Promise<void>;
+    /**
+     * Copy a file from one location to another within the same bucket/container.
+     * Supports both S3-compatible storage and Azure Blob Storage.
+     */
+    copyFile(params: {
+        sourceKey: string;
+        destinationKey: string;
+    }): Promise<void>;
+    /**
+     * List all objects under a given prefix.
+     * Handles pagination for S3-compatible storage and Azure.
+     */
+    listObjects(params: {
+        prefix: string;
+    }): Promise<{
+        key: string;
+        size: number;
+    }[]>;
+    private _listAzureObjects;
+    /**
+     * Download a file from S3/Azure and return its content as a string.
+     * Useful for reading JSON or HTML content stored in object storage.
+     */
+    downloadFileAsString(params: {
+        key: string;
+    }): Promise<string | null>;
+    private _downloadAzureFileAsString;
+    /**
+     * Download a file from S3/Azure and return its content as a Buffer.
+     * Useful for reading binary files like attachments.
+     */
+    downloadFileAsBuffer(params: {
+        key: string;
+    }): Promise<Buffer | null>;
+    private _downloadAzureFileAsBuffer;
+    /**
+     * Upload a buffer with an exact key — NO extension appending.
+     * Unlike uploadFile (which adds .pdf, .zip, etc.), this method
+     * preserves the key exactly as provided.
+     */
+    uploadBufferWithKey(params: {
+        buffer: Buffer;
+        key: string;
+        contentType: string;
+    }): Promise<void>;
 }
 //# sourceMappingURL=s3.service.d.ts.map

package/dist/foundations/s3/services/s3.service.d.ts.map

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

package/dist/foundations/s3/services/s3.service.js

@@ -11,6 +11,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.S3Service = void 0;
 const client_s3_1 = require("@aws-sdk/client-s3");
+const lib_storage_1 = require("@aws-sdk/lib-storage");
 const s3_request_presigner_1 = require("@aws-sdk/s3-request-presigner");
 const storage_blob_1 = require("@azure/storage-blob");
 const common_1 = require("@nestjs/common");
@@ -520,6 +521,272 @@ let S3Service = class S3Service {
             throw error;
         }
     }
+    /**
+     * Single-page list for streaming consumers. Unlike listObjects (which accumulates every page
+     * into one array), this returns one page plus the continuation token so the caller can resume
+     * on demand. StartAfter lets a caller resume after a known key; it is ignored when
+     * ContinuationToken is set.
+     */
+    async listObjectsPage(params) {
+        await this._loadConfiguration();
+        if (!this._endpoint)
+            return { objects: [] };
+        if (this._storageType === "azure") {
+            throw new Error("listObjectsPage is not supported for azure storage");
+        }
+        const listResponse = await this.s3Client.send(new client_s3_1.ListObjectsV2Command({
+            Bucket: this._bucket,
+            Prefix: params.prefix,
+            StartAfter: params.continuationToken ? undefined : params.startAfter,
+            ContinuationToken: params.continuationToken,
+            MaxKeys: params.maxKeys,
+        }));
+        const objects = [];
+        for (const obj of listResponse.Contents ?? []) {
+            if (obj.Key && obj.Size !== undefined)
+                objects.push({ key: obj.Key, size: obj.Size });
+        }
+        return { objects, nextContinuationToken: listResponse.NextContinuationToken };
+    }
+    /**
+     * Download a file from S3/Azure and return both its buffer and the response Content-Type.
+     * Used by workers that hash + re-upload while preserving the original content type.
+     */
+    async downloadFileBuffer(params) {
+        await this._loadConfiguration();
+        if (!this._endpoint) {
+            throw new Error("S3 not configured");
+        }
+        if (this._storageType === "azure") {
+            const blobClient = this.containerClient.getBlobClient(params.key);
+            const downloadResponse = await blobClient.download();
+            if (!downloadResponse.readableStreamBody) {
+                throw new Error(`Azure blob not found: ${params.key}`);
+            }
+            const chunks = [];
+            for await (const chunk of downloadResponse.readableStreamBody) {
+                chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+            }
+            return {
+                buffer: Buffer.concat(chunks),
+                contentType: downloadResponse.contentType ?? undefined,
+            };
+        }
+        const command = new client_s3_1.GetObjectCommand({
+            Bucket: this._bucket,
+            Key: params.key,
+        });
+        const response = await this.s3Client.send(command);
+        if (!response.Body) {
+            throw new Error(`S3 object not found: ${params.key}`);
+        }
+        const chunks = [];
+        for await (const chunk of response.Body) {
+            chunks.push(Buffer.from(chunk));
+        }
+        return {
+            buffer: Buffer.concat(chunks),
+            contentType: response.ContentType,
+        };
+    }
+    /**
+     * Upload a readable stream with an exact key using multipart upload.
+     * Unlike uploadBufferWithKey, this streams data without holding the full content in memory.
+     */
+    async uploadStream(params) {
+        await this._loadConfiguration();
+        if (!this._endpoint)
+            return;
+        if (this._storageType === "azure") {
+            const blobClient = this.containerClient.getBlockBlobClient(params.key);
+            await blobClient.uploadStream(params.stream, 8 * 1024 * 1024, 4, {
+                blobHTTPHeaders: { blobContentType: params.contentType },
+            });
+            return;
+        }
+        // S3-compatible storage — multipart upload via @aws-sdk/lib-storage
+        const upload = new lib_storage_1.Upload({
+            client: this.s3Client,
+            params: {
+                Bucket: this._bucket,
+                Key: params.key,
+                Body: params.stream,
+                ContentType: params.contentType,
+            },
+            partSize: 10 * 1024 * 1024,
+            queueSize: 4,
+        });
+        await upload.done();
+    }
+    /**
+     * Copy a file from one location to another within the same bucket/container.
+     * Supports both S3-compatible storage and Azure Blob Storage.
+     */
+    async copyFile(params) {
+        await this._loadConfiguration();
+        if (!this._endpoint)
+            return;
+        if (this._storageType === "azure") {
+            const sourceBlobClient = this.containerClient.getBlobClient(params.sourceKey);
+            const destBlobClient = this.containerClient.getBlobClient(params.destinationKey);
+            const copyPoller = await destBlobClient.beginCopyFromURL(sourceBlobClient.url);
+            await copyPoller.pollUntilDone();
+            return;
+        }
+        // S3-compatible storage (AWS, DigitalOcean, Hetzner, MinIO)
+        const command = new client_s3_1.CopyObjectCommand({
+            Bucket: this._bucket,
+            CopySource: `${this._bucket}/${params.sourceKey}`,
+            Key: params.destinationKey,
+        });
+        await this.s3Client.send(command);
+    }
+    /**
+     * List all objects under a given prefix.
+     * Handles pagination for S3-compatible storage and Azure.
+     */
+    async listObjects(params) {
+        await this._loadConfiguration();
+        if (!this._endpoint)
+            return [];
+        if (this._storageType === "azure")
+            return await this._listAzureObjects(params);
+        const results = [];
+        let continuationToken;
+        do {
+            const listResponse = await this.s3Client.send(new client_s3_1.ListObjectsV2Command({
+                Bucket: this._bucket,
+                Prefix: params.prefix,
+                ContinuationToken: continuationToken,
+            }));
+            if (listResponse.Contents) {
+                for (const obj of listResponse.Contents) {
+                    if (obj.Key && obj.Size !== undefined) {
+                        results.push({ key: obj.Key, size: obj.Size });
+                    }
+                }
+            }
+            continuationToken = listResponse.NextContinuationToken;
+        } while (continuationToken);
+        return results;
+    }
+    async _listAzureObjects(params) {
+        const results = [];
+        const blobs = this.containerClient.listBlobsFlat({ prefix: params.prefix });
+        for await (const blob of blobs) {
+            results.push({
+                key: blob.name,
+                size: blob.properties.contentLength ?? 0,
+            });
+        }
+        return results;
+    }
+    /**
+     * Download a file from S3/Azure and return its content as a string.
+     * Useful for reading JSON or HTML content stored in object storage.
+     */
+    async downloadFileAsString(params) {
+        await this._loadConfiguration();
+        if (!this._endpoint)
+            return null;
+        if (this._storageType === "azure") {
+            return await this._downloadAzureFileAsString(params);
+        }
+        try {
+            const response = await this.s3Client.send(new client_s3_1.GetObjectCommand({ Bucket: this._bucket, Key: params.key }));
+            if (response.Body) {
+                return await response.Body.transformToString();
+            }
+            return null;
+        }
+        catch (error) {
+            console.error(`Failed to download file ${params.key}:`, error);
+            return null;
+        }
+    }
+    async _downloadAzureFileAsString(params) {
+        try {
+            const blobClient = this.containerClient.getBlobClient(params.key);
+            const downloadResponse = await blobClient.download();
+            if (downloadResponse.readableStreamBody) {
+                const chunks = [];
+                for await (const chunk of downloadResponse.readableStreamBody) {
+                    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+                }
+                return Buffer.concat(chunks).toString("utf-8");
+            }
+            return null;
+        }
+        catch (error) {
+            console.error(`Failed to download Azure file ${params.key}:`, error);
+            return null;
+        }
+    }
+    /**
+     * Download a file from S3/Azure and return its content as a Buffer.
+     * Useful for reading binary files like attachments.
+     */
+    async downloadFileAsBuffer(params) {
+        await this._loadConfiguration();
+        if (!this._endpoint)
+            return null;
+        if (this._storageType === "azure") {
+            return await this._downloadAzureFileAsBuffer(params);
+        }
+        try {
+            const response = await this.s3Client.send(new client_s3_1.GetObjectCommand({ Bucket: this._bucket, Key: params.key }));
+            if (response.Body) {
+                const byteArray = await response.Body.transformToByteArray();
+                return Buffer.from(byteArray);
+            }
+            return null;
+        }
+        catch (error) {
+            console.error(`Failed to download file as buffer ${params.key}:`, error);
+            return null;
+        }
+    }
+    async _downloadAzureFileAsBuffer(params) {
+        try {
+            const blobClient = this.containerClient.getBlobClient(params.key);
+            const downloadResponse = await blobClient.download();
+            if (downloadResponse.readableStreamBody) {
+                const chunks = [];
+                for await (const chunk of downloadResponse.readableStreamBody) {
+                    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+                }
+                return Buffer.concat(chunks);
+            }
+            return null;
+        }
+        catch (error) {
+            console.error(`Failed to download Azure file as buffer ${params.key}:`, error);
+            return null;
+        }
+    }
+    /**
+     * Upload a buffer with an exact key — NO extension appending.
+     * Unlike uploadFile (which adds .pdf, .zip, etc.), this method
+     * preserves the key exactly as provided.
+     */
+    async uploadBufferWithKey(params) {
+        await this._loadConfiguration();
+        if (!this._endpoint)
+            return;
+        if (this._storageType === "azure") {
+            const blobClient = this.containerClient.getBlockBlobClient(params.key);
+            await blobClient.upload(params.buffer, params.buffer.length, {
+                blobHTTPHeaders: { blobContentType: params.contentType },
+            });
+            return;
+        }
+        await this.s3Client.send(new client_s3_1.PutObjectCommand({
+            Bucket: this._bucket,
+            Key: params.key,
+            Body: params.buffer,
+            ContentType: params.contentType,
+        }));
+    }
 };
 exports.S3Service = S3Service;
 exports.S3Service = S3Service = __decorate([