@aws-sdk/util-endpoints 3.171.0 → 3.174.0

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.174.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.173.0...v3.174.0) (2022-09-19)
+
+
+### Features
+
+* **util-endpoints:** add aws.isVirtualHostableS3Bucket ([#3967](https://github.com/aws/aws-sdk-js-v3/issues/3967)) ([2fbe419](https://github.com/aws/aws-sdk-js-v3/commit/2fbe4199b971b0da966369c36a28521ba389a466))
+
+
+
+
+
 # [3.171.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.170.0...v3.171.0) (2022-09-14)
 
 

package/dist-cjs/lib/aws/index.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./isVirtualHostableS3Bucket"), exports);
 tslib_1.__exportStar(require("./parseArn"), exports);
 tslib_1.__exportStar(require("./partition"), exports);

package/dist-cjs/lib/aws/isVirtualHostableS3Bucket.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isVirtualHostableS3Bucket = void 0;
+const isIpAddress_1 = require("../isIpAddress");
+const isValidHostLabel_1 = require("../isValidHostLabel");
+const isVirtualHostableS3Bucket = (value, allowSubDomains = false) => {
+    if (allowSubDomains) {
+        for (const label of value.split(".")) {
+            if (!(0, exports.isVirtualHostableS3Bucket)(label)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    if (!(0, isValidHostLabel_1.isValidHostLabel)(value)) {
+        return false;
+    }
+    if (value.length < 3 || value.length > 63) {
+        return false;
+    }
+    if (value !== value.toLowerCase()) {
+        return false;
+    }
+    if ((0, isIpAddress_1.isIpAddress)(value)) {
+        return false;
+    }
+    return true;
+};
+exports.isVirtualHostableS3Bucket = isVirtualHostableS3Bucket;

package/dist-cjs/lib/isIpAddress.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isIpAddress = void 0;
+const IP_V4_REGEX = new RegExp(`^(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]\\d|\\d)(?:\\.(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]\\d|\\d)){3}$`);
+const isIpAddress = (value) => IP_V4_REGEX.test(value) || (value.startsWith("[") && value.endsWith("]"));
+exports.isIpAddress = isIpAddress;

package/dist-cjs/lib/parseURL.js

@@ -2,11 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseURL = void 0;
 const types_1 = require("@aws-sdk/types");
+const isIpAddress_1 = require("./isIpAddress");
 const DEFAULT_PORTS = {
     [types_1.EndpointURLScheme.HTTP]: 80,
     [types_1.EndpointURLScheme.HTTPS]: 443,
 };
-const IP_V4_REGEX = new RegExp(`^(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]\\d|\\d)(?:\\.(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]\\d|\\d)){3}$`);
 const parseURL = (value) => {
     const whatwgURL = (() => {
         try {
@@ -27,7 +27,7 @@ const parseURL = (value) => {
     if (!Object.values(types_1.EndpointURLScheme).includes(scheme)) {
         return null;
     }
-    const isIp = IP_V4_REGEX.test(hostname) || (hostname.startsWith("[") && hostname.endsWith("]"));
+    const isIp = (0, isIpAddress_1.isIpAddress)(hostname);
     const authority = `${host}${value.includes(`${host}:${DEFAULT_PORTS[scheme]}`) ? `:${DEFAULT_PORTS[scheme]}` : ``}`;
     return {
         scheme,

package/dist-es/lib/aws/index.js

@@ -1,2 +1,3 @@
+export * from "./isVirtualHostableS3Bucket";
 export * from "./parseArn";
 export * from "./partition";

package/dist-es/lib/aws/isVirtualHostableS3Bucket.js

@@ -0,0 +1,38 @@
+import { __values } from "tslib";
+import { isIpAddress } from "../isIpAddress";
+import { isValidHostLabel } from "../isValidHostLabel";
+export var isVirtualHostableS3Bucket = function (value, allowSubDomains) {
+    var e_1, _a;
+    if (allowSubDomains === void 0) { allowSubDomains = false; }
+    if (allowSubDomains) {
+        try {
+            for (var _b = __values(value.split(".")), _c = _b.next(); !_c.done; _c = _b.next()) {
+                var label = _c.value;
+                if (!isVirtualHostableS3Bucket(label)) {
+                    return false;
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        return true;
+    }
+    if (!isValidHostLabel(value)) {
+        return false;
+    }
+    if (value.length < 3 || value.length > 63) {
+        return false;
+    }
+    if (value !== value.toLowerCase()) {
+        return false;
+    }
+    if (isIpAddress(value)) {
+        return false;
+    }
+    return true;
+};

package/dist-es/lib/isIpAddress.js

@@ -0,0 +1,4 @@
+var IP_V4_REGEX = new RegExp("^(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]\\d|\\d)(?:\\.(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]\\d|\\d)){3}$");
+export var isIpAddress = function (value) {
+    return IP_V4_REGEX.test(value) || (value.startsWith("[") && value.endsWith("]"));
+};

package/dist-es/lib/parseURL.js

@@ -1,10 +1,10 @@
 var _a;
 import { EndpointURLScheme } from "@aws-sdk/types";
+import { isIpAddress } from "./isIpAddress";
 var DEFAULT_PORTS = (_a = {},
     _a[EndpointURLScheme.HTTP] = 80,
     _a[EndpointURLScheme.HTTPS] = 443,
     _a);
-var IP_V4_REGEX = new RegExp("^(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]\\d|\\d)(?:\\.(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]\\d|\\d)){3}$");
 export var parseURL = function (value) {
     var whatwgURL = (function () {
         try {
@@ -25,7 +25,7 @@ export var parseURL = function (value) {
     if (!Object.values(EndpointURLScheme).includes(scheme)) {
         return null;
     }
-    var isIp = IP_V4_REGEX.test(hostname) || (hostname.startsWith("[") && hostname.endsWith("]"));
+    var isIp = isIpAddress(hostname);
     var authority = "".concat(host).concat(value.includes("".concat(host, ":").concat(DEFAULT_PORTS[scheme])) ? ":".concat(DEFAULT_PORTS[scheme]) : "");
     return {
         scheme: scheme,

package/dist-types/lib/aws/index.d.ts

@@ -1,2 +1,3 @@
+export * from "./isVirtualHostableS3Bucket";
 export * from "./parseArn";
 export * from "./partition";

package/dist-types/lib/aws/isVirtualHostableS3Bucket.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Evaluates whether a string is a DNS compatible bucket name and can be used with
+ * virtual hosted style addressing.
+ */
+export declare const isVirtualHostableS3Bucket: (value: string, allowSubDomains?: boolean) => boolean;

package/dist-types/lib/isIpAddress.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Validates if the provided value is an IP address.
+ */
+export declare const isIpAddress: (value: string) => boolean;

package/dist-types/ts3.4/lib/aws/index.d.ts

@@ -1,2 +1,3 @@
+export * from "./isVirtualHostableS3Bucket";
 export * from "./parseArn";
 export * from "./partition";

package/dist-types/ts3.4/lib/aws/isVirtualHostableS3Bucket.d.ts

@@ -0,0 +1,4 @@
+export declare const isVirtualHostableS3Bucket: (
+  value: string,
+  allowSubDomains?: boolean
+) => boolean;

package/dist-types/ts3.4/lib/isIpAddress.d.ts

@@ -0,0 +1 @@
+export declare const isIpAddress: (value: string) => boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aws-sdk/util-endpoints",
-  "version": "3.171.0",
+  "version": "3.174.0",
   "description": "Utilities to help with endpoint resolution",
   "main": "./dist-cjs/index.js",
   "module": "./dist-es/index.js",