@a-cube-io/ereceipts-js-sdk 2.0.7 → 2.0.8

package/dist/react.d.ts

@@ -1,1615 +0,0 @@
-import * as React from 'react';
-import { AxiosRequestConfig, AxiosInstance } from 'axios';
-
-/**
- * Role and Permission Management System
- *
- * This module provides type-safe role management with hierarchical permissions
- * and context-based authorization for the ACube E-Receipt system.
- */
-type BaseRole = 'ROLE_SUPPLIER' | 'ROLE_CASHIER' | 'ROLE_MERCHANT';
-type RoleContext = 'ereceipts-it.acubeapi.com';
-type UserRoles = Partial<Record<RoleContext, BaseRole[]>>;
-
-/**
- * Core SDK types
- */
-
-type Environment = 'production' | 'development' | 'sandbox';
-/**
- * Certificate management configuration
- */
-interface CertificateConfig {
-    storagePrefix?: string;
-    metadataKey?: string;
-}
-/**
- * SDK Configuration
- */
-interface SDKConfig {
-    environment: Environment;
-    apiUrl?: string;
-    authUrl?: string;
-    timeout?: number;
-    retryAttempts?: number;
-    debug?: boolean;
-    customHeaders?: Record<string, string>;
-    certificateConfig?: CertificateConfig;
-}
-/**
- * Authentication credentials
- */
-interface AuthCredentials {
-    email: string;
-    password: string;
-}
-/**
- * User information
- */
-interface User {
-    id: string;
-    email: string;
-    username: string;
-    roles: UserRoles;
-    fid: string;
-    pid: string | null;
-    expiresAt: number;
-}
-/**
- * User provider interface for accessing current user information
- */
-interface IUserProvider {
-    getCurrentUser(): Promise<User | null>;
-    isAuthenticated(): Promise<boolean>;
-    getAccessToken(): Promise<string | null>;
-}
-/**
- * API Violation structure for validation errors
- */
-interface APIViolation {
-    propertyPath: string;
-    message: string;
-}
-/**
- * SDK Error types
- */
-type SDKError = 'NETWORK_ERROR' | 'AUTH_ERROR' | 'VALIDATION_ERROR' | 'NOT_FOUND_ERROR' | 'FORBIDDEN_ERROR' | 'UNKNOWN_ERROR' | 'STORAGE_CERTIFICATE_ERROR' | 'CERTIFICATE_MANAGER_NOT_INITIALIZED' | 'SDK_INITIALIZATION_ERROR' | 'API_CLIENT_NOT_INITIALIZED' | 'MTLS_ADAPTER_NOT_AVAILABLE' | 'CERTIFICATE_INFO_ERROR';
-/**
- * SDK Exception class
- */
-declare class ACubeSDKError extends Error {
-    type: SDKError;
-    originalError?: unknown | undefined;
-    statusCode?: number | undefined;
-    violations?: APIViolation[];
-    constructor(type: SDKError, message: string, originalError?: unknown | undefined, statusCode?: number | undefined, violations?: APIViolation[]);
-}
-
-/**
- * SDK Configuration manager
- */
-declare class ConfigManager {
-    private config;
-    constructor(userConfig: SDKConfig);
-    private mergeConfig;
-    private getDefaultApiUrl;
-    private getDefaultAuthUrl;
-    /**
-     * Get the current configuration
-     */
-    getConfig(): Required<SDKConfig>;
-    /**
-     * Get API URL
-     */
-    getApiUrl(): string;
-    /**
-     * Get Auth URL
-     */
-    getAuthUrl(): string;
-    /**
-     * Get environment
-     */
-    getEnvironment(): Environment;
-    /**
-     * Check if debug mode is enabled
-     */
-    isDebugEnabled(): boolean;
-    /**
-     * Get timeout in milliseconds
-     */
-    getTimeout(): number;
-    /**
-     * Get retry attempts
-     */
-    getRetryAttempts(): number;
-    /**
-     * Get custom headers
-     */
-    getCustomHeaders(): Record<string, string>;
-    /**
-     * Update configuration
-     */
-    updateConfig(updates: Partial<SDKConfig>): void;
-}
-
-interface ICachePort {
-    get<T>(key: string): Promise<CachedItem<T> | null>;
-    set<T>(key: string, data: T): Promise<void>;
-    setItem<T>(key: string, item: CachedItem<T>): Promise<void>;
-    setBatch<T>(items: Array<[string, CachedItem<T>]>): Promise<void>;
-    invalidate(pattern: string): Promise<void>;
-    clear(): Promise<void>;
-    getSize(): Promise<CacheSize>;
-    cleanup(): Promise<number>;
-    getKeys(pattern?: string): Promise<string[]>;
-}
-interface CachedItem<T> {
-    data: T;
-    timestamp: number;
-    compressed?: boolean;
-}
-interface CacheSize {
-    entries: number;
-    bytes: number;
-    lastCleanup: number;
-}
-
-interface CertificateData {
-    certificate: string;
-    privateKey: string;
-    format: 'PEM' | 'P12';
-    password?: string;
-}
-interface MTLSConnectionConfig {
-    baseUrl: string;
-    port?: number;
-    timeout?: number;
-    validateCertificate?: boolean;
-}
-interface MTLSRequestConfig {
-    url: string;
-    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
-    headers?: Record<string, string>;
-    data?: unknown;
-    timeout?: number;
-    responseType?: 'json' | 'blob' | 'arraybuffer' | 'text';
-}
-interface MTLSResponse<T = unknown> {
-    data: T;
-    status: number;
-    statusText: string;
-    headers: Record<string, string>;
-}
-interface CertificateInfo {
-    subject: string;
-    issuer: string;
-    validFrom: Date;
-    validTo: Date;
-    serialNumber: string;
-    fingerprint: string;
-    pemId: string;
-    cashRegisterUUID: string;
-}
-interface IMTLSPort {
-    isMTLSSupported(): Promise<boolean>;
-    initialize(config: MTLSConnectionConfig): Promise<void>;
-    configureCertificate(certificateData: CertificateData): Promise<void>;
-    hasCertificate(): Promise<boolean>;
-    getCertificateInfo(): Promise<CertificateInfo | null>;
-    request<T>(config: MTLSRequestConfig): Promise<MTLSResponse<T>>;
-    testConnection(): Promise<boolean>;
-    removeCertificate(): Promise<void>;
-    getBaseUrl(): string | null;
-    getPlatformInfo(): {
-        platform: 'react-native' | 'node' | 'web' | 'expo';
-        mtlsSupported: boolean;
-        certificateStorage: 'keychain' | 'keystore' | 'filesystem' | 'browser-managed' | 'memory';
-        fallbackToJWT: boolean;
-    };
-}
-
-interface INetworkPort {
-    isOnline(): boolean;
-    onStatusChange(callback: (online: boolean) => void): () => void;
-    getNetworkInfo(): Promise<NetworkInfo | null>;
-}
-interface NetworkInfo {
-    type: 'wifi' | 'cellular' | 'ethernet' | 'unknown';
-    effectiveType?: '2g' | '3g' | '4g' | '5g';
-    downlink?: number;
-    rtt?: number;
-}
-
-interface IStoragePort {
-    get(key: string): Promise<string | null>;
-    set(key: string, value: string): Promise<void>;
-    remove(key: string): Promise<void>;
-    clear(): Promise<void>;
-    getAllKeys(): Promise<string[]>;
-    multiGet(keys: string[]): Promise<Record<string, string | null>>;
-    multiSet(items: Record<string, string>): Promise<void>;
-    multiRemove(keys: string[]): Promise<void>;
-}
-interface ISecureStoragePort extends IStoragePort {
-    isAvailable(): Promise<boolean>;
-    getSecurityLevel(): Promise<string>;
-}
-
-/**
- * Platform adapters collection
- */
-interface PlatformAdapters {
-    storage: IStoragePort;
-    secureStorage: ISecureStoragePort;
-    networkMonitor: INetworkPort;
-    cache?: ICachePort;
-    mtls?: IMTLSPort;
-}
-
-/**
- * Generated API types from OpenAPI spec
- */
-interface Page<T> {
-    members: T[];
-    total?: number;
-    page?: number;
-    size?: number;
-    pages?: number;
-}
-interface LdJsonPage<T> {
-    member: T[];
-    totalItems?: number;
-    view?: {
-        '@id': string;
-        type?: string;
-        first?: string;
-        last?: string;
-        previous?: string;
-        next?: string;
-    };
-}
-interface CashierCreateInput {
-    email: string;
-    password: string;
-    name: string;
-    display_name: string;
-}
-interface CashierOutput {
-    uuid: string;
-    merchant_uuid: string;
-    display_name: string;
-    email: string;
-    name: string;
-}
-interface CashierListParams {
-    page?: number;
-    size?: number;
-}
-type PEMStatus = 'NEW' | 'REGISTERED' | 'ACTIVATED' | 'ONLINE' | 'OFFLINE' | 'DISCARDED';
-interface Address {
-    street_address: string;
-    street_number: string;
-    zip_code: string;
-    city: string;
-    province: string;
-}
-type PointOfSaleMf2Type = 'AP' | 'SP' | 'TM' | 'PV';
-interface PointOfSaleOutputMf2 {
-    id: string;
-    status: PEMStatus;
-    type: PointOfSaleMf2Type;
-}
-interface PointOfSaleOutput {
-    serial_number: string;
-    status: PEMStatus;
-    address: Address;
-    operational_status: string;
-}
-interface PointOfSaleListParams {
-    status?: PEMStatus;
-    page?: number;
-    size?: number;
-}
-interface PointOfSaleDetailedOutput {
-    serial_number: string;
-    status: PEMStatus;
-    address: Address;
-    registration_key?: string;
-    operational_status: string;
-}
-interface ActivationRequest {
-    registration_key: string;
-}
-interface PEMStatusOfflineRequest {
-    timestamp: string;
-    reason: string;
-}
-interface PointOfSaleUpdateInput {
-    address?: Address;
-}
-type ReceiptType = 'sale' | 'return' | 'void';
-type GoodOrService = 'goods' | 'service';
-type VatRateCode = '4.00' | '5.00' | '10.00' | '22.00' | '2.00' | '6.40' | '7.00' | '7.30' | '7.50' | '7.65' | '7.95' | '8.30' | '8.50' | '8.80' | '9.50' | '12.30' | 'N1' | 'N2' | 'N3' | 'N4' | 'N5' | 'N6';
-interface ReceiptItem {
-    type?: GoodOrService;
-    quantity: string;
-    description: string;
-    unit_price: string;
-    vat_rate_code?: VatRateCode;
-    simplified_vat_allocation?: boolean;
-    discount?: string;
-    is_down_payment_or_voucher_redemption?: boolean;
-    complimentary?: boolean;
-}
-interface ReceiptReturnItem {
-    id: number;
-    quantity: string;
-}
-interface ReceiptInput {
-    items: ReceiptItem[];
-    customer_tax_code?: string;
-    customer_lottery_code?: string;
-    discount?: string;
-    invoice_issuing?: boolean;
-    uncollected_dcr_to_ssn?: boolean;
-    services_uncollected_amount?: string;
-    goods_uncollected_amount?: string;
-    cash_payment_amount?: string;
-    electronic_payment_amount?: string;
-    ticket_restaurant_payment_amount?: string;
-    ticket_restaurant_quantity?: number;
-}
-interface ReceiptOutput {
-    uuid: string;
-    type: ReceiptType;
-    created_at: string;
-    total_amount: string;
-    document_number: string;
-    document_datetime?: string;
-    is_returnable: boolean;
-    is_voidable: boolean;
-    pdf_url?: string;
-    parent_receipt_uuid?: string;
-}
-interface ReceiptDetailsOutput {
-    uuid: string;
-    type: ReceiptType;
-    customer_lottery_code?: string;
-    created_at: string;
-    total_amount: string;
-    document_number?: string;
-    document_datetime?: string;
-    vat_number: string;
-    total_taxable_amount: string;
-    total_uncollected_amount: string;
-    deductible_amount: string;
-    total_vat_amount: string;
-    total_discount: string;
-    total_gross_discount: string;
-    discount: string;
-    is_returnable: boolean;
-    is_voidable: boolean;
-    pdf_url?: string;
-    parent_receipt_uuid?: string;
-    items?: ReceiptItem[];
-}
-interface VoidReceiptInput {
-    document_number: string;
-}
-interface ReceiptReturnInput {
-    items: ReceiptReturnItem[];
-    document_number: string;
-}
-interface ReturnableReceiptItem {
-    id: number;
-    type?: GoodOrService;
-    quantity: string;
-    returned_quantity: string;
-    description: string;
-    unit_price: string;
-    vat_rate_code?: VatRateCode;
-}
-interface ReceiptReturnOrVoidViaPEMInput {
-    pos_id?: string;
-    items: ReceiptItem[];
-    document_number: string;
-    document_datetime?: string;
-    lottery_code?: string;
-}
-type ReceiptProofType = 'POS' | 'VR' | 'ND';
-declare const RECEIPT_READY = "ready";
-declare const RECEIPT_SENT = "sent";
-type ReceiptStatus = typeof RECEIPT_READY | typeof RECEIPT_SENT;
-declare const RECEIPT_SORT_DESCENDING = "descending";
-declare const RECEIPT_SORT_ASCENDING = "ascending";
-type ReceiptSortOrder = typeof RECEIPT_SORT_DESCENDING | typeof RECEIPT_SORT_ASCENDING;
-interface ReceiptListParams {
-    serial_number: string;
-    page?: number;
-    size?: number;
-    status?: ReceiptStatus;
-    sort?: ReceiptSortOrder;
-    document_number?: string;
-    'document_datetime[before]'?: string;
-    'document_datetime[after]'?: string | null;
-}
-interface ReceiptReturnOrVoidWithProofInput {
-    items: ReceiptItem[];
-    proof: ReceiptProofType;
-    document_datetime: string;
-}
-interface CashRegisterCreate {
-    pem_serial_number: string;
-    name: string;
-}
-interface CashRegisterBasicOutput {
-    uuid: string;
-    pem_serial_number: string;
-    name: string;
-}
-interface CashRegisterDetailedOutput {
-    uuid: string;
-    pem_serial_number: string;
-    name: string;
-    mtls_certificate: string;
-    private_key: string;
-}
-interface CashRegisterListParams {
-    page?: number;
-    size?: number;
-    serial_number?: string;
-}
-interface MerchantOutput {
-    uuid: string;
-    vat_number: string;
-    fiscal_code?: string | null;
-    email: string;
-    business_name?: string | null;
-    first_name?: string | null;
-    last_name?: string | null;
-    address?: Address;
-}
-interface MerchantsParams {
-    page?: number;
-}
-interface MerchantCreateInput {
-    vat_number: string;
-    fiscal_code?: string;
-    business_name?: string | null;
-    first_name?: string | null;
-    last_name?: string | null;
-    email: string;
-    password: string;
-    address?: Address;
-}
-interface MerchantUpdateInput {
-    business_name?: string | null;
-    first_name?: string | null;
-    last_name?: string | null;
-    address?: Address | null;
-}
-interface PemCreateInput {
-    merchant_uuid: string;
-    address?: Address;
-}
-interface PemCreateOutput {
-    serial_number: string;
-    registration_key: string;
-}
-interface PemCertificatesOutput {
-    mtls_certificate: string;
-    activation_xml_response?: string;
-}
-interface SupplierOutput {
-    uuid: string;
-    fiscal_id: string;
-    name: string;
-    address?: Address;
-}
-interface SuppliersParams {
-    page?: number;
-}
-interface SupplierCreateInput {
-    fiscal_id: string;
-    name: string;
-    address?: Address;
-}
-interface SupplierUpdateInput {
-    name: string;
-    address?: Address;
-}
-interface DailyReportOutput {
-    uuid: string;
-    pem_serial_number: string;
-    date: string;
-    total_receipts: number;
-    total_amount: string;
-    status: 'pending' | 'sent' | 'error';
-}
-interface DailyReportsParams {
-    pem_serial_number?: string;
-    date_from?: string;
-    date_to?: string;
-    status?: 'pending' | 'sent' | 'error';
-    page?: number;
-}
-interface JournalOutput {
-    uuid: string;
-    pem_serial_number: string;
-    date: string;
-    sequence_number: number;
-    total_receipts: number;
-    total_amount: string;
-    status: 'open' | 'closed';
-}
-interface JournalsParams {
-    pem_serial_number?: string;
-    status?: 'open' | 'closed';
-    date_from?: string;
-    date_to?: string;
-    page?: number;
-}
-
-/**
- * Single certificate data structure - Essential fields only
- */
-interface StoredCertificate {
-    certificate: string;
-    privateKey: string;
-    format: 'pem' | 'p12' | 'pkcs12';
-}
-/**
- * Certificate storage options - Only format is configurable
- */
-interface CertificateOptions {
-    format?: 'pem' | 'p12' | 'pkcs12';
-}
-/**
- * Certificate manager configuration
- */
-interface CertificateManagerConfig {
-    storageKey?: string;
-}
-/**
- * Simplified Certificate Manager - Supports only ONE certificate per device
- *
- * Key behaviors:
- * - Installing a new certificate automatically removes the existing one
- * - No certificate IDs needed - there's only one
- * - Much simpler API and storage
- */
-declare class CertificateManager {
-    private storage;
-    private storageKey;
-    private isDebugEnabled;
-    constructor(storage: ISecureStoragePort, config?: CertificateManagerConfig, debugEnabled?: boolean);
-    /**
-     * Store a certificate (replaces any existing certificate)
-     */
-    storeCertificate(certificate: string, privateKey: string, options?: CertificateOptions): Promise<void>;
-    /**
-     * Get the stored certificate (returns null if none exists)
-     */
-    getCertificate(): Promise<StoredCertificate | null>;
-    /**
-     * Check if a certificate is stored
-     */
-    hasCertificate(): Promise<boolean>;
-    /**
-     * Remove the stored certificate
-     */
-    clearCertificate(): Promise<void>;
-    /**
-     * Get certificate information without exposing a private key
-     */
-    getCertificateInfo(): Promise<{
-        format: string;
-    } | null>;
-}
-
-/**
- * Simplified authentication modes
- */
-type AuthMode = 'jwt' | 'mtls' | 'auto';
-
-/**
- * Simplified cache request configuration
- * Cache behavior: Online = always fetch fresh data, Offline = always use cache
- */
-interface CacheConfig {
-    /** Whether to use cache for this request (default: true if cache available) */
-    useCache?: boolean;
-}
-
-/**
- * Extended request configuration with simplified cache and mTLS options
- */
-interface HttpRequestConfig extends AxiosRequestConfig, CacheConfig {
-    /** Authentication mode for this request */
-    authMode?: AuthMode;
-    /** Skip mTLS fallback to JWT */
-    noFallback?: boolean;
-}
-
-/**
- * Simplified HTTP client with mTLS and caching support
- */
-declare class HttpClient {
-    private config;
-    private client;
-    private mtlsHandler;
-    private cacheHandler;
-    private certificateManager;
-    private mtlsAdapter;
-    private userProvider;
-    private _isDebugEnabled;
-    constructor(config: ConfigManager, certificateManager?: CertificateManager, cache?: ICachePort, networkMonitor?: INetworkPort, mtlsAdapter?: IMTLSPort, userProvider?: IUserProvider);
-    private createClient;
-    /**
-     * Set authorization header
-     */
-    setAuthorizationHeader(token: string): void;
-    /**
-     * Remove authorization header
-     */
-    removeAuthorizationHeader(): void;
-    /**
-     * Extract mTLS-compatible config from HttpRequestConfig
-     */
-    private extractMTLSConfig;
-    /**
-     * Execute request with consistent error handling
-     * Eliminates duplicate try-catch blocks across all HTTP methods
-     */
-    private executeRequest;
-    /**
-     * Get current network status
-     */
-    getNetworkStatus(): {
-        isOnline: boolean;
-        hasMonitor: boolean;
-    };
-    /**
-     * Check if currently online
-     */
-    isOnline(): boolean;
-    /**
-     * GET request with authentication and caching support
-     */
-    get<T>(url: string, config?: HttpRequestConfig): Promise<T>;
-    /**
-     * POST request with authentication support
-     */
-    post<T>(url: string, data?: unknown, config?: HttpRequestConfig): Promise<T>;
-    /**
-     * PUT request with authentication support
-     */
-    put<T>(url: string, data?: unknown, config?: HttpRequestConfig): Promise<T>;
-    /**
-     * DELETE request with authentication support
-     */
-    delete<T>(url: string, data?: unknown, config?: HttpRequestConfig): Promise<T>;
-    /**
-     * PATCH request with authentication support
-     */
-    patch<T>(url: string, data?: unknown, config?: HttpRequestConfig): Promise<T>;
-    /**
-     * Get mTLS status and certificate information
-     */
-    getMTLSStatus(): Promise<{
-        adapterAvailable: boolean;
-        certificateManagerAvailable: boolean;
-        isReady: boolean;
-        hasCertificate: boolean;
-        certificateInfo: {
-            format: string;
-        } | null;
-        platformInfo: {
-            platform: "react-native" | "node" | "web" | "expo";
-            mtlsSupported: boolean;
-            certificateStorage: "keychain" | "keystore" | "filesystem" | "browser-managed" | "memory";
-            fallbackToJWT: boolean;
-        } | null;
-        diagnosticTest: boolean;
-        diagnosticTestNote: string;
-        pendingRequestsCount: number;
-    }>;
-    /**
-     * Store certificate with coordination between certificate manager and mTLS adapter
-     * This ensures old certificates are properly cleared from both SDK storage and native keychain
-     */
-    storeCertificate(certificate: string, privateKey: string, options?: {
-        format?: 'pem' | 'p12' | 'pkcs12';
-    }): Promise<void>;
-    /**
-     * Clear certificate from both certificate manager and native keychain
-     */
-    clearCertificate(): Promise<void>;
-    /**
-     * Test mTLS connection
-     */
-    testMTLSConnection(): Promise<boolean>;
-    /**
-     * Check if mTLS is ready for requests
-     */
-    isMTLSReady(): Promise<boolean>;
-    /**
-     * Get the mTLS adapter instance (for backward compatibility)
-     */
-    getMTLSAdapter(): IMTLSPort | null;
-    /**
-     * Get a certificate manager instance
-     */
-    getCertificateManager(): CertificateManager | null;
-    /**
-     * Get the underlying axios instance for advanced use cases
-     */
-    getAxiosInstance(): AxiosInstance;
-    /**
-     * Invalidate cache entries
-     */
-    invalidateCache(pattern: string): Promise<void>;
-    get isDebugEnabled(): boolean;
-}
-
-/**
- * Cash Registers API manager
- */
-declare class CashRegistersAPI {
-    private httpClient;
-    private debugEnabled;
-    constructor(httpClient: HttpClient);
-    /**
-     * Create a new cash register
-     */
-    create(cashRegisterData: CashRegisterCreate): Promise<CashRegisterDetailedOutput>;
-    /**
-     * Get all cash registers for the current merchant
-     */
-    list(params: CashRegisterListParams): Promise<Page<CashRegisterBasicOutput>>;
-    /**
-     * Get a cash register by ID
-     */
-    get(id: string): Promise<CashRegisterBasicOutput>;
-    /**
-     * Get detailed cash register information
-     */
-    getDetailed(id: string): Promise<CashRegisterDetailedOutput>;
-    /**
-     * Get certificate status for a cash register
-     */
-    getCertificateStatus(cashRegisterId: string): Promise<{
-        hasCertificate: boolean;
-        isConfigured: boolean;
-        canConnect: boolean;
-        certificateInfo?: {
-            configuredAt: Date;
-            source: string;
-        };
-    }>;
-}
-
-/**
- * Cashiers API manager
- */
-declare class CashiersAPI {
-    private httpClient;
-    constructor(httpClient: HttpClient);
-    /**
-     * Read cashiers with pagination
-     */
-    list(params?: CashierListParams): Promise<Page<CashierOutput>>;
-    /**
-     * Create a new cashier
-     */
-    create(cashierData: CashierCreateInput): Promise<CashierOutput>;
-    /**
-     * Read currently authenticated cashier's information
-     */
-    me(): Promise<CashierOutput>;
-    /**
-     * Get a specific cashier by ID
-     */
-    get(cashierId: string): Promise<CashierOutput>;
-    /**
-     * Delete a cashier
-     */
-    delete(cashierId: string): Promise<void>;
-}
-
-/**
- * Daily Reports API manager (MF2)
- */
-declare class DailyReportsAPI {
-    private httpClient;
-    constructor(httpClient: HttpClient);
-    /**
-     * Retrieve the collection of Daily Report resources
-     */
-    list(params?: DailyReportsParams): Promise<DailyReportOutput[]>;
-    /**
-     * Retrieve a Daily Report resource by UUID
-     */
-    get(uuid: string): Promise<DailyReportOutput>;
-    /**
-     * Regenerate/resend a daily report
-     */
-    regenerate(uuid: string): Promise<DailyReportOutput>;
-}
-
-/**
- * Journals API manager (MF2)
- */
-declare class JournalsAPI {
-    private httpClient;
-    constructor(httpClient: HttpClient);
-    /**
-     * Retrieve the collection of Journal resources
-     */
-    list(params?: JournalsParams): Promise<JournalOutput[]>;
-    /**
-     * Retrieve a Journal resource by UUID
-     */
-    get(uuid: string): Promise<JournalOutput>;
-}
-
-/**
- * Merchants API manager (MF2)
- */
-declare class MerchantsAPI {
-    private httpClient;
-    constructor(httpClient: HttpClient);
-    /**
-     * Retrieve the collection of Merchant resources
-     */
-    list(params: MerchantsParams): Promise<MerchantOutput[]>;
-    /**
-     * Create a Merchant resource
-     */
-    create(merchantData: MerchantCreateInput): Promise<MerchantOutput>;
-    /**
-     * Retrieve a Merchant resource by UUID
-     */
-    get(uuid: string): Promise<MerchantOutput>;
-    /**
-     * Replace the Merchant resource
-     */
-    update(uuid: string, merchantData: MerchantUpdateInput): Promise<MerchantOutput>;
-    /**
-     * Retrieve Point of Sale resources for a specific merchant by Supplier logged
-     */
-    listPointOfSalesBySuppliers(merchantUuid: string, params?: {
-        page?: number;
-    }): Promise<LdJsonPage<PointOfSaleOutputMf2>>;
-    /**
-     *  Retrieve Point of Sale resources for a specific merchant by Merchant logged
-     */
-    listPointOfSalesByMerchants(params?: {
-        page?: number;
-    }): Promise<LdJsonPage<PointOfSaleOutputMf2>>;
-}
-
-/**
- * PEMs API manager (MF2)
- */
-declare class PemsAPI {
-    private httpClient;
-    constructor(httpClient: HttpClient);
-    /**
-     * Create a new PEM
-     */
-    create(pemData: PemCreateInput): Promise<PemCreateOutput>;
-    /**
-     * Get a specific PEM by serial number
-     */
-    get(serialNumber: string): Promise<PointOfSaleDetailedOutput>;
-    /**
-     * Get mTLS and signing certificates for a PEM
-     */
-    getCertificates(serialNumber: string): Promise<PemCertificatesOutput>;
-}
-
-/**
- * Point of Sales API manager
- */
-declare class PointOfSalesAPI {
-    private httpClient;
-    constructor(httpClient: HttpClient);
-    /**
-     * Retrieve Point of Sales (PEMs)
-     */
-    list(params?: PointOfSaleListParams): Promise<Page<PointOfSaleOutput>>;
-    /**
-     * Get a specific Point of Sale by serial number
-     */
-    get(serialNumber: string): Promise<PointOfSaleDetailedOutput>;
-    /**
-     * Update a Point of Sale
-     */
-    update(serialNumber: string, updateData: PointOfSaleUpdateInput): Promise<PointOfSaleDetailedOutput>;
-    /**
-     * Close a journal
-     */
-    close(serial_number: string): Promise<void>;
-    /**
-     * Trigger the activation process of a Point of Sale
-     */
-    activate(serialNumber: string, activationData: ActivationRequest): Promise<void>;
-    /**
-     * Create a new inactivity period
-     */
-    createInactivityPeriod(serialNumber: string): Promise<void>;
-    /**
-     * Change the state of the Point of Sale to 'offline'
-     */
-    setOffline(serialNumber: string, offlineData: PEMStatusOfflineRequest): Promise<void>;
-    /**
-     * Retrieve a POS resource by UUID
-     */
-    getMf2Pos(serialNumber: string): Promise<PointOfSaleOutputMf2>;
-}
-
-/**
- * User role information for authentication routing
- */
-interface UserContext {
-    roles: string[];
-    userId?: string;
-    merchantId?: string;
-}
-/**
- * Receipts API manager with mTLS and role-based authentication
- */
-declare class ReceiptsAPI {
-    private httpClient;
-    private debugEnabled;
-    private userContext;
-    constructor(httpClient: HttpClient);
-    /**
-     * Set user context for role-based authentication
-     */
-    setUserContext(context: UserContext): void;
-    /**
-     * Create request configuration
-     * Let MTLSHandler determine the best authentication mode based on role/platform/method
-     */
-    private createRequestConfig;
-    /**
-     * Create a new electronic receipt
-     * Authentication mode determined by MTLSHandler based on role/platform
-     */
-    create(receiptData: ReceiptInput): Promise<ReceiptOutput>;
-    /**
-     * Get a list of electronic receipts
-     * Authentication mode determined by MTLSHandler (typically JWT for GET operations)
-     */
-    list(params: ReceiptListParams): Promise<Page<ReceiptOutput>>;
-    /**
-     * Get an electronic receipt by UUID
-     * Authentication mode determined by MTLSHandler based on role/platform
-     */
-    get(receiptUuid: string): Promise<ReceiptOutput>;
-    /**
-     * Get receipt details (JSON or PDF)
-     * Authentication mode determined by MTLSHandler
-     * ✅ PDF downloads now use mTLS with binary response support (expo-mutual-tls v1.0.3+)
-     */
-    getDetails(receiptUuid: string, format?: 'json' | 'pdf'): Promise<ReceiptDetailsOutput | string>;
-    /**
-     * Void an electronic receipt via same pos
-     */
-    voidViaSamePos(voidData: VoidReceiptInput): Promise<void>;
-    /**
-     * Void an electronic receipt via different pos
-     */
-    voidViaDifferentPos(voidData: ReceiptReturnOrVoidViaPEMInput): Promise<void>;
-    /**
-     * Void an electronic receipt identified by proof of purchase
-     */
-    voidWithProof(voidData: ReceiptReturnOrVoidWithProofInput): Promise<void>;
-    /**
-     * Return an electronic receipt via same pos
-     */
-    return(returnData: ReceiptReturnInput): Promise<ReceiptOutput>;
-    /**
-     * get returnable items for a receipt
-     */
-    getReturnableItems(receiptUuid: string): Promise<ReturnableReceiptItem[]>;
-    /**
-     * Return items from an electronic receipt via different pos
-     */
-    returnViaDifferentPos(returnData: ReceiptReturnOrVoidViaPEMInput): Promise<ReceiptOutput>;
-    /**
-     * Return items from an electronic receipt identified by proof of purchase
-     * Authentication mode determined by MTLSHandler
-     */
-    returnWithProof(returnData: ReceiptReturnOrVoidWithProofInput): Promise<ReceiptOutput>;
-    /**
-     * Get current authentication status
-     */
-    getAuthenticationStatus(): Promise<{
-        mtlsAvailable: boolean;
-        mtlsReady: boolean;
-        userContext: UserContext | null;
-        recommendedAuthMode: 'auto';
-    }>;
-}
-
-/**
- * Suppliers API manager (MF2)
- */
-declare class SuppliersAPI {
-    private httpClient;
-    constructor(httpClient: HttpClient);
-    /**
-     * Retrieve the collection of Supplier resources
-     */
-    list(params: SuppliersParams): Promise<SupplierOutput[]>;
-    /**
-     * Create a Supplier resource
-     */
-    create(supplierData: SupplierCreateInput): Promise<SupplierOutput>;
-    /**
-     * Retrieve a Supplier resource by UUID
-     */
-    get(uuid: string): Promise<SupplierOutput>;
-    /**
-     * Replace the Supplier resource
-     */
-    update(uuid: string, supplierData: SupplierUpdateInput): Promise<SupplierOutput>;
-    /**
-     * Delete a Supplier resource
-     */
-    delete(uuid: string): Promise<void>;
-}
-
-/**
- * Main API client that combines all resource managers
- */
-declare class APIClient {
-    private httpClient;
-    private cache?;
-    private networkMonitor?;
-    readonly receipts: ReceiptsAPI;
-    readonly cashiers: CashiersAPI;
-    readonly pointOfSales: PointOfSalesAPI;
-    readonly cashRegisters: CashRegistersAPI;
-    readonly merchants: MerchantsAPI;
-    readonly pems: PemsAPI;
-    readonly suppliers: SuppliersAPI;
-    readonly dailyReports: DailyReportsAPI;
-    readonly journals: JournalsAPI;
-    constructor(config: ConfigManager, certificateManager?: CertificateManager, cache?: ICachePort, networkMonitor?: INetworkPort, mtlsAdapter?: IMTLSPort, userProvider?: IUserProvider);
-    /**
-     * Set an authorization header for all requests
-     */
-    setAuthorizationHeader(token: string): void;
-    /**
-     * Remove authorization header
-     */
-    removeAuthorizationHeader(): void;
-    /**
-     * Get the underlying HTTP client for advanced use cases
-     */
-    getHttpClient(): HttpClient;
-    /**
-     * Get the cache adapter if available
-     */
-    getCache(): ICachePort | undefined;
-    /**
-     * Check if the cache is available and enabled
-     */
-    isCacheEnabled(): boolean;
-    /**
-     * Get the network monitor if available
-     */
-    getNetworkMonitor(): INetworkPort | undefined;
-    /**
-     * Check if network monitoring is enabled
-     */
-    isNetworkMonitorEnabled(): boolean;
-    /**
-     * Get current network status
-     */
-    getNetworkStatus(): {
-        isOnline: boolean;
-        hasMonitor: boolean;
-    };
-    /**
-     * Check if currently online
-     */
-    isOnline(): boolean;
-    /**
-     * Get mTLS adapter if available through HttpClient
-     */
-    getMTLSAdapter(): IMTLSPort | null;
-    /**
-     * Check if mTLS is ready
-     */
-    isMTLSReady(): Promise<boolean>;
-}
-
-/**
- * Offline queue types and interfaces
- */
-type OperationType = 'CREATE' | 'UPDATE' | 'DELETE';
-type ResourceType = 'receipt' | 'cashier' | 'point-of-sale' | 'cash-register' | 'merchant' | 'pem';
-type OperationStatus = 'pending' | 'processing' | 'completed' | 'failed';
-/**
- * Queued operation data structure
- */
-interface QueuedOperation {
-    id: string;
-    type: OperationType;
-    resource: ResourceType;
-    endpoint: string;
-    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
-    data?: unknown;
-    headers?: Record<string, string>;
-    status: OperationStatus;
-    createdAt: number;
-    updatedAt: number;
-    retryCount: number;
-    maxRetries: number;
-    error?: string;
-    priority: number;
-}
-/**
- * Sync result for a single operation
- */
-interface SyncResult {
-    operation: QueuedOperation;
-    success: boolean;
-    error?: string;
-    response?: unknown;
-}
-/**
- * Batch sync result
- */
-interface BatchSyncResult {
-    totalOperations: number;
-    successCount: number;
-    failureCount: number;
-    results: SyncResult[];
-}
-/**
- * Queue configuration
- */
-interface QueueConfig {
-    maxRetries: number;
-    retryDelay: number;
-    maxRetryDelay: number;
-    backoffMultiplier: number;
-    maxQueueSize: number;
-    batchSize: number;
-    syncInterval: number;
-}
-/**
- * Queue events
- */
-interface QueueEvents {
-    onOperationAdded?: (operation: QueuedOperation) => void;
-    onOperationCompleted?: (result: SyncResult) => void;
-    onOperationFailed?: (result: SyncResult) => void;
-    onBatchSyncCompleted?: (result: BatchSyncResult) => void;
-    onQueueEmpty?: () => void;
-    onError?: (error: Error) => void;
-}
-
-/**
- * Operation queue manager for offline functionality
- */
-declare class OperationQueue {
-    private storage;
-    private config;
-    private events;
-    private static readonly QUEUE_KEY;
-    private queue;
-    private isProcessing;
-    private syncIntervalId?;
-    constructor(storage: IStoragePort, config?: QueueConfig, events?: QueueEvents);
-    /**
-     * Add an operation to the queue
-     */
-    addOperation(type: OperationType, resource: ResourceType, endpoint: string, method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', data?: unknown, priority?: number): Promise<string>;
-    /**
-     * Get all pending operations
-     */
-    getPendingOperations(): QueuedOperation[];
-    /**
-     * Get operation by ID
-     */
-    getOperation(id: string): QueuedOperation | undefined;
-    /**
-     * Remove operation from queue
-     */
-    removeOperation(id: string): Promise<boolean>;
-    /**
-     * Update operation status
-     */
-    updateOperation(id: string, updates: Partial<QueuedOperation>): Promise<boolean>;
-    /**
-     * Get queue statistics
-     */
-    getStats(): {
-        total: number;
-        pending: number;
-        processing: number;
-        completed: number;
-        failed: number;
-    };
-    /**
-     * Clear all operations from queue
-     */
-    clearQueue(): Promise<void>;
-    /**
-     * Clear completed operations
-     */
-    clearCompleted(): Promise<void>;
-    /**
-     * Clear failed operations
-     */
-    clearFailed(): Promise<void>;
-    /**
-     * Retry failed operations
-     */
-    retryFailed(): Promise<void>;
-    /**
-     * Get operations for batch processing
-     */
-    getNextBatch(): QueuedOperation[];
-    /**
-     * Check if queue is empty (no pending operations)
-     */
-    isEmpty(): boolean;
-    /**
-     * Start auto-sync timer
-     */
-    startAutoSync(): void;
-    /**
-     * Stop auto-sync timer
-     */
-    stopAutoSync(): void;
-    /**
-     * Set processing state
-     */
-    setProcessing(processing: boolean): void;
-    /**
-     * Check if currently processing
-     */
-    isCurrentlyProcessing(): boolean;
-    /**
-     * Load queue from storage
-     */
-    private loadQueue;
-    /**
-     * Save queue to storage
-     */
-    private saveQueue;
-    /**
-     * Generate unique ID for operations
-     */
-    private generateId;
-    /**
-     * Cleanup resources
-     */
-    destroy(): void;
-}
-
-/**
- * Enhanced offline manager with optimistic update support
- */
-declare class OfflineManager {
-    private queue;
-    private syncManager;
-    constructor(storage: IStoragePort, httpClient: HttpClient, networkMonitor: INetworkPort, config?: Partial<QueueConfig>, events?: QueueEvents, _cache?: ICachePort);
-    /**
-     * Queue an operation for offline execution
-     */
-    queueOperation(type: OperationType, resource: ResourceType, endpoint: string, method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', data?: unknown, priority?: number): Promise<string>;
-    /**
-     * Queue a receipt creation
-     */
-    queueReceiptCreation(receiptData: unknown, priority?: number): Promise<string>;
-    /**
-     * Queue a receipt void operation
-     */
-    queueReceiptVoid(voidData: unknown, priority?: number): Promise<string>;
-    /**
-     * Queue a receipt return operation
-     */
-    queueReceiptReturn(returnData: unknown, priority?: number): Promise<string>;
-    /**
-     * Queue a cashier creation
-     */
-    queueCashierCreation(cashierData: unknown, priority?: number): Promise<string>;
-    /**
-     * Check if currently online
-     */
-    isOnline(): boolean;
-    /**
-     * Get sync status and queue statistics
-     */
-    getStatus(): {
-        isOnline: boolean;
-        isProcessing: boolean;
-        queueStats: ReturnType<OperationQueue["getStats"]>;
-    };
-    /**
-     * Get pending operations count
-     */
-    getPendingCount(): number;
-    /**
-     * Check if queue is empty
-     */
-    isEmpty(): boolean;
-    /**
-     * Manually trigger sync (if online)
-     */
-    sync(): Promise<BatchSyncResult | null>;
-    /**
-     * Retry failed operations
-     */
-    retryFailed(): Promise<void>;
-    /**
-     * Clear completed operations
-     */
-    clearCompleted(): Promise<void>;
-    /**
-     * Clear failed operations
-     */
-    clearFailed(): Promise<void>;
-    /**
-     * Clear all operations
-     */
-    clearAll(): Promise<void>;
-    /**
-     * Get operation by ID
-     */
-    getOperation(id: string): QueuedOperation | undefined;
-    /**
-     * Remove specific operation
-     */
-    removeOperation(id: string): Promise<boolean>;
-    /**
-     * Get queue statistics
-     */
-    getQueueStats(): {
-        total: number;
-        pending: number;
-        processing: number;
-        completed: number;
-        failed: number;
-    };
-    /**
-     * Start auto-sync (if not already started)
-     */
-    startAutoSync(): void;
-    /**
-     * Stop auto-sync
-     */
-    stopAutoSync(): void;
-    /**
-     * Create optimistic update (requires cache)
-     */
-    createOptimisticUpdate<T>(_resource: ResourceType, _operation: OperationType, _endpoint: string, _method: 'POST' | 'PUT' | 'PATCH' | 'DELETE', _data: unknown, _optimisticData: T, _cacheKey: string, _priority?: number): Promise<string | null>;
-    /**
-     * Enhanced queue receipt creation with optimistic update
-     */
-    queueReceiptCreationWithOptimistic<T>(receiptData: unknown, optimisticReceipt: T, cacheKey: string, priority?: number): Promise<string | null>;
-    /**
-     * Enhanced queue receipt void with optimistic update
-     */
-    queueReceiptVoidWithOptimistic<T>(voidData: unknown, optimisticUpdate: T, cacheKey: string, priority?: number): Promise<string | null>;
-    /**
-     * Enhanced queue receipt return with optimistic update
-     */
-    queueReceiptReturnWithOptimistic<T>(returnData: unknown, optimisticReceipt: T, cacheKey: string, priority?: number): Promise<string | null>;
-    /**
-     * Get optimistic operations (disabled in simplified cache system)
-     */
-    getOptimisticOperations(): never[];
-    /**
-     * Get pending optimistic operations count (disabled in simplified cache system)
-     */
-    getOptimisticPendingCount(): number;
-    /**
-     * Check if optimistic updates are enabled (disabled in simplified cache system)
-     */
-    isOptimisticEnabled(): boolean;
-    /**
-     * Check if resource has pending optimistic updates (disabled in simplified cache system)
-     */
-    hasPendingOptimisticUpdates(_resource: ResourceType, _resourceId?: string): boolean;
-    /**
-     * Get the optimistic manager (disabled in simplified cache system)
-     */
-    getOptimisticManager(): null;
-    /**
-     * Manually rollback a specific optimistic operation (disabled in simplified cache system)
-     */
-    rollbackOptimisticOperation(_operationId: string, _reason?: string): Promise<void>;
-    /**
-     * Manually rollback all pending optimistic operations for a resource (disabled in simplified cache system)
-     */
-    rollbackOptimisticOperationsByResource(_resource: ResourceType, _resourceId?: string): Promise<void>;
-    /**
-     * Cleanup resources
-     */
-    destroy(): void;
-}
-
-/**
- * SDK Events interface
- */
-interface SDKEvents {
-    onUserChanged?: (user: User | null) => void;
-    onAuthError?: (error: ACubeSDKError) => void;
-    onNetworkStatusChanged?: (online: boolean) => void;
-    onOfflineOperationAdded?: (operationId: string) => void;
-    onOfflineOperationCompleted?: (operationId: string, success: boolean) => void;
-}
-/**
- * Main ACube SDK class
- */
-declare class ACubeSDK {
-    private events;
-    private config;
-    private adapters?;
-    private authManager?;
-    private offlineManager?;
-    private certificateManager?;
-    private isInitialized;
-    api?: APIClient;
-    constructor(config: SDKConfig, customAdapters?: PlatformAdapters, events?: SDKEvents);
-    /**
-     * Initialize the SDK
-     */
-    initialize(): Promise<void>;
-    /**
-     * Login with email and password
-     */
-    login(credentials: AuthCredentials): Promise<User>;
-    /**
-     * Logout current user
-     */
-    logout(): Promise<void>;
-    /**
-     * Get current user
-     */
-    getCurrentUser(): Promise<User | null>;
-    /**
-     * Check if the user is authenticated
-     */
-    isAuthenticated(): Promise<boolean>;
-    /**
-     * Get offline manager for manual queue operations
-     */
-    getOfflineManager(): OfflineManager;
-    /**
-     * Check if currently online
-     */
-    isOnline(): boolean;
-    /**
-     * Get SDK configuration
-     */
-    getConfig(): SDKConfig;
-    /**
-     * Update SDK configuration
-     */
-    updateConfig(updates: Partial<SDKConfig>): void;
-    /**
-     * Get platform adapters (for advanced use cases)
-     */
-    getAdapters(): PlatformAdapters | undefined;
-    /**
-     * Store mTLS certificate (replaces any existing certificate)
-     */
-    storeCertificate(certificate: string, privateKey: string, options?: {
-        name?: string;
-        format?: 'pem' | 'p12' | 'pkcs12';
-        password?: string;
-    }): Promise<void>;
-    /**
-     * Get mTLS status and configuration info
-     */
-    getMTLSStatus(): Promise<{
-        adapterAvailable: boolean;
-        certificateManagerAvailable: boolean;
-        isReady: boolean;
-        hasCertificate: boolean;
-        certificateInfo: {
-            format: string;
-        } | null;
-        platformInfo: {
-            platform: "react-native" | "node" | "web" | "expo";
-            mtlsSupported: boolean;
-            certificateStorage: "keychain" | "keystore" | "filesystem" | "browser-managed" | "memory";
-            fallbackToJWT: boolean;
-        } | null;
-        diagnosticTest: boolean;
-        diagnosticTestNote: string;
-        pendingRequestsCount: number;
-    }>;
-    /**
-     * Test mTLS connection
-     */
-    testMTLSConnection(): Promise<boolean>;
-    /**
-     * Clear the stored certificate
-     */
-    clearCertificate(): Promise<void>;
-    /**
-     * Get certificate manager for advanced certificate operations
-     */
-    getCertificateManager(): CertificateManager | undefined;
-    /**
-     * Get the stored certificate
-     */
-    getCertificate(): Promise<StoredCertificate | null>;
-    /**
-     * Get certificate information (without private key)
-     */
-    getCertificateInfo(): Promise<{
-        format: string;
-    } | null>;
-    /**
-     * Check if certificate is stored
-     */
-    hasCertificate(): Promise<boolean>;
-    /**
-     * Get detailed certificate information from stored certificates
-     * This method retrieves certificate metadata including subject, issuer,
-     * validity dates, fingerprints, key usage, and more from the mTLS adapter.
-     *
-     * Uses retry-on-failure pattern similar to executeRequestMTLS:
-     * - First attempt: Try to get certificate info
-     * - If null and certificate exists: Configure certificate and retry once
-     * - Maximum 2 attempts to prevent infinite loops
-     *
-     * @param isRetryAttempt Internal flag to prevent infinite retry loops
-     * @returns Promise with detailed certificate information or null if not available
-     */
-    getCertificatesInfo(isRetryAttempt?: boolean): Promise<CertificateInfo | null>;
-    /**
-     * Destroy SDK and cleanup resources
-     */
-    destroy(): void;
-    /**
-     * Ensure SDK is initialized
-     */
-    private ensureInitialized;
-}
-
-interface ACubeContextValue {
-    sdk: ACubeSDK | null;
-    user: User | null;
-    isAuthenticated: boolean;
-    isLoading: boolean;
-    isOnline: boolean;
-    error: ACubeSDKError | null;
-    pendingOperations: number;
-}
-interface ACubeProviderProps {
-    config: SDKConfig;
-    children: React.ReactNode;
-    onUserChanged?: (user: User | null) => void;
-    onAuthError?: (error: ACubeSDKError) => void;
-    onNetworkStatusChanged?: (online: boolean) => void;
-}
-declare function ACubeProvider({ config, children, onUserChanged, onAuthError, onNetworkStatusChanged, }: ACubeProviderProps): React.JSX.Element;
-declare function useACube(): ACubeContextValue;
-
-interface UseAuthReturn {
-    user: User | null;
-    isAuthenticated: boolean;
-    isLoading: boolean;
-    error: ACubeSDKError | null;
-    login: (credentials: AuthCredentials) => Promise<User | null>;
-    logout: () => Promise<void>;
-    clearError: () => void;
-}
-declare function useAuth(): UseAuthReturn;
-
-export { ACubeProvider, useACube, useAuth };
-export type { ACubeContextValue, ACubeProviderProps, UseAuthReturn };