@fern-api/ui-core-utils 0.139.3-b692c26d1 → 0.139.3-e28429302

package/dist/__test__/sanitizeUrl.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sanitizeUrl.test.d.ts.map

package/dist/__test__/sanitizeUrl.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizeUrl.test.d.ts","sourceRoot":"","sources":["../../src/__test__/sanitizeUrl.test.ts"],"names":[],"mappings":""}

package/dist/__test__/sanitizeUrl.test.js

@@ -0,0 +1,72 @@
+import { sanitizeUrl } from "../sanitizeUrl";
+describe("sanitizeUrl", () => {
+    describe("undefined and empty inputs", () => {
+        it("returns undefined for undefined input", () => {
+            expect(sanitizeUrl(undefined)).toBeUndefined();
+        });
+        it("returns undefined for empty string", () => {
+            expect(sanitizeUrl("")).toBeUndefined();
+        });
+        it("returns undefined for whitespace string", () => {
+            expect(sanitizeUrl("   ")).toBeUndefined();
+        });
+    });
+    describe("protocol-relative URLs", () => {
+        it("handles protocol-relative URLs starting with //", () => {
+            expect(sanitizeUrl("//example.com")).toBe("https://example.com/");
+            expect(sanitizeUrl("//api.example.com/path")).toBe("https://api.example.com/path");
+            expect(sanitizeUrl("//localhost:8080")).toBe("https://localhost:8080/");
+        });
+        it("returns undefined for invalid protocol-relative URLs", () => {
+            expect(sanitizeUrl("//")).toBeUndefined();
+        });
+    });
+    describe("URLs without protocol", () => {
+        it("adds https:// to URLs without protocol", () => {
+            expect(sanitizeUrl("example.com")).toBe("https://example.com/");
+            expect(sanitizeUrl("api.example.com/path")).toBe("https://api.example.com/path");
+            expect(sanitizeUrl("localhost:3000")).toBe("https://localhost:3000/");
+        });
+    });
+    describe("complete URLs with protocol", () => {
+        it("validates and returns complete HTTPS URLs", () => {
+            expect(sanitizeUrl("https://example.com")).toBe("https://example.com/");
+            expect(sanitizeUrl("https://api.example.com/path")).toBe("https://api.example.com/path");
+            expect(sanitizeUrl("https://localhost:8080")).toBe("https://localhost:8080/");
+            expect(sanitizeUrl("https://example.com?param=value")).toBe("https://example.com/?param=value");
+        });
+        it("validates and returns complete HTTP URLs", () => {
+            expect(sanitizeUrl("http://example.com")).toBe("http://example.com/");
+            expect(sanitizeUrl("http://api.example.com/path")).toBe("http://api.example.com/path");
+            expect(sanitizeUrl("http://localhost:8080")).toBe("http://localhost:8080/");
+        });
+        it("returns undefined for invalid complete URLs", () => {
+            expect(sanitizeUrl("https://")).toBeUndefined();
+            expect(sanitizeUrl("http://")).toBeUndefined();
+        });
+    });
+    describe("edge cases", () => {
+        it("handles URLs with query parameters and fragments", () => {
+            expect(sanitizeUrl("https://example.com/path?param=value#fragment")).toBe("https://example.com/path?param=value#fragment");
+            expect(sanitizeUrl("example.com/path?param=value#fragment")).toBe("https://example.com/path?param=value#fragment");
+        });
+        it("handles URLs with special characters", () => {
+            expect(sanitizeUrl("https://example.com/path with spaces")).toBe("https://example.com/path%20with%20spaces");
+            expect(sanitizeUrl("example.com/path with spaces")).toBe("https://example.com/path%20with%20spaces");
+        });
+        it("handles URLs with authentication", () => {
+            expect(sanitizeUrl("https://user:pass@example.com")).toBe("https://user:pass@example.com/");
+            expect(sanitizeUrl("user:pass@example.com")).toBe("https://user:pass@example.com/");
+        });
+        it("handles IP addresses", () => {
+            expect(sanitizeUrl("https://192.168.1.1")).toBe("https://192.168.1.1/");
+            expect(sanitizeUrl("192.168.1.1")).toBe("https://192.168.1.1/");
+            expect(sanitizeUrl("//192.168.1.1")).toBe("https://192.168.1.1/");
+        });
+        it("handles localhost", () => {
+            expect(sanitizeUrl("https://localhost")).toBe("https://localhost/");
+            expect(sanitizeUrl("localhost")).toBe("https://localhost/");
+            expect(sanitizeUrl("//localhost")).toBe("https://localhost/");
+        });
+    });
+});

package/dist/index.d.ts

@@ -20,4 +20,5 @@ export type { Digit, Letter, LowercaseLetter, UppercaseLetter } from "./types";
 export { unknownToString } from "./unknownToString";
 export { visitDiscriminatedUnion } from "./visitDiscriminatedUnion";
 export { withDefaultProtocol } from "./withDefaultProtocol";
+export { sanitizeUrl } from "./sanitizeUrl";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EACL,WAAW,EACX,KAAK,uBAAuB,GAC7B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EACL,WAAW,EACX,KAAK,uBAAuB,GAC7B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -19,3 +19,4 @@ export { titleCase } from "./titleCase";
 export { unknownToString } from "./unknownToString";
 export { visitDiscriminatedUnion } from "./visitDiscriminatedUnion";
 export { withDefaultProtocol } from "./withDefaultProtocol";
+export { sanitizeUrl } from "./sanitizeUrl";

package/dist/sanitizeUrl.d.ts

@@ -0,0 +1,6 @@
+/**
+ * validates and sanitizes a base URL.
+ * returns null if the URL cannot be coerced into a valid URL.
+ */
+export declare function sanitizeUrl(url: string | undefined): string | undefined;
+//# sourceMappingURL=sanitizeUrl.d.ts.map

package/dist/sanitizeUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizeUrl.d.ts","sourceRoot":"","sources":["../src/sanitizeUrl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAgCvE"}

package/dist/sanitizeUrl.js

@@ -0,0 +1,37 @@
+/**
+ * validates and sanitizes a base URL.
+ * returns null if the URL cannot be coerced into a valid URL.
+ */
+export function sanitizeUrl(url) {
+    if (!url) {
+        return undefined;
+    }
+    // handle protocol-relative URLs (starting with //)
+    if (url.startsWith("//")) {
+        try {
+            const parsedUrl = new URL(`https:${url}`);
+            return parsedUrl.toString();
+        }
+        catch {
+            return undefined;
+        }
+    }
+    // handle URLs without protocol
+    if (!url.startsWith("http://") && !url.startsWith("https://")) {
+        try {
+            const parsedUrl = new URL(`https://${url}`);
+            return parsedUrl.toString();
+        }
+        catch {
+            return undefined;
+        }
+    }
+    // validate complete URLs
+    try {
+        const parsedUrl = new URL(url);
+        return parsedUrl.toString();
+    }
+    catch {
+        return undefined;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fern-api/ui-core-utils",
-  "version": "0.139.3-b692c26d1",
+  "version": "0.139.3-e28429302",
   "repository": {
     "type": "git",
     "url": "https://github.com/fern-api/fern-platform.git",