HttpURLParser.h

// Copyright (c) Stefano Cristiano
// SPDX-License-Identifier: MIT
#pragma once
#include "../Foundation/Result.h"
#include "../Foundation/StringSpan.h"
#include "HttpExport.h"
 
namespace SC
{
 
struct SC_HTTP_EXPORT HttpURLQueryItem
{
    StringSpan name;
    StringSpan value;
    bool       hasValue = false;
};
 
struct SC_HTTP_EXPORT HttpURLQueryIterator
{
    explicit HttpURLQueryIterator(StringSpan search);
 
    bool next(HttpURLQueryItem& item);
 
  private:
    StringSpan search;
    size_t     cursor = 0;
};
 
struct SC_HTTP_EXPORT HttpFormUrlEncodedIterator
{
    explicit HttpFormUrlEncodedIterator(StringSpan body);
 
    bool next(HttpURLQueryItem& item);
 
  private:
    StringSpan body;
    size_t     cursor = 0;
};
 
SC_HTTP_EXPORT Result HttpPercentDecode(StringSpan input, Span<char> storage, StringSpan& output);
 
SC_HTTP_EXPORT Result HttpFormUrlDecode(StringSpan input, Span<char> storage, StringSpan& output);
 
struct SC_HTTP_EXPORT HttpRequestTargetView
{
    StringSpan raw;    
    StringSpan path;   
    StringSpan search; 
    StringSpan hash;   
 
    Result parse(StringSpan requestTarget);
 
    bool getQueryValue(StringSpan name, StringSpan& value) const;
};
 
struct SC_HTTP_EXPORT HttpURLParser
{
    StringSpan protocol; 
    StringSpan username; 
    StringSpan password; 
    StringSpan hostname; 
    uint16_t   port;     
    StringSpan host;     
    StringSpan pathname; 
    StringSpan path;     
    StringSpan search;   
    StringSpan hash;     
 
    Result parse(StringSpan url);
 
    bool getQueryValue(StringSpan name, StringSpan& value) const;
 
    static bool getQueryValue(StringSpan search, StringSpan name, StringSpan& value);
 
  private:
    StringEncoding encoding;
 
    Result parsePath();
    Result parseHost();
    Result validateProtocol();
    Result validatePath();
    Result validateHost();
    Result parseUserPassword(StringSpan userPassword);
    struct Internal;
};
 
} // namespace SC