# DO NOT EDIT THIS FILE!
#
# This file is generated from the CDP specification. If you need to make
# changes, edit the generator and regenerate all of the modules.
#
# CDP domain: SmartCardEmulation (experimental)
from __future__ import annotations
from .util import event_class, T_JSON_DICT
from dataclasses import dataclass
import enum
import typing

class ResultCode(enum.Enum):
    '''
    Indicates the PC/SC error code.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__ErrorCodes.html
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/secauthn/authentication-return-values
    '''
    SUCCESS = "success"
    REMOVED_CARD = "removed-card"
    RESET_CARD = "reset-card"
    UNPOWERED_CARD = "unpowered-card"
    UNRESPONSIVE_CARD = "unresponsive-card"
    UNSUPPORTED_CARD = "unsupported-card"
    READER_UNAVAILABLE = "reader-unavailable"
    SHARING_VIOLATION = "sharing-violation"
    NOT_TRANSACTED = "not-transacted"
    NO_SMARTCARD = "no-smartcard"
    PROTO_MISMATCH = "proto-mismatch"
    SYSTEM_CANCELLED = "system-cancelled"
    NOT_READY = "not-ready"
    CANCELLED = "cancelled"
    INSUFFICIENT_BUFFER = "insufficient-buffer"
    INVALID_HANDLE = "invalid-handle"
    INVALID_PARAMETER = "invalid-parameter"
    INVALID_VALUE = "invalid-value"
    NO_MEMORY = "no-memory"
    TIMEOUT = "timeout"
    UNKNOWN_READER = "unknown-reader"
    UNSUPPORTED_FEATURE = "unsupported-feature"
    NO_READERS_AVAILABLE = "no-readers-available"
    SERVICE_STOPPED = "service-stopped"
    NO_SERVICE = "no-service"
    COMM_ERROR = "comm-error"
    INTERNAL_ERROR = "internal-error"
    SERVER_TOO_BUSY = "server-too-busy"
    UNEXPECTED = "unexpected"
    SHUTDOWN = "shutdown"
    UNKNOWN_CARD = "unknown-card"
    UNKNOWN = "unknown"

    def to_json(self):
        return self.value

    @classmethod
    def from_json(cls, json):
        return cls(json)


class ShareMode(enum.Enum):
    '''
    Maps to the ``SCARD_SHARE_*`` values.
    '''
    SHARED = "shared"
    EXCLUSIVE = "exclusive"
    DIRECT = "direct"

    def to_json(self):
        return self.value

    @classmethod
    def from_json(cls, json):
        return cls(json)


class Disposition(enum.Enum):
    '''
    Indicates what the reader should do with the card.
    '''
    LEAVE_CARD = "leave-card"
    RESET_CARD = "reset-card"
    UNPOWER_CARD = "unpower-card"
    EJECT_CARD = "eject-card"

    def to_json(self):
        return self.value

    @classmethod
    def from_json(cls, json):
        return cls(json)


class ConnectionState(enum.Enum):
    '''
    Maps to ``SCARD_*`` connection state values.
    '''
    ABSENT = "absent"
    PRESENT = "present"
    SWALLOWED = "swallowed"
    POWERED = "powered"
    NEGOTIABLE = "negotiable"
    SPECIFIC = "specific"

    def to_json(self):
        return self.value

    @classmethod
    def from_json(cls, json):
        return cls(json)


@dataclass
class ReaderStateFlags:
    '''
    Maps to the ``SCARD_STATE_*`` flags.
    '''
    unaware: typing.Optional[bool] = None

    ignore: typing.Optional[bool] = None

    changed: typing.Optional[bool] = None

    unknown: typing.Optional[bool] = None

    unavailable: typing.Optional[bool] = None

    empty: typing.Optional[bool] = None

    present: typing.Optional[bool] = None

    exclusive: typing.Optional[bool] = None

    inuse: typing.Optional[bool] = None

    mute: typing.Optional[bool] = None

    unpowered: typing.Optional[bool] = None

    def to_json(self):
        json = dict()
        if self.unaware is not None:
            json['unaware'] = self.unaware
        if self.ignore is not None:
            json['ignore'] = self.ignore
        if self.changed is not None:
            json['changed'] = self.changed
        if self.unknown is not None:
            json['unknown'] = self.unknown
        if self.unavailable is not None:
            json['unavailable'] = self.unavailable
        if self.empty is not None:
            json['empty'] = self.empty
        if self.present is not None:
            json['present'] = self.present
        if self.exclusive is not None:
            json['exclusive'] = self.exclusive
        if self.inuse is not None:
            json['inuse'] = self.inuse
        if self.mute is not None:
            json['mute'] = self.mute
        if self.unpowered is not None:
            json['unpowered'] = self.unpowered
        return json

    @classmethod
    def from_json(cls, json):
        return cls(
            unaware=bool(json['unaware']) if 'unaware' in json else None,
            ignore=bool(json['ignore']) if 'ignore' in json else None,
            changed=bool(json['changed']) if 'changed' in json else None,
            unknown=bool(json['unknown']) if 'unknown' in json else None,
            unavailable=bool(json['unavailable']) if 'unavailable' in json else None,
            empty=bool(json['empty']) if 'empty' in json else None,
            present=bool(json['present']) if 'present' in json else None,
            exclusive=bool(json['exclusive']) if 'exclusive' in json else None,
            inuse=bool(json['inuse']) if 'inuse' in json else None,
            mute=bool(json['mute']) if 'mute' in json else None,
            unpowered=bool(json['unpowered']) if 'unpowered' in json else None,
        )


@dataclass
class ProtocolSet:
    '''
    Maps to the ``SCARD_PROTOCOL_*`` flags.
    '''
    t0: typing.Optional[bool] = None

    t1: typing.Optional[bool] = None

    raw: typing.Optional[bool] = None

    def to_json(self):
        json = dict()
        if self.t0 is not None:
            json['t0'] = self.t0
        if self.t1 is not None:
            json['t1'] = self.t1
        if self.raw is not None:
            json['raw'] = self.raw
        return json

    @classmethod
    def from_json(cls, json):
        return cls(
            t0=bool(json['t0']) if 't0' in json else None,
            t1=bool(json['t1']) if 't1' in json else None,
            raw=bool(json['raw']) if 'raw' in json else None,
        )


class Protocol(enum.Enum):
    '''
    Maps to the ``SCARD_PROTOCOL_*`` values.
    '''
    T0 = "t0"
    T1 = "t1"
    RAW = "raw"

    def to_json(self):
        return self.value

    @classmethod
    def from_json(cls, json):
        return cls(json)


@dataclass
class ReaderStateIn:
    reader: str

    current_state: ReaderStateFlags

    current_insertion_count: int

    def to_json(self):
        json = dict()
        json['reader'] = self.reader
        json['currentState'] = self.current_state.to_json()
        json['currentInsertionCount'] = self.current_insertion_count
        return json

    @classmethod
    def from_json(cls, json):
        return cls(
            reader=str(json['reader']),
            current_state=ReaderStateFlags.from_json(json['currentState']),
            current_insertion_count=int(json['currentInsertionCount']),
        )


@dataclass
class ReaderStateOut:
    reader: str

    event_state: ReaderStateFlags

    event_count: int

    atr: str

    def to_json(self):
        json = dict()
        json['reader'] = self.reader
        json['eventState'] = self.event_state.to_json()
        json['eventCount'] = self.event_count
        json['atr'] = self.atr
        return json

    @classmethod
    def from_json(cls, json):
        return cls(
            reader=str(json['reader']),
            event_state=ReaderStateFlags.from_json(json['eventState']),
            event_count=int(json['eventCount']),
            atr=str(json['atr']),
        )


def enable() -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
    '''
    Enables the ``SmartCardEmulation`` domain.
    '''
    cmd_dict: T_JSON_DICT = {
        'method': 'SmartCardEmulation.enable',
    }
    json = yield cmd_dict


def disable() -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
    '''
    Disables the ``SmartCardEmulation`` domain.
    '''
    cmd_dict: T_JSON_DICT = {
        'method': 'SmartCardEmulation.disable',
    }
    json = yield cmd_dict


def report_establish_context_result(
        request_id: str,
        context_id: int
    ) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
    '''
    Reports the successful result of a ``SCardEstablishContext`` call.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#gaa1b8970169fd4883a6dc4a8f43f19b67
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardestablishcontext

    :param request_id:
    :param context_id:
    '''
    params: T_JSON_DICT = dict()
    params['requestId'] = request_id
    params['contextId'] = context_id
    cmd_dict: T_JSON_DICT = {
        'method': 'SmartCardEmulation.reportEstablishContextResult',
        'params': params,
    }
    json = yield cmd_dict


def report_release_context_result(
        request_id: str
    ) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
    '''
    Reports the successful result of a ``SCardReleaseContext`` call.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#ga6aabcba7744c5c9419fdd6404f73a934
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardreleasecontext

    :param request_id:
    '''
    params: T_JSON_DICT = dict()
    params['requestId'] = request_id
    cmd_dict: T_JSON_DICT = {
        'method': 'SmartCardEmulation.reportReleaseContextResult',
        'params': params,
    }
    json = yield cmd_dict


def report_list_readers_result(
        request_id: str,
        readers: typing.List[str]
    ) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
    '''
    Reports the successful result of a ``SCardListReaders`` call.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#ga93b07815789b3cf2629d439ecf20f0d9
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardlistreadersa

    :param request_id:
    :param readers:
    '''
    params: T_JSON_DICT = dict()
    params['requestId'] = request_id
    params['readers'] = [i for i in readers]
    cmd_dict: T_JSON_DICT = {
        'method': 'SmartCardEmulation.reportListReadersResult',
        'params': params,
    }
    json = yield cmd_dict


def report_get_status_change_result(
        request_id: str,
        reader_states: typing.List[ReaderStateOut]
    ) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
    '''
    Reports the successful result of a ``SCardGetStatusChange`` call.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#ga33247d5d1257d59e55647c3bb717db24
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardgetstatuschangea

    :param request_id:
    :param reader_states:
    '''
    params: T_JSON_DICT = dict()
    params['requestId'] = request_id
    params['readerStates'] = [i.to_json() for i in reader_states]
    cmd_dict: T_JSON_DICT = {
        'method': 'SmartCardEmulation.reportGetStatusChangeResult',
        'params': params,
    }
    json = yield cmd_dict


def report_begin_transaction_result(
        request_id: str,
        handle: int
    ) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
    '''
    Reports the result of a ``SCardBeginTransaction`` call.
    On success, this creates a new transaction object.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#gaddb835dce01a0da1d6ca02d33ee7d861
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardbegintransaction

    :param request_id:
    :param handle:
    '''
    params: T_JSON_DICT = dict()
    params['requestId'] = request_id
    params['handle'] = handle
    cmd_dict: T_JSON_DICT = {
        'method': 'SmartCardEmulation.reportBeginTransactionResult',
        'params': params,
    }
    json = yield cmd_dict


def report_plain_result(
        request_id: str
    ) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
    '''
    Reports the successful result of a call that returns only a result code.
    Used for: ``SCardCancel``, ``SCardDisconnect``, ``SCardSetAttrib``, ``SCardEndTransaction``.

    This maps to:
    1. SCardCancel
       PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#gaacbbc0c6d6c0cbbeb4f4debf6fbeeee6
       Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardcancel

    2. SCardDisconnect
       PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#ga4be198045c73ec0deb79e66c0ca1738a
       Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scarddisconnect

    3. SCardSetAttrib
       PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#ga060f0038a4ddfd5dd2b8fadf3c3a2e4f
       Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardsetattrib

    4. SCardEndTransaction
       PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#gae8742473b404363e5c587f570d7e2f3b
       Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardendtransaction

    :param request_id:
    '''
    params: T_JSON_DICT = dict()
    params['requestId'] = request_id
    cmd_dict: T_JSON_DICT = {
        'method': 'SmartCardEmulation.reportPlainResult',
        'params': params,
    }
    json = yield cmd_dict


def report_connect_result(
        request_id: str,
        handle: int,
        active_protocol: typing.Optional[Protocol] = None
    ) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
    '''
    Reports the successful result of a ``SCardConnect`` call.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#ga4e515829752e0a8dbc4d630696a8d6a5
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardconnecta

    :param request_id:
    :param handle:
    :param active_protocol: *(Optional)*
    '''
    params: T_JSON_DICT = dict()
    params['requestId'] = request_id
    params['handle'] = handle
    if active_protocol is not None:
        params['activeProtocol'] = active_protocol.to_json()
    cmd_dict: T_JSON_DICT = {
        'method': 'SmartCardEmulation.reportConnectResult',
        'params': params,
    }
    json = yield cmd_dict


def report_data_result(
        request_id: str,
        data: str
    ) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
    '''
    Reports the successful result of a call that sends back data on success.
    Used for ``SCardTransmit``, ``SCardControl``, and ``SCardGetAttrib``.

    This maps to:
    1. SCardTransmit
       PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#ga9a2d77242a271310269065e64633ab99
       Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardtransmit

    2. SCardControl
       PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#gac3454d4657110fd7f753b2d3d8f4e32f
       Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardcontrol

    3. SCardGetAttrib
       PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#gaacfec51917255b7a25b94c5104961602
       Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardgetattrib

    :param request_id:
    :param data:
    '''
    params: T_JSON_DICT = dict()
    params['requestId'] = request_id
    params['data'] = data
    cmd_dict: T_JSON_DICT = {
        'method': 'SmartCardEmulation.reportDataResult',
        'params': params,
    }
    json = yield cmd_dict


def report_status_result(
        request_id: str,
        reader_name: str,
        state: ConnectionState,
        atr: str,
        protocol: typing.Optional[Protocol] = None
    ) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
    '''
    Reports the successful result of a ``SCardStatus`` call.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#gae49c3c894ad7ac12a5b896bde70d0382
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardstatusa

    :param request_id:
    :param reader_name:
    :param state:
    :param atr:
    :param protocol: *(Optional)*
    '''
    params: T_JSON_DICT = dict()
    params['requestId'] = request_id
    params['readerName'] = reader_name
    params['state'] = state.to_json()
    params['atr'] = atr
    if protocol is not None:
        params['protocol'] = protocol.to_json()
    cmd_dict: T_JSON_DICT = {
        'method': 'SmartCardEmulation.reportStatusResult',
        'params': params,
    }
    json = yield cmd_dict


def report_error(
        request_id: str,
        result_code: ResultCode
    ) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
    '''
    Reports an error result for the given request.

    :param request_id:
    :param result_code:
    '''
    params: T_JSON_DICT = dict()
    params['requestId'] = request_id
    params['resultCode'] = result_code.to_json()
    cmd_dict: T_JSON_DICT = {
        'method': 'SmartCardEmulation.reportError',
        'params': params,
    }
    json = yield cmd_dict


@event_class('SmartCardEmulation.establishContextRequested')
@dataclass
class EstablishContextRequested:
    '''
    Fired when ``SCardEstablishContext`` is called.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#gaa1b8970169fd4883a6dc4a8f43f19b67
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardestablishcontext
    '''
    request_id: str

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> EstablishContextRequested:
        return cls(
            request_id=str(json['requestId'])
        )


@event_class('SmartCardEmulation.releaseContextRequested')
@dataclass
class ReleaseContextRequested:
    '''
    Fired when ``SCardReleaseContext`` is called.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#ga6aabcba7744c5c9419fdd6404f73a934
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardreleasecontext
    '''
    request_id: str
    context_id: int

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> ReleaseContextRequested:
        return cls(
            request_id=str(json['requestId']),
            context_id=int(json['contextId'])
        )


@event_class('SmartCardEmulation.listReadersRequested')
@dataclass
class ListReadersRequested:
    '''
    Fired when ``SCardListReaders`` is called.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#ga93b07815789b3cf2629d439ecf20f0d9
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardlistreadersa
    '''
    request_id: str
    context_id: int

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> ListReadersRequested:
        return cls(
            request_id=str(json['requestId']),
            context_id=int(json['contextId'])
        )


@event_class('SmartCardEmulation.getStatusChangeRequested')
@dataclass
class GetStatusChangeRequested:
    '''
    Fired when ``SCardGetStatusChange`` is called. Timeout is specified in milliseconds.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#ga33247d5d1257d59e55647c3bb717db24
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardgetstatuschangea
    '''
    request_id: str
    context_id: int
    reader_states: typing.List[ReaderStateIn]
    #: in milliseconds, if absent, it means "infinite"
    timeout: typing.Optional[int]

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> GetStatusChangeRequested:
        return cls(
            request_id=str(json['requestId']),
            context_id=int(json['contextId']),
            reader_states=[ReaderStateIn.from_json(i) for i in json['readerStates']],
            timeout=int(json['timeout']) if 'timeout' in json else None
        )


@event_class('SmartCardEmulation.cancelRequested')
@dataclass
class CancelRequested:
    '''
    Fired when ``SCardCancel`` is called.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#gaacbbc0c6d6c0cbbeb4f4debf6fbeeee6
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardcancel
    '''
    request_id: str
    context_id: int

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> CancelRequested:
        return cls(
            request_id=str(json['requestId']),
            context_id=int(json['contextId'])
        )


@event_class('SmartCardEmulation.connectRequested')
@dataclass
class ConnectRequested:
    '''
    Fired when ``SCardConnect`` is called.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#ga4e515829752e0a8dbc4d630696a8d6a5
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardconnecta
    '''
    request_id: str
    context_id: int
    reader: str
    share_mode: ShareMode
    preferred_protocols: ProtocolSet

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> ConnectRequested:
        return cls(
            request_id=str(json['requestId']),
            context_id=int(json['contextId']),
            reader=str(json['reader']),
            share_mode=ShareMode.from_json(json['shareMode']),
            preferred_protocols=ProtocolSet.from_json(json['preferredProtocols'])
        )


@event_class('SmartCardEmulation.disconnectRequested')
@dataclass
class DisconnectRequested:
    '''
    Fired when ``SCardDisconnect`` is called.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#ga4be198045c73ec0deb79e66c0ca1738a
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scarddisconnect
    '''
    request_id: str
    handle: int
    disposition: Disposition

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> DisconnectRequested:
        return cls(
            request_id=str(json['requestId']),
            handle=int(json['handle']),
            disposition=Disposition.from_json(json['disposition'])
        )


@event_class('SmartCardEmulation.transmitRequested')
@dataclass
class TransmitRequested:
    '''
    Fired when ``SCardTransmit`` is called.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#ga9a2d77242a271310269065e64633ab99
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardtransmit
    '''
    request_id: str
    handle: int
    data: str
    protocol: typing.Optional[Protocol]

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> TransmitRequested:
        return cls(
            request_id=str(json['requestId']),
            handle=int(json['handle']),
            data=str(json['data']),
            protocol=Protocol.from_json(json['protocol']) if 'protocol' in json else None
        )


@event_class('SmartCardEmulation.controlRequested')
@dataclass
class ControlRequested:
    '''
    Fired when ``SCardControl`` is called.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#gac3454d4657110fd7f753b2d3d8f4e32f
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardcontrol
    '''
    request_id: str
    handle: int
    control_code: int
    data: str

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> ControlRequested:
        return cls(
            request_id=str(json['requestId']),
            handle=int(json['handle']),
            control_code=int(json['controlCode']),
            data=str(json['data'])
        )


@event_class('SmartCardEmulation.getAttribRequested')
@dataclass
class GetAttribRequested:
    '''
    Fired when ``SCardGetAttrib`` is called.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#gaacfec51917255b7a25b94c5104961602
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardgetattrib
    '''
    request_id: str
    handle: int
    attrib_id: int

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> GetAttribRequested:
        return cls(
            request_id=str(json['requestId']),
            handle=int(json['handle']),
            attrib_id=int(json['attribId'])
        )


@event_class('SmartCardEmulation.setAttribRequested')
@dataclass
class SetAttribRequested:
    '''
    Fired when ``SCardSetAttrib`` is called.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#ga060f0038a4ddfd5dd2b8fadf3c3a2e4f
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardsetattrib
    '''
    request_id: str
    handle: int
    attrib_id: int
    data: str

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> SetAttribRequested:
        return cls(
            request_id=str(json['requestId']),
            handle=int(json['handle']),
            attrib_id=int(json['attribId']),
            data=str(json['data'])
        )


@event_class('SmartCardEmulation.statusRequested')
@dataclass
class StatusRequested:
    '''
    Fired when ``SCardStatus`` is called.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#gae49c3c894ad7ac12a5b896bde70d0382
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardstatusa
    '''
    request_id: str
    handle: int

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> StatusRequested:
        return cls(
            request_id=str(json['requestId']),
            handle=int(json['handle'])
        )


@event_class('SmartCardEmulation.beginTransactionRequested')
@dataclass
class BeginTransactionRequested:
    '''
    Fired when ``SCardBeginTransaction`` is called.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#gaddb835dce01a0da1d6ca02d33ee7d861
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardbegintransaction
    '''
    request_id: str
    handle: int

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> BeginTransactionRequested:
        return cls(
            request_id=str(json['requestId']),
            handle=int(json['handle'])
        )


@event_class('SmartCardEmulation.endTransactionRequested')
@dataclass
class EndTransactionRequested:
    '''
    Fired when ``SCardEndTransaction`` is called.

    This maps to:
    PC/SC Lite: https://pcsclite.apdu.fr/api/group__API.html#gae8742473b404363e5c587f570d7e2f3b
    Microsoft: https://learn.microsoft.com/en-us/windows/win32/api/winscard/nf-winscard-scardendtransaction
    '''
    request_id: str
    handle: int
    disposition: Disposition

    @classmethod
    def from_json(cls, json: T_JSON_DICT) -> EndTransactionRequested:
        return cls(
            request_id=str(json['requestId']),
            handle=int(json['handle']),
            disposition=Disposition.from_json(json['disposition'])
        )