@algorandfoundation/algokit-utils 5.3.3-beta.2 → 5.4.0

package/debugging/debugging.js

@@ -0,0 +1,139 @@
+'use strict';
+
+var crypto = require('crypto');
+var app = require('../app.js');
+var config = require('../config.js');
+var debugging = require('../types/debugging.js');
+var util = require('../util.js');
+
+function _interopNamespaceDefault(e) {
+    var n = Object.create(null);
+    if (e) {
+        Object.keys(e).forEach(function (k) {
+            if (k !== 'default') {
+                var d = Object.getOwnPropertyDescriptor(e, k);
+                Object.defineProperty(n, k, d.get ? d : {
+                    enumerable: true,
+                    get: function () { return e[k]; }
+                });
+            }
+        });
+    }
+    n.default = e;
+    return Object.freeze(n);
+}
+
+var crypto__namespace = /*#__PURE__*/_interopNamespaceDefault(crypto);
+
+const ALGOKIT_DIR = '.algokit';
+const SOURCES_DIR = 'sources';
+const SOURCES_FILE = 'sources.avm.json';
+const TEAL_FILE_EXT = '.teal';
+const TEAL_SOURCEMAP_EXT = '.teal.tok.map';
+// === Internal methods ===
+async function loadOrCreateSources(sourcesPath) {
+    try {
+        const fs = await Promise.resolve().then(function () { return /*#__PURE__*/_interopNamespaceDefault(require('fs')); });
+        const data = JSON.parse(await fs.promises.readFile(sourcesPath, 'utf8'));
+        return debugging.AVMDebuggerSourceMap.fromDict(data);
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            return new debugging.AVMDebuggerSourceMap([]);
+        }
+        else {
+            throw error;
+        }
+    }
+}
+async function upsertDebugSourcemaps(sourceMaps, projectRoot) {
+    const path = await Promise.resolve().then(function () { return /*#__PURE__*/_interopNamespaceDefault(require('path')); });
+    const fs = await Promise.resolve().then(function () { return /*#__PURE__*/_interopNamespaceDefault(require('fs')); });
+    const sourcesPath = path.join(projectRoot, ALGOKIT_DIR, SOURCES_DIR, SOURCES_FILE);
+    const sources = await loadOrCreateSources(sourcesPath);
+    for (const sourcemap of sourceMaps) {
+        const sourceFilePath = path.resolve(sourcemap.location);
+        try {
+            await fs.promises.access(sourceFilePath);
+            const index = sources.txnGroupSources.findIndex((item) => item.equals(sourcemap));
+            if (index === -1) {
+                sources.txnGroupSources.push(sourcemap);
+            }
+            else {
+                sources.txnGroupSources[index] = sourcemap;
+            }
+        }
+        catch (error) {
+            const err = error;
+            if (err.code === 'ENOENT') {
+                const index = sources.txnGroupSources.findIndex((item) => item.equals(sourcemap));
+                if (index !== -1) {
+                    sources.txnGroupSources.splice(index, 1);
+                }
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    await fs.promises.writeFile(sourcesPath, JSON.stringify(sources.toDict()), 'utf8');
+}
+async function writeToFile(filePath, content) {
+    const path = await Promise.resolve().then(function () { return /*#__PURE__*/_interopNamespaceDefault(require('path')); });
+    const fs = await Promise.resolve().then(function () { return /*#__PURE__*/_interopNamespaceDefault(require('fs')); });
+    await fs.promises.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.promises.writeFile(filePath, content, 'utf8');
+}
+async function buildAVMSourcemap({ rawTeal, compiledTeal, appName, fileName, outputPath, client, withSources = true, }) {
+    if (!rawTeal && !compiledTeal) {
+        throw new Error('Either rawTeal or compiledTeal must be provided.');
+    }
+    const path = await Promise.resolve().then(function () { return /*#__PURE__*/_interopNamespaceDefault(require('path')); });
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    const result = rawTeal ? await app.compileTeal(rawTeal, client) : compiledTeal;
+    const programHash = crypto__namespace.createHash('SHA-512/256').update(Buffer.from(result.compiled, 'base64')).digest('base64');
+    const sourceMap = result.sourceMap;
+    sourceMap.sources = withSources ? [`${fileName}${TEAL_FILE_EXT}`] : [];
+    const outputDirPath = path.join(outputPath, ALGOKIT_DIR, SOURCES_DIR, appName);
+    const sourceMapOutputPath = path.join(outputDirPath, `${fileName}${TEAL_SOURCEMAP_EXT}`);
+    const tealOutputPath = path.join(outputDirPath, `${fileName}${TEAL_FILE_EXT}`);
+    await writeToFile(sourceMapOutputPath, JSON.stringify(sourceMap));
+    if (withSources && result) {
+        await writeToFile(tealOutputPath, result.teal);
+    }
+    return new debugging.AVMDebuggerSourceMapEntry(sourceMapOutputPath, programHash);
+}
+// === Public facing methods ===
+/**
+ * This function persists the source maps for the given sources.
+ *
+ * @param param0 The parameters to define the persistence
+ *
+ * @returns A promise that resolves when the source maps have been persisted.
+ */
+async function persistSourceMaps({ sources, projectRoot, client, withSources }) {
+    if (!util.isNode()) {
+        throw new Error('Sourcemaps can only be persisted in Node.js environment.');
+    }
+    try {
+        const sourceMaps = await Promise.all(sources.map((source) => buildAVMSourcemap({
+            rawTeal: source.rawTeal,
+            compiledTeal: source.compiledTeal,
+            appName: source.appName,
+            fileName: source.fileName,
+            outputPath: projectRoot,
+            client: client,
+            withSources: withSources,
+        })));
+        await upsertDebugSourcemaps(sourceMaps, projectRoot);
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        config.Config.getLogger().error(`Failed to persist avm sourceMaps: ${err.stack ?? err.message ?? err}.`);
+        throw err;
+    }
+}
+
+exports.persistSourceMaps = persistSourceMaps;
+//# sourceMappingURL=debugging.js.map

package/debugging/debugging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugging.js","sources":["../../src/debugging/debugging.ts"],"sourcesContent":[null],"names":["AVMDebuggerSourceMap","compileTeal","crypto","AVMDebuggerSourceMapEntry","isNode","Config"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,MAAM,WAAW,GAAG,UAAU,CAAA;AAC9B,MAAM,WAAW,GAAG,SAAS,CAAA;AAC7B,MAAM,YAAY,GAAG,kBAAkB,CAAA;AACvC,MAAM,aAAa,GAAG,OAAO,CAAA;AAC7B,MAAM,kBAAkB,GAAG,eAAe,CAAA;AAS1C;AAEA,eAAe,mBAAmB,CAAC,WAAmB,EAAA;AACpD,IAAA,IAAI;AACF,QAAA,MAAM,EAAE,GAAG,MAAM,0FAAO,IAAI,MAAC,CAAA;AAC7B,QAAA,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAA;AACxE,QAAA,OAAOA,8BAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;KAC3C;IAAC,OAAO,KAAc,EAAE;QACvB,MAAM,GAAG,GAAG,KAAuB,CAAA;AAEnC,QAAA,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE;AACzB,YAAA,OAAO,IAAIA,8BAAoB,CAAC,EAAE,CAAC,CAAA;SACpC;aAAM;AACL,YAAA,MAAM,KAAK,CAAA;SACZ;KACF;AACH,CAAC;AAED,eAAe,qBAAqB,CAAC,UAAuC,EAAE,WAAmB,EAAA;AAC/F,IAAA,MAAM,IAAI,GAAG,MAAM,0FAAO,MAAM,MAAC,CAAA;AACjC,IAAA,MAAM,EAAE,GAAG,MAAM,0FAAO,IAAI,MAAC,CAAA;AAE7B,IAAA,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC,CAAA;AAClF,IAAA,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAA;AAEtD,IAAA,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE;QAClC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;AACvD,QAAA,IAAI;YACF,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;YACxC,MAAM,KAAK,GAAG,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAA;AACjF,YAAA,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE;AAChB,gBAAA,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;aACxC;iBAAM;AACL,gBAAA,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,GAAG,SAAS,CAAA;aAC3C;SACF;QAAC,OAAO,KAAc,EAAE;YACvB,MAAM,GAAG,GAAG,KAAuB,CAAA;AAEnC,YAAA,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE;gBACzB,MAAM,KAAK,GAAG,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAA;AACjF,gBAAA,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE;oBAChB,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;iBACzC;aACF;iBAAM;AACL,gBAAA,MAAM,KAAK,CAAA;aACZ;SACF;KACF;IAED,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,CAAA;AACpF,CAAC;AAED,eAAe,WAAW,CAAC,QAAgB,EAAE,OAAe,EAAA;AAC1D,IAAA,MAAM,IAAI,GAAG,MAAM,0FAAO,MAAM,MAAC,CAAA;AACjC,IAAA,MAAM,EAAE,GAAG,MAAM,0FAAO,IAAI,MAAC,CAAA;AAE7B,IAAA,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;AACpE,IAAA,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;AACxD,CAAC;AAED,eAAe,iBAAiB,CAAC,EAC/B,OAAO,EACP,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,UAAU,EACV,MAAM,EACN,WAAW,GAAG,IAAI,GASnB,EAAA;AACC,IAAA,IAAI,CAAC,OAAO,IAAI,CAAC,YAAY,EAAE;AAC7B,QAAA,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;KACpE;AACD,IAAA,MAAM,IAAI,GAAG,MAAM,0FAAO,MAAM,MAAC,CAAA;;AAGjC,IAAA,MAAM,MAAM,GAAG,OAAO,GAAG,MAAMC,eAAW,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,YAAa,CAAA;IAC3E,MAAM,WAAW,GAAGC,iBAAM,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;AACpH,IAAA,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAA;AAClC,IAAA,SAAS,CAAC,OAAO,GAAG,WAAW,GAAG,CAAC,CAAA,EAAG,QAAQ,CAAA,EAAG,aAAa,CAAE,CAAA,CAAC,GAAG,EAAE,CAAA;AAEtE,IAAA,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAA;AAC9E,IAAA,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAA,EAAG,QAAQ,CAAA,EAAG,kBAAkB,CAAA,CAAE,CAAC,CAAA;AACxF,IAAA,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAA,EAAG,QAAQ,CAAA,EAAG,aAAa,CAAA,CAAE,CAAC,CAAA;IAC9E,MAAM,WAAW,CAAC,mBAAmB,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAA;AAEjE,IAAA,IAAI,WAAW,IAAI,MAAM,EAAE;QACzB,MAAM,WAAW,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;KAC/C;AAED,IAAA,OAAO,IAAIC,mCAAyB,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAA;AACxE,CAAC;AAED;AAEA;;;;;;AAMG;AACI,eAAe,iBAAiB,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAA2B,EAAA;AAC5G,IAAA,IAAI,CAACC,WAAM,EAAE,EAAE;AACb,QAAA,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAA;KAC5E;AAED,IAAA,IAAI;AACF,QAAA,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAClC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,KACjB,iBAAiB,CAAC;YAChB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;AACzB,YAAA,UAAU,EAAE,WAAW;AACvB,YAAA,MAAM,EAAE,MAAM;AACd,YAAA,WAAW,EAAE,WAAW;SACzB,CAAC,CACH,CACF,CAAA;AAED,QAAA,MAAM,qBAAqB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA;KACrD;IAAC,OAAO,KAAK,EAAE;QACd,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,GAAG,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;AACrE,QAAAC,aAAM,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,qCAAqC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAA,CAAA,CAAG,CAAC,CAAA;AACjG,QAAA,MAAM,GAAG,CAAA;KACV;AACH;;;;"}

package/debugging/debugging.mjs

@@ -0,0 +1,118 @@
+import * as crypto from 'crypto';
+import { compileTeal } from '../app.mjs';
+import { Config } from '../config.mjs';
+import { AVMDebuggerSourceMapEntry, AVMDebuggerSourceMap } from '../types/debugging.mjs';
+import { isNode } from '../util.mjs';
+
+const ALGOKIT_DIR = '.algokit';
+const SOURCES_DIR = 'sources';
+const SOURCES_FILE = 'sources.avm.json';
+const TEAL_FILE_EXT = '.teal';
+const TEAL_SOURCEMAP_EXT = '.teal.tok.map';
+// === Internal methods ===
+async function loadOrCreateSources(sourcesPath) {
+    try {
+        const fs = await import('fs');
+        const data = JSON.parse(await fs.promises.readFile(sourcesPath, 'utf8'));
+        return AVMDebuggerSourceMap.fromDict(data);
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            return new AVMDebuggerSourceMap([]);
+        }
+        else {
+            throw error;
+        }
+    }
+}
+async function upsertDebugSourcemaps(sourceMaps, projectRoot) {
+    const path = await import('path');
+    const fs = await import('fs');
+    const sourcesPath = path.join(projectRoot, ALGOKIT_DIR, SOURCES_DIR, SOURCES_FILE);
+    const sources = await loadOrCreateSources(sourcesPath);
+    for (const sourcemap of sourceMaps) {
+        const sourceFilePath = path.resolve(sourcemap.location);
+        try {
+            await fs.promises.access(sourceFilePath);
+            const index = sources.txnGroupSources.findIndex((item) => item.equals(sourcemap));
+            if (index === -1) {
+                sources.txnGroupSources.push(sourcemap);
+            }
+            else {
+                sources.txnGroupSources[index] = sourcemap;
+            }
+        }
+        catch (error) {
+            const err = error;
+            if (err.code === 'ENOENT') {
+                const index = sources.txnGroupSources.findIndex((item) => item.equals(sourcemap));
+                if (index !== -1) {
+                    sources.txnGroupSources.splice(index, 1);
+                }
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    await fs.promises.writeFile(sourcesPath, JSON.stringify(sources.toDict()), 'utf8');
+}
+async function writeToFile(filePath, content) {
+    const path = await import('path');
+    const fs = await import('fs');
+    await fs.promises.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.promises.writeFile(filePath, content, 'utf8');
+}
+async function buildAVMSourcemap({ rawTeal, compiledTeal, appName, fileName, outputPath, client, withSources = true, }) {
+    if (!rawTeal && !compiledTeal) {
+        throw new Error('Either rawTeal or compiledTeal must be provided.');
+    }
+    const path = await import('path');
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    const result = rawTeal ? await compileTeal(rawTeal, client) : compiledTeal;
+    const programHash = crypto.createHash('SHA-512/256').update(Buffer.from(result.compiled, 'base64')).digest('base64');
+    const sourceMap = result.sourceMap;
+    sourceMap.sources = withSources ? [`${fileName}${TEAL_FILE_EXT}`] : [];
+    const outputDirPath = path.join(outputPath, ALGOKIT_DIR, SOURCES_DIR, appName);
+    const sourceMapOutputPath = path.join(outputDirPath, `${fileName}${TEAL_SOURCEMAP_EXT}`);
+    const tealOutputPath = path.join(outputDirPath, `${fileName}${TEAL_FILE_EXT}`);
+    await writeToFile(sourceMapOutputPath, JSON.stringify(sourceMap));
+    if (withSources && result) {
+        await writeToFile(tealOutputPath, result.teal);
+    }
+    return new AVMDebuggerSourceMapEntry(sourceMapOutputPath, programHash);
+}
+// === Public facing methods ===
+/**
+ * This function persists the source maps for the given sources.
+ *
+ * @param param0 The parameters to define the persistence
+ *
+ * @returns A promise that resolves when the source maps have been persisted.
+ */
+async function persistSourceMaps({ sources, projectRoot, client, withSources }) {
+    if (!isNode()) {
+        throw new Error('Sourcemaps can only be persisted in Node.js environment.');
+    }
+    try {
+        const sourceMaps = await Promise.all(sources.map((source) => buildAVMSourcemap({
+            rawTeal: source.rawTeal,
+            compiledTeal: source.compiledTeal,
+            appName: source.appName,
+            fileName: source.fileName,
+            outputPath: projectRoot,
+            client: client,
+            withSources: withSources,
+        })));
+        await upsertDebugSourcemaps(sourceMaps, projectRoot);
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        Config.getLogger().error(`Failed to persist avm sourceMaps: ${err.stack ?? err.message ?? err}.`);
+        throw err;
+    }
+}
+
+export { persistSourceMaps };
+//# sourceMappingURL=debugging.mjs.map

package/debugging/debugging.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugging.mjs","sources":["../../src/debugging/debugging.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/debugging/index.d.ts

@@ -0,0 +1,3 @@
+export * from './debugging';
+export * from './simulate-and-persist-response';
+//# sourceMappingURL=index.d.ts.map

package/debugging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/debugging/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,iCAAiC,CAAA"}

package/{cjs/debugging.d.ts → debugging/simulate-and-persist-response.d.ts}

@@ -1,13 +1,4 @@
-import algosdk from 'algosdk';
-import { PersistSourceMapsParams, SimulateAndPersistResponseParams } from './types/debugging';
-/**
- * This function persists the source maps for the given sources.
- *
- * @param param0 The parameters to define the persistence
- *
- * @returns A promise that resolves when the source maps have been persisted.
- */
-export declare function persistSourceMaps({ sources, projectRoot, client, withSources }: PersistSourceMapsParams): Promise<void>;
+import { SimulateAndPersistResponseParams } from '../types/debugging';
 /**
  * This function simulates the atomic transactions using the provided `AtomicTransactionComposer` object and `Algodv2` object,
  * and persists the simulation response to an AlgoKit AVM Debugger compliant JSON file.
@@ -25,5 +16,5 @@ export declare function persistSourceMaps({ sources, projectRoot, client, withSo
  * const result = await simulateAndPersistResponse({ atc, projectRoot, algod, bufferSizeMb });
  * console.log(result);
  */
-export declare function simulateAndPersistResponse({ atc, projectRoot, algod, bufferSizeMb }: SimulateAndPersistResponseParams): Promise<algosdk.modelsv2.SimulateResponse>;
-//# sourceMappingURL=debugging.d.ts.map
+export declare function simulateAndPersistResponse({ atc, projectRoot, algod, bufferSizeMb }: SimulateAndPersistResponseParams): Promise<import("algosdk/dist/types/client/v2/algod/models/types").SimulateResponse>;
+//# sourceMappingURL=simulate-and-persist-response.d.ts.map

package/debugging/simulate-and-persist-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate-and-persist-response.d.ts","sourceRoot":"","sources":["../../src/debugging/simulate-and-persist-response.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gCAAgC,EAAE,MAAM,oBAAoB,CAAA;AAarE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,0BAA0B,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,gCAAgC,uFA6E3H"}

package/debugging/simulate-and-persist-response.js

@@ -0,0 +1,108 @@
+'use strict';
+
+var config = require('../config.js');
+var performAtomicTransactionComposerSimulate = require('../transaction/perform-atomic-transaction-composer-simulate.js');
+var util = require('../util.js');
+
+function _interopNamespaceDefault(e) {
+    var n = Object.create(null);
+    if (e) {
+        Object.keys(e).forEach(function (k) {
+            if (k !== 'default') {
+                var d = Object.getOwnPropertyDescriptor(e, k);
+                Object.defineProperty(n, k, d.get ? d : {
+                    enumerable: true,
+                    get: function () { return e[k]; }
+                });
+            }
+        });
+    }
+    n.default = e;
+    return Object.freeze(n);
+}
+
+const TRACES_FILE_EXT = '.trace.avm.json';
+const DEBUG_TRACES_DIR = 'debug_traces';
+/**
+ * This function simulates the atomic transactions using the provided `AtomicTransactionComposer` object and `Algodv2` object,
+ * and persists the simulation response to an AlgoKit AVM Debugger compliant JSON file.
+ *
+ * @param param0 The parameters to control the simulation and persistence.
+ *
+ * @returns The simulation result, which includes various details about how the transactions would be processed.
+ *
+ * @example
+ * const atc = new AtomicTransactionComposer();
+ * const algod = new algosdk.Algodv2(token, server, port);
+ * const projectRoot = '/path/to/project';
+ * const bufferSizeMb = 10;
+ *
+ * const result = await simulateAndPersistResponse({ atc, projectRoot, algod, bufferSizeMb });
+ * console.log(result);
+ */
+async function simulateAndPersistResponse({ atc, projectRoot, algod, bufferSizeMb }) {
+    if (!util.isNode()) {
+        throw new Error('Sourcemaps can only be persisted in Node.js environment.');
+    }
+    const fs = await Promise.resolve().then(function () { return /*#__PURE__*/_interopNamespaceDefault(require('fs')); });
+    const path = await Promise.resolve().then(function () { return /*#__PURE__*/_interopNamespaceDefault(require('path')); });
+    try {
+        const atcToSimulate = atc.clone();
+        const simulateResult = await performAtomicTransactionComposerSimulate.performAtomicTransactionComposerSimulate(atcToSimulate, algod);
+        const txnGroups = simulateResult.txnGroups;
+        const txnTypesCount = txnGroups.reduce((acc, txnGroup) => {
+            const txnType = txnGroup.txnResults[0].txnResult.txn.txn.type;
+            acc[txnType] = (acc[txnType] || 0) + 1;
+            return acc;
+        }, {});
+        const txnTypesStr = Object.entries(txnTypesCount)
+            .map(([type, count]) => `${count}#${type}`)
+            .join('_');
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '');
+        const outputRootDir = path.join(projectRoot, DEBUG_TRACES_DIR);
+        const outputFileName = `${timestamp}_lr${simulateResult.lastRound}_${txnTypesStr}${TRACES_FILE_EXT}`;
+        const outputFilePath = path.join(outputRootDir, outputFileName);
+        try {
+            await fs.promises.access(path.dirname(outputFilePath));
+        }
+        catch (error) {
+            const err = error;
+            if (err.code === 'ENOENT') {
+                await fs.promises.mkdir(path.dirname(outputFilePath), { recursive: true });
+            }
+            else {
+                throw err;
+            }
+        }
+        // cleanup old files if buffer size is exceeded
+        let totalSize = (await Promise.all((await fs.promises.readdir(outputRootDir)).map(async (file) => (await fs.promises.stat(path.join(outputRootDir, file))).size))).reduce((a, b) => a + b, 0);
+        if (totalSize > bufferSizeMb * 1024 * 1024) {
+            const sortedFiles = (await fs.promises.readdir(outputRootDir)).map(async (file) => {
+                const stats = await fs.promises.stat(path.join(outputRootDir, file));
+                return { file, mtime: stats.mtime };
+            });
+            // Since map returns an array of promises, we need to await all of them
+            const resolvedFiles = await Promise.all(sortedFiles);
+            resolvedFiles.sort((a, b) => a.mtime.getTime() - b.mtime.getTime());
+            while (totalSize > bufferSizeMb * 1024 * 1024) {
+                const oldestFilePromise = sortedFiles.shift();
+                if (oldestFilePromise) {
+                    const oldestFile = await oldestFilePromise;
+                    const stats = await fs.promises.stat(path.join(outputRootDir, oldestFile.file));
+                    totalSize -= stats.size;
+                    await fs.promises.unlink(path.join(outputRootDir, oldestFile.file));
+                }
+            }
+        }
+        await fs.promises.writeFile(outputFilePath, JSON.stringify(simulateResult.get_obj_for_encoding(), null, 2));
+        return simulateResult;
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        config.Config.getLogger().error(`Failed to simulate and persist avm traces: ${err.stack ?? err.message ?? err}.`);
+        throw err;
+    }
+}
+
+exports.simulateAndPersistResponse = simulateAndPersistResponse;
+//# sourceMappingURL=simulate-and-persist-response.js.map

package/debugging/simulate-and-persist-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate-and-persist-response.js","sources":["../../src/debugging/simulate-and-persist-response.ts"],"sourcesContent":[null],"names":["isNode","performAtomicTransactionComposerSimulate","Config"],"mappings":"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"}

package/debugging/simulate-and-persist-response.mjs

@@ -0,0 +1,89 @@
+import { Config } from '../config.mjs';
+import { performAtomicTransactionComposerSimulate } from '../transaction/perform-atomic-transaction-composer-simulate.mjs';
+import { isNode } from '../util.mjs';
+
+const TRACES_FILE_EXT = '.trace.avm.json';
+const DEBUG_TRACES_DIR = 'debug_traces';
+/**
+ * This function simulates the atomic transactions using the provided `AtomicTransactionComposer` object and `Algodv2` object,
+ * and persists the simulation response to an AlgoKit AVM Debugger compliant JSON file.
+ *
+ * @param param0 The parameters to control the simulation and persistence.
+ *
+ * @returns The simulation result, which includes various details about how the transactions would be processed.
+ *
+ * @example
+ * const atc = new AtomicTransactionComposer();
+ * const algod = new algosdk.Algodv2(token, server, port);
+ * const projectRoot = '/path/to/project';
+ * const bufferSizeMb = 10;
+ *
+ * const result = await simulateAndPersistResponse({ atc, projectRoot, algod, bufferSizeMb });
+ * console.log(result);
+ */
+async function simulateAndPersistResponse({ atc, projectRoot, algod, bufferSizeMb }) {
+    if (!isNode()) {
+        throw new Error('Sourcemaps can only be persisted in Node.js environment.');
+    }
+    const fs = await import('fs');
+    const path = await import('path');
+    try {
+        const atcToSimulate = atc.clone();
+        const simulateResult = await performAtomicTransactionComposerSimulate(atcToSimulate, algod);
+        const txnGroups = simulateResult.txnGroups;
+        const txnTypesCount = txnGroups.reduce((acc, txnGroup) => {
+            const txnType = txnGroup.txnResults[0].txnResult.txn.txn.type;
+            acc[txnType] = (acc[txnType] || 0) + 1;
+            return acc;
+        }, {});
+        const txnTypesStr = Object.entries(txnTypesCount)
+            .map(([type, count]) => `${count}#${type}`)
+            .join('_');
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '');
+        const outputRootDir = path.join(projectRoot, DEBUG_TRACES_DIR);
+        const outputFileName = `${timestamp}_lr${simulateResult.lastRound}_${txnTypesStr}${TRACES_FILE_EXT}`;
+        const outputFilePath = path.join(outputRootDir, outputFileName);
+        try {
+            await fs.promises.access(path.dirname(outputFilePath));
+        }
+        catch (error) {
+            const err = error;
+            if (err.code === 'ENOENT') {
+                await fs.promises.mkdir(path.dirname(outputFilePath), { recursive: true });
+            }
+            else {
+                throw err;
+            }
+        }
+        // cleanup old files if buffer size is exceeded
+        let totalSize = (await Promise.all((await fs.promises.readdir(outputRootDir)).map(async (file) => (await fs.promises.stat(path.join(outputRootDir, file))).size))).reduce((a, b) => a + b, 0);
+        if (totalSize > bufferSizeMb * 1024 * 1024) {
+            const sortedFiles = (await fs.promises.readdir(outputRootDir)).map(async (file) => {
+                const stats = await fs.promises.stat(path.join(outputRootDir, file));
+                return { file, mtime: stats.mtime };
+            });
+            // Since map returns an array of promises, we need to await all of them
+            const resolvedFiles = await Promise.all(sortedFiles);
+            resolvedFiles.sort((a, b) => a.mtime.getTime() - b.mtime.getTime());
+            while (totalSize > bufferSizeMb * 1024 * 1024) {
+                const oldestFilePromise = sortedFiles.shift();
+                if (oldestFilePromise) {
+                    const oldestFile = await oldestFilePromise;
+                    const stats = await fs.promises.stat(path.join(outputRootDir, oldestFile.file));
+                    totalSize -= stats.size;
+                    await fs.promises.unlink(path.join(outputRootDir, oldestFile.file));
+                }
+            }
+        }
+        await fs.promises.writeFile(outputFilePath, JSON.stringify(simulateResult.get_obj_for_encoding(), null, 2));
+        return simulateResult;
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        Config.getLogger().error(`Failed to simulate and persist avm traces: ${err.stack ?? err.message ?? err}.`);
+        throw err;
+    }
+}
+
+export { simulateAndPersistResponse };
+//# sourceMappingURL=simulate-and-persist-response.mjs.map

package/debugging/simulate-and-persist-response.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate-and-persist-response.mjs","sources":["../../src/debugging/simulate-and-persist-response.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dispenser-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispenser-client.d.ts","sourceRoot":"","sources":["../src/dispenser-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAA;AAErG;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,GAAE,+BAA+B,GAAG,IAAW,6BAEjG"}

package/{cjs/dispenser-client.js → dispenser-client.js}

@@ -1,7 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getTestNetDispenserApiClient = void 0;
-const dispenser_client_1 = require("./types/dispenser-client");
+'use strict';
+
+var dispenserClient = require('./types/dispenser-client.js');
+
 /**
  * Create a new TestNetDispenserApiClient instance.
  * Refer to [docs](https://github.com/algorandfoundation/algokit/blob/main/docs/testnet_api.md) on guidance to obtain an access token.
@@ -19,7 +19,8 @@ const dispenser_client_1 = require("./types/dispenser-client");
  * @returns An instance of the TestNetDispenserApiClient class.
  */
 function getTestNetDispenserApiClient(params = null) {
-    return new dispenser_client_1.TestNetDispenserApiClient(params);
+    return new dispenserClient.TestNetDispenserApiClient(params);
 }
+
 exports.getTestNetDispenserApiClient = getTestNetDispenserApiClient;
-//# sourceMappingURL=dispenser-client.js.map
+//# sourceMappingURL=dispenser-client.js.map

package/dispenser-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispenser-client.js","sources":["../src/dispenser-client.ts"],"sourcesContent":[null],"names":["TestNetDispenserApiClient"],"mappings":";;;;AAEA;;;;;;;;;;;;;;;AAeG;AACa,SAAA,4BAA4B,CAAC,MAAA,GAAiD,IAAI,EAAA;AAChG,IAAA,OAAO,IAAIA,yCAAyB,CAAC,MAAM,CAAC,CAAA;AAC9C;;;;"}

package/{esm/dispenser-client.js → dispenser-client.mjs}

@@ -1,4 +1,5 @@
-import { TestNetDispenserApiClient } from './types/dispenser-client.js';
+import { TestNetDispenserApiClient } from './types/dispenser-client.mjs';
+
 /**
  * Create a new TestNetDispenserApiClient instance.
  * Refer to [docs](https://github.com/algorandfoundation/algokit/blob/main/docs/testnet_api.md) on guidance to obtain an access token.
@@ -15,7 +16,9 @@ import { TestNetDispenserApiClient } from './types/dispenser-client.js';
  *
  * @returns An instance of the TestNetDispenserApiClient class.
  */
-export function getTestNetDispenserApiClient(params = null) {
+function getTestNetDispenserApiClient(params = null) {
     return new TestNetDispenserApiClient(params);
 }
-//# sourceMappingURL=dispenser-client.js.map
+
+export { getTestNetDispenserApiClient };
+//# sourceMappingURL=dispenser-client.mjs.map

package/dispenser-client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispenser-client.mjs","sources":["../src/dispenser-client.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;;;;;;;;;;;;AAeG;AACa,SAAA,4BAA4B,CAAC,MAAA,GAAiD,IAAI,EAAA;AAChG,IAAA,OAAO,IAAI,yBAAyB,CAAC,MAAM,CAAC,CAAA;AAC9C;;;;"}

package/{cjs/index.d.ts → index.d.ts}

@@ -1,10 +1,10 @@
-import { UpdatableConfig } from './types/config';
 export * from './account';
 export * from './amount';
 export * from './app';
 export * from './app-client';
 export * from './app-deploy';
 export * from './asset';
+export * from './config';
 export * from './debugging';
 export * from './dispenser-client';
 export * from './indexer-lookup';
@@ -12,6 +12,4 @@ export * from './localnet';
 export * from './network-client';
 export * from './transaction';
 export * from './transfer';
-/** The AlgoKit config. To update it use the configure method. */
-export declare const Config: UpdatableConfig;
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,OAAO,CAAA;AACrB,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA"}