@tapayadot/accept-react-native 1.3.3 → 1.14.1

package/build/Accept.d.ts

@@ -0,0 +1,255 @@
+import type { AcceptDisplay, AcceptLogEntry, AcceptLogLevel, AcceptSubscription, AcceptTheme, ActivateTerminalResult, InitializeOptions, MerchantConfig, MerchantInformation, MinimumAmount, OnboardingStatus, PayResult, PaymentEvent, PaymentOptions, PaymentRequest, PaymentState, PaymentStatus, PaymentSubscription, PluginStatus, PluginUpdateInfo, RefundReason, SdkState } from "./Accept.types";
+/**
+ * Entry point to the Accept SDK. Mirrors the `Accept` object in the Accept SDK for Android, so the
+ * Android reference documentation applies unchanged.
+ *
+ * ```ts
+ * import Accept from '@tapayadot/accept-react-native';
+ *
+ * Accept.initialize({ isProduction: false });
+ * await Accept.auth.authenticate(merchantToken);
+ *
+ * if (!Accept.plugin.isInstalled()) await Accept.plugin.install();
+ * await Accept.plugin.activateTerminal();
+ *
+ * const result = await Accept.payments.payAsync({ amount: 1000, currency: 'USD' });
+ * ```
+ */
+export declare const Accept: {
+    auth: {
+        /**
+         * Authenticates the SDK for the merchant identified by `merchantToken`. Must succeed before
+         * {@link merchant} or {@link payments} can be used.
+         *
+         * @throws AcceptError `NotInitialized`, `NoInternetConnection`, `Unknown`.
+         */
+        authenticate(merchantToken: string): Promise<void>;
+    };
+    sdk: {
+        /** The version of the Accept SDK for Android bundled in this build. Safe before `initialize`. */
+        readonly version: string;
+        /**
+         * Whether the SDK was initialized against production.
+         *
+         * @throws AcceptError `NotInitialized`.
+         */
+        readonly isProduction: boolean;
+        /**
+         * This device's stable identifier, assigned on the first successful
+         * {@link auth.authenticate} and retained until the app is uninstalled.
+         *
+         * @returns the device id, or `null` before the first authentication.
+         * @throws AcceptError `NotInitialized`, `Unknown`.
+         */
+        deviceId(): Promise<string | null>;
+        /**
+         * The minimum payable amount per supported currency.
+         *
+         * @throws AcceptError `NotInitialized`, `NoInternetConnection`, `Unknown`.
+         */
+        minimumAmounts(): Promise<MinimumAmount[]>;
+    };
+    merchant: {
+        /**
+         * The merchant's business profile, or `null` if onboarding hasn't been submitted yet.
+         *
+         * @throws AcceptError `NotAuthenticated`, `NoInternetConnection`, `Unknown`.
+         */
+        info(): Promise<MerchantInformation | null>;
+        /**
+         * The merchant's payment configuration.
+         *
+         * @throws AcceptError `NotAuthenticated`, `NoInternetConnection`, `Unknown`.
+         */
+        config(): Promise<MerchantConfig>;
+        /**
+         * Whether the merchant is ready to accept payments, or what is blocking it.
+         *
+         * @throws AcceptError `NotAuthenticated`, `NoInternetConnection`, `Unknown`.
+         */
+        onboardingStatus(): Promise<OnboardingStatus>;
+        /**
+         * The currency codes the merchant accepts. Shorthand for `config().availableCurrencies`.
+         *
+         * @throws AcceptError `NotAuthenticated`, `NoInternetConnection`, `Unknown`.
+         */
+        availableCurrencies(): Promise<string[]>;
+    };
+    payments: {
+        /**
+         * Sets the defaults applied to payments that don't override them on {@link pay}.
+         *
+         * Only the keys present are changed, so one option can be set without disturbing the others.
+         * `display` is also what the terminal warm-up fired by {@link auth.authenticate} follows — set it
+         * before authenticating to keep the warm-up off the merchant's screen.
+         */
+        setOptions(options: PaymentOptions): void;
+        /**
+         * Launches the plugin's payment flow and streams its lifecycle to `listener`.
+         *
+         * Never throws: a failure to create the payment arrives as a `creationFailed` event carrying an
+         * {@link AcceptError}. The stream ends after `result` or `creationFailed`, at which point the
+         * subscription removes itself.
+         *
+         * ```ts
+         * Accept.payments.pay({ amount: 1000, currency: 'USD' }, (event) => {
+         *   if (event.type === 'result' && event.payResult.type === 'success') {
+         *     console.log(event.payResult.paymentToken);
+         *   }
+         * });
+         * ```
+         *
+         * @returns a handle that stops delivering events; see {@link PaymentSubscription.remove}.
+         */
+        pay(request: PaymentRequest, listener: (event: PaymentEvent) => void): PaymentSubscription;
+        /**
+         * {@link pay} reduced to its outcome, for callers that don't render the intermediate states.
+         *
+         * @returns the terminal {@link PayResult}.
+         * @throws AcceptError whatever the payment would have reported as `creationFailed` — including
+         *   `PaymentInProgress`, `NotAuthenticated`, `PluginNotReadyForPayments`, `AmountBelowMinimum`,
+         *   and `LocationPermissionRequired`.
+         */
+        payAsync(request: PaymentRequest): Promise<PayResult>;
+        /**
+         * The current status of the payment identified by `paymentToken`.
+         *
+         * @throws AcceptError `NotAuthenticated`, `SessionExpired`, `PaymentNotFound`,
+         *   `NoInternetConnection`, `Unknown`.
+         */
+        status(paymentToken: string): Promise<PaymentStatus>;
+        /**
+         * Cancels the payment identified by `paymentToken`.
+         *
+         * @returns the resulting {@link PaymentState}.
+         * @throws AcceptError `NotAuthenticated`, `SessionExpired`, `PaymentNotFound`,
+         *   `NoInternetConnection`, `Unknown`.
+         */
+        cancel(paymentToken: string): Promise<PaymentState>;
+        /**
+         * Refunds the payment identified by `paymentToken`.
+         *
+         * @returns the resulting {@link PaymentState}.
+         * @throws AcceptError `NotAuthenticated`, `SessionExpired`, `PaymentNotFound`,
+         *   `NoInternetConnection`, `Unknown`.
+         */
+        refund(paymentToken: string, reason: RefundReason): Promise<PaymentState>;
+    };
+    plugin: {
+        /**
+         * Whether the plugin app is installed on this device.
+         *
+         * @throws AcceptError `NotInitialized`, `Unknown`.
+         */
+        isInstalled(): boolean;
+        /**
+         * Opens the plugin's store listing so the merchant can install it. Uses the organization's
+         * branded listing when one is configured and the SDK is authenticated.
+         *
+         * @throws AcceptError `NotInitialized`, `Unknown`.
+         */
+        install(): Promise<void>;
+        /**
+         * Runs the plugin's terminal activation flow and resolves when it finishes. Activation is
+         * required before the device can take card payments.
+         *
+         * @throws AcceptError `ActivationInProgress`, `NotAuthenticated`, `PluginUnavailable`,
+         *   `NoInternetConnection`, `NoTidsAvailableForMerchant`, `MerchantOnboardingIncomplete`,
+         *   `Unknown`.
+         */
+        activateTerminal(): Promise<ActivateTerminalResult>;
+        /**
+         * The plugin's current installed/authenticated/ready state.
+         *
+         * @throws AcceptError `NotInitialized`, `PluginUnavailable`, `PluginTimeout`, `Unknown`.
+         */
+        status(): Promise<PluginStatus>;
+        /**
+         * Whether a newer plugin build is available on Google Play. Call {@link install} to send the
+         * merchant to its listing.
+         *
+         * @throws AcceptError `NotInitialized`, `PluginUnavailable`, `PluginTimeout`, `Unknown`.
+         */
+        updateInfo(): Promise<PluginUpdateInfo>;
+        /**
+         * Logs the merchant out of the plugin app.
+         *
+         * @throws AcceptError `NotInitialized`, `PluginUnavailable`, `PluginTimeout`, `Unknown`.
+         */
+        logout(): Promise<void>;
+    };
+    displays: {
+        /** Every display the device currently reports, primary first. */
+        all(): AcceptDisplay[];
+        /**
+         * The customer-facing panel of a dual-sided device, or `null` on single-screen devices. This is
+         * what `{ type: 'customerFacing' }` targets.
+         */
+        customerFacing(): AcceptDisplay | null;
+        /** Whether a customer-facing display is available right now. */
+        readonly isDualScreen: boolean;
+    };
+    /**
+     * Initializes the SDK against sandbox or production. Must be called before any other surface is
+     * used — typically once, at app startup.
+     *
+     * Safe to call more than once; each call resets which environment subsequent requests target.
+     */
+    initialize(options?: InitializeOptions): void;
+    /** The SDK's current lifecycle state. */
+    readonly state: SdkState;
+    /**
+     * Subscribes to {@link state} transitions. The listener fires with the current state on
+     * subscription, then on every change.
+     */
+    addStateListener(listener: (state: SdkState) => void): AcceptSubscription;
+    /**
+     * Clears all locally persisted SDK state — auth token, device id, cached config, and theme — and
+     * resets {@link state} to `idle`. Call this on merchant logout.
+     *
+     * @throws AcceptError `Unknown`.
+     */
+    clear(): Promise<void>;
+    /**
+     * Enables or disables diagnostic logging. Shorthand for {@link setLogLevel}: `true` maps to
+     * `'DEBUG'`, `false` to `'NONE'`.
+     */
+    setDebugLoggingEnabled(enabled: boolean): void;
+    /**
+     * Sets the verbosity of diagnostic logging. Defaults to `'DEBUG'` against sandbox and `'NONE'`
+     * against production; call after {@link initialize} to override.
+     */
+    setLogLevel(level: AcceptLogLevel): void;
+    /**
+     * Routes SDK logs into `listener` instead of Logcat, for forwarding into your own logging stack.
+     * Pass `null` to restore the default Logcat sink.
+     */
+    setLogger(listener: ((entry: AcceptLogEntry) => void) | null): void;
+    /**
+     * Sets the branding applied to the plugin's activation, status, and payment screens.
+     *
+     * Session-wide, not per payment: it persists until changed or cleared with `null`. Pushed to the
+     * plugin opportunistically the next time it is bound or launched, so there is no confirmation
+     * that it was applied — the plugin may not be installed or running yet.
+     */
+    setTheme(theme: AcceptTheme | null): void;
+    /**
+     * The theme currently set via {@link setTheme}, or `null`. Reflects local SDK state only, not
+     * whether the plugin applied it.
+     */
+    getTheme(): AcceptTheme | null;
+    /**
+     * Stores `base64` image data in SDK-private storage and returns a `content://` URL the plugin can
+     * read — for a logo the host app holds locally rather than at a stable URL. Use the result
+     * anywhere an {@link AcceptTheme} image field takes a URL.
+     *
+     * `assetToBase64` from `@tapayadot/accept-react-native/utils` turns a `require('./logo.png')`
+     * into the expected string.
+     *
+     * @param fileExtension the extension to store the data under, without a leading dot. Tells the
+     *   plugin how to decode it; defaults to `'png'`.
+     * @throws AcceptError `NotInitialized`.
+     */
+    createLocalThemeImageUri(base64: string, fileExtension?: string): string;
+};
+//# sourceMappingURL=Accept.d.ts.map

package/build/Accept.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Accept.d.ts","sourceRoot":"","sources":["../src/Accept.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,cAAc,EACd,cAAc,EACd,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACT,MAAM,gBAAgB,CAAC;AAsTxB;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,MAAM;;QAnTjB;;;;;WAKG;oCACyB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;;;QASlD,iGAAiG;0BAClF,MAAM;QAIrB;;;;WAIG;+BACiB,OAAO;QAI3B;;;;;;WAMG;oBACS,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;QAIlC;;;;WAIG;0BACe,OAAO,CAAC,aAAa,EAAE,CAAC;;;QAS1C;;;;WAIG;gBACK,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;QAI3C;;;;WAIG;kBACO,OAAO,CAAC,cAAc,CAAC;QAIjC;;;;WAIG;4BACiB,OAAO,CAAC,gBAAgB,CAAC;QAI7C;;;;WAIG;+BACoB,OAAO,CAAC,MAAM,EAAE,CAAC;;;QASxC;;;;;;WAMG;4BACiB,cAAc,GAAG,IAAI;QAIzC;;;;;;;;;;;;;;;;WAgBG;qBAEQ,cAAc,YACb,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GACtC,mBAAmB;QAqBtB;;;;;;;WAOG;0BACe,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;QAUrD;;;;;WAKG;6BACkB,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;QAIpD;;;;;;WAMG;6BACkB,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;QAInD;;;;;;WAMG;6BACkB,MAAM,UAAU,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;;;QASzE;;;;WAIG;uBACY,OAAO;QAItB;;;;;WAKG;mBACQ,OAAO,CAAC,IAAI,CAAC;QAIxB;;;;;;;WAOG;4BACiB,OAAO,CAAC,sBAAsB,CAAC;QAInD;;;;WAIG;kBACO,OAAO,CAAC,YAAY,CAAC;QAI/B;;;;;WAKG;sBACW,OAAO,CAAC,gBAAgB,CAAC;QAIvC;;;;WAIG;kBACO,OAAO,CAAC,IAAI,CAAC;;;QAYvB,iEAAiE;eAC1D,aAAa,EAAE;QAItB;;;WAGG;0BACe,aAAa,GAAG,IAAI;QAItC,gEAAgE;+BAC5C,OAAO;;IAgC3B;;;;;OAKG;yBACiB,iBAAiB,GAAQ,IAAI;IAIjD,yCAAyC;oBAC5B,QAAQ;IAIrB;;;OAGG;+BACwB,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,kBAAkB;IAIzE;;;;;OAKG;aACM,OAAO,CAAC,IAAI,CAAC;IAItB;;;OAGG;oCAC6B,OAAO,GAAG,IAAI;IAI9C;;;OAGG;uBACgB,cAAc,GAAG,IAAI;IAIxC;;;OAGG;wBACiB,CAAC,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAMnE;;;;;;OAMG;oBACa,WAAW,GAAG,IAAI,GAAG,IAAI;IAIzC;;;OAGG;gBACS,WAAW,GAAG,IAAI;IAI9B;;;;;;;;;;;OAWG;qCAEO,MAAM,kBACC,MAAM,GACpB,MAAM;CAKV,CAAC"}

package/build/Accept.js

@@ -0,0 +1,387 @@
+import { mapErrors, mapErrorsSync, toAcceptError } from "./AcceptError";
+import Native from "./AcceptSdkReactNativeModule";
+/**
+ * Correlates a `pay()` call with its events. Monotonic within a JavaScript context, which is all
+ * that is needed: the native side only ever routes an event back to the caller that started it.
+ */
+let nextRequestId = 0;
+const newRequestId = () => `pay-${++nextRequestId}`;
+/** A payment event that ends the stream. */
+const isTerminal = (event) => event.type === "result" || event.type === "creationFailed";
+/**
+ * Authentication surface. Mirrors `Accept.auth`.
+ */
+const auth = {
+    /**
+     * Authenticates the SDK for the merchant identified by `merchantToken`. Must succeed before
+     * {@link merchant} or {@link payments} can be used.
+     *
+     * @throws AcceptError `NotInitialized`, `NoInternetConnection`, `Unknown`.
+     */
+    authenticate(merchantToken) {
+        return mapErrors(() => Native.authenticate(merchantToken));
+    },
+};
+/**
+ * SDK-level configuration and diagnostics. Mirrors `Accept.sdk`.
+ */
+const sdk = {
+    /** The version of the Accept SDK for Android bundled in this build. Safe before `initialize`. */
+    get version() {
+        return Native.getSdkVersion();
+    },
+    /**
+     * Whether the SDK was initialized against production.
+     *
+     * @throws AcceptError `NotInitialized`.
+     */
+    get isProduction() {
+        return mapErrorsSync(() => Native.isProduction());
+    },
+    /**
+     * This device's stable identifier, assigned on the first successful
+     * {@link auth.authenticate} and retained until the app is uninstalled.
+     *
+     * @returns the device id, or `null` before the first authentication.
+     * @throws AcceptError `NotInitialized`, `Unknown`.
+     */
+    deviceId() {
+        return mapErrors(() => Native.getDeviceId());
+    },
+    /**
+     * The minimum payable amount per supported currency.
+     *
+     * @throws AcceptError `NotInitialized`, `NoInternetConnection`, `Unknown`.
+     */
+    minimumAmounts() {
+        return mapErrors(() => Native.getMinimumAmounts());
+    },
+};
+/**
+ * Merchant profile and onboarding. Mirrors `Accept.merchant`. Requires {@link auth.authenticate}.
+ */
+const merchant = {
+    /**
+     * The merchant's business profile, or `null` if onboarding hasn't been submitted yet.
+     *
+     * @throws AcceptError `NotAuthenticated`, `NoInternetConnection`, `Unknown`.
+     */
+    info() {
+        return mapErrors(() => Native.getMerchantInfo());
+    },
+    /**
+     * The merchant's payment configuration.
+     *
+     * @throws AcceptError `NotAuthenticated`, `NoInternetConnection`, `Unknown`.
+     */
+    config() {
+        return mapErrors(() => Native.getMerchantConfig());
+    },
+    /**
+     * Whether the merchant is ready to accept payments, or what is blocking it.
+     *
+     * @throws AcceptError `NotAuthenticated`, `NoInternetConnection`, `Unknown`.
+     */
+    onboardingStatus() {
+        return mapErrors(() => Native.getOnboardingStatus());
+    },
+    /**
+     * The currency codes the merchant accepts. Shorthand for `config().availableCurrencies`.
+     *
+     * @throws AcceptError `NotAuthenticated`, `NoInternetConnection`, `Unknown`.
+     */
+    availableCurrencies() {
+        return mapErrors(() => Native.getAvailableCurrencies());
+    },
+};
+/**
+ * Payments. Mirrors `Accept.payments`. Requires {@link auth.authenticate}.
+ */
+const payments = {
+    /**
+     * Sets the defaults applied to payments that don't override them on {@link pay}.
+     *
+     * Only the keys present are changed, so one option can be set without disturbing the others.
+     * `display` is also what the terminal warm-up fired by {@link auth.authenticate} follows — set it
+     * before authenticating to keep the warm-up off the merchant's screen.
+     */
+    setOptions(options) {
+        Native.setPaymentOptions(options);
+    },
+    /**
+     * Launches the plugin's payment flow and streams its lifecycle to `listener`.
+     *
+     * Never throws: a failure to create the payment arrives as a `creationFailed` event carrying an
+     * {@link AcceptError}. The stream ends after `result` or `creationFailed`, at which point the
+     * subscription removes itself.
+     *
+     * ```ts
+     * Accept.payments.pay({ amount: 1000, currency: 'USD' }, (event) => {
+     *   if (event.type === 'result' && event.payResult.type === 'success') {
+     *     console.log(event.payResult.paymentToken);
+     *   }
+     * });
+     * ```
+     *
+     * @returns a handle that stops delivering events; see {@link PaymentSubscription.remove}.
+     */
+    pay(request, listener) {
+        const requestId = newRequestId();
+        let removed = false;
+        const subscription = Native.addListener("onPaymentEvent", (payload) => {
+            if (payload.requestId !== requestId)
+                return;
+            if (isTerminal(payload.event))
+                remove();
+            listener(payload.event);
+        });
+        const remove = () => {
+            if (removed)
+                return;
+            removed = true;
+            subscription.remove();
+            Native.stopPaymentEvents(requestId);
+        };
+        Native.startPayment(requestId, request);
+        return { remove };
+    },
+    /**
+     * {@link pay} reduced to its outcome, for callers that don't render the intermediate states.
+     *
+     * @returns the terminal {@link PayResult}.
+     * @throws AcceptError whatever the payment would have reported as `creationFailed` — including
+     *   `PaymentInProgress`, `NotAuthenticated`, `PluginNotReadyForPayments`, `AmountBelowMinimum`,
+     *   and `LocationPermissionRequired`.
+     */
+    payAsync(request) {
+        return new Promise((resolve, reject) => {
+            payments.pay(request, (event) => {
+                if (event.type === "result")
+                    resolve(event.payResult);
+                else if (event.type === "creationFailed")
+                    reject(toAcceptError(event.error));
+            });
+        });
+    },
+    /**
+     * The current status of the payment identified by `paymentToken`.
+     *
+     * @throws AcceptError `NotAuthenticated`, `SessionExpired`, `PaymentNotFound`,
+     *   `NoInternetConnection`, `Unknown`.
+     */
+    status(paymentToken) {
+        return mapErrors(() => Native.getPaymentStatus(paymentToken));
+    },
+    /**
+     * Cancels the payment identified by `paymentToken`.
+     *
+     * @returns the resulting {@link PaymentState}.
+     * @throws AcceptError `NotAuthenticated`, `SessionExpired`, `PaymentNotFound`,
+     *   `NoInternetConnection`, `Unknown`.
+     */
+    cancel(paymentToken) {
+        return mapErrors(() => Native.cancelPayment(paymentToken));
+    },
+    /**
+     * Refunds the payment identified by `paymentToken`.
+     *
+     * @returns the resulting {@link PaymentState}.
+     * @throws AcceptError `NotAuthenticated`, `SessionExpired`, `PaymentNotFound`,
+     *   `NoInternetConnection`, `Unknown`.
+     */
+    refund(paymentToken, reason) {
+        return mapErrors(() => Native.refundPayment(paymentToken, reason));
+    },
+};
+/**
+ * The Accept plugin app — the companion that drives the physical terminal. Mirrors `Accept.plugin`.
+ */
+const plugin = {
+    /**
+     * Whether the plugin app is installed on this device.
+     *
+     * @throws AcceptError `NotInitialized`, `Unknown`.
+     */
+    isInstalled() {
+        return mapErrorsSync(() => Native.isPluginInstalled());
+    },
+    /**
+     * Opens the plugin's store listing so the merchant can install it. Uses the organization's
+     * branded listing when one is configured and the SDK is authenticated.
+     *
+     * @throws AcceptError `NotInitialized`, `Unknown`.
+     */
+    install() {
+        return mapErrors(() => Native.installPlugin());
+    },
+    /**
+     * Runs the plugin's terminal activation flow and resolves when it finishes. Activation is
+     * required before the device can take card payments.
+     *
+     * @throws AcceptError `ActivationInProgress`, `NotAuthenticated`, `PluginUnavailable`,
+     *   `NoInternetConnection`, `NoTidsAvailableForMerchant`, `MerchantOnboardingIncomplete`,
+     *   `Unknown`.
+     */
+    activateTerminal() {
+        return mapErrors(() => Native.activateTerminal());
+    },
+    /**
+     * The plugin's current installed/authenticated/ready state.
+     *
+     * @throws AcceptError `NotInitialized`, `PluginUnavailable`, `PluginTimeout`, `Unknown`.
+     */
+    status() {
+        return mapErrors(() => Native.getPluginStatus());
+    },
+    /**
+     * Whether a newer plugin build is available on Google Play. Call {@link install} to send the
+     * merchant to its listing.
+     *
+     * @throws AcceptError `NotInitialized`, `PluginUnavailable`, `PluginTimeout`, `Unknown`.
+     */
+    updateInfo() {
+        return mapErrors(() => Native.getPluginUpdateInfo());
+    },
+    /**
+     * Logs the merchant out of the plugin app.
+     *
+     * @throws AcceptError `NotInitialized`, `PluginUnavailable`, `PluginTimeout`, `Unknown`.
+     */
+    logout() {
+        return mapErrors(() => Native.logoutPlugin());
+    },
+};
+/**
+ * Screen topology, for dual-sided POS hardware. Mirrors `Accept.displays`.
+ *
+ * Every member reads the platform live, so a display hot-plugged or powered off between calls is
+ * reflected immediately. None of them throw.
+ */
+const displays = {
+    /** Every display the device currently reports, primary first. */
+    all() {
+        return Native.getDisplays();
+    },
+    /**
+     * The customer-facing panel of a dual-sided device, or `null` on single-screen devices. This is
+     * what `{ type: 'customerFacing' }` targets.
+     */
+    customerFacing() {
+        return Native.getCustomerFacingDisplay();
+    },
+    /** Whether a customer-facing display is available right now. */
+    get isDualScreen() {
+        return Native.isDualScreen();
+    },
+};
+/** The listener currently receiving forwarded SDK logs, if any. */
+let logSubscription = null;
+/**
+ * Entry point to the Accept SDK. Mirrors the `Accept` object in the Accept SDK for Android, so the
+ * Android reference documentation applies unchanged.
+ *
+ * ```ts
+ * import Accept from '@tapayadot/accept-react-native';
+ *
+ * Accept.initialize({ isProduction: false });
+ * await Accept.auth.authenticate(merchantToken);
+ *
+ * if (!Accept.plugin.isInstalled()) await Accept.plugin.install();
+ * await Accept.plugin.activateTerminal();
+ *
+ * const result = await Accept.payments.payAsync({ amount: 1000, currency: 'USD' });
+ * ```
+ */
+export const Accept = {
+    auth,
+    sdk,
+    merchant,
+    payments,
+    plugin,
+    displays,
+    /**
+     * Initializes the SDK against sandbox or production. Must be called before any other surface is
+     * used — typically once, at app startup.
+     *
+     * Safe to call more than once; each call resets which environment subsequent requests target.
+     */
+    initialize(options = {}) {
+        Native.initialize(options.isProduction ?? false);
+    },
+    /** The SDK's current lifecycle state. */
+    get state() {
+        return Native.getState();
+    },
+    /**
+     * Subscribes to {@link state} transitions. The listener fires with the current state on
+     * subscription, then on every change.
+     */
+    addStateListener(listener) {
+        return Native.addListener("onStateChange", ({ state }) => listener(state));
+    },
+    /**
+     * Clears all locally persisted SDK state — auth token, device id, cached config, and theme — and
+     * resets {@link state} to `idle`. Call this on merchant logout.
+     *
+     * @throws AcceptError `Unknown`.
+     */
+    clear() {
+        return mapErrors(() => Native.clear());
+    },
+    /**
+     * Enables or disables diagnostic logging. Shorthand for {@link setLogLevel}: `true` maps to
+     * `'DEBUG'`, `false` to `'NONE'`.
+     */
+    setDebugLoggingEnabled(enabled) {
+        Native.setDebugLoggingEnabled(enabled);
+    },
+    /**
+     * Sets the verbosity of diagnostic logging. Defaults to `'DEBUG'` against sandbox and `'NONE'`
+     * against production; call after {@link initialize} to override.
+     */
+    setLogLevel(level) {
+        Native.setLogLevel(level);
+    },
+    /**
+     * Routes SDK logs into `listener` instead of Logcat, for forwarding into your own logging stack.
+     * Pass `null` to restore the default Logcat sink.
+     */
+    setLogger(listener) {
+        logSubscription?.remove();
+        logSubscription = listener ? Native.addListener("onLog", listener) : null;
+        Native.setLogForwardingEnabled(listener !== null);
+    },
+    /**
+     * Sets the branding applied to the plugin's activation, status, and payment screens.
+     *
+     * Session-wide, not per payment: it persists until changed or cleared with `null`. Pushed to the
+     * plugin opportunistically the next time it is bound or launched, so there is no confirmation
+     * that it was applied — the plugin may not be installed or running yet.
+     */
+    setTheme(theme) {
+        Native.setTheme(theme);
+    },
+    /**
+     * The theme currently set via {@link setTheme}, or `null`. Reflects local SDK state only, not
+     * whether the plugin applied it.
+     */
+    getTheme() {
+        return Native.getTheme();
+    },
+    /**
+     * Stores `base64` image data in SDK-private storage and returns a `content://` URL the plugin can
+     * read — for a logo the host app holds locally rather than at a stable URL. Use the result
+     * anywhere an {@link AcceptTheme} image field takes a URL.
+     *
+     * `assetToBase64` from `@tapayadot/accept-react-native/utils` turns a `require('./logo.png')`
+     * into the expected string.
+     *
+     * @param fileExtension the extension to store the data under, without a leading dot. Tells the
+     *   plugin how to decode it; defaults to `'png'`.
+     * @throws AcceptError `NotInitialized`.
+     */
+    createLocalThemeImageUri(base64, fileExtension = "png") {
+        return mapErrorsSync(() => Native.createLocalThemeImageUri(base64, fileExtension));
+    },
+};
+//# sourceMappingURL=Accept.js.map