@acontplus/ng-common 1.0.0

package/types/acontplus-ng-common.d.ts

@@ -0,0 +1,455 @@
+import { Observable } from 'rxjs';
+import { HttpResponse } from '@angular/common/http';
+import * as i0 from '@angular/core';
+import { InjectionToken, OnInit } from '@angular/core';
+import { FormGroup } from '@angular/forms';
+
+interface WhatsAppTextRequest {
+    to: string;
+    message: string;
+    previewUrl?: boolean;
+}
+interface WhatsAppTextTemplateRequest {
+    to: string;
+    templateName: string;
+    languageCode?: string;
+    bodyParams?: string[];
+}
+interface WhatsAppDocumentRequest {
+    to: string;
+    documentUrl: string;
+    caption?: string;
+    filename?: string;
+}
+interface WhatsAppDocumentTemplateRequest {
+    to: string;
+    templateName: string;
+    languageCode?: string;
+    filename?: string;
+    bodyParams?: string[];
+    file: File;
+}
+interface WhatsAppResponse {
+    success: boolean;
+    messageId?: string;
+    phoneNumber?: string;
+    error?: {
+        code: number;
+        message: string;
+    };
+}
+interface WhatsAppStatusResponse {
+    enabled: boolean;
+    provider: string;
+}
+interface DocumentDeliveryParams {
+    phone: string;
+    file: File;
+    customerName: string;
+    establishmentName: string;
+    documentSeries: string;
+    documentType: string;
+}
+type WhatsAppTextMessage = WhatsAppTextRequest;
+type WhatsAppTemplateMessage = WhatsAppTextTemplateRequest;
+type WhatsAppDocumentMessage = WhatsAppDocumentRequest;
+type WhatsAppDocumentTemplateMessage = WhatsAppDocumentTemplateRequest;
+type WhatsAppMessageResponse = WhatsAppResponse;
+type WhatsAppProviderStatus = WhatsAppStatusResponse;
+
+/**
+ * Puerto para proveedores de WhatsApp
+ * Define la interfaz que deben implementar todos los adaptadores (Meta, Green, etc.)
+ */
+interface WhatsAppMessagingPort {
+    sendText(request: WhatsAppTextRequest): Observable<WhatsAppResponse>;
+    sendTextTemplate(request: WhatsAppTextTemplateRequest): Observable<WhatsAppResponse>;
+    sendDocument(request: WhatsAppDocumentRequest): Observable<WhatsAppResponse>;
+    sendDocumentTemplate(request: WhatsAppDocumentTemplateRequest): Observable<WhatsAppResponse>;
+    getStatus(): Observable<WhatsAppStatusResponse>;
+}
+
+interface PrintParams {
+    id: number;
+    documentoId: number;
+    tipo: 1 | 2 | 3 | 4 | 5 | 6;
+    codDoc: string;
+    codEstab?: string;
+}
+interface PrintConfig {
+    codDoc: string;
+    getUrlPrintServer: boolean;
+    id: number;
+    codEstab?: string;
+}
+interface ApiResponse<T = any> {
+    code: string;
+    message: string;
+    payload?: T;
+}
+/**
+ * Puerto para impresión de documentos
+ * Solo se encarga de impresión, no de generación de reportes
+ */
+interface PrinterPort {
+    askToPrint(params: PrintParams): void;
+    getPrintConfig(params: PrintParams): Observable<ApiResponse>;
+    print(urlPrinter: string, params: PrintParams): Observable<ApiResponse>;
+    createPrintOrder(id: number): void;
+    createPrintCommanda(id: number): void;
+    createPrintOrderWithCommanda(id: number): void;
+    createInvoicePrint(id: number, documentoId: number): void;
+    createNotaEntregaPrint(id: number, documentoId: number): void;
+}
+
+interface ReportGenerationOptions<T = any> {
+    data: T;
+    format?: 'pdf' | 'excel' | 'word';
+    useV1Api?: boolean;
+    forceDownload?: boolean;
+    returnBlob?: boolean;
+}
+/**
+ * Puerto para generación de reportes
+ * Solo se encarga de generar reportes, no de impresión
+ */
+interface ReportPort {
+    generate<T>(options: ReportGenerationOptions<T>): Observable<HttpResponse<Blob>> | void;
+    saveFile(response: any, format?: string, forceDownload?: boolean): void;
+    getFileName(response: any): string;
+}
+
+declare const API_PATHS: {
+    readonly WHATSAPP: "/api/common/whatsapp-cloud";
+    readonly REPORTS: "/api/reports";
+    readonly CONFIG: "/api/config";
+};
+declare const DOCUMENT_TYPES: {
+    readonly NORMAL: "NORMAL";
+    readonly FACTURA: "FACTURA";
+    readonly NOTA_ENTREGA: "NOTA_ENTREGA";
+};
+
+declare const REPORT_PORT: InjectionToken<ReportPort>;
+
+declare const WHATSAPP_MESSAGING_PORT: InjectionToken<WhatsAppMessagingPort>;
+
+declare const PRINTER_PORT: InjectionToken<PrinterPort>;
+
+declare class ReportFacade {
+    private readonly reportPort;
+    generate<T>(options: ReportGenerationOptions<T>): Observable<any> | void;
+    generatePDF<T>(data: T, forceDownload?: boolean): void;
+    generateExcel<T>(data: T, forceDownload?: boolean): void;
+    generateWord<T>(data: T, forceDownload?: boolean): void;
+    generateBlob<T>(data: T, format?: 'pdf' | 'excel' | 'word'): Observable<any>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ReportFacade, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ReportFacade>;
+}
+
+declare class WhatsAppMessagingFacade {
+    private readonly messagingPort;
+    private readonly messageBuilder;
+    sendSimpleText(to: string, message: string, previewUrl?: boolean): Observable<WhatsAppResponse>;
+    sendTemplateText(to: string, templateName: string, params?: string[], languageCode?: string): Observable<WhatsAppResponse>;
+    sendDocument(to: string, documentUrl: string, caption?: string, filename?: string): Observable<WhatsAppResponse>;
+    deliverDocument(params: DocumentDeliveryParams): Observable<WhatsAppResponse>;
+    sendDocumentWithTemplate(params: {
+        phone: string;
+        file: File;
+        templateName: string;
+        bodyParams?: string[];
+        languageCode?: string;
+        filename?: string;
+    }): Observable<WhatsAppResponse>;
+    sendDocumentWithMessages(params: {
+        phone: string;
+        file: File;
+        messages: {
+            main: string;
+            promo: string;
+        };
+    }): Observable<WhatsAppResponse>;
+    getProviderStatus(): Observable<any>;
+    isValidPhone(phone: string): boolean;
+    toDisplayFormat(phone: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WhatsAppMessagingFacade, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<WhatsAppMessagingFacade>;
+}
+
+declare class PrinterFacade {
+    private readonly printerPort;
+    askToPrint(params: PrintParams): void;
+    printOrder(id: number): void;
+    printCommanda(id: number): void;
+    printOrderWithCommanda(id: number): void;
+    printInvoice(id: number, documentoId: number): void;
+    printNotaEntrega(id: number, documentoId: number): void;
+    autoPrint(data: {
+        printerAutomatic: boolean;
+        orderId: number;
+        idDocumento: number;
+    }, codDoc: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PrinterFacade, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PrinterFacade>;
+}
+
+declare class MetaWhatsAppAdapter implements WhatsAppMessagingPort {
+    private readonly http;
+    sendText(request: WhatsAppTextRequest): Observable<WhatsAppResponse>;
+    sendTextTemplate(request: WhatsAppTextTemplateRequest): Observable<WhatsAppResponse>;
+    sendDocument(request: WhatsAppDocumentRequest): Observable<WhatsAppResponse>;
+    sendDocumentTemplate(request: WhatsAppDocumentTemplateRequest): Observable<WhatsAppResponse>;
+    getStatus(): Observable<WhatsAppStatusResponse>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MetaWhatsAppAdapter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MetaWhatsAppAdapter>;
+}
+
+/**
+ * Adaptador para Green API (legacy)
+ * Implementa la interfaz WhatsApp usando Green API
+ */
+declare class GreenWhatsAppAdapter implements WhatsAppMessagingPort {
+    private readonly http;
+    sendText(request: WhatsAppTextRequest): Observable<WhatsAppResponse>;
+    sendTextTemplate(request: WhatsAppTextTemplateRequest): Observable<WhatsAppResponse>;
+    sendDocument(request: WhatsAppDocumentRequest): Observable<WhatsAppResponse>;
+    sendDocumentTemplate(request: WhatsAppDocumentTemplateRequest): Observable<WhatsAppResponse>;
+    getStatus(): Observable<WhatsAppStatusResponse>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GreenWhatsAppAdapter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<GreenWhatsAppAdapter>;
+}
+
+declare class ReportAdapter implements ReportPort {
+    private readonly http;
+    generate<T>(options: ReportGenerationOptions<T>): Observable<HttpResponse<Blob>> | void;
+    getFileName(response: any): string;
+    saveFile(response: any, format?: string, forceDownload?: boolean): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ReportAdapter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ReportAdapter>;
+}
+
+declare class PrinterAdapter implements PrinterPort {
+    private readonly http;
+    askToPrint(obj: PrintParams): void;
+    getPrintConfig(obj: PrintParams): Observable<ApiResponse>;
+    print(urlPrinter: string, paramsToPrint: PrintParams): Observable<ApiResponse>;
+    createPrintOrder(id: number): void;
+    createPrintCommanda(id: number): void;
+    createPrintOrderWithCommanda(id: number): void;
+    createInvoicePrint(id: number, documentoId: number): void;
+    createNotaEntregaPrint(id: number, documentoId: number): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PrinterAdapter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PrinterAdapter>;
+}
+
+interface ReportDocumentData {
+    codDoc: string;
+    codEstab?: string;
+    id?: number;
+    serie?: string;
+}
+interface ReportParams {
+    hasService?: boolean;
+    reportParams: string;
+    dataParams: string;
+}
+declare class ReportParamsBuilder {
+    private readonly reportConfigs;
+    /**
+     * Construye los parámetros de reporte según el tipo de documento
+     */
+    buildParams(docData: ReportDocumentData, format?: 'pdf' | 'excel' | 'word'): ReportParams;
+    /**
+     * Determina si debe usar la API v1 según el tipo de documento
+     */
+    shouldUseV1Api(codDoc: string): boolean;
+    /**
+     * Obtiene la configuración para un tipo de documento
+     */
+    private getReportConfig;
+    /**
+     * Construye los parámetros del reporte
+     */
+    private buildReportParams;
+    /**
+     * Construye los parámetros de datos
+     */
+    private buildDataParams;
+    /**
+     * Método de conveniencia para generar reporte directamente
+     */
+    generateReportFor(docData: ReportDocumentData, format?: 'pdf' | 'excel' | 'word', returnBlob?: boolean): {
+        data: ReportParams;
+        format: "pdf" | "excel" | "word";
+        useV1Api: boolean;
+        returnBlob: boolean;
+    };
+    /**
+     * Obtiene la lista de tipos de documento soportados
+     */
+    getSupportedDocumentTypes(): string[];
+    /**
+     * Verifica si un tipo de documento está soportado
+     */
+    isDocumentTypeSupported(codDoc: string): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ReportParamsBuilder, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ReportParamsBuilder>;
+}
+
+interface DocumentDeliveryData {
+    comprador: string;
+    establecimiento: string;
+    serie: string;
+    tipo: string;
+}
+interface WhatsAppMessages {
+    main: string;
+    promo: string;
+}
+declare class WhatsAppMessageBuilder {
+    buildDocumentDeliveryMessages(data: DocumentDeliveryData): WhatsAppMessages;
+    buildWelcomeMessage(customerName: string, establishmentName: string): string;
+    buildOrderConfirmationMessage(orderNumber: string, customerName: string): string;
+    buildPaymentReminderMessage(customerName: string, amount: number, dueDate: string): string;
+    private buildMainMessage;
+    private buildPromoMessage;
+    private getDocumentTypeDisplay;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WhatsAppMessageBuilder, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<WhatsAppMessageBuilder>;
+}
+
+/**
+ * Utilidades para manejo de archivos y respuestas HTTP
+ */
+declare class FileMapperUtil {
+    /**
+     * Extrae el nombre de archivo desde el header Content-Disposition
+     */
+    static extractFileName(response: any): string;
+    /**
+     * Crea un objeto File desde una respuesta HTTP
+     */
+    static fromResponse(response: any): File;
+    /**
+     * Descarga un archivo usando la API nativa del navegador
+     */
+    static downloadFile(blob: Blob, fileName: string): void;
+    /**
+     * Abre un archivo en una nueva ventana (para PDFs)
+     */
+    static openFile(blob: Blob, fileName: string): void;
+    /**
+     * Detecta si es un navegador legacy que requiere descarga forzada
+     */
+    static isLegacyBrowser(): boolean;
+    private static generateDefaultFileName;
+}
+
+interface PhoneValidationResult {
+    isValid: boolean;
+    cleanPhone: string;
+    errorMessage?: string;
+}
+/**
+ * Utilidades para formateo y validación de números telefónicos
+ */
+declare class PhoneFormatterUtil {
+    /**
+     * Limpia el teléfono removiendo todos los caracteres no numéricos
+     */
+    static cleanPhone(phone: string): string;
+    /**
+     * Valida si un teléfono ecuatoriano es válido
+     */
+    static validateEcuadorianPhone(phone: string): PhoneValidationResult;
+    /**
+     * Convierte número local ecuatoriano a formato internacional
+     */
+    static toInternationalFormat(phone: string): string;
+    /**
+     * Formatea teléfono para la API de WhatsApp Business (con @c.us)
+     */
+    static formatForWhatsAppApi(phone: string): string;
+    /**
+     * Formatea teléfono para WhatsApp Web (sin @c.us)
+     */
+    static formatForWhatsAppWeb(phone: string): string;
+    /**
+     * Formatea teléfono para mostrar al usuario (con espacios y +)
+     */
+    static formatForDisplay(phone: string): string;
+    /**
+     * Validación general para teléfonos internacionales
+     */
+    static isValidInternationalPhone(phone: string): boolean;
+    /**
+     * Genera el hint apropiado según el estado del teléfono
+     */
+    static getPhoneHint(phone: string): string;
+    /**
+     * Obtiene el placeholder para el campo de teléfono
+     */
+    static getPhonePlaceholder(): string;
+}
+
+interface DocumentData {
+    idDocumentoElectronico?: number;
+    documentoId?: number;
+    codDoc: string;
+    docType?: string;
+    codEstab?: string;
+    id?: number;
+    serie?: string;
+}
+interface WhatsAppSendConfig {
+    documentData?: DocumentData;
+    phoneNumbers?: string[];
+    defaultMessage?: string;
+    establishmentPhone?: string;
+    establishmentName?: string;
+    customerName?: string;
+}
+declare class WhatsAppSender implements OnInit {
+    config?: WhatsAppSendConfig;
+    private readonly fb;
+    private readonly whatsappFacade;
+    private readonly reportFacade;
+    private readonly snackBar;
+    private readonly reportBuilder;
+    whatsappForm: FormGroup;
+    isLoading: i0.WritableSignal<boolean>;
+    messageLength: number;
+    phoneNumbers: i0.WritableSignal<string[]>;
+    showWhatsAppWebLink: i0.WritableSignal<boolean>;
+    whatsAppWebUrl: i0.WritableSignal<string>;
+    establishmentPhone: string;
+    establishmentName: string;
+    customerName: string;
+    ngOnInit(): void;
+    private loadConfigData;
+    private initializeForm;
+    private ecuadorianPhoneValidator;
+    private setupMessageLengthCounter;
+    sendWhatsApp(): void;
+    private validatePhoneNumber;
+    private sendSimpleMessage;
+    private sendWithDocument;
+    private generateReport;
+    private processReportFile;
+    private sendMediaWithMessages;
+    private prepareWhatsAppWebLink;
+    openWhatsAppWeb(): void;
+    hideWhatsAppWebLink(): void;
+    private showSuccess;
+    private showError;
+    clearForm(): void;
+    get formattedPhoneDisplay(): string;
+    get phonePlaceholder(): string;
+    get phoneHint(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WhatsAppSender, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<WhatsAppSender, "acp-whatsapp-sender", never, { "config": { "alias": "config"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+export { API_PATHS, DOCUMENT_TYPES, FileMapperUtil, GreenWhatsAppAdapter, MetaWhatsAppAdapter, PRINTER_PORT, PhoneFormatterUtil, PrinterAdapter, PrinterFacade, REPORT_PORT, ReportAdapter, ReportFacade, ReportParamsBuilder, WHATSAPP_MESSAGING_PORT, WhatsAppMessageBuilder, WhatsAppMessagingFacade, WhatsAppSender };
+export type { ApiResponse, DocumentData, DocumentDeliveryData, DocumentDeliveryParams, PhoneValidationResult, PrintConfig, PrintParams, PrinterPort, ReportDocumentData, ReportGenerationOptions, ReportParams, ReportPort, WhatsAppDocumentMessage, WhatsAppDocumentRequest, WhatsAppDocumentTemplateMessage, WhatsAppDocumentTemplateRequest, WhatsAppMessageResponse, WhatsAppMessages, WhatsAppMessagingPort, WhatsAppProviderStatus, WhatsAppResponse, WhatsAppSendConfig, WhatsAppStatusResponse, WhatsAppTemplateMessage, WhatsAppTextMessage, WhatsAppTextRequest, WhatsAppTextTemplateRequest };