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

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,130 @@
+"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 error_1 = require("../../logic/error");
+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.`);
+    }
+    // Route to appropriate handler
+    try {
+        if (subcommand === 'env') {
+            await (0, env_1.handleEnv)(action, key, options);
+        }
+        else if (subcommand === 'scene') {
+            await (0, scene_1.handleScene)(action, key, options);
+        }
+        else if (subcommand === 'player') {
+            await (0, player_1.handlePlayer)(action, key, options);
+        }
+    }
+    catch (error) {
+        if (error instanceof error_1.CliError) {
+            throw error;
+        }
+        throw new error_1.CliError('STORAGE_OPERATION_FAILED', `Storage operation failed: ${error.message}`);
+    }
+}
+//# 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":";;;AAkCA,oBAiEC;AAED,oBA4CC;AAhJD,2CAA8C;AAE9C,6CAA4C;AAC5C,+BAAiC;AACjC,mCAAqC;AACrC,qCAAuC;AAO1B,QAAA,IAAI,GAAG,IAAA,kBAAW,EAAC;IAC9B,QAAQ,EAAE,OAAO;IACjB,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,MAAM;IAClB,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,MAAM;IAChB,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,OAAO;IAClB,cAAc,EAAE,OAAO;IACvB,IAAI,EAAE,cAAc;IACpB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,MAAM;IACnB,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,OAAO;IACpB,IAAI,EAAE,WAAW;CAClB,CAAC,CAAA;AAEF,MAAM,kBAAkB,GAAG,kCAAkC,CAAA;AAE7D,SAAgB,IAAI,CAAC,OAAgB;IACnC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;sEAgBsC,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+CvF,CAAC,CAAA;AACF,CAAC;AAEM,KAAK,UAAU,IAAI,CAAC,OAAgB;IACzC,mEAAmE;IACnE,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;IAE3E,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,gBAAQ,CAChB,4BAA4B,EAC5B,yIAAyI,CAC1I,CAAA;IACH,CAAC;IAED,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,GAAG,cAAc,CAAA;IAEhD,sBAAsB;IACtB,IAAI,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,gBAAQ,CAChB,4BAA4B,EAC5B,uBAAuB,UAAU,wFAAwF,CAC1H,CAAA;IACH,CAAC;IAED,8BAA8B;IAC9B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,gBAAQ,CAChB,wBAAwB,EACxB,uBAAuB,UAAU,4DAA4D,CAC9F,CAAA;IACH,CAAC;IAED,+BAA+B;IAC/B,IAAI,CAAC;QACH,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;YACzB,MAAM,IAAA,eAAS,EAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAA;QACvC,CAAC;aAAM,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;YAClC,MAAM,IAAA,mBAAW,EAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAA;QACzC,CAAC;aAAM,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;YACnC,MAAM,IAAA,qBAAY,EAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAA;QAC1C,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,gBAAQ,EAAE,CAAC;YAC9B,MAAM,KAAK,CAAA;QACb,CAAC;QACD,MAAM,IAAI,gBAAQ,CAAC,0BAA0B,EAAE,6BAA8B,KAAe,CAAC,OAAO,EAAE,CAAC,CAAA;IACzG,CAAC;AACH,CAAC"}

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

package/dist/commands/storage/player.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handlePlayer = 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 player storage operations in the server-side storage service (get, set, delete, clear)
+ */
+const handlePlayer = 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'], ['get', 'set', 'delete', 'clear']);
+    // Get address (required for get/set/delete, optional for clear)
+    const address = options.args['--address'];
+    // Linker dApp options
+    const linkOptions = (0, shared_1.getLinkerDappOptions)(options.args);
+    // Handle actions
+    if (action === 'get') {
+        // GET operation
+        if (!address) {
+            throw new error_1.CliError('STORAGE_MISSING_ADDRESS', 'Missing --address option. Usage: storage player get KEY --address 0x...');
+        }
+        if (!key) {
+            throw new error_1.CliError('STORAGE_MISSING_KEY', 'Missing KEY argument. Usage: storage player get KEY --address 0x...');
+        }
+        logger.info(`Getting player storage value '${key}' for ${address} from ${baseURL}`);
+        const url = `${baseURL}/players/${encodeURIComponent(address)}/values/${encodeURIComponent(key)}`;
+        const info = (0, shared_1.createStorageInfo)('player', 'get', url, worldName, baseParcel, parcels, key, undefined, address);
+        const result = await (0, shared_1.makeAuthenticatedRequest)(options.components, info, linkOptions, 'GET', url);
+        if (result.success) {
+            analytics.track('Storage Player Get Success', { key, address });
+            logger.log(`\nValue for '${key}' (${address}):`);
+            logger.log(JSON.stringify(result.data, null, 2));
+        }
+        else {
+            analytics.track('Storage Player Get Failure', { key, address });
+            (0, beautiful_logs_1.printError)(logger, `Failed to get player storage value '${key}' for ${address}:`, new Error(result.error || 'Unknown error'));
+        }
+    }
+    else if (action === 'set') {
+        // SET operation
+        if (!address) {
+            throw new error_1.CliError('STORAGE_MISSING_ADDRESS', 'Missing --address option. Usage: storage player set KEY --value VALUE --address 0x...');
+        }
+        if (!key) {
+            throw new error_1.CliError('STORAGE_MISSING_KEY', 'Missing KEY argument. Usage: storage player set KEY --value VALUE --address 0x...');
+        }
+        const value = options.args['--value'];
+        if (value === undefined) {
+            throw new error_1.CliError('STORAGE_MISSING_VALUE', 'Missing --value option. Usage: storage player set KEY --value VALUE --address 0x...');
+        }
+        logger.info(`Setting player storage value '${key}' for ${address} to ${baseURL}`);
+        const url = `${baseURL}/players/${encodeURIComponent(address)}/values/${encodeURIComponent(key)}`;
+        const info = (0, shared_1.createStorageInfo)('player', 'set', url, worldName, baseParcel, parcels, key, value, address);
+        const result = await (0, shared_1.makeAuthenticatedRequest)(options.components, info, linkOptions, 'PUT', url, { value });
+        if (result.success) {
+            analytics.track('Storage Player Set Success', { key, address });
+            (0, beautiful_logs_1.printSuccess)(logger, `Player storage value '${key}' for ${address} set successfully!`, '');
+        }
+        else {
+            analytics.track('Storage Player Set Failure', { key, address });
+            (0, beautiful_logs_1.printError)(logger, `Failed to set player storage value '${key}' for ${address}:`, new Error(result.error || 'Unknown error'));
+        }
+    }
+    else if (action === 'delete') {
+        // DELETE operation
+        if (!address) {
+            throw new error_1.CliError('STORAGE_MISSING_ADDRESS', 'Missing --address option. Usage: storage player delete KEY --address 0x...');
+        }
+        if (!key) {
+            throw new error_1.CliError('STORAGE_MISSING_KEY', 'Missing KEY argument. Usage: storage player delete KEY --address 0x...');
+        }
+        logger.info(`Deleting player storage value '${key}' for ${address} from ${baseURL}`);
+        const url = `${baseURL}/players/${encodeURIComponent(address)}/values/${encodeURIComponent(key)}`;
+        const info = (0, shared_1.createStorageInfo)('player', 'delete', url, worldName, baseParcel, parcels, key, undefined, address);
+        const result = await (0, shared_1.makeAuthenticatedRequest)(options.components, info, linkOptions, 'DELETE', url);
+        if (result.success) {
+            analytics.track('Storage Player Delete Success', { key, address });
+            (0, beautiful_logs_1.printSuccess)(logger, `Player storage value '${key}' for ${address} deleted successfully!`, '');
+        }
+        else {
+            analytics.track('Storage Player Delete Failure', { key, address });
+            (0, beautiful_logs_1.printError)(logger, `Failed to delete player storage value '${key}' for ${address}:`, new Error(result.error || 'Unknown error'));
+        }
+    }
+    else if (action === 'clear') {
+        // CLEAR operation
+        const hasConfirm = options.args['--confirm'];
+        if (address) {
+            // Clear specific player
+            if (!hasConfirm) {
+                const confirmed = await (0, shared_1.confirmAction)(`Are you sure you want to delete ALL storage data for player ${address}? This cannot be undone.`);
+                if (!confirmed) {
+                    logger.info('Operation cancelled.');
+                    return;
+                }
+            }
+            logger.info(`Clearing all storage data for player ${address} from ${baseURL}`);
+            const url = `${baseURL}/players/${encodeURIComponent(address)}/values`;
+            const info = (0, shared_1.createStorageInfo)('player', 'clear', url, worldName, baseParcel, parcels, undefined, undefined, address);
+            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 Player Clear Success', { address });
+                (0, beautiful_logs_1.printSuccess)(logger, `All storage data for player ${address} cleared successfully!`, '');
+            }
+            else {
+                analytics.track('Storage Player Clear Failure', { address });
+                (0, beautiful_logs_1.printError)(logger, `Failed to clear storage data for player ${address}:`, new Error(result.error || 'Unknown error'));
+            }
+        }
+        else {
+            // Clear all players
+            if (!hasConfirm) {
+                const confirmed = await (0, shared_1.confirmAction)('Are you sure you want to delete ALL player storage data for ALL players? This cannot be undone.');
+                if (!confirmed) {
+                    logger.info('Operation cancelled.');
+                    return;
+                }
+            }
+            logger.info(`Clearing all player storage data from ${baseURL}`);
+            const url = `${baseURL}/players`;
+            const info = (0, shared_1.createStorageInfo)('player', '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 Player Clear All Success', {});
+                (0, beautiful_logs_1.printSuccess)(logger, 'All player storage data cleared successfully!', '');
+            }
+            else {
+                analytics.track('Storage Player Clear All Failure', {});
+                (0, beautiful_logs_1.printError)(logger, 'Failed to clear all player storage data:', new Error(result.error || 'Unknown error'));
+            }
+        }
+    }
+};
+exports.handlePlayer = handlePlayer;
+//# sourceMappingURL=player.js.map

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

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

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

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

package/dist/commands/storage/scene.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleScene = 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 scene storage operations in the server-side storage service (get, set, delete, clear)
+ */
+const handleScene = 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'], ['get', 'set', 'delete', 'clear']);
+    // Linker dApp options
+    const linkOptions = (0, shared_1.getLinkerDappOptions)(options.args);
+    // Handle actions
+    if (action === 'get') {
+        // GET operation
+        if (!key) {
+            throw new error_1.CliError('STORAGE_MISSING_KEY', 'Missing KEY argument. Usage: storage scene get KEY');
+        }
+        logger.info(`Getting scene storage value '${key}' from ${baseURL}`);
+        const url = `${baseURL}/values/${encodeURIComponent(key)}`;
+        const info = (0, shared_1.createStorageInfo)('scene', 'get', url, worldName, baseParcel, parcels, key);
+        const result = await (0, shared_1.makeAuthenticatedRequest)(options.components, info, linkOptions, 'GET', url);
+        if (result.success) {
+            analytics.track('Storage Scene Get Success', { key });
+            logger.log(`\nValue for '${key}':`);
+            logger.log(JSON.stringify(result.data, null, 2));
+        }
+        else {
+            analytics.track('Storage Scene Get Failure', { key });
+            (0, beautiful_logs_1.printError)(logger, `Failed to get scene storage value '${key}':`, new Error(result.error || 'Unknown error'));
+        }
+    }
+    else if (action === 'set') {
+        // SET operation
+        if (!key) {
+            throw new error_1.CliError('STORAGE_MISSING_KEY', 'Missing KEY argument. Usage: storage scene 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 scene set KEY --value VALUE');
+        }
+        logger.info(`Setting scene storage value '${key}' to ${baseURL}`);
+        const url = `${baseURL}/values/${encodeURIComponent(key)}`;
+        const info = (0, shared_1.createStorageInfo)('scene', '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 Scene Set Success', { key });
+            (0, beautiful_logs_1.printSuccess)(logger, `Scene storage value '${key}' set successfully!`, '');
+        }
+        else {
+            analytics.track('Storage Scene Set Failure', { key });
+            (0, beautiful_logs_1.printError)(logger, `Failed to set scene storage value '${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 scene delete KEY');
+        }
+        logger.info(`Deleting scene storage value '${key}' from ${baseURL}`);
+        const url = `${baseURL}/values/${encodeURIComponent(key)}`;
+        const info = (0, shared_1.createStorageInfo)('scene', '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 Scene Delete Success', { key });
+            (0, beautiful_logs_1.printSuccess)(logger, `Scene storage value '${key}' deleted successfully!`, '');
+        }
+        else {
+            analytics.track('Storage Scene Delete Failure', { key });
+            (0, beautiful_logs_1.printError)(logger, `Failed to delete scene storage value '${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 scene storage data? This cannot be undone.');
+            if (!confirmed) {
+                logger.info('Operation cancelled.');
+                return;
+            }
+        }
+        logger.info(`Clearing all scene storage data from ${baseURL}`);
+        const url = `${baseURL}/values`;
+        const info = (0, shared_1.createStorageInfo)('scene', '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 Scene Clear Success', {});
+            (0, beautiful_logs_1.printSuccess)(logger, 'All scene storage data cleared successfully!', '');
+        }
+        else {
+            analytics.track('Storage Scene Clear Failure', {});
+            (0, beautiful_logs_1.printError)(logger, 'Failed to clear scene storage data:', new Error(result.error || 'Unknown error'));
+        }
+    }
+};
+exports.handleScene = handleScene;
+//# sourceMappingURL=scene.js.map

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

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

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

@@ -0,0 +1,62 @@
+import { IFuture } from 'fp-future';
+import { Lifecycle } from '@well-known-components/interfaces';
+import { CliComponents } from '../../components';
+import { LinkerResponse } from '../../linker-dapp/routes';
+import { StorageInfo, LinkerOptions, StorageType } from './types';
+/**
+ * Validates workspace and extracts world configuration for server-side storage operations
+ */
+export declare const validateWorkspaceAndWorld: (components: CliComponents, projectRoot: string, baseURL: string) => Promise<{
+    worldName: string | undefined;
+    baseParcel: string;
+    parcels: string[];
+}>;
+/**
+ * Builds metadata for server-side storage service requests (ADR-44 format)
+ */
+export declare const buildStorageMetadata: (worldName: string | undefined, baseParcel: string) => string;
+/**
+ * Confirms an action with the user
+ * Accepts: yes, y, no, n (case insensitive)
+ */
+export declare const confirmAction: (message: string) => Promise<boolean>;
+/**
+ * Extracts linker dApp options from command arguments
+ */
+export declare const getLinkerDappOptions: (args: {
+    "--port"?: number;
+    "--no-browser"?: boolean;
+    "--https"?: boolean;
+}) => LinkerOptions;
+/**
+ * Common setup for server-side storage commands: validates action, workspace, and world configuration
+ */
+export declare const setupStorageCommand: (components: CliComponents, projectRoot: string, action: string, targetArg: string | undefined, validActions: string[]) => Promise<{
+    baseURL: string;
+    worldName: string | undefined;
+    baseParcel: string;
+    parcels: string[];
+}>;
+export type StorageOperationResult = {
+    success: boolean;
+    data?: any;
+    error?: string;
+};
+/**
+ * Gets authentication (private key or linker dApp) and executes callback with signed headers
+ */
+export declare const getAuthHeaders: (components: CliComponents, awaitResponse: IFuture<void>, info: StorageInfo, linkOptions: LinkerOptions, deployCallback: (response: LinkerResponse) => Promise<StorageOperationResult>) => Promise<{
+    program?: Lifecycle.ComponentBasedProgram<unknown>;
+}>;
+/**
+ * Makes an authenticated request to the server-side storage service
+ */
+export declare const makeAuthenticatedRequest: (components: CliComponents, info: StorageInfo, linkOptions: LinkerOptions, method: "GET" | "PUT" | "DELETE", url: string, body?: any, additionalHeaders?: Record<string, string>) => Promise<StorageOperationResult>;
+/**
+ * Gets the base URL for server-side storage service operations
+ */
+export declare const getStorageBaseUrl: (targetArg?: string) => string;
+/**
+ * Creates storage info object for signing server-side storage service requests
+ */
+export declare const createStorageInfo: (storageType: StorageType, action: "get" | "set" | "delete" | "clear", url: string, worldName: string | undefined, baseParcel: string, parcels: string[], key?: string, value?: string, address?: string) => StorageInfo;