@mondaydotcomorg/z2h-cli 0.7.2 → 0.9.1

package/dist/commands/build.d.ts

@@ -2,5 +2,5 @@ export interface BuildOptions {
     json?: boolean;
     publicUrl?: string;
 }
-export declare function buildCommand(opts: BuildOptions): Promise<void>;
+export declare function buildCommand(opts?: BuildOptions): Promise<void>;
 //# sourceMappingURL=build.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCpE"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAGD,wBAAsB,YAAY,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCzE"}

package/dist/commands/build.js

@@ -1,11 +1,12 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const fsExtra = require('fs-extra');
+const fs = require('fs-extra');
 const execa = require('execa');
 const util_logger = require('../util/logger.js');
 const shadow_prepare = require('../shadow/prepare.js');
 
-async function buildCommand(opts) {
+// Should be run from the consumer app directory — uses process.cwd() to locate it.
+async function buildCommand(opts = {}) {
     if (opts.json) {
         util_logger.setOutputMode('json');
     }
@@ -27,7 +28,7 @@ async function buildCommand(opts) {
         stdio: 'inherit',
         env: { ...process.env, ...(opts.publicUrl ? { PUBLIC_URL: opts.publicUrl } : {}) },
     });
-    if (!(await fsExtra.pathExists(ctx.paths.shadowBuild))) {
+    if (!(await fs.pathExists(ctx.paths.shadowBuild))) {
         throw new Error(`Expected build output at ${ctx.paths.shadowBuild} — not found.`);
     }
     util_logger.output(`[z2h-cli] build complete — artifacts at ${ctx.paths.shadowBuild}`, {

package/dist/commands/clean.d.ts

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

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

@@ -1 +1 @@
-{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../src/commands/clean.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBpE"}
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../src/commands/clean.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAGD,wBAAsB,YAAY,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBzE"}

package/dist/commands/clean.js

@@ -1,18 +1,19 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const fsExtra = require('fs-extra');
+const fs = require('fs-extra');
 const util_logger = require('../util/logger.js');
 const shadow_paths = require('../shadow/paths.js');
 
-async function cleanCommand(opts) {
+// Should be run from the consumer app directory — uses process.cwd() to locate it.
+async function cleanCommand(opts = {}) {
     if (opts.json) {
         util_logger.setOutputMode('json');
     }
     const paths = shadow_paths.resolveConsumerPaths(process.cwd());
-    const existed = await fsExtra.pathExists(paths.shadowDir);
+    const existed = await fs.pathExists(paths.shadowDir);
     if (existed) {
         util_logger.info(`removing ${paths.shadowDir}`);
-        await fsExtra.remove(paths.shadowDir);
+        await fs.remove(paths.shadowDir);
     }
     util_logger.output(existed ? `[z2h-cli] cleaned shadow at ${paths.shadowDir}` : '[z2h-cli] nothing to clean', {
         ok: true,

package/dist/commands/create-workspace.d.ts

@@ -1,5 +1,5 @@
 export interface CreateWorkspaceOptions {
     json?: boolean;
 }
-export declare function createWorkspaceCommand(opts: CreateWorkspaceOptions): Promise<void>;
+export declare function createWorkspaceCommand(opts?: CreateWorkspaceOptions): Promise<void>;
 //# sourceMappingURL=create-workspace.d.ts.map

package/dist/commands/create-workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-workspace.d.ts","sourceRoot":"","sources":["../../src/commands/create-workspace.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0CxF"}
+{"version":3,"file":"create-workspace.d.ts","sourceRoot":"","sources":["../../src/commands/create-workspace.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,sBAAsB,CAAC,IAAI,GAAE,sBAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C7F"}

package/dist/commands/create-workspace.js

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const path = require('node:path');
 const promises = require('node:fs/promises');
-const fsExtra = require('fs-extra');
+const fs = require('fs-extra');
 const util_logger = require('../util/logger.js');
 const util_workspace = require('../util/workspace.js');
 const util_templates = require('../util/templates.js');
@@ -12,33 +12,33 @@ const _interopDefault = e => e && e.__esModule ? e : { default: e };
 
 const path__default = /*#__PURE__*/_interopDefault(path);
 
-async function createWorkspaceCommand(opts) {
+async function createWorkspaceCommand(opts = {}) {
     if (opts.json) {
         util_logger.setOutputMode('json');
     }
     const home = util_workspace.getWorkspaceHome();
     const templatesDir = util_templates.getTemplatesDir();
     const wsTemplatesDir = path__default.default.join(templatesDir, 'workspace');
-    if (await fsExtra.pathExists(home)) {
-        const entries = await fsExtra.readdir(home);
+    if (await fs.pathExists(home)) {
+        const entries = await fs.readdir(home);
         if (entries.length > 0) {
             throw new Error(`Workspace already exists at ${home}. Remove it and try again.`);
         }
     }
     else {
-        await fsExtra.ensureDir(home);
+        await fs.ensureDir(home);
     }
     const pkgRaw = await promises.readFile(path__default.default.join(wsTemplatesDir, 'package.json.tmpl'), 'utf8');
     await Promise.all([
-        fsExtra.writeFile(path__default.default.join(home, 'package.json'), pkgRaw),
-        fsExtra.copy(path__default.default.join(wsTemplatesDir, 'gitignore'), path__default.default.join(home, '.gitignore')),
-        fsExtra.copy(path__default.default.join(wsTemplatesDir, 'yarnrc.yml'), path__default.default.join(home, '.yarnrc.yml')),
-        fsExtra.copy(path__default.default.join(wsTemplatesDir, 'nx.json'), path__default.default.join(home, 'nx.json')),
-        fsExtra.copy(path__default.default.join(wsTemplatesDir, 'yarnlock'), path__default.default.join(home, 'yarn.lock')),
-        fsExtra.copy(path__default.default.join(wsTemplatesDir, 'nvmrc'), path__default.default.join(home, '.nvmrc')),
-        fsExtra.copy(path__default.default.join(wsTemplatesDir, 'npmrc'), path__default.default.join(home, '.npmrc')),
-        fsExtra.copy(path__default.default.join(wsTemplatesDir, 'README.md'), path__default.default.join(home, 'README.md')),
-        fsExtra.copy(path__default.default.join(wsTemplatesDir, 'yarn-releases', 'yarn-4.5.1.cjs'), path__default.default.join(home, '.yarn', 'releases', 'yarn-4.5.1.cjs')),
+        fs.writeFile(path__default.default.join(home, 'package.json'), pkgRaw),
+        fs.copy(path__default.default.join(wsTemplatesDir, 'gitignore'), path__default.default.join(home, '.gitignore')),
+        fs.copy(path__default.default.join(wsTemplatesDir, 'yarnrc.yml'), path__default.default.join(home, '.yarnrc.yml')),
+        fs.copy(path__default.default.join(wsTemplatesDir, 'nx.json'), path__default.default.join(home, 'nx.json')),
+        fs.copy(path__default.default.join(wsTemplatesDir, 'yarnlock'), path__default.default.join(home, 'yarn.lock')),
+        fs.copy(path__default.default.join(wsTemplatesDir, 'nvmrc'), path__default.default.join(home, '.nvmrc')),
+        fs.copy(path__default.default.join(wsTemplatesDir, 'npmrc'), path__default.default.join(home, '.npmrc')),
+        fs.copy(path__default.default.join(wsTemplatesDir, 'README.md'), path__default.default.join(home, 'README.md')),
+        fs.copy(path__default.default.join(wsTemplatesDir, 'yarn-releases', 'yarn-4.5.1.cjs'), path__default.default.join(home, '.yarn', 'releases', 'yarn-4.5.1.cjs')),
     ]);
     util_logger.info(`setting up your Z2H workspace — this may take a minute...`);
     await util_npm_install.runYarnInstall({ cwd: home });

package/dist/commands/create.d.ts

@@ -3,5 +3,5 @@ export interface CreateOptions {
     htmlFile?: string;
     json?: boolean;
 }
-export declare function createCommand(appName: string, opts: CreateOptions): Promise<void>;
+export declare function createCommand(appName: string, opts?: CreateOptions): Promise<void>;
 //# sourceMappingURL=create.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA6BD,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAkFvF"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA6BD,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8F5F"}

package/dist/commands/create.js

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const path = require('node:path');
 const promises = require('node:fs/promises');
-const fsExtra = require('fs-extra');
+const fs = require('fs-extra');
 const util_logger = require('../util/logger.js');
 const util_workspace = require('../util/workspace.js');
 const util_templates = require('../util/templates.js');
@@ -10,6 +10,7 @@ const util_manifest = require('../util/manifest.js');
 const util_appName = require('../util/app-name.js');
 const constants = require('../constants.js');
 const util_npm_install = require('../util/npm/install.js');
+const commands_build = require('./build.js');
 
 const _interopDefault = e => e && e.__esModule ? e : { default: e };
 
@@ -33,13 +34,13 @@ function pascalCase(input) {
  * Returns true iff `dir` either does not exist or is an empty directory.
  */
 async function isDirEmpty(dir) {
-    if (!(await fsExtra.pathExists(dir))) {
+    if (!(await fs.pathExists(dir))) {
         return true;
     }
-    const entries = await fsExtra.readdir(dir);
+    const entries = await fs.readdir(dir);
     return entries.length === 0;
 }
-async function createCommand(appName, opts) {
+async function createCommand(appName, opts = {}) {
     if (opts.json) {
         util_logger.setOutputMode('json');
     }
@@ -59,7 +60,7 @@ async function createCommand(appName, opts) {
     if (!util_templates.APP_TEMPLATES.includes(template)) {
         throw new Error(`Unknown template "${template}". Available: ${util_templates.APP_TEMPLATES.join(', ')}.`);
     }
-    if (opts.htmlFile && !(await fsExtra.pathExists(opts.htmlFile))) {
+    if (opts.htmlFile && !(await fs.pathExists(opts.htmlFile))) {
         throw new Error(`HTML file does not exist: ${opts.htmlFile}`);
     }
     // Validate target dir.
@@ -78,25 +79,38 @@ async function createCommand(appName, opts) {
         __APP_COMPONENT__: pascalCase(appName),
     };
     const appTemplatesDir = path__default.default.join(util_templates.getTemplatesDir(), 'app');
-    await fsExtra.ensureDir(path__default.default.join(appDir, 'src'));
-    await fsExtra.ensureDir(path__default.default.join(appDir, '.claude'));
+    await fs.ensureDir(path__default.default.join(appDir, 'src'));
+    await fs.ensureDir(path__default.default.join(appDir, '.claude'));
     // package.json (templated).
     const pkgRaw = await promises.readFile(path__default.default.join(appTemplatesDir, 'package.json.tmpl'), 'utf8');
-    await fsExtra.writeFile(path__default.default.join(appDir, 'package.json'), util_templates.renderTemplate(pkgRaw, vars));
+    await fs.writeFile(path__default.default.join(appDir, 'package.json'), util_templates.renderTemplate(pkgRaw, vars));
     // src/index.tsx (templated; choice driven by template).
     const indexTemplate = template === 'html-embed' ? 'html-index.tsx.tmpl' : 'default-index.tsx.tmpl';
     const indexRaw = await promises.readFile(path__default.default.join(appTemplatesDir, indexTemplate), 'utf8');
-    await fsExtra.writeFile(path__default.default.join(appDir, 'src', 'index.tsx'), util_templates.renderTemplate(indexRaw, vars));
+    await fs.writeFile(path__default.default.join(appDir, 'src', 'index.tsx'), util_templates.renderTemplate(indexRaw, vars));
     // Copy verbatim files.
-    await fsExtra.copy(path__default.default.join(appTemplatesDir, 'gitignore'), path__default.default.join(appDir, '.gitignore'));
-    await fsExtra.copy(path__default.default.join(appTemplatesDir, 'claude-settings.json'), path__default.default.join(appDir, '.claude', 'settings.json'));
-    await fsExtra.copy(path__default.default.join(appTemplatesDir, 'CLAUDE.md'), path__default.default.join(appDir, 'CLAUDE.md'));
+    await fs.copy(path__default.default.join(appTemplatesDir, 'gitignore'), path__default.default.join(appDir, '.gitignore'));
+    await fs.copy(path__default.default.join(appTemplatesDir, 'claude-settings.json'), path__default.default.join(appDir, '.claude', 'settings.json'));
+    await fs.copy(path__default.default.join(appTemplatesDir, 'CLAUDE.md'), path__default.default.join(appDir, 'CLAUDE.md'));
     // html-embed: also copy the source HTML.
     if (template === 'html-embed' && opts.htmlFile) {
-        await fsExtra.copy(opts.htmlFile, path__default.default.join(appDir, 'src', 'page.html'));
+        await fs.copy(opts.htmlFile, path__default.default.join(appDir, 'src', 'page.html'));
     }
     util_logger.info(`installing dependencies for ${appName}...`);
     await util_npm_install.runYarnInstall({ cwd: workspace });
+    // build/dev/deploy all locate the consumer via process.cwd() — chdir before calling them.
+    const prevCwd = process.cwd();
+    try {
+        util_logger.info(`pre-building ${appName}`);
+        process.chdir(appDir);
+        await commands_build.buildCommand();
+    }
+    catch {
+        util_logger.warn(`pre-build failed. No worries — it will run again when needed.`);
+    }
+    finally {
+        process.chdir(prevCwd);
+    }
     util_logger.output(`[z2h-cli] app ready at ${appDir}`, {
         ok: true,
         appDir,

package/dist/commands/deploy.d.ts

@@ -2,5 +2,5 @@ export interface DeployOptions {
     dryRun?: boolean;
     json?: boolean;
 }
-export declare function deployCommand(opts: DeployOptions): Promise<void>;
+export declare function deployCommand(opts?: DeployOptions): Promise<void>;
 //# sourceMappingURL=deploy.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA+EtE"}
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAGD,wBAAsB,aAAa,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuF3E"}

package/dist/commands/deploy.js

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const path = require('node:path');
 const os = require('node:os');
-const fsExtra = require('fs-extra');
+const fs = require('fs-extra');
 const util_logger = require('../util/logger.js');
 const shadow_paths = require('../shadow/paths.js');
 const util_manifest = require('../util/manifest.js');
@@ -18,19 +18,20 @@ const _interopDefault = e => e && e.__esModule ? e : { default: e };
 const path__default = /*#__PURE__*/_interopDefault(path);
 const os__default = /*#__PURE__*/_interopDefault(os);
 
-async function deployCommand(opts) {
+// Should be run from the consumer app directory — uses process.cwd() to locate it.
+async function deployCommand(opts = {}) {
     if (opts.json) {
         util_logger.setOutputMode('json');
     }
     const paths = shadow_paths.resolveConsumerPaths(process.cwd());
-    const consumerPkg = (await fsExtra.readJson(paths.consumerPkg));
+    const consumerPkg = (await fs.readJson(paths.consumerPkg));
     if (!consumerPkg.name) {
         throw new Error('Consumer package.json must have a "name" field');
     }
     const appName = util_appName.mfAppName(consumerPkg.name);
     // Validate the user's deploy token is on disk before doing any expensive
     // work. Throws Z2hAuthMissingError with a remediation hint if not.
-    await util_auth_authStore.readZthAuth();
+    const { token } = await util_auth_authStore.readZthAuth();
     util_s3_client.setupS3Client({ appName });
     util_logger.info('reading current Z2H manifest');
     const manifest = await util_manifest.readManifest();
@@ -39,15 +40,15 @@ async function deployCommand(opts) {
     const url = `${constants.BUCKET_READ_DNS_URL}/${keyPrefix}`;
     util_logger.info('building');
     await commands_build.buildCommand({ json: opts.json, publicUrl: url });
-    if (!(await fsExtra.pathExists(paths.shadowBuild))) {
+    if (!(await fs.pathExists(paths.shadowBuild))) {
         throw new Error(`No build output at ${paths.shadowBuild} after build step.`);
     }
     // Trident emits the canonical per-MF manifest at build/asset-manifest.json.
     const assetManifestPath = path__default.default.join(paths.shadowBuild, 'asset-manifest.json');
-    if (!(await fsExtra.pathExists(assetManifestPath))) {
+    if (!(await fs.pathExists(assetManifestPath))) {
         throw new Error(`Missing asset-manifest.json at ${assetManifestPath}.`);
     }
-    const assetManifest = (await fsExtra.readJson(assetManifestPath));
+    const assetManifest = (await fs.readJson(assetManifestPath));
     const deployedBy = os__default.default.userInfo().username;
     const entry = {
         ...assetManifest,
@@ -68,10 +69,18 @@ async function deployCommand(opts) {
         });
         return;
     }
-    util_logger.info(`uploading build → s3://${constants.BUCKET_WRITE_NAME}/${keyPrefix}/`);
-    await util_s3_upload.uploadDir(paths.shadowBuild, keyPrefix);
-    util_logger.info(`updating manifest entry "${appName}" → v${version}`);
-    await util_manifest.writeManifest(util_manifest.upsertEntry(manifest, appName, entry));
+    try {
+        // Lock is acquired here — uploadDir triggers the STS credential provider on first S3 call
+        util_logger.info(`uploading build → s3://${constants.BUCKET_WRITE_NAME}/${keyPrefix}/`);
+        await util_s3_upload.uploadDir(paths.shadowBuild, keyPrefix);
+        util_logger.info(`updating manifest entry "${appName}" → v${version}`);
+        await util_manifest.writeManifest(util_manifest.upsertEntry(manifest, appName, entry));
+        util_logger.info(`registering app "${appName}" → v${version}`);
+        await registerApp(appName, token, version, entry);
+    }
+    finally {
+        await releaseLockBestEffort(appName, token);
+    }
     // The host MF parses the app name from the URL and prepends `mf-` itself
     // before looking it up in the manifest. So the user-facing URL must use
     // the consumer's de-scoped package name (no `mf-` prefix, no `@scope/`).
@@ -87,5 +96,30 @@ async function deployCommand(opts) {
         entry,
     });
 }
+async function registerApp(appName, token, version, entry) {
+    const res = await fetch(`${constants.brokerBaseUrl()}/z2h-cli/apps/register`, {
+        method: 'POST',
+        headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
+        body: JSON.stringify({ appName, version, entry }),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`App registration failed (${res.status}): ${text.slice(0, 1024)}`);
+    }
+}
+// best-effort — the 5-min TTL backstop handles failures
+async function releaseLockBestEffort(appName, token) {
+    try {
+        await fetch(`${constants.brokerBaseUrl()}/z2h-cli/lock/release`, {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({ appName }),
+        });
+        util_logger.info(`lock released for ${appName}`);
+    }
+    catch {
+        util_logger.warn(`failed to release lock for ${appName}`);
+    }
+}
 
 exports.deployCommand = deployCommand;

package/dist/commands/dev.d.ts

@@ -1,5 +1,5 @@
 export interface DevOptions {
     json?: boolean;
 }
-export declare function devCommand(opts: DevOptions): Promise<void>;
+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;AAID,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAuEhE"}
+{"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"}

package/dist/commands/dev.js

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const path = require('node:path');
-const fs = require('node:fs');
-const fsExtra = require('fs-extra');
+const fs$1 = require('node:fs');
+const fs = require('fs-extra');
 const chokidar = require('chokidar');
 const execa = require('execa');
 const util_logger = require('../util/logger.js');
@@ -13,10 +13,11 @@ const shadow_sync = require('../shadow/sync.js');
 const _interopDefault = e => e && e.__esModule ? e : { default: e };
 
 const path__default = /*#__PURE__*/_interopDefault(path);
-const fs__default = /*#__PURE__*/_interopDefault(fs);
+const fs__default = /*#__PURE__*/_interopDefault(fs$1);
 
 const TRIDENT_READY_PATTERN = /Server started at/i;
-async function devCommand(opts) {
+// Should be run from the consumer app directory — uses process.cwd() to locate it.
+async function devCommand(opts = {}) {
     if (opts.json) {
         util_logger.setOutputMode('json');
     }
@@ -30,10 +31,13 @@ async function devCommand(opts) {
     const server = execa.execa('yarn', ['start'], {
         cwd: ctx.paths.shadowDir,
         stdio: ['inherit', 'pipe', 'inherit'],
+        // Trident requires NPM_TOKEN to be set or it refuses to start; 'FAKE_TOKEN' satisfies the check without real credentials.
+        // we always pass a fake token for same behavior for all users (no matter if they have a token or not)
+        env: { ...process.env, NPM_TOKEN: 'FAKE_TOKEN' },
     });
     const pidFile = path__default.default.join(ctx.paths.shadowDir, 'dev.pid');
     if (server.pid) {
-        await fsExtra.writeFile(pidFile, String(server.pid));
+        await fs.writeFile(pidFile, String(server.pid));
     }
     const cleanupPid = () => {
         try {
@@ -73,7 +77,7 @@ async function devCommand(opts) {
     pkgWatcher.on('change', async () => {
         util_logger.warn('consumer package.json changed — re-checking deps');
         try {
-            const raw = (await fsExtra.readJson(ctx.paths.consumerPkg));
+            const raw = (await fs.readJson(ctx.paths.consumerPkg));
             const { pkg } = await shadow_consumerPkg.ensureConsumerPkg(ctx.paths.consumerPkg, raw);
             await shadow_sync.syncShadow(ctx.paths, pkg);
         }

package/dist/commands/migrate.d.ts

@@ -2,5 +2,5 @@ export interface MigrateOptions {
     dryRun?: boolean;
     json?: boolean;
 }
-export declare function migrateCommand(cliVersion: string, opts: MigrateOptions): Promise<void>;
+export declare function migrateCommand(cliVersion: string, opts?: MigrateOptions): Promise<void>;
 //# sourceMappingURL=migrate.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/commands/migrate.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5F"}
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/commands/migrate.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMjG"}

package/dist/commands/migrate.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const util_logger = require('../util/logger.js');
 const migrations_autoMigrate = require('../migrations/auto-migrate.js');
 
-async function migrateCommand(cliVersion, opts) {
+async function migrateCommand(cliVersion, opts = {}) {
     if (opts.json) {
         util_logger.setOutputMode('json');
     }

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

@@ -2,5 +2,5 @@ export interface BuildOptions {
     json?: boolean;
     publicUrl?: string;
 }
-export declare function buildCommand(opts: BuildOptions): Promise<void>;
+export declare function buildCommand(opts?: BuildOptions): Promise<void>;
 //# sourceMappingURL=build.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/commands/build.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCpE"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/commands/build.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAGD,wBAAsB,YAAY,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCzE"}

package/dist/esm/commands/build.mjs

@@ -3,7 +3,8 @@ import { execa } from 'execa';
 import { setOutputMode, info, output } from '../util/logger.mjs';
 import { prepareShadow } from '../shadow/prepare.mjs';
 
-async function buildCommand(opts) {
+// Should be run from the consumer app directory — uses process.cwd() to locate it.
+async function buildCommand(opts = {}) {
     if (opts.json) {
         setOutputMode('json');
     }

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../../src/commands/clean.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBpE"}
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../../src/commands/clean.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAGD,wBAAsB,YAAY,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBzE"}

package/dist/esm/commands/clean.mjs

@@ -2,7 +2,8 @@ import { pathExists, remove } from 'fs-extra';
 import { setOutputMode, info, output } from '../util/logger.mjs';
 import { resolveConsumerPaths } from '../shadow/paths.mjs';
 
-async function cleanCommand(opts) {
+// Should be run from the consumer app directory — uses process.cwd() to locate it.
+async function cleanCommand(opts = {}) {
     if (opts.json) {
         setOutputMode('json');
     }

package/dist/esm/commands/create-workspace.d.ts

@@ -1,5 +1,5 @@
 export interface CreateWorkspaceOptions {
     json?: boolean;
 }
-export declare function createWorkspaceCommand(opts: CreateWorkspaceOptions): Promise<void>;
+export declare function createWorkspaceCommand(opts?: CreateWorkspaceOptions): Promise<void>;
 //# sourceMappingURL=create-workspace.d.ts.map

package/dist/esm/commands/create-workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-workspace.d.ts","sourceRoot":"","sources":["../../../src/commands/create-workspace.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0CxF"}
+{"version":3,"file":"create-workspace.d.ts","sourceRoot":"","sources":["../../../src/commands/create-workspace.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,sBAAsB,CAAC,IAAI,GAAE,sBAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C7F"}

package/dist/esm/commands/create-workspace.mjs

@@ -6,7 +6,7 @@ import { getWorkspaceHome } from '../util/workspace.mjs';
 import { getTemplatesDir } from '../util/templates.mjs';
 import { runYarnInstall } from '../util/npm/install.mjs';
 
-async function createWorkspaceCommand(opts) {
+async function createWorkspaceCommand(opts = {}) {
     if (opts.json) {
         setOutputMode('json');
     }

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

@@ -3,5 +3,5 @@ export interface CreateOptions {
     htmlFile?: string;
     json?: boolean;
 }
-export declare function createCommand(appName: string, opts: CreateOptions): Promise<void>;
+export declare function createCommand(appName: string, opts?: CreateOptions): Promise<void>;
 //# sourceMappingURL=create.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/create.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA6BD,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAkFvF"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/create.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA6BD,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8F5F"}

package/dist/esm/commands/create.mjs

@@ -1,13 +1,14 @@
 import path from 'node:path';
 import { readFile } from 'node:fs/promises';
 import { pathExists, ensureDir, writeFile, copy, readdir } from 'fs-extra';
-import { setOutputMode, info, output } from '../util/logger.mjs';
+import { setOutputMode, info, warn, output } from '../util/logger.mjs';
 import { assertWorkspace } from '../util/workspace.mjs';
 import { APP_TEMPLATES, getTemplatesDir, renderTemplate } from '../util/templates.mjs';
 import { readManifest } from '../util/manifest.mjs';
 import { mfAppName } from '../util/app-name.mjs';
 import { APP_NAME_PATTERN } from '../constants.mjs';
 import { runYarnInstall } from '../util/npm/install.mjs';
+import { buildCommand } from './build.mjs';
 
 // Names reserved by the host MF (mf-bigbrain-zth) for platform pages under
 // /bigbrain-vibe/<name>. Creating an app with one of these would shadow the
@@ -33,7 +34,7 @@ async function isDirEmpty(dir) {
     const entries = await readdir(dir);
     return entries.length === 0;
 }
-async function createCommand(appName, opts) {
+async function createCommand(appName, opts = {}) {
     if (opts.json) {
         setOutputMode('json');
     }
@@ -91,6 +92,19 @@ async function createCommand(appName, opts) {
     }
     info(`installing dependencies for ${appName}...`);
     await runYarnInstall({ cwd: workspace });
+    // build/dev/deploy all locate the consumer via process.cwd() — chdir before calling them.
+    const prevCwd = process.cwd();
+    try {
+        info(`pre-building ${appName}`);
+        process.chdir(appDir);
+        await buildCommand();
+    }
+    catch {
+        warn(`pre-build failed. No worries — it will run again when needed.`);
+    }
+    finally {
+        process.chdir(prevCwd);
+    }
     output(`[z2h-cli] app ready at ${appDir}`, {
         ok: true,
         appDir,

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

@@ -2,5 +2,5 @@ export interface DeployOptions {
     dryRun?: boolean;
     json?: boolean;
 }
-export declare function deployCommand(opts: DeployOptions): Promise<void>;
+export declare function deployCommand(opts?: DeployOptions): Promise<void>;
 //# sourceMappingURL=deploy.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/commands/deploy.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA+EtE"}
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/commands/deploy.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAGD,wBAAsB,aAAa,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuF3E"}