@namiml/cli 3.4.11-dev.202609221916 → 3.4.11-dev.202609222222

package/README.md

@@ -8,13 +8,29 @@ npm install -g @namiml/cli # or install the `nami` command
 nami --version
 ```
 
-Requires Node 20+. Single-file executables for macOS, Linux and Windows are attached to each [release](https://github.com/namiml/nami-cli/releases).
+Requires Node 20+.
 
 `@namiml/cli` is versioned in lockstep with the Nami SDKs — `nami --version` tells you exactly which SDK release it is pinned to.
 
+## Standalone executables
+
+Single-file builds for macOS, Linux and Windows need no Node install. Replace `<version>` with the release you want:
+
+```
+https://packages.namiml.com/NamiSDK/CLI/<version>/nami-<version>-darwin-arm64
+https://packages.namiml.com/NamiSDK/CLI/<version>/nami-<version>-darwin-x64
+https://packages.namiml.com/NamiSDK/CLI/<version>/nami-<version>-linux-x64
+https://packages.namiml.com/NamiSDK/CLI/<version>/nami-<version>-windows-x64.exe
+```
+
+```bash
+curl -fsSLO https://packages.namiml.com/NamiSDK/CLI/3.5.0/nami-3.5.0-darwin-arm64
+chmod +x nami-3.5.0-darwin-arm64 && ./nami-3.5.0-darwin-arm64 --version
+```
+
 ## Status
 
-Early access. The current release is a scaffold; the test-app screens, onboarding and implementation checks are landing release by release. Each [GitHub release](https://github.com/namiml/nami-cli/releases) carries its notes.
+Early access. The current release is a scaffold; the test-app screens, onboarding and implementation checks are landing release by release.
 
 ## License
 

package/dist/adapters/file-storage.adapter.js

@@ -1,11 +1,20 @@
 import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 const DEBOUNCE_MS = 50;
-/** Storage file for one App Platform ID. Throws on path-traversal attempts. */
-export function storagePathFor(appPlatformId, configDir) {
-    if (!/^[A-Za-z0-9-]+$/.test(appPlatformId))
+const SAFE = /^[A-Za-z0-9_-]+$/;
+/**
+ * Storage file for one App Platform ID — and, when a device preset is in play,
+ * one per device under it (`storage/<appPlatformId>/<deviceId>.json`): an iPhone
+ * session and an iPad session are different SDK devices. Throws on path-traversal attempts.
+ */
+export function storagePathFor(appPlatformId, configDir, deviceId) {
+    if (!SAFE.test(appPlatformId))
         throw new Error(`Refusing to build a storage path from "${appPlatformId}".`);
-    return join(configDir, "storage", `${appPlatformId}.json`);
+    if (deviceId === undefined)
+        return join(configDir, "storage", `${appPlatformId}.json`);
+    if (!SAFE.test(deviceId))
+        throw new Error(`Refusing to build a storage path from device "${deviceId}".`);
+    return join(configDir, "storage", appPlatformId, `${deviceId}.json`);
 }
 /**
  * Synchronous IStorageAdapter backed by one JSON file per App Platform ID, so

package/dist/adapters/index.js

@@ -7,7 +7,7 @@ import { TerminalPurchaseAdapter } from "./terminal-purchase.adapter.js";
 export function registerTerminalAdapters(options = {}) {
     const adapters = {
         storage: options.storage ?? new TerminalStorageAdapter(),
-        device: new TerminalDeviceAdapter(),
+        device: new TerminalDeviceAdapter(options.device),
         ui: new TerminalUIAdapter(),
         purchase: new TerminalPurchaseAdapter(),
     };

package/dist/adapters/terminal-device.adapter.js

@@ -1,6 +1,8 @@
 import os from "node:os";
 import { randomUUID } from "node:crypto";
 import { NAMI_SDK_PACKAGE_VERSION } from "@namiml/sdk-core";
+import { deviceOs } from "../devices/presets.js";
+const TV_SCALE = { "720p": 0.67, "1080p": 1, "4k": 2 };
 const SDK_CLIENT = "cli";
 function terminalLanguage() {
     const raw = process.env.LC_ALL || process.env.LC_MESSAGES || process.env.LANG || "en";
@@ -8,8 +10,13 @@ function terminalLanguage() {
     return !tag || tag === "C" || tag === "POSIX" ? "en" : tag;
 }
 export class TerminalDeviceAdapter {
+    preset;
+    /** Without a preset the adapter describes the host machine (a desktop). */
+    constructor(preset) {
+        this.preset = preset;
+    }
     getDeviceData() {
-        return {
+        const base = {
             os_name: os.platform(),
             os_version: os.release(),
             browser_name: "",
@@ -20,17 +27,31 @@ export class TerminalDeviceAdapter {
             extended_platform: "node",
             extended_platform_version: process.versions.node,
         };
+        if (!this.preset)
+            return base;
+        const { device, platformType } = this.preset;
+        return {
+            ...base,
+            os_name: deviceOs(device, platformType),
+            os_version: "",
+            device_model: device.displayName,
+            form_factor: device.type,
+            browser_name: device.browser ?? "",
+        };
     }
     getDeviceFormFactor() {
-        return "desktop";
+        return this.preset?.device.type ?? "desktop";
     }
     getDeviceScaleFactor() {
-        return 1;
+        const quality = this.preset?.device.tvQuality;
+        return quality ? TV_SCALE[quality] ?? 1 : 1;
     }
     generateUUID() {
         return randomUUID();
     }
     getScreenInfo() {
+        if (this.preset)
+            return { width: this.preset.device.width, height: this.preset.device.height, scale: this.getDeviceScaleFactor() };
         return { width: process.stdout.columns ?? 80, height: process.stdout.rows ?? 24, scale: 1 };
     }
     getLanguage() {

package/dist/cli.js

@@ -13,6 +13,7 @@ import { shell } from "./commands/shell.js";
 import { configure } from "./commands/configure.js";
 import { config } from "./commands/config.js";
 import { onboarding } from "./commands/onboarding.js";
+import { devices } from "./commands/devices.js";
 const program = createProgram({
     shell: async (opts) => shell(opts, await buildContext(opts.host)),
     demo: () => { render(_jsx(App, {})); },
@@ -24,5 +25,6 @@ const program = createProgram({
     configure: async (opts) => configure(opts, await buildContext(opts.host)),
     config: async (opts) => config(opts, await buildContext(opts.host)),
     onboarding: async (opts) => onboarding(opts, await buildContext(opts.host)),
+    devices: async (opts) => devices(opts, await buildContext(opts.host)),
 });
 await program.parseAsync(process.argv);

package/dist/commands/configure.js

@@ -4,12 +4,17 @@ import { SDK_DISABLED_MESSAGE, VerifyError, verifyAppPlatform } from "../sdk/ver
 export async function configure(opts, ctx, deps = {}) {
     const verify = deps.verify ?? verifyAppPlatform;
     const run = deps.configure ?? configureSdk;
+    if (opts.device && !opts.platformType) {
+        ctx.err("--device needs --platform-type <apple|google|amazon_iap|roku_pay|web> so the CLI knows which device family to use.");
+        return 2;
+    }
     let result;
     try {
         const verified = await verify(ctx.host.baseUrl, opts.appPlatformId, deps.fetch ?? globalThis.fetch);
         if (verified.kind === "sdk_disabled")
             ctx.err(SDK_DISABLED_MESSAGE);
-        result = await run({ host: ctx.host, appPlatformId: opts.appPlatformId }, { ...deps, verified });
+        const device = opts.platformType ? { platformType: opts.platformType, id: opts.device } : undefined;
+        result = await run({ host: ctx.host, appPlatformId: opts.appPlatformId, device }, { ...deps, verified });
     }
     catch (error) {
         if (error instanceof VerifyError) {
@@ -22,7 +27,7 @@ export async function configure(opts, ctx, deps = {}) {
         ctx.out(JSON.stringify(result, null, 2));
     }
     else {
-        ctx.out(`Configured ${result.appPlatformId} on ${result.host}: ${result.configureState}${result.sdkEnabled ? "" : " (SDK disabled)"}`);
+        ctx.out(`Configured ${result.appPlatformId} on ${result.host}: ${result.configureState}${result.sdkEnabled ? "" : " (SDK disabled)"}${result.device ? ` · ${result.device.displayName}` : ""}`);
         ctx.out(`placements ${result.counts.placements} · products ${result.counts.products} · paywalls ${result.counts.paywalls}${result.deviceId ? ` · device ${result.deviceId}` : ""}`);
     }
     return result.sdkInitialized ? 0 : 1;

package/dist/commands/devices.js

@@ -0,0 +1,21 @@
+import { PLATFORM_TYPES, devicesFor, presetsFor } from "../devices/presets.js";
+import { renderTable } from "./list-output.js";
+/** `nami devices --platform-type <type>` — the presets and the full previewer list for a platform type. */
+export async function devices(opts, ctx) {
+    if (!PLATFORM_TYPES.includes(opts.platformType)) {
+        ctx.err(`Unknown platform type "${opts.platformType}". Use one of: ${PLATFORM_TYPES.join(", ")}.`);
+        return 2;
+    }
+    const presets = presetsFor(opts.platformType);
+    const all = devicesFor(opts.platformType);
+    if (opts.json) {
+        ctx.out(JSON.stringify({ platformType: opts.platformType, presets, devices: all }, null, 2));
+        return 0;
+    }
+    ctx.out(`Presets for ${opts.platformType} (pass the label or id to --device):`);
+    ctx.out(renderTable(presets.map((p) => ({ preset: p.label, formFactor: p.formFactor, device: p.deviceId })), ["preset", "formFactor", "device"]));
+    ctx.out("");
+    ctx.out(`All ${all.length} devices:`);
+    ctx.out(renderTable(all.map((d) => ({ id: d.id, name: d.displayName, type: d.type, size: `${d.width}×${d.height}` })), ["id", "name", "type", "size"]));
+    return 0;
+}

package/dist/commands/shell.js

@@ -10,7 +10,7 @@ export async function shell(opts, ctx) {
         return 0;
     }
     let code = 0;
-    const app = render(_jsx(Shell, { ctx: ctx, appQuery: opts.app, platformQuery: opts.platform, onExit: (c) => { code = c; } }));
+    const app = render(_jsx(Shell, { ctx: ctx, appQuery: opts.app, platformQuery: opts.platform, deviceQuery: opts.device, onExit: (c) => { code = c; } }));
     await app.waitUntilExit();
     return code;
 }

package/dist/devices/presets.js

@@ -0,0 +1,83 @@
+import { resolve } from "../control-center/resolve.js";
+import { PREVIEW_DEVICES, PREVIEW_DEVICE_BY_ID } from "./table.js";
+/** Billing platform types the Control Center uses (`PlatformSerializer.type`). */
+export const PLATFORM_TYPES = ["apple", "google", "amazon_iap", "roku_pay", "web"];
+/** Copied from frontend `utils/paywall.ts` `platformCompatibleWithFormFactor`. */
+export function platformCompatibleWithFormFactor(platformType, formFactor) {
+    if (platformType === "roku_pay" || platformType === "amazon_iap")
+        return formFactor === "television";
+    if (platformType === "apple" || platformType === "google")
+        return formFactor === "television" || formFactor === "phone" || formFactor === "tablet";
+    if (platformType === "web")
+        return true;
+    return false;
+}
+/** Copied from frontend `PaywallPreview/utils.ts` `getDefaultDeviceForFormFactor`. */
+export function defaultDeviceFor(formFactor, platformType) {
+    if (formFactor === "television")
+        return "tv_1080p";
+    if (formFactor === "desktop")
+        return "desktop_1280x1024";
+    if (formFactor === "tablet")
+        return platformType === "google" ? "samsung_galaxy_tab_s9" : "ipadair_13";
+    if (platformType === "google")
+        return "google_pixel_678";
+    if (platformType === "web")
+        return "iphone16_chrome";
+    return "iphone16";
+}
+const preset = (label, formFactor, platformType) => ({ label, formFactor, deviceId: defaultDeviceFor(formFactor, platformType) });
+/** Tier 1: the coarse choices a developer sees first, per platform type. */
+export const PRESETS = {
+    apple: [preset("iPhone", "phone", "apple"), preset("iPad", "tablet", "apple"), preset("Apple TV", "television", "apple")],
+    google: [preset("Android Phone", "phone", "google"), preset("Android Tablet", "tablet", "google"), preset("Android TV", "television", "google")],
+    amazon_iap: [preset("Fire TV", "television", "amazon_iap")],
+    roku_pay: [preset("Roku", "television", "roku_pay")],
+    web: [preset("Mobile", "phone", "web"), preset("Tablet", "tablet", "web"), preset("Desktop", "desktop", "web"), preset("TV", "television", "web")],
+};
+export const presetsFor = (platformType) => PRESETS[platformType] ?? [];
+/** Tier 2: every previewer device that fits the platform's form factors and family. */
+export function devicesFor(platformType) {
+    return PREVIEW_DEVICES.filter((d) => {
+        if (!platformCompatibleWithFormFactor(platformType, d.type))
+            return false;
+        if (d.type === "television")
+            return true;
+        if (platformType === "apple")
+            return d.os === "apple";
+        if (platformType === "google")
+            return d.os === "google";
+        if (platformType === "web")
+            return d.os === "web" || d.type === "desktop";
+        return false;
+    });
+}
+/** id → preset label → display name (exact, then unique substring) — else ResolveError. */
+export function resolveDevice(platformType, query) {
+    const q = query.trim();
+    const candidates = devicesFor(platformType);
+    const byId = candidates.find((d) => d.id === q);
+    if (byId)
+        return byId;
+    const byPreset = presetsFor(platformType).find((p) => p.label.toLowerCase() === q.toLowerCase());
+    if (byPreset)
+        return PREVIEW_DEVICE_BY_ID.get(byPreset.deviceId);
+    const hit = resolve(candidates.map((d) => ({ id: d.id, name: d.displayName })), q, "device");
+    return PREVIEW_DEVICE_BY_ID.get(hit.id);
+}
+const BROWSER_LABEL = { safari: "Safari", apple_chrome: "Chrome", google_chrome: "Chrome" };
+/** Human OS label for the device payload, from the device and the platform it is used with. */
+export function deviceOs(device, platformType) {
+    if (device.type === "television") {
+        return { apple: "tvOS", google: "Android TV", amazon_iap: "Fire OS", roku_pay: "Roku OS" }[platformType] ?? "Web";
+    }
+    if (platformType === "web" || device.os === "web")
+        return device.browser ? BROWSER_LABEL[device.browser] ?? "Web" : "Web";
+    if (device.os === "apple")
+        return device.type === "tablet" ? "iPadOS" : "iOS";
+    if (device.os === "google")
+        return "Android";
+    return "Web";
+}
+export const toSelection = (device) => ({ id: device.id, displayName: device.displayName, formFactor: device.type });
+export const deviceById = (id) => PREVIEW_DEVICE_BY_ID.get(id);

package/dist/devices/table.js

@@ -0,0 +1,59 @@
+/**
+ * GENERATED — do not hand-edit.
+ *
+ * Copied from nami-platform: services/frontend/src/api/types/device.types.ts
+ * (`PreviewDeviceMeta`), the Control Center previewer's device list. Extracted 2026-09-22.
+ * Regenerate by re-running the extraction in NAM-4505's plan; `tests/unit/devices/presets.test.ts`
+ * enforces the platform/form-factor compatibility rule over every entry.
+ */
+export const PREVIEW_DEVICES = [
+    { id: "desktop_1920x1080", type: "desktop", os: null, brand: null, browser: null, displayName: "Desktop", width: 1920, height: 1080, tvQuality: null },
+    { id: "desktop_1440x900", type: "desktop", os: null, brand: null, browser: null, displayName: "Laptop Lg", width: 1440, height: 900, tvQuality: null },
+    { id: "desktop_1280x1024", type: "desktop", os: null, brand: null, browser: null, displayName: "Laptop Md", width: 1280, height: 1024, tvQuality: null },
+    { id: "desktop_1024x768", type: "desktop", os: null, brand: null, browser: null, displayName: "Laptop Sm", width: 1024, height: 768, tvQuality: null },
+    { id: "tv_4k", type: "television", os: null, brand: null, browser: null, displayName: "4K TV", width: 3840, height: 2160, tvQuality: "4k" },
+    { id: "tv_1080p", type: "television", os: null, brand: null, browser: null, displayName: "1080p TV", width: 1920, height: 1080, tvQuality: "1080p" },
+    { id: "tv_720p", type: "television", os: null, brand: null, browser: null, displayName: "720p TV", width: 1280, height: 720, tvQuality: "720p" },
+    { id: "iphone16", type: "phone", os: "apple", brand: null, browser: null, displayName: "iPhone 16", width: 393, height: 852, tvQuality: null },
+    { id: "iphone16_chrome", type: "phone", os: "web", brand: null, browser: "apple_chrome", displayName: "Chrome on iPhone 16", width: 393, height: 852, tvQuality: null },
+    { id: "iphone16_safari", type: "phone", os: "web", brand: null, browser: "safari", displayName: "Safari on iPhone 16", width: 393, height: 852, tvQuality: null },
+    { id: "iphone16_pro", type: "phone", os: "apple", brand: null, browser: null, displayName: "iPhone 16 Pro", width: 402, height: 874, tvQuality: null },
+    { id: "iphone16_plus", type: "phone", os: "apple", brand: null, browser: null, displayName: "iPhone 16 Plus", width: 430, height: 932, tvQuality: null },
+    { id: "iphone16_plus_safari", type: "phone", os: "web", brand: null, browser: "safari", displayName: "Safari on iPhone 16 Plus", width: 430, height: 932, tvQuality: null },
+    { id: "iphone16_plus_chrome", type: "phone", os: "web", brand: null, browser: "apple_chrome", displayName: "Chrome on iPhone 16 Plus", width: 430, height: 932, tvQuality: null },
+    { id: "iphone16_pro_max", type: "phone", os: "apple", brand: null, browser: null, displayName: "iPhone 16 Pro Max", width: 440, height: 956, tvQuality: null },
+    { id: "iphone16_pro_max_chrome", type: "phone", os: "web", brand: null, browser: "apple_chrome", displayName: "Chrome on iPhone 16 Pro Max", width: 440, height: 956, tvQuality: null },
+    { id: "iphone16_pro_max_safari", type: "phone", os: "web", brand: null, browser: "safari", displayName: "Safari on iPhone 16 Pro Max", width: 440, height: 956, tvQuality: null },
+    { id: "iphone15", type: "phone", os: "apple", brand: null, browser: null, displayName: "iPhone 15", width: 390, height: 844, tvQuality: null },
+    { id: "iphone1415_pro", type: "phone", os: "apple", brand: null, browser: null, displayName: "iPhone 15 Pro", width: 393, height: 852, tvQuality: null },
+    { id: "iphone1415_pro_max", type: "phone", os: "apple", brand: null, browser: null, displayName: "iPhone 15 Pro Max", width: 430, height: 932, tvQuality: null },
+    { id: "iphone121314", type: "phone", os: "apple", brand: null, browser: null, displayName: "iPhone 14", width: 390, height: 844, tvQuality: null },
+    { id: "iphone121314_chrome", type: "phone", os: "web", brand: null, browser: "apple_chrome", displayName: "Chrome on iPhone 14", width: 390, height: 844, tvQuality: null },
+    { id: "iphone121314_safari", type: "phone", os: "web", brand: null, browser: "safari", displayName: "Safari on iPhone 14", width: 390, height: 844, tvQuality: null },
+    { id: "iphone1213_pro_max", type: "phone", os: "apple", brand: null, browser: null, displayName: "iPhone 13 Pro Max", width: 428, height: 926, tvQuality: null },
+    { id: "iphone1213_mini", type: "phone", os: "apple", brand: null, browser: null, displayName: "iPhone 13 Mini", width: 375, height: 812, tvQuality: null },
+    { id: "iphone1213_mini_chrome", type: "phone", os: "web", brand: null, browser: "apple_chrome", displayName: "Chrome on iPhone 13 Mini", width: 375, height: 812, tvQuality: null },
+    { id: "iphone1213_mini_safari", type: "phone", os: "web", brand: null, browser: "safari", displayName: "Safari on iPhone 13 Mini", width: 375, height: 812, tvQuality: null },
+    { id: "samsung_galaxy_s22", type: "phone", os: "google", brand: "samsung", browser: null, displayName: "Samsung Galaxy S22", width: 360, height: 780, tvQuality: null },
+    { id: "samsung_galaxy_s22_chrome", type: "phone", os: "web", brand: "samsung", browser: "google_chrome", displayName: "Chrome on Samsung Galaxy S22", width: 360, height: 780, tvQuality: null },
+    { id: "samsung_galaxy_s22_ultra", type: "phone", os: "google", brand: "samsung", browser: null, displayName: "Samsung Galaxy S22 Ultra", width: 384, height: 824, tvQuality: null },
+    { id: "samsung_galaxy_s22_ultra_chrome", type: "phone", os: "web", brand: "samsung", browser: "google_chrome", displayName: "Chrome on Samsung Galaxy S22 Ultra", width: 384, height: 824, tvQuality: null },
+    { id: "samsung_galaxy_s2021", type: "phone", os: "google", brand: "samsung", browser: null, displayName: "Samsung Galaxy S21", width: 360, height: 800, tvQuality: null },
+    { id: "samsung_galaxy_s2021_plus", type: "phone", os: "google", brand: "samsung", browser: null, displayName: "Samsung Galaxy S21 Plus", width: 384, height: 854, tvQuality: null },
+    { id: "samsung_galaxy_s2021_ultra", type: "phone", os: "google", brand: "samsung", browser: null, displayName: "Samsung Galaxy S21 Ultra", width: 412, height: 915, tvQuality: null },
+    { id: "samsung_galaxy_s9", type: "phone", os: "google", brand: "samsung", browser: null, displayName: "Samsung Galaxy S9", width: 360, height: 740, tvQuality: null },
+    { id: "google_pixel_678", type: "phone", os: "google", brand: "google", browser: null, displayName: "Google Pixel 9", width: 412, height: 915, tvQuality: null },
+    { id: "google_pixel_678_chrome", type: "phone", os: "web", brand: "google", browser: "google_chrome", displayName: "Chrome on Google Pixel 9", width: 412, height: 915, tvQuality: null },
+    { id: "google_pixel_8_pro", type: "phone", os: "google", brand: "google", browser: null, displayName: "Google Pixel 9 Pro", width: 448, height: 998, tvQuality: null },
+    { id: "google_pixel_8_pro_chrome", type: "phone", os: "web", brand: "google", browser: "google_chrome", displayName: "Chrome on Pixel 9 Pro", width: 448, height: 998, tvQuality: null },
+    { id: "google_pixel_67_pro", type: "phone", os: "google", brand: "google", browser: null, displayName: "Google Pixel 7 Pro", width: 412, height: 892, tvQuality: null },
+    { id: "google_pixel_5", type: "phone", os: "google", brand: "google", browser: null, displayName: "Google Pixel 5", width: 393, height: 851, tvQuality: null },
+    { id: "google_pixel_3", type: "phone", os: "google", brand: null, browser: null, displayName: "Google Pixel 3", width: 394, height: 786, tvQuality: null },
+    { id: "ipadair_13", type: "tablet", os: "apple", brand: null, browser: null, displayName: "iPad Air 13 2025", width: 1024, height: 1366, tvQuality: null },
+    { id: "ipadair_11", type: "tablet", os: "apple", brand: null, browser: null, displayName: "iPad Air 11 2026", width: 820, height: 1180, tvQuality: null },
+    { id: "ipadpro_13", type: "tablet", os: "apple", brand: null, browser: null, displayName: "iPad Pro 13 2025", width: 1024, height: 1366, tvQuality: null },
+    { id: "ipadmini_2021", type: "tablet", os: "apple", brand: null, browser: null, displayName: "iPad Mini 2021", width: 744, height: 1059, tvQuality: null },
+    { id: "samsung_galaxy_tab_s9", type: "tablet", os: "google", brand: "samsung", browser: null, displayName: "Samsung Galaxy Tab S9", width: 753, height: 1204, tvQuality: null },
+    { id: "samsung_galaxy_a9plus", type: "tablet", os: "google", brand: "samsung", browser: null, displayName: "Samsung Galaxy Tab A9 Plus", width: 800, height: 1280, tvQuality: null },
+];
+export const PREVIEW_DEVICE_BY_ID = new Map(PREVIEW_DEVICES.map((d) => [d.id, d]));

package/dist/program.js

@@ -19,6 +19,7 @@ export function createProgram(h, options = {}) {
         .option(HOST_FLAG, HOST_HELP)
         .option("--app <id-or-name>", "skip the app picker")
         .option("--platform <id-or-name>", "skip the platform picker")
+        .option("--device <id-or-name>", "skip the device picker (preset label, previewer id or name)")
         .action(async (_opts, cmd) => {
         const opts = cmd.optsWithGlobals();
         process.exitCode = await h.shell(opts);
@@ -72,10 +73,20 @@ export function createProgram(h, options = {}) {
         .description("Verify an App Platform ID and configure the SDK against it (headless).")
         .requiredOption("--app-platform-id <uuid>", "the App Platform ID (nami platforms shows it)")
         .option(HOST_FLAG, HOST_HELP)
+        .option("--platform-type <type>", "apple | google | amazon_iap | roku_pay | web — selects the device family (default preset when --device is omitted)")
+        .option("--device <id-or-name>", "target device: preset label (iPad), previewer id (ipadair_13) or name; needs --platform-type")
         .option("--json", "machine-readable result")
         .action(async (_opts, cmd) => {
         process.exitCode = await h.configure(cmd.optsWithGlobals());
     });
+    program
+        .command("devices")
+        .description("List the target device presets and the full previewer device list for a platform type.")
+        .requiredOption("--platform-type <type>", "apple | google | amazon_iap | roku_pay | web")
+        .option("--json", "machine-readable output")
+        .action(async (_opts, cmd) => {
+        process.exitCode = await h.devices(cmd.optsWithGlobals());
+    });
     program
         .command("config")
         .description("Show the persisted CLI state (host, org, current app/platform, recent, onboarding). Never contains secrets.")

package/dist/screens/ConfigureScreen.js

@@ -6,12 +6,12 @@ import { palette } from "../theme.js";
 import { configureSdk } from "../sdk/configure.js";
 import { SDK_DISABLED_MESSAGE, verifyAppPlatform } from "../sdk/verify.js";
 /** Verify → (warn if the SDK is disabled) → configure. Every failure names the next action. */
-export function ConfigureScreen({ host, appPlatformId, onDone, onBack, verify = verifyAppPlatform, configure = configureSdk, phase }) {
+export function ConfigureScreen({ host, appPlatformId, device, onDone, onBack, verify = verifyAppPlatform, configure = configureSdk, phase }) {
     const [state, setState] = useState({ kind: "verifying" });
     const run = async (verified) => {
         setState({ kind: "configuring" });
         try {
-            onDone(await configure({ host, appPlatformId }, { verified }));
+            onDone(await configure({ host, appPlatformId, device }, { verified }));
         }
         catch (error) {
             setState({ kind: "failed", message: error instanceof Error ? error.message : String(error) });

package/dist/screens/PickDevice.js

@@ -0,0 +1,29 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useState } from "react";
+import { SelectList } from "../components/SelectList.js";
+import { deviceById, devicesFor, presetsFor } from "../devices/presets.js";
+const MORE = "__more__";
+const size = (d) => `${d.width}×${d.height}`;
+/**
+ * Tier 1: the platform's coarse presets (iPhone / iPad / Apple TV …).
+ * Tier 2 ("More devices…"): every previewer device that fits the platform.
+ */
+export function PickDevice({ platformType, platformName, currentDeviceId, onSelect, onCancel }) {
+    const [mode, setMode] = useState("presets");
+    const all = devicesFor(platformType);
+    if (mode === "all") {
+        return (_jsx(SelectList, { title: `Devices for ${platformName}`, items: all.map((d) => ({ key: d.id, label: d.displayName, badge: d.type, hint: size(d) })), initialKey: currentDeviceId, onSelect: (key) => { const d = deviceById(key); if (d)
+                onSelect(d); }, onCancel: () => setMode("presets"), footer: "\u2191/\u2193 move \u00B7 Enter select \u00B7 type to filter \u00B7 Esc back to presets" }, "all"));
+    }
+    const presets = presetsFor(platformType);
+    return (_jsx(SelectList, { title: `Target device for ${platformName}`, items: [
+            ...presets.map((p) => { const d = deviceById(p.deviceId); return { key: p.deviceId, label: p.label, hint: d ? `${d.displayName} · ${size(d)}` : undefined }; }),
+            { key: MORE, label: "More devices…", hint: `${all.length} previewer devices` },
+        ], initialKey: currentDeviceId && presets.some((p) => p.deviceId === currentDeviceId) ? currentDeviceId : undefined, onSelect: (key) => {
+            if (key === MORE)
+                return setMode("all");
+            const d = deviceById(key);
+            if (d)
+                onSelect(d);
+        }, onCancel: onCancel }, "presets"));
+}

package/dist/screens/SelectionHeader.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from "ink";
 import { palette } from "../theme.js";
 /** One-line context bar: `org / app / platform (type)`. Always visible in the shell. */
-export function SelectionHeader({ orgName, appName, platformName, platformType, host }) {
+export function SelectionHeader({ orgName, appName, platformName, platformType, deviceName, host }) {
     const parts = [orgName, appName, platformName ? `${platformName}${platformType ? ` (${platformType})` : ""}` : null].filter(Boolean);
-    return (_jsxs(Box, { children: [_jsx(Text, { bold: true, color: palette.aqua, children: "nami" }), _jsx(Text, { dimColor: true, children: "  " }), _jsx(Text, { children: parts.join(" / ") || "not signed in" }), host && host !== "production" && _jsxs(Text, { dimColor: true, children: ["  [", host, "]"] })] }));
+    return (_jsxs(Box, { children: [_jsx(Text, { bold: true, color: palette.aqua, children: "nami" }), _jsx(Text, { dimColor: true, children: "  " }), _jsx(Text, { children: parts.join(" / ") || "not signed in" }), deviceName && _jsxs(Text, { dimColor: true, children: [" \u00B7 ", deviceName] }), host && host !== "production" && _jsxs(Text, { dimColor: true, children: ["  [", host, "]"] })] }));
 }

package/dist/screens/Shell.js

@@ -4,6 +4,8 @@ import { Box, Text, useApp, useInput } from "ink";
 import { LoginFlow } from "./LoginFlow.js";
 import { PickApp } from "./PickApp.js";
 import { PickPlatform } from "./PickPlatform.js";
+import { PickDevice } from "./PickDevice.js";
+import { deviceById, presetsFor, resolveDevice, toSelection } from "../devices/presets.js";
 import { SelectionHeader } from "./SelectionHeader.js";
 import { Thinking } from "../components/Thinking.js";
 import { palette } from "../theme.js";
@@ -18,13 +20,13 @@ import { appFrom, platformFrom, selectionFrom } from "../config/selection.js";
  * Selection is in-memory for now (persistence: NAM-4501; configure: NAM-4500;
  * full Switch with Recent/org switching: NAM-4503).
  */
-export function Shell({ ctx, appQuery, platformQuery, onExit, exitWhenDone = true, phase, verify, configure }) {
+export function Shell({ ctx, appQuery, platformQuery, deviceQuery, onExit, exitWhenDone = true, phase, verify, configure }) {
     const { exit } = useApp();
     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 });
+    const [queries, setQueries] = useState({ app: appQuery, platform: platformQuery, device: deviceQuery });
     const finish = (code) => {
         onExit?.(code);
         if (exitWhenDone)
@@ -38,6 +40,27 @@ export function Shell({ ctx, appQuery, platformQuery, onExit, exitWhenDone = tru
             return fatal(error.message, 2);
         fatal(error instanceof Error ? error.message : String(error));
     };
+    /** After a platform is chosen: --device → resolve; single preset (Roku, Fire TV) → auto; else ask. */
+    const chooseDevice = (app, platform, current) => {
+        if (queries.device) {
+            try {
+                const device = resolveDevice(platform.type, queries.device);
+                setQueries((q) => ({ ...q, device: undefined }));
+                step("configure");
+                return setState({ kind: "configure", app, platform, device });
+            }
+            catch (error) {
+                return handleError(error);
+            }
+        }
+        const presets = presetsFor(platform.type);
+        if (presets.length <= 1) {
+            const device = presets[0] ? deviceById(presets[0].deviceId) ?? null : null;
+            step("configure");
+            return setState({ kind: "configure", app, platform, device });
+        }
+        setState({ kind: "pick-device", app, platform, current });
+    };
     const loadApps = async (current) => {
         setState({ kind: "busy", label: "Loading your apps…" });
         try {
@@ -61,7 +84,7 @@ export function Shell({ ctx, appQuery, platformQuery, onExit, exitWhenDone = tru
             if (queries.platform) {
                 const platform = findPlatform(platforms, queries.platform);
                 setQueries((q) => ({ ...q, platform: undefined }));
-                return setState({ kind: "configure", app, platform });
+                return chooseDevice(app, platform);
             }
             step("pick-platform");
             setState({ kind: "pick-platform", app, platforms, current });
@@ -83,8 +106,12 @@ export function Shell({ ctx, appQuery, platformQuery, onExit, exitWhenDone = tru
             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);
+                const stored = config.current.device ? deviceById(config.current.device.id) : undefined;
+                const fallback = presetsFor(platform.type)[0];
+                const device = stored ?? (fallback ? deviceById(fallback.deviceId) ?? null : null);
                 step("configure");
-                return setState({ kind: "configure", app: appFrom(config.current), platform: platformFrom(config.current) });
+                return setState({ kind: "configure", app: appFrom(config.current), platform, device });
             }
             await loadApps();
         })();
@@ -102,13 +129,15 @@ export function Shell({ ctx, appQuery, platformQuery, onExit, exitWhenDone = tru
             return void loadApps(state.app);
         if (input === "p")
             return void loadPlatforms(state.app, state.platform);
+        if (input === "d" && presetsFor(state.platform.type).length > 1)
+            return setState({ kind: "pick-device", app: state.app, platform: state.platform, current: state.device ?? undefined });
     }, { isActive: state.kind === "home" });
-    const header = (_jsx(SelectionHeader, { orgName: orgName, appName: "app" in state ? state.app.name : undefined, platformName: "platform" in state ? state.platform.name : undefined, platformType: "platform" in state ? state.platform.typeLabel : undefined, 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) => { step("configure"); setState({ kind: "configure", app: state.app, platform }); }, onCancel: () => void loadApps(state.app) })), state.kind === "configure" && (_jsx(ConfigureScreen, { host: ctx.host, appPlatformId: state.platform.id, phase: phase, verify: verify, configure: configure, onDone: (result) => {
+    const header = (_jsx(SelectionHeader, { orgName: orgName, appName: "app" in state ? state.app.name : undefined, platformName: "platform" in state ? state.platform.name : undefined, platformType: "platform" in state ? state.platform.typeLabel : undefined, deviceName: "device" in state ? state.device?.displayName : undefined, 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
-                                .setCurrent(selectionFrom(state.app, state.platform), { host: ctx.host.name, session: { orgId, orgName } })
+                                .setCurrent(selectionFrom(state.app, state.platform, state.device ? toSelection(state.device) : null), { host: ctx.host.name, session: { orgId, orgName } })
                                 .then(() => ctx.config.markOnboardingDone())
                                 .catch(() => { });
-                            setState({ kind: "home", app: state.app, platform: state.platform, result });
-                        }, onBack: () => void loadPlatforms(state.app, state.platform) })), state.kind === "home" && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "column", borderStyle: "round", paddingX: 1, children: [_jsxs(Text, { bold: true, children: [state.app.name, " \u00B7 ", state.platform.name, " ", _jsxs(Text, { color: palette.secondaryBlue, children: ["[", state.platform.typeLabel, "]"] })] }), _jsxs(Text, { children: ["App Platform ID: ", _jsx(Text, { color: palette.aqua, children: state.platform.id })] }), _jsxs(Text, { children: [state.result.sdkEnabled ? "SDK enabled" : "SDK disabled", " \u00B7 ", state.result.configureState, state.result.deviceId ? ` · device ${state.result.deviceId}` : ""] }), _jsxs(Text, { children: ["placements ", _jsx(Text, { bold: true, children: state.result.counts.placements }), " \u00B7 products ", _jsx(Text, { bold: true, children: state.result.counts.products }), " \u00B7 paywalls ", _jsx(Text, { bold: true, children: state.result.counts.paywalls })] }), _jsx(Text, { dimColor: true, children: "Launch a placement lands in NAM-4502." })] }), _jsx(Text, { dimColor: true, children: "s switch app \u00B7 p switch platform \u00B7 q quit" })] })), state.kind === "fatal" && _jsx(Text, { color: palette.coral, children: state.message })] })] }));
+                            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" && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "column", borderStyle: "round", paddingX: 1, children: [_jsxs(Text, { bold: true, children: [state.app.name, " \u00B7 ", state.platform.name, " ", _jsxs(Text, { color: palette.secondaryBlue, children: ["[", state.platform.typeLabel, "]"] })] }), _jsxs(Text, { children: ["App Platform ID: ", _jsx(Text, { color: palette.aqua, children: state.platform.id })] }), state.device && _jsxs(Text, { children: ["Device: ", state.device.displayName, " ", _jsxs(Text, { dimColor: true, children: ["(", state.device.type, ", ", state.device.width, "\u00D7", state.device.height, ")"] })] }), _jsxs(Text, { children: [state.result.sdkEnabled ? "SDK enabled" : "SDK disabled", " \u00B7 ", state.result.configureState, state.result.deviceId ? ` · device ${state.result.deviceId}` : ""] }), _jsxs(Text, { children: ["placements ", _jsx(Text, { bold: true, children: state.result.counts.placements }), " \u00B7 products ", _jsx(Text, { bold: true, children: state.result.counts.products }), " \u00B7 paywalls ", _jsx(Text, { bold: true, children: state.result.counts.paywalls })] }), _jsx(Text, { dimColor: true, children: "Launch a placement lands in NAM-4502." })] }), _jsxs(Text, { dimColor: true, children: ["s switch app \u00B7 p switch platform", presetsFor(state.platform.type).length > 1 ? " · d switch device" : "", " \u00B7 q quit"] })] })), state.kind === "fatal" && _jsx(Text, { color: palette.coral, children: state.message })] })] }));
 }

package/dist/sdk/configure.js

@@ -3,6 +3,7 @@ import { registerTerminalAdapters } from "../adapters/index.js";
 import { FileStorageAdapter, storagePathFor } from "../adapters/file-storage.adapter.js";
 import { configDir } from "../paths.js";
 import { verifyAppPlatform } from "./verify.js";
+import { deviceById, presetsFor, resolveDevice, toSelection } from "../devices/presets.js";
 let activeStorage = null;
 let configuredOnce = false;
 /** The storage adapter registered by the last configureSdk() call (tests/inspection). */
@@ -15,12 +16,13 @@ export const currentStorage = () => activeStorage;
 export async function configureSdk(input, deps = {}) {
     const fetchImpl = deps.fetch ?? globalThis.fetch;
     const verified = deps.verified ?? (await verifyAppPlatform(input.host.baseUrl, input.appPlatformId, fetchImpl));
-    const storagePath = storagePathFor(input.appPlatformId, deps.configDir ?? configDir());
+    const preset = resolvePreset(input.device);
+    const storagePath = storagePathFor(input.appPlatformId, deps.configDir ?? configDir(), preset?.device.id);
     if (configuredOnce)
         await Nami.reset();
     activeStorage?.dispose();
     activeStorage = new FileStorageAdapter(storagePath);
-    registerTerminalAdapters({ storage: activeStorage });
+    registerTerminalAdapters({ storage: activeStorage, device: preset ?? undefined });
     const namiCommands = input.host.name === "staging" ? ["useStagingAPI"] : [];
     const state = await Nami.configure({ appPlatformID: input.appPlatformId, namiCommands, logLevel: input.logLevel ?? "warn" });
     configuredOnce = true;
@@ -38,8 +40,20 @@ export async function configureSdk(input, deps = {}) {
         },
         deviceId: safeDeviceId(),
         storagePath,
+        device: preset ? toSelection(preset.device) : null,
     };
 }
+/** Pick the preset: explicit id/label/name, else the platform's first preset (phone or TV). */
+function resolvePreset(input) {
+    if (!input)
+        return null;
+    const { platformType, id } = input;
+    if (id)
+        return { device: resolveDevice(platformType, id), platformType };
+    const first = presetsFor(platformType)[0];
+    const device = first ? deviceById(first.deviceId) : undefined;
+    return device ? { device, platformType } : null;
+}
 function safeCount(read) {
     try {
         return read();

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.202609221916";
+export const NAMI_CLI_VERSION = "3.4.11-dev.202609222222";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@namiml/cli",
-  "version": "3.4.11-dev.202609221916",
+  "version": "3.4.11-dev.202609222222",
   "description": "Nami SDK developer CLI — terminal test app, implementation and flow checks",
   "keywords": [
     "nami",
@@ -27,14 +27,15 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/namiml/nami-cli.git"
+    "url": "https://github.com/namiml/nami-releases.git",
+    "directory": "cli"
   },
   "homepage": "https://www.namiml.com",
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@namiml/sdk-core": "3.4.11-dev.202609221916",
+    "@namiml/sdk-core": "3.4.11-dev.202609222222",
     "commander": "^15",
     "env-paths": "^4",
     "ink": "^6.0.0",