Files
Betriebsf-hrungssoftware/src/domain/vcard.ts
Claude 8fde24a8a2
Some checks failed
Prüfung / tests (push) Has been cancelled
Prüfung / container (push) Has been cancelled
Kontakte mit dem Handy abgleichen über Nextcloud-Adressbuch, .vcf einlesen (0.44.0)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AmyPfuNc4sCRfaF3oURXZz
2026-11-04 19:48:42 +00:00

133 lines
6.6 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// Kontakte mit dem Handy abgleichen (Henning, 04.11.2026): vCard lesen und schreiben (RFC 2426/6350, wie Apple sie liefert).
// Das Programm pflegt nur Name, Firma, Telefon, Mobil, E-Mail und Adresse; alles andere in der Karte (Foto,
// Geburtstag, weitere Nummern) bleibt beim Zurückschreiben unverändert stehen.
export interface KontaktFelder {
name: string;
firma: string | null;
telefon: string | null;
mobil: string | null;
email: string | null;
strasse: string | null;
plz: string | null;
ort: string | null;
}
export const FELDER: (keyof KontaktFelder)[] = ["name", "firma", "telefon", "mobil", "email", "strasse", "plz", "ort"];
interface Zeile {
/** Gruppe wie „item1“ bei Apple */
gruppe: string;
name: string;
params: string;
wert: string;
}
/** Fortsetzungszeilen zusammenführen und in Eigenschaften zerlegen */
function zeilen(text: string): Zeile[] {
const roh = text.replace(/\r\n|\r/g, "\n").replace(/\n[ \t]/g, "").split("\n").filter((z) => z.trim());
return roh.map((z) => {
const i = z.indexOf(":");
const kopf = i < 0 ? z : z.slice(0, i);
const wert = i < 0 ? "" : z.slice(i + 1);
const [nameTeil, ...params] = kopf.split(";");
const punkt = nameTeil!.lastIndexOf(".");
return { gruppe: punkt < 0 ? "" : nameTeil!.slice(0, punkt), name: nameTeil!.slice(punkt + 1).toUpperCase(), params: params.join(";"), wert };
});
}
const ent = (s: string) => s.replace(/\\n/gi, "\n").replace(/\\([,;\\])/g, "$1").trim();
const esc = (s: string) => s.replace(/\\/g, "\\\\").replace(/\n/g, "\\n").replace(/([,;])/g, "\\$1");
/** Strukturierte Werte (N, ADR, ORG) an unmaskierten Semikolons teilen */
const teile = (s: string) => s.split(/(?<!\\);/).map(ent);
const leer = (s: string | undefined | null) => (s && s.trim() ? s.trim() : null);
const istMobil = (z: Zeile) => /type=[^;:]*\b(cell|iphone|mobile)\b/i.test(z.params) || /\bcell\b/i.test(z.params);
const istTelefon = (z: Zeile) => z.name === "TEL" && !/\bfax\b/i.test(z.params);
/** Einzelne Karten aus einer .vcf-Datei mit vielen Kontakten */
export function kartenAus(text: string): string[] {
return [...text.replace(/\r\n|\r/g, "\n").matchAll(/BEGIN:VCARD[\s\S]*?END:VCARD/gi)].map((m) => m[0]);
}
export function uidVon(karte: string): string | null {
return leer(zeilen(karte).find((z) => z.name === "UID")?.wert);
}
/** Letzte Änderung laut Karte (REV), falls angegeben */
export function revVon(karte: string): string | null {
const w = leer(zeilen(karte).find((z) => z.name === "REV")?.wert);
if (!w) return null;
const m = /^(\d{4})-?(\d{2})-?(\d{2})(?:T(\d{2}):?(\d{2}):?(\d{2}))?/.exec(w);
return m ? `${m[1]}-${m[2]}-${m[3]}T${m[4] ?? "00"}:${m[5] ?? "00"}:${m[6] ?? "00"}Z` : null;
}
export function felderAus(karte: string): KontaktFelder {
const z = zeilen(karte);
const erstes = (n: string) => z.find((x) => x.name === n);
const org = leer(teile(erstes("ORG")?.wert ?? "").filter(Boolean).join(", "));
const n = teile(erstes("N")?.wert ?? "");
const ausN = leer([n[3], n[1], n[2], n[0], n[4]].filter((x) => x && x.trim()).join(" "));
const fn = leer(ent(erstes("FN")?.wert ?? ""));
const tels = z.filter(istTelefon);
const mobil = tels.find(istMobil);
const telefon = tels.find((t) => t !== mobil);
const adr = z.find((x) => x.name === "ADR");
const a = adr ? teile(adr.wert) : [];
return {
name: fn ?? ausN ?? org ?? "(ohne Namen)",
firma: org,
telefon: leer(telefon?.wert),
mobil: leer(mobil?.wert),
email: leer(erstes("EMAIL")?.wert),
strasse: leer([a[1], a[2]].filter((x) => x && x.trim()).join(" ")),
plz: leer(a[5]),
ort: leer(a[3]),
};
}
/** Gleiche Inhalte erkennen, ohne auf Schreibweise von Leerzeichen zu achten */
export function fingerabdruck(f: Partial<KontaktFelder>): string {
return JSON.stringify(FELDER.map((k) => (f[k] ?? "").toString().replace(/\s+/g, " ").trim()));
}
/** Telefonnummern vergleichbar machen: nur Ziffern, +49/0049 wie 0 */
export function nummer(t: string | null | undefined): string {
const d = (t ?? "").replace(/^\+/, "00").replace(/\D/g, "");
return d.replace(/^0049/, "0");
}
/**
* Karte mit den Feldern aus dem Programm. Eine vorhandene Karte wird nur in den gepflegten Zeilen geändert;
* ohne Karte entsteht eine neue (vCard 3.0, wie Apple sie anlegt).
*/
export function karteMit(f: KontaktFelder, uid: string, alt: string | null, jetzt = new Date()): string {
const z = alt ? zeilen(alt).filter((x) => !["BEGIN", "END"].includes(x.name)) : [{ gruppe: "", name: "VERSION", params: "", wert: "3.0" }];
const setze = (finde: (x: Zeile) => boolean, name: string, params: string, wert: string | null) => {
const i = z.findIndex(finde);
if (!wert) { if (i >= 0) z.splice(i, 1); return; }
if (i >= 0) z[i] = { ...z[i]!, wert };
else z.push({ gruppe: "", name, params, wert });
};
const firmaKontakt = !!f.firma && f.name === f.firma;
const altFn = ent(z.find((x) => x.name === "FN")?.wert ?? "");
setze((x) => x.name === "FN", "FN", "", esc(f.name));
// N: Nachname;Vorname – bei Firmen bleibt N leer wie bei Apple
const worte = f.name.trim().split(/\s+/);
const nWert = firmaKontakt ? ";;;;" : worte.length > 1 ? `${esc(worte.at(-1)!)};${esc(worte.slice(0, -1).join(" "))};;;` : `${esc(f.name)};;;;`;
// N nur neu setzen, wenn sich der Name geändert hat; sonst bleibt Apples Aufteilung (z. B. Titel, Namenszusatz)
if (!z.some((x) => x.name === "N") || altFn !== f.name) setze((x) => x.name === "N", "N", "", nWert);
setze((x) => x.name === "ORG", "ORG", "", f.firma ? `${esc(f.firma)};` : null);
setze((x) => istTelefon(x) && istMobil(x), "TEL", "type=CELL;type=VOICE", f.mobil);
setze((x) => istTelefon(x) && !istMobil(x), "TEL", "type=WORK;type=VOICE", f.telefon);
setze((x) => x.name === "EMAIL", "EMAIL", "type=INTERNET;type=WORK", f.email);
const adr = f.strasse || f.plz || f.ort ? `;;${esc(f.strasse ?? "")};${esc(f.ort ?? "")};;${esc(f.plz ?? "")};` : null;
const altAdr = z.find((x) => x.name === "ADR");
// Land und Region einer vorhandenen Adresse bleiben stehen
const adrWert = adr && altAdr ? (() => { const t = altAdr.wert.split(/(?<!\\);/); return [t[0] ?? "", t[1] ?? "", esc(f.strasse ?? ""), esc(f.ort ?? ""), t[4] ?? "", esc(f.plz ?? ""), t[6] ?? ""].join(";"); })() : adr;
setze((x) => x.name === "ADR", "ADR", "type=WORK", adrWert);
setze((x) => x.name === "UID", "UID", "", uid);
setze((x) => x.name === "REV", "REV", "", jetzt.toISOString().replace(/\.\d+Z$/, "Z"));
const zeile = (x: Zeile) => `${x.gruppe ? `${x.gruppe}.` : ""}${x.name}${x.params ? `;${x.params}` : ""}:${x.wert}`;
return ["BEGIN:VCARD", ...z.map(zeile), "END:VCARD"].join("\r\n") + "\r\n";
}