Method constructor

src/utils/safe-url.ts:44–128

* Parse a URL and handle special characters in passwords * This is a safe alternative to the URL constructor * * @param urlString - The DSN string to parse

(urlString: string)

   * @param urlString - The DSN string to parse
   */
  constructor(urlString: string) {
    // Initialize with defaults
    this.protocol = '';
    this.hostname = '';
    this.port = '';
    this.pathname = '';
    this.username = '';
    this.password = '';
    this.searchParams = new Map<string, string>();

    // Validate URL string
    if (!urlString || urlString.trim() === '') {
      throw new Error('URL string cannot be empty');
    }

    try {
      // Extract protocol
      const protocolSeparator: number = urlString.indexOf('://');
      if (protocolSeparator !== -1) {
        this.protocol = urlString.substring(0, protocolSeparator + 1); // includes the colon
        urlString = urlString.substring(protocolSeparator + 3); // rest after ://
      } else {
        throw new Error('Invalid URL format: missing protocol (e.g., "mysql://")');
      }

      // Extract query params if any
      const questionMarkIndex: number = urlString.indexOf('?');
      let queryParams: string = '';
      if (questionMarkIndex !== -1) {
        queryParams = urlString.substring(questionMarkIndex + 1);
        urlString = urlString.substring(0, questionMarkIndex);

        // Parse query parameters
        queryParams.split('&').forEach(pair => {
          const parts: string[] = pair.split('=');
          if (parts.length === 2 && parts[0] && parts[1]) {
            this.searchParams.set(parts[0], decodeURIComponent(parts[1]));
          }
        });
      }

      // Extract authentication
      const atIndex: number = urlString.indexOf('@');
      if (atIndex !== -1) {
        const auth: string = urlString.substring(0, atIndex);
        urlString = urlString.substring(atIndex + 1);

        // Split into username and password
        const colonIndex: number = auth.indexOf(':');
        if (colonIndex !== -1) {
          this.username = auth.substring(0, colonIndex);
          this.password = auth.substring(colonIndex + 1);
          
          // Decode username and password
          this.username = decodeURIComponent(this.username);
          this.password = decodeURIComponent(this.password);
        } else {
          this.username = auth;