voip.ms Messages: Signal-style desktop SMS client
Electron + React app that imports the full voip.ms SMS history into a local SQLite/FTS5 database, polls for new messages, sends SMS, resolves names/photos from GNOME EDS address books, and supports global and per-chat search with jump-to-message. Data lives in ~/Documents/voipms-desktop-data (covered by Deja Dup) with daily consistent snapshots. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,85 @@
|
||||
// Minimal voip.ms REST client. Docs: https://voip.ms/m/apidocs.php
|
||||
import type { Credentials, Did } from '@shared/types'
|
||||
|
||||
const ENDPOINT = 'https://voip.ms/api/v1/rest.php'
|
||||
|
||||
export interface RawSms {
|
||||
id: string
|
||||
date: string // "YYYY-MM-DD HH:MM:SS" in the requested timezone (we ask for UTC)
|
||||
type: string // "1" received, "0" sent
|
||||
did: string
|
||||
contact: string
|
||||
message: string
|
||||
}
|
||||
|
||||
const FRIENDLY_ERRORS: Record<string, string> = {
|
||||
invalid_credentials: 'Invalid API username or password. Use the API password set under Main Menu → SOAP & REST/JSON API, not your login password.',
|
||||
missing_credentials: 'Missing API username or password.',
|
||||
ip_not_enabled: "This computer's IP address isn't allowed. Add it under Main Menu → SOAP & REST/JSON API → Enable IP Addresses.",
|
||||
api_not_enabled: 'The API is not enabled on your voip.ms account. Enable it under Main Menu → SOAP & REST/JSON API.',
|
||||
sms_toolong: 'Message is too long.',
|
||||
invalid_dst: 'Invalid destination number.',
|
||||
invalid_did: 'That DID is not valid on your account.',
|
||||
sms_failed: 'voip.ms failed to send the message.'
|
||||
}
|
||||
|
||||
export class VoipMsError extends Error {
|
||||
constructor(public status: string) {
|
||||
super(FRIENDLY_ERRORS[status] ?? `voip.ms error: ${status}`)
|
||||
}
|
||||
}
|
||||
|
||||
export class VoipMs {
|
||||
constructor(private creds: Credentials) {}
|
||||
|
||||
private async call<T>(method: string, params: Record<string, string | number | undefined> = {}): Promise<T> {
|
||||
const url = new URL(ENDPOINT)
|
||||
url.searchParams.set('api_username', this.creds.username)
|
||||
url.searchParams.set('api_password', this.creds.password)
|
||||
url.searchParams.set('method', method)
|
||||
for (const [k, v] of Object.entries(params)) {
|
||||
if (v !== undefined && v !== '') url.searchParams.set(k, String(v))
|
||||
}
|
||||
const res = await fetch(url, { signal: AbortSignal.timeout(60_000) })
|
||||
if (!res.ok) throw new Error(`voip.ms HTTP ${res.status}`)
|
||||
const json = (await res.json()) as { status: string } & T
|
||||
if (json.status !== 'success') throw new VoipMsError(json.status)
|
||||
return json
|
||||
}
|
||||
|
||||
async getDids(): Promise<Did[]> {
|
||||
const r = await this.call<{ dids: Array<Record<string, string>> }>('getDIDsInfo')
|
||||
return r.dids.map((d) => ({
|
||||
did: d.did,
|
||||
description: d.description ?? '',
|
||||
smsEnabled: d.sms_enabled === '1'
|
||||
}))
|
||||
}
|
||||
|
||||
// Returns [] when voip.ms reports no messages for the range.
|
||||
async getSms(opts: { from: string; to: string; did?: string; limit?: number }): Promise<RawSms[]> {
|
||||
try {
|
||||
const r = await this.call<{ sms: RawSms[] }>('getSMS', {
|
||||
from: opts.from,
|
||||
to: opts.to,
|
||||
did: opts.did,
|
||||
limit: opts.limit ?? 10000,
|
||||
timezone: 0
|
||||
})
|
||||
return r.sms ?? []
|
||||
} catch (e) {
|
||||
if (e instanceof VoipMsError && e.status === 'no_sms') return []
|
||||
throw e
|
||||
}
|
||||
}
|
||||
|
||||
async sendSms(did: string, dst: string, message: string): Promise<number> {
|
||||
const r = await this.call<{ sms: number | string }>('sendSMS', { did, dst, message })
|
||||
return Number(r.sms)
|
||||
}
|
||||
}
|
||||
|
||||
// "2024-01-02 03:04:05" (UTC) -> epoch ms
|
||||
export function parseVoipDate(s: string): number {
|
||||
return Date.parse(s.replace(' ', 'T') + 'Z')
|
||||
}
|
||||
Reference in New Issue
Block a user