docs: continue inline comment pass (#88849)

Adds broad inline comments and JSDoc for CLI, cron, outbound/channel, plugin SDK, ACP, shared helpers, net policy, and related utility contracts. Proof: git diff --check on latest exact head plus focused cron tests passed; CI had no failing checks observed before merge attempt.
This commit is contained in:
Peter Steinberger
2026-05-31 22:32:28 -04:00
committed by GitHub
parent 4932391e8a
commit 1e7510ae10
230 changed files with 1403 additions and 105 deletions

View File

@@ -108,10 +108,12 @@ export function normalizeCsvOrLooseStringList(value: unknown): string[] {
}
function normalizeSlugInput(raw?: string | null) {
// NFC keeps visually identical composed/decomposed Unicode labels matching the
// same slug while preserving non-Latin channel and room names.
return (normalizeOptionalLowercaseString(raw) ?? "").normalize("NFC");
}
/** Normalizes user-facing names into permissive lowercase hyphen slugs. */
/** Normalizes user-facing names into permissive lowercase slugs that may keep #/@/._+. */
export function normalizeHyphenSlug(raw?: string | null) {
const trimmed = normalizeSlugInput(raw);
if (!trimmed) {
@@ -122,7 +124,7 @@ export function normalizeHyphenSlug(raw?: string | null) {
return cleaned.replace(/-{2,}/g, "-").replace(/^[-.]+|[-.]+$/g, "");
}
/** Normalizes @/#-prefixed names into lowercase hyphen slugs without the prefix. */
/** Normalizes @/#-prefixed channel names into strict lowercase hyphen slugs without the prefix. */
export function normalizeAtHashSlug(raw?: string | null) {
const trimmed = normalizeSlugInput(raw);
if (!trimmed) {