Function validateKey

src/utils/localValidate.ts:26–46

(key: string)

const MAX_KEY_LENGTH = 128

export function validateKey(key: string): void {
  if (!key) {
    throw new Error('Empty key')
  }
  if (key.length > MAX_KEY_LENGTH) {
    throw new Error(`Key too long (max ${MAX_KEY_LENGTH})`)
  }
  if (!KEY_REGEX.test(key)) {
    throw new Error(`Invalid key chars: ${JSON.stringify(key)}`)
  }
  if (key.startsWith('.')) {
    throw new Error('Leading dot forbidden')
  }
  // M6 fix: match the basename (pre-dot component) so e.g. NUL.txt and
  // CON.foo are also rejected. On Windows these still alias to the device
  // file regardless of extension and would silently lose data.
  const basenameComponent = key.includes('.') ? key.split('.')[0]! : key
  if (WINDOWS_RESERVED_BASENAME.test(basenameComponent)) {
    throw new Error(`Windows reserved name: ${key}`)
  }
}

/** Returns true iff key would pass validateKey (no throw). Useful for guards. */
export function isValidKey(key: string): boolean {