@wener/common 2.0.3 → 2.0.6

package/lib/s3/parseS3Url.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/s3/parseS3Url.ts"],"sourcesContent":["import { parseBoolean } from '@wener/utils';\n\nexport type ParsedS3Options = {\n\taccessKeyId?: string;\n\tsecretAccessKey?: string;\n\tregion?: string;\n\tuseSsl?: boolean;\n\tbucket?: string;\n\tendpoint: string;\n\tport?: number;\n\tpathStyle?: boolean;\n\turl?: string;\n};\n\nexport type ParseS3UrlOptions = Partial<ParsedS3Options>;\n\nfunction isValidIpAddress(hostname: string): boolean {\n\tconst ipv4Regex = /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;\n\tconst ipv6Regex = /^\\[([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}]$/;\n\treturn ipv4Regex.test(hostname) || ipv6Regex.test(hostname);\n}\n\nexport function parseS3Url({ url = process.env.S3_URL, ...rest }: ParseS3UrlOptions = {}): ParsedS3Options | undefined {\n\tif (!url) return undefined;\n\n\tconst normalizedUrl = url.startsWith('s3://') ? url.replace(/^s3:\\/\\//, 'https://') : url;\n\tlet parsed: URL;\n\ttry {\n\t\tparsed = new URL(normalizedUrl);\n\t} catch (error) {\n\t\tthrow new Error(`Invalid S3 URL: ${url}`);\n\t}\n\n\tconst pathStyleParam = parsed.searchParams.get('pathStyle');\n\tlet pathStyle: boolean | undefined = rest.pathStyle;\n\tpathStyle ??= parseBoolean(pathStyleParam, true);\n\n\t// Auto-detect path style for IP addresses\n\tif (pathStyle === undefined && isValidIpAddress(parsed.hostname)) {\n\t\tpathStyle = true;\n\t}\n\n\tconst result: ParsedS3Options = {\n\t\taccessKeyId: parsed.username || undefined,\n\t\tsecretAccessKey: parsed.password || undefined,\n\t\tendpoint: parsed.hostname,\n\t\tport: parsed.port ? Number(parsed.port) : undefined,\n\t\tuseSsl: parsed.protocol === 'https:',\n\t\tregion: parsed.searchParams.get('region') || undefined,\n\t\tpathStyle,\n\t};\n\n\tif (!result.port) {\n\t\tif (result.useSsl) {\n\t\t\tresult.port = 443;\n\t\t} else {\n\t\t\tresult.port = 80;\n\t\t}\n\t}\n\n\tconst pathSegments = parsed.pathname.split('/').filter(Boolean);\n\tconst awsVirtualHostMatch = parsed.hostname.match(/^(.*?)\\.s3[.-]([a-z0-9-]+)?\\.?amazonaws\\.com$/);\n\n\tif (result.pathStyle) {\n\t\tresult.bucket = pathSegments[0];\n\t} else if (awsVirtualHostMatch) {\n\t\tresult.bucket = awsVirtualHostMatch[1];\n\t\tresult.endpoint = parsed.hostname;\n\t\tif (!result.region && awsVirtualHostMatch[2]) {\n\t\t\tresult.region = awsVirtualHostMatch[2];\n\t\t}\n\t\tresult.pathStyle = false;\n\t} else {\n\t\tresult.bucket = pathSegments[0];\n\t\tif (result.pathStyle === undefined) {\n\t\t\tresult.pathStyle = true;\n\t\t}\n\t}\n\n\t// Type-safe property assignment\n\tfor (const [key, value] of Object.entries(rest)) {\n\t\tif (value !== undefined && value !== null && key in result) {\n\t\t\t(result as Record<string, unknown>)[key] = value;\n\t\t}\n\t}\n\n\treturn result;\n}\n"],"names":["parseBoolean","isValidIpAddress","hostname","ipv4Regex","ipv6Regex","test","parseS3Url","url","process","env","S3_URL","rest","undefined","normalizedUrl","startsWith","replace","parsed","URL","error","Error","pathStyleParam","searchParams","get","pathStyle","result","accessKeyId","username","secretAccessKey","password","endpoint","port","Number","useSsl","protocol","region","pathSegments","pathname","split","filter","Boolean","awsVirtualHostMatch","match","bucket","key","value","Object","entries"],"mappings":"AAAA,SAASA,YAAY,QAAQ,eAAe;AAgB5C,SAASC,iBAAiBC,QAAgB;IACzC,MAAMC,YAAY;IAClB,MAAMC,YAAY;IAClB,OAAOD,UAAUE,IAAI,CAACH,aAAaE,UAAUC,IAAI,CAACH;AACnD;AAEA,OAAO,SAASI,WAAW,EAAEC,MAAMC,QAAQC,GAAG,CAACC,MAAM,EAAE,GAAGC,MAAyB,GAAG,CAAC,CAAC;IACvF,IAAI,CAACJ,KAAK,OAAOK;IAEjB,MAAMC,gBAAgBN,IAAIO,UAAU,CAAC,WAAWP,IAAIQ,OAAO,CAAC,YAAY,cAAcR;IACtF,IAAIS;IACJ,IAAI;QACHA,SAAS,IAAIC,IAAIJ;IAClB,EAAE,OAAOK,OAAO;QACf,MAAM,IAAIC,MAAM,CAAC,gBAAgB,EAAEZ,KAAK;IACzC;IAEA,MAAMa,iBAAiBJ,OAAOK,YAAY,CAACC,GAAG,CAAC;IAC/C,IAAIC,YAAiCZ,KAAKY,SAAS;IACnDA,cAAcvB,aAAaoB,gBAAgB;IAE3C,0CAA0C;IAC1C,IAAIG,cAAcX,aAAaX,iBAAiBe,OAAOd,QAAQ,GAAG;QACjEqB,YAAY;IACb;IAEA,MAAMC,SAA0B;QAC/BC,aAAaT,OAAOU,QAAQ,IAAId;QAChCe,iBAAiBX,OAAOY,QAAQ,IAAIhB;QACpCiB,UAAUb,OAAOd,QAAQ;QACzB4B,MAAMd,OAAOc,IAAI,GAAGC,OAAOf,OAAOc,IAAI,IAAIlB;QAC1CoB,QAAQhB,OAAOiB,QAAQ,KAAK;QAC5BC,QAAQlB,OAAOK,YAAY,CAACC,GAAG,CAAC,aAAaV;QAC7CW;IACD;IAEA,IAAI,CAACC,OAAOM,IAAI,EAAE;QACjB,IAAIN,OAAOQ,MAAM,EAAE;YAClBR,OAAOM,IAAI,GAAG;QACf,OAAO;YACNN,OAAOM,IAAI,GAAG;QACf;IACD;IAEA,MAAMK,eAAenB,OAAOoB,QAAQ,CAACC,KAAK,CAAC,KAAKC,MAAM,CAACC;IACvD,MAAMC,sBAAsBxB,OAAOd,QAAQ,CAACuC,KAAK,CAAC;IAElD,IAAIjB,OAAOD,SAAS,EAAE;QACrBC,OAAOkB,MAAM,GAAGP,YAAY,CAAC,EAAE;IAChC,OAAO,IAAIK,qBAAqB;QAC/BhB,OAAOkB,MAAM,GAAGF,mBAAmB,CAAC,EAAE;QACtChB,OAAOK,QAAQ,GAAGb,OAAOd,QAAQ;QACjC,IAAI,CAACsB,OAAOU,MAAM,IAAIM,mBAAmB,CAAC,EAAE,EAAE;YAC7ChB,OAAOU,MAAM,GAAGM,mBAAmB,CAAC,EAAE;QACvC;QACAhB,OAAOD,SAAS,GAAG;IACpB,OAAO;QACNC,OAAOkB,MAAM,GAAGP,YAAY,CAAC,EAAE;QAC/B,IAAIX,OAAOD,SAAS,KAAKX,WAAW;YACnCY,OAAOD,SAAS,GAAG;QACpB;IACD;IAEA,gCAAgC;IAChC,KAAK,MAAM,CAACoB,KAAKC,MAAM,IAAIC,OAAOC,OAAO,CAACnC,MAAO;QAChD,IAAIiC,UAAUhC,aAAagC,UAAU,QAAQD,OAAOnB,QAAQ;YAC1DA,MAAkC,CAACmB,IAAI,GAAGC;QAC5C;IACD;IAEA,OAAOpB;AACR"}
+{"version":3,"sources":["../../src/s3/parseS3Url.ts"],"sourcesContent":["import { parseBoolean } from '@wener/utils';\n\nexport type ParsedS3Options = {\n\taccessKeyId?: string;\n\tsecretAccessKey?: string;\n\tregion?: string;\n\tuseSsl?: boolean;\n\tbucket?: string;\n\tendpoint: string;\n\tport?: number;\n\tpathStyle?: boolean;\n\turl?: string;\n};\n\nexport type ParseS3UrlOptions = Partial<ParsedS3Options>;\n\nfunction isValidIpAddress(hostname: string): boolean {\n\tconst ipv4Regex = /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;\n\tconst ipv6Regex = /^\\[([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}]$/;\n\treturn ipv4Regex.test(hostname) || ipv6Regex.test(hostname);\n}\n\nexport function parseS3Url({ url = process.env.S3_URL, ...rest }: ParseS3UrlOptions = {}): ParsedS3Options | undefined {\n\tif (!url) return undefined;\n\n\tconst normalizedUrl = url.startsWith('s3://') ? url.replace(/^s3:\\/\\//, 'https://') : url;\n\tlet parsed: URL;\n\ttry {\n\t\tparsed = new URL(normalizedUrl);\n\t} catch (_error) {\n\t\tthrow new Error(`Invalid S3 URL: ${url}`);\n\t}\n\n\tconst pathStyleParam = parsed.searchParams.get('pathStyle');\n\tlet pathStyle: boolean | undefined = rest.pathStyle;\n\tpathStyle ??= parseBoolean(pathStyleParam, true);\n\n\t// Auto-detect path style for IP addresses\n\tif (pathStyle === undefined && isValidIpAddress(parsed.hostname)) {\n\t\tpathStyle = true;\n\t}\n\n\tconst result: ParsedS3Options = {\n\t\taccessKeyId: parsed.username || undefined,\n\t\tsecretAccessKey: parsed.password || undefined,\n\t\tendpoint: parsed.hostname,\n\t\tport: parsed.port ? Number(parsed.port) : undefined,\n\t\tuseSsl: parsed.protocol === 'https:',\n\t\tregion: parsed.searchParams.get('region') || undefined,\n\t\tpathStyle,\n\t};\n\n\tif (!result.port) {\n\t\tif (result.useSsl) {\n\t\t\tresult.port = 443;\n\t\t} else {\n\t\t\tresult.port = 80;\n\t\t}\n\t}\n\n\tconst pathSegments = parsed.pathname.split('/').filter(Boolean);\n\tconst awsVirtualHostMatch = parsed.hostname.match(/^(.*?)\\.s3[.-]([a-z0-9-]+)?\\.?amazonaws\\.com$/);\n\n\tif (result.pathStyle) {\n\t\tresult.bucket = pathSegments[0];\n\t} else if (awsVirtualHostMatch) {\n\t\tresult.bucket = awsVirtualHostMatch[1];\n\t\tresult.endpoint = parsed.hostname;\n\t\tif (!result.region && awsVirtualHostMatch[2]) {\n\t\t\tresult.region = awsVirtualHostMatch[2];\n\t\t}\n\t\tresult.pathStyle = false;\n\t} else {\n\t\tresult.bucket = pathSegments[0];\n\t\tif (result.pathStyle === undefined) {\n\t\t\tresult.pathStyle = true;\n\t\t}\n\t}\n\n\t// Type-safe property assignment\n\tfor (const [key, value] of Object.entries(rest)) {\n\t\tif (value !== undefined && value !== null && key in result) {\n\t\t\t(result as Record<string, unknown>)[key] = value;\n\t\t}\n\t}\n\n\treturn result;\n}\n"],"names":["parseBoolean","isValidIpAddress","hostname","ipv4Regex","ipv6Regex","test","parseS3Url","url","process","env","S3_URL","rest","undefined","normalizedUrl","startsWith","replace","parsed","URL","_error","Error","pathStyleParam","searchParams","get","pathStyle","result","accessKeyId","username","secretAccessKey","password","endpoint","port","Number","useSsl","protocol","region","pathSegments","pathname","split","filter","Boolean","awsVirtualHostMatch","match","bucket","key","value","Object","entries"],"mappings":"AAAA,SAASA,YAAY,QAAQ,eAAe;AAgB5C,SAASC,iBAAiBC,QAAgB;IACzC,MAAMC,YAAY;IAClB,MAAMC,YAAY;IAClB,OAAOD,UAAUE,IAAI,CAACH,aAAaE,UAAUC,IAAI,CAACH;AACnD;AAEA,OAAO,SAASI,WAAW,EAAEC,MAAMC,QAAQC,GAAG,CAACC,MAAM,EAAE,GAAGC,MAAyB,GAAG,CAAC,CAAC;IACvF,IAAI,CAACJ,KAAK,OAAOK;IAEjB,MAAMC,gBAAgBN,IAAIO,UAAU,CAAC,WAAWP,IAAIQ,OAAO,CAAC,YAAY,cAAcR;IACtF,IAAIS;IACJ,IAAI;QACHA,SAAS,IAAIC,IAAIJ;IAClB,EAAE,OAAOK,QAAQ;QAChB,MAAM,IAAIC,MAAM,CAAC,gBAAgB,EAAEZ,KAAK;IACzC;IAEA,MAAMa,iBAAiBJ,OAAOK,YAAY,CAACC,GAAG,CAAC;IAC/C,IAAIC,YAAiCZ,KAAKY,SAAS;IACnDA,cAAcvB,aAAaoB,gBAAgB;IAE3C,0CAA0C;IAC1C,IAAIG,cAAcX,aAAaX,iBAAiBe,OAAOd,QAAQ,GAAG;QACjEqB,YAAY;IACb;IAEA,MAAMC,SAA0B;QAC/BC,aAAaT,OAAOU,QAAQ,IAAId;QAChCe,iBAAiBX,OAAOY,QAAQ,IAAIhB;QACpCiB,UAAUb,OAAOd,QAAQ;QACzB4B,MAAMd,OAAOc,IAAI,GAAGC,OAAOf,OAAOc,IAAI,IAAIlB;QAC1CoB,QAAQhB,OAAOiB,QAAQ,KAAK;QAC5BC,QAAQlB,OAAOK,YAAY,CAACC,GAAG,CAAC,aAAaV;QAC7CW;IACD;IAEA,IAAI,CAACC,OAAOM,IAAI,EAAE;QACjB,IAAIN,OAAOQ,MAAM,EAAE;YAClBR,OAAOM,IAAI,GAAG;QACf,OAAO;YACNN,OAAOM,IAAI,GAAG;QACf;IACD;IAEA,MAAMK,eAAenB,OAAOoB,QAAQ,CAACC,KAAK,CAAC,KAAKC,MAAM,CAACC;IACvD,MAAMC,sBAAsBxB,OAAOd,QAAQ,CAACuC,KAAK,CAAC;IAElD,IAAIjB,OAAOD,SAAS,EAAE;QACrBC,OAAOkB,MAAM,GAAGP,YAAY,CAAC,EAAE;IAChC,OAAO,IAAIK,qBAAqB;QAC/BhB,OAAOkB,MAAM,GAAGF,mBAAmB,CAAC,EAAE;QACtChB,OAAOK,QAAQ,GAAGb,OAAOd,QAAQ;QACjC,IAAI,CAACsB,OAAOU,MAAM,IAAIM,mBAAmB,CAAC,EAAE,EAAE;YAC7ChB,OAAOU,MAAM,GAAGM,mBAAmB,CAAC,EAAE;QACvC;QACAhB,OAAOD,SAAS,GAAG;IACpB,OAAO;QACNC,OAAOkB,MAAM,GAAGP,YAAY,CAAC,EAAE;QAC/B,IAAIX,OAAOD,SAAS,KAAKX,WAAW;YACnCY,OAAOD,SAAS,GAAG;QACpB;IACD;IAEA,gCAAgC;IAChC,KAAK,MAAM,CAACoB,KAAKC,MAAM,IAAIC,OAAOC,OAAO,CAACnC,MAAO;QAChD,IAAIiC,UAAUhC,aAAagC,UAAU,QAAQD,OAAOnB,QAAQ;YAC1DA,MAAkC,CAACmB,IAAI,GAAGC;QAC5C;IACD;IAEA,OAAOpB;AACR"}

package/lib/s3/parseS3Url.test.js

@@ -1,270 +1,271 @@
-import { beforeEach, describe, expect, it, vi } from "vitest";
-import { parseS3Url } from "./parseS3Url.js";
-describe("parseS3Url", function () {
-    beforeEach(function () {
-        vi.restoreAllMocks();
-    });
-    it("should return undefined for empty URL", function () {
-        var result = parseS3Url({
-            url: ""
-        });
-        expect(result).toBeUndefined();
-    });
-    it("should return undefined for undefined URL", function () {
-        var result = parseS3Url({
-            url: undefined
-        });
-        expect(result).toBeUndefined();
-    });
-    it("should parse basic HTTPS URL", function () {
-        var result = parseS3Url({
-            url: "https://s3.amazonaws.com/bucket-name"
-        });
-        expect(result).toEqual({
-            accessKeyId: undefined,
-            secretAccessKey: undefined,
-            endpoint: "s3.amazonaws.com",
-            port: 443,
-            useSsl: true,
-            region: undefined,
-            pathStyle: true,
-            bucket: "bucket-name"
-        });
-    });
-    it("should parse basic HTTP URL", function () {
-        var result = parseS3Url({
-            url: "http://s3.amazonaws.com/bucket-name"
-        });
-        expect(result).toEqual({
-            accessKeyId: undefined,
-            secretAccessKey: undefined,
-            endpoint: "s3.amazonaws.com",
-            port: 80,
-            useSsl: false,
-            region: undefined,
-            pathStyle: true,
-            bucket: "bucket-name"
-        });
-    });
-    it("should parse S3 protocol URL", function () {
-        var result = parseS3Url({
-            url: "s3://s3.amazonaws.com/bucket-name"
-        });
-        expect(result).toEqual({
-            accessKeyId: undefined,
-            secretAccessKey: undefined,
-            endpoint: "s3.amazonaws.com",
-            port: 443,
-            useSsl: true,
-            region: undefined,
-            pathStyle: true,
-            bucket: "bucket-name"
-        });
-    });
-    it("should parse URL with credentials", function () {
-        var result = parseS3Url({
-            url: "https://user:pass@s3.amazonaws.com/bucket-name"
-        });
-        expect(result).toEqual({
-            accessKeyId: "user",
-            secretAccessKey: "pass",
-            endpoint: "s3.amazonaws.com",
-            port: 443,
-            useSsl: true,
-            region: undefined,
-            pathStyle: true,
-            bucket: "bucket-name"
-        });
-    });
-    it("should parse URL with port", function () {
-        var result = parseS3Url({
-            url: "https://s3.amazonaws.com:9000/bucket-name"
-        });
-        expect(result).toEqual({
-            accessKeyId: undefined,
-            secretAccessKey: undefined,
-            endpoint: "s3.amazonaws.com",
-            port: 9000,
-            useSsl: true,
-            region: undefined,
-            pathStyle: true,
-            bucket: "bucket-name"
-        });
-    });
-    it("should parse URL with region query parameter", function () {
-        var result = parseS3Url({
-            url: "https://s3.amazonaws.com/bucket-name?region=us-east-1"
-        });
-        expect(result).toEqual({
-            accessKeyId: undefined,
-            secretAccessKey: undefined,
-            endpoint: "s3.amazonaws.com",
-            port: 443,
-            useSsl: true,
-            region: "us-east-1",
-            pathStyle: true,
-            bucket: "bucket-name"
-        });
-    });
-    it("should parse URL with pathStyle parameter", function () {
-        var result = parseS3Url({
-            url: "https://s3.amazonaws.com/bucket-name?pathStyle=true"
-        });
-        expect(result).toEqual({
-            accessKeyId: undefined,
-            secretAccessKey: undefined,
-            endpoint: "s3.amazonaws.com",
-            port: 443,
-            useSsl: true,
-            region: undefined,
-            pathStyle: true,
-            bucket: "bucket-name"
-        });
-    });
-    it("should parse URL with pathStyle=false parameter", function () {
-        var result = parseS3Url({
-            url: "https://s3.amazonaws.com/bucket-name?pathStyle=false"
-        });
-        expect(result).toEqual({
-            accessKeyId: undefined,
-            secretAccessKey: undefined,
-            endpoint: "s3.amazonaws.com",
-            port: 443,
-            useSsl: true,
-            region: undefined,
-            pathStyle: false,
-            bucket: "bucket-name"
-        });
-    });
-    it("should detect path style for IP addresses", function () {
-        var result = parseS3Url({
-            url: "https://192.168.1.1/bucket-name"
-        });
-        expect(result).toEqual({
-            accessKeyId: undefined,
-            secretAccessKey: undefined,
-            endpoint: "192.168.1.1",
-            port: 443,
-            useSsl: true,
-            region: undefined,
-            pathStyle: true,
-            bucket: "bucket-name"
-        });
-    });
-    it("should detect path style for IPv6 addresses", function () {
-        var result = parseS3Url({
-            url: "https://[2001:db8::1]/bucket-name"
-        });
-        expect(result).toEqual({
-            accessKeyId: undefined,
-            secretAccessKey: undefined,
-            endpoint: "[2001:db8::1]",
-            port: 443,
-            useSsl: true,
-            region: undefined,
-            pathStyle: true,
-            bucket: "bucket-name"
-        });
-    });
-    it("should parse AWS virtual hosted style URL", function () {
-        var result = parseS3Url({
-            url: "https://my-bucket.s3.us-east-1.amazonaws.com"
-        });
-        expect(result).toEqual({
-            accessKeyId: undefined,
-            secretAccessKey: undefined,
-            endpoint: "my-bucket.s3.us-east-1.amazonaws.com",
-            port: 443,
-            useSsl: true,
-            region: "us-east-1",
-            pathStyle: false,
-            bucket: "my-bucket"
-        });
-    });
-    it("should parse AWS virtual hosted style URL with custom endpoint", function () {
-        var result = parseS3Url({
-            url: "https://my-bucket.s3.amazonaws.com"
-        });
-        expect(result).toEqual({
-            accessKeyId: undefined,
-            secretAccessKey: undefined,
-            endpoint: "my-bucket.s3.amazonaws.com",
-            port: 443,
-            useSsl: true,
-            region: undefined,
-            pathStyle: false,
-            bucket: "my-bucket"
-        });
-    });
-    it("should override parameters with provided options", function () {
-        var result = parseS3Url({
-            url: "https://s3.amazonaws.com/bucket-name",
-            region: "us-west-2",
-            pathStyle: false
-        });
-        expect(result).toEqual({
-            accessKeyId: undefined,
-            secretAccessKey: undefined,
-            endpoint: "s3.amazonaws.com",
-            port: 443,
-            useSsl: true,
-            region: "us-west-2",
-            pathStyle: false,
-            bucket: "bucket-name"
-        });
-    });
-    it("should use S3_URL environment variable by default", function () {
-        vi.stubEnv("S3_URL", "https://env-bucket.s3.amazonaws.com");
-        var result = parseS3Url();
-        expect(result).toEqual({
-            accessKeyId: undefined,
-            secretAccessKey: undefined,
-            endpoint: "env-bucket.s3.amazonaws.com",
-            port: 443,
-            useSsl: true,
-            region: undefined,
-            pathStyle: false,
-            bucket: "env-bucket"
-        });
-    });
-    it("should throw error for invalid URL", function () {
-        expect(function () {
-            return parseS3Url({
-                url: "invalid-url"
-            });
-        }).toThrow("Invalid S3 URL: invalid-url");
-    });
-    it("should handle complex URL with multiple parameters", function () {
-        var result = parseS3Url({
-            url: "https://user:pass@custom-s3.com:9000/my-bucket?region=us-east-1&pathStyle=true"
-        });
-        expect(result).toEqual({
-            accessKeyId: "user",
-            secretAccessKey: "pass",
-            endpoint: "custom-s3.com",
-            port: 9000,
-            useSsl: true,
-            region: "us-east-1",
-            pathStyle: true,
-            bucket: "my-bucket"
-        });
-    });
-    it("should ignore undefined and null values in rest parameters", function () {
-        var result = parseS3Url({
-            url: "https://s3.amazonaws.com/bucket-name",
-            region: "us-west-2",
-            port: undefined,
-            useSsl: null
-        });
-        expect(result).toEqual({
-            accessKeyId: undefined,
-            secretAccessKey: undefined,
-            endpoint: "s3.amazonaws.com",
-            port: 443,
-            useSsl: true,
-            region: "us-west-2",
-            pathStyle: true,
-            bucket: "bucket-name"
-        });
-    });
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { parseS3Url } from './parseS3Url.js';
+
+describe('parseS3Url', () => {
+	beforeEach(() => {
+		vi.restoreAllMocks();
+	});
+	it('should return undefined for empty URL', () => {
+		var result = parseS3Url({
+			url: '',
+		});
+		expect(result).toBeUndefined();
+	});
+	it('should return undefined for undefined URL', () => {
+		var result = parseS3Url({
+			url: undefined,
+		});
+		expect(result).toBeUndefined();
+	});
+	it('should parse basic HTTPS URL', () => {
+		var result = parseS3Url({
+			url: 'https://s3.amazonaws.com/bucket-name',
+		});
+		expect(result).toEqual({
+			accessKeyId: undefined,
+			secretAccessKey: undefined,
+			endpoint: 's3.amazonaws.com',
+			port: 443,
+			useSsl: true,
+			region: undefined,
+			pathStyle: true,
+			bucket: 'bucket-name',
+		});
+	});
+	it('should parse basic HTTP URL', () => {
+		var result = parseS3Url({
+			url: 'http://s3.amazonaws.com/bucket-name',
+		});
+		expect(result).toEqual({
+			accessKeyId: undefined,
+			secretAccessKey: undefined,
+			endpoint: 's3.amazonaws.com',
+			port: 80,
+			useSsl: false,
+			region: undefined,
+			pathStyle: true,
+			bucket: 'bucket-name',
+		});
+	});
+	it('should parse S3 protocol URL', () => {
+		var result = parseS3Url({
+			url: 's3://s3.amazonaws.com/bucket-name',
+		});
+		expect(result).toEqual({
+			accessKeyId: undefined,
+			secretAccessKey: undefined,
+			endpoint: 's3.amazonaws.com',
+			port: 443,
+			useSsl: true,
+			region: undefined,
+			pathStyle: true,
+			bucket: 'bucket-name',
+		});
+	});
+	it('should parse URL with credentials', () => {
+		var result = parseS3Url({
+			url: 'https://user:pass@s3.amazonaws.com/bucket-name',
+		});
+		expect(result).toEqual({
+			accessKeyId: 'user',
+			secretAccessKey: 'pass',
+			endpoint: 's3.amazonaws.com',
+			port: 443,
+			useSsl: true,
+			region: undefined,
+			pathStyle: true,
+			bucket: 'bucket-name',
+		});
+	});
+	it('should parse URL with port', () => {
+		var result = parseS3Url({
+			url: 'https://s3.amazonaws.com:9000/bucket-name',
+		});
+		expect(result).toEqual({
+			accessKeyId: undefined,
+			secretAccessKey: undefined,
+			endpoint: 's3.amazonaws.com',
+			port: 9000,
+			useSsl: true,
+			region: undefined,
+			pathStyle: true,
+			bucket: 'bucket-name',
+		});
+	});
+	it('should parse URL with region query parameter', () => {
+		var result = parseS3Url({
+			url: 'https://s3.amazonaws.com/bucket-name?region=us-east-1',
+		});
+		expect(result).toEqual({
+			accessKeyId: undefined,
+			secretAccessKey: undefined,
+			endpoint: 's3.amazonaws.com',
+			port: 443,
+			useSsl: true,
+			region: 'us-east-1',
+			pathStyle: true,
+			bucket: 'bucket-name',
+		});
+	});
+	it('should parse URL with pathStyle parameter', () => {
+		var result = parseS3Url({
+			url: 'https://s3.amazonaws.com/bucket-name?pathStyle=true',
+		});
+		expect(result).toEqual({
+			accessKeyId: undefined,
+			secretAccessKey: undefined,
+			endpoint: 's3.amazonaws.com',
+			port: 443,
+			useSsl: true,
+			region: undefined,
+			pathStyle: true,
+			bucket: 'bucket-name',
+		});
+	});
+	it('should parse URL with pathStyle=false parameter', () => {
+		var result = parseS3Url({
+			url: 'https://s3.amazonaws.com/bucket-name?pathStyle=false',
+		});
+		expect(result).toEqual({
+			accessKeyId: undefined,
+			secretAccessKey: undefined,
+			endpoint: 's3.amazonaws.com',
+			port: 443,
+			useSsl: true,
+			region: undefined,
+			pathStyle: false,
+			bucket: 'bucket-name',
+		});
+	});
+	it('should detect path style for IP addresses', () => {
+		var result = parseS3Url({
+			url: 'https://192.168.1.1/bucket-name',
+		});
+		expect(result).toEqual({
+			accessKeyId: undefined,
+			secretAccessKey: undefined,
+			endpoint: '192.168.1.1',
+			port: 443,
+			useSsl: true,
+			region: undefined,
+			pathStyle: true,
+			bucket: 'bucket-name',
+		});
+	});
+	it('should detect path style for IPv6 addresses', () => {
+		var result = parseS3Url({
+			url: 'https://[2001:db8::1]/bucket-name',
+		});
+		expect(result).toEqual({
+			accessKeyId: undefined,
+			secretAccessKey: undefined,
+			endpoint: '[2001:db8::1]',
+			port: 443,
+			useSsl: true,
+			region: undefined,
+			pathStyle: true,
+			bucket: 'bucket-name',
+		});
+	});
+	it('should parse AWS virtual hosted style URL', () => {
+		var result = parseS3Url({
+			url: 'https://my-bucket.s3.us-east-1.amazonaws.com',
+		});
+		expect(result).toEqual({
+			accessKeyId: undefined,
+			secretAccessKey: undefined,
+			endpoint: 'my-bucket.s3.us-east-1.amazonaws.com',
+			port: 443,
+			useSsl: true,
+			region: 'us-east-1',
+			pathStyle: false,
+			bucket: 'my-bucket',
+		});
+	});
+	it('should parse AWS virtual hosted style URL with custom endpoint', () => {
+		var result = parseS3Url({
+			url: 'https://my-bucket.s3.amazonaws.com',
+		});
+		expect(result).toEqual({
+			accessKeyId: undefined,
+			secretAccessKey: undefined,
+			endpoint: 'my-bucket.s3.amazonaws.com',
+			port: 443,
+			useSsl: true,
+			region: undefined,
+			pathStyle: false,
+			bucket: 'my-bucket',
+		});
+	});
+	it('should override parameters with provided options', () => {
+		var result = parseS3Url({
+			url: 'https://s3.amazonaws.com/bucket-name',
+			region: 'us-west-2',
+			pathStyle: false,
+		});
+		expect(result).toEqual({
+			accessKeyId: undefined,
+			secretAccessKey: undefined,
+			endpoint: 's3.amazonaws.com',
+			port: 443,
+			useSsl: true,
+			region: 'us-west-2',
+			pathStyle: false,
+			bucket: 'bucket-name',
+		});
+	});
+	it('should use S3_URL environment variable by default', () => {
+		vi.stubEnv('S3_URL', 'https://env-bucket.s3.amazonaws.com');
+		var result = parseS3Url();
+		expect(result).toEqual({
+			accessKeyId: undefined,
+			secretAccessKey: undefined,
+			endpoint: 'env-bucket.s3.amazonaws.com',
+			port: 443,
+			useSsl: true,
+			region: undefined,
+			pathStyle: false,
+			bucket: 'env-bucket',
+		});
+	});
+	it('should throw error for invalid URL', () => {
+		expect(() =>
+			parseS3Url({
+				url: 'invalid-url',
+			}),
+		).toThrow('Invalid S3 URL: invalid-url');
+	});
+	it('should handle complex URL with multiple parameters', () => {
+		var result = parseS3Url({
+			url: 'https://user:pass@custom-s3.com:9000/my-bucket?region=us-east-1&pathStyle=true',
+		});
+		expect(result).toEqual({
+			accessKeyId: 'user',
+			secretAccessKey: 'pass',
+			endpoint: 'custom-s3.com',
+			port: 9000,
+			useSsl: true,
+			region: 'us-east-1',
+			pathStyle: true,
+			bucket: 'my-bucket',
+		});
+	});
+	it('should ignore undefined and null values in rest parameters', () => {
+		var result = parseS3Url({
+			url: 'https://s3.amazonaws.com/bucket-name',
+			region: 'us-west-2',
+			port: undefined,
+			useSsl: null,
+		});
+		expect(result).toEqual({
+			accessKeyId: undefined,
+			secretAccessKey: undefined,
+			endpoint: 's3.amazonaws.com',
+			port: 443,
+			useSsl: true,
+			region: 'us-west-2',
+			pathStyle: true,
+			bucket: 'bucket-name',
+		});
+	});
 });