@dcl/sdk-commands 7.29.1-36591934525.commit-48aa9b5 → 7.29.1-36625469671.commit-2d5ffac

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

@@ -0,0 +1,243 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupStorageEndpoints = setupStorageEndpoints;
+const runtime_env_1 = require("./runtime-env");
+/** Keys live in varchar(255) columns on the deployed service. */
+const MAX_KEY_LENGTH = 255;
+/** At most this many entries per page; also the fallback for a missing or invalid limit. */
+const MAX_PAGE_SIZE = 100;
+/** The deployed pagination helper caps offsets here. */
+const MAX_OFFSET = 100000;
+/** Slack the deployed service allows on top of the per-value limit for the request envelope. */
+const BODY_ENVELOPE_SLACK_BYTES = 1024;
+const ADDRESS_PATTERN = /^0x[a-f0-9]{40}$/;
+/** A `\u0000` escape in JSON.stringify output that is not an escaped backslash followed by the text `u0000`. */
+const NUL_ESCAPE = /(?<!\\)(?:\\\\)*\\u0000/;
+const LONE_SURROGATE = /[\ud800-\udbff](?![\udc00-\udfff])|(?<![\ud800-\udbff])[\udc00-\udfff]/;
+/** The deployed service orders by its database collation, which can differ for non-ASCII and mixed case. */
+function compareByCodePoint(a, b) {
+    const left = [...a];
+    const right = [...b];
+    for (let i = 0; i < Math.min(left.length, right.length); i++) {
+        const difference = left[i].codePointAt(0) - right[i].codePointAt(0);
+        if (difference !== 0)
+            return difference;
+    }
+    return left.length - right.length;
+}
+function hasLoneSurrogate(value) {
+    if (typeof value === 'string')
+        return LONE_SURROGATE.test(value);
+    if (Array.isArray(value))
+        return value.some(hasLoneSurrogate);
+    if (value !== null && typeof value === 'object') {
+        return Object.entries(value).some(([key, item]) => LONE_SURROGATE.test(key) || hasLoneSurrogate(item));
+    }
+    return false;
+}
+/**
+ * Sets up storage-related endpoints for environment variables, scene storage, and player storage.
+ */
+function setupStorageEndpoints(components, router, workspace) {
+    const withKeyValidation = async (ctx, next) => {
+        const { key } = ctx.params;
+        if (!key || [...key].length > MAX_KEY_LENGTH) {
+            return { status: 400, body: { message: `Key must be between 1 and ${MAX_KEY_LENGTH} characters` } };
+        }
+        // Same rule as the SDK: these keys cannot be addressed by path, or stored by the deployed service.
+        if (key === '.' || key === '..' || key.includes('\u0000') || LONE_SURROGATE.test(key)) {
+            return { status: 400, body: { message: 'Invalid key' } };
+        }
+        return next();
+    };
+    const withAddressValidation = async (ctx, next) => {
+        const address = (ctx.params.address ?? '').toLowerCase();
+        if (!ADDRESS_PATTERN.test(address)) {
+            return { status: 400, body: { message: 'Invalid player address' } };
+        }
+        ctx.params.address = address;
+        return next();
+    };
+    const badRequest = (message) => ({ status: 400, body: { message } });
+    const invalidBody = () => badRequest('Invalid JSON body');
+    function serverError(what, error) {
+        components.logger.error(`Failed to ${what}: ${error}`);
+        return { status: 500, body: { message: `Failed to ${what}` } };
+    }
+    /** The body must be exactly `{ value }`. */
+    function readValueFromBody(bodyText) {
+        let parsed;
+        try {
+            parsed = JSON.parse(bodyText);
+        }
+        catch {
+            return { ok: false };
+        }
+        if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
+            return { ok: false };
+        const keys = Object.keys(parsed);
+        if (keys.length !== 1 || keys[0] !== 'value')
+            return { ok: false };
+        return { ok: true, value: parsed.value };
+    }
+    async function readPut(ctx, limits, options = {}) {
+        const bodyText = await ctx.request.text();
+        if (Buffer.byteLength(bodyText, 'utf-8') > limits.maxValueSizeBytes + BODY_ENVELOPE_SLACK_BYTES) {
+            return { response: { status: 413, body: { message: 'Request body is too large' } } };
+        }
+        const parsed = readValueFromBody(bodyText);
+        if (!parsed.ok || (options.stringOnly && typeof parsed.value !== 'string'))
+            return { response: invalidBody() };
+        if (!options.allowNul && NUL_ESCAPE.test(JSON.stringify(parsed.value))) {
+            return { response: badRequest('Values must not contain the \\u0000 (NUL) character') };
+        }
+        if (hasLoneSurrogate(parsed.value))
+            return { response: badRequest('Values must not contain unpaired surrogates') };
+        return { value: parsed.value };
+    }
+    async function write(what, store, success) {
+        try {
+            await store();
+            return success;
+        }
+        catch (error) {
+            if (error instanceof runtime_env_1.StorageLimitExceededError)
+                return badRequest(error.message);
+            return serverError(what, error);
+        }
+    }
+    function listPage(values, searchParams) {
+        const prefix = searchParams.get('prefix');
+        const matching = Object.entries(values)
+            .filter(([key]) => !prefix || key.startsWith(prefix))
+            .sort(([a], [b]) => compareByCodePoint(a, b))
+            .map(([key, value]) => ({ key, value }));
+        const requestedLimit = parseInt(searchParams.get('limit') ?? '', 10);
+        const limit = Number.isNaN(requestedLimit) || requestedLimit <= 0 || requestedLimit > MAX_PAGE_SIZE
+            ? MAX_PAGE_SIZE
+            : requestedLimit;
+        const offset = Math.min(MAX_OFFSET, Math.max(0, parseInt(searchParams.get('offset') ?? '', 10) || 0));
+        return {
+            body: JSON.stringify({
+                data: matching.slice(offset, offset + limit),
+                pagination: { limit, offset, total: matching.length }
+            })
+        };
+    }
+    // Environment variables endpoints (/env/:key)
+    router.get('/env/:key', withKeyValidation, async (ctx) => {
+        const { key } = ctx.params;
+        try {
+            const value = (await (0, runtime_env_1.getMergedEnv)(components, workspace.projects[0].workingDirectory)).get(key);
+            if (value === undefined)
+                return { status: 404, body: { message: `Environment variable '${key}' not found` } };
+            return { body: JSON.stringify({ value }) };
+        }
+        catch (error) {
+            return serverError(`get environment variable '${key}'`, error);
+        }
+    });
+    router.put('/env/:key', withKeyValidation, async (ctx) => {
+        const { key } = ctx.params;
+        try {
+            const put = await readPut(ctx, runtime_env_1.STORAGE_LIMITS.env, { stringOnly: true, allowNul: true });
+            if ('response' in put)
+                return put.response;
+            return write(`set environment variable '${key}'`, () => (0, runtime_env_1.setEnvValue)(components, key, put.value), {
+                status: 204
+            });
+        }
+        catch (error) {
+            return serverError(`set environment variable '${key}'`, error);
+        }
+    });
+    router.delete('/env/:key', withKeyValidation, async (ctx) => {
+        const { key } = ctx.params;
+        return write(`delete environment variable '${key}'`, () => (0, runtime_env_1.deleteEnvValue)(components, key).then(() => { }), {
+            status: 204
+        });
+    });
+    // Scene Storage list endpoint (GET /values, optional ?prefix=&limit=&offset=)
+    router.get('/values', async (ctx) => {
+        try {
+            return listPage(await (0, runtime_env_1.getWorldStorage)(components), ctx.url.searchParams);
+        }
+        catch (error) {
+            return serverError('list storage values', error);
+        }
+    });
+    // Scene Storage endpoints (/values/:key)
+    router.get('/values/:key', withKeyValidation, async (ctx) => {
+        const { key } = ctx.params;
+        try {
+            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 }) };
+        }
+        catch (error) {
+            return serverError(`get storage value '${key}'`, error);
+        }
+    });
+    router.put('/values/:key', withKeyValidation, async (ctx) => {
+        const { key } = ctx.params;
+        try {
+            const put = await readPut(ctx, runtime_env_1.STORAGE_LIMITS.world);
+            if ('response' in put)
+                return put.response;
+            return write(`set storage value '${key}'`, () => (0, runtime_env_1.setWorldValue)(components, key, put.value), {
+                body: JSON.stringify({ value: put.value })
+            });
+        }
+        catch (error) {
+            return serverError(`set storage value '${key}'`, error);
+        }
+    });
+    router.delete('/values/:key', withKeyValidation, async (ctx) => {
+        const { key } = ctx.params;
+        return write(`delete storage value '${key}'`, () => (0, runtime_env_1.deleteWorldValue)(components, key).then(() => { }), {
+            status: 204
+        });
+    });
+    // Player Storage list endpoint (GET /players/:address/values, optional ?prefix=&limit=&offset=)
+    router.get('/players/:address/values', withAddressValidation, async (ctx) => {
+        const { address } = ctx.params;
+        try {
+            return listPage(await (0, runtime_env_1.getPlayerStorage)(components, address), ctx.url.searchParams);
+        }
+        catch (error) {
+            return serverError(`list player storage values for '${address}'`, error);
+        }
+    });
+    // Player Storage endpoints (/players/:address/values/:key)
+    router.get('/players/:address/values/:key', withAddressValidation, withKeyValidation, async (ctx) => {
+        const { address, key } = ctx.params;
+        try {
+            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 }) };
+        }
+        catch (error) {
+            return serverError(`get player storage value '${key}' for '${address}'`, error);
+        }
+    });
+    router.put('/players/:address/values/:key', withAddressValidation, withKeyValidation, async (ctx) => {
+        const { address, key } = ctx.params;
+        try {
+            const put = await readPut(ctx, runtime_env_1.STORAGE_LIMITS.player);
+            if ('response' in put)
+                return put.response;
+            return write(`set player storage value '${key}' for '${address}'`, () => (0, runtime_env_1.setPlayerValue)(components, address, key, put.value), { body: JSON.stringify({ value: put.value }) });
+        }
+        catch (error) {
+            return serverError(`set player storage value '${key}' for '${address}'`, error);
+        }
+    });
+    router.delete('/players/:address/values/:key', withAddressValidation, withKeyValidation, async (ctx) => {
+        const { address, key } = ctx.params;
+        return write(`delete player storage value '${key}' for '${address}'`, () => (0, runtime_env_1.deletePlayerValue)(components, address, key).then(() => { }), { status: 204 });
+    });
+}
+//# 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/utils.d.ts

@@ -1,3 +1,10 @@
+declare global {
+    namespace NodeJS {
+        interface Process {
+            resourcesPath?: string;
+        }
+    }
+}
 /**
  * Get the LAN IP address for external device access (e.g., mobile preview)
  */
@@ -6,3 +13,28 @@ 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;
+};
+type NpxLookup = {
+    execPath?: string;
+    pathEnv?: string;
+    npmBin?: string;
+    npxBin?: string;
+    resourcesPath?: string;
+};
+/**
+ * Absolute path to npm's `npx-cli.js`: the npm an Electron host ships first, then the running
+ * node's own npm, then every npm on PATH (Windows layout, unix `lib` layout, or an `npm` symlink
+ * into the npm package). Null when no npm install is reachable.
+ */
+export declare function findNpxCliJs({ execPath, pathEnv, npmBin: npm, resourcesPath }?: NpxLookup): string | null;
+export declare function findNpxBin({ pathEnv, npxBin: npx }?: NpxLookup): string | null;
+export {};

package/dist/commands/start/utils.js

@@ -32,10 +32,21 @@ 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.findNpxCliJs = findNpxCliJs;
+exports.findNpxBin = findNpxBin;
 const os = __importStar(require("os"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+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 +65,65 @@ 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;
+}
+function npxCliUnderNodeDir(nodeDir) {
+    return [
+        path_1.default.join(nodeDir, 'node_modules', 'npm', 'bin', 'npx-cli.js'),
+        path_1.default.join(nodeDir, '..', 'lib', 'node_modules', 'npm', 'bin', 'npx-cli.js')
+    ];
+}
+function npxCliBesideNpm(npmPath) {
+    try {
+        return path_1.default.join(path_1.default.dirname(fs_1.default.realpathSync(npmPath)), 'npx-cli.js');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Absolute path to npm's `npx-cli.js`: the npm an Electron host ships first, then the running
+ * node's own npm, then every npm on PATH (Windows layout, unix `lib` layout, or an `npm` symlink
+ * into the npm package). Null when no npm install is reachable.
+ */
+function findNpxCliJs({ execPath = process.execPath, pathEnv = process.env.PATH ?? '', npmBin: npm = npmBin, resourcesPath = process.resourcesPath } = {}) {
+    const npmPaths = pathEnv
+        .split(path_1.default.delimiter)
+        .filter(path_1.default.isAbsolute)
+        .map((dir) => path_1.default.join(dir, npm))
+        .filter((candidate) => fs_1.default.existsSync(candidate));
+    const bundledByElectron = resourcesPath
+        ? [path_1.default.join(resourcesPath, 'app.asar.unpacked', 'node_modules', 'npm', 'bin', 'npx-cli.js')]
+        : [];
+    const candidates = [
+        ...bundledByElectron,
+        ...npxCliUnderNodeDir(path_1.default.dirname(execPath)),
+        ...npmPaths.flatMap((npmPath) => npxCliUnderNodeDir(path_1.default.dirname(npmPath))),
+        ...npmPaths.map(npxCliBesideNpm).filter((candidate) => !!candidate)
+    ];
+    return candidates.find((candidate) => fs_1.default.existsSync(candidate)) ?? null;
+}
+function findNpxBin({ pathEnv = process.env.PATH ?? '', npxBin: npx = npxBin } = {}) {
+    const candidates = pathEnv
+        .split(path_1.default.delimiter)
+        .filter(path_1.default.isAbsolute)
+        .map((dir) => path_1.default.join(dir, npx));
+    return candidates.find((candidate) => fs_1.default.existsSync(candidate)) ?? 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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBA,4BAKC;AAKD,8BAIC;AAKD,sDAEC;AAKD,kCAQC;AA8BD,oCAsBC;AAED,gCAOC;AAjHD,uCAAwB;AACxB,4CAAmB;AACnB,gDAAuB;AAUvB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAA;AAChE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAA;AAEhE;;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;AAED;;GAEG;AACH,SAAgB,qBAAqB;IACnC,OAAO,OAAO,OAAO,CAAC,QAAQ,KAAK,WAAW,IAAI,UAAU,IAAI,OAAO,CAAC,QAAQ,CAAA;AAClF,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW;IACzB,IAAI,qBAAqB,EAAE,EAAE,CAAC;QAC5B,OAAO;YACL,GAAG,OAAO,CAAC,GAAG;YACd,oBAAoB,EAAE,GAAG;SAC1B,CAAA;IACH,CAAC;IACD,OAAO,OAAO,CAAC,GAAgC,CAAA;AACjD,CAAC;AAUD,SAAS,kBAAkB,CAAC,OAAe;IACzC,OAAO;QACL,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC;QAC9D,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC;KAC5E,CAAA;AACH,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,IAAI,CAAC;QACH,OAAO,cAAI,CAAC,IAAI,CAAC,cAAI,CAAC,OAAO,CAAC,YAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,EAAE,YAAY,CAAC,CAAA;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAC,EAC3B,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAC3B,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,EAChC,MAAM,EAAE,GAAG,GAAG,MAAM,EACpB,aAAa,GAAG,OAAO,CAAC,aAAa,KACxB,EAAE;IACf,MAAM,QAAQ,GAAG,OAAO;SACrB,KAAK,CAAC,cAAI,CAAC,SAAS,CAAC;SACrB,MAAM,CAAC,cAAI,CAAC,UAAU,CAAC;SACvB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;SACjC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAA;IAElD,MAAM,iBAAiB,GAAG,aAAa;QACrC,CAAC,CAAC,CAAC,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,mBAAmB,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;QAC7F,CAAC,CAAC,EAAE,CAAA;IACN,MAAM,UAAU,GAAG;QACjB,GAAG,iBAAiB;QACpB,GAAG,kBAAkB,CAAC,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC7C,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,kBAAkB,CAAC,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3E,GAAG,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,EAAuB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;KACzF,CAAA;IACD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,IAAI,IAAI,CAAA;AACzE,CAAC;AAED,SAAgB,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,GAAG,MAAM,KAAgB,EAAE;IACnG,MAAM,UAAU,GAAG,OAAO;SACvB,KAAK,CAAC,cAAI,CAAC,SAAS,CAAC;SACrB,MAAM,CAAC,cAAI,CAAC,UAAU,CAAC;SACvB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;IAEpC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,IAAI,IAAI,CAAA;AACzE,CAAC"}

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