miinventario-v2/apps/backend/src/modules/integrations/pos/interfaces/pos-adapter.interface.ts

import { PosProvider } from '../../entities/pos-integration.entity';

export interface PosProduct {
  externalId: string;
  name: string;
  sku?: string;
  barcode?: string;
  category?: string;
  quantity: number;
  price?: number;
  cost?: number;
  imageUrl?: string;
}

export interface PosSaleItem {
  externalProductId: string;
  quantity: number;
  unitPrice: number;
  totalPrice: number;
}

export interface PosSale {
  externalId: string;
  items: PosSaleItem[];
  totalAmount: number;
  timestamp: Date;
}

export interface PosInventoryUpdate {
  externalProductId: string;
  newQuantity: number;
  reason?: string;
}

export interface PosAdapterConfig {
  provider: PosProvider;
  credentials: Record<string, unknown>;
  storeId: string;
}

export interface IPosAdapter {
  readonly provider: PosProvider;

  /**
   * Initialize the adapter with credentials
   */
  initialize(config: PosAdapterConfig): Promise<void>;

  /**
   * Validate the credentials are correct
   */
  validateCredentials(): Promise<boolean>;

  /**
   * Fetch all products from POS
   */
  getProducts(): Promise<PosProduct[]>;

  /**
   * Fetch a single product by external ID
   */
  getProduct(externalId: string): Promise<PosProduct | null>;

  /**
   * Update inventory quantity in POS
   */
  updateInventory(updates: PosInventoryUpdate[]): Promise<void>;

  /**
   * Fetch recent sales
   */
  getSales(since: Date): Promise<PosSale[]>;

  /**
   * Generate webhook secret for this integration
   */
  generateWebhookSecret(): string;

  /**
   * Verify webhook signature
   */
  verifyWebhookSignature(
    payload: string,
    signature: string,
    secret: string,
  ): boolean;
}