// Typed wrappers around the Tauri commands and events of the app shell. import { invoke } from '@tauri-apps/api/core' import { listen, type UnlistenFn } from '@tauri-apps/api/event' export type CallId = number export interface Settings { allowlist: string[] mic_device: string | null output_device: string | null language: string deepscript_model: string /** Custom words/names submitted with every transcription. */ vocabulary: string[] retention_days: number autostart: boolean start_after_secs: number end_after_secs: number /** Whose backend key is stored; set by the app at login. */ backend_username: string | null /** When the stored backend key expires (RFC 3339); set by the app. */ backend_key_expires_at: string | null /** The backend the stored key belongs to; set by the app. */ backend_key_base_url: string | null } /** The backend this build talks to (fixed per build, not a setting). */ export interface BackendServer { base_url: string /** Where the admin manages their keys. */ keys_url: string } /** Login status for the settings, checked with the backend. */ export interface BackendStatus { logged_in: boolean username: string | null /** RFC 3339. */ expires_at: string | null /** `false` if the key could not be checked; username and expiry are then the stored ones. */ reachable: boolean } export type Service = 'deepscript' export interface DeviceInfo { id: string name: string } export interface Devices { inputs: DeviceInfo[] outputs: DeviceInfo[] } export interface DeviceLevels { mic: number out: number } export type Track = 'mic' | 'out' export type RecordingState = | { state: 'idle' } | { state: 'recording'; call_id: CallId; app: string; started_at: string } /** What the end-of-call prompt shows about a call. Times are RFC 3339. */ export interface CallBrief { id: CallId app: string started_at: string ended_at: string | null duration_secs: number } /** The call the end-of-call prompt shows, and how many wait behind it. */ export interface PendingPrompt extends CallBrief { more_waiting: number } export type CallStatus = 'recording' | 'awaiting_decision' | 'processing' | 'done' | 'failed' /** What the status pill shows and whether the row needs the user's * attention. Mirrors `CallStatus`, except `done` splits into `done` * (uploaded to this build's backend — "fertig") and `ready_to_upload` * (not uploaded here yet — "bereit zum Hochladen"). */ export type ListState = | 'recording' | 'awaiting_decision' | 'processing' | 'failed' | 'done' | 'ready_to_upload' /** A row of the main window's call list. Times are RFC 3339. */ export interface CallListItem { id: CallId app: string started_at: string /** 0 while recording. */ duration_secs: number status: CallStatus list_state: ListState /** Whether this row needs the user to act on it (the dot in the list, * counted in the sidebar header's "N offen"). */ needs_action: boolean interrupted: boolean /** The name the user gave the call, if any. */ title: string | null /** The CRM's id of the transcript, from its last upload. */ crm_transcript_id: string | null /** When the transcript was last uploaded (RFC 3339). */ uploaded_at: string | null } /** A transcript line; `speaker_key` is "me" or "remote:". */ export interface SegmentView { speaker_key: string label: string start: number end: number text: string } /** A merged speaker: its lines now belong to `into_key`. */ export interface SpeakerMerge { from_key: string from_label: string into_key: string into_label: string } export interface CallDetail { call: CallListItem & { error: string | null; transcribed_at: string | null } /** The transcript with speaker merges applied. */ segments: SegmentView[] /** Renamed speakers by key. */ speaker_names: Record merges: SpeakerMerge[] /** The transcript is being uploaded right now. */ uploading: boolean } /** A newer version the release feed offers. */ export interface UpdateInfo { version: string /** `false` while a recording runs or a call is being processed. */ can_install: boolean } /** Download progress of an update; `total` is `null` if unknown. */ export interface UpdateProgress { downloaded: number total: number | null } /** Why the install button is disabled, shown next to it as a hint. */ export const UPDATE_BUSY_HINT = 'Nach der laufenden Aufnahme/Verarbeitung möglich' /** What a check (background or manual) found. */ export type UpdateCheckResult = | { status: 'none' } | { status: 'available'; version: string } | { status: 'error'; message: string } export interface Levels { mic: number out: number failed_tracks: Track[] } export const getSettings = () => invoke('get_settings') export const saveSettings = (settings: Settings) => invoke('save_settings', { settings }) export const setApiKey = (service: Service, key: string) => invoke('set_api_key', { service, key }) export const hasApiKey = (service: Service) => invoke('has_api_key', { service }) export const listDevices = () => invoke('list_devices') export const testDevices = () => invoke('test_devices') export const getRecordingState = () => invoke('get_recording_state') export const startManualRecording = () => invoke('start_manual_recording') /** Shows/focuses the floating recorder window instead of starting another recording. */ export const showRecorder = () => invoke('show_recorder') export const stopRecording = () => invoke('stop_recording') export const discardCurrentRecording = () => invoke('discard_current_recording') export const getPendingPrompt = () => invoke('get_pending_prompt') export const getCallBrief = (id: CallId) => invoke('get_call_brief', { id }) export const transcribeCall = (id: CallId) => invoke('transcribe_call', { id }) export const retryCall = (id: CallId) => invoke('retry_call', { id }) export const discardCall = (id: CallId) => invoke('discard_call', { id }) export const listCalls = () => invoke('list_calls') export const getCall = (id: CallId) => invoke('get_call', { id }) /** An empty name restores the default label. */ export const renameSpeaker = (id: CallId, speakerKey: string, name: string) => invoke('rename_speaker', { id, speakerKey, name }) export const mergeSpeakers = (id: CallId, fromKey: string, intoKey: string) => invoke('merge_speakers', { id, fromKey, intoKey }) export const unmergeSpeaker = (id: CallId, fromKey: string) => invoke('unmerge_speaker', { id, fromKey }) /** `null` or an empty title restores the default heading. */ export const renameCall = (id: CallId, title: string | null) => invoke('rename_call', { id, title }) export const backendServer = () => invoke('backend_server') export const backendStatus = () => invoke('backend_status') /** Resolves once the login window created a key; rejects if it was closed or failed. */ export const backendLogin = () => invoke('backend_login') export const backendLogout = () => invoke('backend_logout') /** Opens the backend's key management page in the system browser. */ export const openBackendKeysPage = () => invoke('open_backend_keys_page') /** Logs in first if needed; resolves once the CRM has the transcript. */ export const uploadTranscript = (id: CallId) => invoke('upload_transcript', { id }) export const getUpdate = () => invoke('get_update') /** Resolves only on failure: on success the app restarts. */ export const installUpdate = () => invoke('install_update') /** This build's own version, for the settings' "Updates" section. */ export const getAppVersion = () => invoke('get_app_version') /** Whether this build can install an update itself (Windows only). */ export const canSelfUpdate = () => invoke('can_self_update') /** "Nach Updates suchen": runs the same check as the background loop, * immediately. An `available` result leaves the same state `getUpdate` * reads, so the main window's banner shows it too. */ export const checkForUpdateNow = () => invoke('check_for_update_now') export const onRecordingState = (handler: (state: RecordingState) => void): Promise => listen('recording-state', (event) => handler(event.payload)) export const onCallEnded = (handler: (id: CallId) => void): Promise => listen<{ id: CallId }>('call-ended', (event) => handler(event.payload.id)) /** The prompt queue changed (a call was decided elsewhere). */ export const onPromptChanged = (handler: () => void): Promise => listen('prompt-changed', () => handler()) /** A call's status changed (processing started, done or failed). */ export const onCallUpdated = (handler: (id: CallId) => void): Promise => listen<{ id: CallId }>('call-updated', (event) => handler(event.payload.id)) /** The backend login changed (logged in, logged out, key discarded). */ export const onBackendChanged = (handler: () => void): Promise => listen('backend-changed', () => handler()) /** Creating the key failed; the login window stays open for another try. */ export const onBackendLoginError = (handler: (message: string) => void): Promise => listen<{ message: string }>('backend-login-error', (event) => handler(event.payload.message)) export const onUpdateAvailable = (handler: (info: UpdateInfo) => void): Promise => listen('update-available', (event) => handler(event.payload)) export const onUpdateProgress = ( handler: (progress: UpdateProgress) => void, ): Promise => listen('update-progress', (event) => handler(event.payload)) export const onLevels = (handler: (levels: Levels) => void): Promise => listen('levels', (event) => handler(event.payload)) /** Maps an rms level (0..1) to a meter fill (0..1) on a -60..0 dB scale. */ export function meterFill(level: number): number { if (level <= 0) return 0 const db = 20 * Math.log10(level) return Math.min(1, Math.max(0, (db + 60) / 60)) } function megabytes(bytes: number): string { return (bytes / 1024 / 1024).toLocaleString('de-DE', { maximumFractionDigits: 1 }) + ' MB' } /** Text shown while an update installs (the banner and the settings' * Updates section share this). */ export function updateProgressText(progress: UpdateProgress | null): string { if (!progress) return 'Update wird heruntergeladen…' if (progress.total === null) return `Update wird heruntergeladen… ${megabytes(progress.downloaded)}` if (progress.downloaded >= progress.total) return 'Update wird installiert…' return `Update wird heruntergeladen… ${Math.floor((progress.downloaded * 100) / progress.total)} %` } /** Error text of a rejected command. */ export function errorText(err: unknown): string { return typeof err === 'string' ? err : err instanceof Error ? err.message : String(err) }