@ton/sandbox 0.35.0 → 0.35.1

package/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.35.1] - 2025-07-08
+
+### Fixed
+
+- Fixed sandbox not running in browser environment
+
 ## [0.35.0] - 2025-07-07
 
 ### Changed 

package/dist/blockchain/SmartContract.d.ts

@@ -3,7 +3,6 @@ import { Address, Cell, Message, OutAction, ShardAccount, Transaction, TupleItem
 import { Blockchain } from './Blockchain';
 import { ExtraCurrency } from '../utils/ec';
 import { EmulationResult, RunCommonArgs, TickOrTock } from '../executor/Executor';
-import { DebugInfo } from '../debugger/Debuggee';
 export declare function createShardAccount(args: {
     address?: Address;
     code: Cell;
@@ -98,10 +97,6 @@ export declare class SmartContract {
     }): SmartContract;
     static empty(blockchain: Blockchain, address: Address): SmartContract;
     protected createCommonArgs(params?: MessageParams): RunCommonArgs;
-    protected getDebugInfo(): {
-        uninitialized: boolean;
-        debugInfo: DebugInfo | undefined;
-    };
     receiveMessage(message: Message, params?: MessageParams): Promise<SmartContractTransaction>;
     runTickTock(which: TickOrTock, params?: MessageParams): Promise<SmartContractTransaction>;
     protected runCommon(run: () => Promise<EmulationResult>): Promise<SmartContractTransaction>;

package/dist/blockchain/SmartContract.js

@@ -17,8 +17,7 @@ const core_1 = require("@ton/core");
 const ec_1 = require("../utils/ec");
 const selector_1 = require("../utils/selector");
 const deepcopy_1 = require("../utils/deepcopy");
-const DebugInfoCache_1 = require("../debugger/DebugInfoCache");
-const debug_1 = require("../debugger/debug");
+const debugger_1 = require("../debugger");
 function createShardAccount(args) {
     let wc = args.workchain ?? 0;
     let address = args.address ?? (0, core_1.contractAddress)(wc, { code: args.code, data: args.data });
@@ -223,31 +222,17 @@ class SmartContract {
             prevBlocksInfo: this.blockchain.prevBlocks,
         };
     }
-    getDebugInfo() {
-        const acc = this.account;
-        if (acc.account === undefined || acc.account === null) {
-            return { uninitialized: true, debugInfo: undefined };
-        }
-        if (acc.account.storage.state.type !== 'active') {
-            return { uninitialized: true, debugInfo: undefined };
-        }
-        const code = acc.account.storage.state.state.code;
-        if (code === undefined || code === null) {
-            return { uninitialized: true, debugInfo: undefined };
-        }
-        const debugInfo = DebugInfoCache_1.defaultDebugInfoCache.get(code.hash().toString('base64'));
-        return { uninitialized: false, debugInfo };
-    }
     async receiveMessage(message, params) {
         const args = {
             ...this.createCommonArgs(params),
             message: (0, core_1.beginCell)().store((0, core_1.storeMessage)(message)).endCell(),
         };
         if (this.debug) {
-            const { uninitialized, debugInfo } = this.getDebugInfo();
+            const debugContext = (0, debugger_1.getDebugContext)();
+            const { uninitialized, debugInfo } = debugContext.getDebugInfo(this.account);
             if (debugInfo !== undefined) {
                 const executor = await this.blockchain.getDebuggerExecutor();
-                return await this.runCommon(() => (0, debug_1.debugTransaction)(executor, args, debugInfo));
+                return await this.runCommon(() => debugContext.debugTransaction(executor, args, debugInfo));
             }
             else if (uninitialized) {
                 // eslint-disable-next-line no-console
@@ -330,10 +315,11 @@ class SmartContract {
         };
         let res;
         if (this.debug) {
-            const { uninitialized, debugInfo } = this.getDebugInfo();
+            const debugContext = (0, debugger_1.getDebugContext)();
+            const { uninitialized, debugInfo } = debugContext.getDebugInfo(this.account);
             if (debugInfo !== undefined) {
                 const executor = await this.blockchain.getDebuggerExecutor();
-                res = await (0, debug_1.debugGetMethod)(executor, args, debugInfo);
+                res = await debugContext.debugGetMethod(executor, args, debugInfo);
             }
             else {
                 if (uninitialized) {

package/dist/debugger/DebugContext.d.ts

@@ -0,0 +1,14 @@
+import type { ShardAccount } from '@ton/core';
+import type { EmulationResult, Executor, GetMethodArgs, GetMethodResult, RunTransactionArgs } from '../executor/Executor';
+import type { DebugInfo } from './Debuggee';
+declare class DebugContext {
+    constructor();
+    getDebugInfo: (account: ShardAccount) => {
+        uninitialized: boolean;
+        debugInfo: DebugInfo | undefined;
+    };
+    debugGetMethod: (executor: Executor, args: GetMethodArgs, debugInfo: DebugInfo) => Promise<GetMethodResult>;
+    debugTransaction: (executor: Executor, args: RunTransactionArgs, debugInfo: DebugInfo) => Promise<EmulationResult>;
+}
+export declare function getDebugContext(): DebugContext;
+export {};

package/dist/debugger/DebugContext.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDebugContext = void 0;
+const environment_1 = require("../utils/environment");
+// only this class is allowed to use outside the 'debugger' directory for browser support
+class DebugContext {
+    constructor() {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { debugGetMethod, debugTransaction } = require('./debug');
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { getDebugInfo } = require('./DebugInfoCache');
+        this.debugGetMethod = debugGetMethod;
+        this.debugTransaction = debugTransaction;
+        this.getDebugInfo = getDebugInfo;
+    }
+}
+let debugContext = undefined;
+function getDebugContext() {
+    if ((0, environment_1.isBrowser)()) {
+        throw new Error('Debug feature is not supported in browser environment');
+    }
+    if (!debugContext) {
+        debugContext = new DebugContext();
+    }
+    return debugContext;
+}
+exports.getDebugContext = getDebugContext;

package/dist/debugger/DebugInfoCache.d.ts

@@ -1,6 +1,9 @@
-import { Cell } from '@ton/core';
+import { Cell, type ShardAccount } from '@ton/core';
 import { DebugInfo as FuncDebugInfo } from '@ton-community/func-js';
-import { DebugInfo } from './Debuggee';
+import type { DebugInfo } from './Debuggee';
 export type DebugInfoCache = Map<string, DebugInfo>;
-export declare const defaultDebugInfoCache: DebugInfoCache;
+export declare function getDebugInfo(acc: ShardAccount): {
+    uninitialized: boolean;
+    debugInfo: DebugInfo | undefined;
+};
 export declare function registerCompiledContract(code: Cell, debugInfo: FuncDebugInfo, marks: Cell): Cell;

package/dist/debugger/DebugInfoCache.js

@@ -1,17 +1,36 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerCompiledContract = exports.defaultDebugInfoCache = void 0;
-const node_path_1 = require("node:path");
+exports.registerCompiledContract = exports.getDebugInfo = void 0;
 const marks_1 = require("./marks");
-exports.defaultDebugInfoCache = new Map();
+const environment_1 = require("../utils/environment");
+const defaultDebugInfoCache = new Map();
+function getDebugInfo(acc) {
+    if (acc.account === undefined || acc.account === null) {
+        return { uninitialized: true, debugInfo: undefined };
+    }
+    if (acc.account.storage.state.type !== 'active') {
+        return { uninitialized: true, debugInfo: undefined };
+    }
+    const code = acc.account.storage.state.state.code;
+    if (code === undefined || code === null) {
+        return { uninitialized: true, debugInfo: undefined };
+    }
+    const debugInfo = defaultDebugInfoCache.get(code.hash().toString('base64'));
+    return { uninitialized: false, debugInfo };
+}
+exports.getDebugInfo = getDebugInfo;
 function registerCompiledContract(code, debugInfo, marks) {
+    if ((0, environment_1.isBrowser)()) {
+        throw new Error('Debug feature is not supported in browser environment');
+    }
     const parsedMarks = (0, marks_1.parseMarks)(marks, code);
     const { locations, globals } = debugInfo;
     const sm = {};
     for (let i = 0; i < locations.length; i++) {
         const di = locations[i];
         const common = {
-            path: (0, node_path_1.resolve)(di.file),
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            path: require('node:path').resolve(di.file),
             line: di.line,
             function: di.func,
             contextId: di.ctx_id,
@@ -59,7 +78,7 @@ function registerCompiledContract(code, debugInfo, marks) {
             };
         }
     }
-    exports.defaultDebugInfoCache.set(code.hash().toString('base64'), {
+    defaultDebugInfoCache.set(code.hash().toString('base64'), {
         sourceMap: sm,
         globals,
         marks: parsedMarks,

package/dist/debugger/index.d.ts

@@ -0,0 +1 @@
+export { getDebugContext } from './DebugContext';

package/dist/debugger/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDebugContext = void 0;
+var DebugContext_1 = require("./DebugContext");
+Object.defineProperty(exports, "getDebugContext", { enumerable: true, get: function () { return DebugContext_1.getDebugContext; } });

package/dist/jest/BenchmarkReporter.js

@@ -32,6 +32,7 @@ const BenchmarkCommand_1 = require("./BenchmarkCommand");
 const BenchmarkEnvironment_1 = require("./BenchmarkEnvironment");
 const readJsonl_1 = require("../utils/readJsonl");
 const metric_1 = require("../metric");
+const readSnapshots_1 = require("../metric/readSnapshots");
 exports.defaultSnapshotDir = '.snapshot';
 exports.defaultReportName = 'gas-report';
 exports.defaultContractDatabaseName = 'contract.abi.json';
@@ -77,7 +78,7 @@ class BenchmarkReporter extends reporters_1.BaseReporter {
         return this.options.depthCompare || exports.defaultDepthCompare;
     }
     get snapshotFiles() {
-        return (0, metric_1.readSnapshots)(this.snapshotDirPath);
+        return (0, readSnapshots_1.readSnapshots)(this.snapshotDirPath);
     }
     get snapshots() {
         return this.snapshotFiles.then((list) => Object.values(list).map((item) => item.content));

package/dist/metric/index.d.ts

@@ -3,4 +3,3 @@ export * from './ContractDatabase';
 export * from './defaultColor';
 export * from './deltaResult';
 export * from './gasReportTable';
-export * from './readSnapshots';

package/dist/metric/index.js

@@ -19,4 +19,3 @@ __exportStar(require("./ContractDatabase"), exports);
 __exportStar(require("./defaultColor"), exports);
 __exportStar(require("./deltaResult"), exports);
 __exportStar(require("./gasReportTable"), exports);
-__exportStar(require("./readSnapshots"), exports);

package/dist/utils/environment.d.ts

@@ -0,0 +1 @@
+export declare function isBrowser(): boolean;

package/dist/utils/environment.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBrowser = void 0;
+function isBrowser() {
+    // eslint-disable-next-line no-undef
+    return typeof window !== 'undefined' && typeof window.document !== 'undefined';
+}
+exports.isBrowser = isBrowser;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ton/sandbox",
-  "version": "0.35.0",
+  "version": "0.35.1",
   "description": "TON transaction emulator",
   "main": "dist/index.js",
   "license": "MIT",