@ubox-tools/deploy-xperience 1.1.4 → 1.1.5

package/README.md

@@ -31,6 +31,7 @@ npx @ubox-tools/deploy-xperience [app1 app2 ...] [options]
 | `--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) |
+| `--xpace <name>` | Xpace (place) to assign the Ubox to — case-insensitive match; defaults to the first available xpace if omitted or not found |
 | `--show` | Show the browser window (default: headless) |
 | `--help` | Print usage and exit |
 
@@ -55,6 +56,7 @@ npx @ubox-tools/deploy-xperience --noplayer             # Deploy apps only, skip
 npx @ubox-tools/deploy-xperience --project-name "MyProject"
 npx @ubox-tools/deploy-xperience mobile --ubox-id 42   # Use existing Ubox #42 for mobile
 npx @ubox-tools/deploy-xperience --ubox-id mobile:42 --ubox-id main:99
+npx @ubox-tools/deploy-xperience --xpace workshop    # Assign Ubox to "Workshop" xpace
 ```
 
 ## Deployment Phases

package/deploy.js

@@ -57,6 +57,7 @@ Options:
   --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
+  --xpace <name>         Xpace (place) to assign the Ubox to (case-insensitive match); defaults to the first available xpace
   --show                 Show the browser window (default: headless)
   --help                 Show this help
 
@@ -80,6 +81,7 @@ Examples:
   let noSource    = false;
   let noPlayer    = false;
   let show        = false;
+  let xpaceName   = null;
   const appArgs   = [];
   const uboxIds   = {};
   let   bareUboxId = null;
@@ -95,6 +97,7 @@ Examples:
       else { noSource = true; }
     }
     else if (args[i] === '--noplayer')     { noPlayer = true; }
+    else if (args[i] === '--xpace')        { xpaceName = args[++i]; }
     else if (args[i] === '--show')         { show = true; }
     else if (args[i] === '--ubox-id') {
       const val = args[++i];
@@ -133,7 +136,7 @@ Examples:
     uboxIds[ordered[0]] = bareUboxId;
   }
 
-  return { apps: ordered, email, password, projectName, noAssets, noSource, noPlayer, show, uboxIds };
+  return { apps: ordered, email, password, projectName, noAssets, noSource, noPlayer, show, xpaceName, uboxIds };
 }
 
 // ─── Credentials ──────────────────────────────────────────────────────────────
@@ -716,7 +719,7 @@ async function handleTCModal(page) {
   await sleep(1500);
 }
 
-async function findOrCreateUbox(page, fullName) {
+async function findOrCreateUbox(page, fullName, xpaceName = null) {
   console.log(`  [ubox] Searching for "${fullName}"...`);
   await page.goto(`${BASE_URL}/#/uboxes`, { waitUntil: 'networkidle2' });
   await sleep(1500);
@@ -761,15 +764,17 @@ async function findOrCreateUbox(page, fullName) {
   await page.keyboard.type(fullName, { delay: 30 });
   await sleep(300);
 
-  // Place select: find 1st visible select, choose "Claude"
-  await page.evaluate(() => {
+  // Place select: find 1st visible select, choose by --xpace name (or first non-null option)
+  await page.evaluate((xpaceName) => {
     const sels = Array.from(document.querySelectorAll('select'))
       .filter(e => { const r = e.getBoundingClientRect(); return r.width > 0 && r.height > 0; });
     if (sels[0]) {
-      const opt = Array.from(sels[0].options).find(o => /Claude/i.test(o.text));
+      const opts = Array.from(sels[0].options);
+      const opt = (xpaceName && opts.find(o => new RegExp(xpaceName, 'i').test(o.text)))
+        || opts.find(o => o.value !== 'null');
       if (opt) { sels[0].value = opt.value; sels[0].dispatchEvent(new Event('change', { bubbles: true })); }
     }
-  });
+  }, xpaceName);
   await sleep(300);
 
   // Config select: find 2nd visible select, choose "MyUboxConf"
@@ -992,7 +997,7 @@ async function isAppInstalled(page, appFullName) {
   }, appFullName);
 }
 
-async function deployUbox(page, appName, projectName, appParams, mobileVirtualLink, targetUboxId = null) {
+async function deployUbox(page, appName, projectName, appParams, mobileVirtualLink, targetUboxId = null, xpaceName = null) {
   const fullName = `${projectName} ${appName}`;
   console.log(`\n[Phase 3] Ubox: ${fullName}`);
 
@@ -1003,7 +1008,7 @@ async function deployUbox(page, appName, projectName, appParams, mobileVirtualLi
     await page.goto(uboxUrl, { waitUntil: 'networkidle2' });
     await sleep(2000);
   } else {
-    ({ url: uboxUrl } = await findOrCreateUbox(page, fullName));
+    ({ url: uboxUrl } = await findOrCreateUbox(page, fullName, xpaceName));
   }
 
   let virtualLink = null;
@@ -1054,7 +1059,7 @@ async function deployUbox(page, appName, projectName, appParams, mobileVirtualLi
 // ─── Main ─────────────────────────────────────────────────────────────────────
 
 async function main() {
-  const { apps, email: emailArg, password: passwordArg, projectName: projectNameArg, noAssets, noSource, noPlayer, show, uboxIds } = parseArgs();
+  const { apps, email: emailArg, password: passwordArg, projectName: projectNameArg, noAssets, noSource, noPlayer, show, xpaceName, uboxIds } = parseArgs();
 
   if (apps.length === 0) {
     console.error('No apps found in apps/ directory. Nothing to deploy.');
@@ -1106,7 +1111,7 @@ async function main() {
       for (const appName of apps) {
         const { uboxId, virtualLink } = await deployUbox(
           page, appName, projectName, appParamsMap[appName], mobileVirtualLink,
-          uboxIds[appName] ?? null
+          uboxIds[appName] ?? null, xpaceName
         );
         state[appName].uboxId = uboxId;
         if (appName === 'mobile' && virtualLink) {

package/package.json

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