URL Parsing API

dhoro url = url_parse("https://user:pass@api.example.com:8080/v1/users?active=true#top");

dekho(url.Href);      // "https://user:pass@api.example.com:8080/v1/users?active=true#top"
dekho(url.Protocol);  // "https:"
dekho(url.Username);  // "user"
dekho(url.Password);  // "pass"
dekho(url.Hostname);  // "api.example.com"
dekho(url.Port);      // "8080"
dekho(url.Host);      // "api.example.com:8080"
dekho(url.Pathname);  // "/v1/users"
dekho(url.Search);    // "?active=true"
dekho(url.Hash);      // "#top"
dekho(url.Origin);    // "https://api.example.com:8080"

// From query string
dhoro params1 = url_query_params("?name=John&age=30");
dhoro params2 = url_query_params("name=John&age=30");  // Works without "?"

// From URL object
dhoro url = url_parse("https://api.com/users?role=admin");
dhoro params3 = url_query_params(url.Search);

// Empty params
dhoro params4 = url_query_params("");  // Create empty params

dhoro params = url_query_params("?name=John&age=30&tag=js&tag=go");

dhoro name = url_query_get(params, "name");    // "John"
dhoro age = url_query_get(params, "age");      // "30"
dhoro tag = url_query_get(params, "tag");      // "js" (first value)
dhoro missing = url_query_get(params, "city"); // null

jodi (name != mittha) {
  dekho("Name is:", name);
} nahole {
  dekho("Name not found");
}

dhoro params = url_query_params("?name=John&age=30");

// Set new parameter
url_query_set(params, "city", "Boston");
dekho(url_query_toString(params));  // "name=John&age=30&city=Boston"

// Replace existing parameter
url_query_set(params, "age", "31");
dekho(url_query_toString(params));  // "name=John&age=31&city=Boston"

// Set replaces all values if multiple exist
url_query_set(params, "tag", "first");
url_query_append(params, "tag", "second");
url_query_set(params, "tag", "only");  // Removes "first" and "second"
dekho(url_query_get(params, "tag"));   // "only"

dhoro params = url_query_params("?name=John");

// Append multiple values for same key
url_query_append(params, "tag", "javascript");
url_query_append(params, "tag", "golang");
url_query_append(params, "tag", "python");

dekho(url_query_toString(params));
// "name=John&tag=javascript&tag=golang&tag=python"

// Get only returns first value
dekho(url_query_get(params, "tag"));  // "javascript"

// Get all values
dhoro allTags = url_query_values(params);  // ["John", "javascript", "golang", "python"]

dhoro params = url_query_params("?name=John&age=30&city=Boston");

dekho(url_query_toString(params));
// "name=John&age=30&city=Boston"

// Delete a parameter
url_query_delete(params, "age");
dekho(url_query_toString(params));
// "name=John&city=Boston"

// Delete removes all values if multiple exist
url_query_append(params, "tag", "js");
url_query_append(params, "tag", "go");
url_query_delete(params, "tag");  // Removes both values
dekho(url_query_has(params, "tag"));  // mittha

dhoro params = url_query_params("?name=John&age=30");

jodi (url_query_has(params, "name")) {
  dekho("Name exists:", url_query_get(params, "name"));
}

jodi (url_query_has(params, "email")) {
  dekho("Email exists");
} nahole {
  dekho("Email not found");  // This will print
}

// Use for conditional logic
jodi (!url_query_has(params, "page")) {
  url_query_set(params, "page", "1");  // Set default page
}

dhoro params = url_query_params("?name=John&age=30&city=Boston");

dhoro keys = url_query_keys(params);
dekho(keys);  // ["name", "age", "city"]

// Iterate over keys
ghuriye (dhoro i = 0; i < dorghyo(keys); i = i + 1) {
  dhoro key = keys[i];
  dhoro value = url_query_get(params, key);
  dekho(key, "=", value);
}

// Multiple values for same key
url_query_append(params, "tag", "js");
url_query_append(params, "tag", "go");
dhoro allKeys = url_query_keys(params);
// ["name", "age", "city", "tag", "tag"] - duplicates included

dhoro params = url_query_params("?name=John&age=30&city=Boston");

dhoro values = url_query_values(params);
dekho(values);  // ["John", "30", "Boston"]

// Get all values including duplicates
url_query_append(params, "tag", "javascript");
url_query_append(params, "tag", "golang");
dhoro allValues = url_query_values(params);
// ["John", "30", "Boston", "javascript", "golang"]

// Iterate over values
ghuriye (dhoro i = 0; i < dorghyo(values); i = i + 1) {
  dekho("Value", i, ":", values[i]);
}

dhoro params = url_query_params("");

url_query_set(params, "name", "John Doe");
url_query_set(params, "age", "30");
url_query_set(params, "city", "New York");

dhoro queryString = url_query_toString(params);
dekho(queryString);  // "name=John+Doe&age=30&city=New+York"

// Build complete URL
dhoro baseUrl = "https://api.example.com/users";
dhoro fullUrl = baseUrl + "?" + queryString;
dekho(fullUrl);
// "https://api.example.com/users?name=John+Doe&age=30&city=New+York"

// Special characters are automatically encoded
url_query_set(params, "search", "hello world & more");
dekho(url_query_toString(params));
// "name=John+Doe&age=30&city=New+York&search=hello+world+%26+more"

// Reusable URL builder
kaj URLBuilder(baseUrl) {
  dhoro params = url_query_params("");
  
  ferao {
    setParam: kaj(key, value) {
      url_query_set(params, key, value);
      ferao ei;  // Return self for chaining
    },
    
    appendParam: kaj(key, value) {
      url_query_append(params, key, value);
      ferao ei;
    },
    
    removeParam: kaj(key) {
      url_query_delete(params, key);
      ferao ei;
    },
    
    build: kaj() {
      dhoro queryString = url_query_toString(params);
      ferao queryString != "" ? baseUrl + "?" + queryString : baseUrl;
    }
  };
}

// Usage with method chaining
dhoro url = URLBuilder("https://api.example.com/users")
  .setParam("status", "active")
  .setParam("role", "admin")
  .setParam("page", "1")
  .appendParam("tag", "verified")
  .appendParam("tag", "premium")
  .build();

dekho(url);
// "https://api.example.com/users?status=active&role=admin&page=1&tag=verified&tag=premium"

// Merge query parameters from multiple sources
kaj mergeQueryParams(params1, params2) {
  dhoro merged = url_query_params("");
  
  // Add all from first params
  dhoro keys1 = url_query_keys(params1);
  dhoro values1 = url_query_values(params1);
  ghuriye (dhoro i = 0; i < dorghyo(keys1); i = i + 1) {
    url_query_append(merged, keys1[i], values1[i]);
  }
  
  // Add all from second params (may override)
  dhoro keys2 = url_query_keys(params2);
  dhoro values2 = url_query_values(params2);
  ghuriye (dhoro i = 0; i < dorghyo(keys2); i = i + 1) {
    // Use set to override, or append to add multiple
    url_query_set(merged, keys2[i], values2[i]);
  }
  
  ferao merged;
}

// Usage
dhoro defaultParams = url_query_params("?limit=20&sort=asc");
dhoro userParams = url_query_params("?page=5&filter=active");
dhoro finalParams = mergeQueryParams(defaultParams, userParams);

dekho(url_query_toString(finalParams));
// "limit=20&sort=asc&page=5&filter=active"

// Route handler based on URL path and params
kaj routeRequest(urlString) {
  dhoro url = url_parse(urlString);
  dhoro path = url.Pathname;
  dhoro params = url_query_params(url.Search);
  
  // Route based on path
  jodi (path == "/api/users") {
    // Handle users endpoint
    dhoro page = url_query_has(params, "page") ? 
      url_query_get(params, "page") : "1";
    dhoro limit = url_query_has(params, "limit") ? 
      url_query_get(params, "limit") : "20";
    
    ferao handleUsers(page, limit, params);
    
  } nahole jodi (path == "/api/products") {
    // Handle products endpoint
    dhoro category = url_query_get(params, "category");
    dhoro minPrice = url_query_get(params, "minPrice");
    dhoro maxPrice = url_query_get(params, "maxPrice");
    
    ferao handleProducts(category, minPrice, maxPrice);
    
  } nahole jodi (khuje(path, "/api/users/") == 0) {
    // Handle specific user by ID
    dhoro pathParts = bibhajan(path, "/");
    dhoro userId = pathParts[3];
    
    ferao handleUserById(userId, params);
  }
  
  ferao {status: 404, message: "Route not found"};
}

// Helper functions
kaj handleUsers(page, limit, params) {
  dhoro filters = [];
  
  jodi (url_query_has(params, "status")) {
    joro(filters, "status=" + url_query_get(params, "status"));
  }
  
  jodi (url_query_has(params, "role")) {
    joro(filters, "role=" + url_query_get(params, "role"));
  }
  
  dekho("Fetching users: page=" + page + ", limit=" + limit);
  dekho("Filters:", joro(filters, ", "));
  
  ferao {status: 200, data: "users list"};
}

// Usage
dhoro result = routeRequest("https://api.com/api/users?page=2&status=active&role=admin");
dekho(result);

// Build paginated URLs
kaj buildPaginationURLs(currentUrl, totalPages) {
  dhoro url = url_parse(currentUrl);
  dhoro params = url_query_params(url.Search);
  
  dhoro currentPage = url_query_has(params, "page") ? 
    text_shongkha(url_query_get(params, "page")) : 1;
  
  dhoro baseUrl = url.Origin + url.Pathname;
  
  // Build URL for specific page
  dhoro buildPageUrl = kaj(pageNum) {
    dhoro newParams = url_query_params(url.Search);
    url_query_set(newParams, "page", shongkha_text(pageNum));
    ferao baseUrl + "?" + url_query_toString(newParams);
  };
  
  dhoro urls = {
    first: buildPageUrl(1),
    prev: currentPage > 1 ? buildPageUrl(currentPage - 1) : mittha,
    current: currentUrl,
    next: currentPage < totalPages ? buildPageUrl(currentPage + 1) : mittha,
    last: buildPageUrl(totalPages)
  };
  
  ferao urls;
}

// Usage
dhoro currentUrl = "https://api.com/users?status=active&page=3&limit=20";
dhoro pagination = buildPaginationURLs(currentUrl, 10);

dekho("First:", pagination.first);
dekho("Previous:", pagination.prev);
dekho("Next:", pagination.next);
dekho("Last:", pagination.last);