@dcl/sdk-commands 7.20.1 → 7.20.2-22102228700.commit-61000fc

package/dist/commands/start/server/runtime-env.js

@@ -0,0 +1,226 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadServerStorage = loadServerStorage;
+exports.saveServerStorage = saveServerStorage;
+exports.loadEnvFile = loadEnvFile;
+exports.getEnvStorage = getEnvStorage;
+exports.getMergedEnv = getMergedEnv;
+exports.setEnvValue = setEnvValue;
+exports.deleteEnvValue = deleteEnvValue;
+exports.getWorldStorage = getWorldStorage;
+exports.getWorldValue = getWorldValue;
+exports.setWorldValue = setWorldValue;
+exports.deleteWorldValue = deleteWorldValue;
+exports.getPlayerValue = getPlayerValue;
+exports.setPlayerValue = setPlayerValue;
+exports.deletePlayerValue = deletePlayerValue;
+const path_1 = __importDefault(require("path"));
+// Find the sdk-commands package root by resolving its package.json
+const SDK_COMMANDS_ROOT = path_1.default.dirname(require.resolve('@dcl/sdk-commands/package.json'));
+const RUNTIME_DATA_DIR = path_1.default.join(SDK_COMMANDS_ROOT, '.runtime-data');
+const SERVER_STORAGE_FILE = 'server-storage.json';
+const DEFAULT_STORAGE = {
+    env: {},
+    world: {},
+    players: {}
+};
+/**
+ * Ensures the runtime data directory exists.
+ */
+async function ensureRuntimeDir(components) {
+    try {
+        const exists = await components.fs.directoryExists(RUNTIME_DATA_DIR);
+        if (!exists) {
+            await components.fs.mkdir(RUNTIME_DATA_DIR, { recursive: true });
+        }
+    }
+    catch (error) {
+        components.logger.error(`Failed to create runtime data directory: ${error}`);
+    }
+}
+/**
+ * Loads all server-side storage data from server-storage.json.
+ */
+async function loadServerStorage(components) {
+    const storagePath = path_1.default.join(RUNTIME_DATA_DIR, SERVER_STORAGE_FILE);
+    try {
+        const exists = await components.fs.fileExists(storagePath);
+        if (!exists) {
+            return { ...DEFAULT_STORAGE };
+        }
+        const content = await components.fs.readFile(storagePath, 'utf-8');
+        const parsed = JSON.parse(content);
+        // Merge with defaults to ensure all keys exist
+        return {
+            env: parsed.env ?? {},
+            world: parsed.world ?? {},
+            players: parsed.players ?? {}
+        };
+    }
+    catch (error) {
+        components.logger.error(`Failed to load ${SERVER_STORAGE_FILE}: ${error}`);
+        return { ...DEFAULT_STORAGE };
+    }
+}
+/**
+ * Saves all server-side storage data to server-storage.json.
+ */
+async function saveServerStorage(components, data) {
+    await ensureRuntimeDir(components);
+    const storagePath = path_1.default.join(RUNTIME_DATA_DIR, SERVER_STORAGE_FILE);
+    try {
+        await components.fs.writeFile(storagePath, JSON.stringify(data, null, 2));
+    }
+    catch (error) {
+        components.logger.error(`Failed to save ${SERVER_STORAGE_FILE}: ${error}`);
+        throw error;
+    }
+}
+/**
+ * Loads environment variables from a .env file in the project directory.
+ * Returns a Map of key-value pairs.
+ */
+async function loadEnvFile(components, projectDirectory) {
+    const envMap = new Map();
+    const envPath = path_1.default.join(projectDirectory, '.env');
+    try {
+        const exists = await components.fs.fileExists(envPath);
+        if (!exists) {
+            return envMap;
+        }
+        const content = await components.fs.readFile(envPath, 'utf-8');
+        const lines = content.split('\n');
+        for (const line of lines) {
+            const trimmed = line.trim();
+            // Skip empty lines and comments
+            if (!trimmed || trimmed.startsWith('#')) {
+                continue;
+            }
+            const equalIndex = trimmed.indexOf('=');
+            if (equalIndex > 0) {
+                const key = trimmed.slice(0, equalIndex).trim();
+                let value = trimmed.slice(equalIndex + 1).trim();
+                // Remove surrounding quotes if present
+                if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+                    value = value.slice(1, -1);
+                }
+                envMap.set(key, value);
+            }
+        }
+    }
+    catch (error) {
+        components.logger.error(`Failed to load .env file: ${error}`);
+    }
+    return envMap;
+}
+/**
+ * Gets runtime environment variables.
+ */
+async function getEnvStorage(components) {
+    const storage = await loadServerStorage(components);
+    return storage.env;
+}
+/**
+ * Gets merged environment variables.
+ * Runtime values (from server-storage.json) override .env values.
+ */
+async function getMergedEnv(components, projectDirectory) {
+    const envFile = await loadEnvFile(components, projectDirectory);
+    const runtimeEnv = await getEnvStorage(components);
+    // Runtime overrides .env
+    for (const [key, value] of Object.entries(runtimeEnv)) {
+        envFile.set(key, value);
+    }
+    return envFile;
+}
+/**
+ * Sets a runtime environment variable.
+ */
+async function setEnvValue(components, key, value) {
+    const storage = await loadServerStorage(components);
+    storage.env[key] = value;
+    await saveServerStorage(components, storage);
+}
+/**
+ * Deletes a runtime environment variable.
+ * Returns true if key existed and was deleted, false otherwise.
+ */
+async function deleteEnvValue(components, key) {
+    const storage = await loadServerStorage(components);
+    if (!(key in storage.env)) {
+        return false;
+    }
+    delete storage.env[key];
+    await saveServerStorage(components, storage);
+    return true;
+}
+/**
+ * Gets all world storage data.
+ */
+async function getWorldStorage(components) {
+    const storage = await loadServerStorage(components);
+    return storage.world;
+}
+/**
+ * Gets a value from world storage.
+ */
+async function getWorldValue(components, key) {
+    const storage = await loadServerStorage(components);
+    return storage.world[key];
+}
+/**
+ * Sets a value in world storage.
+ */
+async function setWorldValue(components, key, value) {
+    const storage = await loadServerStorage(components);
+    storage.world[key] = value;
+    await saveServerStorage(components, storage);
+}
+/**
+ * Deletes a value from world storage.
+ * Returns true if key existed and was deleted, false otherwise.
+ */
+async function deleteWorldValue(components, key) {
+    const storage = await loadServerStorage(components);
+    if (!(key in storage.world)) {
+        return false;
+    }
+    delete storage.world[key];
+    await saveServerStorage(components, storage);
+    return true;
+}
+/**
+ * Gets a value from a player's storage.
+ */
+async function getPlayerValue(components, address, key) {
+    const storage = await loadServerStorage(components);
+    return storage.players[address]?.[key];
+}
+/**
+ * Sets a value in a player's storage.
+ */
+async function setPlayerValue(components, address, key, value) {
+    const storage = await loadServerStorage(components);
+    if (!storage.players[address]) {
+        storage.players[address] = {};
+    }
+    storage.players[address][key] = value;
+    await saveServerStorage(components, storage);
+}
+/**
+ * Deletes a value from a player's storage.
+ * Returns true if key existed and was deleted, false otherwise.
+ */
+async function deletePlayerValue(components, address, key) {
+    const storage = await loadServerStorage(components);
+    if (!storage.players[address] || !(key in storage.players[address])) {
+        return false;
+    }
+    delete storage.players[address][key];
+    await saveServerStorage(components, storage);
+    return true;
+}
+//# sourceMappingURL=runtime-env.js.map

package/dist/commands/start/server/runtime-env.js.map

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

package/dist/commands/start/server/storage-service.d.ts

@@ -0,0 +1,8 @@
+import { Router } from '@well-known-components/http-server';
+import { PreviewComponents } from '../types';
+import { CliComponents } from '../../../components';
+import { Workspace } from '../../../logic/workspace-validations';
+/**
+ * Sets up storage-related endpoints for environment variables, scene storage, and player storage.
+ */
+export declare function setupStorageEndpoints(components: CliComponents, router: Router<PreviewComponents>, workspace: Workspace): void;

package/dist/commands/start/server/storage-service.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupStorageEndpoints = setupStorageEndpoints;
+const runtime_env_1 = require("./runtime-env");
+/**
+ * Sets up storage-related endpoints for environment variables, scene storage, and player storage.
+ */
+function setupStorageEndpoints(components, router, workspace) {
+    const withKeyValidation = async (ctx, next) => {
+        if (!ctx.params.key) {
+            return { status: 400, body: { message: 'Key is required' } };
+        }
+        return next();
+    };
+    const withAddressValidation = async (ctx, next) => {
+        if (!ctx.params.address) {
+            return { status: 400, body: { message: 'Address is required' } };
+        }
+        return next();
+    };
+    // Environment variables endpoints (/env/:key)
+    router.get('/env/:key', withKeyValidation, async (ctx) => {
+        const { key } = ctx.params;
+        const envVars = await (0, runtime_env_1.getMergedEnv)(components, workspace.projects[0].workingDirectory);
+        const value = envVars.get(key);
+        if (value === undefined) {
+            return { status: 404, body: { message: `Environment variable '${key}' not found` } };
+        }
+        return { body: JSON.stringify({ value }) };
+    });
+    router.put('/env/:key', withKeyValidation, async (ctx) => {
+        const { key } = ctx.params;
+        try {
+            const bodyText = await ctx.request.text();
+            const { value } = JSON.parse(bodyText);
+            await (0, runtime_env_1.setEnvValue)(components, key, value);
+            return { status: 204 };
+        }
+        catch (error) {
+            components.logger.error(`Failed to set environment variable '${key}': ${error}`);
+            return { status: 500, body: { message: `Failed to set environment variable '${key}'` } };
+        }
+    });
+    router.delete('/env/:key', withKeyValidation, async (ctx) => {
+        const { key } = ctx.params;
+        try {
+            await (0, runtime_env_1.deleteEnvValue)(components, key);
+            return { status: 204 };
+        }
+        catch (error) {
+            components.logger.error(`Failed to delete environment variable '${key}': ${error}`);
+            return { status: 500, body: { message: `Failed to delete environment variable '${key}'` } };
+        }
+    });
+    // Scene Storage list endpoint (GET /values, optional ?prefix=&limit=&offset=)
+    router.get('/values', async (ctx) => {
+        const prefix = ctx.url.searchParams.get('prefix');
+        const limitParam = ctx.url.searchParams.get('limit');
+        const offsetParam = ctx.url.searchParams.get('offset');
+        const storage = await (0, runtime_env_1.loadServerStorage)(components);
+        let entries = Object.entries(storage.world).map(([key, value]) => ({ key, value }));
+        if (prefix !== null && prefix !== '') {
+            entries = entries.filter((entry) => entry.key.startsWith(prefix));
+        }
+        const total = entries.length;
+        const offset = offsetParam !== null ? Math.max(0, parseInt(offsetParam, 10) || 0) : 0;
+        const limit = limitParam !== null ? Math.max(1, parseInt(limitParam, 10) || 0) : entries.length;
+        const paginatedEntries = limit > 0 ? entries.slice(offset, offset + limit) : entries.slice(offset);
+        return { body: JSON.stringify({ data: paginatedEntries, pagination: { offset, total } }) };
+    });
+    // Scene Storage endpoints (/values/:key)
+    router.get('/values/:key', withKeyValidation, async (ctx) => {
+        const { key } = ctx.params;
+        const value = await (0, runtime_env_1.getWorldValue)(components, key);
+        if (value === undefined) {
+            return { status: 404, body: { message: `Storage key '${key}' not found` } };
+        }
+        return { body: JSON.stringify({ value }) };
+    });
+    router.put('/values/:key', withKeyValidation, async (ctx) => {
+        const { key } = ctx.params;
+        try {
+            const bodyText = await ctx.request.text();
+            const { value } = JSON.parse(bodyText);
+            await (0, runtime_env_1.setWorldValue)(components, key, value);
+            return { body: JSON.stringify({ value }) };
+        }
+        catch (error) {
+            components.logger.error(`Failed to set storage value '${key}': ${error}`);
+            return { status: 500, body: { message: `Failed to set storage value '${key}'` } };
+        }
+    });
+    router.delete('/values/:key', withKeyValidation, async (ctx) => {
+        const { key } = ctx.params;
+        try {
+            await (0, runtime_env_1.deleteWorldValue)(components, key);
+            return { status: 204 };
+        }
+        catch (error) {
+            components.logger.error(`Failed to delete storage value '${key}': ${error}`);
+            return { status: 500, body: { message: `Failed to delete storage value '${key}'` } };
+        }
+    });
+    // Player Storage list endpoint (GET /players/:address/values, optional ?prefix=&limit=&offset=)
+    router.get('/players/:address/values', withAddressValidation, async (ctx) => {
+        const { address } = ctx.params;
+        const prefix = ctx.url.searchParams.get('prefix');
+        const limitParam = ctx.url.searchParams.get('limit');
+        const offsetParam = ctx.url.searchParams.get('offset');
+        const storage = await (0, runtime_env_1.loadServerStorage)(components);
+        const playerData = storage.players[address] ?? {};
+        let entries = Object.entries(playerData).map(([key, value]) => ({ key, value }));
+        if (prefix !== null && prefix !== '') {
+            entries = entries.filter((entry) => entry.key.startsWith(prefix));
+        }
+        const total = entries.length;
+        const offset = offsetParam !== null ? Math.max(0, parseInt(offsetParam, 10) || 0) : 0;
+        const limit = limitParam !== null ? Math.max(1, parseInt(limitParam, 10) || 0) : entries.length;
+        const paginatedEntries = limit > 0 ? entries.slice(offset, offset + limit) : entries.slice(offset);
+        return { body: JSON.stringify({ data: paginatedEntries, pagination: { offset, total } }) };
+    });
+    // Player Storage endpoints (/players/:address/values/:key)
+    router.get('/players/:address/values/:key', withAddressValidation, withKeyValidation, async (ctx) => {
+        const { address, key } = ctx.params;
+        const value = await (0, runtime_env_1.getPlayerValue)(components, address, key);
+        if (value === undefined) {
+            return { status: 404, body: { message: `Player storage key '${key}' not found for '${address}'` } };
+        }
+        return { body: JSON.stringify({ value }) };
+    });
+    router.put('/players/:address/values/:key', withAddressValidation, withKeyValidation, async (ctx) => {
+        const { address, key } = ctx.params;
+        try {
+            const bodyText = await ctx.request.text();
+            const { value } = JSON.parse(bodyText);
+            await (0, runtime_env_1.setPlayerValue)(components, address, key, value);
+            return { body: JSON.stringify({ value }) };
+        }
+        catch (error) {
+            components.logger.error(`Failed to set player storage value '${key}' for '${address}': ${error}`);
+            return { status: 500, body: { message: `Failed to set player storage value '${key}' for '${address}'` } };
+        }
+    });
+    router.delete('/players/:address/values/:key', withAddressValidation, withKeyValidation, async (ctx) => {
+        const { address, key } = ctx.params;
+        try {
+            await (0, runtime_env_1.deletePlayerValue)(components, address, key);
+            return { status: 204 };
+        }
+        catch (error) {
+            components.logger.error(`Failed to delete player storage value '${key}' for '${address}': ${error}`);
+            return { status: 500, body: { message: `Failed to delete player storage value '${key}' for '${address}'` } };
+        }
+    });
+}
+//# sourceMappingURL=storage-service.js.map

package/dist/commands/start/server/storage-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-service.js","sourceRoot":"","sources":["../../../../src/commands/start/server/storage-service.ts"],"names":[],"mappings":";;AAqBA,sDAwLC;AAxMD,+CAWsB;AAEtB;;GAEG;AACH,SAAgB,qBAAqB,CACnC,UAAyB,EACzB,MAAiC,EACjC,SAAoB;IAEpB,MAAM,iBAAiB,GAEnB,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;YACpB,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE,CAAA;QAC9D,CAAC;QACD,OAAO,IAAI,EAAE,CAAA;IACf,CAAC,CAAA;IAED,MAAM,qBAAqB,GAEvB,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxB,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE,EAAE,CAAA;QAClE,CAAC;QACD,OAAO,IAAI,EAAE,CAAA;IACf,CAAC,CAAA;IAED,8CAA8C;IAC9C,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACvD,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM,CAAA;QAE1B,MAAM,OAAO,GAAG,MAAM,IAAA,0BAAY,EAAC,UAAU,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAA;QACtF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAE9B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,yBAAyB,GAAG,aAAa,EAAE,EAAE,CAAA;QACtF,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACvD,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM,CAAA;QAE1B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;YACzC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YACtC,MAAM,IAAA,yBAAW,EAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;YACzC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAA;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,GAAG,MAAM,KAAK,EAAE,CAAC,CAAA;YAChF,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,uCAAuC,GAAG,GAAG,EAAE,EAAE,CAAA;QAC1F,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1D,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM,CAAA;QAE1B,IAAI,CAAC;YACH,MAAM,IAAA,4BAAc,EAAC,UAAU,EAAE,GAAG,CAAC,CAAA;YACrC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAA;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,0CAA0C,GAAG,MAAM,KAAK,EAAE,CAAC,CAAA;YACnF,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,0CAA0C,GAAG,GAAG,EAAE,EAAE,CAAA;QAC7F,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,8EAA8E;IAC9E,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAClC,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACjD,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACpD,MAAM,WAAW,GAAG,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAEtD,MAAM,OAAO,GAAG,MAAM,IAAA,+BAAiB,EAAC,UAAU,CAAC,CAAA;QACnD,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;QAEnF,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;YACrC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;QACnE,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAA;QAC5B,MAAM,MAAM,GAAG,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACrF,MAAM,KAAK,GAAG,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAA;QAC/F,MAAM,gBAAgB,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAElG,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAA;IAC5F,CAAC,CAAC,CAAA;IAEF,yCAAyC;IACzC,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1D,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM,CAAA;QAE1B,MAAM,KAAK,GAAG,MAAM,IAAA,2BAAa,EAAC,UAAU,EAAE,GAAG,CAAC,CAAA;QAClD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,gBAAgB,GAAG,aAAa,EAAE,EAAE,CAAA;QAC7E,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1D,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM,CAAA;QAE1B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;YACzC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YACtC,MAAM,IAAA,2BAAa,EAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;YAC3C,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,GAAG,MAAM,KAAK,EAAE,CAAC,CAAA;YACzE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,gCAAgC,GAAG,GAAG,EAAE,EAAE,CAAA;QACnF,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC7D,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM,CAAA;QAE1B,IAAI,CAAC;YACH,MAAM,IAAA,8BAAgB,EAAC,UAAU,EAAE,GAAG,CAAC,CAAA;YACvC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAA;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,GAAG,MAAM,KAAK,EAAE,CAAC,CAAA;YAC5E,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,mCAAmC,GAAG,GAAG,EAAE,EAAE,CAAA;QACtF,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,gGAAgG;IAChG,MAAM,CAAC,GAAG,CAAC,0BAA0B,EAAE,qBAAqB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1E,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,CAAA;QAC9B,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACjD,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACpD,MAAM,WAAW,GAAG,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAEtD,MAAM,OAAO,GAAG,MAAM,IAAA,+BAAiB,EAAC,UAAU,CAAC,CAAA;QACnD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;QACjD,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;QAEhF,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;YACrC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;QACnE,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAA;QAC5B,MAAM,MAAM,GAAG,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACrF,MAAM,KAAK,GAAG,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAA;QAC/F,MAAM,gBAAgB,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAElG,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAA;IAC5F,CAAC,CAAC,CAAA;IAEF,2DAA2D;IAC3D,MAAM,CAAC,GAAG,CAAC,+BAA+B,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAClG,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM,CAAA;QAEnC,MAAM,KAAK,GAAG,MAAM,IAAA,4BAAc,EAAC,UAAU,EAAE,OAAO,EAAE,GAAG,CAAC,CAAA;QAE5D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,uBAAuB,GAAG,oBAAoB,OAAO,GAAG,EAAE,EAAE,CAAA;QACrG,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,GAAG,CAAC,+BAA+B,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAClG,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM,CAAA;QAEnC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;YACzC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YAEtC,MAAM,IAAA,4BAAc,EAAC,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;YAErD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,GAAG,UAAU,OAAO,MAAM,KAAK,EAAE,CAAC,CAAA;YACjG,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,uCAAuC,GAAG,UAAU,OAAO,GAAG,EAAE,EAAE,CAAA;QAC3G,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,MAAM,CAAC,+BAA+B,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACrG,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM,CAAA;QAEnC,IAAI,CAAC;YACH,MAAM,IAAA,+BAAiB,EAAC,UAAU,EAAE,OAAO,EAAE,GAAG,CAAC,CAAA;YACjD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAA;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,0CAA0C,GAAG,UAAU,OAAO,MAAM,KAAK,EAAE,CAAC,CAAA;YACpG,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,0CAA0C,GAAG,UAAU,OAAO,GAAG,EAAE,EAAE,CAAA;QAC9G,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

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

@@ -4,6 +4,7 @@ import { RoomComponent } from '@dcl/mini-comms/dist/adapters/rooms';
 import { WebSocketComponent } from './server/ws';
 import { CliComponents } from '../../components';
 import { ISignalerComponent } from '../../components/exit-signal';
+import { ChildProcess } from 'child_process';
 export type PreviewComponents = CliComponents & {
     logs: ILoggerComponent;
     server: IHttpServerComponent<PreviewComponents>;
@@ -13,4 +14,6 @@ export type PreviewComponents = CliComponents & {
     rooms: RoomComponent;
     ws: WebSocketComponent;
     signaler: ISignalerComponent;
+    /** Authoritative Server process (@dcl/hammurabi-server) */
+    hammurabiServer?: ChildProcess;
 };

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

@@ -6,3 +6,37 @@ export declare function getLanIp(): string | undefined;
  * Get the full LAN URL with protocol for external device access
  */
 export declare function getLanUrl(port: number | string): string | undefined;
+/**
+ * Detects if the code is running in an Electron environment
+ */
+export declare function isElectronEnvironment(): boolean;
+/**
+ * Gets the spawn environment, adding ELECTRON_RUN_AS_NODE if running in Electron
+ */
+export declare function getSpawnEnv(): {
+    [key: string]: string;
+};
+/**
+ * Gets the npm binary name (npm or npm.cmd on Windows)
+ */
+export declare function getNpmBin(): string;
+/**
+ * Gets the npx binary name (npx or npx.cmd on Windows)
+ */
+export declare function getNpxBin(): string;
+/**
+ * Gets the npm-cli.js path in Electron environment, or null if not found
+ * Should only be called when isElectronEnvironment() returns true
+ */
+export declare function getElectronNpm(): string | null;
+/**
+ * Attempts to find npx-cli.js on disk. Works in both regular Node.js and Electron.
+ *
+ * Tries three strategies:
+ * 1. Derive from process.execPath (standard Node.js installs, nvm, etc.)
+ * 2. Look alongside the npm binary found on PATH
+ * 3. Look inside Electron's app.asar.unpacked bundled npm (e.g. Creator Hub)
+ *
+ * Returns the absolute path to npx-cli.js, or null if not found.
+ */
+export declare function findNpxCliJs(): string | null;

package/dist/commands/start/utils.js

@@ -32,10 +32,24 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getLanIp = getLanIp;
 exports.getLanUrl = getLanUrl;
+exports.isElectronEnvironment = isElectronEnvironment;
+exports.getSpawnEnv = getSpawnEnv;
+exports.getNpmBin = getNpmBin;
+exports.getNpxBin = getNpxBin;
+exports.getElectronNpm = getElectronNpm;
+exports.findNpxCliJs = findNpxCliJs;
 const os = __importStar(require("os"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+// Platform-aware binary names
+const npmBin = /^win/.test(process.platform) ? 'npm.cmd' : 'npm';
+const npxBin = /^win/.test(process.platform) ? 'npx.cmd' : 'npx';
 /**
  * Get the LAN IP address for external device access (e.g., mobile preview)
  */
@@ -54,4 +68,94 @@ function getLanUrl(port) {
         return undefined;
     return `http://${ip}:${port}`;
 }
+/**
+ * Detects if the code is running in an Electron environment
+ */
+function isElectronEnvironment() {
+    return typeof process.versions !== 'undefined' && 'electron' in process.versions;
+}
+/**
+ * Gets the spawn environment, adding ELECTRON_RUN_AS_NODE if running in Electron
+ */
+function getSpawnEnv() {
+    if (isElectronEnvironment()) {
+        return {
+            ...process.env,
+            ELECTRON_RUN_AS_NODE: '1'
+        };
+    }
+    return process.env;
+}
+/**
+ * Gets the npm binary name (npm or npm.cmd on Windows)
+ */
+function getNpmBin() {
+    return npmBin;
+}
+/**
+ * Gets the npx binary name (npx or npx.cmd on Windows)
+ */
+function getNpxBin() {
+    return npxBin;
+}
+/**
+ * Gets the npm-cli.js path in Electron environment, or null if not found
+ * Should only be called when isElectronEnvironment() returns true
+ */
+function getElectronNpm() {
+    const npmPath = process.env.PATH?.split(path_1.default.delimiter)
+        .map((dir) => path_1.default.join(dir, npmBin))
+        .find((npm) => fs_1.default.existsSync(npm)) || npmBin;
+    if (fs_1.default.existsSync(npmPath)) {
+        const npmCliJs = path_1.default.join(path_1.default.dirname(npmPath), 'npm-cli.js');
+        if (fs_1.default.existsSync(npmCliJs)) {
+            return npmCliJs;
+        }
+    }
+    return null;
+}
+/**
+ * Attempts to find npx-cli.js on disk. Works in both regular Node.js and Electron.
+ *
+ * Tries three strategies:
+ * 1. Derive from process.execPath (standard Node.js installs, nvm, etc.)
+ * 2. Look alongside the npm binary found on PATH
+ * 3. Look inside Electron's app.asar.unpacked bundled npm (e.g. Creator Hub)
+ *
+ * Returns the absolute path to npx-cli.js, or null if not found.
+ */
+function findNpxCliJs() {
+    const execDir = path_1.default.dirname(process.execPath);
+    // Strategy 1: Derive from process.execPath
+    // Unix:    {prefix}/bin/node  -> {prefix}/lib/node_modules/npm/bin/npx-cli.js
+    // Windows: {prefix}/node.exe  -> {prefix}/node_modules/npm/bin/npx-cli.js
+    const execPathCandidates = [
+        path_1.default.join(execDir, '..', 'lib', 'node_modules', 'npm', 'bin', 'npx-cli.js'),
+        path_1.default.join(execDir, 'node_modules', 'npm', 'bin', 'npx-cli.js')
+    ];
+    for (const candidate of execPathCandidates) {
+        if (fs_1.default.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    // Strategy 2: Find npx-cli.js next to npm on PATH
+    const npmPath = process.env.PATH?.split(path_1.default.delimiter)
+        .map((dir) => path_1.default.join(dir, npmBin))
+        .find((npm) => fs_1.default.existsSync(npm)) || npmBin;
+    if (fs_1.default.existsSync(npmPath)) {
+        const npxCliJs = path_1.default.join(path_1.default.dirname(npmPath), 'npx-cli.js');
+        if (fs_1.default.existsSync(npxCliJs)) {
+            return npxCliJs;
+        }
+    }
+    // Strategy 3: Look in Electron's app.asar.unpacked bundled npm
+    const resourcesPath = process.resourcesPath;
+    if (resourcesPath) {
+        const npxCliJs = path_1.default.join(resourcesPath, 'app.asar.unpacked', 'node_modules', 'npm', 'bin', 'npx-cli.js');
+        if (fs_1.default.existsSync(npxCliJs)) {
+            return npxCliJs;
+        }
+    }
+    return null;
+}
 //# sourceMappingURL=utils.js.map

package/dist/commands/start/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/commands/start/utils.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKA,4BAKC;AAKD,8BAIC;AAnBD,uCAAwB;AAExB;;GAEG;AACH,SAAgB,QAAQ;IACtB,MAAM,iBAAiB,GAAG,EAAE,CAAC,iBAAiB,EAAE,CAAA;IAChD,OAAO,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC;SACpC,IAAI,EAAE;SACN,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,OAAO,KAAK,WAAW,CAAC,EAAE,OAAO,CAAA;AACnH,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAC,IAAqB;IAC7C,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAA;IACrB,IAAI,CAAC,EAAE;QAAE,OAAO,SAAS,CAAA;IACzB,OAAO,UAAU,EAAE,IAAI,IAAI,EAAE,CAAA;AAC/B,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/commands/start/utils.ts"],"names":[],"mappings":"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"}

package/dist/commands/storage/env.d.ts

@@ -0,0 +1,5 @@
+import { Options } from './types';
+/**
+ * Handles environment variable operations in the server-side storage service (set, delete, clear)
+ */
+export declare const handleEnv: (action: string, key: string | undefined, options: Options) => Promise<void>;