.HELPER
Sammlung generischer Hilfsfunktionen ohne eigenes fachliches Modul (RAGAI.HELPER).
Wird intern von zahlreichen anderen RAGAI-Modulen mitgenutzt: getImageURlFromSkill löst Skill-IDs zu
Bild-URLs auf (genutzt u. a. von RAGAI.CARDS.image(), RAGAI.CHAT_AVATAR, RAGAI.VIDEO_AVATAR),
timeToSeconds wird von RAGAI.YOUTUBE.seekTo()/RAGAI.VIMEO.seekTo() zur Umrechnung von
Stunden/Minuten/Sekunden verwendet. closeWindow läuft iterativ die Parent-Fenster-Kette bis zum
obersten schließbaren Fenster hoch (mit Sicherheitsgrenze von 10 Ebenen), relevant wenn der Bot mehrfach
verschachtelt eingebettet ist (z. B. Fusion-View in Fusion-View).
Methoden
.closeWindow()
Schließt iterativ bis zum obersten schließbaren Parent-Fenster hoch (max. 10 Ebenen), relevant bei mehrfach verschachtelten Einbettungen.
Rückgabewert: void
.extractJavaScriptCode(input)
Extrahiert den Inhalt des ersten javascript/js-Codeblocks aus einem Text; leerer String, wenn keiner gefunden wird.
| Parameter | Typ | Beschreibung |
|---|---|---|
input | string |
Rückgabewert: string
.copyToClipboard(text)
Kopiert einen Text in die Zwischenablage des Nutzers und zeigt eine Erfolgs-/Fehler-Toast-Meldung an.
| Parameter | Typ | Beschreibung |
|---|---|---|
text | string | z.input<typeof helperTextSchema> |
Objekt-Form (validiert über helperTextSchema):
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
text | string | ✔ | Der zu verarbeitende Text. |
Rückgabewert: void
.timeToSeconds(hours, minutes, seconds)
Rechnet Stunden/Minuten/Sekunden in eine Gesamtsekundenzahl um.
| Parameter | Typ | Beschreibung |
|---|---|---|
hours | number | |
minutes | number | |
seconds | number |
Rückgabewert: number
.endBot(opts?)
Beendet den Bot, optional mit Abschlussnachricht, Titel und automatischer Weiterleitung nach n Sekunden.
| Parameter | Typ | Beschreibung |
|---|---|---|
opts | Partial<EndBotOptions> |
Rückgabewert: void
.addStat(stat)
Fügt einen benannten Messpunkt zur Bot-Statistik hinzu.
| Parameter | Typ | Beschreibung |
|---|---|---|
stat | string | z.input<typeof helperStatSchema> |
Objekt-Form (validiert über helperStatSchema):
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
stat | string | ✔ | Name der zu erfassenden Statistik. |
Rückgabewert: Promise<{ status: string }>
.getImageURlFromSkill(skillId)
Löst eine Skill-ID zur öffentlichen URL des hinterlegten Bildes auf.
| Parameter | Typ | Beschreibung |
|---|---|---|
skillId | string | z.input<typeof helperSkillIdSchema> |
Objekt-Form (validiert über helperSkillIdSchema):
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
skillId | string | ✔ | ID des betroffenen Skills. |
Rückgabewert: Promise<string>
.currentLanguage()
Gibt die aktuelle Sprache des Bots zurück (z. B. "de", "en").
Rückgabewert: string