@namiml/cli 3.4.11-dev.202609230009 → 3.4.11-dev.202609231629

package/dist/screens/Shell.js

@@ -1,13 +1,21 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useState } from "react";
-import { Box, Text, useApp, useInput } from "ink";
+import { useEffect, useRef, useState } from "react";
+import { Box, Text, useApp, useInput, useStdout } from "ink";
 import { LoginFlow } from "./LoginFlow.js";
 import { PickApp } from "./PickApp.js";
 import { PickPlatform } from "./PickPlatform.js";
 import { PickDevice } from "./PickDevice.js";
 import { PickOrg } from "./PickOrg.js";
 import { SwitchScreen } from "./SwitchScreen.js";
+import { WelcomeScreen } from "./WelcomeScreen.js";
+import { NewToNami } from "./NewToNami.js";
 import { SuccessScreen } from "./SuccessScreen.js";
+import { PickPlacement } from "./PickPlacement.js";
+import { LaunchScreen, focusableNodes } from "./LaunchScreen.js";
+import { corePlacements } from "../placements/list.js";
+import { compositeForPlacement, pressNode, startLaunch as startLaunchFn } from "../placements/launch.js";
+import { EventBus } from "../events/bus.js";
+import { terminalColumns } from "../utils/terminal.js";
 import { deviceById, presetsFor, resolveDevice, toSelection } from "../devices/presets.js";
 import { SelectionHeader } from "./SelectionHeader.js";
 import { Thinking } from "../components/Thinking.js";
@@ -19,6 +27,7 @@ import { findApp, findPlatform, ResolveError } from "../control-center/resolve.j
 import { findAppPlatformById, pastedStandIn } from "../control-center/lookup.js";
 import { ConfigureScreen } from "./ConfigureScreen.js";
 import { appFrom, platformFrom, selectionFrom } from "../config/selection.js";
+import { resolveHost } from "../hosts.js";
 import { verifyAppPlatform as verifyAppPlatformFn, VerifyError } from "../sdk/verify.js";
 import TextInput from "ink-text-input";
 /**
@@ -28,14 +37,27 @@ import TextInput from "ink-text-input";
  * pasted App Platform ID. Every path funnels back through `configure`, so the
  * SDK is re-configured in place and each platform keeps its own storage file.
  */
-export function Shell({ ctx, appQuery, platformQuery, deviceQuery, onExit, exitWhenDone = true, phase, verify, configure }) {
+export function Shell({ ctx, appQuery, platformQuery, deviceQuery, onExit, exitWhenDone = true, phase, hostWasExplicit = false, verify, configure, placementsSource, compositeSource, startLaunch }) {
     const { exit } = useApp();
+    const { stdout } = useStdout();
     const [state, setState] = useState({ kind: "boot" });
     const [orgName, setOrgName] = useState(null);
     const [orgId, setOrgId] = useState(null);
     const step = (name) => void ctx.config.setOnboardingStep(name).catch(() => { });
     const [queries, setQueries] = useState({ app: appQuery, platform: platformQuery, device: deviceQuery });
     const [pasted, setPasted] = useState("");
+    // The paste route may retry on another host after a 404, without re-typing the id.
+    const [pasteHost, setPasteHost] = useState(ctx.host);
+    // One bus for the whole session. A launch clears it, so a run always starts
+    // empty, but `seq` keeps climbing — it identifies events, it is not a count.
+    const [bus] = useState(() => new EventBus());
+    const [events, setEvents] = useState([]);
+    const [paused, setPaused] = useState(false);
+    const [expanded, setExpanded] = useState(false);
+    const [focusIndex, setFocusIndex] = useState(0);
+    const [notice, setNotice] = useState(undefined);
+    // The bus subscriber runs outside React's render, so pause is read from a ref.
+    const pausedRef = useRef(false);
     const finish = (code) => {
         onExit?.(code);
         if (exitWhenDone)
@@ -120,22 +142,99 @@ export function Shell({ ctx, appQuery, platformQuery, deviceQuery, onExit, exitW
      * its name by scanning the apps this account can see. An id from another org
      * still works — it just shows as a pasted id until the device step.
      */
-    const usePastedId = async (home, raw) => {
+    const usePastedId = async (home, raw, host = pasteHost) => {
         const id = raw.trim();
         if (!id)
             return;
+        setPasteHost(host);
         setState({ kind: "busy", label: "Checking that ID…" });
         try {
-            await (verify ?? verifyAppPlatformFn)(ctx.host.baseUrl, id);
+            await (verify ?? verifyAppPlatformFn)(host.baseUrl, id);
         }
         catch (error) {
-            if (error instanceof VerifyError)
-                return setState({ kind: "paste-id", home, notice: error.message });
+            if (error instanceof VerifyError) {
+                // A first-run id pasted against production is most often a staging id.
+                const offer = error.code === "not_found" && host.name === "production" && !hostWasExplicit ? id : undefined;
+                const notice = offer ? `${error.message}\nPress s to try staging instead.` : error.message;
+                return setState({ kind: "paste-id", home, notice, offerStaging: offer });
+            }
             return handleError(error);
         }
         const named = (await findAppPlatformById(ctx.session, id)) ?? pastedStandIn(id);
         chooseDevice(named.app, named.platform);
     };
+    /** `l`: the placements this configured platform can launch. */
+    const openPlacements = (home) => {
+        try {
+            setState({ kind: "pick-placement", home, placements: (placementsSource ?? corePlacements)() });
+        }
+        catch (error) {
+            handleError(error);
+        }
+    };
+    /** Enter on a placement: reset the pane, outline the page, then subscribe and launch. */
+    const openLaunch = (home, placement) => {
+        bus.clear();
+        setEvents([]);
+        setFocusIndex(0);
+        setExpanded(false);
+        setNotice(undefined);
+        pausedRef.current = false;
+        setPaused(false);
+        setState({ kind: "launch", home, placement, composite: (compositeSource ?? compositeForPlacement)(placement.label) });
+    };
+    // Subscriptions live and die with the launch state, so leaving the screen
+    // unregisters every handler it added.
+    const launchLabel = state.kind === "launch" ? state.placement.label : null;
+    useEffect(() => {
+        if (launchLabel === null)
+            return;
+        let live = true;
+        let session;
+        const unsubscribe = bus.subscribe(() => {
+            if (!pausedRef.current)
+                setEvents(bus.all());
+        });
+        void (startLaunch ?? startLaunchFn)(launchLabel, bus)
+            .then((started) => {
+            if (live)
+                session = started;
+            else
+                started.dispose();
+        })
+            .catch((error) => setNotice(error instanceof Error ? error.message : String(error)));
+        return () => {
+            live = false;
+            unsubscribe();
+            session?.dispose();
+        };
+    }, [launchLabel]);
+    /** Press: report the mapped action, or say why this control reports nothing. */
+    const press = (node) => {
+        setNotice(pressNode(node).reason);
+    };
+    const togglePause = () => {
+        const next = !pausedRef.current;
+        pausedRef.current = next;
+        setPaused(next);
+        // Resuming catches up on everything that arrived while paused.
+        if (!next)
+            setEvents(bus.all());
+    };
+    const clearEvents = () => {
+        bus.clear();
+        setEvents([]);
+    };
+    const onWelcomeChoice = (choice) => {
+        if (choice === "signin") {
+            step("signin");
+            return setState({ kind: "signin" });
+        }
+        if (choice === "new")
+            return setState({ kind: "new-to-nami" });
+        step("configure");
+        setState({ kind: "paste-id", home: null });
+    };
     const onSwitchChoice = (home, action) => {
         if (action.kind === "recent")
             return useRecent(home, action.selection);
@@ -187,11 +286,18 @@ export function Shell({ ctx, appQuery, platformQuery, deviceQuery, onExit, exitW
             setOrgName(stored?.orgName ?? null);
             setOrgId(stored?.orgId ?? null);
             const signedIn = Boolean(stored || ctx.env.NAMI_TOKEN);
+            const { config } = await ctx.config.load();
+            const asked = Boolean(queries.app || queries.platform || queries.device);
+            // First run only: the step is still `welcome` and nothing has been chosen.
+            // Any later step resumes where it left off, so quitting mid-onboarding
+            // never re-greets you.
+            if (config.onboarding.step === "welcome" && !config.current && !asked) {
+                return setState({ kind: "welcome" });
+            }
             if (!signedIn) {
                 step("signin");
                 return setState({ kind: "signin" });
             }
-            const { config } = await ctx.config.load();
             // Zero-prompt re-run: a persisted selection (and no --app/--platform override) goes straight to configure.
             if (config.current && !queries.app && !queries.platform) {
                 const platform = platformFrom(config.current);
@@ -208,12 +314,16 @@ export function Shell({ ctx, appQuery, platformQuery, deviceQuery, onExit, exitW
         if (state.kind === "fatal")
             finish(state.code);
     }, [state.kind]);
-    useInput((_input, key) => {
+    useInput((input, key) => {
         if (state.kind !== "paste-id")
             return;
+        if (state.offerStaging && input === "s") {
+            const id = state.offerStaging;
+            return void usePastedId(state.home, id, resolveHost("staging"));
+        }
         if (key.escape) {
             setPasted("");
-            setState(state.home);
+            setState(state.home ?? { kind: "welcome" });
         }
     }, { isActive: state.kind === "paste-id" });
     useInput((input, key) => {
@@ -228,11 +338,11 @@ export function Shell({ ctx, appQuery, platformQuery, deviceQuery, onExit, exitW
         if (input === "d" && presetsFor(state.platform.type).length > 1)
             return setState({ kind: "pick-device", app: state.app, platform: state.platform, current: state.device ?? undefined });
         if (input === "l")
-            return setState({ ...state, launchHint: true });
+            return openPlacements(state);
     }, { isActive: state.kind === "home" });
     // The hub and its sub-screens keep the home state they came from, so the header
     // keeps showing what is loaded while you choose what to switch to.
-    const shown = "home" in state ? state.home : "app" in state ? state : {};
+    const shown = ("home" in state ? state.home : "app" in state ? state : null) ?? {};
     const header = (_jsx(SelectionHeader, { orgName: orgName, appName: shown.app?.name, platformName: shown.platform?.name, platformType: shown.platform?.typeLabel, deviceName: shown.device?.displayName, host: ctx.host.name }));
     return (_jsxs(Box, { flexDirection: "column", children: [header, _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [state.kind === "boot" && _jsx(Thinking, { label: "Starting\u2026", phase: phase }), state.kind === "signin" && (_jsxs(Box, { flexDirection: "column", children: [state.notice && _jsx(Text, { color: palette.aqua, children: state.notice }), _jsx(LoginFlow, { auth: ctx.auth, store: ctx.store, host: ctx.host, exitWhenDone: false, phase: phase, onDone: (session) => { setOrgName(session.orgName); setOrgId(session.orgId); void loadApps(); }, onFail: (e) => fatal(e.message) })] })), state.kind === "busy" && _jsx(Thinking, { label: state.label, phase: phase }), state.kind === "pick-app" && (_jsx(PickApp, { apps: state.apps, orgName: orgName, baseUrl: ctx.host.baseUrl, currentAppId: state.current?.id, onSelect: (app) => void loadPlatforms(app), onCancel: () => finish(0) })), state.kind === "pick-platform" && (_jsx(PickPlatform, { appName: state.app.name, platforms: state.platforms, currentPlatformId: state.current?.id, onSelect: (platform) => chooseDevice(state.app, platform), onCancel: () => void loadApps(state.app) })), state.kind === "pick-device" && (_jsx(PickDevice, { platformType: state.platform.type, platformName: state.platform.name, currentDeviceId: state.current?.id, onSelect: (device) => { step("configure"); setState({ kind: "configure", app: state.app, platform: state.platform, device }); }, onCancel: () => void loadPlatforms(state.app, state.platform) })), state.kind === "configure" && (_jsx(ConfigureScreen, { host: ctx.host, appPlatformId: state.platform.id, device: state.device ? { platformType: state.platform.type, id: state.device.id } : undefined, phase: phase, verify: verify, configure: configure, onDone: (result) => {
                             void ctx.config
@@ -240,5 +350,8 @@ export function Shell({ ctx, appQuery, platformQuery, deviceQuery, onExit, exitW
                                 .then(() => ctx.config.markOnboardingDone())
                                 .catch(() => { });
                             setState({ kind: "home", app: state.app, platform: state.platform, device: state.device, result });
-                        }, onBack: () => chooseDevice(state.app, state.platform, state.device ?? undefined) })), state.kind === "home" && (_jsx(SuccessScreen, { app: state.app, platform: state.platform, device: state.device, result: state.result, host: ctx.host, canSwitchDevice: presetsFor(state.platform.type).length > 1, launchHint: state.launchHint })), state.kind === "switch" && (_jsx(SwitchScreen, { recent: state.recent, current: state.current, orgName: orgName, canSwitchDevice: presetsFor(state.home.platform.type).length > 1, canSwitchOrg: true, onChoose: (action) => onSwitchChoice(state.home, action), onCancel: () => setState(state.home) })), state.kind === "pick-org" && (_jsx(PickOrg, { orgs: state.orgs, currentOrgId: orgId, onSelect: (org) => void switchOrg(org), onCancel: () => setState(state.home) })), state.kind === "paste-id" && (_jsxs(Box, { flexDirection: "column", children: [state.notice && _jsx(Text, { color: palette.coral, children: state.notice }), _jsxs(Box, { children: [_jsx(Text, { children: "App Platform ID: " }), _jsx(TextInput, { value: pasted, onChange: setPasted, onSubmit: (v) => { setPasted(""); void usePastedId(state.home, v); } })] }), _jsx(Text, { dimColor: true, children: "nami platforms --app <app> lists them. Esc to go back." })] })), state.kind === "fatal" && _jsx(Text, { color: palette.coral, children: state.message })] })] }));
+                        }, onBack: () => chooseDevice(state.app, state.platform, state.device ?? undefined) })), state.kind === "home" && (_jsx(SuccessScreen, { app: state.app, platform: state.platform, device: state.device, result: state.result, host: ctx.host, canSwitchDevice: presetsFor(state.platform.type).length > 1 })), state.kind === "pick-placement" && (_jsx(PickPlacement, { placements: state.placements, onSelect: (placement) => openLaunch(state.home, placement), onCancel: () => setState(state.home) })), state.kind === "launch" && (_jsx(LaunchScreen, { placement: state.placement, composite: state.composite, deviceName: state.home.device?.displayName, events: events, width: Math.max(terminalColumns(stdout) - 2, 40), paused: paused, expanded: expanded, selectedSeq: events.at(-1)?.seq, focusIndex: focusIndex, onPress: press, onMove: (delta) => {
+                            const count = focusableNodes(state.composite).length;
+                            setFocusIndex((index) => (count === 0 ? 0 : (index + delta + count) % count));
+                        }, onTogglePause: togglePause, onClear: clearEvents, onToggleExpand: () => setExpanded((on) => !on), onBack: () => setState(state.home), notice: notice })), state.kind === "welcome" && (_jsx(WelcomeScreen, { host: ctx.host, onChoose: onWelcomeChoice, onCancel: () => finish(0) })), state.kind === "new-to-nami" && (_jsx(NewToNami, { host: ctx.host, onContinue: () => { step("configure"); setState({ kind: "paste-id", home: null }); }, onBack: () => setState({ kind: "welcome" }) })), state.kind === "switch" && (_jsx(SwitchScreen, { recent: state.recent, current: state.current, orgName: orgName, canSwitchDevice: presetsFor(state.home.platform.type).length > 1, canSwitchOrg: true, onChoose: (action) => onSwitchChoice(state.home, action), onCancel: () => setState(state.home) })), state.kind === "pick-org" && (_jsx(PickOrg, { orgs: state.orgs, currentOrgId: orgId, onSelect: (org) => void switchOrg(org), onCancel: () => setState(state.home) })), state.kind === "paste-id" && (_jsxs(Box, { flexDirection: "column", children: [state.notice && _jsx(Text, { color: palette.coral, children: state.notice }), _jsxs(Box, { children: [_jsx(Text, { children: "App Platform ID: " }), _jsx(TextInput, { value: pasted, onChange: setPasted, onSubmit: (v) => { setPasted(""); void usePastedId(state.home, v); } })] }), _jsxs(Text, { dimColor: true, children: ["Checking ", pasteHost.name, ". nami platforms --app <app> lists them. Esc to go back."] })] })), state.kind === "fatal" && _jsx(Text, { color: palette.coral, children: state.message })] })] }));
 }

package/dist/screens/SuccessScreen.js

@@ -3,9 +3,9 @@ import { Box, Text } from "ink";
 import { palette } from "../theme.js";
 export const PLACEMENT_LIST_MAX = 8;
 /** The payoff after onboarding: what the SDK found, and what to do next. */
-export function SuccessScreen({ app, platform, device, result, host, canSwitchDevice, launchHint }) {
+export function SuccessScreen({ app, platform, device, result, host, canSwitchDevice }) {
     const { counts, placements } = result;
     const shown = placements.slice(0, PLACEMENT_LIST_MAX);
     const more = placements.length - shown.length;
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: palette.aqua, paddingX: 1, children: [_jsxs(Text, { children: [_jsx(Text, { bold: true, color: palette.aqua, children: "Connected" }), " \u00B7 ", app.name, " \u00B7 ", platform.name, " ", _jsxs(Text, { color: palette.secondaryBlue, children: ["[", platform.typeLabel, "]"] }), device && _jsxs(Text, { children: [" \u00B7 ", device.displayName, " ", _jsxs(Text, { dimColor: true, children: ["(", device.width, "\u00D7", device.height, ")"] })] })] }), _jsxs(Text, { dimColor: true, children: ["App Platform ID ", result.appPlatformId, " \u00B7 ", host.name] }), _jsxs(Text, { children: ["SDK ", result.configureState, " \u00B7 pinned to @namiml/sdk-core ", result.sdkVersion, " \u00B7 ", result.sdkEnabled ? "SDK enabled" : _jsx(Text, { color: palette.coral, children: "SDK disabled" })] }), result.deviceId && _jsxs(Text, { dimColor: true, children: ["device ", result.deviceId] }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: ["placements ", _jsx(Text, { bold: true, children: counts.placements }), " \u00B7 products ", _jsx(Text, { bold: true, children: counts.products }), " \u00B7 paywalls ", _jsx(Text, { bold: true, children: counts.paywalls })] }) }), shown.length > 0 && (_jsxs(Text, { dimColor: true, children: [shown.join(" · "), more > 0 ? ` · +${more} more` : ""] })), launchHint && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: palette.aqua, children: ["Launching a placement lands in the next release.", placements.length > 0 ? ` The SDK found: ${shown.join(", ")}${more > 0 ? ` and ${more} more` : ""}.` : " This platform has no placements yet — add a campaign in the Control Center."] }) }))] }), _jsxs(Text, { dimColor: true, children: ["l launch a placement \u00B7 s switch app \u00B7 p switch platform", canSwitchDevice ? " · d switch device" : "", " \u00B7 q quit"] })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: palette.aqua, paddingX: 1, children: [_jsxs(Text, { children: [_jsx(Text, { bold: true, color: palette.aqua, children: "Connected" }), " \u00B7 ", app.name, " \u00B7 ", platform.name, " ", _jsxs(Text, { color: palette.secondaryBlue, children: ["[", platform.typeLabel, "]"] }), device && _jsxs(Text, { children: [" \u00B7 ", device.displayName, " ", _jsxs(Text, { dimColor: true, children: ["(", device.width, "\u00D7", device.height, ")"] })] })] }), _jsxs(Text, { dimColor: true, children: ["App Platform ID ", result.appPlatformId, " \u00B7 ", host.name] }), _jsxs(Text, { children: ["SDK ", result.configureState, " \u00B7 pinned to @namiml/sdk-core ", result.sdkVersion, " \u00B7 ", result.sdkEnabled ? "SDK enabled" : _jsx(Text, { color: palette.coral, children: "SDK disabled" })] }), result.deviceId && _jsxs(Text, { dimColor: true, children: ["device ", result.deviceId] }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: ["placements ", _jsx(Text, { bold: true, children: counts.placements }), " \u00B7 products ", _jsx(Text, { bold: true, children: counts.products }), " \u00B7 paywalls ", _jsx(Text, { bold: true, children: counts.paywalls })] }) }), shown.length > 0 && (_jsxs(Text, { dimColor: true, children: [shown.join(" · "), more > 0 ? ` · +${more} more` : ""] }))] }), _jsxs(Text, { dimColor: true, children: ["l launch a placement \u00B7 s switch app \u00B7 p switch platform", canSwitchDevice ? " · d switch device" : "", " \u00B7 q quit"] })] }));
 }

package/dist/screens/WelcomeScreen.js

@@ -0,0 +1,15 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { SelectList } from "../components/SelectList.js";
+const CHOICES = [
+    { key: "signin", label: "Sign in to pick my app", hint: "your Control Center account" },
+    { key: "paste", label: "I have an App Platform ID", hint: "no sign-in needed" },
+    { key: "new", label: "I'm new to Nami", hint: "start here" },
+];
+/**
+ * First-run welcome: sign in, paste an App Platform ID, or read the explainer.
+ * Pure — it never fetches and never exits; `Shell` owns every transition.
+ */
+export function WelcomeScreen({ host, onChoose, onCancel }) {
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: [host.name, " \u00B7 ", host.baseUrl] }), _jsx(SelectList, { title: "Welcome to Nami", items: CHOICES, initialKey: "signin", onSelect: (key) => onChoose(key), onCancel: onCancel })] }));
+}

package/dist/sdk/summary.js

@@ -1,12 +1,34 @@
-/** One human label per campaign rule: the placement label for label rules, else the rule name. */
+/**
+ * The one human label a campaign rule goes by: the placement label for label
+ * rules, else the rule name. Empty when the rule carries neither.
+ *
+ * This is the single copy of that rule — `summarizePlacements()` (the configure
+ * summary and the Success screen) and `listPlacements()` (`src/placements/list.ts`,
+ * the picker and `nami placements`) both go through it so they cannot drift.
+ */
+export function placementLabel(campaign) {
+    const label = campaign.type === "label" && typeof campaign.value === "string" && campaign.value.trim() ? campaign.value.trim() : campaign.name?.trim();
+    return label || undefined;
+}
+/** One human label per campaign rule, de-duplicated and sorted. */
 export function summarizePlacements(campaigns) {
     if (!Array.isArray(campaigns))
         return [];
     const labels = new Set();
     for (const c of campaigns) {
-        const label = c.type === "label" && typeof c.value === "string" && c.value.trim() ? c.value.trim() : c.name?.trim();
+        const label = placementLabel(c);
         if (label)
             labels.add(label);
     }
     return [...labels].sort((a, b) => a.localeCompare(b));
 }
+/**
+ * The two lines every non-JSON configure path prints. `nami configure`, `nami
+ * onboarding` and any future caller share this so their output cannot drift.
+ */
+export function configureSummaryLines(result) {
+    return [
+        `Configured ${result.appPlatformId} on ${result.host}: ${result.configureState}${result.sdkEnabled ? "" : " (SDK disabled)"}${result.device ? ` · ${result.device.displayName}` : ""}`,
+        `placements ${result.counts.placements} · products ${result.counts.products} · paywalls ${result.counts.paywalls}${result.deviceId ? ` · device ${result.deviceId}` : ""}`,
+    ];
+}

package/dist/utils/open-url.js

@@ -0,0 +1,33 @@
+import { spawn } from "node:child_process";
+const nodeSpawn = (cmd, args, opts) => spawn(cmd, args, opts);
+/** The platform's "open this in the default handler" command, or null when we have none. */
+function opener(platform, url) {
+    switch (platform) {
+        case "darwin":
+            return { cmd: "open", args: [url] };
+        case "win32":
+            // The empty string is `start`'s title argument; without it a quoted URL becomes the title.
+            return { cmd: "cmd", args: ["/c", "start", "", url] };
+        case "linux":
+            return { cmd: "xdg-open", args: [url] };
+        default:
+            return null;
+    }
+}
+/**
+ * Best effort: open `url` in the developer's browser. Never throws and never blocks —
+ * returns false when we have no opener for this platform or spawning fails, so the
+ * caller can print the URL instead.
+ */
+export function openUrl(url, platform = process.platform, spawnImpl = nodeSpawn) {
+    const target = opener(platform, url);
+    if (!target)
+        return false;
+    try {
+        spawnImpl(target.cmd, target.args, { stdio: "ignore", detached: true }).unref();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/version.js

@@ -1,2 +1,2 @@
 /** CLI package version. Stamped by scripts/version.sh from the repo VERSION file — do not hand-edit. */
-export const NAMI_CLI_VERSION = "3.4.11-dev.202609230009";
+export const NAMI_CLI_VERSION = "3.4.11-dev.202609231629";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@namiml/cli",
-  "version": "3.4.11-dev.202609230009",
+  "version": "3.4.11-dev.202609231629",
   "description": "Nami SDK developer CLI — terminal test app, implementation and flow checks",
   "keywords": [
     "nami",
@@ -35,7 +35,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@namiml/sdk-core": "3.4.11-dev.202609230009",
+    "@namiml/sdk-core": "3.4.11-dev.202609231629",
     "commander": "^15",
     "env-paths": "^4",
     "ink": "^6.0.0",