@dcl/sdk-commands 7.21.1-22917715332.commit-e5d969d → 7.21.1-22918726402.commit-ee210ee

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":"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"}

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>;

package/dist/commands/storage/env.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleEnv = void 0;
+const path_1 = require("path");
+const error_1 = require("../../logic/error");
+const beautiful_logs_1 = require("../../logic/beautiful-logs");
+const shared_1 = require("./shared");
+/**
+ * Handles environment variable operations in the server-side storage service (set, delete, clear)
+ */
+const handleEnv = async (action, key, options) => {
+    const { logger, analytics } = options.components;
+    const projectRoot = (0, path_1.resolve)(process.cwd(), options.args['--dir'] || '.');
+    // Common setup: validate action, workspace, and world
+    const { baseURL, worldName, baseParcel, parcels } = await (0, shared_1.setupStorageCommand)(options.components, projectRoot, action, options.args['--target'], ['set', 'delete', 'clear']);
+    // Linker dApp options
+    const linkOptions = (0, shared_1.getLinkerDappOptions)(options.args);
+    // Handle actions
+    if (action === 'set') {
+        // SET operation
+        if (!key) {
+            throw new error_1.CliError('STORAGE_MISSING_KEY', 'Missing KEY argument. Usage: storage env set KEY --value VALUE');
+        }
+        const value = options.args['--value'];
+        if (value === undefined) {
+            throw new error_1.CliError('STORAGE_MISSING_VALUE', 'Missing --value option. Usage: storage env set KEY --value VALUE');
+        }
+        logger.info(`Setting environment variable '${key}' to ${baseURL}`);
+        const url = `${baseURL}/env/${encodeURIComponent(key)}`;
+        const info = (0, shared_1.createStorageInfo)('env', 'set', url, worldName, baseParcel, parcels, key, value);
+        const result = await (0, shared_1.makeAuthenticatedRequest)(options.components, info, linkOptions, 'PUT', url, { value });
+        if (result.success) {
+            analytics.track('Storage Env Set Success', { key });
+            (0, beautiful_logs_1.printSuccess)(logger, `Environment variable '${key}' set successfully!`, '');
+        }
+        else {
+            analytics.track('Storage Env Set Failure', { key });
+            (0, beautiful_logs_1.printError)(logger, `Failed to set environment variable '${key}':`, new Error(result.error || 'Unknown error'));
+        }
+    }
+    else if (action === 'delete') {
+        // DELETE operation
+        if (!key) {
+            throw new error_1.CliError('STORAGE_MISSING_KEY', 'Missing KEY argument. Usage: storage env delete KEY');
+        }
+        logger.info(`Deleting environment variable '${key}' from ${baseURL}`);
+        const url = `${baseURL}/env/${encodeURIComponent(key)}`;
+        const info = (0, shared_1.createStorageInfo)('env', 'delete', url, worldName, baseParcel, parcels, key);
+        const result = await (0, shared_1.makeAuthenticatedRequest)(options.components, info, linkOptions, 'DELETE', url);
+        if (result.success) {
+            analytics.track('Storage Env Delete Success', { key });
+            (0, beautiful_logs_1.printSuccess)(logger, `Environment variable '${key}' deleted successfully!`, '');
+        }
+        else {
+            analytics.track('Storage Env Delete Failure', { key });
+            (0, beautiful_logs_1.printError)(logger, `Failed to delete environment variable '${key}':`, new Error(result.error || 'Unknown error'));
+        }
+    }
+    else if (action === 'clear') {
+        // CLEAR operation
+        const hasConfirm = options.args['--confirm'];
+        if (!hasConfirm) {
+            const confirmed = await (0, shared_1.confirmAction)('Are you sure you want to delete ALL environment variables? This cannot be undone.');
+            if (!confirmed) {
+                logger.info('Operation cancelled.');
+                return;
+            }
+        }
+        logger.info(`Clearing all environment variables from ${baseURL}`);
+        const url = `${baseURL}/env`;
+        const info = (0, shared_1.createStorageInfo)('env', 'clear', url, worldName, baseParcel, parcels);
+        const result = await (0, shared_1.makeAuthenticatedRequest)(options.components, info, linkOptions, 'DELETE', url, undefined, {
+            'X-Confirm-Delete-All': 'true'
+        });
+        if (result.success) {
+            analytics.track('Storage Env Clear Success', {});
+            (0, beautiful_logs_1.printSuccess)(logger, 'All environment variables cleared successfully!', '');
+        }
+        else {
+            analytics.track('Storage Env Clear Failure', {});
+            (0, beautiful_logs_1.printError)(logger, 'Failed to clear environment variables:', new Error(result.error || 'Unknown error'));
+        }
+    }
+};
+exports.handleEnv = handleEnv;
+//# sourceMappingURL=env.js.map

package/dist/commands/storage/env.js.map

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

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

@@ -0,0 +1,26 @@
+import { Result } from 'arg';
+import { CliComponents } from '../../components';
+export interface Options {
+    args: Result<typeof args>;
+    components: CliComponents;
+}
+export declare const args: {
+    '--help': BooleanConstructor;
+    '-h': string;
+    '--dir': StringConstructor;
+    '--target': StringConstructor;
+    '-t': string;
+    '--port': NumberConstructor;
+    '-p': string;
+    '--https': BooleanConstructor;
+    '--no-browser': BooleanConstructor;
+    '-b': string;
+    '--value': StringConstructor;
+    '-v': string;
+    '--address': StringConstructor;
+    '-a': string;
+    '--confirm': BooleanConstructor;
+    '-c': string;
+};
+export declare function help(options: Options): void;
+export declare function main(options: Options): Promise<void>;

package/dist/commands/storage/index.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.args = void 0;
+exports.help = help;
+exports.main = main;
+const args_1 = require("../../logic/args");
+const analytics_1 = require("../../components/analytics");
+const error_1 = require("../../logic/error");
+const config_1 = require("../../logic/config");
+const env_1 = require("./env");
+const scene_1 = require("./scene");
+const player_1 = require("./player");
+exports.args = (0, args_1.declareArgs)({
+    '--help': Boolean,
+    '-h': '--help',
+    '--dir': String,
+    '--target': String,
+    '-t': '--target',
+    '--port': Number,
+    '-p': '--port',
+    '--https': Boolean,
+    '--no-browser': Boolean,
+    '-b': '--no-browser',
+    '--value': String,
+    '-v': '--value',
+    '--address': String,
+    '-a': '--address',
+    '--confirm': Boolean,
+    '-c': '--confirm'
+});
+const STORAGE_SERVER_ORG = 'https://storage.decentraland.org';
+function help(options) {
+    options.components.logger.log(`
+  Usage: 'sdk-commands storage [subcommand] [action] [KEY] [options]'
+    Manages server-side storage including environment variables, scene storage, and player storage.
+    This data is stored in Decentraland's remote storage service, not in the local filesystem.
+    Requires a scene.json with worldConfiguration.name in the project directory.
+
+    Subcommands:
+      env       Manage environment variables
+      scene     Manage scene storage
+      player    Manage player storage
+
+    Options:
+      -h, --help                Displays complete help
+      -v, --value       [value] The value to set for a storage key
+      -a, --address     [addr]  Player address (for player storage operations)
+      -c, --confirm             Skip confirmation prompts for destructive operations
+      -t, --target      [URL]   Target storage server URL (default: ${STORAGE_SERVER_ORG})
+      --dir             [path]  Path to the project directory
+      -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
+
+    Target options:
+      - https://storage.decentraland.org  (production - default)
+      - https://storage.decentraland.zone (staging)
+      - http://localhost:<port>                  (local development)
+
+    Environment Variables (storage env):
+      storage env set KEY --value VALUE    Set an environment variable
+      storage env delete KEY               Delete an environment variable
+      storage env clear --confirm          Delete all environment variables
+
+    Scene Storage (storage scene):
+      storage scene set KEY --value VALUE  Set a scene storage value
+      storage scene get KEY                Get a scene storage value
+      storage scene delete KEY             Delete a scene storage value
+      storage scene clear --confirm        Delete all scene storage data
+
+    Player Storage (storage player):
+      storage player set KEY --value VALUE --address 0xABCD    Set a player storage value
+      storage player get KEY --address 0xABCD                  Get a player storage value
+      storage player delete KEY --address 0xABCD               Delete a player storage value
+      storage player clear --address 0xABCD --confirm          Delete all data for a player
+      storage player clear --confirm                           Delete all player data (all players)
+
+    Examples:
+    - Set an environment variable:
+      $ sdk-commands storage env set API_KEY --value "my-secret-key"
+
+    - Get a scene storage value:
+      $ sdk-commands storage scene get high_score
+
+    - Set player storage:
+      $ sdk-commands storage player set level --value 10 --address 0x1234...
+
+    - Clear all environment variables with confirmation:
+      $ sdk-commands storage env clear --confirm
+
+    - Deploy to staging:
+      $ sdk-commands storage env set MY_KEY --value my_value --target https://storage.decentraland.zone
+
+    - Deploy to local development server:
+      $ sdk-commands storage scene set test_key --value test_value --target http://localhost:8000
+`);
+}
+async function main(options) {
+    // Parse positional arguments: storage [subcommand] [action] [KEY?]
+    const positionalArgs = options.args._.filter((arg) => !arg.startsWith('-'));
+    if (positionalArgs.length === 0) {
+        throw new error_1.CliError('STORAGE_MISSING_SUBCOMMAND', 'Missing subcommand. Usage: storage [env|scene|player] [action] [KEY] [options]\nRun "sdk-commands storage --help" for more information.');
+    }
+    const [subcommand, action, key] = positionalArgs;
+    // Validate subcommand
+    if (!['env', 'scene', 'player'].includes(subcommand)) {
+        throw new error_1.CliError('STORAGE_INVALID_SUBCOMMAND', `Invalid subcommand '${subcommand}'. Use: env, scene, or player\nRun "sdk-commands storage --help" for more information.`);
+    }
+    // Validate action is provided
+    if (!action) {
+        throw new error_1.CliError('STORAGE_MISSING_ACTION', `Missing action for '${subcommand}'. Run "sdk-commands storage --help" for more information.`);
+    }
+    // Use storage-specific analytics; pass augmented options so handlers use it without mutating shared components
+    const storageAnalytics = await (0, analytics_1.createAnalyticsComponent)(options.components, {
+        writeKey: (0, config_1.getStorageSegmentKey)()
+    });
+    const storageOptions = {
+        ...options,
+        components: { ...options.components, analytics: storageAnalytics }
+    };
+    try {
+        if (subcommand === 'env') {
+            await (0, env_1.handleEnv)(action, key, storageOptions);
+        }
+        else if (subcommand === 'scene') {
+            await (0, scene_1.handleScene)(action, key, storageOptions);
+        }
+        else if (subcommand === 'player') {
+            await (0, player_1.handlePlayer)(action, key, storageOptions);
+        }
+    }
+    catch (error) {
+        if (error instanceof error_1.CliError) {
+            throw error;
+        }
+        throw new error_1.CliError('STORAGE_OPERATION_FAILED', `Storage operation failed: ${error.message}`);
+    }
+    finally {
+        await storageAnalytics.stop();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/storage/index.js.map

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

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

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