@putdotio/taizn 1.10.0 → 1.12.0

package/README.md

@@ -58,8 +58,10 @@ taizn package
 taizn install
 taizn run
 taizn tv info
+taizn tv info --json
 taizn tv pair
 taizn tv press KEY_ENTER
+taizn tv press --json KEY_ENTER
 taizn tv press --delay-ms 250 KEY_HOME KEY_DOWN KEY_ENTER
 taizn --version
 ```
@@ -78,7 +80,9 @@ proof output. `profile` imports
 `package` builds and signs a `.wgt`. `install` packages and sideloads it.
 `run` launches the configured variant application on the target. `tv` commands use
 Samsung's websocket remote-control API to inspect a TV,
-pair for a remote token, and send remote-control key presses. See
+pair for a remote token, and send remote-control key presses. Add `--json` to
+`tv info` for a structured TV capability snapshot, or to `tv press` for a
+structured key-sequence receipt. See
 [Samsung TV Remote](./docs/TV_REMOTE.md) for pairing, environment, and limits.
 `tv press` accepts one key or a sequence of keys.
 

package/dist/taizn.mjs

@@ -461,20 +461,56 @@ Effect.fn("sendSamsungTvKey")(function* (env, key) {
 });
 const sendSamsungTvKeys = Effect.fn("sendSamsungTvKeys")(function* (env, keys, pressOptions) {
 	const remoteOptions = yield* resolveRemoteOptions(env, { requireToken: true });
-	if (!remoteOptions.token) return yield* MissingTvRemoteToken.make({});
+	const token = remoteOptions.token;
+	const delayMs = Math.max(0, pressOptions?.delayMs ?? 250);
+	if (!token) return yield* MissingTvRemoteToken.make({});
 	yield* connectRemote(remoteOptions, {
-		delayMs: Math.max(0, pressOptions?.delayMs ?? 250),
+		delayMs,
 		keys
 	});
+	if (pressOptions?.json) {
+		yield* Console.log(JSON.stringify({
+			delayMs,
+			keys,
+			keyCount: keys.length,
+			target: {
+				host: remoteOptions.host,
+				port: remoteOptions.port,
+				protocol: remoteOptions.protocol,
+				url: remoteTarget(remoteOptions)
+			}
+		}));
+		return;
+	}
 	yield* Console.log(keys.length === 1 ? `Sent Samsung TV remote key: ${keys[0]}` : `Sent Samsung TV remote keys: ${keys.join(", ")}`);
 });
-const showSamsungTvInfo = Effect.fn("showSamsungTvInfo")(function* (env) {
+const showSamsungTvInfo = Effect.fn("showSamsungTvInfo")(function* (env, infoOptions = {}) {
 	const options = yield* resolveRemoteOptions(env);
 	const info = yield* fetchSamsungTvInfo(options.host, {
 		port: env.tvInfoPort,
 		timeoutMs: options.timeoutMs
 	});
 	const support = info.isSupport ? parseSupport(info.isSupport) : void 0;
+	if (infoOptions.json) {
+		yield* Console.log(JSON.stringify({
+			developer: {
+				enabled: stringFlag(info.device.developerMode),
+				ip: info.device.developerIP,
+				mode: info.device.developerMode
+			},
+			host: options.host,
+			infoPort: env.tvInfoPort ?? TV_INFO_PORT,
+			ip: info.device.ip ?? options.host,
+			model: info.device.modelName,
+			name: decodeHtml(info.name),
+			remote: info.remote,
+			remoteAvailable: stringFlag(support?.remote_available),
+			tokenAuth: stringFlag(info.device.TokenAuthSupport),
+			type: info.type,
+			uri: info.uri
+		}));
+		return;
+	}
 	yield* Console.log(`Samsung TV: ${decodeHtml(info.name)}`);
 	yield* Console.log(`model: ${info.device.modelName ?? "unknown"}`);
 	yield* Console.log(`ip: ${info.device.ip ?? options.host}`);
@@ -696,6 +732,11 @@ const hostFromTarget = (target) => {
 };
 const causeToMessage = (cause) => cause instanceof Error ? cause.message : String(cause);
 const decodeHtml = (value) => value.replaceAll(""", "\"").replaceAll("&", "&");
+const stringFlag = (value) => {
+	const normalized = value?.trim().toLowerCase();
+	if (normalized === "true" || normalized === "1") return true;
+	if (normalized === "false" || normalized === "0") return false;
+};
 //#endregion
 //#region src/xml.ts
 const escapeXml = (value) => value.replaceAll("&", "&amp;").replaceAll("\"", "&quot;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
@@ -1223,12 +1264,16 @@ const tvPair = Command.make("pair", {}, () => Effect.gen(function* () {
 }));
 const tvPress = Command.make("press", {
 	delayMs: Flag.integer("delay-ms").pipe(Flag.withDefault(250)),
+	json: Flag.boolean("json"),
 	keys: Argument.string("key").pipe(Argument.variadic({ min: 1 }))
-}, ({ delayMs, keys }) => Effect.gen(function* () {
-	yield* sendSamsungTvKeys(yield* loadEnv(), keys, { delayMs });
+}, ({ delayMs, json, keys }) => Effect.gen(function* () {
+	yield* sendSamsungTvKeys(yield* loadEnv(), keys, {
+		delayMs,
+		json
+	});
 }));
-const tvInfo = Command.make("info", {}, () => Effect.gen(function* () {
-	yield* showSamsungTvInfo(yield* loadEnv());
+const tvInfo = Command.make("info", { json: Flag.boolean("json") }, ({ json }) => Effect.gen(function* () {
+	yield* showSamsungTvInfo(yield* loadEnv(), { json });
 }));
 const tv = Command.make("tv", {}).pipe(Command.withSubcommands([
 	tvPair,

package/docs/TV_REMOTE.md

@@ -7,19 +7,23 @@ and smoke checks against a physical TV or monitor.
 
 ```bash
 taizn tv info
+taizn tv info --json
 taizn tv pair
 taizn tv press KEY_ENTER
+taizn tv press --json KEY_ENTER
 taizn tv press --delay-ms 250 KEY_HOME KEY_DOWN KEY_ENTER
 ```
 
 - `info` reads the TV's local `/api/v2/` metadata and reports remote-control
-  support.
+  support. Add `--json` to emit a structured TV capability snapshot for agents
+  and scripts.
 - `pair` opens a Samsung remote websocket and waits for the TV to approve the
   client. When pairing succeeds, it stores the token in `.taizn/remote.json`.
 - `press` reconnects with the paired token and sends a Samsung remote key such
   as `KEY_HOME`, `KEY_BACK`, `KEY_UP`, `KEY_DOWN`, `KEY_LEFT`, `KEY_RIGHT`, or
   `KEY_ENTER`. Pass multiple keys to send a navigation sequence on one
   websocket connection. `--delay-ms` controls the delay between sequence keys.
+  Add `--json` to emit a redacted receipt with the target, delay, and keys sent.
 
 ## Environment
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@putdotio/taizn",
-  "version": "1.10.0",
+  "version": "1.12.0",
   "description": "A tiny CLI companion for interacting with Tizen ecosystem.",
   "keywords": [
     "cli",