@dcl/sdk-commands 7.22.6-25007982108.commit-83012ab → 7.22.6-25321038582.commit-63ddb3f

package/dist/commands/sdk-server-logs/index.js

@@ -0,0 +1,313 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.args = void 0;
+exports.help = help;
+exports.main = main;
+const path_1 = require("path");
+const fp_future_1 = __importDefault(require("fp-future"));
+const crypto_1 = require("@dcl/crypto");
+const crypto_2 = require("@dcl/crypto/dist/crypto");
+const eth_connect_1 = require("eth-connect");
+const args_1 = require("../../logic/args");
+const error_1 = require("../../logic/error");
+const beautiful_logs_1 = require("../../logic/beautiful-logs");
+const account_1 = require("../../logic/account");
+const auth_chain_headers_1 = require("../../logic/auth-chain-headers");
+const routes_1 = require("../../linker-dapp/routes");
+const run_dapp_1 = require("../../run-dapp");
+const workspace_validations_1 = require("../../logic/workspace-validations");
+const scene_validations_1 = require("../../logic/scene-validations");
+exports.args = (0, args_1.declareArgs)({
+    '--help': Boolean,
+    '-h': '--help',
+    '--dir': String,
+    '--world': String,
+    '-w': '--world',
+    '--position': String,
+    '--target': String,
+    '-t': '--target',
+    '--port': Number,
+    '-p': '--port',
+    '--https': Boolean,
+    '--no-browser': Boolean,
+    '-b': '--no-browser'
+});
+const DEFAULT_SERVER = 'https://multiplayer-server.decentraland.org';
+function help(options) {
+    options.components.logger.log(`
+  Usage: 'sdk-commands sdk-server-logs [options]'
+    Streams real-time logs from the multiplayer server.
+    Runs from any directory when --world and/or --position are provided.
+    Falls back to scene.json (worldConfiguration.name) when neither is passed.
+
+    Options:
+      -h, --help                Displays complete help
+      -w, --world       [name]  World name. When omitted, --position targets Genesis City.
+      --position        [x,y]   Parcel coordinates. Optional for worlds (selects a scene
+                                in a multi-scene world). Required for Genesis City.
+      -t, --target      [URL]   Target multiplayer server URL (default: ${DEFAULT_SERVER})
+      --dir             [path]  Path to the project directory (used with scene.json fallback)
+      -p, --port        [port]  Select a custom port for the linker dApp
+      -b, --no-browser          Do not open a new browser window
+      --https                   Use HTTPS for the linker dApp
+
+    Examples:
+    - View logs using the world in the current scene.json:
+      $ sdk-commands sdk-server-logs
+
+    - View logs for a world from any directory:
+      $ sdk-commands sdk-server-logs --world myworld.dcl.eth
+
+    - View logs for a specific scene in a multi-scene world:
+      $ sdk-commands sdk-server-logs --world myworld.dcl.eth --position 10,10
+
+    - View logs for a Genesis City scene (use =value form for negative coords):
+      $ sdk-commands sdk-server-logs --position=-125,-96
+
+    - Connect to a custom server:
+      $ sdk-commands sdk-server-logs --world myworld --target https://multiplayer-server.decentraland.zone
+
+    - Use private key for authentication (no browser):
+      $ DCL_PRIVATE_KEY=0x... sdk-commands sdk-server-logs --world myworld
+`);
+}
+function setServerLogsRoutes(router, components, awaitResponse, signCallback) {
+    const { logger } = components;
+    const resolveLinkerPromise = () => setTimeout(() => awaitResponse.resolve(), 100);
+    const rejectLinkerPromise = (e) => setTimeout(() => awaitResponse.reject(e), 100);
+    router.post('/api/logs', async (ctx) => {
+        const value = (await ctx.request.json());
+        if (!value.address || !value.authChain) {
+            const errorMessage = `Invalid payload: ${Object.keys(value).join(' - ')}`;
+            logger.error(errorMessage);
+            resolveLinkerPromise();
+            return { status: 400, body: { success: false, error: errorMessage } };
+        }
+        try {
+            await signCallback(value);
+            resolveLinkerPromise();
+            return { body: { success: true } };
+        }
+        catch (e) {
+            rejectLinkerPromise(e);
+            return { status: 400, body: { success: false, error: e.message } };
+        }
+    });
+    return router;
+}
+async function getAddressAndSignature(components, awaitResponse, payload, displayLabel, targetUrl, linkOptions, signCallback) {
+    // If DCL_PRIVATE_KEY is set, sign directly without the linker dapp
+    if (process.env.DCL_PRIVATE_KEY) {
+        const wallet = (0, account_1.createWallet)(process.env.DCL_PRIVATE_KEY);
+        const authChain = crypto_1.Authenticator.createSimpleAuthChain(payload, wallet.address, (0, crypto_2.ethSign)((0, eth_connect_1.hexToBytes)(wallet.privateKey), payload));
+        const linkerResponse = { authChain, address: wallet.address };
+        await signCallback(linkerResponse);
+        awaitResponse.resolve();
+        return {};
+    }
+    // Use linker dapp for signing - pass the payload as the rootCID
+    const { router: commonRouter } = (0, routes_1.setRoutes)(components, {
+        rootCID: payload,
+        baseParcel: '0,0',
+        parcels: ['0,0'],
+        skipValidations: true,
+        debug: !!process.env.DEBUG,
+        isWorld: true,
+        world: displayLabel,
+        targetUrl,
+        action: 'view-logs'
+    });
+    const router = setServerLogsRoutes(commonRouter, components, awaitResponse, signCallback);
+    components.logger.info('You need to sign to access server logs');
+    const { program } = await (0, run_dapp_1.runDapp)(components, router, { ...linkOptions, uri: `/` });
+    return { program };
+}
+async function streamLogs(components, logsUrl, authHeaders) {
+    const { logger, fetch: fetchComponent } = components;
+    logger.info('\nConnecting to server logs...');
+    try {
+        const response = await fetchComponent.fetch(logsUrl, {
+            method: 'GET',
+            headers: {
+                ...authHeaders,
+                Accept: 'text/event-stream'
+            }
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Server returned ${response.status}: ${errorText}`);
+        }
+        const contentType = response.headers.get('content-type') || '';
+        if (!contentType.includes('text/event-stream') && !contentType.includes('application/stream')) {
+            throw new Error('Server does not support SSE streaming');
+        }
+        logger.info('Streaming logs in real-time (press CTRL+C to stop)');
+        if (response.body) {
+            const decoder = new TextDecoder();
+            let buffer = '';
+            for await (const chunk of response.body) {
+                buffer += decoder.decode(chunk, { stream: true });
+                const lines = buffer.split('\n');
+                buffer = lines.pop() || '';
+                for (const line of lines) {
+                    if (line.trim()) {
+                        formatAndPrintLog(logger, line);
+                    }
+                }
+            }
+        }
+        logger.info('\n======================= End Scene Logs =======================');
+    }
+    catch (e) {
+        (0, beautiful_logs_1.printError)(logger, 'Failed to stream logs:', e);
+        process.exit(1);
+    }
+}
+function formatAndPrintLog(logger, log) {
+    // If log is a string, try to parse as JSON
+    let logObj = log;
+    if (typeof log === 'string') {
+        try {
+            logObj = JSON.parse(log);
+        }
+        catch {
+            // If not JSON, just print the string
+            logger.log(log);
+            return;
+        }
+    }
+    // Extract common log fields
+    const timestamp = logObj.timestamp || logObj.time || new Date().toISOString();
+    const level = (logObj.level || logObj.severity || 'INFO').toUpperCase();
+    const message = logObj.message || logObj.msg || JSON.stringify(logObj);
+    // Format timestamp
+    const date = new Date(timestamp);
+    const formattedTime = date.toISOString().replace('T', ' ').substring(0, 19);
+    // Format the log message with timestamp
+    const formattedMessage = `[${formattedTime}] [${level}] ${message}`;
+    // Map log levels to logger methods
+    const normalizedLevel = level.toLowerCase();
+    switch (normalizedLevel) {
+        case 'error':
+            logger.error(formattedMessage);
+            break;
+        case 'warn':
+        case 'warning':
+            logger.warn(formattedMessage);
+            break;
+        case 'debug':
+            logger.debug(formattedMessage);
+            break;
+        case 'info':
+        case 'trace':
+        default:
+            logger.info(formattedMessage);
+            break;
+    }
+    // If there are additional fields, print them
+    const additionalFields = Object.keys(logObj).filter((key) => !['timestamp', 'time', 'level', 'severity', 'message', 'msg'].includes(key));
+    if (additionalFields.length > 0) {
+        const additional = {};
+        additionalFields.forEach((key) => {
+            additional[key] = logObj[key];
+        });
+        logger.log(`  ${JSON.stringify(additional)}`);
+    }
+}
+function normalizePosition(raw) {
+    const match = raw.trim().match(/^(-?\d+)\s*,\s*(-?\d+)$/);
+    if (!match) {
+        throw new error_1.CliError('SERVER_LOGS_INVALID_POSITION', `Invalid --position "${raw}"; expected "x,y" with integer coordinates`);
+    }
+    return `${parseInt(match[1], 10)},${parseInt(match[2], 10)}`;
+}
+/**
+ * Build the HTTP request shape for the multiplayer-server `/logs` endpoint.
+ *
+ * Every call targets the same `/logs` route; the server picks the scene from
+ * the signed metadata:
+ *   - worlds  → `sceneId: "<world>.dcl.eth"` (+ `parcel` for multi-scene worlds)
+ *   - Genesis → `parcel: "x,y"` only
+ *
+ * `parcel` and `realmName` are always set. `realmName` defaults to `"main"` for
+ * Genesis, matching the convention used by other signed-fetch emitters
+ * (hammurabi worker, unity explorer, kernel).
+ */
+function buildLogsRequest(baseURL, world, position) {
+    const metadata = JSON.stringify({
+        parcel: position ?? '0,0',
+        realmName: world ? `${world}.dcl.eth` : 'main',
+        ...(world && { sceneId: `${world}.dcl.eth` })
+    });
+    return {
+        logsUrl: `${baseURL}/logs`,
+        pathname: '/logs',
+        metadata
+    };
+}
+async function main(options) {
+    const { logger } = options.components;
+    const projectRoot = (0, path_1.resolve)(process.cwd(), options.args['--dir'] || '.');
+    const positionArg = options.args['--position'];
+    const worldArg = options.args['--world'];
+    const position = positionArg ? normalizePosition(positionArg) : undefined;
+    let world;
+    if (worldArg) {
+        world = worldArg.replace(/\.dcl\.eth$/i, '');
+    }
+    else if (!position) {
+        // no --world nor --position: fall back to scene.json in the current directory
+        await (0, workspace_validations_1.getValidWorkspace)(options.components, projectRoot);
+        const sceneJson = await (0, scene_validations_1.getValidSceneJson)(options.components, projectRoot);
+        const worldName = sceneJson.worldConfiguration?.name;
+        if (!worldName) {
+            throw new error_1.CliError('SERVER_LOGS_MISSING_WORLD', 'Provide --world (with optional --position) for worlds, or --position alone for Genesis City scenes. ' +
+                'Alternatively, run from a project whose scene.json defines worldConfiguration.name.');
+        }
+        world = worldName.replace(/\.dcl\.eth$/i, '');
+    }
+    const displayLabel = world
+        ? position
+            ? `${world}.dcl.eth ${position}`
+            : `${world}.dcl.eth`
+        : `Genesis City ${position}`;
+    logger.info(`Viewing logs for ${displayLabel}`);
+    const baseURL = options.args['--target'] || DEFAULT_SERVER;
+    const { logsUrl, pathname, metadata } = buildLogsRequest(baseURL, world, position);
+    // Linker dApp options
+    const linkerPort = options.args['--port'];
+    const openBrowser = !options.args['--no-browser'];
+    const isHttps = !!options.args['--https'];
+    const linkOptions = { linkerPort, openBrowser, isHttps };
+    const awaitResponse = (0, fp_future_1.default)();
+    const timestamp = String(Date.now());
+    // Build the payload to sign: method:path:timestamp:metadata
+    const payload = ['get', pathname, timestamp, metadata].join(':').toLowerCase();
+    let authHeaders = {};
+    const { program } = await getAddressAndSignature(options.components, awaitResponse, payload, displayLabel, baseURL, linkOptions, async (linkerResponse) => {
+        authHeaders = (0, auth_chain_headers_1.createAuthChainHeaders)(linkerResponse.authChain, timestamp, metadata);
+    });
+    try {
+        await awaitResponse;
+        logger.info('Authentication successful!');
+        // Close the browser window
+        if (program) {
+            await program.stop();
+        }
+        // Start streaming logs
+        await streamLogs(options.components, logsUrl, authHeaders);
+    }
+    catch (e) {
+        (0, beautiful_logs_1.printError)(logger, 'Failed to authenticate:', e);
+        throw e;
+    }
+    finally {
+        if (program) {
+            void program.stop();
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/sdk-server-logs/index.js.map

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

package/dist/commands/start/explorer-alpha.js

@@ -17,6 +17,7 @@ async function runApp(components, { cwd, realm: realmValue, baseCoords, isHub, a
     const skipAuthScreen = !!args['--skip-auth-screen'];
     const landscapeTerrainEnabled = !!args['--landscape-terrain-enabled'];
     const openDeeplinkInNewInstance = !!args['-n'];
+    const multiInstance = !!args['--multi-instance'];
     try {
         if (isWindows) {
             // On Windows, pre-check if the protocol handler is registered as `start` will silently fail otherwise.
@@ -40,6 +41,9 @@ async function runApp(components, { cwd, realm: realmValue, baseCoords, isHub, a
         if (openDeeplinkInNewInstance) {
             params.set('open-deeplink-in-new-instance', 'true');
         }
+        if (multiInstance) {
+            params.set('multi-instance', 'true');
+        }
         const queryParams = params.toString();
         const app = `decentraland://"${queryParams}"`;
         await components.spawner.exec(cwd, cmd, [app], { silent: true });

package/dist/commands/start/explorer-alpha.js.map

@@ -1 +1 @@
-{"version":3,"file":"explorer-alpha.js","sourceRoot":"","sources":["../../../src/commands/start/explorer-alpha.ts"],"names":[],"mappings":";;AAMA,4CAiBC;AAnBD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;AAExC,KAAK,UAAU,gBAAgB,CACpC,UAAyB,EACzB,IAMC;IAED,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,IAAI,CAAA;IAE9C,IAAI,MAAM,MAAM,CAAC,UAAU,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACjF,OAAM;IACR,CAAC;IAED,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,wFAAwF,CAAC,CAAA;AACjH,CAAC;AAED,KAAK,UAAU,MAAM,CACnB,UAAyB,EACzB,EACE,GAAG,EACH,KAAK,EAAE,UAAU,EACjB,UAAU,EACV,KAAK,EACL,IAAI,EAOL;IAED,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAA;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,GAAG,UAAU,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,EAAE,CAAA;IACxE,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,UAAU,CAAA;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,CAAA;IACxC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;IACnD,MAAM,uBAAuB,GAAG,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAA;IACrE,MAAM,yBAAyB,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAE9C,IAAI,CAAC;QACH,IAAI,SAAS,EAAE,CAAC;YACd,uGAAuG;YACvG,6FAA6F;YAC7F,MAAM,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,iCAAiC,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QAClH,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;QAEpC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAC1B,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;QAChC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAE5B,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;QAEjC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QAC3B,CAAC;QACD,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,CAAC,GAAG,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAA;QACxC,CAAC;QACD,IAAI,uBAAuB,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAA;QACjD,CAAC;QACD,IAAI,yBAAyB,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,CAAC,+BAA+B,EAAE,MAAM,CAAC,CAAA;QACrD,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;QAErC,MAAM,GAAG,GAAG,mBAAmB,WAAW,GAAG,CAAA;QAC7C,MAAM,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QAChE,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,kCAAkC,WAAW,IAAI,CAAC,CAAA;QACzE,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,2CAA2C,EAAE,CAAC,CAAC,OAAO,CAAC,CAAA;QAC/E,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"explorer-alpha.js","sourceRoot":"","sources":["../../../src/commands/start/explorer-alpha.ts"],"names":[],"mappings":"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"}

package/dist/commands/start/hammurabi-server.d.ts

@@ -0,0 +1,19 @@
+import { ChildProcess } from 'child_process';
+import { CliComponents } from '../../components';
+import { PreviewComponents } from './types';
+import { ProjectUnion } from '../../logic/project-validations';
+/**
+ * Starts the Multiplayer Server process using npx to install and run in one step
+ */
+export declare function startHammurabiServer(components: Pick<CliComponents, 'logger'>, workingDir: string, realm: string): ChildProcess;
+/**
+ * Spawns the multiplayer server for the project.
+ * In the auth-server SDK, all scenes are authoritative multiplayer.
+ * Uses npx to handle installation and execution in a single step (works in Electron).
+ *
+ * @param components - Preview components including logger
+ * @param project - The project to start the multiplayer server for
+ * @param realm - The realm URL to pass to the hammurabi server
+ * @returns The ChildProcess if started, undefined otherwise
+ */
+export declare function spawnAuthServer(components: PreviewComponents, project: ProjectUnion, realm: string): ChildProcess | undefined;

package/dist/commands/start/hammurabi-server.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startHammurabiServer = startHammurabiServer;
+exports.spawnAuthServer = spawnAuthServer;
+const child_process_1 = require("child_process");
+const beautiful_logs_1 = require("../../logic/beautiful-logs");
+const log_1 = require("../../components/log");
+const utils_1 = require("./utils");
+const HAMMURABI_PACKAGE = '@dcl/hammurabi-server';
+const HAMMURABI_VERSION = 'next';
+/**
+ * Registers cleanup handlers on the global process object
+ * Returns a function to remove the handlers
+ */
+function registerProcessCleanup(cleanup) {
+    process.on('SIGTERM', cleanup);
+    process.on('SIGINT', cleanup);
+    process.on('exit', cleanup);
+    return () => {
+        process.off('SIGTERM', cleanup);
+        process.off('SIGINT', cleanup);
+        process.off('exit', cleanup);
+    };
+}
+/**
+ * Starts the Multiplayer Server process using npx to install and run in one step
+ */
+function startHammurabiServer(components, workingDir, realm) {
+    (0, beautiful_logs_1.printProgressInfo)(components.logger, `Starting ${log_1.colors.bold('Multiplayer Server')} with realm: ${log_1.colors.bold(realm)}`);
+    const npxArgs = ['--yes', `${HAMMURABI_PACKAGE}@${HAMMURABI_VERSION}`, `--realm=${realm}`];
+    const npxCliJs = (0, utils_1.findNpxCliJs)();
+    // In Electron, override npm_config_prefix because npm derives its prefix from process.execPath,
+    // which points to the Electron Helper binary. This causes npm to look for a `lib/` directory
+    // inside the Helper bundle, which doesn't exist (ENOENT).
+    const env = (0, utils_1.isElectronEnvironment)() ? { ...(0, utils_1.getSpawnEnv)(), npm_config_prefix: workingDir } : (0, utils_1.getSpawnEnv)();
+    // If npx-cli.js was found, run it directly via process.execPath (node in regular env,
+    // Electron Helper with ELECTRON_RUN_AS_NODE=1 in Electron). Otherwise fall back to npx binary.
+    const hammurabiProcess = npxCliJs
+        ? (0, child_process_1.spawn)(process.execPath, [npxCliJs, ...npxArgs], { cwd: workingDir, shell: false, stdio: 'inherit', env })
+        : (0, child_process_1.spawn)((0, utils_1.getNpxBin)(), npxArgs, { cwd: workingDir, shell: false, stdio: 'inherit', env });
+    hammurabiProcess.on('error', (error) => {
+        (0, beautiful_logs_1.printWarning)(components.logger, `Multiplayer Server process error: ${error.message}`);
+    });
+    // Register cleanup handlers
+    const cleanup = () => {
+        if (!hammurabiProcess.killed) {
+            hammurabiProcess.kill('SIGTERM');
+        }
+    };
+    const removeCleanup = registerProcessCleanup(cleanup);
+    hammurabiProcess.on('close', (code) => {
+        removeCleanup();
+        if (code !== 0 && code !== null) {
+            (0, beautiful_logs_1.printWarning)(components.logger, `Multiplayer Server exited with code ${code}`);
+        }
+    });
+    return hammurabiProcess;
+}
+/**
+ * Spawns the multiplayer server for the project.
+ * In the auth-server SDK, all scenes are authoritative multiplayer.
+ * Uses npx to handle installation and execution in a single step (works in Electron).
+ *
+ * @param components - Preview components including logger
+ * @param project - The project to start the multiplayer server for
+ * @param realm - The realm URL to pass to the hammurabi server
+ * @returns The ChildProcess if started, undefined otherwise
+ */
+function spawnAuthServer(components, project, realm) {
+    try {
+        return startHammurabiServer(components, project.workingDirectory, realm);
+    }
+    catch (error) {
+        (0, beautiful_logs_1.printWarning)(components.logger, `Failed to start Multiplayer Server: ${error.message}`);
+        return undefined;
+    }
+}
+//# sourceMappingURL=hammurabi-server.js.map

package/dist/commands/start/hammurabi-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hammurabi-server.js","sourceRoot":"","sources":["../../../src/commands/start/hammurabi-server.ts"],"names":[],"mappings":";;AA8BA,oDA6CC;AAYD,0CAWC;AAlGD,iDAAmD;AAEnD,+DAA4E;AAC5E,8CAA6C;AAG7C,mCAAqF;AAErF,MAAM,iBAAiB,GAAG,uBAAuB,CAAA;AACjD,MAAM,iBAAiB,GAAG,MAAM,CAAA;AAEhC;;;GAGG;AACH,SAAS,sBAAsB,CAAC,OAAmB;IACjD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAC9B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC7B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAE3B,OAAO,GAAG,EAAE;QACV,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QAC/B,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAC9B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,CAAC,CAAA;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAClC,UAAyC,EACzC,UAAkB,EAClB,KAAa;IAEb,IAAA,kCAAiB,EACf,UAAU,CAAC,MAAM,EACjB,YAAY,YAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,gBAAgB,YAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAClF,CAAA;IAED,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,GAAG,iBAAiB,IAAI,iBAAiB,EAAE,EAAE,WAAW,KAAK,EAAE,CAAC,CAAA;IAC1F,MAAM,QAAQ,GAAG,IAAA,oBAAY,GAAE,CAAA;IAE/B,gGAAgG;IAChG,6FAA6F;IAC7F,0DAA0D;IAC1D,MAAM,GAAG,GAAG,IAAA,6BAAqB,GAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAA,mBAAW,GAAE,EAAE,iBAAiB,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,IAAA,mBAAW,GAAE,CAAA;IAEzG,sFAAsF;IACtF,+FAA+F;IAC/F,MAAM,gBAAgB,GAAG,QAAQ;QAC/B,CAAC,CAAC,IAAA,qBAAK,EAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,GAAG,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;QAC3G,CAAC,CAAC,IAAA,qBAAK,EAAC,IAAA,iBAAS,GAAE,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAA;IAEzF,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;QACrC,IAAA,6BAAY,EAAC,UAAU,CAAC,MAAM,EAAE,qCAAqC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;IACvF,CAAC,CAAC,CAAA;IAEF,4BAA4B;IAC5B,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC;YAC7B,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAClC,CAAC;IACH,CAAC,CAAA;IAED,MAAM,aAAa,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAA;IAErD,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;QACpC,aAAa,EAAE,CAAA;QACf,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAChC,IAAA,6BAAY,EAAC,UAAU,CAAC,MAAM,EAAE,uCAAuC,IAAI,EAAE,CAAC,CAAA;QAChF,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,gBAAgB,CAAA;AACzB,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,eAAe,CAC7B,UAA6B,EAC7B,OAAqB,EACrB,KAAa;IAEb,IAAI,CAAC;QACH,OAAO,oBAAoB,CAAC,UAAU,EAAE,OAAO,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAA;IAC1E,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,IAAA,6BAAY,EAAC,UAAU,CAAC,MAAM,EAAE,uCAAuC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;QACvF,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/start/index.d.ts

@@ -21,7 +21,6 @@ export declare const args: {
     '-w': string;
     '--skip-build': BooleanConstructor;
     '--data-layer': BooleanConstructor;
-    '--customEntryPoint': BooleanConstructor;
     '--explorer-alpha': BooleanConstructor;
     '--web-explorer': BooleanConstructor;
     '--hub': BooleanConstructor;
@@ -36,6 +35,8 @@ export declare const args: {
     '--landscape-terrain-enabled': BooleanConstructor;
     '-n': BooleanConstructor;
     '--bevy-web': BooleanConstructor;
+    '--multi-instance': BooleanConstructor;
+    '--no-client': BooleanConstructor;
 };
 export declare function help(options: Options): Promise<void>;
 export declare function main(options: Options): Promise<void>;

package/dist/commands/start/index.js

@@ -66,6 +66,7 @@ const beautiful_logs_1 = require("../../logic/beautiful-logs");
 const project_validations_1 = require("../../logic/project-validations");
 const explorer_alpha_1 = require("./explorer-alpha");
 const utils_1 = require("./utils");
+const hammurabi_server_1 = require("./hammurabi-server");
 exports.args = (0, args_1.declareArgs)({
     '--dir': String,
     '--help': Boolean,
@@ -83,7 +84,6 @@ exports.args = (0, args_1.declareArgs)({
     '-w': '--no-watch',
     '--skip-build': Boolean,
     '--data-layer': Boolean,
-    '--customEntryPoint': Boolean,
     '--explorer-alpha': Boolean,
     '--web-explorer': Boolean,
     '--hub': Boolean,
@@ -98,7 +98,9 @@ exports.args = (0, args_1.declareArgs)({
     '--skip-auth-screen': Boolean,
     '--landscape-terrain-enabled': Boolean,
     '-n': Boolean,
-    '--bevy-web': Boolean
+    '--bevy-web': Boolean,
+    '--multi-instance': Boolean,
+    '--no-client': Boolean
 });
 async function help(options) {
     options.components.logger.log(`
@@ -123,8 +125,9 @@ async function help(options) {
       --skip-auth-screen                Skip the auth screen (accepts 'true' or 'false').
       --landscape-terrain-enabled       Enable landscape terrain.
       -n                                Open a new instance of the Client even if one is already running.
-      --bevy-web                        Opens preview using the Bevy Web browser window (default=true)
-      --mobile, -m                      Show QR code for mobile preview on the same network (default=true)
+      --bevy-web                        Opens preview using the Bevy Web browser window.
+      --mobile                          Show QR code for mobile preview on the same network.
+      --multi-instance                  Allow running multiple Explorer instances simultaneously.
 
 
     Examples:
@@ -149,10 +152,10 @@ async function main(options) {
     const withDataLayer = options.args['--data-layer'];
     const enableWeb3 = options.args['--web3'];
     const isHub = !!options.args['--hub'];
-    // Default to true if not specified (undefined), false only if explicitly set to false
-    const bevyWeb = (options.args['--bevy-web'] ?? true) && !isCi;
-    const isMobile = (options.args['--mobile'] ?? true) && !isCi;
-    const explorerAlpha = !options.args['--web-explorer'] && !bevyWeb;
+    const skipClient = !!options.args['--no-client'];
+    const bevyWeb = !!options.args['--bevy-web'] && !skipClient;
+    const isMobile = options.args['--mobile'] && !skipClient;
+    const explorerAlpha = !options.args['--web-explorer'] && !bevyWeb && !skipClient;
     let hasSmartWearable = false;
     const workspace = await (0, workspace_validations_1.getValidWorkspace)(options.components, workingDirectory);
     /* istanbul ignore if */
@@ -166,15 +169,7 @@ async function main(options) {
             // first run `npm run build`, this can be disabled with --skip-build
             // then start the embedded compiler, this can be disabled with --no-watch
             if (watch || build) {
-                await (0, build_1.buildScene)({
-                    ...options,
-                    args: {
-                        '--dir': project.workingDirectory,
-                        '--watch': watch,
-                        _: [],
-                        '--customEntryPoint': !!options.args['--customEntryPoint']
-                    }
-                }, project);
+                await (0, build_1.buildScene)({ ...options, args: { '--dir': project.workingDirectory, '--watch': watch, _: [] } }, project);
                 await (0, project_validations_1.startValidations)(options.components, project.workingDirectory);
             }
             // track the event
@@ -237,6 +232,22 @@ async function main(options) {
                 }
             }
             await startComponents();
+            // Start Hammurabi server if needed (stored outside components to avoid lifecycle management)
+            let hammurabiServer;
+            const project = workspace.projects[0];
+            if (project) {
+                const realm = `http://localhost:${port}`;
+                hammurabiServer = (0, hammurabi_server_1.spawnAuthServer)(components, project, realm);
+                // Register cleanup handler for hammurabi server
+                if (hammurabiServer) {
+                    const cleanup = () => {
+                        if (hammurabiServer && !hammurabiServer.killed) {
+                            hammurabiServer.kill('SIGTERM');
+                        }
+                    };
+                    components.signaler.programClosed.then(cleanup).catch(() => { });
+                }
+            }
             const networkInterfaces = os.networkInterfaces();
             const availableURLs = [];
             (0, beautiful_logs_1.printProgressInfo)(options.components.logger, 'Preview server is now running!');
@@ -248,15 +259,14 @@ async function main(options) {
                 (networkInterfaces[dev] || []).forEach((details) => {
                     if (details.family === 'IPv4') {
                         const oldBackpack = 'DISABLE_backpack_editor_v2=&ENABLE_backpack_editor_v1';
-                        const baseUrl = `http://${details.address}:${port}`;
-                        let url = `${baseUrl}?position=${baseCoords.x}%2C${baseCoords.y}&${oldBackpack}`;
+                        let addr = `http://${details.address}:${port}?position=${baseCoords.x}%2C${baseCoords.y}&${oldBackpack}`;
                         if (debug) {
-                            url = `${url}&SCENE_DEBUG_PANEL`;
+                            addr = `${addr}&SCENE_DEBUG_PANEL`;
                         }
                         if (enableWeb3 || hasSmartWearable) {
-                            url = `${url}&ENABLE_WEB3`;
+                            addr = `${addr}&ENABLE_WEB3`;
                         }
-                        availableURLs.push({ base: baseUrl, url });
+                        availableURLs.push(addr);
                     }
                 });
             });
@@ -264,29 +274,26 @@ async function main(options) {
             const lanUrl = (0, utils_1.getLanUrl)(port);
             // Push localhost and 127.0.0.1 at top
             const sortedURLs = availableURLs.sort((a, _b) => {
-                return a.base.toLowerCase().includes('localhost') || a.base.includes('127.0.0.1') || a.base.includes('0.0.0.0')
-                    ? -1
-                    : 1;
+                return a.toLowerCase().includes('localhost') || a.includes('127.0.0.1') || a.includes('0.0.0.0') ? -1 : 1;
             });
-            const bevyUrl = `https://decentraland.zone/bevy-web/?preview=true&realm=${sortedURLs[0].base}&position=${baseCoords.x},${baseCoords.y}`;
+            const bevyUrl = `https://decentraland.zone/bevy-web/?preview=true&realm=${new URL(sortedURLs[0]).origin}&position=${baseCoords.x},${baseCoords.y}`;
             if (!explorerAlpha) {
                 if (bevyWeb) {
                     components.logger.log(`    ${bevyUrl}`);
                 }
                 else {
                     for (const addr of sortedURLs) {
-                        components.logger.log(`    ${addr.url}`);
+                        components.logger.log(`    ${addr}`);
                     }
                 }
             }
             components.logger.log('\nPress CTRL+C to exit\n');
-            // Open preferably localhost/127.0.0.1
             if (explorerAlpha && !isMobile) {
-                const realm = new URL(sortedURLs[0].url).origin;
+                const realm = new URL(sortedURLs[0]).origin;
                 await (0, explorer_alpha_1.runExplorerAlpha)(components, { cwd: workingDirectory, realm, baseCoords, isHub, args: options.args });
             }
-            if (isMobile && lanUrl) {
-                const deepLink = `decentraland://open?preview=${lanUrl}&position=${baseCoords.x}%2C${baseCoords.y}`;
+            if (options.args['--mobile'] && lanUrl) {
+                const deepLink = `decentraland://open?preview=${lanUrl}&position=${baseCoords.x},${baseCoords.y}`;
                 qrcode_1.default.toString(deepLink, { type: 'terminal', small: true }, (err, qr) => {
                     if (!err) {
                         components.logger.log(log_1.colors.bold('\nScan to preview on mobile: \n'));
@@ -298,7 +305,7 @@ async function main(options) {
             // Open preferably localhost/127.0.0.1
             if ((!explorerAlpha || bevyWeb) && openBrowser && sortedURLs.length) {
                 try {
-                    const url = bevyWeb ? bevyUrl : sortedURLs[0].url;
+                    const url = bevyWeb ? bevyUrl : sortedURLs[0];
                     await (0, open_1.default)(url);
                 }
                 catch (_) {