@furystack/utils 8.1.3 → 8.1.5

package/esm/deep-merge.d.ts

@@ -6,8 +6,8 @@ export type DeepPartial<T> = {
 };
 /**
  * Deep merge two objects.
- * @param  target The source object to be merged
- * @param sources The source objects
+ * @param target The target object to be merged into
+ * @param sources The source objects to merge
  * @returns A new instance with the merged values
  */
 export declare const deepMerge: <T>(target: T, ...sources: Array<DeepPartial<T> | undefined>) => T;

package/esm/deep-merge.js

@@ -1,7 +1,7 @@
 /**
  * Deep merge two objects.
- * @param  target The source object to be merged
- * @param sources The source objects
+ * @param target The target object to be merged into
+ * @param sources The source objects to merge
  * @returns A new instance with the merged values
  */
 export const deepMerge = (target, ...sources) => {

package/esm/is-async-disposable.d.ts

@@ -1,7 +1,6 @@
 /**
- *
  * @param value The value to check
- * @returns if the value is an instance of an async disposable object
+ * @returns whether the value is an instance of an async disposable object
  */
 export declare const isAsyncDisposable: (value: unknown) => value is AsyncDisposable;
 //# sourceMappingURL=is-async-disposable.d.ts.map

package/esm/is-async-disposable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"is-async-disposable.d.ts","sourceRoot":"","sources":["../src/is-async-disposable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,eAE3D,CAAA"}
+{"version":3,"file":"is-async-disposable.d.ts","sourceRoot":"","sources":["../src/is-async-disposable.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,eAE3D,CAAA"}

package/esm/is-async-disposable.js

@@ -1,7 +1,6 @@
 /**
- *
  * @param value The value to check
- * @returns if the value is an instance of an async disposable object
+ * @returns whether the value is an instance of an async disposable object
  */
 export const isAsyncDisposable = (value) => {
     return value?.[Symbol.asyncDispose] instanceof Function;

package/esm/is-async-disposable.js.map

@@ -1 +1 @@
-{"version":3,"file":"is-async-disposable.js","sourceRoot":"","sources":["../src/is-async-disposable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAA4B,EAAE;IAC5E,OAAQ,KAAyB,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,YAAY,QAAQ,CAAA;AAC9E,CAAC,CAAA"}
+{"version":3,"file":"is-async-disposable.js","sourceRoot":"","sources":["../src/is-async-disposable.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAA4B,EAAE;IAC5E,OAAQ,KAAyB,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,YAAY,QAAQ,CAAA;AAC9E,CAAC,CAAA"}

package/esm/is-disposable.d.ts

@@ -1,7 +1,6 @@
 /**
- *
  * @param value The value to check
- * @returns if the value is an instance of a disposable object
+ * @returns whether the value is an instance of a disposable object
  */
 export declare const isDisposable: (value: unknown) => value is Disposable;
 //# sourceMappingURL=is-disposable.d.ts.map

package/esm/is-disposable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"is-disposable.d.ts","sourceRoot":"","sources":["../src/is-disposable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,UAEtD,CAAA"}
+{"version":3,"file":"is-disposable.d.ts","sourceRoot":"","sources":["../src/is-disposable.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,UAEtD,CAAA"}

package/esm/is-disposable.js

@@ -1,7 +1,6 @@
 /**
- *
  * @param value The value to check
- * @returns if the value is an instance of a disposable object
+ * @returns whether the value is an instance of a disposable object
  */
 export const isDisposable = (value) => {
     return value?.[Symbol.dispose] instanceof Function;

package/esm/is-disposable.js.map

@@ -1 +1 @@
-{"version":3,"file":"is-disposable.js","sourceRoot":"","sources":["../src/is-disposable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAc,EAAuB,EAAE;IAClE,OAAQ,KAAoB,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,QAAQ,CAAA;AACpE,CAAC,CAAA"}
+{"version":3,"file":"is-disposable.js","sourceRoot":"","sources":["../src/is-disposable.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAc,EAAuB,EAAE;IAClE,OAAQ,KAAoB,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,QAAQ,CAAA;AACpE,CAAC,CAAA"}

package/esm/observable-value.d.ts

@@ -15,7 +15,7 @@ export type ObservableValueOptions<T> = {
      * Defines a custom compare function to determine if the value should be updated and the observers should be notified
      * @param lastValue the last value
      * @param nextValue the next value
-     * @returns if the value should be updated and the observers should be notified
+     * @returns whether the value should be updated and the observers should be notified
      */
     compare: (lastValue: T, nextValue: T) => boolean;
 };
@@ -58,7 +58,7 @@ export declare class ObservableValue<T> implements Disposable {
     /**
      * The observer will unsubscribe from the Observable
      * @param observer The ValueObserver instance
-     * @returns if unsubscribing was successfull
+     * @returns whether unsubscribing was successful
      */
     unsubscribe(observer: ValueObserver<T>): boolean;
     /**

package/esm/observable-value.js

@@ -61,7 +61,7 @@ export class ObservableValue {
     /**
      * The observer will unsubscribe from the Observable
      * @param observer The ValueObserver instance
-     * @returns if unsubscribing was successfull
+     * @returns whether unsubscribing was successful
      */
     unsubscribe(observer) {
         return this.observers.delete(observer);

package/esm/path-helper.d.ts

@@ -40,5 +40,93 @@ export declare class PathHelper {
      */
     static getParentPath(path: string): string;
     static normalize(path: string): string;
+    /**
+     * Trims only the trailing slash from a URL or path
+     * @param url The URL or path to trim
+     * @returns The URL/path without trailing slash
+     * @example
+     * PathHelper.trimTrailingSlash('/api/') // '/api'
+     * PathHelper.trimTrailingSlash('http://example.com/') // 'http://example.com'
+     */
+    static trimTrailingSlash(url: string): string;
+    /**
+     * Trims only the leading slash from a path
+     * @param path The path to trim
+     * @returns The path without leading slash
+     * @example
+     * PathHelper.trimLeadingSlash('/api') // 'api'
+     * PathHelper.trimLeadingSlash('api') // 'api'
+     */
+    static trimLeadingSlash(path: string): string;
+    /**
+     * Ensures a path has a leading slash
+     * @param path The path to check
+     * @returns The path with a leading slash
+     * @example
+     * PathHelper.ensureLeadingSlash('api') // '/api'
+     * PathHelper.ensureLeadingSlash('/api') // '/api'
+     */
+    static ensureLeadingSlash(path: string): string;
+    /**
+     * Normalizes a base URL by ensuring it has no trailing slash
+     * @param baseUrl The base URL to normalize (e.g., 'http://example.com/' or '/api/')
+     * @returns The normalized base URL without trailing slash
+     * @example
+     * PathHelper.normalizeBaseUrl('http://example.com/') // 'http://example.com'
+     * PathHelper.normalizeBaseUrl('/api/') // '/api'
+     * PathHelper.normalizeBaseUrl('/api') // '/api'
+     */
+    static normalizeBaseUrl(baseUrl: string): string;
+    /**
+     * Joins a base URL with a path, handling slashes correctly
+     * Preserves protocols (http://, https://, etc.)
+     * @param baseUrl The base URL (with or without trailing slash)
+     * @param path The path to append (with or without leading slash)
+     * @returns The combined URL with correct slash handling
+     * @example
+     * PathHelper.joinUrl('http://example.com', '/path') // 'http://example.com/path'
+     * PathHelper.joinUrl('http://example.com/', 'path') // 'http://example.com/path'
+     * PathHelper.joinUrl('/api', '/users') // '/api/users'
+     * PathHelper.joinUrl('/api/', 'users') // '/api/users'
+     * PathHelper.joinUrl('http://example.com', '') // 'http://example.com'
+     */
+    static joinUrl(baseUrl: string, path: string): string;
+    /**
+     * Checks if a request URL matches a base URL pattern
+     * Handles trailing slash variations correctly
+     * @param requestUrl The incoming request URL
+     * @param baseUrl The base URL pattern to match against
+     * @returns true if the request URL matches the base URL
+     * @example
+     * PathHelper.matchesBaseUrl('/api/users', '/api') // true
+     * PathHelper.matchesBaseUrl('/api', '/api') // true
+     * PathHelper.matchesBaseUrl('/api', '/api/') // true
+     * PathHelper.matchesBaseUrl('/other', '/api') // false
+     * PathHelper.matchesBaseUrl('/api2', '/api') // false (not a path match)
+     */
+    static matchesBaseUrl(requestUrl: string, baseUrl: string): boolean;
+    /**
+     * Extracts the remaining path after a base URL
+     * Always returns a path with a leading slash (or empty string for exact matches)
+     * @param requestUrl The full request URL
+     * @param baseUrl The base URL to remove
+     * @returns The remaining path with leading slash, or empty string if exact match
+     * @example
+     * PathHelper.extractPath('/api/users', '/api') // '/users'
+     * PathHelper.extractPath('/api', '/api') // ''
+     * PathHelper.extractPath('/api/users?id=1', '/api') // '/users?id=1'
+     * PathHelper.extractPath('/api/', '/api') // '/'
+     */
+    static extractPath(requestUrl: string, baseUrl: string): string;
+    /**
+     * Normalizes a URL by removing consecutive slashes (except after protocol)
+     * @param url The URL to normalize
+     * @returns The normalized URL
+     * @example
+     * PathHelper.normalizeUrl('http://example.com//path') // 'http://example.com/path'
+     * PathHelper.normalizeUrl('/api//users///123') // '/api/users/123'
+     * PathHelper.normalizeUrl('http://example.com/') // 'http://example.com/'
+     */
+    static normalizeUrl(url: string): string;
 }
 //# sourceMappingURL=path-helper.d.ts.map

package/esm/path-helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path-helper.d.ts","sourceRoot":"","sources":["../src/path-helper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,UAAU;IACrB;;;;OAIG;WACW,WAAW,CAAC,IAAI,EAAE,MAAM;IAUtC;;;;;OAKG;WACW,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAIjD;;;;OAIG;WACW,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE;IAIzC;;;;;OAKG;WACW,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO;IAIjF;;;;;;;OAOG;WACW,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQnC,SAAS,CAAC,IAAI,EAAE,MAAM;CAGrC"}
+{"version":3,"file":"path-helper.d.ts","sourceRoot":"","sources":["../src/path-helper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,UAAU;IACrB;;;;OAIG;WACW,WAAW,CAAC,IAAI,EAAE,MAAM;IAUtC;;;;;OAKG;WACW,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAIjD;;;;OAIG;WACW,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE;IAIzC;;;;;OAKG;WACW,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO;IAIjF;;;;;;;OAOG;WACW,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAQnC,SAAS,CAAC,IAAI,EAAE,MAAM;IAIpC;;;;;;;OAOG;WACW,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIpD;;;;;;;OAOG;WACW,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIpD;;;;;;;OAOG;WACW,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAItD;;;;;;;;OAQG;WACW,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIvD;;;;;;;;;;;;OAYG;WACW,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAS5D;;;;;;;;;;;;OAYG;WACW,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAc1E;;;;;;;;;;;OAWG;WACW,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAiBtE;;;;;;;;OAQG;WACW,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAchD"}

package/esm/path-helper.js

@@ -62,5 +62,141 @@ export class PathHelper {
     static normalize(path) {
         return this.getSegments(path).join('/');
     }
+    /**
+     * Trims only the trailing slash from a URL or path
+     * @param url The URL or path to trim
+     * @returns The URL/path without trailing slash
+     * @example
+     * PathHelper.trimTrailingSlash('/api/') // '/api'
+     * PathHelper.trimTrailingSlash('http://example.com/') // 'http://example.com'
+     */
+    static trimTrailingSlash(url) {
+        return url.endsWith('/') ? url.slice(0, -1) : url;
+    }
+    /**
+     * Trims only the leading slash from a path
+     * @param path The path to trim
+     * @returns The path without leading slash
+     * @example
+     * PathHelper.trimLeadingSlash('/api') // 'api'
+     * PathHelper.trimLeadingSlash('api') // 'api'
+     */
+    static trimLeadingSlash(path) {
+        return path.startsWith('/') ? path.slice(1) : path;
+    }
+    /**
+     * Ensures a path has a leading slash
+     * @param path The path to check
+     * @returns The path with a leading slash
+     * @example
+     * PathHelper.ensureLeadingSlash('api') // '/api'
+     * PathHelper.ensureLeadingSlash('/api') // '/api'
+     */
+    static ensureLeadingSlash(path) {
+        return path.startsWith('/') ? path : `/${path}`;
+    }
+    /**
+     * Normalizes a base URL by ensuring it has no trailing slash
+     * @param baseUrl The base URL to normalize (e.g., 'http://example.com/' or '/api/')
+     * @returns The normalized base URL without trailing slash
+     * @example
+     * PathHelper.normalizeBaseUrl('http://example.com/') // 'http://example.com'
+     * PathHelper.normalizeBaseUrl('/api/') // '/api'
+     * PathHelper.normalizeBaseUrl('/api') // '/api'
+     */
+    static normalizeBaseUrl(baseUrl) {
+        return this.trimTrailingSlash(baseUrl);
+    }
+    /**
+     * Joins a base URL with a path, handling slashes correctly
+     * Preserves protocols (http://, https://, etc.)
+     * @param baseUrl The base URL (with or without trailing slash)
+     * @param path The path to append (with or without leading slash)
+     * @returns The combined URL with correct slash handling
+     * @example
+     * PathHelper.joinUrl('http://example.com', '/path') // 'http://example.com/path'
+     * PathHelper.joinUrl('http://example.com/', 'path') // 'http://example.com/path'
+     * PathHelper.joinUrl('/api', '/users') // '/api/users'
+     * PathHelper.joinUrl('/api/', 'users') // '/api/users'
+     * PathHelper.joinUrl('http://example.com', '') // 'http://example.com'
+     */
+    static joinUrl(baseUrl, path) {
+        if (!path) {
+            return this.normalizeBaseUrl(baseUrl);
+        }
+        const normalizedBase = this.normalizeBaseUrl(baseUrl);
+        const normalizedPath = this.ensureLeadingSlash(path);
+        return `${normalizedBase}${normalizedPath}`;
+    }
+    /**
+     * Checks if a request URL matches a base URL pattern
+     * Handles trailing slash variations correctly
+     * @param requestUrl The incoming request URL
+     * @param baseUrl The base URL pattern to match against
+     * @returns true if the request URL matches the base URL
+     * @example
+     * PathHelper.matchesBaseUrl('/api/users', '/api') // true
+     * PathHelper.matchesBaseUrl('/api', '/api') // true
+     * PathHelper.matchesBaseUrl('/api', '/api/') // true
+     * PathHelper.matchesBaseUrl('/other', '/api') // false
+     * PathHelper.matchesBaseUrl('/api2', '/api') // false (not a path match)
+     */
+    static matchesBaseUrl(requestUrl, baseUrl) {
+        const normalizedBase = this.normalizeBaseUrl(baseUrl);
+        const normalizedRequest = requestUrl;
+        // Exact match
+        if (normalizedRequest === normalizedBase) {
+            return true;
+        }
+        // Check if request starts with base followed by a slash
+        // This prevents '/api2' from matching '/api'
+        return normalizedRequest.startsWith(`${normalizedBase}/`);
+    }
+    /**
+     * Extracts the remaining path after a base URL
+     * Always returns a path with a leading slash (or empty string for exact matches)
+     * @param requestUrl The full request URL
+     * @param baseUrl The base URL to remove
+     * @returns The remaining path with leading slash, or empty string if exact match
+     * @example
+     * PathHelper.extractPath('/api/users', '/api') // '/users'
+     * PathHelper.extractPath('/api', '/api') // ''
+     * PathHelper.extractPath('/api/users?id=1', '/api') // '/users?id=1'
+     * PathHelper.extractPath('/api/', '/api') // '/'
+     */
+    static extractPath(requestUrl, baseUrl) {
+        const normalizedBase = this.normalizeBaseUrl(baseUrl);
+        // Exact match
+        if (requestUrl === normalizedBase) {
+            return '';
+        }
+        // If request doesn't match base, return the original request URL
+        if (!this.matchesBaseUrl(requestUrl, baseUrl)) {
+            return requestUrl;
+        }
+        // Extract the path after the base
+        return requestUrl.substring(normalizedBase.length);
+    }
+    /**
+     * Normalizes a URL by removing consecutive slashes (except after protocol)
+     * @param url The URL to normalize
+     * @returns The normalized URL
+     * @example
+     * PathHelper.normalizeUrl('http://example.com//path') // 'http://example.com/path'
+     * PathHelper.normalizeUrl('/api//users///123') // '/api/users/123'
+     * PathHelper.normalizeUrl('http://example.com/') // 'http://example.com/'
+     */
+    static normalizeUrl(url) {
+        // Handle protocol separately to preserve ://
+        const protocolMatch = url.match(/^([a-z][a-z0-9+.-]*:\/\/)(.*)$/i);
+        if (protocolMatch) {
+            const [, protocol, rest] = protocolMatch;
+            // Remove consecutive slashes from the rest
+            const normalized = rest.replace(/\/+/g, '/');
+            return `${protocol}${normalized}`;
+        }
+        // No protocol, just remove consecutive slashes
+        return url.replace(/\/+/g, '/');
+    }
 }
 //# sourceMappingURL=path-helper.js.map

package/esm/path-helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"path-helper.js","sourceRoot":"","sources":["../src/path-helper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,UAAU;IACrB;;;;OAIG;IACI,MAAM,CAAC,WAAW,CAAC,IAAY;QACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QACvC,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,WAAW,CAAC,IAAY;QACpC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IACvE,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,SAAS,CAAC,GAAG,IAAc;QACvC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC7D,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,YAAY,CAAC,YAAoB,EAAE,cAAsB;QACrE,OAAO,cAAc,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACzE,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,aAAa,CAAC,IAAY;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;QACvC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,QAAQ,CAAC,GAAG,EAAE,CAAA;QAChB,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC3B,CAAC;IAEM,MAAM,CAAC,SAAS,CAAC,IAAY;QAClC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACzC,CAAC;CACF"}
+{"version":3,"file":"path-helper.js","sourceRoot":"","sources":["../src/path-helper.ts"],"names":[],"mappings":"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"}

package/esm/path-helper.spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path-helper.spec.d.ts","sourceRoot":"","sources":["../src/path-helper.spec.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,eAAe,yCA0E1B,CAAA"}
+{"version":3,"file":"path-helper.spec.d.ts","sourceRoot":"","sources":["../src/path-helper.spec.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,eAAe,yCAuT1B,CAAA"}

package/esm/path-helper.spec.js

@@ -64,5 +64,183 @@ export const pathHelperTests = describe('PathHelper', () => {
             expect(PathHelper.normalize('/Root/Example/Content/')).toBe('Root/Example/Content');
         });
     });
+    describe('#trimTrailingSlash()', () => {
+        it('should remove trailing slash', () => {
+            expect(PathHelper.trimTrailingSlash('/api/')).toBe('/api');
+        });
+        it('should handle URLs with trailing slash', () => {
+            expect(PathHelper.trimTrailingSlash('http://example.com/')).toBe('http://example.com');
+        });
+        it('should not modify paths without trailing slash', () => {
+            expect(PathHelper.trimTrailingSlash('/api')).toBe('/api');
+        });
+        it('should handle empty string', () => {
+            expect(PathHelper.trimTrailingSlash('')).toBe('');
+        });
+        it('should handle root path', () => {
+            expect(PathHelper.trimTrailingSlash('/')).toBe('');
+        });
+    });
+    describe('#trimLeadingSlash()', () => {
+        it('should remove leading slash', () => {
+            expect(PathHelper.trimLeadingSlash('/api')).toBe('api');
+        });
+        it('should not modify paths without leading slash', () => {
+            expect(PathHelper.trimLeadingSlash('api')).toBe('api');
+        });
+        it('should handle empty string', () => {
+            expect(PathHelper.trimLeadingSlash('')).toBe('');
+        });
+        it('should handle root path', () => {
+            expect(PathHelper.trimLeadingSlash('/')).toBe('');
+        });
+    });
+    describe('#ensureLeadingSlash()', () => {
+        it('should add leading slash when missing', () => {
+            expect(PathHelper.ensureLeadingSlash('api')).toBe('/api');
+        });
+        it('should not add extra slash when already present', () => {
+            expect(PathHelper.ensureLeadingSlash('/api')).toBe('/api');
+        });
+        it('should handle empty string', () => {
+            expect(PathHelper.ensureLeadingSlash('')).toBe('/');
+        });
+    });
+    describe('#normalizeBaseUrl()', () => {
+        it('should remove trailing slash from URL', () => {
+            expect(PathHelper.normalizeBaseUrl('http://example.com/')).toBe('http://example.com');
+        });
+        it('should remove trailing slash from path', () => {
+            expect(PathHelper.normalizeBaseUrl('/api/')).toBe('/api');
+        });
+        it('should not modify URL without trailing slash', () => {
+            expect(PathHelper.normalizeBaseUrl('/api')).toBe('/api');
+        });
+        it('should handle HTTPS URLs', () => {
+            expect(PathHelper.normalizeBaseUrl('https://example.com/')).toBe('https://example.com');
+        });
+    });
+    describe('#joinUrl()', () => {
+        it('should join URL with path (both with slashes)', () => {
+            expect(PathHelper.joinUrl('http://example.com/', '/path')).toBe('http://example.com/path');
+        });
+        it('should join URL with path (URL with slash)', () => {
+            expect(PathHelper.joinUrl('http://example.com/', 'path')).toBe('http://example.com/path');
+        });
+        it('should join URL with path (path with slash)', () => {
+            expect(PathHelper.joinUrl('http://example.com', '/path')).toBe('http://example.com/path');
+        });
+        it('should join URL with path (neither with slash)', () => {
+            expect(PathHelper.joinUrl('http://example.com', 'path')).toBe('http://example.com/path');
+        });
+        it('should join relative paths', () => {
+            expect(PathHelper.joinUrl('/api', '/users')).toBe('/api/users');
+            expect(PathHelper.joinUrl('/api/', 'users')).toBe('/api/users');
+        });
+        it('should handle empty path', () => {
+            expect(PathHelper.joinUrl('http://example.com', '')).toBe('http://example.com');
+            expect(PathHelper.joinUrl('http://example.com/', '')).toBe('http://example.com');
+        });
+        it('should handle complex paths', () => {
+            expect(PathHelper.joinUrl('http://example.com:8080', '/api/v1/users')).toBe('http://example.com:8080/api/v1/users');
+        });
+        it('should preserve HTTPS protocol', () => {
+            expect(PathHelper.joinUrl('https://secure.example.com', '/secure/path')).toBe('https://secure.example.com/secure/path');
+        });
+    });
+    describe('#matchesBaseUrl()', () => {
+        it('should match exact URL', () => {
+            expect(PathHelper.matchesBaseUrl('/api', '/api')).toBe(true);
+        });
+        it('should match URL with trailing slash in base', () => {
+            expect(PathHelper.matchesBaseUrl('/api', '/api/')).toBe(true);
+        });
+        it('should match URL starting with base', () => {
+            expect(PathHelper.matchesBaseUrl('/api/users', '/api')).toBe(true);
+        });
+        it('should not match different URL', () => {
+            expect(PathHelper.matchesBaseUrl('/other', '/api')).toBe(false);
+        });
+        it('should not match similar prefix without slash', () => {
+            expect(PathHelper.matchesBaseUrl('/api2', '/api')).toBe(false);
+            expect(PathHelper.matchesBaseUrl('/api-v2', '/api')).toBe(false);
+        });
+        it('should match nested paths', () => {
+            expect(PathHelper.matchesBaseUrl('/api/v1/users/123', '/api')).toBe(true);
+            expect(PathHelper.matchesBaseUrl('/api/v1/users/123', '/api/v1')).toBe(true);
+        });
+        it('should handle root path', () => {
+            expect(PathHelper.matchesBaseUrl('/api', '/')).toBe(true);
+            expect(PathHelper.matchesBaseUrl('/', '/')).toBe(true);
+        });
+        it('should match with query string', () => {
+            expect(PathHelper.matchesBaseUrl('/api/users?page=1', '/api')).toBe(true);
+        });
+        it('should match with trailing slash in request', () => {
+            expect(PathHelper.matchesBaseUrl('/api/', '/api')).toBe(true);
+        });
+    });
+    describe('#extractPath()', () => {
+        it('should extract path after base URL', () => {
+            expect(PathHelper.extractPath('/api/users', '/api')).toBe('/users');
+        });
+        it('should return empty string for exact match', () => {
+            expect(PathHelper.extractPath('/api', '/api')).toBe('');
+        });
+        it('should preserve query string', () => {
+            expect(PathHelper.extractPath('/api/users?id=1', '/api')).toBe('/users?id=1');
+        });
+        it('should handle trailing slash in request', () => {
+            expect(PathHelper.extractPath('/api/', '/api')).toBe('/');
+        });
+        it('should handle trailing slash in base', () => {
+            expect(PathHelper.extractPath('/api/users', '/api/')).toBe('/users');
+        });
+        it('should extract nested paths', () => {
+            expect(PathHelper.extractPath('/api/v1/users/123', '/api')).toBe('/v1/users/123');
+            expect(PathHelper.extractPath('/api/v1/users/123', '/api/v1')).toBe('/users/123');
+        });
+        it('should return original URL if no match', () => {
+            expect(PathHelper.extractPath('/other/path', '/api')).toBe('/other/path');
+        });
+        it('should handle complex query strings', () => {
+            expect(PathHelper.extractPath('/api/search?q=test&limit=10&offset=0', '/api')).toBe('/search?q=test&limit=10&offset=0');
+        });
+        it('should preserve fragments', () => {
+            expect(PathHelper.extractPath('/api/page#section', '/api')).toBe('/page#section');
+        });
+    });
+    describe('#normalizeUrl()', () => {
+        it('should remove double slashes from path', () => {
+            expect(PathHelper.normalizeUrl('/api//users')).toBe('/api/users');
+        });
+        it('should remove multiple consecutive slashes', () => {
+            expect(PathHelper.normalizeUrl('/api///users////123')).toBe('/api/users/123');
+        });
+        it('should preserve protocol slashes', () => {
+            expect(PathHelper.normalizeUrl('http://example.com//path')).toBe('http://example.com/path');
+        });
+        it('should handle HTTPS protocol', () => {
+            expect(PathHelper.normalizeUrl('https://example.com///path//to///resource')).toBe('https://example.com/path/to/resource');
+        });
+        it('should not modify already normalized URLs', () => {
+            expect(PathHelper.normalizeUrl('http://example.com/path')).toBe('http://example.com/path');
+            expect(PathHelper.normalizeUrl('/api/users')).toBe('/api/users');
+        });
+        it('should handle trailing slash', () => {
+            expect(PathHelper.normalizeUrl('http://example.com/')).toBe('http://example.com/');
+            expect(PathHelper.normalizeUrl('/api/')).toBe('/api/');
+        });
+        it('should handle custom protocols', () => {
+            expect(PathHelper.normalizeUrl('ftp://example.com//path')).toBe('ftp://example.com/path');
+            expect(PathHelper.normalizeUrl('ws://example.com//socket')).toBe('ws://example.com/socket');
+        });
+        it('should handle URLs with port', () => {
+            expect(PathHelper.normalizeUrl('http://example.com:8080//path')).toBe('http://example.com:8080/path');
+        });
+        it('should preserve query strings', () => {
+            expect(PathHelper.normalizeUrl('/api//users?page=1')).toBe('/api/users?page=1');
+        });
+    });
 });
 //# sourceMappingURL=path-helper.spec.js.map

package/esm/path-helper.spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"path-helper.spec.js","sourceRoot":"","sources":["../src/path-helper.spec.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"path-helper.spec.js","sourceRoot":"","sources":["../src/path-helper.spec.ts"],"names":[],"mappings":"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"}

package/esm/sort-by.d.ts

@@ -4,7 +4,10 @@ declare global {
      */
     export interface Array<T> {
         /**
-         * Returns a promise with a new array of elements that meets the specified async callback
+         * Sorts the array by a specified field and direction
+         * @param field The field to sort by
+         * @param direction The sort direction, either 'asc' or 'desc' (default: 'asc')
+         * @returns A new sorted array
          */
         sortBy: (field: keyof T, direction?: 'asc' | 'desc') => T[];
     }

package/esm/sort-by.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sort-by.d.ts","sourceRoot":"","sources":["../src/sort-by.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb;;OAEG;IACH,MAAM,WAAW,KAAK,CAAC,CAAC;QACtB;;WAEG;QACH,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,KAAK,CAAC,EAAE,CAAA;KAC5D;CACF;AAED,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,GAAG,MAAM,eAU1G,CAAA"}
+{"version":3,"file":"sort-by.d.ts","sourceRoot":"","sources":["../src/sort-by.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb;;OAEG;IACH,MAAM,WAAW,KAAK,CAAC,CAAC;QACtB;;;;;WAKG;QACH,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,KAAK,CAAC,EAAE,CAAA;KAC5D;CACF;AAED,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,GAAG,MAAM,eAU1G,CAAA"}

package/esm/sort-by.js.map

@@ -1 +1 @@
-{"version":3,"file":"sort-by.js","sourceRoot":"","sources":["../src/sort-by.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,SAAS,GAAG,CAAuB,OAAU,EAAE,OAAU,EAAE,KAAQ,EAAE,SAAyB,EAAE,EAAE;IAC7G,MAAM,CAAC,GAAG,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAA;IACjD,MAAM,CAAC,GAAG,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAA;IACjD,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC,CAAA;IACX,CAAC;IACD,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,CAAA;IACV,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC,CAAA;AAED,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,UAAU,GAAG,EAAE,SAAS,GAAG,KAAK;IACvD,+DAA+D;IAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAA;AAC7D,CAAC,CAAA"}
+{"version":3,"file":"sort-by.js","sourceRoot":"","sources":["../src/sort-by.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,MAAM,SAAS,GAAG,CAAuB,OAAU,EAAE,OAAU,EAAE,KAAQ,EAAE,SAAyB,EAAE,EAAE;IAC7G,MAAM,CAAC,GAAG,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAA;IACjD,MAAM,CAAC,GAAG,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAA;IACjD,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC,CAAA;IACX,CAAC;IACD,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,CAAA;IACV,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC,CAAA;AAED,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,UAAU,GAAG,EAAE,SAAS,GAAG,KAAK;IACvD,+DAA+D;IAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAA;AAC7D,CAAC,CAAA"}

package/esm/using-async.d.ts

@@ -1,7 +1,7 @@
 /**
- * Method that accepts an IDisposable resource that will be disposed after the callback
+ * Method that accepts a Disposable or AsyncDisposable resource that will be disposed after the callback
  * @param resource The resource that is used in the callback and will be disposed afterwards
- * @param callback The callback that will be executed asynchrounously before the resource will be disposed
+ * @param callback The callback that will be executed asynchronously before the resource will be disposed
  * @returns A promise that will be resolved with a return value after the resource is disposed
  */
 export declare const usingAsync: <T extends Disposable | AsyncDisposable, TReturns>(resource: T, callback: (r: T) => Promise<TReturns>) => Promise<TReturns>;

package/esm/using-async.js

@@ -1,9 +1,9 @@
 import { isAsyncDisposable } from './is-async-disposable.js';
 import { isDisposable } from './is-disposable.js';
 /**
- * Method that accepts an IDisposable resource that will be disposed after the callback
+ * Method that accepts a Disposable or AsyncDisposable resource that will be disposed after the callback
  * @param resource The resource that is used in the callback and will be disposed afterwards
- * @param callback The callback that will be executed asynchrounously before the resource will be disposed
+ * @param callback The callback that will be executed asynchronously before the resource will be disposed
  * @returns A promise that will be resolved with a return value after the resource is disposed
  */
 export const usingAsync = async (resource, callback) => {

package/esm/using.d.ts

@@ -1,7 +1,7 @@
 /**
- * Method that accepts an IDisposable resource that will be disposed after the callback
+ * Method that accepts a Disposable resource that will be disposed after the callback
  * @param resource The resource that is used in the callback and will be disposed afterwards
- * @param callback The callback that will be executed synchrounously before the resource will be disposed
+ * @param callback The callback that will be executed synchronously before the resource will be disposed
  * @returns the value that will be returned by the callback method
  */
 export declare const using: <T extends Disposable, TReturns>(resource: T, callback: (r: T) => TReturns) => TReturns;

package/esm/using.js

@@ -1,7 +1,7 @@
 /**
- * Method that accepts an IDisposable resource that will be disposed after the callback
+ * Method that accepts a Disposable resource that will be disposed after the callback
  * @param resource The resource that is used in the callback and will be disposed afterwards
- * @param callback The callback that will be executed synchrounously before the resource will be disposed
+ * @param callback The callback that will be executed synchronously before the resource will be disposed
  * @returns the value that will be returned by the callback method
  */
 export const using = (resource, callback) => {

package/esm/value-observer.d.ts

@@ -33,7 +33,7 @@ export declare class ValueObserver<T> implements Disposable {
      */
     [Symbol.dispose](): void;
     /**
-     * @constructs ValueObserver<T> the ValueObserver instance
+     * Creates a ValueObserver instance
      * @param observable The related Observable object
      * @param callback The callback that will be fired on change
      * @param options Additional options

package/esm/value-observer.js

@@ -31,7 +31,7 @@ export class ValueObserver {
         this.observable.unsubscribe(this);
     }
     /**
-     * @constructs ValueObserver<T> the ValueObserver instance
+     * Creates a ValueObserver instance
      * @param observable The related Observable object
      * @param callback The callback that will be fired on change
      * @param options Additional options

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@furystack/utils",
-  "version": "8.1.3",
+  "version": "8.1.5",
   "description": "General utilities",
   "type": "module",
   "scripts": {
@@ -35,6 +35,6 @@
   "homepage": "https://github.com/furystack/furystack",
   "devDependencies": {
     "typescript": "^5.9.3",
-    "vitest": "^3.2.4"
+    "vitest": "^4.0.10"
   }
 }

package/src/deep-merge.ts

@@ -5,8 +5,8 @@ export type DeepPartial<T> = { [K in keyof T]?: DeepPartial<T[K]> }
 
 /**
  * Deep merge two objects.
- * @param  target The source object to be merged
- * @param sources The source objects
+ * @param target The target object to be merged into
+ * @param sources The source objects to merge
  * @returns A new instance with the merged values
  */
 export const deepMerge = <T>(target: T, ...sources: Array<DeepPartial<T> | undefined>) => {

package/src/is-async-disposable.ts

@@ -1,7 +1,6 @@
 /**
- *
  * @param value The value to check
- * @returns if the value is an instance of an async disposable object
+ * @returns whether the value is an instance of an async disposable object
  */
 export const isAsyncDisposable = (value: unknown): value is AsyncDisposable => {
   return (value as AsyncDisposable)?.[Symbol.asyncDispose] instanceof Function

package/src/is-disposable.ts

@@ -1,7 +1,6 @@
 /**
- *
  * @param value The value to check
- * @returns if the value is an instance of a disposable object
+ * @returns whether the value is an instance of a disposable object
  */
 export const isDisposable = (value: unknown): value is Disposable => {
   return (value as Disposable)?.[Symbol.dispose] instanceof Function

package/src/observable-value.ts

@@ -20,7 +20,7 @@ export type ObservableValueOptions<T> = {
    * Defines a custom compare function to determine if the value should be updated and the observers should be notified
    * @param lastValue the last value
    * @param nextValue the next value
-   * @returns if the value should be updated and the observers should be notified
+   * @returns whether the value should be updated and the observers should be notified
    */
   compare: (lastValue: T, nextValue: T) => boolean
 }
@@ -84,7 +84,7 @@ export class ObservableValue<T> implements Disposable {
   /**
    * The observer will unsubscribe from the Observable
    * @param observer The ValueObserver instance
-   * @returns if unsubscribing was successfull
+   * @returns whether unsubscribing was successful
    */
   public unsubscribe(observer: ValueObserver<T>) {
     return this.observers.delete(observer)

package/src/path-helper.spec.ts

@@ -78,4 +78,241 @@ export const pathHelperTests = describe('PathHelper', () => {
       expect(PathHelper.normalize('/Root/Example/Content/')).toBe('Root/Example/Content')
     })
   })
+
+  describe('#trimTrailingSlash()', () => {
+    it('should remove trailing slash', () => {
+      expect(PathHelper.trimTrailingSlash('/api/')).toBe('/api')
+    })
+
+    it('should handle URLs with trailing slash', () => {
+      expect(PathHelper.trimTrailingSlash('http://example.com/')).toBe('http://example.com')
+    })
+
+    it('should not modify paths without trailing slash', () => {
+      expect(PathHelper.trimTrailingSlash('/api')).toBe('/api')
+    })
+
+    it('should handle empty string', () => {
+      expect(PathHelper.trimTrailingSlash('')).toBe('')
+    })
+
+    it('should handle root path', () => {
+      expect(PathHelper.trimTrailingSlash('/')).toBe('')
+    })
+  })
+
+  describe('#trimLeadingSlash()', () => {
+    it('should remove leading slash', () => {
+      expect(PathHelper.trimLeadingSlash('/api')).toBe('api')
+    })
+
+    it('should not modify paths without leading slash', () => {
+      expect(PathHelper.trimLeadingSlash('api')).toBe('api')
+    })
+
+    it('should handle empty string', () => {
+      expect(PathHelper.trimLeadingSlash('')).toBe('')
+    })
+
+    it('should handle root path', () => {
+      expect(PathHelper.trimLeadingSlash('/')).toBe('')
+    })
+  })
+
+  describe('#ensureLeadingSlash()', () => {
+    it('should add leading slash when missing', () => {
+      expect(PathHelper.ensureLeadingSlash('api')).toBe('/api')
+    })
+
+    it('should not add extra slash when already present', () => {
+      expect(PathHelper.ensureLeadingSlash('/api')).toBe('/api')
+    })
+
+    it('should handle empty string', () => {
+      expect(PathHelper.ensureLeadingSlash('')).toBe('/')
+    })
+  })
+
+  describe('#normalizeBaseUrl()', () => {
+    it('should remove trailing slash from URL', () => {
+      expect(PathHelper.normalizeBaseUrl('http://example.com/')).toBe('http://example.com')
+    })
+
+    it('should remove trailing slash from path', () => {
+      expect(PathHelper.normalizeBaseUrl('/api/')).toBe('/api')
+    })
+
+    it('should not modify URL without trailing slash', () => {
+      expect(PathHelper.normalizeBaseUrl('/api')).toBe('/api')
+    })
+
+    it('should handle HTTPS URLs', () => {
+      expect(PathHelper.normalizeBaseUrl('https://example.com/')).toBe('https://example.com')
+    })
+  })
+
+  describe('#joinUrl()', () => {
+    it('should join URL with path (both with slashes)', () => {
+      expect(PathHelper.joinUrl('http://example.com/', '/path')).toBe('http://example.com/path')
+    })
+
+    it('should join URL with path (URL with slash)', () => {
+      expect(PathHelper.joinUrl('http://example.com/', 'path')).toBe('http://example.com/path')
+    })
+
+    it('should join URL with path (path with slash)', () => {
+      expect(PathHelper.joinUrl('http://example.com', '/path')).toBe('http://example.com/path')
+    })
+
+    it('should join URL with path (neither with slash)', () => {
+      expect(PathHelper.joinUrl('http://example.com', 'path')).toBe('http://example.com/path')
+    })
+
+    it('should join relative paths', () => {
+      expect(PathHelper.joinUrl('/api', '/users')).toBe('/api/users')
+      expect(PathHelper.joinUrl('/api/', 'users')).toBe('/api/users')
+    })
+
+    it('should handle empty path', () => {
+      expect(PathHelper.joinUrl('http://example.com', '')).toBe('http://example.com')
+      expect(PathHelper.joinUrl('http://example.com/', '')).toBe('http://example.com')
+    })
+
+    it('should handle complex paths', () => {
+      expect(PathHelper.joinUrl('http://example.com:8080', '/api/v1/users')).toBe(
+        'http://example.com:8080/api/v1/users',
+      )
+    })
+
+    it('should preserve HTTPS protocol', () => {
+      expect(PathHelper.joinUrl('https://secure.example.com', '/secure/path')).toBe(
+        'https://secure.example.com/secure/path',
+      )
+    })
+  })
+
+  describe('#matchesBaseUrl()', () => {
+    it('should match exact URL', () => {
+      expect(PathHelper.matchesBaseUrl('/api', '/api')).toBe(true)
+    })
+
+    it('should match URL with trailing slash in base', () => {
+      expect(PathHelper.matchesBaseUrl('/api', '/api/')).toBe(true)
+    })
+
+    it('should match URL starting with base', () => {
+      expect(PathHelper.matchesBaseUrl('/api/users', '/api')).toBe(true)
+    })
+
+    it('should not match different URL', () => {
+      expect(PathHelper.matchesBaseUrl('/other', '/api')).toBe(false)
+    })
+
+    it('should not match similar prefix without slash', () => {
+      expect(PathHelper.matchesBaseUrl('/api2', '/api')).toBe(false)
+      expect(PathHelper.matchesBaseUrl('/api-v2', '/api')).toBe(false)
+    })
+
+    it('should match nested paths', () => {
+      expect(PathHelper.matchesBaseUrl('/api/v1/users/123', '/api')).toBe(true)
+      expect(PathHelper.matchesBaseUrl('/api/v1/users/123', '/api/v1')).toBe(true)
+    })
+
+    it('should handle root path', () => {
+      expect(PathHelper.matchesBaseUrl('/api', '/')).toBe(true)
+      expect(PathHelper.matchesBaseUrl('/', '/')).toBe(true)
+    })
+
+    it('should match with query string', () => {
+      expect(PathHelper.matchesBaseUrl('/api/users?page=1', '/api')).toBe(true)
+    })
+
+    it('should match with trailing slash in request', () => {
+      expect(PathHelper.matchesBaseUrl('/api/', '/api')).toBe(true)
+    })
+  })
+
+  describe('#extractPath()', () => {
+    it('should extract path after base URL', () => {
+      expect(PathHelper.extractPath('/api/users', '/api')).toBe('/users')
+    })
+
+    it('should return empty string for exact match', () => {
+      expect(PathHelper.extractPath('/api', '/api')).toBe('')
+    })
+
+    it('should preserve query string', () => {
+      expect(PathHelper.extractPath('/api/users?id=1', '/api')).toBe('/users?id=1')
+    })
+
+    it('should handle trailing slash in request', () => {
+      expect(PathHelper.extractPath('/api/', '/api')).toBe('/')
+    })
+
+    it('should handle trailing slash in base', () => {
+      expect(PathHelper.extractPath('/api/users', '/api/')).toBe('/users')
+    })
+
+    it('should extract nested paths', () => {
+      expect(PathHelper.extractPath('/api/v1/users/123', '/api')).toBe('/v1/users/123')
+      expect(PathHelper.extractPath('/api/v1/users/123', '/api/v1')).toBe('/users/123')
+    })
+
+    it('should return original URL if no match', () => {
+      expect(PathHelper.extractPath('/other/path', '/api')).toBe('/other/path')
+    })
+
+    it('should handle complex query strings', () => {
+      expect(PathHelper.extractPath('/api/search?q=test&limit=10&offset=0', '/api')).toBe(
+        '/search?q=test&limit=10&offset=0',
+      )
+    })
+
+    it('should preserve fragments', () => {
+      expect(PathHelper.extractPath('/api/page#section', '/api')).toBe('/page#section')
+    })
+  })
+
+  describe('#normalizeUrl()', () => {
+    it('should remove double slashes from path', () => {
+      expect(PathHelper.normalizeUrl('/api//users')).toBe('/api/users')
+    })
+
+    it('should remove multiple consecutive slashes', () => {
+      expect(PathHelper.normalizeUrl('/api///users////123')).toBe('/api/users/123')
+    })
+
+    it('should preserve protocol slashes', () => {
+      expect(PathHelper.normalizeUrl('http://example.com//path')).toBe('http://example.com/path')
+    })
+
+    it('should handle HTTPS protocol', () => {
+      expect(PathHelper.normalizeUrl('https://example.com///path//to///resource')).toBe(
+        'https://example.com/path/to/resource',
+      )
+    })
+
+    it('should not modify already normalized URLs', () => {
+      expect(PathHelper.normalizeUrl('http://example.com/path')).toBe('http://example.com/path')
+      expect(PathHelper.normalizeUrl('/api/users')).toBe('/api/users')
+    })
+
+    it('should handle trailing slash', () => {
+      expect(PathHelper.normalizeUrl('http://example.com/')).toBe('http://example.com/')
+      expect(PathHelper.normalizeUrl('/api/')).toBe('/api/')
+    })
+
+    it('should handle custom protocols', () => {
+      expect(PathHelper.normalizeUrl('ftp://example.com//path')).toBe('ftp://example.com/path')
+      expect(PathHelper.normalizeUrl('ws://example.com//socket')).toBe('ws://example.com/socket')
+    })
+
+    it('should handle URLs with port', () => {
+      expect(PathHelper.normalizeUrl('http://example.com:8080//path')).toBe('http://example.com:8080/path')
+    })
+
+    it('should preserve query strings', () => {
+      expect(PathHelper.normalizeUrl('/api//users?page=1')).toBe('/api/users?page=1')
+    })
+  })
 })

package/src/path-helper.ts

@@ -67,4 +67,155 @@ export class PathHelper {
   public static normalize(path: string) {
     return this.getSegments(path).join('/')
   }
+
+  /**
+   * Trims only the trailing slash from a URL or path
+   * @param url The URL or path to trim
+   * @returns The URL/path without trailing slash
+   * @example
+   * PathHelper.trimTrailingSlash('/api/') // '/api'
+   * PathHelper.trimTrailingSlash('http://example.com/') // 'http://example.com'
+   */
+  public static trimTrailingSlash(url: string): string {
+    return url.endsWith('/') ? url.slice(0, -1) : url
+  }
+
+  /**
+   * Trims only the leading slash from a path
+   * @param path The path to trim
+   * @returns The path without leading slash
+   * @example
+   * PathHelper.trimLeadingSlash('/api') // 'api'
+   * PathHelper.trimLeadingSlash('api') // 'api'
+   */
+  public static trimLeadingSlash(path: string): string {
+    return path.startsWith('/') ? path.slice(1) : path
+  }
+
+  /**
+   * Ensures a path has a leading slash
+   * @param path The path to check
+   * @returns The path with a leading slash
+   * @example
+   * PathHelper.ensureLeadingSlash('api') // '/api'
+   * PathHelper.ensureLeadingSlash('/api') // '/api'
+   */
+  public static ensureLeadingSlash(path: string): string {
+    return path.startsWith('/') ? path : `/${path}`
+  }
+
+  /**
+   * Normalizes a base URL by ensuring it has no trailing slash
+   * @param baseUrl The base URL to normalize (e.g., 'http://example.com/' or '/api/')
+   * @returns The normalized base URL without trailing slash
+   * @example
+   * PathHelper.normalizeBaseUrl('http://example.com/') // 'http://example.com'
+   * PathHelper.normalizeBaseUrl('/api/') // '/api'
+   * PathHelper.normalizeBaseUrl('/api') // '/api'
+   */
+  public static normalizeBaseUrl(baseUrl: string): string {
+    return this.trimTrailingSlash(baseUrl)
+  }
+
+  /**
+   * Joins a base URL with a path, handling slashes correctly
+   * Preserves protocols (http://, https://, etc.)
+   * @param baseUrl The base URL (with or without trailing slash)
+   * @param path The path to append (with or without leading slash)
+   * @returns The combined URL with correct slash handling
+   * @example
+   * PathHelper.joinUrl('http://example.com', '/path') // 'http://example.com/path'
+   * PathHelper.joinUrl('http://example.com/', 'path') // 'http://example.com/path'
+   * PathHelper.joinUrl('/api', '/users') // '/api/users'
+   * PathHelper.joinUrl('/api/', 'users') // '/api/users'
+   * PathHelper.joinUrl('http://example.com', '') // 'http://example.com'
+   */
+  public static joinUrl(baseUrl: string, path: string): string {
+    if (!path) {
+      return this.normalizeBaseUrl(baseUrl)
+    }
+    const normalizedBase = this.normalizeBaseUrl(baseUrl)
+    const normalizedPath = this.ensureLeadingSlash(path)
+    return `${normalizedBase}${normalizedPath}`
+  }
+
+  /**
+   * Checks if a request URL matches a base URL pattern
+   * Handles trailing slash variations correctly
+   * @param requestUrl The incoming request URL
+   * @param baseUrl The base URL pattern to match against
+   * @returns true if the request URL matches the base URL
+   * @example
+   * PathHelper.matchesBaseUrl('/api/users', '/api') // true
+   * PathHelper.matchesBaseUrl('/api', '/api') // true
+   * PathHelper.matchesBaseUrl('/api', '/api/') // true
+   * PathHelper.matchesBaseUrl('/other', '/api') // false
+   * PathHelper.matchesBaseUrl('/api2', '/api') // false (not a path match)
+   */
+  public static matchesBaseUrl(requestUrl: string, baseUrl: string): boolean {
+    const normalizedBase = this.normalizeBaseUrl(baseUrl)
+    const normalizedRequest = requestUrl
+
+    // Exact match
+    if (normalizedRequest === normalizedBase) {
+      return true
+    }
+
+    // Check if request starts with base followed by a slash
+    // This prevents '/api2' from matching '/api'
+    return normalizedRequest.startsWith(`${normalizedBase}/`)
+  }
+
+  /**
+   * Extracts the remaining path after a base URL
+   * Always returns a path with a leading slash (or empty string for exact matches)
+   * @param requestUrl The full request URL
+   * @param baseUrl The base URL to remove
+   * @returns The remaining path with leading slash, or empty string if exact match
+   * @example
+   * PathHelper.extractPath('/api/users', '/api') // '/users'
+   * PathHelper.extractPath('/api', '/api') // ''
+   * PathHelper.extractPath('/api/users?id=1', '/api') // '/users?id=1'
+   * PathHelper.extractPath('/api/', '/api') // '/'
+   */
+  public static extractPath(requestUrl: string, baseUrl: string): string {
+    const normalizedBase = this.normalizeBaseUrl(baseUrl)
+
+    // Exact match
+    if (requestUrl === normalizedBase) {
+      return ''
+    }
+
+    // If request doesn't match base, return the original request URL
+    if (!this.matchesBaseUrl(requestUrl, baseUrl)) {
+      return requestUrl
+    }
+
+    // Extract the path after the base
+    return requestUrl.substring(normalizedBase.length)
+  }
+
+  /**
+   * Normalizes a URL by removing consecutive slashes (except after protocol)
+   * @param url The URL to normalize
+   * @returns The normalized URL
+   * @example
+   * PathHelper.normalizeUrl('http://example.com//path') // 'http://example.com/path'
+   * PathHelper.normalizeUrl('/api//users///123') // '/api/users/123'
+   * PathHelper.normalizeUrl('http://example.com/') // 'http://example.com/'
+   */
+  public static normalizeUrl(url: string): string {
+    // Handle protocol separately to preserve ://
+    const protocolMatch = url.match(/^([a-z][a-z0-9+.-]*:\/\/)(.*)$/i)
+
+    if (protocolMatch) {
+      const [, protocol, rest] = protocolMatch
+      // Remove consecutive slashes from the rest
+      const normalized = rest.replace(/\/+/g, '/')
+      return `${protocol}${normalized}`
+    }
+
+    // No protocol, just remove consecutive slashes
+    return url.replace(/\/+/g, '/')
+  }
 }

package/src/sort-by.ts

@@ -4,7 +4,10 @@ declare global {
    */
   export interface Array<T> {
     /**
-     * Returns a promise with a new array of elements that meets the specified async callback
+     * Sorts the array by a specified field and direction
+     * @param field The field to sort by
+     * @param direction The sort direction, either 'asc' or 'desc' (default: 'asc')
+     * @returns A new sorted array
      */
     sortBy: (field: keyof T, direction?: 'asc' | 'desc') => T[]
   }

package/src/using-async.ts

@@ -2,9 +2,9 @@ import { isAsyncDisposable } from './is-async-disposable.js'
 import { isDisposable } from './is-disposable.js'
 
 /**
- * Method that accepts an IDisposable resource that will be disposed after the callback
+ * Method that accepts a Disposable or AsyncDisposable resource that will be disposed after the callback
  * @param resource The resource that is used in the callback and will be disposed afterwards
- * @param callback The callback that will be executed asynchrounously before the resource will be disposed
+ * @param callback The callback that will be executed asynchronously before the resource will be disposed
  * @returns A promise that will be resolved with a return value after the resource is disposed
  */
 export const usingAsync = async <T extends Disposable | AsyncDisposable, TReturns>(

package/src/using.ts

@@ -1,7 +1,7 @@
 /**
- * Method that accepts an IDisposable resource that will be disposed after the callback
+ * Method that accepts a Disposable resource that will be disposed after the callback
  * @param resource The resource that is used in the callback and will be disposed afterwards
- * @param callback The callback that will be executed synchrounously before the resource will be disposed
+ * @param callback The callback that will be executed synchronously before the resource will be disposed
  * @returns the value that will be returned by the callback method
  */
 export const using = <T extends Disposable, TReturns>(resource: T, callback: (r: T) => TReturns) => {

package/src/value-observer.ts

@@ -35,7 +35,7 @@ export class ValueObserver<T> implements Disposable {
   }
 
   /**
-   * @constructs ValueObserver<T> the ValueObserver instance
+   * Creates a ValueObserver instance
    * @param observable The related Observable object
    * @param callback The callback that will be fired on change
    * @param options Additional options