@jazadev/react-native 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,271 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { ViewStyle } from 'react-native';
+
+type Bundle = {
+    id: string;
+    appId: string;
+    label: string | null;
+    priceUsd: string;
+    credits: number;
+    isActive: boolean;
+    sortOrder: number;
+    createdAt: string;
+    updatedAt: string;
+};
+type CatalogCurrency = {
+    id: string;
+    code: string;
+    name: string;
+    decimals: number;
+    isActive: boolean;
+};
+type CatalogCountry = {
+    id: string;
+    name: string;
+    iso2: string;
+    iso3: string;
+    isActive: boolean;
+    currencies?: Array<{
+        currency: CatalogCurrency;
+    }>;
+    paymentGateways?: unknown[];
+};
+type PredictProviderResponse = {
+    provider: {
+        code: string;
+        displayName: string;
+    };
+    countryIso3: string | null;
+    currencies: Array<{
+        code: string;
+        decimals: number;
+    }>;
+    defaultCurrencyCode: string;
+};
+type QuotePaymentResponse = {
+    bundleId: string;
+    credits: number;
+    currencyCode: string;
+    paymentGatewayCode: string;
+    amountUsd: string;
+    amountLocal: string;
+    feeUsd: string;
+    feeLocal: string;
+    totalUsd: string;
+    totalLocal: string;
+};
+type DepositStatus = 'PENDING' | 'COMPLETED' | 'FAILED' | 'EXPIRED' | 'CANCELLED';
+type PublicDeposit = {
+    id: string;
+    status: DepositStatus;
+    credits: number;
+    currencyCode: string | null;
+    paymentGatewayCode: string | null;
+    amountUsd: string;
+    amountLocal: string;
+    feeUsd: string;
+    feeLocal: string;
+    totalUsd: string;
+    totalLocal: string;
+    bundleId: string | null;
+    phoneNumber: string | null;
+    providerRef: string | null;
+    failureReason: string | null;
+    expiresAt: string;
+    createdAt: string;
+    updatedAt: string;
+};
+type TopUpCompleteResult = {
+    depositId: string;
+    credits: number;
+    status: DepositStatus;
+};
+
+type ThemeMode = 'light' | 'dark';
+type JazaTheme = {
+    mode: ThemeMode;
+    colors: {
+        background: string;
+        surface: string;
+        surfaceContainer: string;
+        surfaceContainerLow: string;
+        surfaceContainerHigh: string;
+        surfaceContainerHighest: string;
+        surfaceVariant: string;
+        onSurface: string;
+        onSurfaceVariant: string;
+        primary: string;
+        onPrimary: string;
+        primaryContainer: string;
+        onPrimaryContainer: string;
+        secondaryContainer: string;
+        onSecondaryContainer: string;
+        outline: string;
+        outlineVariant: string;
+        error: string;
+        success: string;
+        overlay: string;
+        bundleBorder: string;
+        bundleBorderSelected: string;
+        bundleBg: string;
+    };
+    spacing: {
+        xs: number;
+        sm: number;
+        md: number;
+        lg: number;
+        xl: number;
+        gutter: number;
+    };
+    radius: {
+        md: number;
+        lg: number;
+        xl: number;
+        full: number;
+    };
+};
+declare const darkTheme: JazaTheme;
+/** Checkout UI uses dark palette in both light and dark preference. */
+declare const lightTheme: JazaTheme;
+type ThemePreference = 'light' | 'dark' | 'system';
+
+type JazaProviderProps = {
+    publishableKey: string;
+    apiBaseUrl?: string;
+    getBalance: () => Promise<number>;
+    onTopUpComplete?: (result: TopUpCompleteResult) => void;
+    theme?: ThemePreference;
+    children: ReactNode;
+};
+declare function JazaProvider({ publishableKey, apiBaseUrl, getBalance, onTopUpComplete, theme: themePreference, children, }: JazaProviderProps): react.JSX.Element;
+
+type PublicClientConfig = {
+    apiBaseUrl?: string;
+    publishableKey: string;
+};
+declare class PublicClient {
+    private readonly apiBaseUrl;
+    private readonly publishableKey;
+    private topUpToken;
+    constructor(config: PublicClientConfig);
+    setTopUpToken(token: string | null): void;
+    listCountries(): Promise<CatalogCountry[]>;
+    listBundles(): Promise<Bundle[]>;
+    predictProvider(phoneNumber: string): Promise<PredictProviderResponse>;
+    quotePayment(body: {
+        bundleId: string;
+        currencyCode: string;
+        paymentGatewayCode: string;
+    }): Promise<QuotePaymentResponse>;
+    createDeposit(body: {
+        bundleId: string;
+        currencyCode: string;
+        paymentGatewayCode: string;
+        phoneNumber: string;
+        idempotencyKey?: string;
+    }): Promise<PublicDeposit>;
+    getDeposit(paymentRequestId: string): Promise<PublicDeposit>;
+    private authedRequest;
+    private request;
+}
+
+type EnrichedCountry = {
+    id: string;
+    name: string;
+    iso2: string;
+    iso3: string;
+    dialCode: string;
+    flag: string;
+    currencies: Array<{
+        code: string;
+        decimals: number;
+        name: string;
+    }>;
+};
+declare function enrichCountries(countries: CatalogCountry[]): EnrichedCountry[];
+declare function buildE164(dialCode: string, nationalNumber: string): string;
+/** Prefer local (non-USD) when multiple currencies are supported. */
+declare function pickDefaultCurrencyCode(codes: string[]): string;
+declare function isDepositTerminal(status: string): status is 'COMPLETED' | 'FAILED' | 'EXPIRED' | 'CANCELLED';
+declare function formatCredits(n: number): string;
+declare function formatUsd(priceUsd: string): string;
+declare function formatCurrencyAmount(amount: string | number, currencyCode: string, _decimals?: number): string;
+/** @deprecated Use formatCurrencyAmount */
+declare function formatLocalAmount(amount: string, currencyCode: string, decimals?: number): string;
+
+type TopUpStep = 'offer' | 'payment' | 'processing';
+type ResultPhase = 'loading' | 'success' | 'failure';
+type JazaContextValue = {
+    theme: JazaTheme;
+    themePreference: ThemePreference;
+    publishableKey: string;
+    client: PublicClient;
+    balance: number | null;
+    balanceLoading: boolean;
+    balanceError: string | null;
+    refreshBalance: () => Promise<void>;
+    sheetOpen: boolean;
+    step: TopUpStep;
+    resultPhase: ResultPhase;
+    topUpToken: string | null;
+    bundles: Bundle[];
+    bundlesLoading: boolean;
+    bundlesError: string | null;
+    selectedBundle: Bundle | null;
+    setSelectedBundle: (b: Bundle | null) => void;
+    countries: EnrichedCountry[];
+    selectedCountry: EnrichedCountry | null;
+    setSelectedCountry: (c: EnrichedCountry | null) => void;
+    selectedCurrencyCode: string | null;
+    setSelectedCurrencyCode: (code: string | null) => void;
+    phoneNational: string;
+    setPhoneNational: (v: string) => void;
+    predict: PredictProviderResponse | null;
+    predictLoading: boolean;
+    predictError: string | null;
+    quote: QuotePaymentResponse | null;
+    quoteLoading: boolean;
+    quoteError: string | null;
+    deposit: PublicDeposit | null;
+    depositError: string | null;
+    failureReason: string | null;
+    openTopUp: (token: string) => Promise<void>;
+    closeTopUp: () => void;
+    goToOffer: () => void;
+    goToPayment: () => void;
+    submitDeposit: () => Promise<void>;
+    retryPayment: () => void;
+    onTopUpComplete?: (result: TopUpCompleteResult) => void;
+};
+declare function useJaza(): JazaContextValue;
+
+type JazaBalanceWidgetProps = {
+    style?: ViewStyle;
+};
+declare function JazaBalanceWidget({ style }: JazaBalanceWidgetProps): react.JSX.Element;
+
+type JazaTopUpButtonProps = {
+    onRequestToken: () => Promise<string>;
+    label?: string;
+    style?: ViewStyle;
+};
+declare function JazaTopUpButton({ onRequestToken, label, style, }: JazaTopUpButtonProps): react.JSX.Element;
+
+declare class JazaSdkError extends Error {
+    readonly statusCode: number;
+    readonly code: string;
+    readonly raw: unknown;
+    constructor(statusCode: number, message: string, raw?: unknown);
+    static fromResponse(status: number, body: unknown): JazaSdkError;
+}
+
+declare const VERSION = "0.1.0";
+declare const DEFAULT_API_BASE_URL = "https://api.jaza.dev";
+
+/** ISO 3166-1 alpha-2 → international dial code (Jaza MoMo ecosystem). */
+declare const DIAL_CODES: Record<string, string>;
+declare function iso2ToFlag(iso2: string): string;
+declare function getDialCode(iso2: string): string | undefined;
+
+export { type Bundle, type CatalogCountry, DEFAULT_API_BASE_URL, DIAL_CODES, type DepositStatus, type EnrichedCountry, JazaBalanceWidget, type JazaBalanceWidgetProps, type JazaContextValue, JazaProvider, type JazaProviderProps, JazaSdkError, type JazaTheme, JazaTopUpButton, type JazaTopUpButtonProps, type PredictProviderResponse, PublicClient, type PublicClientConfig, type PublicDeposit, type QuotePaymentResponse, type ResultPhase, type ThemePreference, type TopUpCompleteResult, type TopUpStep, VERSION, buildE164, darkTheme, enrichCountries, formatCredits, formatCurrencyAmount, formatLocalAmount, formatUsd, getDialCode, isDepositTerminal, iso2ToFlag, lightTheme, pickDefaultCurrencyCode, useJaza };