tinybeeai 0.0.0-stage → 0.16.1

package/dist/target-url.js

@@ -0,0 +1,116 @@
+// The web addresses a deployment gives (environment_url): which of them may become the page tests run against. An address comes from
+// GitHub, and anyone who can write a deployment status in the environment chooses it, so every use of one goes through here.
+/** The longest target address kept. A longer one is not a page address a person set up, and it would fill a step. */
+export const MAX_TARGET_URL = 300;
+/**
+ * The target of the tests from the URL of a deployment or a preview: a web address (https, or http for a machine of your own), else
+ * none. The address is cut to its origin and path: a query string (a share token), a fragment and a sign-in in the address never reach
+ * the tests or the run steps. An address over 300 characters is none.
+ */
+export function targetUrlOf(url) {
+    if (!url)
+        return undefined;
+    try {
+        const u = new URL(url.trim());
+        const local = u.hostname === 'localhost' || u.hostname === '127.0.0.1' || u.hostname === '[::1]' || u.hostname.endsWith('.localhost');
+        if (u.protocol !== 'https:' && !(u.protocol === 'http:' && local))
+            return undefined;
+        const clean = `${u.origin}${u.pathname}`.replace(/\/+$/, '');
+        return clean.length <= MAX_TARGET_URL ? clean : undefined;
+    }
+    catch {
+        /* not a web address */
+    }
+    return undefined;
+}
+/** The host of a web address, lower case, or null when it is not one. */
+export function hostOf(url) {
+    if (!url)
+        return null;
+    try {
+        return new URL(url).hostname.toLowerCase();
+    }
+    catch {
+        return null;
+    }
+}
+/** The origin of a web address, lower case, or null when it is not one. */
+export function originOf(url) {
+    if (!url)
+        return null;
+    try {
+        return new URL(url.trim()).origin.toLowerCase();
+    }
+    catch {
+        return null;
+    }
+}
+const trimPath = (p) => p.replace(/\/+$/, '');
+/**
+ * The address of a deployment as a base for UI tests, or undefined: the same cleaning as targetUrlOf, and only the root of a site
+ * (or the path the Base URL itself has). An address such as https://api.qa.example.com/health is a probe of a service, never the page
+ * the tests open, so it is left out whatever host it is on.
+ */
+export function uiBaseOf(url, baseUrl) {
+    const clean = targetUrlOf(url);
+    if (!clean)
+        return undefined;
+    const path = trimPath(new URL(clean).pathname);
+    let basePath;
+    try {
+        if (baseUrl)
+            basePath = trimPath(new URL(baseUrl.trim()).pathname);
+    }
+    catch {
+        /* no usable Base URL */
+    }
+    if (!path) {
+        // The root of the site the deployment names. A Base URL with a path (https://qa.example.com/app) says where the app lives on that
+        // site, so the target keeps the path and the tests do not open the bare origin (KAT-403).
+        const withPath = basePath ? `${new URL(clean).origin}${basePath}` : clean;
+        return withPath.length <= MAX_TARGET_URL ? withPath : undefined;
+    }
+    return basePath && path === basePath ? clean : undefined;
+}
+/** The longest text deployUrlMatch takes. */
+export const MAX_DEPLOY_URL_MATCH = 200;
+/**
+ * Reads a deployUrlMatch: a host (`web.qa.example.com`) or an origin (`https://web.qa.example.com`), nothing else. Returns the host or
+ * the origin in lower case, or null when the text is neither (a path, a query, a sign-in, a wildcard, or no web address at all).
+ */
+export function cleanDeployUrlMatch(v) {
+    if (typeof v !== 'string')
+        return null;
+    const text = v.trim().toLowerCase();
+    if (!text || text.length > MAX_DEPLOY_URL_MATCH || /[\s\u0000-\u001f\u007f*]/.test(text))
+        return null;
+    try {
+        if (/^https?:\/\//.test(text)) {
+            const u = new URL(text);
+            if (u.username || u.password || u.search || u.hash || trimPath(u.pathname))
+                return null;
+            return u.origin;
+        }
+        if (!/^[a-z0-9]([a-z0-9.-]*[a-z0-9])?(:\d{1,5})?$/.test(text))
+            return null;
+        const u = new URL(`https://${text}`);
+        return u.host;
+    }
+    catch {
+        return null;
+    }
+}
+/** True when `url` is on the host or the origin that a deployUrlMatch names. */
+export function matchesDeployUrl(match, url) {
+    const m = cleanDeployUrlMatch(match);
+    if (!m)
+        return false;
+    try {
+        const u = new URL(url.trim());
+        return m.includes('://') ? u.origin.toLowerCase() === m : u.host.toLowerCase() === m;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=target-url.js.map

package/dist/target-url.js.map

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