qualty 0.1.15 → 0.1.16

package/bin/local-runner.js

@@ -9,6 +9,36 @@ function safePathSegment(value, fallback) {
   return normalized || fallback;
 }
 
+/**
+ * Rewrite a dashboard/production test URL to localhost for local CLI runs.
+ * Keeps pathname, search, and hash; swaps origin to http://localhost:<port>.
+ */
+export function rewriteUrlForLocalRun(rawUrl, port) {
+  const portNum = Number(port);
+  if (!Number.isFinite(portNum) || portNum < 1 || portNum > 65535) {
+    return String(rawUrl || "").trim();
+  }
+  const trimmed = String(rawUrl || "").trim();
+  if (!trimmed) return trimmed;
+
+  let parsed;
+  try {
+    const withProtocol = /^https?:\/\//i.test(trimmed) ? trimmed : `https://${trimmed}`;
+    parsed = new URL(withProtocol);
+  } catch {
+    return trimmed;
+  }
+
+  const suffix = `${parsed.pathname}${parsed.search}${parsed.hash}`;
+  return `http://localhost:${portNum}${suffix}`;
+}
+
+function resolveLocalPort(rawPort, fallback = 3000) {
+  const portNum = Number(rawPort);
+  if (Number.isFinite(portNum) && portNum >= 1 && portNum <= 65535) return portNum;
+  return fallback;
+}
+
 function localAuthStatePath({ orgId, projectId, profile }) {
   const orgSeg = safePathSegment(orgId || "default-org", "default-org");
   const projectSeg = safePathSegment(projectId || "default-project", "default-project");
@@ -177,6 +207,7 @@ async function preflightMissingLocalBindings({
   savedJobs,
   explicitAuthProfile,
   noAuthState,
+  localPort = 3000,
 }) {
   if (noAuthState) return;
   if (explicitAuthProfile) return;
@@ -195,14 +226,16 @@ async function preflightMissingLocalBindings({
     const entry = missingByProfile.get(profileName) || {
       localProfileName: profileName,
       projectId: String(job?.project_id || projectId || "").trim(),
-      startUrl: String(job?.url || "").trim(),
+      startUrl: rewriteUrlForLocalRun(String(job?.url || "").trim(), localPort),
       tests: [],
     };
     entry.tests.push({
       id: String(job?.id || "").trim(),
       name: String(job?.name || job?.id || "Unnamed test").trim(),
     });
-    if (!entry.startUrl) entry.startUrl = String(job?.url || "").trim();
+    if (!entry.startUrl) {
+      entry.startUrl = rewriteUrlForLocalRun(String(job?.url || "").trim(), localPort);
+    }
     missingByProfile.set(profileName, entry);
   }
   if (missingByProfile.size === 0) return;
@@ -1016,7 +1049,14 @@ export async function runLocalExecution({
     body: { device },
   });
 
-  const url = claim.url;
+  const originalUrl = String(claim.url || "").trim();
+  const localPort = resolveLocalPort(claim.local_port);
+  const url = rewriteUrlForLocalRun(originalUrl, localPort);
+  if (url !== originalUrl) {
+    // eslint-disable-next-line no-console
+    console.log(`[qualty] Local URL rewrite: ${originalUrl} -> ${url}`);
+  }
+  claim.url = url;
   const viewport = claim.viewport || { width: 1440, height: 900 };
   const steps = Array.isArray(claim.steps) ? claim.steps : [];
   const totalSteps = claim.total_steps || steps.length;
@@ -1279,6 +1319,21 @@ export async function runLocalExecution({
   return { success: runSuccess, stepsJson, error: runError };
 }
 
+async function fetchProjectLocalPort({ apiRequest, apiUrl, token, orgId, projectId }) {
+  if (!projectId) return 3000;
+  try {
+    const project = await apiRequest({
+      apiUrl,
+      token,
+      orgId,
+      path: `/api/v1/projects/${encodeURIComponent(String(projectId))}`,
+    });
+    return resolveLocalPort(project?.localhost?.port);
+  } catch {
+    return 3000;
+  }
+}
+
 export async function runLocalCi({
   apiUrl,
   token,
@@ -1301,6 +1356,8 @@ export async function runLocalCi({
     throw new Error("No saved tests matched your selector.");
   }
 
+  const localPort = await fetchProjectLocalPort({ apiRequest, apiUrl, token, orgId, projectId });
+
   const startResp = await apiRequest({
     apiUrl,
     token,
@@ -1328,6 +1385,7 @@ export async function runLocalCi({
     savedJobs,
     explicitAuthProfile: String(authProfile || "").trim(),
     noAuthState: Boolean(noAuthState),
+    localPort,
   });
 
   const concurrency = Math.max(1, Number(localConcurrency) || 4);

package/bin/qualty.js

@@ -6,11 +6,12 @@ import { homedir, hostname } from "node:os";
 import { join } from "node:path";
 import { createInterface } from "node:readline/promises";
 import process from "node:process";
-import { runLocalCi } from "./local-runner.js";
+import { rewriteUrlForLocalRun, runLocalCi } from "./local-runner.js";
 
 /** CLI backend URL is fixed by Qualty distribution. */
 const DEFAULT_QUALTY_API_URL = "https://qualty-api-production.up.railway.app";
 
+
 const QUALTY_CONFIG_DIR = join(homedir(), ".config", "qualty");
 const QUALTY_CONFIG_PATH = join(QUALTY_CONFIG_DIR, "config.json");
 const QUALTY_SHARED_CREDS_DIR = join(homedir(), ".qualty");
@@ -1426,6 +1427,7 @@ async function runAuthSetup(args) {
       id: String(p?.id || "").trim(),
       name: String(p?.name || "").trim() || "Unnamed project",
       url: String(p?.url || "").trim(),
+      localPort: Number(p?.localhost?.port) || 3000,
     }))
     .filter((p) => p.id);
   if (projects.length === 0) {
@@ -1537,7 +1539,15 @@ async function runAuthSetup(args) {
     }
     const context = await browser.newContext();
     const page = await context.newPage();
-    const startUrl = project.url || "about:blank";
+    const rawStartUrl = project.url || "about:blank";
+    const startUrl =
+      rawStartUrl === "about:blank"
+        ? rawStartUrl
+        : rewriteUrlForLocalRun(rawStartUrl, project.localPort);
+    if (startUrl !== rawStartUrl) {
+      // eslint-disable-next-line no-console
+      console.log(`[qualty][auth] Local URL rewrite: ${rawStartUrl} -> ${startUrl}`);
+    }
     await page.goto(startUrl, { waitUntil: "domcontentloaded", timeout: 60000 }).catch(() => {});
     // eslint-disable-next-line no-console
     console.log(`[qualty][auth] Browser opened for project "${project.name}".`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qualty",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "description": "Qualty CLI for localhost and CI test runs",
   "bin": {
     "qualty": "bin/qualty.js"