@ooneex/url 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ooneex
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,478 @@
+# @ooneex/url
+
+A comprehensive TypeScript/JavaScript library for working with URLs. This package provides powerful URL parsing, manipulation, and building capabilities with a clean, type-safe API for web applications.
+
+![Browser](https://img.shields.io/badge/Browser-Compatible-green?style=flat-square&logo=googlechrome)
+![Bun](https://img.shields.io/badge/Bun-Compatible-orange?style=flat-square&logo=bun)
+![Deno](https://img.shields.io/badge/Deno-Compatible-blue?style=flat-square&logo=deno)
+![Node.js](https://img.shields.io/badge/Node.js-Compatible-green?style=flat-square&logo=node.js)
+![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue?style=flat-square&logo=typescript)
+![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)
+
+## Features
+
+✅ **Complete URL Parsing** - Parse and extract all URL components (protocol, hostname, port, path, queries, fragment)
+
+✅ **Type-Safe** - Full TypeScript support with proper type definitions
+
+✅ **Immutable & Mutable** - Choose between ReadonlyUrl for parsing or Url for manipulation
+
+✅ **Cross-Platform** - Works in Browser, Node.js, Bun, and Deno
+
+✅ **Smart Query Parsing** - Automatically converts query parameters to appropriate types (string, number, boolean)
+
+✅ **Subdomain Detection** - Intelligently separates subdomains from domains
+
+✅ **Port Handling** - Proper default port detection and custom port support
+
+✅ **Path Normalization** - Clean path handling with proper slash management
+
+✅ **Zero Dependencies** - No external dependencies required (uses workspace utilities)
+
+## Installation
+
+### Bun
+```bash
+bun add @ooneex/url
+```
+
+### pnpm
+```bash
+pnpm add @ooneex/url
+```
+
+### Yarn
+```bash
+yarn add @ooneex/url
+```
+
+### npm
+```bash
+npm install @ooneex/url
+```
+
+## Usage
+
+### Basic URL Parsing
+
+```typescript
+import { ReadonlyUrl } from '@ooneex/url';
+
+const url = new ReadonlyUrl('https://blog.example.com:3000/posts/123?page=2&sort=desc#comments');
+
+// Get URL components
+console.log(url.getProtocol()); // "https"
+console.log(url.getHostname()); // "blog.example.com"
+console.log(url.getSubdomain()); // "blog"
+console.log(url.getDomain()); // "example.com"
+console.log(url.getPort()); // 3000
+console.log(url.getPath()); // "/posts/123"
+console.log(url.getQueries()); // { page: 2, sort: "desc" }
+console.log(url.getFragment()); // "comments"
+console.log(url.getOrigin()); // "https://blog.example.com:3000"
+```
+
+### URL Manipulation
+
+```typescript
+import { Url } from '@ooneex/url';
+
+const url = new Url('https://example.com');
+
+// Chain modifications
+url.setProtocol('http')
+   .setHostname('api.example.com')
+   .setPort(8080)
+   .setPath('/v1/users')
+   .addQuery('limit', 10)
+   .addQuery('offset', 0)
+   .setFragment('results');
+
+console.log(url.toString()); // "http://api.example.com:8080/v1/users?limit=10&offset=0#results"
+```
+
+### Advanced Usage
+
+```typescript
+import { Url, ReadonlyUrl } from '@ooneex/url';
+
+// Parse complex URLs with multiple subdomains
+const complexUrl = new ReadonlyUrl('https://dev.api.example.com/v2/users?active=true&count=100');
+console.log(complexUrl.getSubdomain()); // "dev.api"
+console.log(complexUrl.getDomain()); // "example.com"
+console.log(complexUrl.getQueries()); // { active: true, count: 100 }
+
+// Build URLs programmatically
+const apiUrl = new Url('https://api.example.com')
+  .setPath('/users')
+  .setQueries({
+    page: 1,
+    limit: 20,
+    active: true,
+    search: 'john'
+  });
+
+console.log(apiUrl.toString()); // "https://api.example.com/users?page=1&limit=20&active=true&search=john"
+
+// Handle localhost and IP addresses
+const localUrl = new ReadonlyUrl('http://localhost:3000/dashboard');
+console.log(localUrl.getSubdomain()); // null
+console.log(localUrl.getDomain()); // "localhost"
+
+const ipUrl = new ReadonlyUrl('http://192.168.1.1:8080/status');
+console.log(ipUrl.getSubdomain()); // null
+console.log(ipUrl.getDomain()); // "192.168.1.1"
+```
+
+## API Reference
+
+### `ReadonlyUrl` Class
+
+Immutable URL parsing class that provides read-only access to URL components.
+
+#### Constructor
+
+##### `new ReadonlyUrl(url: string | URL)`
+Creates a new ReadonlyUrl instance from a URL string or URL object.
+
+**Parameters:**
+- `url` - The URL string or URL object to parse
+
+**Example:**
+```typescript
+const url = new ReadonlyUrl('https://example.com/path?query=value#fragment');
+const urlFromObject = new ReadonlyUrl(new URL('https://example.com'));
+```
+
+#### Methods
+
+##### `getNative(): URL`
+Returns the native JavaScript URL object.
+
+**Returns:** Native URL object
+
+**Example:**
+```typescript
+const nativeUrl = url.getNative();
+console.log(nativeUrl instanceof URL); // true
+```
+
+##### `getProtocol(): string`
+Gets the protocol (without the colon).
+
+**Returns:** Protocol string (e.g., "https", "http")
+
+**Example:**
+```typescript
+const url = new ReadonlyUrl('https://example.com');
+console.log(url.getProtocol()); // "https"
+```
+
+##### `getSubdomain(): string | null`
+Gets the subdomain portion of the hostname.
+
+**Returns:** Subdomain string or null if no subdomain
+
+**Example:**
+```typescript
+const url = new ReadonlyUrl('https://blog.example.com');
+console.log(url.getSubdomain()); // "blog"
+
+const url2 = new ReadonlyUrl('https://example.com');
+console.log(url2.getSubdomain()); // null
+```
+
+##### `getDomain(): string`
+Gets the domain portion of the hostname.
+
+**Returns:** Domain string
+
+**Example:**
+```typescript
+const url = new ReadonlyUrl('https://blog.example.com');
+console.log(url.getDomain()); // "example.com"
+```
+
+##### `getHostname(): string`
+Gets the full hostname.
+
+**Returns:** Hostname string
+
+**Example:**
+```typescript
+const url = new ReadonlyUrl('https://blog.example.com:3000');
+console.log(url.getHostname()); // "blog.example.com"
+```
+
+##### `getPort(): number`
+Gets the port number.
+
+**Returns:** Port number (defaults to 80 if not specified)
+
+**Example:**
+```typescript
+const url = new ReadonlyUrl('https://example.com:3000');
+console.log(url.getPort()); // 3000
+
+const url2 = new ReadonlyUrl('https://example.com');
+console.log(url2.getPort()); // 80
+```
+
+##### `getPath(): string`
+Gets the URL path.
+
+**Returns:** Path string (always starts with "/")
+
+**Example:**
+```typescript
+const url = new ReadonlyUrl('https://example.com/users/123');
+console.log(url.getPath()); // "/users/123"
+```
+
+##### `getQueries(): Record<string, ScalarType>`
+Gets all query parameters as an object with automatically parsed types.
+
+**Returns:** Object with query parameters (values can be string, number, or boolean)
+
+**Example:**
+```typescript
+const url = new ReadonlyUrl('https://example.com?page=1&active=true&name=john');
+console.log(url.getQueries()); // { page: 1, active: true, name: "john" }
+```
+
+##### `getFragment(): string`
+Gets the URL fragment (without the hash).
+
+**Returns:** Fragment string
+
+**Example:**
+```typescript
+const url = new ReadonlyUrl('https://example.com#section');
+console.log(url.getFragment()); // "section"
+```
+
+##### `getBase(): string`
+Gets the base URL (protocol + hostname + port).
+
+**Returns:** Base URL string
+
+**Example:**
+```typescript
+const url = new ReadonlyUrl('https://example.com:3000/path?query=value');
+console.log(url.getBase()); // "https://example.com:3000"
+```
+
+##### `getOrigin(): string`
+Gets the origin (protocol + hostname + port).
+
+**Returns:** Origin string
+
+**Example:**
+```typescript
+const url = new ReadonlyUrl('https://example.com:3000/path');
+console.log(url.getOrigin()); // "https://example.com:3000"
+```
+
+##### `toString(): string`
+Converts the URL to its string representation.
+
+**Returns:** Full URL string
+
+**Example:**
+```typescript
+const url = new ReadonlyUrl('https://example.com/path?query=value#fragment');
+console.log(url.toString()); // "https://example.com/path?query=value#fragment"
+```
+
+### `Url` Class
+
+Mutable URL class that extends ReadonlyUrl with modification capabilities.
+
+#### Constructor
+
+##### `new Url(url: string | URL)`
+Creates a new Url instance from a URL string or URL object.
+
+**Parameters:**
+- `url` - The URL string or URL object to parse
+
+**Example:**
+```typescript
+const url = new Url('https://example.com');
+```
+
+#### Modification Methods
+
+##### `setProtocol(protocol: string): Url`
+Sets the protocol.
+
+**Parameters:**
+- `protocol` - Protocol string (with or without colon)
+
+**Returns:** Self for chaining
+
+**Example:**
+```typescript
+const url = new Url('https://example.com');
+url.setProtocol('http');
+console.log(url.getProtocol()); // "http"
+```
+
+##### `setHostname(hostname: string): Url`
+Sets the hostname and automatically parses subdomain/domain.
+
+**Parameters:**
+- `hostname` - Hostname string
+
+**Returns:** Self for chaining
+
+**Example:**
+```typescript
+const url = new Url('https://example.com');
+url.setHostname('api.example.com');
+console.log(url.getSubdomain()); // "api"
+console.log(url.getDomain()); // "example.com"
+```
+
+##### `setPort(port: number): Url`
+Sets the port number.
+
+**Parameters:**
+- `port` - Port number
+
+**Returns:** Self for chaining
+
+**Example:**
+```typescript
+const url = new Url('https://example.com');
+url.setPort(8080);
+console.log(url.getPort()); // 8080
+```
+
+##### `setPath(path: string): Url`
+Sets the URL path.
+
+**Parameters:**
+- `path` - Path string (leading/trailing slashes are normalized)
+
+**Returns:** Self for chaining
+
+**Example:**
+```typescript
+const url = new Url('https://example.com');
+url.setPath('/api/users');
+console.log(url.getPath()); // "/api/users"
+```
+
+##### `addQuery(key: string, value: ScalarType): Url`
+Adds or updates a query parameter.
+
+**Parameters:**
+- `key` - Query parameter name
+- `value` - Query parameter value (string, number, or boolean)
+
+**Returns:** Self for chaining
+
+**Example:**
+```typescript
+const url = new Url('https://example.com');
+url.addQuery('page', 1)
+   .addQuery('active', true)
+   .addQuery('search', 'john');
+console.log(url.getQueries()); // { page: 1, active: true, search: "john" }
+```
+
+##### `setQueries(queries: Record<string, ScalarType>): Url`
+Sets all query parameters, replacing existing ones.
+
+**Parameters:**
+- `queries` - Object with query parameters
+
+**Returns:** Self for chaining
+
+**Example:**
+```typescript
+const url = new Url('https://example.com?old=value');
+url.setQueries({ page: 1, limit: 10 });
+console.log(url.getQueries()); // { page: 1, limit: 10 }
+```
+
+##### `removeQuery(key: string): Url`
+Removes a specific query parameter.
+
+**Parameters:**
+- `key` - Query parameter name to remove
+
+**Returns:** Self for chaining
+
+**Example:**
+```typescript
+const url = new Url('https://example.com?page=1&limit=10');
+url.removeQuery('page');
+console.log(url.getQueries()); // { limit: 10 }
+```
+
+##### `clearQueries(): Url`
+Removes all query parameters.
+
+**Returns:** Self for chaining
+
+**Example:**
+```typescript
+const url = new Url('https://example.com?page=1&limit=10');
+url.clearQueries();
+console.log(url.getQueries()); // {}
+```
+
+##### `setFragment(fragment: string): Url`
+Sets the URL fragment.
+
+**Parameters:**
+- `fragment` - Fragment string (with or without hash)
+
+**Returns:** Self for chaining
+
+**Example:**
+```typescript
+const url = new Url('https://example.com');
+url.setFragment('section');
+console.log(url.getFragment()); // "section"
+console.log(url.toString()); // "https://example.com#section"
+```
+
+### Types
+
+#### `IReadonlyUrl`
+Interface defining all available read-only URL methods.
+
+#### `IUrl`
+Interface defining all available URL manipulation methods (extends IReadonlyUrl).
+
+#### `ScalarType`
+Type representing valid query parameter values (string, number, or boolean).
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
+
+### Development Setup
+
+1. Clone the repository
+2. Install dependencies: `bun install`
+3. Run tests: `bun run test`
+4. Build the project: `bun run build`
+
+### Guidelines
+
+- Write tests for new features
+- Follow the existing code style
+- Update documentation for API changes
+- Ensure all tests pass before submitting PR
+
+---
+
+Made with ❤️ by the Ooneex team

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+import { ScalarType as ScalarType2 } from "@ooneex/types";
+import { ScalarType } from "@ooneex/types";
+interface IReadonlyUrl {
+	getNative: () => URL;
+	getProtocol: () => string;
+	getSubdomain: () => string | null;
+	getDomain: () => string;
+	getHostname: () => string;
+	getPort: () => number;
+	getPath: () => string;
+	getQueries: () => Record<string, ScalarType>;
+	getFragment: () => string;
+	getBase: () => string;
+	getOrigin: () => string;
+	getQuery: (name: string) => ScalarType | null;
+	toString: () => string;
+}
+interface IUrl extends IReadonlyUrl {
+	setProtocol: (protocol: string) => IUrl;
+	setHostname: (hostname: string) => IUrl;
+	setPort: (port: number) => IUrl;
+	setPath: (path: string) => IUrl;
+	setFragment: (fragment: string) => IUrl;
+	addQuery: (key: string, value: ScalarType) => IUrl;
+	setQueries: (queries: Record<string, ScalarType>) => IUrl;
+	removeQuery: (key: string) => IUrl;
+	clearQueries: () => IUrl;
+}
+declare class ReadonlyUrl implements IReadonlyUrl {
+	protected native: URL;
+	protected protocol: string;
+	protected subdomain: string | null;
+	protected domain: string;
+	protected hostname: string;
+	protected port: number;
+	protected path: string;
+	protected queries: Record<string, ScalarType2>;
+	protected fragment: string;
+	protected base: string;
+	protected origin: string;
+	constructor(url: string | URL);
+	getNative(): URL;
+	getProtocol(): string;
+	getSubdomain(): string | null;
+	getDomain(): string;
+	getHostname(): string;
+	getPort(): number;
+	getPath(): string;
+	getQueries(): Record<string, ScalarType2>;
+	getQuery(name: string): ScalarType2 | null;
+	getFragment(): string;
+	getBase(): string;
+	getOrigin(): string;
+	toString(): string;
+}
+import { ScalarType as ScalarType3 } from "@ooneex/types";
+declare class Url extends ReadonlyUrl implements IUrl {
+	setProtocol(protocol: string): this;
+	setHostname(hostname: string): this;
+	setPort(port: number): this;
+	setPath(path: string): this;
+	addQuery(key: string, value: ScalarType3): this;
+	removeQuery(key: string): this;
+	setQueries(queries: Record<string, ScalarType3>): this;
+	clearQueries(): this;
+	setFragment(fragment: string): this;
+	private updateNativeUrl;
+	private shouldShowPort;
+	private buildQueryString;
+}
+export { Url, ReadonlyUrl, IUrl, IReadonlyUrl };

package/dist/index.js

@@ -0,0 +1,3 @@
+import{parseString as t,trim as x}from"@ooneex/utils";class i{native;protocol;subdomain;domain;hostname;port;path;queries={};fragment;base;origin;constructor(g){if(this.native=new URL(g),this.protocol=x(this.native.protocol,":"),this.subdomain=null,this.hostname=this.native.hostname,this.domain=this.hostname,!/^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(this.hostname)&&this.hostname!=="localhost"){let e=/(?<subdomain>.+)\.(?<domain>[a-z0-9-_]+\.[a-z0-9]+)$/i.exec(this.domain);if(e){let{subdomain:r,domain:U}=e.groups;this.subdomain=r,this.domain=U}}if(this.native.port)this.port=t(this.native.port);else{let r=(typeof g==="string"?g:g.toString()).match(/:(\d+)/);if(r)this.port=t(r[1]);else this.port=80}if(this.native.pathname==="/")this.path="/";else this.path=this.native.pathname.replace(/\/+$/,"");this.fragment=x(this.native.hash,"#"),this.base=`${this.native.protocol}//${this.native.host}`,this.origin=this.native.origin;for(let[e,r]of this.native.searchParams)if(r==="true")this.queries[e]=!0;else if(r==="false")this.queries[e]=!1;else if(/^\d+$/.test(r)&&!r.startsWith("0"))this.queries[e]=Number.parseInt(r,10);else if(/^-?\d+(\.\d+)?$/.test(r)&&!r.startsWith("0"))this.queries[e]=Number.parseFloat(r);else this.queries[e]=r}getNative(){return this.native}getProtocol(){return this.protocol}getSubdomain(){return this.subdomain}getDomain(){return this.domain}getHostname(){return this.hostname}getPort(){return this.port}getPath(){return this.path}getQueries(){return{...this.queries}}getQuery(g){return this.queries[g]||null}getFragment(){return this.fragment}getBase(){return this.base}getOrigin(){return this.origin}toString(){return this.native.toString()}}import{trim as Q}from"@ooneex/utils";class s extends i{setProtocol(g){let I=this.protocol;if(this.protocol=Q(g,":"),I==="http"&&this.port===80&&this.protocol==="https")this.port=80;else if(I==="https"&&this.port===443&&this.protocol==="http")this.port=80;return this.updateNativeUrl(),this}setHostname(g){if(this.hostname=g,this.subdomain=null,this.domain=g,!/^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(g)&&g!=="localhost"){let e=/(?<subdomain>.+)\.(?<domain>[a-z0-9-_]+\.[a-z0-9]+)$/i.exec(g);if(e){let{subdomain:r,domain:U}=e.groups;this.subdomain=r,this.domain=U}}return this.updateNativeUrl(),this}setPort(g){return this.port=g,this.updateNativeUrl(),this}setPath(g){if(g==="")this.path="/";else this.path=`/${Q(g,"/")}`;return this.updateNativeUrl(),this}addQuery(g,I){return this.queries[g]=I,this.updateNativeUrl(),this}removeQuery(g){return delete this.queries[g],this.updateNativeUrl(),this}setQueries(g){return this.queries={...g},this.updateNativeUrl(),this}clearQueries(){return this.queries={},this.updateNativeUrl(),this}setFragment(g){return this.fragment=Q(g,"#"),this.updateNativeUrl(),this}updateNativeUrl(){let g=this.protocol.includes(":")?this.protocol:`${this.protocol}:`,I=this.shouldShowPort()?`:${this.port}`:"",e=this.path,r=this.buildQueryString(),U=this.fragment?`#${this.fragment}`:"",T=`${g}//${this.hostname}${I}${e}${r}${U}`;this.native=new URL(T),this.base=this.shouldShowPort()?`${g}//${this.hostname}${I}`:`${g}//${this.hostname}`,this.origin=this.shouldShowPort()?`${g}//${this.hostname}${I}`:`${g}//${this.hostname}`}shouldShowPort(){if(this.protocol==="http"&&this.port===80)return!1;if(this.protocol==="https"&&this.port===443)return!1;if(this.port===80)return!1;return!0}buildQueryString(){let g=new URLSearchParams;for(let[e,r]of Object.entries(this.queries))g.set(e,String(r));let I=g.toString();return I?`?${I}`:""}}export{s as Url,i as ReadonlyUrl};
+
+//# debugId=E5A2C3518A1FC26E64756E2164756E21

package/dist/index.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["src/ReadonlyUrl.ts", "src/Url.ts"],
+  "sourcesContent": [
+    "import type { ScalarType } from \"@ooneex/types\";\nimport { parseString, trim } from \"@ooneex/utils\";\nimport type { IReadonlyUrl } from \"./types\";\n\nexport class ReadonlyUrl implements IReadonlyUrl {\n  protected native: URL;\n  protected protocol: string;\n  protected subdomain: string | null;\n  protected domain: string;\n  protected hostname: string;\n  protected port: number;\n  protected path: string;\n  protected queries: Record<string, ScalarType> = {};\n  protected fragment: string;\n  protected base: string;\n  protected origin: string;\n\n  constructor(url: string | URL) {\n    this.native = new URL(url);\n\n    this.protocol = trim(this.native.protocol, \":\");\n    this.subdomain = null;\n    this.hostname = this.native.hostname;\n    this.domain = this.hostname;\n\n    // Only parse domain/subdomain for actual domain names, not IP addresses\n    const isIpAddress = /^\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}$/.test(this.hostname);\n    if (!isIpAddress && this.hostname !== \"localhost\") {\n      const match = /(?<subdomain>.+)\\.(?<domain>[a-z0-9-_]+\\.[a-z0-9]+)$/i.exec(this.domain);\n      if (match) {\n        const { subdomain, domain } = match.groups as {\n          subdomain: string;\n          domain: string;\n        };\n        this.subdomain = subdomain;\n        this.domain = domain;\n      }\n    }\n\n    // Handle port parsing - native URL omits default ports, but we need to detect them\n    if (this.native.port) {\n      this.port = parseString(this.native.port);\n    } else {\n      // Check if the original URL string had an explicit port\n      const urlString = typeof url === \"string\" ? url : url.toString();\n      const portMatch = urlString.match(/:(\\d+)/);\n      if (portMatch) {\n        this.port = parseString(portMatch[1] as string);\n      } else {\n        this.port = 80; // Default port\n      }\n    }\n    // Handle path - preserve structure but handle trailing slashes correctly\n    if (this.native.pathname === \"/\") {\n      this.path = \"/\";\n    } else {\n      // Remove all trailing slashes if present, but preserve internal empty segments\n      this.path = this.native.pathname.replace(/\\/+$/, \"\");\n    }\n    this.fragment = trim(this.native.hash, \"#\");\n    this.base = `${this.native.protocol}//${this.native.host}`;\n    this.origin = this.native.origin;\n\n    for (const [key, value] of this.native.searchParams) {\n      // Only parse as number/boolean if it's clearly intended to be\n      if (value === \"true\") {\n        this.queries[key] = true;\n      } else if (value === \"false\") {\n        this.queries[key] = false;\n      } else if (/^\\d+$/.test(value) && !value.startsWith(\"0\")) {\n        // Only parse as number if it's all digits and doesn't start with 0 (to preserve \"001\")\n        this.queries[key] = Number.parseInt(value, 10);\n      } else if (/^-?\\d+(\\.\\d+)?$/.test(value) && !value.startsWith(\"0\")) {\n        // Parse as float if it's a valid number\n        this.queries[key] = Number.parseFloat(value);\n      } else {\n        this.queries[key] = value;\n      }\n    }\n  }\n\n  public getNative(): URL {\n    return this.native;\n  }\n\n  public getProtocol(): string {\n    return this.protocol;\n  }\n\n  public getSubdomain(): string | null {\n    return this.subdomain;\n  }\n\n  public getDomain(): string {\n    return this.domain;\n  }\n\n  public getHostname(): string {\n    return this.hostname;\n  }\n\n  public getPort(): number {\n    return this.port;\n  }\n\n  public getPath(): string {\n    return this.path;\n  }\n\n  public getQueries(): Record<string, ScalarType> {\n    return { ...this.queries };\n  }\n\n  public getQuery(name: string): ScalarType | null {\n    return this.queries[name] || null;\n  }\n\n  public getFragment(): string {\n    return this.fragment;\n  }\n\n  public getBase(): string {\n    return this.base;\n  }\n\n  public getOrigin(): string {\n    return this.origin;\n  }\n\n  public toString(): string {\n    return this.native.toString();\n  }\n}\n",
+    "import type { ScalarType } from \"@ooneex/types\";\nimport { trim } from \"@ooneex/utils\";\nimport { ReadonlyUrl } from \"./ReadonlyUrl\";\nimport type { IUrl } from \"./types\";\n\nexport class Url extends ReadonlyUrl implements IUrl {\n  public setProtocol(protocol: string): this {\n    const oldProtocol = this.protocol;\n    this.protocol = trim(protocol, \":\");\n\n    // Update port based on protocol change if it was a default port\n    if (oldProtocol === \"http\" && this.port === 80 && this.protocol === \"https\") {\n      this.port = 80; // Keep 80 as default for all protocols as per tests\n    } else if (oldProtocol === \"https\" && this.port === 443 && this.protocol === \"http\") {\n      this.port = 80; // Keep 80 as default for all protocols as per tests\n    }\n\n    this.updateNativeUrl();\n    return this;\n  }\n\n  public setHostname(hostname: string): this {\n    this.hostname = hostname;\n\n    this.subdomain = null;\n    this.domain = hostname;\n\n    // Only parse domain/subdomain for actual domain names, not IP addresses\n    const isIpAddress = /^\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}$/.test(hostname);\n    if (!isIpAddress && hostname !== \"localhost\") {\n      const match = /(?<subdomain>.+)\\.(?<domain>[a-z0-9-_]+\\.[a-z0-9]+)$/i.exec(hostname);\n      if (match) {\n        const { subdomain, domain } = match.groups as {\n          subdomain: string;\n          domain: string;\n        };\n        this.subdomain = subdomain;\n        this.domain = domain;\n      }\n    }\n\n    this.updateNativeUrl();\n    return this;\n  }\n\n  public setPort(port: number): this {\n    this.port = port;\n    this.updateNativeUrl();\n    return this;\n  }\n\n  public setPath(path: string): this {\n    if (path === \"\") {\n      this.path = \"/\";\n    } else {\n      this.path = `/${trim(path, \"/\")}`;\n    }\n    this.updateNativeUrl();\n    return this;\n  }\n\n  public addQuery(key: string, value: ScalarType): this {\n    this.queries[key] = value;\n    this.updateNativeUrl();\n    return this;\n  }\n\n  public removeQuery(key: string): this {\n    delete this.queries[key];\n    this.updateNativeUrl();\n    return this;\n  }\n\n  public setQueries(queries: Record<string, ScalarType>): this {\n    this.queries = { ...queries };\n    this.updateNativeUrl();\n    return this;\n  }\n\n  public clearQueries(): this {\n    this.queries = {};\n    this.updateNativeUrl();\n    return this;\n  }\n\n  public setFragment(fragment: string): this {\n    this.fragment = trim(fragment, \"#\");\n    this.updateNativeUrl();\n    return this;\n  }\n\n  private updateNativeUrl() {\n    const protocol = this.protocol.includes(\":\") ? this.protocol : `${this.protocol}:`;\n    const port = this.shouldShowPort() ? `:${this.port}` : \"\";\n    const path = this.path;\n    const queryString = this.buildQueryString();\n    const fragment = this.fragment ? `#${this.fragment}` : \"\";\n    const urlString = `${protocol}//${this.hostname}${port}${path}${queryString}${fragment}`;\n    this.native = new URL(urlString);\n    this.base = this.shouldShowPort() ? `${protocol}//${this.hostname}${port}` : `${protocol}//${this.hostname}`;\n    this.origin = this.shouldShowPort() ? `${protocol}//${this.hostname}${port}` : `${protocol}//${this.hostname}`;\n  }\n\n  private shouldShowPort(): boolean {\n    if (this.protocol === \"http\" && this.port === 80) return false;\n    if (this.protocol === \"https\" && this.port === 443) return false;\n    if (this.port === 80) return false; // Don't show default port 80\n    return true;\n  }\n\n  private buildQueryString(): string {\n    const params = new URLSearchParams();\n    for (const [key, value] of Object.entries(this.queries)) {\n      params.set(key, String(value));\n    }\n    const queryString = params.toString();\n    return queryString ? `?${queryString}` : \"\";\n  }\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "E5A2C3518A1FC26E64756E2164756E21",
+  "names": []
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@ooneex/url",
+  "description": "",
+  "version": "0.0.1",
+  "type": "module",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "package.json"
+  ],
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "license": "MIT",
+  "scripts": {
+    "test": "bun test tests",
+    "build": "bunup",
+    "lint": "tsgo --noEmit && bunx biome lint",
+    "publish:prod": "bun publish --tolerate-republish --access public",
+    "publish:pack": "bun pm pack --destination ./dist",
+    "publish:dry": "bun publish --dry-run"
+  },
+  "dependencies": {
+    "@ooneex/utils": "0.0.8"
+  },
+  "devDependencies": {
+    "@ooneex/types": "0.0.1"
+  }
+}