@dcl/sdk-commands 7.30.1 → 7.30.2-37807847179.commit-24c42ea

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

@@ -0,0 +1,244 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startMultiplayerServer = startMultiplayerServer;
+exports.waitForServerReady = waitForServerReady;
+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 scene_validations_1 = require("../../logic/scene-validations");
+const future_1 = require("../../logic/future");
+const dcl_env_1 = require("./dcl-env");
+const HAMMURABI_PACKAGE = '@dcl/hammurabi-server';
+const HAMMURABI_VERSION = 'next';
+const BEVY_PACKAGE = '@dcl-regenesislabs/bevy-headless-server';
+const BEVY_VERSION = '0.1.0-36033403774.commit-19347eb';
+const EXIT_UNAVAILABLE = 78;
+const CMD_METACHARACTERS = /[&|<>^%"!\r\n]/;
+const DEFAULT_ENGINE = 'bevy';
+function selectedEngine() {
+    const requested = process.env.DCL_SERVER_ENGINE;
+    return requested === 'bevy' || requested === 'hammurabi' ? requested : DEFAULT_ENGINE;
+}
+/**
+ * npx accepts a directory or tarball as well as a registry spec, so pointing
+ * DCL_SERVER_PACKAGE at a local build exercises this spawn path without publishing.
+ */
+function packageSpec(engine) {
+    const override = process.env.DCL_SERVER_PACKAGE;
+    if (override)
+        return override;
+    return engine === 'bevy' ? `${BEVY_PACKAGE}@${BEVY_VERSION}` : `${HAMMURABI_PACKAGE}@${HAMMURABI_VERSION}`;
+}
+/**
+ * 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);
+    };
+}
+const TRACING_PREFIX = /^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2})\.\d+Z\s+(INFO|WARN|ERROR|DEBUG|TRACE)\s+[\w:]+:\s?/;
+const HEARTBEAT_LINE = /^\[headless\] alive:/;
+const SERVER_READY_GRACE_MS = 1500;
+const SERVER_READY_TIMEOUT_MS = 10000;
+const ANSI_CODES = /\u001b\[[0-9;]*m/g;
+const ENGINE_NOISE = [
+    /^failed to process gltf/,
+    /^Path not found: \$ipfs/,
+    /^bevy_render feature is enabled but RenderApp was not detected/,
+    /^Could not find an asset loader matching: .* Path: Some\("embedded:\/\//
+];
+const SCENE_CONTEXT = /^\[\[-?\d+, -?\d+\] \d+\.\d+\] /;
+function colorByLevel(level, message) {
+    if (level === 'WARN')
+        return log_1.colors.yellow(message);
+    if (level === 'ERROR')
+        return log_1.colors.redBright(message);
+    return message;
+}
+function localTime(utcTimestamp) {
+    const date = new Date(utcTimestamp + 'Z');
+    return isNaN(date.getTime()) ? '' : log_1.colors.dim(date.toTimeString().slice(0, 8)) + ' ';
+}
+/** Forwards a server child stream to `sink`, line by line, tagged `[Server]` and ANSI-cleaned. */
+function forwardEngineLogs(source, sink) {
+    if (!source)
+        return;
+    const serverTag = log_1.colors.greenBright('[Server]') + ' ';
+    const writeClean = (raw) => {
+        const line = raw.replace(ANSI_CODES, '');
+        if (!line.trim())
+            return;
+        if (HEARTBEAT_LINE.test(line))
+            return;
+        const match = line.match(TRACING_PREFIX);
+        if (!match) {
+            sink.write(serverTag + line.replace(/^\[headless\] /, '') + '\n');
+            return;
+        }
+        const message = line.slice(match[0].length);
+        if (ENGINE_NOISE.some((pattern) => pattern.test(message)))
+            return;
+        if (SCENE_CONTEXT.test(message)) {
+            const sceneMessage = message.replace(SCENE_CONTEXT, '');
+            const sceneTag = sceneMessage.match(/^(LOG|WARN|ERROR|DEBUG) /);
+            const body = sceneTag ? sceneMessage.slice(sceneTag[0].length) : sceneMessage;
+            sink.write(serverTag + localTime(match[1]) + colorByLevel(sceneTag?.[1], body) + '\n');
+        }
+        else {
+            sink.write(serverTag + localTime(match[1]) + colorByLevel(match[2], message) + '\n');
+        }
+    };
+    let pending = '';
+    source.setEncoding('utf8');
+    source.on('data', (chunk) => {
+        const lines = (pending + chunk).split('\n');
+        pending = lines.pop() ?? '';
+        lines.forEach(writeClean);
+    });
+    source.on('end', () => {
+        if (pending)
+            writeClean(pending);
+    });
+}
+/**
+ * Starts the Multiplayer Server process using npx to install and run in one step
+ */
+function startMultiplayerServer(components, workingDir, realm, engine = DEFAULT_ENGINE, engineArgs = [], position) {
+    const pkg = packageSpec(engine);
+    (0, beautiful_logs_1.printProgressInfo)(components.logger, `Starting ${log_1.colors.bold('Multiplayer Server')} (${engine}) with realm: ${log_1.colors.bold(realm)}`);
+    const npxArgs = ['--yes', pkg, `--realm=${realm}`, ...engineArgs];
+    if (position)
+        npxArgs.push(`--position=${position.x},${position.y}`);
+    const npxCliJs = (0, utils_1.findNpxCliJs)();
+    const npxPath = npxCliJs ? null : (0, utils_1.findNpxBin)();
+    if (!npxCliJs && !npxPath) {
+        throw new Error('npx-cli.js and npx were not found in a trusted location');
+    }
+    const useShell = !!npxPath && process.platform === 'win32';
+    if (useShell) {
+        const unsafe = npxArgs.find((arg) => CMD_METACHARACTERS.test(arg));
+        if (unsafe)
+            throw new Error(`refusing to run npx through the shell with argument ${JSON.stringify(unsafe)}`);
+        (0, beautiful_logs_1.printWarning)(components.logger, `npx-cli.js not found next to ${process.execPath} or any npm on PATH; running ${npxPath} through the shell`);
+    }
+    const env = (0, utils_1.isElectronEnvironment)()
+        ? { ...(0, utils_1.getSpawnEnv)(), npm_config_prefix: workingDir }
+        : { ...(0, utils_1.getSpawnEnv)() };
+    if (engine === 'bevy' && !env.RUST_LOG) {
+        env.RUST_LOG = 'warn,scene_runner::renderer_context=info';
+    }
+    const stdio = ['inherit', 'pipe', 'pipe'];
+    const serverProcess = npxCliJs
+        ? (0, child_process_1.spawn)(process.execPath, [npxCliJs, ...npxArgs], { cwd: workingDir, shell: false, stdio, env })
+        : (0, child_process_1.spawn)(useShell ? `"${npxPath}"` : npxPath, useShell ? npxArgs.map((arg) => `"${arg}"`) : npxArgs, {
+            cwd: workingDir,
+            shell: useShell,
+            stdio,
+            env
+        });
+    forwardEngineLogs(serverProcess.stdout, process.stdout);
+    forwardEngineLogs(serverProcess.stderr, process.stderr);
+    const ready = (0, future_1.future)();
+    let graceTimer;
+    serverProcess.on('spawn', () => {
+        graceTimer = setTimeout(() => ready.resolve(true), SERVER_READY_GRACE_MS);
+    });
+    serverProcess.on('error', (error) => {
+        clearTimeout(graceTimer);
+        (0, beautiful_logs_1.printWarning)(components.logger, `Multiplayer Server process error: ${error.message}`);
+        ready.resolve(false);
+    });
+    const cleanup = () => {
+        if (!serverProcess.killed) {
+            serverProcess.kill('SIGTERM');
+        }
+    };
+    const removeCleanup = registerProcessCleanup(cleanup);
+    serverProcess.on('close', (code, signal) => {
+        removeCleanup();
+        clearTimeout(graceTimer);
+        ready.resolve(false);
+        if (code !== 0 && code !== null) {
+            components.analytics.track('Multiplayer server exited', {
+                engine,
+                exitCode: code,
+                unavailable: code === EXIT_UNAVAILABLE
+            });
+            (0, beautiful_logs_1.printWarning)(components.logger, `Multiplayer Server exited with code ${code}. The preview keeps running without it, ` +
+                `but clients wait for state sync (\`isStateSyncronized()\` stays false) until a server joins the scene room.`);
+        }
+        else if (signal && signal !== 'SIGTERM' && signal !== 'SIGINT') {
+            (0, beautiful_logs_1.printWarning)(components.logger, `Multiplayer Server terminated by signal ${signal}`);
+        }
+    });
+    return { child: serverProcess, ready };
+}
+/** Waits for the server process to come up, fail, or time out. */
+async function waitForServerReady(components, ready, timeoutMs = SERVER_READY_TIMEOUT_MS) {
+    (0, beautiful_logs_1.printProgressInfo)(components.logger, 'Waiting for the Multiplayer Server to start...');
+    let timer;
+    const timeout = new Promise((resolve) => {
+        timer = setTimeout(() => resolve('timeout'), timeoutMs);
+    });
+    const result = await Promise.race([ready, timeout]);
+    clearTimeout(timer);
+    if (result === true) {
+        (0, beautiful_logs_1.printProgressInfo)(components.logger, `${log_1.colors.bold('Multiplayer Server')} is ready`);
+        return;
+    }
+    const reason = result === 'timeout' ? `is not ready after ${timeoutMs / 1000}s` : 'is not running';
+    (0, beautiful_logs_1.printWarning)(components.logger, `Multiplayer Server ${reason}. Opening the client anyway; state sync completes once a server joins the scene room.`);
+}
+/**
+ * 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).
+ *
+ * Which implementation runs is chosen by DCL_SERVER_ENGINE (bevy | hammurabi), defaulting
+ * to bevy. When bevy reports itself unavailable on this machine (exit 78) the preview is
+ * aborted with instructions to opt into hammurabi — there is no automatic fallback.
+ *
+ * @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 server
+ * @returns The readiness promise, or undefined when the server could not be spawned
+ */
+function spawnAuthServer(components, project, realm, dclenv = 'org') {
+    const engine = selectedEngine();
+    try {
+        const server = startMultiplayerServer(components, project.workingDirectory, realm, engine, engine === 'bevy' ? (0, dcl_env_1.engineEnvArgs)(dclenv) : [], (0, scene_validations_1.getBaseCoords)(project.scene));
+        void components.signaler.programClosed
+            .then(() => {
+            if (!server.child.killed)
+                server.child.kill('SIGTERM');
+        })
+            .catch(() => { });
+        if (engine === 'bevy') {
+            server.child.on('close', (code) => {
+                if (code !== EXIT_UNAVAILABLE)
+                    return;
+                const { logger } = components;
+                logger.error(`The bevy multiplayer server (${packageSpec(engine)}) cannot run on this machine ` +
+                    `(exit ${EXIT_UNAVAILABLE}: unsupported platform or missing binary — ${process.platform}-${process.arch}).`);
+                logger.error(`To run the preview with the hammurabi server instead:`);
+                logger.error(`  DCL_SERVER_ENGINE=hammurabi npm start`);
+                void components.analytics.stop().finally(() => process.exit(EXIT_UNAVAILABLE));
+            });
+        }
+        return server.ready;
+    }
+    catch (error) {
+        (0, beautiful_logs_1.printWarning)(components.logger, `Failed to start Multiplayer Server: ${error.message}`);
+        return undefined;
+    }
+}
+//# sourceMappingURL=multiplayer-server.js.map

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

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

package/dist/commands/start/server/routes.d.ts

@@ -3,4 +3,4 @@ import { Workspace } from '../../../logic/workspace-validations';
 import { DataLayer } from '../data-layer/rpc';
 import { PreviewComponents } from '../types';
 export declare const sceneUpdateClients: Set<WebSocket>;
-export declare function wireRouter(components: PreviewComponents, workspace: Workspace, dataLayer?: DataLayer): Promise<void>;
+export declare function wireRouter(components: PreviewComponents, workspace: Workspace, dataLayer?: DataLayer, dclenv?: string): Promise<void>;

package/dist/commands/start/server/routes.js

@@ -10,10 +10,12 @@ const http_server_1 = require("@well-known-components/http-server");
 const ws_1 = require("@well-known-components/http-server/dist/ws");
 const ws_2 = require("../data-layer/ws");
 const endpoints_1 = require("./endpoints");
+const storage_service_1 = require("./storage-service");
 const realm_1 = require("./realm");
 const utils_1 = require("../utils");
+const dcl_env_1 = require("../dcl-env");
 exports.sceneUpdateClients = new Set();
-async function wireRouter(components, workspace, dataLayer) {
+async function wireRouter(components, workspace, dataLayer, dclenv = 'org') {
     const router = new http_server_1.Router();
     if (dataLayer) {
         router.get('/data-layer', async (ctx, next) => {
@@ -46,7 +48,8 @@ async function wireRouter(components, workspace, dataLayer) {
             };
         }
         const [x, y] = baseParcel.split(',');
-        const deepLink = `decentraland://open?preview=${lanUrl}&position=${x},${y}`;
+        // same Pulse params as the terminal QR in start/index.ts
+        const deepLink = `decentraland://open?preview=${lanUrl}&position=${x},${y}${(0, dcl_env_1.lsdDeepLinkPulseParams)(workspace.projects[0].workingDirectory, dclenv)}`;
         const qrDataUrl = await qrcode_1.default.toDataURL(deepLink);
         return {
             headers: { 'content-type': 'application/json' },
@@ -60,6 +63,7 @@ async function wireRouter(components, workspace, dataLayer) {
         };
     });
     (0, realm_1.setupRealmAndComms)(components, router, localSceneParcels);
+    (0, storage_service_1.setupStorageEndpoints)(components, router, workspace);
     await (0, endpoints_1.setupEcs6Endpoints)(components, router, workspace);
     components.server.setContext(components);
     components.server.use(router.allowedMethods());

package/dist/commands/start/server/routes.js.map

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

package/dist/commands/start/server/runtime-env.d.ts

@@ -0,0 +1,84 @@
+import { CliComponents } from '../../../components';
+/**
+ * Structure for all server-side storage data.
+ * Stored in sdk-commands package directory (hidden from users).
+ */
+export interface ServerStorage {
+    env: Record<string, string>;
+    world: Record<string, unknown>;
+    players: Record<string, Record<string, unknown>>;
+}
+export interface StorageLimits {
+    maxValueSizeBytes: number;
+    maxTotalSizeBytes: number;
+}
+/** The deployed service's defaults, in bytes; totals are per world, or per player. */
+export declare const STORAGE_LIMITS: Record<'env' | 'world' | 'player', StorageLimits>;
+export declare class StorageLimitExceededError extends Error {
+}
+/** The lock was removed or replaced while this process held it; nothing was written. */
+export declare class StoreLockLostError extends Error {
+}
+/** Only a missing file is an empty store; any other read failure throws. */
+export declare function loadServerStorage(components: Pick<CliComponents, 'fs' | 'logger'>): Promise<ServerStorage>;
+/**
+ * Saves all server-side storage data to server-storage.json.
+ */
+export declare function saveServerStorage(components: Pick<CliComponents, 'fs' | 'logger'>, data: ServerStorage): Promise<void>;
+/**
+ * Loads environment variables from a .env file in the project directory.
+ * Returns a Map of key-value pairs.
+ */
+export declare function loadEnvFile(components: Pick<CliComponents, 'fs' | 'logger'>, projectDirectory: string): Promise<Map<string, string>>;
+/**
+ * Gets runtime environment variables.
+ */
+export declare function getEnvStorage(components: Pick<CliComponents, 'fs' | 'logger'>): Promise<Record<string, string>>;
+/**
+ * Gets merged environment variables.
+ * Runtime values (from server-storage.json) override .env values.
+ */
+export declare function getMergedEnv(components: Pick<CliComponents, 'fs' | 'logger'>, projectDirectory: string): Promise<Map<string, string>>;
+/**
+ * Sets a runtime environment variable.
+ */
+export declare function setEnvValue(components: Pick<CliComponents, 'fs' | 'logger'>, key: string, value: string): Promise<void>;
+/**
+ * Deletes a runtime environment variable.
+ * Returns true if key existed and was deleted, false otherwise.
+ */
+export declare function deleteEnvValue(components: Pick<CliComponents, 'fs' | 'logger'>, key: string): Promise<boolean>;
+/**
+ * Gets all world storage data.
+ */
+export declare function getWorldStorage(components: Pick<CliComponents, 'fs' | 'logger'>): Promise<Record<string, unknown>>;
+/**
+ * Gets a value from world storage.
+ */
+export declare function getWorldValue(components: Pick<CliComponents, 'fs' | 'logger'>, key: string): Promise<unknown | undefined>;
+/**
+ * Gets all storage data for a player, empty when the player has none.
+ */
+export declare function getPlayerStorage(components: Pick<CliComponents, 'fs' | 'logger'>, address: string): Promise<Record<string, unknown>>;
+/**
+ * Sets a value in world storage.
+ */
+export declare function setWorldValue(components: Pick<CliComponents, 'fs' | 'logger'>, key: string, value: unknown): Promise<void>;
+/**
+ * Deletes a value from world storage.
+ * Returns true if key existed and was deleted, false otherwise.
+ */
+export declare function deleteWorldValue(components: Pick<CliComponents, 'fs' | 'logger'>, key: string): Promise<boolean>;
+/**
+ * Gets a value from a player's storage.
+ */
+export declare function getPlayerValue(components: Pick<CliComponents, 'fs' | 'logger'>, address: string, key: string): Promise<unknown | undefined>;
+/**
+ * Sets a value in a player's storage.
+ */
+export declare function setPlayerValue(components: Pick<CliComponents, 'fs' | 'logger'>, address: string, key: string, value: unknown): Promise<void>;
+/**
+ * Deletes a value from a player's storage.
+ * Returns true if key existed and was deleted, false otherwise.
+ */
+export declare function deletePlayerValue(components: Pick<CliComponents, 'fs' | 'logger'>, address: string, key: string): Promise<boolean>;