@mondaydotcomorg/z2h-cli 0.11.6 → 0.12.1

package/dist/commands/dev.d.ts

@@ -1,5 +1,6 @@
 export interface DevOptions {
     json?: boolean;
+    open?: boolean;
 }
 export declare function devCommand(opts?: DevOptions): Promise<void>;
 //# sourceMappingURL=dev.d.ts.map

package/dist/commands/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAKD,wBAAsB,UAAU,CAAC,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA0ErE"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAKD,wBAAsB,UAAU,CAAC,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA6ErE"}

package/dist/commands/dev.js

@@ -9,6 +9,7 @@ const util_logger = require('../util/logger.js');
 const shadow_prepare = require('../shadow/prepare.js');
 const shadow_consumerPkg = require('../shadow/consumer-pkg.js');
 const shadow_sync = require('../shadow/sync.js');
+const util_openBrowser = require('../util/open-browser.js');
 
 const _interopDefault = e => e && e.__esModule ? e : { default: e };
 
@@ -68,6 +69,9 @@ async function devCommand(opts = {}) {
                 port,
                 url,
             });
+            if (opts.open) {
+                void util_openBrowser.openInBrowser(url);
+            }
         }
     });
     // Only watch consumer package.json. Source changes flow through Vite's

package/dist/commands/generate-z2h-token.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-z2h-token.d.ts","sourceRoot":"","sources":["../../src/commands/generate-z2h-token.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,sBAAsB,yDAAyD,CAAC;AAC7F,eAAO,MAAM,mBAAmB,SAAU,CAAC;AAE3C,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAuED,wBAAsB,uBAAuB,CAAC,IAAI,GAAE,uBAA4B,GAAG,OAAO,CAAC,IAAI,CAAC,CA+B/F"}
+{"version":3,"file":"generate-z2h-token.d.ts","sourceRoot":"","sources":["../../src/commands/generate-z2h-token.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,sBAAsB,yDAAyD,CAAC;AAC7F,eAAO,MAAM,mBAAmB,SAAU,CAAC;AAE3C,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAwDD,wBAAsB,uBAAuB,CAAC,IAAI,GAAE,uBAA4B,GAAG,OAAO,CAAC,IAAI,CAAC,CA+B/F"}

package/dist/commands/generate-z2h-token.js

@@ -2,10 +2,10 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const readline = require('node:readline/promises');
 const node_process = require('node:process');
-const execa = require('execa');
 const util_logger = require('../util/logger.js');
 const util_auth_writeAuth = require('../util/auth/write-auth.js');
 const util_auth_loopbackServer = require('../util/auth/loopback-server.js');
+const util_openBrowser = require('../util/open-browser.js');
 
 const _interopDefault = e => e && e.__esModule ? e : { default: e };
 
@@ -13,19 +13,6 @@ const readline__default = /*#__PURE__*/_interopDefault(readline);
 
 const DEFAULT_TOKEN_PAGE_URL = 'https://bigbrain.me/bigbrain-vibe/generate-z2h-token';
 const LOOPBACK_TIMEOUT_MS = 120_000;
-function browserOpenCommand() {
-    switch (process.platform) {
-        case 'darwin':
-            return 'open';
-        case 'win32':
-            return 'start';
-        default:
-            return 'xdg-open';
-    }
-}
-async function openInBrowser(url) {
-    await execa.execa(browserOpenCommand(), [url], { stdio: 'ignore' });
-}
 async function promptForToken() {
     const rl = readline__default.default.createInterface({ input: node_process.stdin, output: node_process.stdout });
     try {
@@ -58,7 +45,7 @@ async function runLoopbackFlow(pageUrl) {
     util_logger.info('opening your browser to mint a Z2H deploy token');
     util_logger.info(`  ${fullUrl}`);
     try {
-        await openInBrowser(fullUrl);
+        await util_openBrowser.openInBrowser(fullUrl);
     }
     catch {
         util_logger.warn('could not auto-open the browser. please visit the URL above manually.');

package/dist/esm/commands/dev.d.ts

@@ -1,5 +1,6 @@
 export interface DevOptions {
     json?: boolean;
+    open?: boolean;
 }
 export declare function devCommand(opts?: DevOptions): Promise<void>;
 //# sourceMappingURL=dev.d.ts.map

package/dist/esm/commands/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/commands/dev.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAKD,wBAAsB,UAAU,CAAC,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA0ErE"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/commands/dev.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAKD,wBAAsB,UAAU,CAAC,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA6ErE"}

package/dist/esm/commands/dev.mjs

@@ -7,6 +7,7 @@ import { setOutputMode, info, output, warn, errorLog } from '../util/logger.mjs'
 import { prepareShadow } from '../shadow/prepare.mjs';
 import { ensureConsumerPkg } from '../shadow/consumer-pkg.mjs';
 import { syncShadow } from '../shadow/sync.mjs';
+import { openInBrowser } from '../util/open-browser.mjs';
 
 const TRIDENT_READY_PATTERN = /Server started at/i;
 // Should be run from the consumer app directory — uses process.cwd() to locate it.
@@ -61,6 +62,9 @@ async function devCommand(opts = {}) {
                 port,
                 url,
             });
+            if (opts.open) {
+                void openInBrowser(url);
+            }
         }
     });
     // Only watch consumer package.json. Source changes flow through Vite's

package/dist/esm/commands/generate-z2h-token.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-z2h-token.d.ts","sourceRoot":"","sources":["../../../src/commands/generate-z2h-token.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,sBAAsB,yDAAyD,CAAC;AAC7F,eAAO,MAAM,mBAAmB,SAAU,CAAC;AAE3C,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAuED,wBAAsB,uBAAuB,CAAC,IAAI,GAAE,uBAA4B,GAAG,OAAO,CAAC,IAAI,CAAC,CA+B/F"}
+{"version":3,"file":"generate-z2h-token.d.ts","sourceRoot":"","sources":["../../../src/commands/generate-z2h-token.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,sBAAsB,yDAAyD,CAAC;AAC7F,eAAO,MAAM,mBAAmB,SAAU,CAAC;AAE3C,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAwDD,wBAAsB,uBAAuB,CAAC,IAAI,GAAE,uBAA4B,GAAG,OAAO,CAAC,IAAI,CAAC,CA+B/F"}

package/dist/esm/commands/generate-z2h-token.mjs

@@ -1,25 +1,12 @@
 import readline from 'node:readline/promises';
 import { stdin, stdout } from 'node:process';
-import { execa } from 'execa';
 import { setOutputMode, warn, output, info } from '../util/logger.mjs';
 import { validateJwtPattern, writeZthAuth } from '../util/auth/write-auth.mjs';
 import { startLoopbackServer } from '../util/auth/loopback-server.mjs';
+import { openInBrowser } from '../util/open-browser.mjs';
 
 const DEFAULT_TOKEN_PAGE_URL = 'https://bigbrain.me/bigbrain-vibe/generate-z2h-token';
 const LOOPBACK_TIMEOUT_MS = 120_000;
-function browserOpenCommand() {
-    switch (process.platform) {
-        case 'darwin':
-            return 'open';
-        case 'win32':
-            return 'start';
-        default:
-            return 'xdg-open';
-    }
-}
-async function openInBrowser(url) {
-    await execa(browserOpenCommand(), [url], { stdio: 'ignore' });
-}
 async function promptForToken() {
     const rl = readline.createInterface({ input: stdin, output: stdout });
     try {

package/dist/esm/index.mjs

@@ -70,6 +70,7 @@ async function main() {
     program
         .command('dev')
         .description('Start the Trident dev server against .zth/ with native Vite HMR')
+        .option('--open', 'open the browser automatically when the dev server is ready')
         .option('--json', 'emit structured JSON on stdout')
         .action(async (opts) => {
         try {

package/dist/esm/util/open-browser.d.ts

@@ -0,0 +1,2 @@
+export declare function openInBrowser(url: string): Promise<void>;
+//# sourceMappingURL=open-browser.d.ts.map

package/dist/esm/util/open-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-browser.d.ts","sourceRoot":"","sources":["../../../src/util/open-browser.ts"],"names":[],"mappings":"AAcA,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI9D"}

package/dist/esm/util/open-browser.mjs

@@ -0,0 +1,20 @@
+import { execa } from 'execa';
+import { errorLog } from './logger.mjs';
+
+function browserOpenCommand() {
+    switch (process.platform) {
+        case 'darwin':
+            return 'open';
+        case 'win32':
+            return 'start';
+        default:
+            return 'xdg-open';
+    }
+}
+async function openInBrowser(url) {
+    await execa(browserOpenCommand(), [url], { stdio: 'ignore' }).catch(() => {
+        errorLog(`Failed to open browser for ${url}, open it manually.`);
+    });
+}
+
+export { openInBrowser };

package/dist/index.js

@@ -76,6 +76,7 @@ async function main() {
     program
         .command('dev')
         .description('Start the Trident dev server against .zth/ with native Vite HMR')
+        .option('--open', 'open the browser automatically when the dev server is ready')
         .option('--json', 'emit structured JSON on stdout')
         .action(async (opts) => {
         try {

package/dist/util/open-browser.d.ts

@@ -0,0 +1,2 @@
+export declare function openInBrowser(url: string): Promise<void>;
+//# sourceMappingURL=open-browser.d.ts.map

package/dist/util/open-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-browser.d.ts","sourceRoot":"","sources":["../../src/util/open-browser.ts"],"names":[],"mappings":"AAcA,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI9D"}

package/dist/util/open-browser.js

@@ -0,0 +1,22 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const execa = require('execa');
+const util_logger = require('./logger.js');
+
+function browserOpenCommand() {
+    switch (process.platform) {
+        case 'darwin':
+            return 'open';
+        case 'win32':
+            return 'start';
+        default:
+            return 'xdg-open';
+    }
+}
+async function openInBrowser(url) {
+    await execa.execa(browserOpenCommand(), [url], { stdio: 'ignore' }).catch(() => {
+        util_logger.errorLog(`Failed to open browser for ${url}, open it manually.`);
+    });
+}
+
+exports.openInBrowser = openInBrowser;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mondaydotcomorg/z2h-cli",
-  "version": "0.11.6",
+  "version": "0.12.1",
   "bin": "./bin/z2h-cli.js",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/commands/dev.ts

@@ -7,10 +7,12 @@ import { info, warn, errorLog, output, setOutputMode } from '../util/logger';
 import { prepareShadow } from '../shadow/prepare';
 import { ensureConsumerPkg } from '../shadow/consumer-pkg';
 import { syncShadow } from '../shadow/sync';
+import { openInBrowser } from '../util/open-browser';
 import type { ConsumerPkg } from '../types';
 
 export interface DevOptions {
   json?: boolean;
+  open?: boolean;
 }
 
 const TRIDENT_READY_PATTERN = /Server started at/i;
@@ -71,6 +73,9 @@ export async function devCommand(opts: DevOptions = {}): Promise<void> {
         port,
         url,
       });
+      if (opts.open) {
+        void openInBrowser(url);
+      }
     }
   });
 

package/src/commands/generate-z2h-token.ts

@@ -1,9 +1,9 @@
 import readline from 'node:readline/promises';
 import { stdin, stdout } from 'node:process';
-import { execa } from 'execa';
 import { info, warn, output, setOutputMode } from '../util/logger';
 import { writeZthAuth, validateJwtPattern } from '../util/auth/write-auth';
 import { startLoopbackServer } from '../util/auth/loopback-server';
+import { openInBrowser } from '../util/open-browser';
 
 export const DEFAULT_TOKEN_PAGE_URL = 'https://bigbrain.me/bigbrain-vibe/generate-z2h-token';
 export const LOOPBACK_TIMEOUT_MS = 120_000;
@@ -21,21 +21,6 @@ export interface GenerateZ2HTokenOptions {
   json?: boolean;
 }
 
-function browserOpenCommand(): string {
-  switch (process.platform) {
-    case 'darwin':
-      return 'open';
-    case 'win32':
-      return 'start';
-    default:
-      return 'xdg-open';
-  }
-}
-
-async function openInBrowser(url: string): Promise<void> {
-  await execa(browserOpenCommand(), [url], { stdio: 'ignore' });
-}
-
 async function promptForToken(): Promise<string> {
   const rl = readline.createInterface({ input: stdin, output: stdout });
   try {

package/src/index.ts

@@ -78,8 +78,9 @@ async function main(): Promise<void> {
   program
     .command('dev')
     .description('Start the Trident dev server against .zth/ with native Vite HMR')
+    .option('--open', 'open the browser automatically when the dev server is ready')
     .option('--json', 'emit structured JSON on stdout')
-    .action(async (opts: { json?: boolean }) => {
+    .action(async (opts: { open?: boolean; json?: boolean }) => {
       try {
         await devCommand(opts);
       } catch (err) {

package/src/templates/app/CLAUDE.md

@@ -38,9 +38,9 @@ When a request needs data, follow `z2h:coding-standards-mf` §0: write a `runQue
 - This folder is **standalone** — not part of any monorepo, no git initialized.
 - `src/index.tsx` default-exports the React component the host MF loads.
 - `package.json` wires the `z2h-cli` for `build` / `start` / `deploy`.
-- `.zth/` is an auto-generated shadow workspace — never edit it by hand; `npx z2h-cli clean` wipes it.
-- Local dev: `npx z2h-cli dev` → opens at `https://bigbrain.me/bigbrain-vibe/<app>?zth_local=<port>`.
-- Production: `npx z2h-cli deploy` → live at `https://bigbrain.me/bigbrain-vibe/<app>`.
+- `.zth/` is an auto-generated shadow workspace — never edit it by hand; `z2h-cli clean` wipes it.
+- Local dev: `z2h-cli dev` → opens at `https://bigbrain.me/bigbrain-vibe/<app>?zth_local=<port>`.
+- Production: `z2h-cli deploy` → live at `https://bigbrain.me/bigbrain-vibe/<app>`.
 - There is no git, no PR, no CI. The gate is: lint pass → typecheck pass → user previews and approves.
 
 ---
@@ -54,8 +54,8 @@ Apps are **private by default** — only you can view them. After the first depl
 To change visibility at any time:
 
 ```
-npx z2h-cli grant --public   # open to all monday.com employees
-npx z2h-cli revoke --public  # back to private
+z2h-cli grant --public   # open to all monday.com employees
+z2h-cli revoke --public  # back to private
 ```
 
 ---

package/src/util/open-browser.ts

@@ -0,0 +1,19 @@
+import { execa } from 'execa';
+import { errorLog } from './logger';
+
+function browserOpenCommand(): string {
+  switch (process.platform) {
+    case 'darwin':
+      return 'open';
+    case 'win32':
+      return 'start';
+    default:
+      return 'xdg-open';
+  }
+}
+
+export async function openInBrowser(url: string): Promise<void> {
+  await execa(browserOpenCommand(), [url], { stdio: 'ignore' }).catch(() => {
+    errorLog(`Failed to open browser for ${url}, open it manually.`);
+  });
+}