@hypersoniclabs/helix-cli 0.1.7 → 0.1.24-helix3.438

package/dist/dev/devServer.js

@@ -0,0 +1,228 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEV_WORLD_ID = exports.DEV_SHELL_DEFAULT_PORT = void 0;
+exports.resolveSdkDistDir = resolveSdkDistDir;
+exports.readWorldIdentity = readWorldIdentity;
+exports.startDevServer = startDevServer;
+// The transport half of `helix dev`: the world's BUILT bundle on one port, the simulated shell page on
+// another. Two ports means two ORIGINS — the SDK only handshakes when window.parent !== window, and a
+// same-origin iframe would pass tests that production's cross-origin postMessage semantics would fail.
+//
+// Entirely offline: no auth, no backend, no credentials. The shell answers helix:ready immediately (an
+// unanswered handshake costs every boot the SDK's full 8 s INIT_TIMEOUT_MS) and the SDK's dev-shell dist
+// is served raw to the browser as native ESM.
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const install_1 = require("../install");
+const staticServe_1 = require("../screenshot/staticServe");
+const shellPage_1 = require("./shellPage");
+const state_1 = require("./state");
+/** Clear of the dev-stack's ports (3001 portal · 4173 world · 5000 backend · 2567 room) and vite's 5173. */
+exports.DEV_SHELL_DEFAULT_PORT = 5190;
+/** The world has no real row here, so it gets an obviously synthetic uuid rather than a real-looking one. */
+exports.DEV_WORLD_ID = '00000000-0000-4000-8000-000000000001';
+/**
+ * Where the browser gets the dev shell from. `@hypersoniclabs/helix-sdk/package.json` is NOT resolvable —
+ * the SDK's exports map does not list it — so resolve a real subpath instead and walk up from the file:
+ * dist/dev-shell/index.js and dist/index.js both land on dist/.
+ */
+function resolveSdkDistDir() {
+    const entries = [];
+    for (const specifier of ['@hypersoniclabs/helix-sdk/dev-shell', '@hypersoniclabs/helix-sdk']) {
+        try {
+            entries.push(require.resolve(specifier));
+        }
+        catch {
+            // Older SDK without the subpath, or not installed — the next candidate (or the throw) covers it.
+        }
+    }
+    for (const entry of entries) {
+        let dir = (0, node_path_1.dirname)(entry);
+        if ((0, node_path_1.basename)(dir) === 'dev-shell')
+            dir = (0, node_path_1.dirname)(dir);
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(dir, 'dev-shell', 'index.js')))
+            return dir;
+    }
+    throw new Error('could not find the dev shell in @hypersoniclabs/helix-sdk — install a version that exports ' +
+        '"./dev-shell" (npm i @hypersoniclabs/helix-sdk@latest)');
+}
+/** slug/title from the project's own manifest; a dir with no helix.json still runs, just unnamed. */
+function readWorldIdentity(worldDir) {
+    const manifestPath = install_1.WORLD_MANIFEST_LOCATIONS.map((rel) => (0, node_path_1.join)(worldDir, rel)).find((p) => (0, node_fs_1.existsSync)(p));
+    let slug;
+    let title;
+    if (manifestPath) {
+        try {
+            // Same BOM tolerance as the seed readers — a BOM here silently unnamed the world.
+            const raw = (0, node_fs_1.readFileSync)(manifestPath, 'utf8');
+            const manifest = JSON.parse(raw.charCodeAt(0) === 0xfeff ? raw.slice(1) : raw);
+            if (typeof manifest.slug === 'string' && manifest.slug)
+                slug = manifest.slug;
+            if (typeof manifest.title === 'string' && manifest.title)
+                title = manifest.title;
+        }
+        catch {
+            // A malformed manifest is the world's problem to fix; it must not block the local shell.
+        }
+    }
+    const fallbackSlug = (0, node_path_1.basename)(worldDir) || 'dev-world';
+    return { id: exports.DEV_WORLD_ID, slug: slug ?? fallbackSlug, title: title ?? 'Dev World' };
+}
+const json = (res, status, body) => {
+    const payload = Buffer.from(`${JSON.stringify(body)}\n`, 'utf8');
+    res.writeHead(status, { 'content-type': 'application/json; charset=utf-8', 'content-length': payload.byteLength });
+    res.end(payload);
+};
+const text = (res, contentType, body) => {
+    const payload = Buffer.from(body, 'utf8');
+    res.writeHead(200, { 'content-type': contentType, 'content-length': payload.byteLength, 'cache-control': 'no-store' });
+    res.end(payload);
+};
+function readBody(req, limitBytes) {
+    return new Promise((resolvePromise, reject) => {
+        const chunks = [];
+        let size = 0;
+        req.on('data', (chunk) => {
+            size += chunk.length;
+            if (size > limitBytes) {
+                reject(new Error(`state payload exceeds ${limitBytes} bytes`));
+                req.destroy();
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on('end', () => resolvePromise(Buffer.concat(chunks).toString('utf8')));
+        req.on('error', reject);
+    });
+}
+// One simulated player's state is small, but a world can fill its data store — this is the same order as
+// the shell lane's 100 MB per-world storage cap, so a legitimate state never trips it.
+const STATE_LIMIT_BYTES = 128 * 1024 * 1024;
+const listenError = (err, port) => {
+    if (err?.code === 'EADDRINUSE') {
+        return new Error(`port ${port} is already in use — pass --port <n> (helix dev takes <n> for the shell and <n>+1 for the world)`);
+    }
+    return err instanceof Error ? err : new Error(String(err));
+};
+/**
+ * Boot both servers. Nothing here reads credentials or touches the network: working with no backend at
+ * all is the whole point of the command.
+ */
+async function startDevServer(options) {
+    const worldDir = (0, node_path_1.resolve)(options.worldDir);
+    const distDir = (0, node_path_1.join)(worldDir, 'dist');
+    if (!(0, node_fs_1.existsSync)((0, node_path_1.join)(distDir, 'index.html'))) {
+        throw new Error(`no built bundle at ${distDir} — run your build first (npm run build). ` +
+            'helix dev serves the BUILT bundle, not the source project.');
+    }
+    const sdkDistDir = resolveSdkDistDir();
+    const world = readWorldIdentity(worldDir);
+    const gitignore = (0, state_1.ensureDevDirIgnored)(worldDir);
+    const seed = (0, state_1.readDevProductsSeed)(worldDir);
+    const achievementsSeed = (0, state_1.readDevAchievementsSeed)(worldDir);
+    const selection = (0, state_1.selectDevState)((0, state_1.readDevStateFile)(worldDir), world.slug, {
+        reset: options.reset,
+        fresh: options.fresh,
+    });
+    let stateFile = selection.file;
+    if (selection.mutated)
+        (0, state_1.writeDevStateFile)(worldDir, stateFile);
+    // What /dev/config hands the page. It has to track the POSTs, not stay pinned to the boot state:
+    // reloading the tab is the ordinary way to check that a simulated save survived.
+    let liveState = selection.state;
+    // The seed REPLACES the stored registry at boot (earned survives), so editing the file between runs
+    // takes effect on the next `helix dev` — the local analog of re-registering. With no seed file the
+    // stored registry is left alone, so a hand-edited dev-state.json keeps working.
+    if (achievementsSeed && liveState) {
+        const prior = liveState.achievements;
+        const earned = typeof prior === 'object' && prior !== null && Array.isArray(prior.earned)
+            ? prior.earned
+            : [];
+        liveState.achievements = { registry: achievementsSeed.achievements, earned };
+    }
+    const shellPort = options.port ?? exports.DEV_SHELL_DEFAULT_PORT;
+    const worldPort = shellPort ? shellPort + 1 : 0;
+    let worldServer;
+    try {
+        worldServer = await (0, staticServe_1.startStaticServer)(distDir, {}, '', { port: worldPort });
+    }
+    catch (err) {
+        throw listenError(err, worldPort);
+    }
+    const worldOrigin = `http://127.0.0.1:${worldServer.port}`;
+    const products = seed?.seed ?? null;
+    const route = (req, res) => {
+        const path = (req.url ?? '/').split('?')[0];
+        if (req.method === 'GET' && (path === '/' || path === '/index.html')) {
+            text(res, 'text/html; charset=utf-8', shellPage_1.DEV_SHELL_PAGE_HTML);
+            return true;
+        }
+        if (req.method === 'GET' && path === '/dev/shell.js') {
+            text(res, 'text/javascript; charset=utf-8', shellPage_1.DEV_SHELL_PAGE_JS);
+            return true;
+        }
+        if (req.method === 'GET' && path === '/dev/config') {
+            json(res, 200, {
+                mode: 'simulated',
+                worldOrigin,
+                world,
+                user: selection.identity,
+                state: liveState,
+                products,
+                // For the page's fresh-player path: a null state still needs the registry minted into it.
+                achievements: achievementsSeed?.achievements ?? null,
+                stateFile: (0, state_1.devStatePath)(worldDir),
+                flags: { reset: Boolean(options.reset), fresh: Boolean(options.fresh) },
+            });
+            return true;
+        }
+        if (path === '/dev/state') {
+            if (req.method !== 'POST') {
+                json(res, 405, { error: 'POST the serialized dev-shell state here' });
+                return true;
+            }
+            readBody(req, STATE_LIMIT_BYTES)
+                .then((body) => {
+                const parsed = JSON.parse(body);
+                liveState = parsed;
+                stateFile = (0, state_1.recordDevState)(stateFile, world.slug, parsed);
+                (0, state_1.writeDevStateFile)(worldDir, stateFile);
+                json(res, 200, { ok: true });
+            })
+                .catch((err) => {
+                json(res, 400, { error: err instanceof Error ? err.message : String(err) });
+            });
+            return true;
+        }
+        return false;
+    };
+    let shellServer;
+    try {
+        shellServer = await (0, staticServe_1.startStaticServer)(sdkDistDir, {}, 'sdk', { port: shellPort, route });
+    }
+    catch (err) {
+        await worldServer.close();
+        throw listenError(err, shellPort);
+    }
+    return {
+        shellUrl: `http://127.0.0.1:${shellServer.port}/`,
+        worldUrl: `${worldOrigin}/`,
+        shellPort: shellServer.port,
+        worldPort: worldServer.port,
+        distDir,
+        world,
+        identity: selection.identity,
+        stateFile: (0, state_1.devStatePath)(worldDir),
+        products: seed ? { path: seed.path, count: seed.count } : null,
+        achievements: achievementsSeed
+            ? { path: achievementsSeed.path, count: achievementsSeed.count, criteriaCount: achievementsSeed.criteriaCount }
+            : null,
+        gitignore,
+        sdkDistDir,
+        close: async () => {
+            await shellServer.close();
+            await worldServer.close();
+        },
+    };
+}
+//# sourceMappingURL=devServer.js.map

package/dist/dev/devServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devServer.js","sourceRoot":"","sources":["../../src/dev/devServer.ts"],"names":[],"mappings":"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"}

package/dist/dev/shellPage.d.ts

@@ -0,0 +1,3 @@
+export declare const DEV_SHELL_BANNER: string;
+export declare const DEV_SHELL_PAGE_HTML = "<!doctype html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n<title>helix dev \u2014 SIMULATED shell</title>\n<style>\n  :root { color-scheme: dark; }\n  * { box-sizing: border-box; }\n  body { margin: 0; height: 100vh; display: flex; flex-direction: column;\n         font: 13px/1.5 ui-sans-serif, system-ui, sans-serif; background: #0d0f13; color: #e6e8ec; }\n  .banner { padding: 8px 14px; background: #7a4b00; color: #fff5e0; font-weight: 600; }\n  .banner code { background: rgba(0,0,0,.3); padding: 1px 5px; border-radius: 3px; }\n  main { flex: 1; display: flex; min-height: 0; }\n  .stage { flex: 1; min-width: 0; background: #000; position: relative; }\n  iframe { width: 100%; height: 100%; border: 0; display: block; }\n  #toast { position: absolute; left: 50%; top: 18px; transform: translateX(-50%); max-width: 80%;\n           background: #16241a; color: #c9f0c9; border: 1px solid #3f7a3f; border-radius: 6px;\n           padding: 8px 14px; font-weight: 600; opacity: 0; pointer-events: none; transition: opacity .25s; }\n  #toast.show { opacity: 1; }\n  #confirm { position: absolute; inset: 0; display: none; align-items: center; justify-content: center;\n             background: rgba(0,0,0,.55); }\n  #confirm.show { display: flex; }\n  .confirm-card { background: #161a21; border: 1px solid #3a4152; border-radius: 10px; padding: 18px 20px;\n                  width: 320px; box-shadow: 0 12px 40px rgba(0,0,0,.5); }\n  .confirm-card .tag { color: #ffcf8a; font-size: 11px; letter-spacing: .08em; text-transform: uppercase; }\n  .confirm-card h3 { margin: 4px 0 10px; font-size: 15px; }\n  .confirm-card .price { color: #b7bdc8; }\n  .confirm-card .price b { color: #e6e8ec; }\n  .confirm-card .row { display: flex; gap: 8px; justify-content: flex-end; margin-top: 16px; }\n  .confirm-card button.buy { border-color: #3f7a3f; color: #c9f0c9; }\n  .panel { width: 320px; border-left: 1px solid #23262d; display: flex; flex-direction: column; min-height: 0; }\n  .panel h2 { margin: 0; padding: 8px 12px; font-size: 11px; letter-spacing: .08em; text-transform: uppercase;\n              color: #8b93a1; border-bottom: 1px solid #23262d; }\n  .meta { padding: 8px 12px; color: #8b93a1; border-bottom: 1px solid #23262d; }\n  .meta b { color: #e6e8ec; font-weight: 600; }\n  .menu { padding: 8px; display: grid; gap: 6px; border-bottom: 1px solid #23262d; }\n  button { font: inherit; text-align: left; padding: 6px 9px; border-radius: 5px; cursor: pointer;\n           background: #1a1d24; color: #e6e8ec; border: 1px solid #2c3039; }\n  button:hover { background: #232732; }\n  button.armed { border-color: #b4741a; color: #ffcf8a; }\n  #log { flex: 1; margin: 0; padding: 8px 12px; overflow: auto; white-space: pre-wrap; word-break: break-word;\n         font: 11px/1.45 ui-monospace, SFMono-Regular, Menlo, monospace; color: #b7bdc8; }\n  #log .sim { color: #9fd39f; }\n  #log .err { color: #ff9b9b; }\n</style>\n</head>\n<body>\n<div class=\"banner\">SIMULATED shell \u2014 helix dev. Purchases, saves and achievements are simulated locally; nothing here proves a product is registered or that settlement works.</div>\n<main>\n  <div class=\"stage\"><iframe id=\"world\" title=\"world\" allow=\"autoplay; microphone; gamepad; fullscreen\"></iframe><div id=\"toast\"></div><div id=\"confirm\"><div class=\"confirm-card\"><div class=\"tag\">Simulated purchase</div><h3 id=\"confirmTitle\"></h3><div class=\"price\" id=\"confirmPrice\"></div><div class=\"row\"><button id=\"confirmCancel\">Cancel</button><button id=\"confirmBuy\" class=\"buy\">Buy</button></div></div></div></div>\n  <aside class=\"panel\">\n    <h2>helix dev \u2014 simulated</h2>\n    <div class=\"meta\" id=\"meta\">loading\u2026</div>\n    <h2>Debug menu</h2>\n    <div class=\"menu\" id=\"menu\"></div>\n    <h2>Log</h2>\n    <pre id=\"log\"></pre>\n  </aside>\n</main>\n<script type=\"module\" src=\"/dev/shell.js\"></script>\n</body>\n</html>\n";
+export declare const DEV_SHELL_PAGE_JS = "// Served by `helix dev`. Everything here is SIMULATED \u2014 see the banner.\nconst logEl = document.getElementById('log');\nconst menuEl = document.getElementById('menu');\nconst metaEl = document.getElementById('meta');\nconst frame = document.getElementById('world');\nconst toastEl = document.getElementById('toast');\n\nlet toastTimer = null;\nfunction toast(text) {\n  toastEl.textContent = text;\n  toastEl.className = 'show';\n  if (toastTimer) clearTimeout(toastTimer);\n  toastTimer = setTimeout(function () { toastEl.className = ''; }, 4000);\n}\n\n// The real shell's purchase confirm, simulated: one dialog at a time, queued in arrival order.\nconst confirmEl = document.getElementById('confirm');\nlet confirmChain = Promise.resolve();\nfunction confirmPurchase(req) {\n  const ask = function () {\n    return new Promise(function (done) {\n      document.getElementById('confirmTitle').textContent = req.title;\n      document.getElementById('confirmPrice').innerHTML = req.isFree\n        ? 'Free claim &middot; balance stays <b>' + req.balanceLix + ' LIX</b>'\n        : '<b>' + req.priceLix + ' LIX</b> &middot; balance ' + req.balanceLix + ' &rarr; <b>' + req.balanceAfterLix + '</b>';\n      confirmEl.className = 'show';\n      const buy = document.getElementById('confirmBuy');\n      const cancel = document.getElementById('confirmCancel');\n      const settle = function (verdict) {\n        confirmEl.className = '';\n        buy.onclick = null;\n        cancel.onclick = null;\n        done(verdict);\n      };\n      buy.onclick = function () { settle(true); };\n      cancel.onclick = function () { settle(false); };\n    });\n  };\n  const result = confirmChain.then(ask);\n  confirmChain = result.then(function () {}, function () {});\n  return result;\n}\n\nfunction append(text, kind) {\n  const line = document.createElement('div');\n  if (kind) line.className = kind;\n  line.textContent = text;\n  logEl.appendChild(line);\n  while (logEl.childElementCount > 500) logEl.removeChild(logEl.firstChild);\n  logEl.scrollTop = logEl.scrollHeight;\n}\n\nfunction show(value) {\n  if (value === undefined) return '';\n  try {\n    return typeof value === 'string' ? value : JSON.stringify(value);\n  } catch (err) {\n    return String(value);\n  }\n}\n\nfunction button(label, onClick) {\n  const el = document.createElement('button');\n  el.textContent = label;\n  el.addEventListener('click', function () { onClick(el); });\n  menuEl.appendChild(el);\n  return el;\n}\n\nasync function main() {\n  const config = await (await fetch('/dev/config')).json();\n  frame.src = config.worldOrigin + '/';\n\n  const devShell = await import('/sdk/dev-shell/index.js');\n  const prefix = devShell.DEV_SHELL_LOG_PREFIX;\n\n  let pending = null;\n  let sending = false;\n  async function flush() {\n    if (sending || pending === null) return;\n    sending = true;\n    const body = pending;\n    pending = null;\n    try {\n      await fetch('/dev/state', { method: 'POST', headers: { 'content-type': 'application/json' }, body: body });\n    } catch (err) {\n      append('state was not saved: ' + String(err), 'err');\n    }\n    sending = false;\n    flush();\n  }\n\n  // A fresh player has no stored state, so the seeded achievement registry is minted into a new one here.\n  const freshState = !config.state && config.achievements\n    ? devShell.createDevShellState({ identity: config.user, achievements: config.achievements })\n    : undefined;\n\n  const shell = devShell.createDevShell({\n    worldWindow: frame,\n    worldOrigin: config.worldOrigin,\n    world: config.world,\n    user: config.user,\n    state: config.state || freshState,\n    products: config.products || undefined,\n    debug: true,\n    onAchievementEarned: function (a) {\n      toast('Achievement unlocked (SIMULATED): ' + a.name + (a.points ? ' (+' + a.points + ')' : ''));\n    },\n    confirmPurchase: confirmPurchase,\n    log: function (message, detail) {\n      append(detail === undefined ? message : message + ' ' + show(detail), message.indexOf(prefix) === 0 ? 'sim' : null);\n      if (detail === undefined) console.log(message);\n      else console.log(message, detail);\n    },\n    onStateChange: function (state) {\n      pending = JSON.stringify(state);\n      flush();\n    },\n  });\n  window.helixDevShell = shell;\n\n  metaEl.innerHTML =\n    '<div>world <b>' + config.world.title + '</b> (' + config.world.slug + ')</div>' +\n    '<div>player <b>' + config.user.id + '</b></div>' +\n    '<div>served from ' + config.worldOrigin + '</div>';\n\n  let failMode = 'off';\n  let saveFailure = false;\n  let signedIn = true;\n\n  button('Grant all entitlements', function () { shell.grantAllEntitlements(); });\n  button('Grant one entitlement\u2026', function () {\n    const ref = window.prompt('Product key or ref to grant');\n    if (ref) shell.grantEntitlement(ref);\n  });\n  button('Remove one entitlement\u2026', function () {\n    const ref = window.prompt('Product key or ref to remove');\n    if (ref) shell.removeEntitlement(ref);\n  });\n  button('Print owned entitlements', function () {\n    append(prefix + ' entitlements ' + show(shell.getEntitlementsSnapshot()), 'sim');\n  });\n  const failButton = button('Purchases always fail: off', function (el) {\n    failMode = shell.cyclePurchasesAlwaysFail();\n    el.textContent = 'Purchases always fail: ' + failMode;\n    el.className = failMode === 'off' ? '' : 'armed';\n  });\n  failButton.textContent = 'Purchases always fail: ' + failMode;\n  button('Reset player document', function () { shell.resetPlayerDocument(); });\n  button('Force save failure: off', function (el) {\n    saveFailure = !saveFailure;\n    shell.setForceSaveFailure(saveFailure);\n    el.textContent = 'Force save failure: ' + (saveFailure ? 'on' : 'off');\n    el.className = saveFailure ? 'armed' : '';\n  });\n  button('Exhaust consume fence', function () { shell.exhaustConsumeFence(); });\n  button('Set wallet\u2026', function () {\n    const lix = window.prompt('Simulated LIX balance', '500');\n    if (lix !== null && lix !== '') shell.setWallet({ lix: Number(lix) });\n  });\n  button('Award achievement\u2026', function () {\n    const key = window.prompt('Achievement key to award (must be in the local registry)');\n    if (key) shell.awardAchievement(key);\n  });\n  button('Print achievement progress', function () { shell.getAchievementsProgress(); });\n  button('Add 5 min playtime', function () {\n    shell.addPlaytime(300);\n    append(prefix + ' +300s playtime added', 'sim');\n  });\n  button('Bump analytics event\u2026', function () {\n    const name = window.prompt('Analytics event name (e.g. world_entered) \u2014 real events never reach a shell');\n    if (name) shell.bumpAnalyticsEvent(name);\n  });\n  button('Set MP player var\u2026', function () {\n    const field = window.prompt('Persistent playerVar (dot-path, e.g. wins)');\n    if (!field) return;\n    const value = window.prompt('Numeric value for \"' + field + '\"', '1');\n    if (value !== null && value !== '') shell.setMpPlayerVar(field, Number(value));\n  });\n  button('Reset earned achievements', function () { shell.resetAchievements(); });\n  button('Seed leaderboard score\u2026', function () {\n    const board = window.prompt('Board name (declared boards are room-written live \u2014 this is the room, by hand)', 'main');\n    if (!board) return;\n    const player = window.prompt('Player name (empty = the simulated player)');\n    const score = window.prompt('Score', '100');\n    if (score === null || score === '') return;\n    shell.seedLeaderboardScore(board, Number(score), player ? { subject: player, displayName: player } : {});\n  });\n  button('Set data-store doc\u2026', function () {\n    const key = window.prompt('Document key (world-global / mp:world:* / reserved keys allowed \u2014 this is the server, by hand)');\n    if (!key) return;\n    const raw = window.prompt('JSON value for \"' + key + '\"', '{}');\n    if (raw === null) return;\n    try { shell.seedDocument(key, JSON.parse(raw)); }\n    catch (err) { append('not valid JSON: ' + String(err), 'err'); }\n  });\n  button('Push shell event\u2026', function () {\n    const event = window.prompt('Shell event (avatar-changed, equipment-changed, overlay-open, overlay-closed, \u2026)');\n    if (event) shell.pushEvent(event);\n  });\n  button('Signed in: yes', function (el) {\n    signedIn = !signedIn;\n    shell.setSignedIn(signedIn);\n    el.textContent = 'Signed in: ' + (signedIn ? 'yes' : 'no');\n    el.className = signedIn ? '' : 'armed';\n  });\n  button('Print state', function () { append(prefix + ' state ' + show(shell.getState()), 'sim'); });\n  button('Reload world', function () { frame.src = config.worldOrigin + '/?t=' + Date.now(); });\n  button('Clear log', function () { logEl.textContent = ''; });\n\n  // Playtime evidence accrues while the shell is open \u2014 the local stand-in for the server's rollup.\n  setInterval(function () { shell.addPlaytime(15); }, 15000);\n\n  append(prefix + ' shell ready \u2014 the room lane (DSL rules, consume/save/saveRoom) is NOT simulated; ' +\n    'the debug menu stands in for awardAchievement and the persistent-var flush.', 'sim');\n}\n\nmain().catch(function (err) {\n  append('dev shell failed to start: ' + String(err && err.stack ? err.stack : err), 'err');\n});\n";

package/dist/dev/shellPage.js

@@ -0,0 +1,297 @@
+"use strict";
+// The `helix dev` shell page, served from memory: an iframe for the world plus the SDK dev shell's debug
+// menu. Authored as strings rather than as .html/.js files because the CLI's build is `tsc` alone — a
+// non-TS asset under src/ would never reach dist/ and the published CLI would serve nothing.
+//
+// The browser half is dependency-free ES2020 and avoids template literals, so it survives being embedded
+// in one here.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEV_SHELL_PAGE_JS = exports.DEV_SHELL_PAGE_HTML = exports.DEV_SHELL_BANNER = void 0;
+exports.DEV_SHELL_BANNER = 'SIMULATED shell — helix dev. Purchases, saves and achievements are simulated locally; ' +
+    'nothing here proves a product is registered or that settlement works.';
+exports.DEV_SHELL_PAGE_HTML = `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>helix dev — SIMULATED shell</title>
+<style>
+  :root { color-scheme: dark; }
+  * { box-sizing: border-box; }
+  body { margin: 0; height: 100vh; display: flex; flex-direction: column;
+         font: 13px/1.5 ui-sans-serif, system-ui, sans-serif; background: #0d0f13; color: #e6e8ec; }
+  .banner { padding: 8px 14px; background: #7a4b00; color: #fff5e0; font-weight: 600; }
+  .banner code { background: rgba(0,0,0,.3); padding: 1px 5px; border-radius: 3px; }
+  main { flex: 1; display: flex; min-height: 0; }
+  .stage { flex: 1; min-width: 0; background: #000; position: relative; }
+  iframe { width: 100%; height: 100%; border: 0; display: block; }
+  #toast { position: absolute; left: 50%; top: 18px; transform: translateX(-50%); max-width: 80%;
+           background: #16241a; color: #c9f0c9; border: 1px solid #3f7a3f; border-radius: 6px;
+           padding: 8px 14px; font-weight: 600; opacity: 0; pointer-events: none; transition: opacity .25s; }
+  #toast.show { opacity: 1; }
+  #confirm { position: absolute; inset: 0; display: none; align-items: center; justify-content: center;
+             background: rgba(0,0,0,.55); }
+  #confirm.show { display: flex; }
+  .confirm-card { background: #161a21; border: 1px solid #3a4152; border-radius: 10px; padding: 18px 20px;
+                  width: 320px; box-shadow: 0 12px 40px rgba(0,0,0,.5); }
+  .confirm-card .tag { color: #ffcf8a; font-size: 11px; letter-spacing: .08em; text-transform: uppercase; }
+  .confirm-card h3 { margin: 4px 0 10px; font-size: 15px; }
+  .confirm-card .price { color: #b7bdc8; }
+  .confirm-card .price b { color: #e6e8ec; }
+  .confirm-card .row { display: flex; gap: 8px; justify-content: flex-end; margin-top: 16px; }
+  .confirm-card button.buy { border-color: #3f7a3f; color: #c9f0c9; }
+  .panel { width: 320px; border-left: 1px solid #23262d; display: flex; flex-direction: column; min-height: 0; }
+  .panel h2 { margin: 0; padding: 8px 12px; font-size: 11px; letter-spacing: .08em; text-transform: uppercase;
+              color: #8b93a1; border-bottom: 1px solid #23262d; }
+  .meta { padding: 8px 12px; color: #8b93a1; border-bottom: 1px solid #23262d; }
+  .meta b { color: #e6e8ec; font-weight: 600; }
+  .menu { padding: 8px; display: grid; gap: 6px; border-bottom: 1px solid #23262d; }
+  button { font: inherit; text-align: left; padding: 6px 9px; border-radius: 5px; cursor: pointer;
+           background: #1a1d24; color: #e6e8ec; border: 1px solid #2c3039; }
+  button:hover { background: #232732; }
+  button.armed { border-color: #b4741a; color: #ffcf8a; }
+  #log { flex: 1; margin: 0; padding: 8px 12px; overflow: auto; white-space: pre-wrap; word-break: break-word;
+         font: 11px/1.45 ui-monospace, SFMono-Regular, Menlo, monospace; color: #b7bdc8; }
+  #log .sim { color: #9fd39f; }
+  #log .err { color: #ff9b9b; }
+</style>
+</head>
+<body>
+<div class="banner">${exports.DEV_SHELL_BANNER}</div>
+<main>
+  <div class="stage"><iframe id="world" title="world" allow="autoplay; microphone; gamepad; fullscreen"></iframe><div id="toast"></div><div id="confirm"><div class="confirm-card"><div class="tag">Simulated purchase</div><h3 id="confirmTitle"></h3><div class="price" id="confirmPrice"></div><div class="row"><button id="confirmCancel">Cancel</button><button id="confirmBuy" class="buy">Buy</button></div></div></div></div>
+  <aside class="panel">
+    <h2>helix dev — simulated</h2>
+    <div class="meta" id="meta">loading…</div>
+    <h2>Debug menu</h2>
+    <div class="menu" id="menu"></div>
+    <h2>Log</h2>
+    <pre id="log"></pre>
+  </aside>
+</main>
+<script type="module" src="/dev/shell.js"></script>
+</body>
+</html>
+`;
+exports.DEV_SHELL_PAGE_JS = `// Served by \`helix dev\`. Everything here is SIMULATED — see the banner.
+const logEl = document.getElementById('log');
+const menuEl = document.getElementById('menu');
+const metaEl = document.getElementById('meta');
+const frame = document.getElementById('world');
+const toastEl = document.getElementById('toast');
+
+let toastTimer = null;
+function toast(text) {
+  toastEl.textContent = text;
+  toastEl.className = 'show';
+  if (toastTimer) clearTimeout(toastTimer);
+  toastTimer = setTimeout(function () { toastEl.className = ''; }, 4000);
+}
+
+// The real shell's purchase confirm, simulated: one dialog at a time, queued in arrival order.
+const confirmEl = document.getElementById('confirm');
+let confirmChain = Promise.resolve();
+function confirmPurchase(req) {
+  const ask = function () {
+    return new Promise(function (done) {
+      document.getElementById('confirmTitle').textContent = req.title;
+      document.getElementById('confirmPrice').innerHTML = req.isFree
+        ? 'Free claim &middot; balance stays <b>' + req.balanceLix + ' LIX</b>'
+        : '<b>' + req.priceLix + ' LIX</b> &middot; balance ' + req.balanceLix + ' &rarr; <b>' + req.balanceAfterLix + '</b>';
+      confirmEl.className = 'show';
+      const buy = document.getElementById('confirmBuy');
+      const cancel = document.getElementById('confirmCancel');
+      const settle = function (verdict) {
+        confirmEl.className = '';
+        buy.onclick = null;
+        cancel.onclick = null;
+        done(verdict);
+      };
+      buy.onclick = function () { settle(true); };
+      cancel.onclick = function () { settle(false); };
+    });
+  };
+  const result = confirmChain.then(ask);
+  confirmChain = result.then(function () {}, function () {});
+  return result;
+}
+
+function append(text, kind) {
+  const line = document.createElement('div');
+  if (kind) line.className = kind;
+  line.textContent = text;
+  logEl.appendChild(line);
+  while (logEl.childElementCount > 500) logEl.removeChild(logEl.firstChild);
+  logEl.scrollTop = logEl.scrollHeight;
+}
+
+function show(value) {
+  if (value === undefined) return '';
+  try {
+    return typeof value === 'string' ? value : JSON.stringify(value);
+  } catch (err) {
+    return String(value);
+  }
+}
+
+function button(label, onClick) {
+  const el = document.createElement('button');
+  el.textContent = label;
+  el.addEventListener('click', function () { onClick(el); });
+  menuEl.appendChild(el);
+  return el;
+}
+
+async function main() {
+  const config = await (await fetch('/dev/config')).json();
+  frame.src = config.worldOrigin + '/';
+
+  const devShell = await import('/sdk/dev-shell/index.js');
+  const prefix = devShell.DEV_SHELL_LOG_PREFIX;
+
+  let pending = null;
+  let sending = false;
+  async function flush() {
+    if (sending || pending === null) return;
+    sending = true;
+    const body = pending;
+    pending = null;
+    try {
+      await fetch('/dev/state', { method: 'POST', headers: { 'content-type': 'application/json' }, body: body });
+    } catch (err) {
+      append('state was not saved: ' + String(err), 'err');
+    }
+    sending = false;
+    flush();
+  }
+
+  // A fresh player has no stored state, so the seeded achievement registry is minted into a new one here.
+  const freshState = !config.state && config.achievements
+    ? devShell.createDevShellState({ identity: config.user, achievements: config.achievements })
+    : undefined;
+
+  const shell = devShell.createDevShell({
+    worldWindow: frame,
+    worldOrigin: config.worldOrigin,
+    world: config.world,
+    user: config.user,
+    state: config.state || freshState,
+    products: config.products || undefined,
+    debug: true,
+    onAchievementEarned: function (a) {
+      toast('Achievement unlocked (SIMULATED): ' + a.name + (a.points ? ' (+' + a.points + ')' : ''));
+    },
+    confirmPurchase: confirmPurchase,
+    log: function (message, detail) {
+      append(detail === undefined ? message : message + ' ' + show(detail), message.indexOf(prefix) === 0 ? 'sim' : null);
+      if (detail === undefined) console.log(message);
+      else console.log(message, detail);
+    },
+    onStateChange: function (state) {
+      pending = JSON.stringify(state);
+      flush();
+    },
+  });
+  window.helixDevShell = shell;
+
+  metaEl.innerHTML =
+    '<div>world <b>' + config.world.title + '</b> (' + config.world.slug + ')</div>' +
+    '<div>player <b>' + config.user.id + '</b></div>' +
+    '<div>served from ' + config.worldOrigin + '</div>';
+
+  let failMode = 'off';
+  let saveFailure = false;
+  let signedIn = true;
+
+  button('Grant all entitlements', function () { shell.grantAllEntitlements(); });
+  button('Grant one entitlement…', function () {
+    const ref = window.prompt('Product key or ref to grant');
+    if (ref) shell.grantEntitlement(ref);
+  });
+  button('Remove one entitlement…', function () {
+    const ref = window.prompt('Product key or ref to remove');
+    if (ref) shell.removeEntitlement(ref);
+  });
+  button('Print owned entitlements', function () {
+    append(prefix + ' entitlements ' + show(shell.getEntitlementsSnapshot()), 'sim');
+  });
+  const failButton = button('Purchases always fail: off', function (el) {
+    failMode = shell.cyclePurchasesAlwaysFail();
+    el.textContent = 'Purchases always fail: ' + failMode;
+    el.className = failMode === 'off' ? '' : 'armed';
+  });
+  failButton.textContent = 'Purchases always fail: ' + failMode;
+  button('Reset player document', function () { shell.resetPlayerDocument(); });
+  button('Force save failure: off', function (el) {
+    saveFailure = !saveFailure;
+    shell.setForceSaveFailure(saveFailure);
+    el.textContent = 'Force save failure: ' + (saveFailure ? 'on' : 'off');
+    el.className = saveFailure ? 'armed' : '';
+  });
+  button('Exhaust consume fence', function () { shell.exhaustConsumeFence(); });
+  button('Set wallet…', function () {
+    const lix = window.prompt('Simulated LIX balance', '500');
+    if (lix !== null && lix !== '') shell.setWallet({ lix: Number(lix) });
+  });
+  button('Award achievement…', function () {
+    const key = window.prompt('Achievement key to award (must be in the local registry)');
+    if (key) shell.awardAchievement(key);
+  });
+  button('Print achievement progress', function () { shell.getAchievementsProgress(); });
+  button('Add 5 min playtime', function () {
+    shell.addPlaytime(300);
+    append(prefix + ' +300s playtime added', 'sim');
+  });
+  button('Bump analytics event…', function () {
+    const name = window.prompt('Analytics event name (e.g. world_entered) — real events never reach a shell');
+    if (name) shell.bumpAnalyticsEvent(name);
+  });
+  button('Set MP player var…', function () {
+    const field = window.prompt('Persistent playerVar (dot-path, e.g. wins)');
+    if (!field) return;
+    const value = window.prompt('Numeric value for "' + field + '"', '1');
+    if (value !== null && value !== '') shell.setMpPlayerVar(field, Number(value));
+  });
+  button('Reset earned achievements', function () { shell.resetAchievements(); });
+  button('Seed leaderboard score…', function () {
+    const board = window.prompt('Board name (declared boards are room-written live — this is the room, by hand)', 'main');
+    if (!board) return;
+    const player = window.prompt('Player name (empty = the simulated player)');
+    const score = window.prompt('Score', '100');
+    if (score === null || score === '') return;
+    shell.seedLeaderboardScore(board, Number(score), player ? { subject: player, displayName: player } : {});
+  });
+  button('Set data-store doc…', function () {
+    const key = window.prompt('Document key (world-global / mp:world:* / reserved keys allowed — this is the server, by hand)');
+    if (!key) return;
+    const raw = window.prompt('JSON value for "' + key + '"', '{}');
+    if (raw === null) return;
+    try { shell.seedDocument(key, JSON.parse(raw)); }
+    catch (err) { append('not valid JSON: ' + String(err), 'err'); }
+  });
+  button('Push shell event…', function () {
+    const event = window.prompt('Shell event (avatar-changed, equipment-changed, overlay-open, overlay-closed, …)');
+    if (event) shell.pushEvent(event);
+  });
+  button('Signed in: yes', function (el) {
+    signedIn = !signedIn;
+    shell.setSignedIn(signedIn);
+    el.textContent = 'Signed in: ' + (signedIn ? 'yes' : 'no');
+    el.className = signedIn ? '' : 'armed';
+  });
+  button('Print state', function () { append(prefix + ' state ' + show(shell.getState()), 'sim'); });
+  button('Reload world', function () { frame.src = config.worldOrigin + '/?t=' + Date.now(); });
+  button('Clear log', function () { logEl.textContent = ''; });
+
+  // Playtime evidence accrues while the shell is open — the local stand-in for the server's rollup.
+  setInterval(function () { shell.addPlaytime(15); }, 15000);
+
+  append(prefix + ' shell ready — the room lane (DSL rules, consume/save/saveRoom) is NOT simulated; ' +
+    'the debug menu stands in for awardAchievement and the persistent-var flush.', 'sim');
+}
+
+main().catch(function (err) {
+  append('dev shell failed to start: ' + String(err && err.stack ? err.stack : err), 'err');
+});
+`;
+//# sourceMappingURL=shellPage.js.map

package/dist/dev/shellPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellPage.js","sourceRoot":"","sources":["../../src/dev/shellPage.ts"],"names":[],"mappings":";AAAA,yGAAyG;AACzG,sGAAsG;AACtG,6FAA6F;AAC7F,EAAE;AACF,yGAAyG;AACzG,eAAe;;;AAEF,QAAA,gBAAgB,GAC3B,wFAAwF;IACxF,uEAAuE,CAAC;AAE7D,QAAA,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAgDb,wBAAgB;;;;;;;;;;;;;;;CAerC,CAAC;AAEW,QAAA,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4NhC,CAAC"}