1.1.0 • Published 1 year ago

capacitor-sms-sender v1.1.0

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

capacitor-sms-sender

Send SMS directly from capacitor app

Install

npm install capacitor-sms-sender
npx cap sync

Example

import { SmsSender } from 'capacitor-sms-sender'

let opts = {
    id: 1,
    sim: 0,
    phone: '+123020021',
    text: 'Hi There'
}
SmsSender.send(opts)
    .then(res => {
        console.log(res)
    })

SmsSender.addListener('smsSenderDelivered', res => {
    console.log(res)
})

API

send(...)

send(opts: SmsSenderOptions) => Promise<SmsSenderResult>

Send a text sms to a number from a specified sim index

ParamType
optsSmsSenderOptions

Returns: Promise<SmsSenderResult>

Since: 1.0.0


checkPermissions()

checkPermissions() => Promise<PermissionStatus>

Check status of permissions

Returns: Promise<PermissionStatus>

Since: 1.0.0


requestPermissions()

requestPermissions() => Promise<PermissionStatus>

Request the required permissions

Returns: Promise<PermissionStatus>


addListener('smsSenderStatusUpdated', ...)

addListener(eventName: 'smsSenderStatusUpdated', listenerFunc: (result: SmsSenderResult) => void) => Promise<PluginListenerHandle> & PluginListenerHandle

Listen for sms status update

ParamType
eventName'smsSenderStatusUpdated'
listenerFunc(result: SmsSenderResult) => void

Returns: Promise<PluginListenerHandle> & PluginListenerHandle

Since: 1.1.0


removeAllListeners()

removeAllListeners() => Promise<void>

Remove all registered listeners

Since: 1.0.0


Interfaces

SmsSenderResult

PropTypeDescriptionSince
idnumberMessage SMS id1.0.0
statusstringDelivery status, possible value are 'PENDING', FAILED', 'SENT', or 'DELIVERED'1.0.0

SmsSenderOptions

PropTypeDescriptionSince
idnumberSMS Message id1.0.0
simnumberDevice SIM index1.0.0
phonestringTarget phone number1.0.0
textstringSMS Message1.0.0

PermissionStatus

PropTypeDescriptionSince
send_smsPermissionStateSEND_SMS Permission1.0.0
read_phone_statePermissionStateREAD_PHONE_STATE Permission1.0.0

PluginListenerHandle

PropType
remove() => Promise<void>

Type Aliases

PermissionState

'prompt' | 'prompt-with-rationale' | 'granted' | 'denied'