Tipe

interface PaymentScope {
  provider: string; // id provider stabil, mis. "gopay" atau "shopee"
  accountId?: string; // id akun provider bila tersedia
  merchantId: string; // id merchant/store native provider untuk polling
}

type PaymentStatus = "pending" | "paid" | "expired" | "cancelled";

interface Payment {
  id: string;
  scope?: PaymentScope; // dihilangkan hanya pada record unscoped eksplisit
  baseAmount: number; // nominal diminta merchant (rupiah penuh)
  uniqueOffset: number; // offset unik untuk disambiguasi
  uniqueAmount: number; // nominal yang harus ditransfer (base + offset)
  status: PaymentStatus;
  createdAt: number;
  expiresAt: number;
  reference?: string; // referensi caller (order id internal)
  qrString?: string; // QRIS dinamis bila QRIS statis dikonfigurasi
  transaction?: MerchantTransaction; // transaksi tercocok setelah lunas
  metadata?: Record<string, unknown>;
}

interface PaymentStore {
  create(payment: Payment): Promise<void> | void;
  update(payment: Payment): Promise<void> | void;
  get(id: string): Promise<Payment | undefined> | Payment | undefined;
  listActive(scope?: PaymentScope): Promise<Payment[]> | Payment[];
}

interface MerchantTransaction {
  id: string;
  orderId: string;
  merchantId: string;
  status: string;
  paymentType: string;
  grossAmount: number;
  realGrossAmount?: number;
  currency: string;
  transactionTime: string;
  settlementTime?: string;
  transactionSource?: string;
  raw: unknown;
}

interface TransactionLister {
  list(
    merchantId: string,
    query: TransactionQuery,
  ): Promise<MerchantTransaction[]>;
}

interface TransactionQuery {
  from?: number;
  size?: number;
  statuses?: readonly string[];
  paymentTypes?: readonly string[];
  startTime: Date;
  endTime: Date;
}

interface TransactionFeed {
  listRecent(query: TransactionFeedQuery): Promise<TransactionFeedResult>;
}

interface TransactionFeedQuery {
  scope: PaymentScope;
  startTime: Date;
  endTime: Date;
  pageSize: number;
  maxPages: number;
}

interface TransactionFeedResult {
  transactions: MerchantTransaction[];
  truncated: boolean;
  pagesFetched?: number;
}

interface MerchantProvider<TSession = SessionState> {
  readonly providerId: string;
  readonly authenticated: boolean;
  readonly staticQris?: string;
  getPaymentScope(): PaymentScope | undefined;
  exportSession(): TSession;
}

interface TokenSet {
  accessToken: string;
  refreshToken: string;
  expiresAt?: number; // epoch ms bila derivable
  tokenType: string;
}

interface SessionState {
  tokens: TokenSet;
  deviceId?: string;
  lastRefreshedAt?: number;
}

interface LoginRequestResult {
  otpToken?: string;
  raw: unknown;
}

interface MerchantProfile {
  id: string;
  merchantName: string;
  outletName?: string;
  phone?: string;
  email?: string;
  serverKey?: string;
  clientKey?: string;
  timezone?: string;
  outlets: MerchantOutlet[];
  raw: unknown;
}

interface MerchantOutlet {
  popId: string;
  name?: string;
  status?: string;
  receiverId?: string;
  qrString?: string; // payload QRIS statis EMVCo outlet
  raw: unknown;
}

interface StoredMerchant {
  id: string;
  merchantName: string;
  outletName?: string;
  phone?: string;
  email?: string;
  businessType?: string;
  merchantType?: string;
  serviceArea?: string;
  outlets: MerchantOutlet[];
  qrString?: string;
  raw: unknown;
}

type ShopeeLoginOutcome =
  | { status: "complete"; session: ShopeeSession }
  | {
      status: "merchant-selection-required";
      verification: ShopeeOtpVerification;
      merchants: ShopeeMerchantSummary[];
    };

interface ShopeeSession {
  version: 1;
  cookies: ShopeeCookie[];
  accountId: string;
  merchant: ShopeeMerchantSummary;
  merchants: ShopeeMerchantSummary[];
  switchCredential?: {
    tocNonce: string;
    spcClientId: string;
    deviceFingerprint: string;
  };
  stores: ShopeeStore[];
  storeId?: string;
  createdAt: number;
  expiresAt?: number;
}

interface ShopeeStaticQrisScope {
  merchantId: string;
  storeId: string;
}

type LogLevel = "debug" | "info" | "warn" | "error";

interface Logger {
  debug(message: string, context?: Record<string, unknown>): void;
  info(message: string, context?: Record<string, unknown>): void;
  warn(message: string, context?: Record<string, unknown>): void;
  error(message: string, context?: Record<string, unknown>): void;
}