@miosa/cli 1.0.86 → 1.0.88

package/dist/commands/sandbox.js

@@ -104,8 +104,9 @@ export function register(program) {
             console.log(JSON.stringify(data, null, 2));
             return;
         }
-        const raw = unwrap(await client().apiGet(apiPath(`/sandboxes/${enc(id)}`)));
-        const sb = (raw ?? {});
+        const sb = opts.port != null
+            ? await showSandboxWithPreview(id, opts.port, opts.probePath)
+            : (unwrap(await client().apiGet(apiPath(`/sandboxes/${enc(id)}`))) ?? {});
         printBanner({ subtitle: "Sandbox" });
         const rows = [
             { label: "ID", value: chalk.bold(str(sb["id"])), icon: icon.info },
@@ -142,6 +143,23 @@ export function register(program) {
                 value: chalk.cyan(str(sb["public_url"])),
             });
         }
+        const preview = asRecord(sb["preview"]);
+        if (preview?.["url"]) {
+            rows.push({
+                label: "Preview URL",
+                value: chalk.cyan(str(preview["url"])),
+            });
+            rows.push({
+                label: "URL class",
+                value: str(preview["url_class"] ?? "temporary_preview"),
+            });
+            rows.push({
+                label: "Embeddable",
+                value: preview["stable_for_embedding"] === true
+                    ? chalk.green("yes")
+                    : chalk.yellow("temporary"),
+            });
+        }
         if (sb["created_at"]) {
             rows.push({
                 label: "Created",
@@ -733,6 +751,7 @@ export function register(program) {
             return;
         }
         console.log(result.url);
+        printPreviewContractHint(result);
         if (!result.ready) {
             console.error(chalk.yellow(`Preview route created but not verified yet (${result.error ?? result.status ?? "pending"}).`));
         }
@@ -1810,6 +1829,9 @@ async function showSandboxWithPreview(sandboxId, port, probePath) {
     catch (err) {
         preview = {
             url: "",
+            url_class: "temporary_preview",
+            stable_for_embedding: false,
+            recommended_next_action: "create_alias_or_publish",
             ready: false,
             status: null,
             latency_ms: null,
@@ -1822,6 +1844,10 @@ async function showSandboxWithPreview(sandboxId, port, probePath) {
         preview: {
             url: preview?.url || null,
             port,
+            url_info: preview?.url_info ?? null,
+            url_class: preview?.url_class ?? "temporary_preview",
+            stable_for_embedding: preview?.stable_for_embedding ?? false,
+            recommended_next_action: preview?.recommended_next_action ?? "create_alias_or_publish",
             route_ready: Boolean(preview?.url),
             tls_ready: preview?.ready ?? false,
             last_status: preview?.status ?? null,
@@ -1844,12 +1870,28 @@ async function previewSandbox(sandboxId, port, opts) {
         : await probePublicPreview(url, opts.probePath);
     return {
         url,
+        url_class: stringField(exposed, "url_class") ??
+            stringField(exposed, "class") ??
+            "temporary_preview",
+        stable_for_embedding: booleanField(exposed, "stable_for_embedding") ?? false,
+        recommended_next_action: stringField(exposed, "recommended_next_action") ??
+            "create_alias_or_publish",
+        url_info: objectField(exposed, "url_info") ?? undefined,
         ready: edge.ok,
         status: edge.status,
         latency_ms: edge.latency_ms ?? null,
         error: edge.error,
     };
 }
+function printPreviewContractHint(result) {
+    const urlClass = result.url_class ?? "temporary_preview";
+    if (result.stable_for_embedding === true) {
+        console.error(chalk.dim(`URL class: ${urlClass}, stable for embedding.`));
+        return;
+    }
+    console.error(chalk.yellow(`URL class: ${urlClass}, temporary preview.`));
+    console.error(chalk.dim(`For durable client use, next action: ${result.recommended_next_action ?? "create_alias_or_publish"}.`));
+}
 async function waitSandboxReady(sandboxId, port, probePath, timeoutSec) {
     const c = client();
     await waitForSandboxRunning(c, sandboxId, Math.min(timeoutSec, 120));
@@ -2006,10 +2048,18 @@ async function deploySandbox(localDir, opts) {
         const internal = await waitForInternalHttp(c, sandboxId, resolvedPort, resolvedProbePath, Math.min(opts.timeout, 60));
         deployStep(opts, "Creating public preview route");
         const exposed = await c.apiPost(apiPath(`/sandboxes/${enc(sandboxId)}/expose`), { port: resolvedPort, title: "app preview" });
-        const previewUrl = extractUrl(unwrap(exposed));
+        const exposeData = unwrap(exposed);
+        const previewUrl = extractUrl(exposeData);
         if (!previewUrl) {
             throw new UserError("Sandbox expose did not return a preview URL.");
         }
+        const previewUrlInfo = objectField(exposeData, "url_info") ?? undefined;
+        const previewUrlClass = stringField(exposeData, "url_class") ??
+            stringField(exposeData, "class") ??
+            "temporary_preview";
+        const stableForEmbedding = booleanField(exposeData, "stable_for_embedding") ?? false;
+        const recommendedNextAction = stringField(exposeData, "recommended_next_action") ??
+            "create_alias_or_publish";
         if (opts.wait)
             deployStep(opts, "Checking public preview readiness");
         const edge = opts.wait
@@ -2037,6 +2087,10 @@ async function deploySandbox(localDir, opts) {
             sandbox_id: sandboxId,
             port: resolvedPort,
             preview_url: previewUrl,
+            preview_url_info: previewUrlInfo,
+            preview_url_class: previewUrlClass,
+            stable_for_embedding: stableForEmbedding,
+            recommended_next_action: recommendedNextAction,
             preview_ready: edge.ok,
             persistent: true,
             always_on: Boolean(opts.alwaysOn),
@@ -2149,6 +2203,25 @@ async function publishSandbox(sandboxId, opts) {
         extractUrl(deployment) ??
         stringField(data, "url") ??
         null;
+    let urlInfo = objectField(response, "url_info") ??
+        objectField(deployment, "url_info") ??
+        objectField(data, "url_info") ??
+        null;
+    let urlClass = stringField(response, "url_class") ??
+        stringField(response, "class") ??
+        stringField(deployment, "url_class") ??
+        stringField(deployment, "class") ??
+        stringField(data, "url_class") ??
+        stringField(data, "class") ??
+        "durable_deployment";
+    let stableForEmbedding = booleanField(response, "stable_for_embedding") ??
+        booleanField(deployment, "stable_for_embedding") ??
+        booleanField(data, "stable_for_embedding") ??
+        true;
+    let recommendedNextAction = stringField(response, "recommended_next_action") ??
+        stringField(deployment, "recommended_next_action") ??
+        stringField(data, "recommended_next_action") ??
+        "attach_custom_domain";
     let deploymentProduct = stringField(response, "deployment_product") ??
         stringField(data, "deployment_product") ??
         stringField(deployment, "deployment_product") ??
@@ -2164,6 +2237,15 @@ async function publishSandbox(sandboxId, opts) {
         const waited = await waitForDeploymentReady(c, deploymentId, opts.timeout);
         state = stringField(waited, "state") ?? state;
         url = extractUrl(waited) ?? url;
+        urlInfo = objectField(waited, "url_info") ?? urlInfo;
+        urlClass =
+            stringField(waited, "url_class") ??
+                stringField(waited, "class") ??
+                urlClass;
+        stableForEmbedding =
+            booleanField(waited, "stable_for_embedding") ?? stableForEmbedding;
+        recommendedNextAction =
+            stringField(waited, "recommended_next_action") ?? recommendedNextAction;
         deploymentProduct =
             stringField(waited, "deployment_product") ??
                 stringField(asRecord(waited["metadata"]), "deployment_product") ??
@@ -2175,6 +2257,11 @@ async function publishSandbox(sandboxId, opts) {
         response["state"] = state;
         if (url)
             response["url"] = url;
+        if (urlInfo)
+            response["url_info"] = urlInfo;
+        response["url_class"] = urlClass;
+        response["stable_for_embedding"] = stableForEmbedding;
+        response["recommended_next_action"] = recommendedNextAction;
         data["deployment"] = waited;
         data["promotion_pending"] = false;
         data["app_consistency_pending"] = false;
@@ -2196,6 +2283,10 @@ async function publishSandbox(sandboxId, opts) {
         release_id: releaseId,
         version_id: versionId,
         url,
+        url_info: urlInfo ?? undefined,
+        url_class: urlClass,
+        stable_for_embedding: stableForEmbedding,
+        recommended_next_action: recommendedNextAction,
         state,
         deployment_product: deploymentProduct,
         docker_deploy_host_id: dockerDeployHostId,
@@ -2220,7 +2311,7 @@ async function waitForDeploymentReady(c, deploymentId, timeoutSec) {
         await sleep(2000);
     }
     const lastState = last ? String(last["state"] ?? "unknown") : "unknown";
-    throw new UserError(`Deployment still building after ${timeoutSec}s — it may still finish. Re-check with \`miosa sandbox show ${deploymentId}\` or \`miosa deploy logs\`.`, `Last state: ${lastState}`);
+    throw new UserError(`Deployment still building after ${timeoutSec}s — it may still finish. Re-check with \`miosa deploy show ${deploymentId}\` or \`miosa deploy logs ${deploymentId}\`.`, `Last state: ${lastState}`);
 }
 function parsePublishDatabase(value) {
     if (!value)
@@ -2258,6 +2349,12 @@ async function doctorSandbox(sandboxId, port, probePath) {
         exposeData = { error: err instanceof Error ? err.message : String(err) };
     }
     const previewUrl = extractUrl(exposeData);
+    const urlClass = stringField(exposeData, "url_class") ??
+        stringField(exposeData, "class") ??
+        "temporary_preview";
+    const stableForEmbedding = booleanField(exposeData, "stable_for_embedding") ?? false;
+    const recommendedNextAction = stringField(exposeData, "recommended_next_action") ??
+        "create_alias_or_publish";
     const edge = previewUrl
         ? await probePublicPreview(previewUrl, probePath)
         : { ok: false, status: null, error: "No preview URL returned" };
@@ -2275,6 +2372,10 @@ async function doctorSandbox(sandboxId, port, probePath) {
         edge_probe: edge,
         preview_ready: edge.ok,
         preview_url: previewUrl,
+        url_info: objectField(exposeData, "url_info") ?? null,
+        url_class: urlClass,
+        stable_for_embedding: stableForEmbedding,
+        recommended_next_action: recommendedNextAction,
         expose: exposeData,
     };
 }
@@ -2290,6 +2391,8 @@ function renderDoctorReport(report) {
     console.log(`  ${chalk.bold("Preview ready")} ${report["preview_ready"] ? chalk.green("yes") : chalk.red("no")}`);
     if (report["preview_url"]) {
         console.log(`  ${chalk.bold("Preview URL")}   ${chalk.cyan(String(report["preview_url"]))}`);
+        console.log(`  ${chalk.bold("URL class")}     ${report["url_class"]}`);
+        console.log(`  ${chalk.bold("Embeddable")}    ${report["stable_for_embedding"] === true ? chalk.green("yes") : chalk.yellow("temporary")}`);
     }
     console.log();
     if (!report["preview_ready"]) {
@@ -3146,6 +3249,13 @@ function stringField(row, key) {
     const value = row?.[key];
     return typeof value === "string" && value.length > 0 ? value : null;
 }
+function booleanField(row, key) {
+    const value = row?.[key];
+    return typeof value === "boolean" ? value : null;
+}
+function objectField(row, key) {
+    return asRecord(row?.[key]);
+}
 function isSandboxTarget(value) {
     const idx = value.indexOf(":");
     if (idx <= 0)