@posx/core 5.5.35 → 5.5.37

package/build/index.d.ts

@@ -428,7 +428,7 @@ declare module '@posx/core/services/app.service' {
   import { AppRemoteService, IAppRemoteService, IAppModelSequence } from '@posx/core/services/abstract.service';
   import { IAppConfig, IConfig, UpdateGeneralConfigOptions, ICache } from '@posx/core/types/config.type';
   import { IPrintJob, IPrintTemplate, IPrinter, IRenderPrintTemplateOptions, RenderPrintTemplateOptions } from '@posx/core/types/printer.type';
-  import { IPayment, IPaymentMethod } from '@posx/core/types/payment.type';
+  import { IPayment, IPaymentMethod, IPaymentSyncData } from '@posx/core/types/payment.type';
   import { INote, INoteGroup } from '@posx/core/types/note.type';
   import { ISection, ISectionItem } from '@posx/core/types/section.type';
   import { Category, ICategory, ICoreItem, IItem, ISubcategory } from '@posx/core/types/product.type';
@@ -828,16 +828,49 @@ declare module '@posx/core/services/app.service' {
        * @returns A promise that resolves to the updated invoice.
        */
       removePayment(invoice: IInvoice, payment_uid: string): Promise<IInvoice>;
+      /**
+       * Sync payment status callback function type
+       */
+      onPaymentSync?: (data: IPaymentSyncData) => Promise<void>;
+      /**
+       * Sync payment status to external systems
+       * @param data - Payment sync data
+       */
+      syncPaymentStatus(data: IPaymentSyncData): Promise<void>;
   }
+  /**
+   * Payment Service implementation
+   *
+   * Usage example for CDS payment status sync:
+   * ```typescript
+   * // Setup payment sync callback
+   * paymentService.onPaymentSync = async (data: IPaymentSyncData) => {
+   *   // Send to CDS or other external systems
+   *   console.log('Payment status:', data.status, 'for payment:', data.payment_uid);
+   * };
+   *
+   * // Manual payment status sync (for external payment flows)
+   * await paymentService.syncPaymentStatus({
+   *   payment_uid: 'payment_123',
+   *   invoice_uid: 'invoice_456',
+   *   status: PaymentStatus.STARTED,
+   *   payment_method: paymentMethod,
+   *   amount: 100.00,
+   *   timestamp: new Date()
+   * });
+   * ```
+   */
   export class PaymentService extends AppRemoteService<IPayment> implements IPaymentService {
       readonly http: AxiosInstance;
       readonly db: Dexie;
       readonly options: IServiceOptions;
       readonly moduleName: string;
       readonly methodName: string;
+      onPaymentSync?: (data: IPaymentSyncData) => Promise<void>;
       constructor(http: AxiosInstance, db: Dexie, options: IServiceOptions, moduleName?: string, methodName?: string);
       addPayment(invoice: IInvoice, amount: number, paymentMethod: IPaymentMethod): Promise<IInvoice>;
       removePayment(invoice: IInvoice, payment_uid: string): Promise<IInvoice>;
+      syncPaymentStatus(data: IPaymentSyncData): Promise<void>;
   }
   /**
    * Represents the interface for the AppMiscService.
@@ -1123,6 +1156,9 @@ declare module '@posx/core/services/invoice.service' {
   export interface ILineOperationService extends IInvoiceBaseService {
       /**
        * Adds an item to an invoice line. If the item already exists in the invoice, the quantity is increased, otherwise a new line is created.
+       * Adding items with positive quantities
+       * Reducing quantities of existing items with negative values
+       * Automatic removal of lines when quantity reaches 0 or below
        * @param invoice - The invoice to add the item to.
        * @param customer - The customer associated with the invoice.
        * @param appConfig - The app configuration.
@@ -3281,6 +3317,46 @@ declare module '@posx/core/types/payment.type' {
       source_payment: IPayment;
       target_payment_method: IPaymentMethod;
   };
+  /**
+   * Payment sync status enum
+   */
+  export enum PaymentStatus {
+      STARTED = "payment_started",
+      PROCESSING = "payment_processing",
+      COMPLETED = "payment_completed",
+      FAILED = "payment_failed"
+  }
+  /**
+   * Payment sync data interface
+   */
+  export interface IPaymentSyncData {
+      /** Payment unique identifier */
+      payment_uid: string;
+      /** Associated invoice ID */
+      invoice_uid: string;
+      /** Table ID */
+      table_uid?: string;
+      /** Payment status */
+      status: PaymentStatus;
+      /** Payment method */
+      payment_method: IPaymentMethod;
+      /** Payment amount */
+      amount: number;
+      /** Actual tender amount */
+      tender_amount?: number;
+      /** Change amount */
+      change_amount?: number;
+      /** Payment result */
+      result?: 'success' | 'failed';
+      /** Error message */
+      error_message?: string;
+      /** Timestamp */
+      timestamp: Date;
+      /** Employee UID */
+      employee_uid?: string;
+      /** Terminal ID */
+      terminal_id?: string;
+  }
 
 }
 declare module '@posx/core/types/printer.type' {