ecom-documents 1.0.0

package/dist/index.mjs

@@ -0,0 +1,1117 @@
+import axios from 'axios';
+import { Transform, Type, plainToInstance } from 'class-transformer';
+import { IsString, IsNotEmpty, IsNumber, IsArray, ValidateNested, IsDefined, IsOptional, IsDateString, IsUrl, IsEnum, validate } from 'class-validator';
+
+var __defProp = Object.defineProperty;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = void 0 ;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (decorator(target, key, result) ) || result;
+  if (result) __defProp(target, key, result);
+  return result;
+};
+
+// src/enums/document-type.enum.ts
+var DocumentType = {
+  STATEMENTS: "STATEMENTS",
+  PAYOUTS: "PAYOUTS",
+  SETTLEMENTS: "SETTLEMENTS",
+  TRANSACTIONS: "TRANSACTIONS",
+  TRANSACTIONS_INTERNAL: "TRANSACTIONS_INTERNAL",
+  REFUNDS: "REFUNDS",
+  REFUNDS_INTERNAL_GATEWAY: "REFUNDS_INTERNAL_GATEWAY",
+  PROFIT_FEES: "PROFIT_FEES",
+  PAYMENT_METHODS: "PAYMENT_METHODS",
+  VENDOR_LIST: "VENDOR_LIST",
+  VENDOR_SALES: "VENDOR_SALES",
+  EXCEPTIONS: "EXCEPTIONS",
+  REFUNDS_POS: "REFUNDS_POS",
+  REFUNDS_INTERNAL_POS: "REFUNDS_INTERNAL_POS"
+  // MERCHANT_USERS: 'MERCHANT_USERS',
+  // INTERNAL_USERS: 'INTERNAL_USERS',
+  // BULK_INVOICE_CUSTOMERS: 'BULK_INVOICE_CUSTOMERS',
+  // USERS_AND_AGENTS: 'USERS_AND_AGENTS',
+  // CUSTOMERS: 'CUSTOMERS',
+  // TERMINAL: 'TERMINAL',
+  // INVOICES: 'INVOICES',
+  // INVOICE_HISTORY: 'INVOICE_HISTORY',
+  // USERS: 'USERS',
+  // UNPAID_INVOICES: 'UNPAID_INVOICES',
+  // TERMINALS: 'TERMINALS',
+  // POS_TRANSACTIONS: 'POS_TRANSACTIONS',
+  // POS_MERCHANT_TRANSACTIONS: 'POS_MERCHANT_TRANSACTIONS',
+  // POS_TRANSACTIONS_INVALID: 'POS_TRANSACTIONS_INVALID',
+  // BULK_INVOICES_INVALID: 'BULK_INVOICES_INVALID',
+  // BLACKLIST_INVALID: 'BLACKLIST_INVALID',
+  // BLACKLIST: 'BLACKLIST',
+  // PARTNERS: 'PARTNERS',
+};
+
+// src/enums/fileFormat.enum.ts
+var FileFormat = {
+  PDF: "pdf",
+  CSV: "csv",
+  XLSX: "xlsx"
+};
+var ExceptionDocument = class {
+  createdAt;
+  merchantName;
+  merchantRisk;
+  cardNumber;
+  cardIssuer;
+  cardHolderName;
+  payerIpAddress;
+  product;
+  paymentMethod;
+  amount;
+  action;
+};
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], ExceptionDocument.prototype, "createdAt");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], ExceptionDocument.prototype, "merchantName");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], ExceptionDocument.prototype, "merchantRisk");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], ExceptionDocument.prototype, "cardNumber");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], ExceptionDocument.prototype, "cardIssuer");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], ExceptionDocument.prototype, "cardHolderName");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], ExceptionDocument.prototype, "payerIpAddress");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], ExceptionDocument.prototype, "product");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], ExceptionDocument.prototype, "paymentMethod");
+__decorateClass([
+  Transform(({ value }) => Number(value).toFixed(3)),
+  IsNumber(),
+  IsNotEmpty()
+], ExceptionDocument.prototype, "amount");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], ExceptionDocument.prototype, "action");
+var ExceptionExportDto = class {
+  data;
+};
+__decorateClass([
+  IsArray(),
+  ValidateNested({ each: true }),
+  Type(() => ExceptionDocument),
+  IsNotEmpty(),
+  IsDefined()
+], ExceptionExportDto.prototype, "data");
+var PaymentMethodDocument = class {
+  paymentMethod;
+  totalAmount;
+  percentageOfTotal;
+  txnCount;
+};
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], PaymentMethodDocument.prototype, "paymentMethod");
+__decorateClass([
+  Transform(({ value }) => Number(value).toFixed(3)),
+  IsNumber(),
+  IsNotEmpty()
+], PaymentMethodDocument.prototype, "totalAmount");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], PaymentMethodDocument.prototype, "percentageOfTotal");
+__decorateClass([
+  IsNumber(),
+  IsNotEmpty()
+], PaymentMethodDocument.prototype, "txnCount");
+var PaymentMethodsExportDto = class {
+  data;
+};
+__decorateClass([
+  IsArray(),
+  ValidateNested({ each: true }),
+  Type(() => PaymentMethodDocument),
+  IsNotEmpty(),
+  IsDefined()
+], PaymentMethodsExportDto.prototype, "data");
+var PayoutDocument = class {
+  id;
+  mid;
+  iban;
+  amount;
+  currency;
+  numOfTxn;
+  notes;
+  createdAt;
+};
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], PayoutDocument.prototype, "id");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], PayoutDocument.prototype, "mid");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], PayoutDocument.prototype, "iban");
+__decorateClass([
+  Transform(({ value }) => Number(value).toFixed(3)),
+  IsNumber(),
+  IsNotEmpty()
+], PayoutDocument.prototype, "amount");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], PayoutDocument.prototype, "currency");
+__decorateClass([
+  IsNumber(),
+  IsNotEmpty()
+], PayoutDocument.prototype, "numOfTxn");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], PayoutDocument.prototype, "notes");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], PayoutDocument.prototype, "createdAt");
+var PayoutsExportDto = class {
+  data;
+};
+__decorateClass([
+  IsArray(),
+  ValidateNested({ each: true }),
+  Type(() => PayoutDocument),
+  IsNotEmpty(),
+  IsDefined()
+], PayoutsExportDto.prototype, "data");
+var ProfitFeesDocument = class {
+  mid;
+  merchantName;
+  numOfTxn;
+  totalTxnAmount;
+  totalProfitAmount;
+  type;
+};
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], ProfitFeesDocument.prototype, "mid");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], ProfitFeesDocument.prototype, "merchantName");
+__decorateClass([
+  IsNumber(),
+  IsNotEmpty()
+], ProfitFeesDocument.prototype, "numOfTxn");
+__decorateClass([
+  Transform(({ value }) => Number(value).toFixed(3)),
+  IsNumber(),
+  IsNotEmpty()
+], ProfitFeesDocument.prototype, "totalTxnAmount");
+__decorateClass([
+  Transform(({ value }) => Number(value).toFixed(3)),
+  IsNumber(),
+  IsNotEmpty()
+], ProfitFeesDocument.prototype, "totalProfitAmount");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], ProfitFeesDocument.prototype, "type");
+var ProfitFeesExportDto = class {
+  data;
+};
+__decorateClass([
+  IsArray(),
+  ValidateNested({ each: true }),
+  Type(() => ProfitFeesDocument),
+  IsNotEmpty(),
+  IsDefined()
+], ProfitFeesExportDto.prototype, "data");
+var RefundBaseDto = class {
+  createdAt;
+  refundedAt;
+  rejectedAt;
+  ecomReference;
+  merchantReference;
+  originalTxnId;
+  originalTxnDate;
+  originalTxnAmount;
+  amount;
+  paymentMethod;
+  status;
+  mid;
+  merchantName;
+};
+__decorateClass([
+  IsNotEmpty()
+], RefundBaseDto.prototype, "createdAt");
+__decorateClass([
+  IsOptional()
+], RefundBaseDto.prototype, "refundedAt");
+__decorateClass([
+  IsOptional()
+], RefundBaseDto.prototype, "rejectedAt");
+__decorateClass([
+  IsString(),
+  IsOptional()
+], RefundBaseDto.prototype, "ecomReference");
+__decorateClass([
+  IsString(),
+  IsOptional()
+], RefundBaseDto.prototype, "merchantReference");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], RefundBaseDto.prototype, "originalTxnId");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], RefundBaseDto.prototype, "originalTxnDate");
+__decorateClass([
+  Transform(({ value }) => Number(value).toFixed(3)),
+  IsNumber(),
+  IsNotEmpty()
+], RefundBaseDto.prototype, "originalTxnAmount");
+__decorateClass([
+  Transform(({ value }) => Number(value).toFixed(3)),
+  IsNumber(),
+  IsNotEmpty()
+], RefundBaseDto.prototype, "amount");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], RefundBaseDto.prototype, "paymentMethod");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], RefundBaseDto.prototype, "status");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], RefundBaseDto.prototype, "mid");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], RefundBaseDto.prototype, "merchantName");
+var RefundDocument = class extends RefundBaseDto {
+  customerName;
+  customerPhone;
+  invoiceNumber;
+  product;
+  type;
+  requestedBy;
+};
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], RefundDocument.prototype, "customerName");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], RefundDocument.prototype, "customerPhone");
+__decorateClass([
+  IsString(),
+  IsOptional()
+], RefundDocument.prototype, "invoiceNumber");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], RefundDocument.prototype, "product");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], RefundDocument.prototype, "type");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], RefundDocument.prototype, "requestedBy");
+var RefundPOSDocument = class extends RefundBaseDto {
+  authId;
+  terminalId;
+  terminalName;
+  cardNumber;
+};
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], RefundPOSDocument.prototype, "authId");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], RefundPOSDocument.prototype, "terminalId");
+__decorateClass([
+  IsString(),
+  IsOptional()
+], RefundPOSDocument.prototype, "terminalName");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], RefundPOSDocument.prototype, "cardNumber");
+var RefundsExportDto = class {
+  data;
+};
+__decorateClass([
+  IsArray(),
+  ValidateNested({ each: true }),
+  Type(() => RefundDocument),
+  IsNotEmpty(),
+  IsDefined()
+], RefundsExportDto.prototype, "data");
+var RefundsPOSExportDto = class {
+  data;
+};
+__decorateClass([
+  IsArray(),
+  ValidateNested({ each: true }),
+  Type(() => RefundPOSDocument),
+  IsNotEmpty(),
+  IsDefined()
+], RefundsPOSExportDto.prototype, "data");
+var SettlementDocument = class {
+  mid;
+  merchantName;
+  bank;
+  holderName;
+  iban;
+  accountNumber;
+  totalAmount;
+  totalTxnCount;
+  settlementDate;
+};
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], SettlementDocument.prototype, "mid");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], SettlementDocument.prototype, "merchantName");
+__decorateClass([
+  IsOptional()
+], SettlementDocument.prototype, "bank");
+__decorateClass([
+  IsString(),
+  IsOptional()
+], SettlementDocument.prototype, "holderName");
+__decorateClass([
+  IsString(),
+  IsOptional()
+], SettlementDocument.prototype, "iban");
+__decorateClass([
+  IsString(),
+  IsOptional()
+], SettlementDocument.prototype, "accountNumber");
+__decorateClass([
+  Transform(({ value }) => Number(value).toFixed(3)),
+  IsNumber(),
+  IsNotEmpty()
+], SettlementDocument.prototype, "totalAmount");
+__decorateClass([
+  IsNumber(),
+  IsNotEmpty()
+], SettlementDocument.prototype, "totalTxnCount");
+__decorateClass([
+  IsOptional()
+], SettlementDocument.prototype, "settlementDate");
+var SettlementsExportDto = class {
+  data;
+};
+__decorateClass([
+  IsArray(),
+  ValidateNested({ each: true }),
+  Type(() => SettlementDocument),
+  IsNotEmpty(),
+  IsDefined()
+], SettlementsExportDto.prototype, "data");
+var StatementDocument = class {
+  createdAt;
+  transactionId;
+  merchantReference;
+  invoiceId;
+  description;
+  paymentMethod;
+  amount;
+  type;
+  balanceAfter;
+};
+__decorateClass([
+  IsNotEmpty()
+], StatementDocument.prototype, "createdAt");
+__decorateClass([
+  IsString(),
+  IsOptional()
+], StatementDocument.prototype, "transactionId");
+__decorateClass([
+  IsString(),
+  IsOptional()
+], StatementDocument.prototype, "merchantReference");
+__decorateClass([
+  IsString(),
+  IsOptional()
+], StatementDocument.prototype, "invoiceId");
+__decorateClass([
+  IsString(),
+  IsOptional()
+], StatementDocument.prototype, "description");
+__decorateClass([
+  IsNotEmpty()
+], StatementDocument.prototype, "paymentMethod");
+__decorateClass([
+  Transform(({ value }) => Number(value).toFixed(3)),
+  IsNumber(),
+  IsNotEmpty()
+], StatementDocument.prototype, "amount");
+__decorateClass([
+  IsNotEmpty()
+], StatementDocument.prototype, "type");
+__decorateClass([
+  Transform(({ value }) => Number(value).toFixed(3)),
+  IsNumber(),
+  IsNotEmpty()
+], StatementDocument.prototype, "balanceAfter");
+var StatementsExportDto = class {
+  data;
+};
+__decorateClass([
+  IsArray(),
+  ValidateNested({ each: true }),
+  Type(() => StatementDocument),
+  IsNotEmpty(),
+  IsDefined()
+], StatementsExportDto.prototype, "data");
+var TransactionDocument = class {
+  createdAt;
+  id;
+  ecomReference;
+  merchantReference;
+  merchantName;
+  invoiceNumber;
+  customerName;
+  customerPhone;
+  amount;
+  product;
+  paymentMethod;
+  status;
+  authCode;
+  terminalId;
+  terminalName;
+  cardNumber;
+};
+__decorateClass([
+  IsNotEmpty()
+], TransactionDocument.prototype, "createdAt");
+__decorateClass([
+  IsNotEmpty()
+], TransactionDocument.prototype, "id");
+__decorateClass([
+  IsNotEmpty(),
+  IsString()
+], TransactionDocument.prototype, "ecomReference");
+__decorateClass([
+  IsString(),
+  IsOptional()
+], TransactionDocument.prototype, "merchantReference");
+__decorateClass([
+  IsString(),
+  IsOptional()
+], TransactionDocument.prototype, "merchantName");
+__decorateClass([
+  IsString(),
+  IsOptional()
+], TransactionDocument.prototype, "invoiceNumber");
+__decorateClass([
+  IsNotEmpty(),
+  IsString()
+], TransactionDocument.prototype, "customerName");
+__decorateClass([
+  IsNotEmpty(),
+  IsString()
+], TransactionDocument.prototype, "customerPhone");
+__decorateClass([
+  Transform(({ value }) => Number(value).toFixed(3)),
+  IsNotEmpty(),
+  IsNumber()
+], TransactionDocument.prototype, "amount");
+__decorateClass([
+  IsNotEmpty()
+], TransactionDocument.prototype, "product");
+__decorateClass([
+  IsNotEmpty(),
+  IsString()
+], TransactionDocument.prototype, "paymentMethod");
+__decorateClass([
+  IsNotEmpty(),
+  IsString()
+], TransactionDocument.prototype, "status");
+__decorateClass([
+  IsString(),
+  IsOptional()
+], TransactionDocument.prototype, "authCode");
+__decorateClass([
+  IsString(),
+  IsOptional()
+], TransactionDocument.prototype, "terminalId");
+__decorateClass([
+  IsString(),
+  IsOptional()
+], TransactionDocument.prototype, "terminalName");
+__decorateClass([
+  IsString(),
+  IsOptional()
+], TransactionDocument.prototype, "cardNumber");
+var TransactionsExportDto = class {
+  data;
+};
+__decorateClass([
+  IsArray(),
+  IsNotEmpty(),
+  IsDefined()
+], TransactionsExportDto.prototype, "data");
+var VendorSalesDocument = class {
+  mid;
+  vendorNumber;
+  vendorName;
+  totalTxnAmount;
+};
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], VendorSalesDocument.prototype, "mid");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], VendorSalesDocument.prototype, "vendorNumber");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], VendorSalesDocument.prototype, "vendorName");
+__decorateClass([
+  Transform(({ value }) => Number(value).toFixed(3)),
+  IsNumber(),
+  IsNotEmpty()
+], VendorSalesDocument.prototype, "totalTxnAmount");
+var VendorListDocument = class {
+  mid;
+  vendorNumber;
+  vendorName;
+  email;
+  bank;
+  iban;
+  commission;
+};
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], VendorListDocument.prototype, "mid");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], VendorListDocument.prototype, "vendorNumber");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], VendorListDocument.prototype, "vendorName");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], VendorListDocument.prototype, "email");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], VendorListDocument.prototype, "bank");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], VendorListDocument.prototype, "iban");
+__decorateClass([
+  IsNotEmpty()
+], VendorListDocument.prototype, "commission");
+var VendorSalesExportDto = class {
+  data;
+};
+__decorateClass([
+  IsArray(),
+  ValidateNested({ each: true }),
+  Type(() => VendorSalesDocument),
+  IsNotEmpty(),
+  IsDefined()
+], VendorSalesExportDto.prototype, "data");
+var VendorListExportDto = class {
+  data;
+};
+__decorateClass([
+  IsArray(),
+  ValidateNested({ each: true }),
+  Type(() => VendorListDocument),
+  IsNotEmpty(),
+  IsDefined()
+], VendorListExportDto.prototype, "data");
+
+// src/dtos/dto-map.ts
+var DocumentPayloadMap = {
+  // transactions microservice dtos
+  [DocumentType.STATEMENTS]: StatementsExportDto,
+  [DocumentType.PAYOUTS]: PayoutsExportDto,
+  [DocumentType.SETTLEMENTS]: SettlementsExportDto,
+  [DocumentType.TRANSACTIONS]: TransactionsExportDto,
+  [DocumentType.TRANSACTIONS_INTERNAL]: TransactionsExportDto,
+  [DocumentType.REFUNDS]: RefundsExportDto,
+  [DocumentType.REFUNDS_INTERNAL_GATEWAY]: RefundsExportDto,
+  [DocumentType.PROFIT_FEES]: ProfitFeesExportDto,
+  [DocumentType.PAYMENT_METHODS]: PaymentMethodsExportDto,
+  [DocumentType.VENDOR_LIST]: VendorListExportDto,
+  [DocumentType.VENDOR_SALES]: VendorSalesExportDto,
+  [DocumentType.EXCEPTIONS]: ExceptionExportDto,
+  // pos microservice dtos
+  [DocumentType.REFUNDS_POS]: RefundsPOSExportDto,
+  [DocumentType.REFUNDS_INTERNAL_POS]: RefundsPOSExportDto
+  // elinks microservice dtos
+};
+
+// src/validators/document-validator.ts
+var DocumentValidator = class {
+  /**
+   * Validate a document payload based on its type
+   * @param type - Document type
+   * @param payload - Raw payload data
+   * @returns Validation result with typed payload or errors
+   */
+  static async validatePayload(type, payload) {
+    const DtoClass = DocumentPayloadMap[type];
+    if (!DtoClass) {
+      return {
+        isValid: false,
+        errorMessage: `Unknown document type: ${type}`,
+        errors: [
+          {
+            property: "type",
+            constraints: { invalid: `Unknown document type: ${type}` }
+          }
+        ]
+      };
+    }
+    const instance = plainToInstance(DtoClass, payload);
+    const errors = await validate(instance, {
+      whitelist: true,
+      validationError: {
+        target: false,
+        value: true
+      }
+    });
+    if (errors.length > 0) {
+      return {
+        isValid: false,
+        errors,
+        errorMessage: "Payload validation failed"
+      };
+    }
+    return {
+      isValid: true,
+      validatedPayload: instance
+    };
+  }
+  /**
+   * Format validation errors into human-readable messages
+   * @param errors - Array of validation errors
+   * @returns Formatted error messages
+   */
+  static formatErrors(errors) {
+    const messages = [];
+    const formatError = (error, path = "") => {
+      const currentPath = path ? `${path}.${error.property}` : error.property;
+      if (error.constraints) {
+        Object.values(error.constraints).forEach((message) => {
+          messages.push(`${currentPath}: ${message}`);
+        });
+      }
+      if (error.children && error.children.length > 0) {
+        error.children.forEach((child) => formatError(child, currentPath));
+      }
+    };
+    errors.forEach((error) => formatError(error));
+    return messages;
+  }
+};
+
+// src/client/document-client.ts
+var DocumentExportClient = class {
+  client;
+  constructor(documentMsBaseUrl, documentMSCommunicationKey) {
+    this.client = axios.create({
+      baseURL: documentMsBaseUrl,
+      headers: {
+        "Content-Type": "application/json",
+        "x-communication-key": documentMSCommunicationKey || ""
+      }
+    });
+  }
+  /**
+   * Generate a document with type-safe payload
+   * @param type - Document type
+   * @param payload - Typed payload for the document
+   * @returns Document generation response
+   */
+  async generateDocument(documentFormat, documentType, dateRange, payload, merchantInfo, presignedURL = false) {
+    try {
+      const validation = await DocumentValidator.validatePayload(documentType, payload);
+      if (!validation.isValid) {
+        const messages = DocumentValidator.formatErrors(validation.errors || []);
+        throw new Error(`Document payload validation failed: ${messages.join("; ")}`);
+      }
+      const request = {
+        documentFormat,
+        documentType,
+        dateRange,
+        merchantInfo,
+        data: payload.data,
+        presignedURL
+      };
+      const response = await this.client.post("/v2/document-generation", request);
+      return response.data;
+    } catch (error) {
+      return Promise.reject(error);
+    }
+  }
+};
+
+// src/client/errors/document-error.ts
+var DocumentError = class extends Error {
+  constructor(message, code, statusCode, details) {
+    super(message);
+    this.code = code;
+    this.statusCode = statusCode;
+    this.details = details;
+    this.name = "DocumentError";
+    Error.captureStackTrace(this, this.constructor);
+  }
+};
+var DocumentGenerationError = class extends DocumentError {
+  constructor(message, details) {
+    super(message, "DOCUMENT_GENERATION_ERROR", 500, details);
+    this.name = "DocumentGenerationError";
+  }
+};
+var DocumentNetworkError = class extends DocumentError {
+  constructor(message, statusCode, details) {
+    super(message, "NETWORK_ERROR", statusCode, details);
+    this.name = "DocumentNetworkError";
+  }
+};
+
+// src/client/errors/validation-error.ts
+var DocumentValidationError = class extends DocumentError {
+  constructor(message, validationErrors) {
+    super(message, "VALIDATION_ERROR", 400, { validationErrors });
+    this.validationErrors = validationErrors;
+    this.name = "DocumentValidationError";
+  }
+  /**
+   * Get formatted validation error messages
+   */
+  getMessages() {
+    const messages = [];
+    const formatError = (error, path = "") => {
+      const currentPath = path ? `${path}.${error.property}` : error.property;
+      if (error.constraints) {
+        Object.values(error.constraints).forEach((msg) => {
+          messages.push(`${currentPath}: ${msg}`);
+        });
+      }
+      if (error.children && error.children.length > 0) {
+        error.children.forEach((child) => formatError(child, currentPath));
+      }
+    };
+    this.validationErrors.forEach((error) => formatError(error));
+    return messages;
+  }
+};
+var DateRangeExportDto = class {
+  from;
+  to;
+};
+__decorateClass([
+  IsDateString(),
+  IsNotEmpty()
+], DateRangeExportDto.prototype, "from");
+__decorateClass([
+  IsDateString(),
+  IsNotEmpty()
+], DateRangeExportDto.prototype, "to");
+
+// src/utils/chunked-fetcher.util.ts
+async function fetchDBQueryInChunks(config) {
+  const { queryFn, pageOptions, chunkSize = 200 } = config;
+  const firstPageOptions = {
+    ...pageOptions,
+    take: chunkSize,
+    skip: 0
+  };
+  const [firstRecords, totalRecords] = await queryFn(firstPageOptions);
+  if (firstRecords.length >= totalRecords || firstRecords.length < chunkSize) {
+    return firstRecords;
+  }
+  const allRecords = new Array(totalRecords);
+  for (let i = 0; i < firstRecords.length; i++) {
+    allRecords[i] = firstRecords[i];
+  }
+  let currentIndex = firstRecords.length;
+  let skip = chunkSize;
+  while (currentIndex < totalRecords) {
+    const chunkPageOptions = {
+      ...pageOptions,
+      take: chunkSize,
+      skip
+    };
+    const [records] = await queryFn(chunkPageOptions);
+    if (records.length === 0) {
+      break;
+    }
+    for (let i = 0; i < records.length; i++) {
+      allRecords[currentIndex++] = records[i];
+    }
+    if (records.length < chunkSize) {
+      break;
+    }
+    skip += chunkSize;
+  }
+  if (currentIndex < totalRecords) {
+    allRecords.length = currentIndex;
+  }
+  return allRecords;
+}
+
+// src/utils/mask-account-number.ts
+function maskAccountNumber(str) {
+  if (!str) return "";
+  const lastFourDigits = str.slice(-4);
+  const maskedPart = str.slice(0, -4).replace(/\d/g, "x");
+  return maskedPart + lastFourDigits || "";
+}
+
+// src/dtos/base/merchant-headers.ts
+var MerchantDetailsHeaderExportDto = class {
+  name;
+  profile;
+  accountNumber;
+  totalBalance;
+  availableBalance;
+  pendingBalance;
+  currency;
+};
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], MerchantDetailsHeaderExportDto.prototype, "name");
+__decorateClass([
+  IsUrl({ protocols: ["https"] }),
+  IsOptional()
+], MerchantDetailsHeaderExportDto.prototype, "profile");
+__decorateClass([
+  Transform(({ value }) => maskAccountNumber(value)),
+  IsString(),
+  IsNotEmpty()
+], MerchantDetailsHeaderExportDto.prototype, "accountNumber");
+__decorateClass([
+  Transform(({ value }) => Number(value).toFixed(3)),
+  IsNumber(),
+  IsNotEmpty()
+], MerchantDetailsHeaderExportDto.prototype, "totalBalance");
+__decorateClass([
+  Transform(({ value }) => Number(value).toFixed(3)),
+  IsNumber(),
+  IsNotEmpty()
+], MerchantDetailsHeaderExportDto.prototype, "availableBalance");
+__decorateClass([
+  Transform(({ value }) => Number(value).toFixed(3)),
+  IsNumber(),
+  IsNotEmpty()
+], MerchantDetailsHeaderExportDto.prototype, "pendingBalance");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], MerchantDetailsHeaderExportDto.prototype, "currency");
+
+// src/dtos/base/document-generation.request.dto.ts
+var DocumentGenerationRequestDto = class {
+  documentFormat;
+  documentType;
+  merchantInfo;
+  dateRange;
+  data;
+  presignedURL = false;
+};
+__decorateClass([
+  IsEnum(FileFormat, { message: "document format must be one of: pdf, csv, xlsx" }),
+  IsNotEmpty()
+], DocumentGenerationRequestDto.prototype, "documentFormat");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], DocumentGenerationRequestDto.prototype, "documentType");
+__decorateClass([
+  Type(() => MerchantDetailsHeaderExportDto),
+  ValidateNested(),
+  IsOptional()
+], DocumentGenerationRequestDto.prototype, "merchantInfo");
+__decorateClass([
+  Type(() => DateRangeExportDto),
+  ValidateNested(),
+  IsNotEmpty()
+], DocumentGenerationRequestDto.prototype, "dateRange");
+__decorateClass([
+  IsNotEmpty()
+], DocumentGenerationRequestDto.prototype, "data");
+__decorateClass([
+  IsNotEmpty()
+], DocumentGenerationRequestDto.prototype, "presignedURL");
+
+// src/dtos/base/document-path.response.dto.ts
+var DocumentPathResponseDto = class {
+  name;
+  path;
+  s3Result;
+  constructor(name, path, commandResult) {
+    this.name = name;
+    this.path = path;
+    this.s3Result = commandResult;
+  }
+};
+var InvoiceDocument = class {
+  createdAt;
+  paidAt;
+  customerName;
+  customerPhone;
+  id;
+  merchantReference;
+  createdBy;
+  transactionId = "";
+  status;
+  amount;
+  paymentMethod;
+};
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], InvoiceDocument.prototype, "createdAt");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], InvoiceDocument.prototype, "paidAt");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], InvoiceDocument.prototype, "customerName");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], InvoiceDocument.prototype, "customerPhone");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], InvoiceDocument.prototype, "id");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], InvoiceDocument.prototype, "merchantReference");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], InvoiceDocument.prototype, "createdBy");
+__decorateClass([
+  IsString(),
+  IsOptional()
+], InvoiceDocument.prototype, "transactionId");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], InvoiceDocument.prototype, "status");
+__decorateClass([
+  Transform(({ value }) => Number(value).toFixed(3)),
+  IsNumber(),
+  IsNotEmpty()
+], InvoiceDocument.prototype, "amount");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], InvoiceDocument.prototype, "paymentMethod");
+var InvoiceHistoryDocument = class {
+  createdAt;
+  action;
+  createdBy;
+  invoiceId;
+  paymentMethod;
+  paymentMethodBrand;
+};
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], InvoiceHistoryDocument.prototype, "createdAt");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], InvoiceHistoryDocument.prototype, "action");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], InvoiceHistoryDocument.prototype, "createdBy");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], InvoiceHistoryDocument.prototype, "invoiceId");
+__decorateClass([
+  IsString(),
+  IsNotEmpty()
+], InvoiceHistoryDocument.prototype, "paymentMethod");
+__decorateClass([
+  IsString(),
+  IsOptional()
+], InvoiceHistoryDocument.prototype, "paymentMethodBrand");
+var InvoiceExportDto = class {
+  data;
+};
+__decorateClass([
+  IsArray(),
+  ValidateNested({ each: true }),
+  Type(() => InvoiceDocument),
+  IsNotEmpty(),
+  IsDefined()
+], InvoiceExportDto.prototype, "data");
+var InvoiceHistoryExportDto = class {
+  data;
+};
+__decorateClass([
+  IsArray(),
+  ValidateNested({ each: true }),
+  Type(() => InvoiceHistoryDocument),
+  IsNotEmpty(),
+  IsDefined()
+], InvoiceHistoryExportDto.prototype, "data");
+
+export { DateRangeExportDto, DocumentError, DocumentExportClient, DocumentGenerationError, DocumentGenerationRequestDto, DocumentNetworkError, DocumentPathResponseDto, DocumentPayloadMap, DocumentType, DocumentValidationError, DocumentValidator, ExceptionExportDto, FileFormat, InvoiceExportDto, InvoiceHistoryExportDto, MerchantDetailsHeaderExportDto, PaymentMethodsExportDto, PayoutsExportDto, ProfitFeesExportDto, RefundsExportDto, RefundsPOSExportDto, SettlementsExportDto, StatementsExportDto, TransactionsExportDto, VendorListExportDto, VendorSalesExportDto, fetchDBQueryInChunks, maskAccountNumber };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map