Merge pull request #95 from ralcorta/chore/get_iva_receptor_types

[Chore] new use cases and doc config

Author: ralcorta

docs/.vitepress/config.mts

@@ -8,6 +8,9 @@ export default withMermaid(
     description: "Arca typescript SDK",
     lang: "es",
     appearance: "dark",
+    sitemap: {
+      hostname: "https://afipts.com",
+    },
     head: [["link", { rel: "icon", href: "/logo.ico" }]],
     themeConfig: {
       logo: "/logo.png",

jest.setup.js

@@ -1 +1,19 @@
-jest.setTimeout(30000)
+jest.setTimeout(30000);
+
+// Global error sanitization to prevent circular structure issues in Jest serialization
+const originalProcessEmit = process.emit;
+process.emit = function (event, error, ...args) {
+  if (event === "unhandledRejection" && error && typeof error === "object") {
+    // Sanitize the error to avoid circular structure issues
+    const sanitizedError = new Error(error?.message || "Unknown error");
+    sanitizedError.name = error?.name || "Error";
+    if (error?.code) {
+      sanitizedError.code = error.code;
+    }
+    if (error?.stack) {
+      sanitizedError.stack = error.stack;
+    }
+    return originalProcessEmit.call(this, event, sanitizedError, ...args);
+  }
+  return originalProcessEmit.apply(this, arguments);
+};

package.json

@@ -10,10 +10,11 @@
     "build": "nx run-many --target=build --all",
     "build:core": "nx build core",
     "test": "nx run-many --target=test --all --skip-nx-cache",
+    "test:integration": "nx run-many --target=test:integration --all --skip-nx-cache",
+    "lint": "nx run-many --target=lint --all",
     "test:core": "nx test core",
     "test:core:unit": "nx test:unit core",
     "test:core:integration": "nx test:integration core",
-    "lint": "nx run-many --target=lint --all",
     "lint:core": "nx lint core",
     "publish:core": "nx publish core",
     "version:core": "nx version core --versionType=${VERSION:-patch}",
@@ -56,4 +57,4 @@
     "soap",
     "wsaa"
   ]
-}
+}

packages/core/package.json

@@ -6,13 +6,14 @@
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "scripts": {
-    "build": "npx tsc",
+    "build": "npx tsc -p tsconfig.build.json",
     "test": "jest",
     "test:unit": "jest ./tests/unit",
     "test:integration": "jest ./tests/integration",
     "test:integration:watch": "jest ./tests/integration --watch",
     "test:integration:manual": "jest ./tests/integration/electronic-billing-manual-tokens.integration.test.ts",
-    "test:integration:auto": "jest ./tests/integration/electronic-billing.integration.test.ts"
+    "test:integration:auto": "jest ./tests/integration/electronic-billing.integration.test.ts",
+    "generate:wsdl-strings": "node scripts/generate-wsdl-strings.js"
   },
   "dependencies": {
     "dotenv": "^16.3.1",
@@ -70,4 +71,4 @@
     "endpoint",
     "wsaa"
   ]
-}
+}

packages/core/scripts/generate-wsdl-strings.js

@@ -0,0 +1,70 @@
+const fs = require("fs");
+const path = require("path");
+
+const wsdlDir = path.join(
+  __dirname,
+  "../src/infrastructure/outbound/adapters/soap/wsdl"
+);
+const outputFile = path.join(
+  __dirname,
+  "../src/infrastructure/outbound/adapters/soap/wsdl-strings.ts"
+);
+
+const header = `/**
+ * WSDL files embedded as strings
+ * This file is auto-generated to avoid file system access issues in bundled environments
+ * Generated from files in src/infrastructure/outbound/adapters/soap/wsdl/
+ * 
+ * DO NOT EDIT THIS FILE MANUALLY
+ * Run: npm run generate:wsdl-strings
+ */
+
+export const WSDL_STRINGS: Record<string, string> = {
+`;
+
+const footer = `};
+
+export function getWsdlString(wsdlName: string): string | undefined {
+  return WSDL_STRINGS[wsdlName];
+}
+`;
+
+function generate() {
+  console.log("Generating wsdl-strings.ts...");
+
+  if (!fs.existsSync(wsdlDir)) {
+    console.error(`WSDL directory not found: ${wsdlDir}`);
+    process.exit(1);
+  }
+
+  const files = fs
+    .readdirSync(wsdlDir)
+    .filter((file) => file.endsWith(".wsdl"));
+  let content = header;
+
+  files.forEach((file, index) => {
+    const filePath = path.join(wsdlDir, file);
+    const fileContent = fs.readFileSync(filePath, "utf8");
+
+    // Escape backticks in the content if any (though unlikely in XML)
+    const escapedContent = fileContent
+      .replace(/\\/g, "\\\\")
+      .replace(/`/g, "\\`")
+      .replace(/\${/g, "\\${");
+
+    content += `  '${file}': \`${escapedContent}\``;
+
+    if (index < files.length - 1) {
+      content += ",\n";
+    } else {
+      content += "\n";
+    }
+  });
+
+  content += footer;
+
+  fs.writeFileSync(outputFile, content);
+  console.log(`Successfully generated ${outputFile}`);
+}
+
+generate();

packages/core/scripts/generate-wsdl-strings.ts

@@ -15,6 +15,12 @@ import {
   CurrencyType,
   OptionalType,
   TaxType,
+  IvaReceptorType,
+  CaeaResponse,
+  CaeaNoMovement,
+  PaisType,
+  ActividadType,
+  CotizacionType,
   ErrorInfo,
 } from "@domain/types/electronic-billing.types";
 
@@ -136,3 +142,79 @@ export interface TaxTypesResultDto {
     err?: ErrorInfo[];
   };
 }
+
+/**
+ * IVA Receptor Types Result DTO
+ */
+export interface IvaReceptorTypesResultDto {
+  resultGet?: {
+    condicionIvaReceptor?: IvaReceptorType[];
+  };
+  errors?: {
+    err?: ErrorInfo[];
+  };
+}
+
+/**
+ * CAEA Result DTO
+ */
+export interface CaeaResultDto {
+  resultGet?: CaeaResponse;
+  errors?: {
+    err?: ErrorInfo[];
+  };
+}
+
+/**
+ * CAEA No Movement Result DTO
+ */
+export interface CaeaNoMovementResultDto {
+  resultGet?: CaeaNoMovement[];
+  errors?: {
+    err?: ErrorInfo[];
+  };
+}
+
+/**
+ * Countries Result DTO
+ */
+export interface CountriesResultDto {
+  resultGet?: {
+    paisTipo?: PaisType[];
+  };
+  errors?: {
+    err?: ErrorInfo[];
+  };
+}
+
+/**
+ * Activities Result DTO
+ */
+export interface ActivitiesResultDto {
+  resultGet?: {
+    actividadesTipo?: ActividadType[];
+  };
+  errors?: {
+    err?: ErrorInfo[];
+  };
+}
+
+/**
+ * Quotation Result DTO
+ */
+export interface QuotationResultDto {
+  resultGet?: CotizacionType;
+  errors?: {
+    err?: ErrorInfo[];
+  };
+}
+
+/**
+ * Max Records Result DTO
+ */
+export interface MaxRecordsResultDto {
+  resultGet?: number;
+  errors?: {
+    err?: ErrorInfo[];
+  };
+}

packages/core/src/application/dto/electronic-billing.dto.ts

@@ -18,6 +18,13 @@ import {
   CurrencyTypesResultDto,
   OptionalTypesResultDto,
   TaxTypesResultDto,
+  IvaReceptorTypesResultDto,
+  CaeaResultDto,
+  CaeaNoMovementResultDto,
+  CountriesResultDto,
+  ActivitiesResultDto,
+  QuotationResultDto,
+  MaxRecordsResultDto,
 } from "@application/dto/electronic-billing.dto";
 
 export interface IElectronicBillingRepositoryPort {
@@ -105,4 +112,82 @@ export interface IElectronicBillingRepositoryPort {
    * @returns Tax types information
    */
   getTaxTypes(): Promise<TaxTypesResultDto>;
+
+  /**
+   * Get available IVA receptor types
+   * @param claseCmp Voucher class (optional)
+   * @returns IVA receptor types information
+   */
+  getIvaReceptorTypes(claseCmp?: string): Promise<IvaReceptorTypesResultDto>;
+
+  /**
+   * Request CAEA (Anticipated Electronic Authorization Code)
+   * @param period Period (YYYYMM)
+   * @param order Fortnight (1 or 2)
+   * @returns CAEA information
+   */
+  getCaea(period: number, order: number): Promise<CaeaResultDto>;
+
+  /**
+   * Consult CAEA
+   * @param period Period (YYYYMM)
+   * @param order Fortnight (1 or 2)
+   * @returns CAEA information
+   */
+  consultCaea(period: number, order: number): Promise<CaeaResultDto>;
+
+  /**
+   * Inform CAEA No Movement
+   * @param caea CAEA number
+   * @param salesPoint Sales point number
+   * @returns CAEA No Movement information
+   */
+  informCaeaNoMovement(
+    caea: string,
+    salesPoint: number
+  ): Promise<CaeaNoMovementResultDto>;
+
+  /**
+   * Consult CAEA No Movement
+   * @param caea CAEA number
+   * @param salesPoint Sales point number
+   * @returns CAEA No Movement information
+   */
+  consultCaeaNoMovement(
+    caea: string,
+    salesPoint: number
+  ): Promise<CaeaNoMovementResultDto>;
+
+  /**
+   * Inform CAEA Usage (Regimen Informativo)
+   * @param caea CAEA number
+   * @param salesPoint Sales point number
+   * @returns CAEA Usage information
+   */
+  informCaeaUsage(voucher: Voucher, caea: string): Promise<CaeaResultDto>;
+
+  /**
+   * Get Quotation
+   * @param currencyId Currency ID
+   * @returns Quotation information
+   */
+  getQuotation(currencyId: string): Promise<QuotationResultDto>;
+
+  /**
+   * Get Countries
+   * @returns Countries information
+   */
+  getCountries(): Promise<CountriesResultDto>;
+
+  /**
+   * Get Activities
+   * @returns Activities information
+   */
+  getActivities(): Promise<ActivitiesResultDto>;
+
+  /**
+   * Get Max Records per Request
+   * @returns Max records number
+   */
+  getMaxRecordsPerRequest(): Promise<MaxRecordsResultDto>;
 }