@ubox-tools/deploy-xperience 1.1.1 → 1.1.3

package/README.md

@@ -26,6 +26,8 @@ npx @ubox-tools/deploy-xperience [app1 app2 ...] [options]
 | `--password <pass>` | Ubox Studio password (or `UBOX_PASSWORD` env var) |
 | `--project-name <name>` | Override the project name (default: parent directory name) |
 | `--noassets` | Skip uploading assets (images, fonts, files) |
+| `--nosource` | Skip source injection entirely |
+| `--nosource <files>` | Skip specific files (comma-separated, e.g. `ubox.js,logic.js`) |
 | `--noplayer` | Skip Phase 3 — deploy apps only, do not create/update Uboxes |
 | `--ubox-id <id>` | Use a pre-existing Ubox by ID — skips search/create (single-app deployments) |
 | `--ubox-id <app>:<id>` | Scoped form for multi-app deployments (repeatable) |
@@ -47,6 +49,8 @@ npx @ubox-tools/deploy-xperience                        # Deploy all apps (headl
 npx @ubox-tools/deploy-xperience --show                 # Deploy all apps, show browser
 npx @ubox-tools/deploy-xperience mobile                 # Deploy only the mobile app
 npx @ubox-tools/deploy-xperience main --noassets        # Deploy main app, skip asset uploads
+npx @ubox-tools/deploy-xperience --nosource             # Deploy without re-injecting source
+npx @ubox-tools/deploy-xperience --nosource ubox.js    # Skip only ubox.js injection
 npx @ubox-tools/deploy-xperience --noplayer             # Deploy apps only, skip Uboxes
 npx @ubox-tools/deploy-xperience --project-name "MyProject"
 npx @ubox-tools/deploy-xperience mobile --ubox-id 42   # Use existing Ubox #42 for mobile

package/deploy.js

@@ -52,6 +52,8 @@ Options:
   --password <pass>      Ubox studio password (or set UBOX_PASSWORD env var)
   --project-name <name>  Override project name (default: directory name)
   --noassets             Skip uploading assets (resources)
+  --nosource             Skip source injection entirely
+  --nosource <files>     Skip specific files (comma-separated, e.g. ubox.js,logic.js)
   --noplayer             Skip Ubox creation (Phase 3) — only deploy applications
   --ubox-id <id>         Use a pre-existing Ubox by ID (skips search/create)
   --ubox-id <app>:<id>   Scoped form when deploying multiple apps
@@ -75,6 +77,7 @@ Examples:
   let password    = process.env.UBOX_PASSWORD;
   let projectName = null;
   let noAssets    = false;
+  let noSource    = false;
   let noPlayer    = false;
   let show        = false;
   const appArgs   = [];
@@ -86,6 +89,11 @@ Examples:
     else if (args[i] === '--password')     { password = args[++i]; }
     else if (args[i] === '--project-name') { projectName = args[++i]; }
     else if (args[i] === '--noassets')     { noAssets = true; }
+    else if (args[i] === '--nosource') {
+      const next = args[i + 1];
+      if (next && !next.startsWith('--')) { noSource = args[++i]; }
+      else { noSource = true; }
+    }
     else if (args[i] === '--noplayer')     { noPlayer = true; }
     else if (args[i] === '--show')         { show = true; }
     else if (args[i] === '--ubox-id') {
@@ -125,7 +133,7 @@ Examples:
     uboxIds[ordered[0]] = bareUboxId;
   }
 
-  return { apps: ordered, email, password, projectName, noAssets, noPlayer, show, uboxIds };
+  return { apps: ordered, email, password, projectName, noAssets, noSource, noPlayer, show, uboxIds };
 }
 
 // ─── Credentials ──────────────────────────────────────────────────────────────
@@ -652,7 +660,7 @@ async function injectSource(page, proxy) {
   await sleep(3000);
 }
 
-async function deployApp(page, appName, projectName, { noAssets = false } = {}) {
+async function deployApp(page, appName, projectName, { noAssets = false, noSource = false } = {}) {
   const fullName         = `${projectName} ${appName}`;
   const { proxy, assets, params } = generateProxy(appName);
 
@@ -666,7 +674,14 @@ async function deployApp(page, appName, projectName, { noAssets = false } = {})
     await uploadResources(page, assets);
   }
   await configureParameters(page, params);
-  await injectSource(page, proxy);
+  if (noSource === true) {
+    console.log('  [source] Skipped (--nosource)');
+  } else {
+    const filteredProxy = typeof noSource === 'string'
+      ? Object.fromEntries(Object.entries(proxy).filter(([f]) => !noSource.split(',').includes(f)))
+      : proxy;
+    await injectSource(page, filteredProxy);
+  }
 
   // Extract app ID from current URL
   const appId = page.url().match(/#\/application(?:-source)?\/(\d+)/)?.[1] || '?';
@@ -967,25 +982,37 @@ async function setMobileLink(page, appFullName, mobileVirtualLink) {
   console.log(`  [ubox] mobileLink = ${mobileVirtualLink}`);
 }
 
+async function isAppInstalled(page, appFullName) {
+  return page.evaluate(name => {
+    for (const card of document.querySelectorAll('.card-body.ubox-app-installed')) {
+      const title = card.querySelector('p.card-text');
+      if (title && title.textContent.trim() === name) return true;
+    }
+    return false;
+  }, appFullName);
+}
+
 async function deployUbox(page, appName, projectName, appParams, mobileVirtualLink, targetUboxId = null) {
   const fullName = `${projectName} ${appName}`;
   console.log(`\n[Phase 3] Ubox: ${fullName}`);
 
-  let uboxUrl, created;
+  let uboxUrl;
   if (targetUboxId) {
     uboxUrl = `${BASE_URL}/#/ubox/${targetUboxId}`;
     console.log(`  [ubox] Using pre-existing Ubox ID ${targetUboxId} — navigating directly...`);
     await page.goto(uboxUrl, { waitUntil: 'networkidle2' });
     await sleep(2000);
-    created = false;
   } else {
-    ({ url: uboxUrl, created } = await findOrCreateUbox(page, fullName));
+    ({ url: uboxUrl } = await findOrCreateUbox(page, fullName));
   }
 
   let virtualLink = null;
 
-  if (created) {
-    // Fresh ubox — need to make public, install app, get virtual link, set params
+  const installed = await isAppInstalled(page, fullName);
+
+  if (!installed) {
+    // App not installed — make public, install, get virtual link, set params
+    console.log(`  [ubox] "${fullName}" not installed — proceeding with install...`);
     await checkMakePublic(page);
     await installApp(page, fullName);
 
@@ -1003,8 +1030,7 @@ async function deployUbox(page, appName, projectName, appParams, mobileVirtualLi
       await setMobileLink(page, fullName, mobileVirtualLink);
     }
   } else {
-    // Existing ubox — skip install, params, and virtual link retrieval
-    console.log('  [ubox] Already exists — skipping install, params, and virtual link');
+    console.log(`  [ubox] "${fullName}" already installed — skipping install`);
 
     // Still retrieve the virtual link for mobile so main can use it
     if (appName === 'mobile') {
@@ -1023,7 +1049,7 @@ async function deployUbox(page, appName, projectName, appParams, mobileVirtualLi
 // ─── Main ─────────────────────────────────────────────────────────────────────
 
 async function main() {
-  const { apps, email: emailArg, password: passwordArg, projectName: projectNameArg, noAssets, noPlayer, show, uboxIds } = parseArgs();
+  const { apps, email: emailArg, password: passwordArg, projectName: projectNameArg, noAssets, noSource, noPlayer, show, uboxIds } = parseArgs();
 
   if (apps.length === 0) {
     console.error('No apps found in apps/ directory. Nothing to deploy.');
@@ -1035,6 +1061,8 @@ async function main() {
   console.log(`Project : ${projectName}`);
   console.log(`Apps    : ${apps.join(', ')}`);
   if (noAssets) console.log('Flags   : --noassets (skip resource uploads)');
+  if (noSource === true) console.log('Flags   : --nosource (skip all source injection)');
+  else if (noSource) console.log(`Flags   : --nosource ${noSource} (skip specific files)`);
   if (noPlayer) console.log('Flags   : --noplayer (skip Ubox creation)');
   console.log('');
 
@@ -1062,7 +1090,7 @@ async function main() {
       state[appName] = {};
       const { params } = generateProxy(appName);
       appParamsMap[appName] = params;
-      state[appName].appId = await deployApp(page, appName, projectName, { noAssets });
+      state[appName].appId = await deployApp(page, appName, projectName, { noAssets, noSource });
     }
 
     // Phase 3 — Deploy Uboxes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubox-tools/deploy-xperience",
-  "version": "1.1.1",
+  "version": "1.1.3",
   "description": "Deploy a Ubox experience to studio.ubox.world",
   "bin": { "deploy-xperience": "./deploy.js" },
   "dependencies": { "puppeteer": "*" },