@putdotio/taizn 1.2.0 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +30 -1
  2. package/dist/taizn.mjs +987 -260
  3. package/docs/DISTRIBUTION.md +54 -0
  4. package/docs/TV_REMOTE.md +70 -0
  5. package/package.json +10 -9
package/README.md CHANGED
@@ -31,6 +31,7 @@ Create `taizn.json` in the app directory, keep `.taizn/` ignored, then run:
31
31
  pnpm exec taizn check
32
32
  pnpm exec taizn package
33
33
  pnpm exec taizn install
34
+ pnpm exec taizn run
34
35
  ```
35
36
 
36
37
  Project files:
@@ -38,23 +39,37 @@ Project files:
38
39
  - `taizn.json`: app build, widget, signing, and variant config
39
40
  - `.taizn/.env`: optional local secrets read by Node
40
41
  - `.taizn/certificates/`: optional local author/distributor certs for `taizn profile`
42
+ - `.taizn/remote.json`: optional paired Samsung TV remote token
41
43
  - `.taizn/build/`: generated package staging and output
42
44
 
43
45
  ## Commands
44
46
 
45
47
  ```bash
46
48
  taizn check
49
+ taizn apps
50
+ taizn apps put
47
51
  taizn profile
48
52
  taizn package
49
53
  taizn install
54
+ taizn run
55
+ taizn tv info
56
+ taizn tv pair
57
+ taizn tv press KEY_ENTER
58
+ taizn tv press --delay-ms 250 KEY_HOME KEY_DOWN KEY_ENTER
50
59
  taizn --version
51
60
  ```
52
61
 
53
62
  `check` verifies the configured Tizen CLI and `sdb`, then prints connected
54
- targets without requiring `taizn.json`. `profile` imports
63
+ targets without requiring `taizn.json`. `apps` lists installed applications on
64
+ the target, with an optional query filter. `profile` imports
55
65
  `.taizn/certificates/author.p12` and
56
66
  `.taizn/certificates/distributor.p12` into a Tizen security profile.
57
67
  `package` builds and signs a `.wgt`. `install` packages and sideloads it.
68
+ `run` launches the configured variant application on the target. `tv` commands use
69
+ Samsung's websocket remote-control API to inspect a TV,
70
+ pair for a remote token, and send remote-control key presses. See
71
+ [Samsung TV Remote](./docs/TV_REMOTE.md) for pairing, environment, and limits.
72
+ `tv press` accepts one key or a sequence of keys.
58
73
 
59
74
  ## Environment
60
75
 
@@ -68,8 +83,20 @@ TAIZN_VARIANT=development
68
83
  TAIZN_TARGET=<tv-ip>:26101
69
84
  TAIZN_TIZEN_CLI=~/tizen-studio/tools/ide/bin/tizen
70
85
  TAIZN_SDB=~/tizen-studio/tools/sdb
86
+ TAIZN_TV_HOST=<tv-ip>
87
+ TAIZN_TV_INFO_PORT=8001
88
+ TAIZN_TV_NAME=taizn
89
+ TAIZN_TV_PORT=8002
90
+ TAIZN_TV_PROTOCOL=wss
91
+ TAIZN_TV_TIMEOUT_MS=30000
92
+ TAIZN_TV_TOKEN=<paired-remote-token>
71
93
  ```
72
94
 
95
+ `taizn tv` uses `TAIZN_TV_HOST`, or the host part of `TAIZN_TARGET` when no TV
96
+ host is set. `TAIZN_TV_INFO_PORT` controls the HTTP metadata endpoint; the
97
+ remote-control websocket still uses `TAIZN_TV_PORT`. `taizn tv pair` writes the
98
+ paired remote token to `.taizn/remote.json`; keep `.taizn/` ignored.
99
+
73
100
  ## Config
74
101
 
75
102
  ```json
@@ -122,11 +149,13 @@ bundle local app assets but production packages should load hosted asset URLs.
122
149
 
123
150
  - [Contributing](./CONTRIBUTING.md)
124
151
  - [Distribution](./docs/DISTRIBUTION.md)
152
+ - [Samsung TV Remote](./docs/TV_REMOTE.md)
125
153
  - [Security](./SECURITY.md)
126
154
 
127
155
  ## Repo Internals
128
156
 
129
157
  - [Agent guide](./AGENTS.md)
158
+ - Effect source for local API research lives in ignored `.repos/effect`; dependency installs bootstrap it outside CI.
130
159
 
131
160
  ## Contributing
132
161