pterm 0.0.18 → 0.0.19

package/README.md

@@ -103,15 +103,16 @@ pterm stop start.js
 
 ## run
 
-Run a launcher. Equivalent to the user visiting a launcher page. Will run whichever script is the current default script.
+Run a launcher. Equivalent to the user visiting a launcher page. By default it will run whichever script is the current launcher default. If the launcher exposes no explicit default, you can provide repeated `--default` selectors and Pinokio will match the first selector that exists in the launcher's current menu state.
 
 ### syntax
 
 ```
-pterm run <launcher_path_or_uri> [--open]
+pterm run <launcher_path_or_uri> [--default <selector>]... [--open]
 ```
 
 - `--open`: (optional) open URL results in the browser. Default behavior is to print the URL to stdout without opening a browser.
+- `--default`: (optional, repeatable) ordered launcher action selector. Each selector is matched against the current launcher menu. Selectors use launcher `href` syntax such as `run.js`, `install.js`, or `run.js?mode=Default`.
 
 ### examples
 
@@ -133,6 +134,21 @@ Run from a launcher URI and auto-open the resulting URL in browser
 pterm run https://github.com/example/my-launcher --open
 ```
 
+Run a launcher with ordered fallback selectors when the launcher has no explicit default item
+
+```
+pterm run ~/pinokio/api/facefusion-pinokio.git \
+  --default 'run.js?mode=Default' \
+  --default run.js \
+  --default install.js
+```
+
+Launch a script directly with query parameters. Query parameters are passed through as script input automatically.
+
+```
+pterm start 'run.js?mode=Default'
+```
+
 ## search
 
 Search installed or available apps.

package/index.js

@@ -2,7 +2,12 @@
 const path = require('path')
 const yargs = require('yargs/yargs')
 const { hideBin } = require('yargs/helpers')
-const argv = yargs(hideBin(process.argv)).parse();
+const argv = yargs(hideBin(process.argv))
+  .option('default', {
+    type: 'string',
+    array: true
+  })
+  .parse();
 const Script = require('./script')
 const Util = require('./util')
 const script = new Script();
@@ -89,7 +94,7 @@ const isHttpUri = (value) => typeof value === "string" && /^https?:\/\//i.test(v
           })
         }
         while(true) {
-          let default_uri = await script.default_script(uri)
+          let default_uri = await script.default_script(uri, argv.default)
           if (default_uri) {
             if (path.isAbsolute(default_uri)) {
               await new Promise((resolve, reject) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pterm",
-  "version": "0.0.18",
+  "version": "0.0.19",
   "description": "",
   "main": "index.js",
   "bin": {

package/script.js

@@ -30,7 +30,7 @@ class Script {
 
     return cleanup; // call this to stop listening
   }
-  async default_script (uri) {
+  async default_script (uri, defaultSelectors) {
     const rpc = new RPC("ws://localhost:42000")
     const stop = () => {
       rpc.run({
@@ -55,6 +55,7 @@ class Script {
       rpc.run({
         uri,
         mode: "open",
+        default: Array.isArray(defaultSelectors) ? defaultSelectors : undefined,
         source: "pterm",
         client: {
           source: "pterm"