NetMesh/domain/terminalEncodingPreference.ts

export type TerminalEncodingPreference = 'utf-8' | 'gb18030';

export const isTerminalEncodingPreference = (
  value: string | null | undefined,
): value is TerminalEncodingPreference => value === 'utf-8' || value === 'gb18030';

const normalizeCharsetToken = (value: string): string => value.replace(/[^a-z0-9]/g, "");

const GB18030_CHARSET_TOKENS = new Set(["gb18030", "gbk", "gb2312", "cp936", "ms936"]);
const UTF8_CHARSET_TOKENS = new Set(["utf8", "utf"]);

export const resolveTerminalEncodingFromCharset = (
  charset?: string,
): TerminalEncodingPreference | null => {
  if (!charset) return null;
  const raw = String(charset).trim().toLowerCase();
  if (!raw) return null;

  const localeCodeset = raw.match(/\.([^@]+)(?:@.*)?$/)?.[1];
  const candidates = [raw, localeCodeset].filter((value): value is string => Boolean(value));
  if (candidates.some((candidate) => GB18030_CHARSET_TOKENS.has(normalizeCharsetToken(candidate)))) {
    return 'gb18030';
  }
  if (candidates.some((candidate) => UTF8_CHARSET_TOKENS.has(normalizeCharsetToken(candidate)))) {
    return 'utf-8';
  }
  return null;
};

export const resolveInitialTerminalEncoding = (
  charset?: string,
  rememberedEncoding?: string | null,
): TerminalEncodingPreference => {
  const charsetEncoding = resolveTerminalEncodingFromCharset(charset);
  const remembered = isTerminalEncodingPreference(rememberedEncoding) ? rememberedEncoding : null;

  if (remembered && (charsetEncoding !== null || !String(charset ?? "").trim())) {
    return remembered;
  }

  return charsetEncoding ?? 'utf-8';
};

export const terminalEncodingPreferenceToCharset = (
  encoding: TerminalEncodingPreference,
): string => (encoding === 'gb18030' ? 'GB18030' : 'UTF-8');

export type TerminalEncodingAttachConnection = 'ssh' | 'telnet' | 'serial' | 'other';

export const shouldSyncTerminalEncodingOnAttach = ({
  connection,
  userPickedEncoding,
  hasRememberedEncoding,
}: {
  connection: TerminalEncodingAttachConnection;
  userPickedEncoding: boolean;
  hasRememberedEncoding: boolean;
}): boolean => {
  if (connection === 'ssh') return true;
  if (connection === 'telnet' || connection === 'serial') {
    return userPickedEncoding || hasRememberedEncoding;
  }
  return false;
};

export const createTerminalEncodingStorageKey = (
  prefix: string,
  host: {
    id?: string;
    protocol?: string;
    username?: string;
    hostname?: string;
    port?: number;
  },
): string => {
  const stableHostId = host.id?.trim();
  const rawKey = stableHostId || [
    host.protocol || 'ssh',
    host.username || '',
    host.hostname || '',
    host.port ?? '',
  ].join('|');
  return `${prefix}${encodeURIComponent(rawKey)}`;
};