openclaw/src/pairing/pairing-store-keys.ts

import { normalizeLowercaseStringOrEmpty } from "@openclaw/normalization-core/string-coerce";
import { normalizeUniqueStringEntries } from "@openclaw/normalization-core/string-normalization";
import { DEFAULT_ACCOUNT_ID } from "../routing/session-key.js";
import type { PairingChannel } from "./pairing-store.types.js";

type PairingKeyKind = "channel" | "account id";

function describePairingKeyInput(value: unknown): string {
  if (value === null) {
    return "null";
  }
  if (Array.isArray(value)) {
    return "array";
  }
  if (typeof value === "string") {
    const trimmed = value.trim();
    return trimmed ? `string length ${trimmed.length}` : "empty string";
  }
  if (typeof value === "number" && !Number.isFinite(value)) {
    return "non-finite number";
  }
  return typeof value;
}

function invalidPairingKeyError(kind: PairingKeyKind, reason: string, value: unknown): Error {
  return new Error(`invalid pairing ${kind}: ${reason}; got ${describePairingKeyInput(value)}`);
}

function normalizePairingKey(value: unknown, kind: PairingKeyKind): string {
  if (typeof value !== "string") {
    throw invalidPairingKeyError(kind, "expected non-empty string", value);
  }
  const raw = normalizeLowercaseStringOrEmpty(value);
  if (!raw) {
    throw invalidPairingKeyError(kind, "expected non-empty string", value);
  }
  const safe = raw.replace(/[\\/:*?"<>|]/g, "_").replace(/\.\./g, "_");
  if (!safe || safe === "_") {
    throw invalidPairingKeyError(kind, "sanitized key is empty", value);
  }
  return safe;
}

export function safeChannelKey(channel: PairingChannel): string {
  return normalizePairingKey(channel, "channel");
}

export function safeAccountKey(accountId: string): string {
  return normalizePairingKey(accountId, "account id");
}

export function dedupePreserveOrder(entries: string[]): string[] {
  return normalizeUniqueStringEntries(entries);
}

export function resolveAllowFromAccountId(accountId?: string): string {
  if (accountId != null && typeof accountId !== "string") {
    throw invalidPairingKeyError("account id", "expected non-empty string", accountId);
  }
  return normalizeLowercaseStringOrEmpty(accountId) || DEFAULT_ACCOUNT_ID;
}