@algorandfoundation/algokit-utils 10.0.0-alpha.31 → 10.0.0-alpha.32

package/types/testing.d.ts

@@ -1,156 +1,18 @@
-import { Address } from "../packages/common/src/address.js";
-import { Transaction } from "../packages/transact/src/transactions/transaction.js";
-import { MultisigAccount } from "../packages/transact/src/multisig.js";
-import { LogicSigAccount } from "../packages/transact/src/logicsig.js";
-import { AddressWithSigners, AddressWithTransactionSigner } from "../packages/transact/src/signer.js";
-import { AlgodClient } from "../packages/algod_client/src/client.js";
-import { AlgoAmount } from "./amount.js";
-import { TransactionResponse } from "../packages/indexer_client/src/models/transaction-response.js";
-import { IndexerClient } from "../packages/indexer_client/src/client.js";
-import { KmdClient } from "../packages/kmd_client/src/client.js";
-import { AlgoConfig } from "./network-client.js";
-import { AlgorandClient } from "./algorand-client.js";
-import { TestLogger } from "../testing/test-logger.js";
-import { TransactionLogger } from "../testing/transaction-logger.js";
+import { AlgoKitLogCaptureFixture as AlgoKitLogCaptureFixture$1, AlgorandFixture as AlgorandFixture$1, AlgorandFixtureConfig as AlgorandFixtureConfig$1, AlgorandTestAutomationContext as AlgorandTestAutomationContext$1, GetTestAccountParams as GetTestAccountParams$1, LogSnapshotConfig as LogSnapshotConfig$1 } from "../testing/types.js";
 
 //#region src/types/testing.d.ts
-/**
- * Test automation context.
- */
-interface AlgorandTestAutomationContext {
-  /** An AlgorandClient instance loaded with the current context, including testAccount and any generated accounts loaded as signers */
-  algorand: AlgorandClient;
-  /** Algod client instance that will log transactions in `transactionLogger` */
-  algod: AlgodClient;
-  /** Indexer client instance */
-  indexer: IndexerClient;
-  /** KMD client instance */
-  kmd: KmdClient;
-  /** Transaction logger that will log transaction IDs for all transactions issued by `algod` */
-  transactionLogger: TransactionLogger;
-  /** Default, funded test account that is ephemerally created */
-  testAccount: Address & AddressWithSigners;
-  /** Generate and fund an additional ephemerally created account */
-  generateAccount: (params: GetTestAccountParams) => Promise<Address & AddressWithSigners>;
-  /** Wait for the indexer to catch up with all transactions logged by `transactionLogger` */
-  waitForIndexer: () => Promise<void>;
-  /** Wait for the indexer to catch up with the given transaction ID */
-  waitForIndexerTransaction: (transactionId: string) => Promise<TransactionResponse>;
-}
-/**
- * Parameters for the `getTestAccount` function.
- */
-interface GetTestAccountParams {
-  /** Initial funds to ensure the account has */
-  initialFunds: AlgoAmount;
-  /** Whether to suppress the log (which includes a mnemonic) or not (default: do not suppress the log) */
-  suppressLog?: boolean;
-  /** Optional override for how to get a test account; this allows you to retrieve accounts from a known or cached list of accounts. */
-  accountGetter?: (algorand: AlgorandClient) => Promise<Address & AddressWithSigners>;
-}
-/** Configuration for creating an Algorand testing fixture. */
-interface AlgorandFixtureConfig extends Partial<AlgoConfig> {
-  /** An optional algod client, if not specified then it will create one against `algodConfig` (if present) then environment variables defined network (if present) or default LocalNet. */
-  algod?: AlgodClient;
-  /** An optional indexer client, if not specified then it will create one against `indexerConfig` (if present) then environment variables defined network (if present) or default LocalNet. */
-  indexer?: IndexerClient;
-  /** An optional kmd client, if not specified then it will create one against `kmdConfig` (if present) then environment variables defined network (if present) or default LocalNet. */
-  kmd?: KmdClient;
-  /** The amount of funds to allocate to the default testing account, if not specified then it will get 10 ALGO. */
-  testAccountFunding?: AlgoAmount;
-  /** Optional override for how to get an account; this allows you to retrieve accounts from a known or cached list of accounts. */
-  accountGetter?: (algorand: AlgorandClient) => Promise<Address & AddressWithSigners>;
-}
-/** An Algorand automated testing fixture */
-interface AlgorandFixture {
-  /**
-   * Retrieve the current context.
-   * Useful with destructuring.
-   *
-   * If you haven't called `newScope` then this will throw an error.
-   * @example
-   * ```typescript
-   * test('My test', () => {
-   *     const {algod, indexer, testAccount, ...} = fixture.context
-   * })
-   * ```
-   */
-  get context(): AlgorandTestAutomationContext;
-  /**
-   * Retrieve an `AlgorandClient` loaded with the current context, including testAccount and any generated accounts loaded as signers.
-   */
-  get algorand(): AlgorandClient;
-  /**
-   * @deprecated Use newScope instead.
-   * Testing framework agnostic handler method to run before each test to prepare the `context` for that test with per test isolation.
-   */
-  beforeEach: () => Promise<void>;
-  /**
-   * Creates a new isolated fixture scope (clean transaction logger, AlgorandClient, testAccount, etc.).
-   *
-   * You can call this from any testing framework specific hook method to control when you want a new scope.
-   *
-   * @example Jest / vitest - per test isolation (beforeEach)
-   * ```typescript
-   * describe('MY MODULE', () => {
-   *   const fixture = algorandFixture()
-   *   beforeEach(fixture.newScope)
-   *
-   *   test('MY TEST', async () => {
-   *     const { algorand, testAccount } = fixture.context
-   *
-   *     // Test stuff!
-   *   })
-   * })
-   * ```
-   *
-   * @example Jest / vitest - test suite isolation (beforeAll)
-   * ```typescript
-   * describe('MY MODULE', () => {
-   *   const fixture = algorandFixture()
-   *   beforeAll(fixture.newScope)
-   *
-   *   test('test1', async () => {
-   *     const { algorand, testAccount } = fixture.context
-   *
-   *     // Test stuff!
-   *   })
-   *   test('test2', async () => {
-   *     const { algorand, testAccount } = fixture.context
-   *     // algorand and testAccount are the same as in test1
-   *   })
-   * })
-   * ```
-   *
-   */
-  newScope: () => Promise<void>;
-}
-/** Configuration for preparing a captured log snapshot.
- * This helps ensure that the provided configuration items won't appear
- *  with random values in the log snapshot, but rather will get substituted with predictable ids.
- */
-interface LogSnapshotConfig {
-  /** Any transaction IDs or transactions to replace the ID for predictably */
-  transactions?: (string | Transaction)[];
-  /** Any accounts/addresses to replace the address for predictably */
-  accounts?: (string | Address | LogicSigAccount | MultisigAccount | AddressWithTransactionSigner)[];
-  /** Any app IDs to replace predictably */
-  apps?: (string | number | bigint)[];
-  /** Optional filter predicate to filter out logs */
-  filterPredicate?: (log: string) => boolean;
-}
-interface AlgoKitLogCaptureFixture {
-  /** The test logger instance for the current test */
-  get testLogger(): TestLogger;
-  /**
-   * Testing framework agnostic handler method to run before each test to prepare the `testLogger` for that test.
-   */
-  beforeEach: () => void;
-  /**
-   * Testing framework agnostic handler method to run after each test to reset the logger.
-   */
-  afterEach: () => void;
-}
+/** @deprecated Import from `@algorandfoundation/algokit-utils/testing` instead */
+type AlgorandTestAutomationContext = AlgorandTestAutomationContext$1;
+/** @deprecated Import from `@algorandfoundation/algokit-utils/testing` instead */
+type GetTestAccountParams = GetTestAccountParams$1;
+/** @deprecated Import from `@algorandfoundation/algokit-utils/testing` instead */
+type AlgorandFixtureConfig = AlgorandFixtureConfig$1;
+/** @deprecated Import from `@algorandfoundation/algokit-utils/testing` instead */
+type AlgorandFixture = AlgorandFixture$1;
+/** @deprecated Import from `@algorandfoundation/algokit-utils/testing` instead */
+type LogSnapshotConfig = LogSnapshotConfig$1;
+/** @deprecated Import from `@algorandfoundation/algokit-utils/testing` instead */
+type AlgoKitLogCaptureFixture = AlgoKitLogCaptureFixture$1;
 //#endregion
 export { AlgoKitLogCaptureFixture, AlgorandFixture, AlgorandFixtureConfig, AlgorandTestAutomationContext, GetTestAccountParams, LogSnapshotConfig };
 //# sourceMappingURL=testing.d.ts.map

package/types/transaction.d.ts

@@ -1,133 +1,38 @@
-import { Expand } from "../packages/common/src/expand.js";
-import { ABIReturn } from "../packages/abi/src/abi-method.js";
-import { Transaction } from "../packages/transact/src/transactions/transaction.js";
-import { AddressWithTransactionSigner, SendingAddress, TransactionSigner } from "../packages/transact/src/signer.js";
-import { PendingTransactionResponse } from "../packages/algod_client/src/models/pending-transaction-response.js";
-import { AlgoAmount } from "./amount.js";
-import { TransactionComposer } from "./composer.js";
+import { AdditionalTransactionComposerContext as AdditionalTransactionComposerContext$1, Arc2TransactionNote as Arc2TransactionNote$1, ConfirmedTransactionResult as ConfirmedTransactionResult$1, ConfirmedTransactionResults as ConfirmedTransactionResults$1, SendParams as SendParams$1, SendSingleTransactionResult as SendSingleTransactionResult$1, SendTransactionComposerResults as SendTransactionComposerResults$1, SendTransactionFrom as SendTransactionFrom$1, SendTransactionParams as SendTransactionParams$1, SendTransactionResult as SendTransactionResult$1, SendTransactionResults as SendTransactionResults$1, TransactionComposerToSend as TransactionComposerToSend$1, TransactionGroupToSend as TransactionGroupToSend$1, TransactionNote as TransactionNote$1, TransactionNoteData as TransactionNoteData$1, TransactionToSign as TransactionToSign$1 } from "../transaction/types.js";
 
 //#region src/types/transaction.d.ts
-type TransactionNote = Uint8Array | TransactionNoteData | Arc2TransactionNote;
-type TransactionNoteData = string | null | undefined | number | any[] | Record<string, any>;
-/** ARC-0002 compatible transaction note components https://github.com/algorandfoundation/ARCs/blob/main/ARCs/arc-0002.md */
-type Arc2TransactionNote = {
-  dAppName: string;
-  format: 'm' | 'b' | 'u';
-  data: string;
-} | {
-  dAppName: string;
-  format: 'j';
-  data: TransactionNoteData;
-};
-/** The sending configuration for a transaction */
-interface SendTransactionParams {
-  /** Whether to skip signing and sending the transaction to the chain (default: transaction signed and sent to chain, unless `atc` specified)
-   * and instead just return the raw transaction, e.g. so you can add it to a group of transactions */
-  skipSending?: boolean;
-  /** Whether to skip waiting for the submitted transaction (only relevant if `skipSending` is `false` or unset) */
-  skipWaiting?: boolean;
-  /** An optional `TransactionComposer` to add the transaction to, if specified then `skipSending: undefined` has the same effect as `skipSending: true` */
-  transactionComposer?: TransactionComposer;
-  /** Whether to suppress log messages from transaction send, default: do not suppress */
-  suppressLog?: boolean;
-  /** The flat fee you want to pay, useful for covering extra fees in a transaction group or app call */
-  fee?: AlgoAmount;
-  /** The maximum fee that you are happy to pay (default: unbounded) - if this is set it's possible the transaction could get rejected during network congestion */
-  maxFee?: AlgoAmount;
-  /** The maximum number of rounds to wait for confirmation, only applies if `skipWaiting` is `undefined` or `false`, default: wait up to 5 rounds */
-  maxRoundsToWaitForConfirmation?: number;
-  /** Whether to use simulate to automatically populate app call resources in the txn objects. Defaults to true when there are app calls in the group.  */
-  populateAppCallResources?: boolean;
-}
-/** Result from sending a single transaction. */
-type SendSingleTransactionResult = Expand<SendTransactionComposerResults & ConfirmedTransactionResult>;
-/** The result of sending a transaction */
-interface SendTransactionResult {
-  /** The transaction */
-  transaction: Transaction;
-  /** The response if the transaction was sent and waited for */
-  confirmation?: PendingTransactionResponse;
-}
-/** The result of preparing and/or sending multiple transactions */
-interface SendTransactionResults {
-  /** The transactions that have been prepared and/or sent */
-  transactions: Transaction[];
-  /** The responses if the transactions were sent and waited for,
-   * the index of the confirmation will match the index of the underlying transaction
-   */
-  confirmations?: PendingTransactionResponse[];
-}
-/** The result of preparing and/or sending multiple transactions using an `TransactionComposer` */
-interface SendTransactionComposerResults extends Omit<SendTransactionResults, 'confirmations'> {
-  /** base64 encoded representation of the group ID of the group */
-  groupId: string | undefined;
-  /** The transaction IDs that have been prepared and/or sent */
-  txIds: string[];
-  /** If ABI method(s) were called the processed return values */
-  returns?: ABIReturn[];
-  /** The responses if the transactions were sent and waited for,
-   * the index of the confirmation will match the index of the underlying transaction
-   */
-  confirmations: PendingTransactionResponse[];
-}
-/** The result of sending and confirming a transaction */
-interface ConfirmedTransactionResult extends SendTransactionResult {
-  /** The response from sending and waiting for the transaction */
-  confirmation: PendingTransactionResponse;
-}
-/** The result of sending and confirming one or more transactions, but where there is a primary transaction of interest */
-interface ConfirmedTransactionResults extends SendTransactionResult, SendTransactionResults {
-  /** The response from sending and waiting for the primary transaction */
-  confirmation: PendingTransactionResponse;
-  /** The response from sending and waiting for the transactions */
-  confirmations: PendingTransactionResponse[];
-}
-/**
- * @deprcated Use `SendingAddress` instead
- */
-type SendTransactionFrom = AddressWithTransactionSigner;
-/** Defines an unsigned transaction that will appear in a group of transactions along with its signing information */
-interface TransactionToSign {
-  /** The unsigned transaction to sign and send */
-  transaction: Transaction;
-  /** The account to use to sign the transaction, either an account (with private key loaded) or a logic signature account */
-  signer: AddressWithTransactionSigner | TransactionSigner;
-}
-/** A group of transactions to send together as an group
- * https://dev.algorand.co/concepts/transactions/atomic-txn-groups/
- */
-interface TransactionGroupToSend {
-  /** Any parameters to control the semantics of the send to the network */
-  sendParams?: Omit<SendTransactionParams, 'fee' | 'maxFee' | 'skipSending' | 'atc'>;
-  /** The list of transactions to send, which can either be a raw transaction (in which case `signer` is required),
-   *   the async result of an AlgoKit utils method that returns a `SendTransactionResult` (saves unwrapping the promise, be sure to pass `skipSending: true`, `signer` is also required)
-   *   or the transaction with its signer (`signer` is ignored)
-   **/
-  transactions: (TransactionToSign | Transaction | Promise<SendTransactionResult>)[];
-  /** Optional signer to pass in, required if at least one transaction provided is just the transaction, ignored otherwise */
-  signer?: SendingAddress;
-}
-/** Parameters to configure transaction sending. */
-interface SendParams {
-  /** The number of rounds to wait for confirmation. By default until the latest lastValid has past. */
-  maxRoundsToWaitForConfirmation?: number;
-  /** Whether to suppress log messages from transaction send, default: do not suppress. */
-  suppressLog?: boolean;
-  /** Whether to use simulate to automatically populate app call resources in the txn objects. Defaults to `Config.populateAppCallResources`. */
-  populateAppCallResources?: boolean;
-  /** Whether to use simulate to automatically calculate required app call inner transaction fees and cover them in the parent app call transaction fee */
-  coverAppCallInnerTransactionFees?: boolean;
-}
-/** Additional context about the `TransactionComposer`. */
-interface AdditionalTransactionComposerContext {
-  /** A map of transaction index in the `TransactionComposer` to the max fee that can be calculated for a transaction in the group */
-  maxFees: Map<number, AlgoAmount>;
-}
-/** An `TransactionComposer` with transactions to send. */
-interface TransactionComposerToSend extends SendParams {
-  /** The `TransactionComposer` with transactions loaded to send */
-  transactionComposer: TransactionComposer;
-}
+/** @deprecated Import from `@algorandfoundation/algokit-utils/transaction` instead */
+type TransactionNote = TransactionNote$1;
+/** @deprecated Import from `@algorandfoundation/algokit-utils/transaction` instead */
+type TransactionNoteData = TransactionNoteData$1;
+/** @deprecated Import from `@algorandfoundation/algokit-utils/transaction` instead */
+type Arc2TransactionNote = Arc2TransactionNote$1;
+/** @deprecated Import from `@algorandfoundation/algokit-utils/transaction` instead */
+type SendTransactionParams = SendTransactionParams$1;
+/** @deprecated Import from `@algorandfoundation/algokit-utils/transaction` instead */
+type SendSingleTransactionResult = SendSingleTransactionResult$1;
+/** @deprecated Import from `@algorandfoundation/algokit-utils/transaction` instead */
+type SendTransactionResult = SendTransactionResult$1;
+/** @deprecated Import from `@algorandfoundation/algokit-utils/transaction` instead */
+type SendTransactionResults = SendTransactionResults$1;
+/** @deprecated Import from `@algorandfoundation/algokit-utils/transaction` instead */
+type SendTransactionComposerResults = SendTransactionComposerResults$1;
+/** @deprecated Import from `@algorandfoundation/algokit-utils/transaction` instead */
+type ConfirmedTransactionResult = ConfirmedTransactionResult$1;
+/** @deprecated Import from `@algorandfoundation/algokit-utils/transaction` instead */
+type ConfirmedTransactionResults = ConfirmedTransactionResults$1;
+/** @deprecated Import from `@algorandfoundation/algokit-utils/transaction` instead */
+type SendTransactionFrom = SendTransactionFrom$1;
+/** @deprecated Import from `@algorandfoundation/algokit-utils/transaction` instead */
+type TransactionToSign = TransactionToSign$1;
+/** @deprecated Import from `@algorandfoundation/algokit-utils/transaction` instead */
+type TransactionGroupToSend = TransactionGroupToSend$1;
+/** @deprecated Import from `@algorandfoundation/algokit-utils/transaction` instead */
+type SendParams = SendParams$1;
+/** @deprecated Import from `@algorandfoundation/algokit-utils/transaction` instead */
+type AdditionalTransactionComposerContext = AdditionalTransactionComposerContext$1;
+/** @deprecated Import from `@algorandfoundation/algokit-utils/transaction` instead */
+type TransactionComposerToSend = TransactionComposerToSend$1;
 //#endregion
 export { AdditionalTransactionComposerContext, Arc2TransactionNote, ConfirmedTransactionResult, ConfirmedTransactionResults, SendParams, SendSingleTransactionResult, SendTransactionComposerResults, SendTransactionFrom, SendTransactionParams, SendTransactionResult, SendTransactionResults, TransactionComposerToSend, TransactionGroupToSend, TransactionNote, TransactionNoteData, TransactionToSign };
 //# sourceMappingURL=transaction.d.ts.map

package/updatable-config.d.ts

@@ -0,0 +1,57 @@
+import { Logger } from "./packages/common/src/logger.js";
+import { AsyncEventEmitter } from "./async-event-emitter.js";
+
+//#region src/updatable-config.d.ts
+/** The AlgoKit configuration type */
+interface Config {
+  /** Logger */
+  logger: Logger;
+  /** Whether or not debug mode is enabled */
+  debug: boolean;
+  /** The path to the project root directory */
+  projectRoot: string | null;
+  /** Indicates whether to trace all operations */
+  traceAll: boolean;
+  /** The size of the trace buffer in megabytes */
+  traceBufferSizeMb: number;
+  /** The maximum depth to search for a specific file */
+  maxSearchDepth: number;
+  /**
+   * Whether to enable populateAppCallResources in sendParams by default.
+   * Default value is false.
+   */
+  populateAppCallResources: boolean;
+  events: AsyncEventEmitter;
+}
+/** Updatable AlgoKit config */
+declare class UpdatableConfig implements Readonly<Config> {
+  private config;
+  get populateAppCallResources(): boolean;
+  get logger(): Logger;
+  get debug(): boolean;
+  get projectRoot(): string | null;
+  get traceAll(): boolean;
+  get traceBufferSizeMb(): number;
+  get maxSearchDepth(): number;
+  get events(): AsyncEventEmitter;
+  /**
+   * Returns the current logger, or the null logger if true is passed in to `returnNullLogger`
+   * @param returnNullLogger Whether or not to return the null logger
+   * @returns The requested logger
+   */
+  getLogger(returnNullLogger?: boolean): Logger;
+  /**
+   * Temporarily run with debug set to true.
+   * @param lambda A lambda expression with code to run with debug config set to true
+   */
+  withDebug(lambda: () => unknown): void;
+  constructor();
+  /**
+   * Update the AlgoKit configuration with your own configuration settings
+   * @param newConfig Partial or complete config to replace
+   */
+  configure(newConfig: Partial<Config>): void;
+}
+//#endregion
+export { Config, UpdatableConfig };
+//# sourceMappingURL=updatable-config.d.ts.map

package/updatable-config.js

@@ -0,0 +1,80 @@
+const require_async_event_emitter = require('./async-event-emitter.js');
+const require_logging = require('./logging.js');
+
+//#region src/updatable-config.ts
+/** Updatable AlgoKit config */
+var UpdatableConfig = class {
+	config;
+	get populateAppCallResources() {
+		return this.config.populateAppCallResources;
+	}
+	get logger() {
+		return this.config.logger;
+	}
+	get debug() {
+		return this.config.debug;
+	}
+	get projectRoot() {
+		return this.config.projectRoot;
+	}
+	get traceAll() {
+		return this.config.traceAll;
+	}
+	get traceBufferSizeMb() {
+		return this.config.traceBufferSizeMb;
+	}
+	get maxSearchDepth() {
+		return this.config.maxSearchDepth;
+	}
+	get events() {
+		return this.config.events;
+	}
+	/**
+	* Returns the current logger, or the null logger if true is passed in to `returnNullLogger`
+	* @param returnNullLogger Whether or not to return the null logger
+	* @returns The requested logger
+	*/
+	getLogger(returnNullLogger) {
+		if (returnNullLogger) return require_logging.nullLogger;
+		return this.logger;
+	}
+	/**
+	* Temporarily run with debug set to true.
+	* @param lambda A lambda expression with code to run with debug config set to true
+	*/
+	withDebug(lambda) {
+		const original = this.config.debug;
+		try {
+			this.config.debug = true;
+			lambda();
+		} finally {
+			this.config.debug = original;
+		}
+	}
+	constructor() {
+		this.config = {
+			logger: require_logging.consoleLogger,
+			debug: false,
+			projectRoot: null,
+			traceAll: false,
+			traceBufferSizeMb: 256,
+			maxSearchDepth: 10,
+			populateAppCallResources: true,
+			events: new require_async_event_emitter.AsyncEventEmitter()
+		};
+	}
+	/**
+	* Update the AlgoKit configuration with your own configuration settings
+	* @param newConfig Partial or complete config to replace
+	*/
+	configure(newConfig) {
+		this.config = {
+			...this.config,
+			...newConfig
+		};
+	}
+};
+
+//#endregion
+exports.UpdatableConfig = UpdatableConfig;
+//# sourceMappingURL=updatable-config.js.map

package/updatable-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updatable-config.js","names":["nullLogger","consoleLogger","AsyncEventEmitter"],"sources":["../src/updatable-config.ts"],"sourcesContent":["import { AsyncEventEmitter } from './async-event-emitter'\nimport { Logger, consoleLogger, nullLogger } from './logging'\n\n/** The AlgoKit configuration type */\nexport interface Config {\n  /** Logger */\n  logger: Logger\n  /** Whether or not debug mode is enabled */\n  debug: boolean\n  /** The path to the project root directory */\n  projectRoot: string | null\n  /** Indicates whether to trace all operations */\n  traceAll: boolean\n  /** The size of the trace buffer in megabytes */\n  traceBufferSizeMb: number\n  /** The maximum depth to search for a specific file */\n  maxSearchDepth: number\n  /**\n   * Whether to enable populateAppCallResources in sendParams by default.\n   * Default value is false.\n   */\n  populateAppCallResources: boolean\n\n  events: AsyncEventEmitter\n}\n\n/** Updatable AlgoKit config */\nexport class UpdatableConfig implements Readonly<Config> {\n  private config: Config\n\n  get populateAppCallResources() {\n    return this.config.populateAppCallResources\n  }\n\n  get logger() {\n    return this.config.logger\n  }\n\n  get debug() {\n    return this.config.debug\n  }\n\n  get projectRoot() {\n    return this.config.projectRoot\n  }\n\n  get traceAll() {\n    return this.config.traceAll\n  }\n\n  get traceBufferSizeMb() {\n    return this.config.traceBufferSizeMb\n  }\n\n  get maxSearchDepth() {\n    return this.config.maxSearchDepth\n  }\n\n  get events() {\n    return this.config.events\n  }\n\n  /**\n   * Returns the current logger, or the null logger if true is passed in to `returnNullLogger`\n   * @param returnNullLogger Whether or not to return the null logger\n   * @returns The requested logger\n   */\n  getLogger(returnNullLogger?: boolean) {\n    if (returnNullLogger) {\n      return nullLogger\n    }\n\n    return this.logger\n  }\n\n  /**\n   * Temporarily run with debug set to true.\n   * @param lambda A lambda expression with code to run with debug config set to true\n   */\n  withDebug(lambda: () => unknown) {\n    const original = this.config.debug\n    try {\n      this.config.debug = true\n      lambda()\n    } finally {\n      this.config.debug = original\n    }\n  }\n\n  constructor() {\n    this.config = {\n      logger: consoleLogger,\n      debug: false,\n      projectRoot: null,\n      traceAll: false,\n      traceBufferSizeMb: 256,\n      maxSearchDepth: 10,\n      populateAppCallResources: true,\n      events: new AsyncEventEmitter(),\n    }\n  }\n\n  /**\n   * Update the AlgoKit configuration with your own configuration settings\n   * @param newConfig Partial or complete config to replace\n   */\n  configure(newConfig: Partial<Config>) {\n    this.config = { ...this.config, ...newConfig }\n  }\n}\n"],"mappings":";;;;;AA2BA,IAAa,kBAAb,MAAyD;CACvD,AAAQ;CAER,IAAI,2BAA2B;AAC7B,SAAO,KAAK,OAAO;;CAGrB,IAAI,SAAS;AACX,SAAO,KAAK,OAAO;;CAGrB,IAAI,QAAQ;AACV,SAAO,KAAK,OAAO;;CAGrB,IAAI,cAAc;AAChB,SAAO,KAAK,OAAO;;CAGrB,IAAI,WAAW;AACb,SAAO,KAAK,OAAO;;CAGrB,IAAI,oBAAoB;AACtB,SAAO,KAAK,OAAO;;CAGrB,IAAI,iBAAiB;AACnB,SAAO,KAAK,OAAO;;CAGrB,IAAI,SAAS;AACX,SAAO,KAAK,OAAO;;;;;;;CAQrB,UAAU,kBAA4B;AACpC,MAAI,iBACF,QAAOA;AAGT,SAAO,KAAK;;;;;;CAOd,UAAU,QAAuB;EAC/B,MAAM,WAAW,KAAK,OAAO;AAC7B,MAAI;AACF,QAAK,OAAO,QAAQ;AACpB,WAAQ;YACA;AACR,QAAK,OAAO,QAAQ;;;CAIxB,cAAc;AACZ,OAAK,SAAS;GACZ,QAAQC;GACR,OAAO;GACP,aAAa;GACb,UAAU;GACV,mBAAmB;GACnB,gBAAgB;GAChB,0BAA0B;GAC1B,QAAQ,IAAIC,+CAAmB;GAChC;;;;;;CAOH,UAAU,WAA4B;AACpC,OAAK,SAAS;GAAE,GAAG,KAAK;GAAQ,GAAG;GAAW"}

package/updatable-config.mjs

@@ -0,0 +1,80 @@
+import { AsyncEventEmitter } from "./async-event-emitter.mjs";
+import { consoleLogger, nullLogger } from "./logging.mjs";
+
+//#region src/updatable-config.ts
+/** Updatable AlgoKit config */
+var UpdatableConfig = class {
+	config;
+	get populateAppCallResources() {
+		return this.config.populateAppCallResources;
+	}
+	get logger() {
+		return this.config.logger;
+	}
+	get debug() {
+		return this.config.debug;
+	}
+	get projectRoot() {
+		return this.config.projectRoot;
+	}
+	get traceAll() {
+		return this.config.traceAll;
+	}
+	get traceBufferSizeMb() {
+		return this.config.traceBufferSizeMb;
+	}
+	get maxSearchDepth() {
+		return this.config.maxSearchDepth;
+	}
+	get events() {
+		return this.config.events;
+	}
+	/**
+	* Returns the current logger, or the null logger if true is passed in to `returnNullLogger`
+	* @param returnNullLogger Whether or not to return the null logger
+	* @returns The requested logger
+	*/
+	getLogger(returnNullLogger) {
+		if (returnNullLogger) return nullLogger;
+		return this.logger;
+	}
+	/**
+	* Temporarily run with debug set to true.
+	* @param lambda A lambda expression with code to run with debug config set to true
+	*/
+	withDebug(lambda) {
+		const original = this.config.debug;
+		try {
+			this.config.debug = true;
+			lambda();
+		} finally {
+			this.config.debug = original;
+		}
+	}
+	constructor() {
+		this.config = {
+			logger: consoleLogger,
+			debug: false,
+			projectRoot: null,
+			traceAll: false,
+			traceBufferSizeMb: 256,
+			maxSearchDepth: 10,
+			populateAppCallResources: true,
+			events: new AsyncEventEmitter()
+		};
+	}
+	/**
+	* Update the AlgoKit configuration with your own configuration settings
+	* @param newConfig Partial or complete config to replace
+	*/
+	configure(newConfig) {
+		this.config = {
+			...this.config,
+			...newConfig
+		};
+	}
+};
+
+//#endregion
+export { UpdatableConfig };
+//# sourceMappingURL=updatable-config.mjs.map

package/updatable-config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"updatable-config.mjs","names":[],"sources":["../src/updatable-config.ts"],"sourcesContent":["import { AsyncEventEmitter } from './async-event-emitter'\nimport { Logger, consoleLogger, nullLogger } from './logging'\n\n/** The AlgoKit configuration type */\nexport interface Config {\n  /** Logger */\n  logger: Logger\n  /** Whether or not debug mode is enabled */\n  debug: boolean\n  /** The path to the project root directory */\n  projectRoot: string | null\n  /** Indicates whether to trace all operations */\n  traceAll: boolean\n  /** The size of the trace buffer in megabytes */\n  traceBufferSizeMb: number\n  /** The maximum depth to search for a specific file */\n  maxSearchDepth: number\n  /**\n   * Whether to enable populateAppCallResources in sendParams by default.\n   * Default value is false.\n   */\n  populateAppCallResources: boolean\n\n  events: AsyncEventEmitter\n}\n\n/** Updatable AlgoKit config */\nexport class UpdatableConfig implements Readonly<Config> {\n  private config: Config\n\n  get populateAppCallResources() {\n    return this.config.populateAppCallResources\n  }\n\n  get logger() {\n    return this.config.logger\n  }\n\n  get debug() {\n    return this.config.debug\n  }\n\n  get projectRoot() {\n    return this.config.projectRoot\n  }\n\n  get traceAll() {\n    return this.config.traceAll\n  }\n\n  get traceBufferSizeMb() {\n    return this.config.traceBufferSizeMb\n  }\n\n  get maxSearchDepth() {\n    return this.config.maxSearchDepth\n  }\n\n  get events() {\n    return this.config.events\n  }\n\n  /**\n   * Returns the current logger, or the null logger if true is passed in to `returnNullLogger`\n   * @param returnNullLogger Whether or not to return the null logger\n   * @returns The requested logger\n   */\n  getLogger(returnNullLogger?: boolean) {\n    if (returnNullLogger) {\n      return nullLogger\n    }\n\n    return this.logger\n  }\n\n  /**\n   * Temporarily run with debug set to true.\n   * @param lambda A lambda expression with code to run with debug config set to true\n   */\n  withDebug(lambda: () => unknown) {\n    const original = this.config.debug\n    try {\n      this.config.debug = true\n      lambda()\n    } finally {\n      this.config.debug = original\n    }\n  }\n\n  constructor() {\n    this.config = {\n      logger: consoleLogger,\n      debug: false,\n      projectRoot: null,\n      traceAll: false,\n      traceBufferSizeMb: 256,\n      maxSearchDepth: 10,\n      populateAppCallResources: true,\n      events: new AsyncEventEmitter(),\n    }\n  }\n\n  /**\n   * Update the AlgoKit configuration with your own configuration settings\n   * @param newConfig Partial or complete config to replace\n   */\n  configure(newConfig: Partial<Config>) {\n    this.config = { ...this.config, ...newConfig }\n  }\n}\n"],"mappings":";;;;;AA2BA,IAAa,kBAAb,MAAyD;CACvD,AAAQ;CAER,IAAI,2BAA2B;AAC7B,SAAO,KAAK,OAAO;;CAGrB,IAAI,SAAS;AACX,SAAO,KAAK,OAAO;;CAGrB,IAAI,QAAQ;AACV,SAAO,KAAK,OAAO;;CAGrB,IAAI,cAAc;AAChB,SAAO,KAAK,OAAO;;CAGrB,IAAI,WAAW;AACb,SAAO,KAAK,OAAO;;CAGrB,IAAI,oBAAoB;AACtB,SAAO,KAAK,OAAO;;CAGrB,IAAI,iBAAiB;AACnB,SAAO,KAAK,OAAO;;CAGrB,IAAI,SAAS;AACX,SAAO,KAAK,OAAO;;;;;;;CAQrB,UAAU,kBAA4B;AACpC,MAAI,iBACF,QAAO;AAGT,SAAO,KAAK;;;;;;CAOd,UAAU,QAAuB;EAC/B,MAAM,WAAW,KAAK,OAAO;AAC7B,MAAI;AACF,QAAK,OAAO,QAAQ;AACpB,WAAQ;YACA;AACR,QAAK,OAAO,QAAQ;;;CAIxB,cAAc;AACZ,OAAK,SAAS;GACZ,QAAQ;GACR,OAAO;GACP,aAAa;GACb,UAAU;GACV,mBAAmB;GACnB,gBAAgB;GAChB,0BAA0B;GAC1B,QAAQ,IAAI,mBAAmB;GAChC;;;;;;CAOH,UAAU,WAA4B;AACpC,OAAK,SAAS;GAAE,GAAG,KAAK;GAAQ,GAAG;GAAW"}

package/util.js

@@ -1,4 +1,4 @@
-const require_app = require('./types/app.js');
+const require_app = require('./app.js');
 
 //#region src/util.ts
 /**

package/util.js.map

@@ -1 +1 @@
-{"version":3,"file":"util.js","names":["APP_PAGE_MAX_SIZE"],"sources":["../src/util.ts"],"sourcesContent":["import { APP_PAGE_MAX_SIZE } from './types/app'\n\n/**\n * Converts a value which might be a number or a bigint into a number to be used with apis that don't support bigint.\n *\n * Throws an UnsafeConversionError if the conversion would result in an unsafe integer for the Number type\n * @param value\n */\nexport const toNumber = (value: number | bigint) => {\n  if (typeof value === 'number') return value\n\n  if (value > BigInt(Number.MAX_SAFE_INTEGER)) {\n    throw new UnsafeConversionError(\n      `Cannot convert ${value} to a Number as it is larger than the maximum safe integer the Number type can hold.`,\n    )\n  } else if (value < BigInt(Number.MIN_SAFE_INTEGER)) {\n    throw new UnsafeConversionError(\n      `Cannot convert ${value} to a Number as it is smaller than the minimum safe integer the Number type can hold.`,\n    )\n  }\n  return Number(value)\n}\n\nexport class UnsafeConversionError extends Error {}\n\n/**\n * Calculates the amount of funds to add to a wallet to bring it up to the minimum spending balance.\n * @param minSpendingBalance The minimum spending balance for the wallet\n * @param currentSpendingBalance The current spending balance for the wallet\n * @param minFundingIncrement The minimum amount of funds that can be added to the wallet\n * @returns The amount of funds to add to the wallet or null if the wallet is already above the minimum spending balance\n */\nexport const calculateFundAmount = (\n  minSpendingBalance: bigint,\n  currentSpendingBalance: bigint,\n  minFundingIncrement: bigint,\n): bigint | null => {\n  if (minSpendingBalance > currentSpendingBalance) {\n    const minFundAmount = minSpendingBalance - currentSpendingBalance\n    return BigInt(Math.max(Number(minFundAmount), Number(minFundingIncrement)))\n  } else {\n    return null\n  }\n}\n\n/**\n * Checks if the current environment is Node.js\n *\n * @returns A boolean indicating whether the current environment is Node.js\n */\nexport const isNode = () => {\n  return typeof process !== 'undefined' && process.versions != null && process.versions.node != null\n}\n\n/**\n * Returns the given array split into chunks of `batchSize` batches.\n * @param array The array to chunk\n * @param batchSize The size of batches to split the array into\n * @returns A generator that yields the array split into chunks of `batchSize` batches\n */\nexport function* chunkArray<T>(array: T[], batchSize: number): Generator<T[], void> {\n  for (let i = 0; i < array.length; i += batchSize) yield array.slice(i, i + batchSize)\n}\n\n/**\n * Memoize calls to the given function in an in-memory map.\n * @param fn The function to memoize\n * @returns The memoized function\n */\nexport const memoize = <T = unknown, R = unknown>(fn: (val: T) => R) => {\n  const cache = new Map()\n  const cached = function (this: unknown, val: T) {\n    return cache.has(val) ? cache.get(val) : cache.set(val, fn.call(this, val)) && cache.get(val)\n  }\n  cached.cache = cache\n  return cached as (val: T) => R\n}\n\nexport const binaryStartsWith = (base: Uint8Array, startsWith: Uint8Array): boolean => {\n  if (startsWith.length > base.length) return false\n  for (let i = 0; i < startsWith.length; i++) {\n    if (base[i] !== startsWith[i]) return false\n  }\n  return true\n}\n\nexport const defaultJsonValueReplacer = (key: string, value: unknown) => {\n  if (typeof value === 'bigint') {\n    try {\n      return toNumber(value)\n    } catch {\n      return value.toString()\n    }\n  }\n  return value\n}\nexport const asJson = (\n  value: unknown,\n  replacer: (key: string, value: unknown) => unknown = defaultJsonValueReplacer,\n  space?: string | number,\n) => {\n  return JSON.stringify(value, replacer, space)\n}\n\n/** Calculate minimum number of extra program pages required for provided approval and clear state programs */\nexport const calculateExtraProgramPages = (approvalProgram: Uint8Array, clearStateProgram?: Uint8Array): number => {\n  return Math.floor((approvalProgram.length + (clearStateProgram?.length ?? 0) - 1) / APP_PAGE_MAX_SIZE)\n}\n"],"mappings":";;;;;;;;;AAQA,MAAa,YAAY,UAA2B;AAClD,KAAI,OAAO,UAAU,SAAU,QAAO;AAEtC,KAAI,QAAQ,OAAO,OAAO,iBAAiB,CACzC,OAAM,IAAI,sBACR,kBAAkB,MAAM,sFACzB;UACQ,QAAQ,OAAO,OAAO,iBAAiB,CAChD,OAAM,IAAI,sBACR,kBAAkB,MAAM,uFACzB;AAEH,QAAO,OAAO,MAAM;;AAGtB,IAAa,wBAAb,cAA2C,MAAM;;;;;;;;AASjD,MAAa,uBACX,oBACA,wBACA,wBACkB;AAClB,KAAI,qBAAqB,wBAAwB;EAC/C,MAAM,gBAAgB,qBAAqB;AAC3C,SAAO,OAAO,KAAK,IAAI,OAAO,cAAc,EAAE,OAAO,oBAAoB,CAAC,CAAC;OAE3E,QAAO;;;;;;;;AAmBX,UAAiB,WAAc,OAAY,WAAyC;AAClF,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,UAAW,OAAM,MAAM,MAAM,GAAG,IAAI,UAAU;;;;;;;AAQvF,MAAa,WAAqC,OAAsB;CACtE,MAAM,wBAAQ,IAAI,KAAK;CACvB,MAAM,SAAS,SAAyB,KAAQ;AAC9C,SAAO,MAAM,IAAI,IAAI,GAAG,MAAM,IAAI,IAAI,GAAG,MAAM,IAAI,KAAK,GAAG,KAAK,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,IAAI;;AAE/F,QAAO,QAAQ;AACf,QAAO;;AAGT,MAAa,oBAAoB,MAAkB,eAAoC;AACrF,KAAI,WAAW,SAAS,KAAK,OAAQ,QAAO;AAC5C,MAAK,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,IACrC,KAAI,KAAK,OAAO,WAAW,GAAI,QAAO;AAExC,QAAO;;AAGT,MAAa,4BAA4B,KAAa,UAAmB;AACvE,KAAI,OAAO,UAAU,SACnB,KAAI;AACF,SAAO,SAAS,MAAM;SAChB;AACN,SAAO,MAAM,UAAU;;AAG3B,QAAO;;AAET,MAAa,UACX,OACA,WAAqD,0BACrD,UACG;AACH,QAAO,KAAK,UAAU,OAAO,UAAU,MAAM;;;AAI/C,MAAa,8BAA8B,iBAA6B,sBAA2C;AACjH,QAAO,KAAK,OAAO,gBAAgB,UAAU,mBAAmB,UAAU,KAAK,KAAKA,8BAAkB"}
+{"version":3,"file":"util.js","names":["APP_PAGE_MAX_SIZE"],"sources":["../src/util.ts"],"sourcesContent":["import { APP_PAGE_MAX_SIZE } from './app'\n\n/**\n * Converts a value which might be a number or a bigint into a number to be used with apis that don't support bigint.\n *\n * Throws an UnsafeConversionError if the conversion would result in an unsafe integer for the Number type\n * @param value\n */\nexport const toNumber = (value: number | bigint) => {\n  if (typeof value === 'number') return value\n\n  if (value > BigInt(Number.MAX_SAFE_INTEGER)) {\n    throw new UnsafeConversionError(\n      `Cannot convert ${value} to a Number as it is larger than the maximum safe integer the Number type can hold.`,\n    )\n  } else if (value < BigInt(Number.MIN_SAFE_INTEGER)) {\n    throw new UnsafeConversionError(\n      `Cannot convert ${value} to a Number as it is smaller than the minimum safe integer the Number type can hold.`,\n    )\n  }\n  return Number(value)\n}\n\nexport class UnsafeConversionError extends Error {}\n\n/**\n * Calculates the amount of funds to add to a wallet to bring it up to the minimum spending balance.\n * @param minSpendingBalance The minimum spending balance for the wallet\n * @param currentSpendingBalance The current spending balance for the wallet\n * @param minFundingIncrement The minimum amount of funds that can be added to the wallet\n * @returns The amount of funds to add to the wallet or null if the wallet is already above the minimum spending balance\n */\nexport const calculateFundAmount = (\n  minSpendingBalance: bigint,\n  currentSpendingBalance: bigint,\n  minFundingIncrement: bigint,\n): bigint | null => {\n  if (minSpendingBalance > currentSpendingBalance) {\n    const minFundAmount = minSpendingBalance - currentSpendingBalance\n    return BigInt(Math.max(Number(minFundAmount), Number(minFundingIncrement)))\n  } else {\n    return null\n  }\n}\n\n/**\n * Checks if the current environment is Node.js\n *\n * @returns A boolean indicating whether the current environment is Node.js\n */\nexport const isNode = () => {\n  return typeof process !== 'undefined' && process.versions != null && process.versions.node != null\n}\n\n/**\n * Returns the given array split into chunks of `batchSize` batches.\n * @param array The array to chunk\n * @param batchSize The size of batches to split the array into\n * @returns A generator that yields the array split into chunks of `batchSize` batches\n */\nexport function* chunkArray<T>(array: T[], batchSize: number): Generator<T[], void> {\n  for (let i = 0; i < array.length; i += batchSize) yield array.slice(i, i + batchSize)\n}\n\n/**\n * Memoize calls to the given function in an in-memory map.\n * @param fn The function to memoize\n * @returns The memoized function\n */\nexport const memoize = <T = unknown, R = unknown>(fn: (val: T) => R) => {\n  const cache = new Map()\n  const cached = function (this: unknown, val: T) {\n    return cache.has(val) ? cache.get(val) : cache.set(val, fn.call(this, val)) && cache.get(val)\n  }\n  cached.cache = cache\n  return cached as (val: T) => R\n}\n\nexport const binaryStartsWith = (base: Uint8Array, startsWith: Uint8Array): boolean => {\n  if (startsWith.length > base.length) return false\n  for (let i = 0; i < startsWith.length; i++) {\n    if (base[i] !== startsWith[i]) return false\n  }\n  return true\n}\n\nexport const defaultJsonValueReplacer = (key: string, value: unknown) => {\n  if (typeof value === 'bigint') {\n    try {\n      return toNumber(value)\n    } catch {\n      return value.toString()\n    }\n  }\n  return value\n}\nexport const asJson = (\n  value: unknown,\n  replacer: (key: string, value: unknown) => unknown = defaultJsonValueReplacer,\n  space?: string | number,\n) => {\n  return JSON.stringify(value, replacer, space)\n}\n\n/** Calculate minimum number of extra program pages required for provided approval and clear state programs */\nexport const calculateExtraProgramPages = (approvalProgram: Uint8Array, clearStateProgram?: Uint8Array): number => {\n  return Math.floor((approvalProgram.length + (clearStateProgram?.length ?? 0) - 1) / APP_PAGE_MAX_SIZE)\n}\n"],"mappings":";;;;;;;;;AAQA,MAAa,YAAY,UAA2B;AAClD,KAAI,OAAO,UAAU,SAAU,QAAO;AAEtC,KAAI,QAAQ,OAAO,OAAO,iBAAiB,CACzC,OAAM,IAAI,sBACR,kBAAkB,MAAM,sFACzB;UACQ,QAAQ,OAAO,OAAO,iBAAiB,CAChD,OAAM,IAAI,sBACR,kBAAkB,MAAM,uFACzB;AAEH,QAAO,OAAO,MAAM;;AAGtB,IAAa,wBAAb,cAA2C,MAAM;;;;;;;;AASjD,MAAa,uBACX,oBACA,wBACA,wBACkB;AAClB,KAAI,qBAAqB,wBAAwB;EAC/C,MAAM,gBAAgB,qBAAqB;AAC3C,SAAO,OAAO,KAAK,IAAI,OAAO,cAAc,EAAE,OAAO,oBAAoB,CAAC,CAAC;OAE3E,QAAO;;;;;;;;AAmBX,UAAiB,WAAc,OAAY,WAAyC;AAClF,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,UAAW,OAAM,MAAM,MAAM,GAAG,IAAI,UAAU;;;;;;;AAQvF,MAAa,WAAqC,OAAsB;CACtE,MAAM,wBAAQ,IAAI,KAAK;CACvB,MAAM,SAAS,SAAyB,KAAQ;AAC9C,SAAO,MAAM,IAAI,IAAI,GAAG,MAAM,IAAI,IAAI,GAAG,MAAM,IAAI,KAAK,GAAG,KAAK,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,IAAI;;AAE/F,QAAO,QAAQ;AACf,QAAO;;AAGT,MAAa,oBAAoB,MAAkB,eAAoC;AACrF,KAAI,WAAW,SAAS,KAAK,OAAQ,QAAO;AAC5C,MAAK,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,IACrC,KAAI,KAAK,OAAO,WAAW,GAAI,QAAO;AAExC,QAAO;;AAGT,MAAa,4BAA4B,KAAa,UAAmB;AACvE,KAAI,OAAO,UAAU,SACnB,KAAI;AACF,SAAO,SAAS,MAAM;SAChB;AACN,SAAO,MAAM,UAAU;;AAG3B,QAAO;;AAET,MAAa,UACX,OACA,WAAqD,0BACrD,UACG;AACH,QAAO,KAAK,UAAU,OAAO,UAAU,MAAM;;;AAI/C,MAAa,8BAA8B,iBAA6B,sBAA2C;AACjH,QAAO,KAAK,OAAO,gBAAgB,UAAU,mBAAmB,UAAU,KAAK,KAAKA,8BAAkB"}

package/util.mjs

@@ -1,4 +1,4 @@
-import { APP_PAGE_MAX_SIZE } from "./types/app.mjs";
+import { APP_PAGE_MAX_SIZE } from "./app.mjs";
 
 //#region src/util.ts
 /**

package/util.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"util.mjs","names":[],"sources":["../src/util.ts"],"sourcesContent":["import { APP_PAGE_MAX_SIZE } from './types/app'\n\n/**\n * Converts a value which might be a number or a bigint into a number to be used with apis that don't support bigint.\n *\n * Throws an UnsafeConversionError if the conversion would result in an unsafe integer for the Number type\n * @param value\n */\nexport const toNumber = (value: number | bigint) => {\n  if (typeof value === 'number') return value\n\n  if (value > BigInt(Number.MAX_SAFE_INTEGER)) {\n    throw new UnsafeConversionError(\n      `Cannot convert ${value} to a Number as it is larger than the maximum safe integer the Number type can hold.`,\n    )\n  } else if (value < BigInt(Number.MIN_SAFE_INTEGER)) {\n    throw new UnsafeConversionError(\n      `Cannot convert ${value} to a Number as it is smaller than the minimum safe integer the Number type can hold.`,\n    )\n  }\n  return Number(value)\n}\n\nexport class UnsafeConversionError extends Error {}\n\n/**\n * Calculates the amount of funds to add to a wallet to bring it up to the minimum spending balance.\n * @param minSpendingBalance The minimum spending balance for the wallet\n * @param currentSpendingBalance The current spending balance for the wallet\n * @param minFundingIncrement The minimum amount of funds that can be added to the wallet\n * @returns The amount of funds to add to the wallet or null if the wallet is already above the minimum spending balance\n */\nexport const calculateFundAmount = (\n  minSpendingBalance: bigint,\n  currentSpendingBalance: bigint,\n  minFundingIncrement: bigint,\n): bigint | null => {\n  if (minSpendingBalance > currentSpendingBalance) {\n    const minFundAmount = minSpendingBalance - currentSpendingBalance\n    return BigInt(Math.max(Number(minFundAmount), Number(minFundingIncrement)))\n  } else {\n    return null\n  }\n}\n\n/**\n * Checks if the current environment is Node.js\n *\n * @returns A boolean indicating whether the current environment is Node.js\n */\nexport const isNode = () => {\n  return typeof process !== 'undefined' && process.versions != null && process.versions.node != null\n}\n\n/**\n * Returns the given array split into chunks of `batchSize` batches.\n * @param array The array to chunk\n * @param batchSize The size of batches to split the array into\n * @returns A generator that yields the array split into chunks of `batchSize` batches\n */\nexport function* chunkArray<T>(array: T[], batchSize: number): Generator<T[], void> {\n  for (let i = 0; i < array.length; i += batchSize) yield array.slice(i, i + batchSize)\n}\n\n/**\n * Memoize calls to the given function in an in-memory map.\n * @param fn The function to memoize\n * @returns The memoized function\n */\nexport const memoize = <T = unknown, R = unknown>(fn: (val: T) => R) => {\n  const cache = new Map()\n  const cached = function (this: unknown, val: T) {\n    return cache.has(val) ? cache.get(val) : cache.set(val, fn.call(this, val)) && cache.get(val)\n  }\n  cached.cache = cache\n  return cached as (val: T) => R\n}\n\nexport const binaryStartsWith = (base: Uint8Array, startsWith: Uint8Array): boolean => {\n  if (startsWith.length > base.length) return false\n  for (let i = 0; i < startsWith.length; i++) {\n    if (base[i] !== startsWith[i]) return false\n  }\n  return true\n}\n\nexport const defaultJsonValueReplacer = (key: string, value: unknown) => {\n  if (typeof value === 'bigint') {\n    try {\n      return toNumber(value)\n    } catch {\n      return value.toString()\n    }\n  }\n  return value\n}\nexport const asJson = (\n  value: unknown,\n  replacer: (key: string, value: unknown) => unknown = defaultJsonValueReplacer,\n  space?: string | number,\n) => {\n  return JSON.stringify(value, replacer, space)\n}\n\n/** Calculate minimum number of extra program pages required for provided approval and clear state programs */\nexport const calculateExtraProgramPages = (approvalProgram: Uint8Array, clearStateProgram?: Uint8Array): number => {\n  return Math.floor((approvalProgram.length + (clearStateProgram?.length ?? 0) - 1) / APP_PAGE_MAX_SIZE)\n}\n"],"mappings":";;;;;;;;;AAQA,MAAa,YAAY,UAA2B;AAClD,KAAI,OAAO,UAAU,SAAU,QAAO;AAEtC,KAAI,QAAQ,OAAO,OAAO,iBAAiB,CACzC,OAAM,IAAI,sBACR,kBAAkB,MAAM,sFACzB;UACQ,QAAQ,OAAO,OAAO,iBAAiB,CAChD,OAAM,IAAI,sBACR,kBAAkB,MAAM,uFACzB;AAEH,QAAO,OAAO,MAAM;;AAGtB,IAAa,wBAAb,cAA2C,MAAM;;;;;;;;AASjD,MAAa,uBACX,oBACA,wBACA,wBACkB;AAClB,KAAI,qBAAqB,wBAAwB;EAC/C,MAAM,gBAAgB,qBAAqB;AAC3C,SAAO,OAAO,KAAK,IAAI,OAAO,cAAc,EAAE,OAAO,oBAAoB,CAAC,CAAC;OAE3E,QAAO;;;;;;;;AAmBX,UAAiB,WAAc,OAAY,WAAyC;AAClF,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,UAAW,OAAM,MAAM,MAAM,GAAG,IAAI,UAAU;;;;;;;AAQvF,MAAa,WAAqC,OAAsB;CACtE,MAAM,wBAAQ,IAAI,KAAK;CACvB,MAAM,SAAS,SAAyB,KAAQ;AAC9C,SAAO,MAAM,IAAI,IAAI,GAAG,MAAM,IAAI,IAAI,GAAG,MAAM,IAAI,KAAK,GAAG,KAAK,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,IAAI;;AAE/F,QAAO,QAAQ;AACf,QAAO;;AAGT,MAAa,oBAAoB,MAAkB,eAAoC;AACrF,KAAI,WAAW,SAAS,KAAK,OAAQ,QAAO;AAC5C,MAAK,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,IACrC,KAAI,KAAK,OAAO,WAAW,GAAI,QAAO;AAExC,QAAO;;AAGT,MAAa,4BAA4B,KAAa,UAAmB;AACvE,KAAI,OAAO,UAAU,SACnB,KAAI;AACF,SAAO,SAAS,MAAM;SAChB;AACN,SAAO,MAAM,UAAU;;AAG3B,QAAO;;AAET,MAAa,UACX,OACA,WAAqD,0BACrD,UACG;AACH,QAAO,KAAK,UAAU,OAAO,UAAU,MAAM;;;AAI/C,MAAa,8BAA8B,iBAA6B,sBAA2C;AACjH,QAAO,KAAK,OAAO,gBAAgB,UAAU,mBAAmB,UAAU,KAAK,KAAK,kBAAkB"}
+{"version":3,"file":"util.mjs","names":[],"sources":["../src/util.ts"],"sourcesContent":["import { APP_PAGE_MAX_SIZE } from './app'\n\n/**\n * Converts a value which might be a number or a bigint into a number to be used with apis that don't support bigint.\n *\n * Throws an UnsafeConversionError if the conversion would result in an unsafe integer for the Number type\n * @param value\n */\nexport const toNumber = (value: number | bigint) => {\n  if (typeof value === 'number') return value\n\n  if (value > BigInt(Number.MAX_SAFE_INTEGER)) {\n    throw new UnsafeConversionError(\n      `Cannot convert ${value} to a Number as it is larger than the maximum safe integer the Number type can hold.`,\n    )\n  } else if (value < BigInt(Number.MIN_SAFE_INTEGER)) {\n    throw new UnsafeConversionError(\n      `Cannot convert ${value} to a Number as it is smaller than the minimum safe integer the Number type can hold.`,\n    )\n  }\n  return Number(value)\n}\n\nexport class UnsafeConversionError extends Error {}\n\n/**\n * Calculates the amount of funds to add to a wallet to bring it up to the minimum spending balance.\n * @param minSpendingBalance The minimum spending balance for the wallet\n * @param currentSpendingBalance The current spending balance for the wallet\n * @param minFundingIncrement The minimum amount of funds that can be added to the wallet\n * @returns The amount of funds to add to the wallet or null if the wallet is already above the minimum spending balance\n */\nexport const calculateFundAmount = (\n  minSpendingBalance: bigint,\n  currentSpendingBalance: bigint,\n  minFundingIncrement: bigint,\n): bigint | null => {\n  if (minSpendingBalance > currentSpendingBalance) {\n    const minFundAmount = minSpendingBalance - currentSpendingBalance\n    return BigInt(Math.max(Number(minFundAmount), Number(minFundingIncrement)))\n  } else {\n    return null\n  }\n}\n\n/**\n * Checks if the current environment is Node.js\n *\n * @returns A boolean indicating whether the current environment is Node.js\n */\nexport const isNode = () => {\n  return typeof process !== 'undefined' && process.versions != null && process.versions.node != null\n}\n\n/**\n * Returns the given array split into chunks of `batchSize` batches.\n * @param array The array to chunk\n * @param batchSize The size of batches to split the array into\n * @returns A generator that yields the array split into chunks of `batchSize` batches\n */\nexport function* chunkArray<T>(array: T[], batchSize: number): Generator<T[], void> {\n  for (let i = 0; i < array.length; i += batchSize) yield array.slice(i, i + batchSize)\n}\n\n/**\n * Memoize calls to the given function in an in-memory map.\n * @param fn The function to memoize\n * @returns The memoized function\n */\nexport const memoize = <T = unknown, R = unknown>(fn: (val: T) => R) => {\n  const cache = new Map()\n  const cached = function (this: unknown, val: T) {\n    return cache.has(val) ? cache.get(val) : cache.set(val, fn.call(this, val)) && cache.get(val)\n  }\n  cached.cache = cache\n  return cached as (val: T) => R\n}\n\nexport const binaryStartsWith = (base: Uint8Array, startsWith: Uint8Array): boolean => {\n  if (startsWith.length > base.length) return false\n  for (let i = 0; i < startsWith.length; i++) {\n    if (base[i] !== startsWith[i]) return false\n  }\n  return true\n}\n\nexport const defaultJsonValueReplacer = (key: string, value: unknown) => {\n  if (typeof value === 'bigint') {\n    try {\n      return toNumber(value)\n    } catch {\n      return value.toString()\n    }\n  }\n  return value\n}\nexport const asJson = (\n  value: unknown,\n  replacer: (key: string, value: unknown) => unknown = defaultJsonValueReplacer,\n  space?: string | number,\n) => {\n  return JSON.stringify(value, replacer, space)\n}\n\n/** Calculate minimum number of extra program pages required for provided approval and clear state programs */\nexport const calculateExtraProgramPages = (approvalProgram: Uint8Array, clearStateProgram?: Uint8Array): number => {\n  return Math.floor((approvalProgram.length + (clearStateProgram?.length ?? 0) - 1) / APP_PAGE_MAX_SIZE)\n}\n"],"mappings":";;;;;;;;;AAQA,MAAa,YAAY,UAA2B;AAClD,KAAI,OAAO,UAAU,SAAU,QAAO;AAEtC,KAAI,QAAQ,OAAO,OAAO,iBAAiB,CACzC,OAAM,IAAI,sBACR,kBAAkB,MAAM,sFACzB;UACQ,QAAQ,OAAO,OAAO,iBAAiB,CAChD,OAAM,IAAI,sBACR,kBAAkB,MAAM,uFACzB;AAEH,QAAO,OAAO,MAAM;;AAGtB,IAAa,wBAAb,cAA2C,MAAM;;;;;;;;AASjD,MAAa,uBACX,oBACA,wBACA,wBACkB;AAClB,KAAI,qBAAqB,wBAAwB;EAC/C,MAAM,gBAAgB,qBAAqB;AAC3C,SAAO,OAAO,KAAK,IAAI,OAAO,cAAc,EAAE,OAAO,oBAAoB,CAAC,CAAC;OAE3E,QAAO;;;;;;;;AAmBX,UAAiB,WAAc,OAAY,WAAyC;AAClF,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,UAAW,OAAM,MAAM,MAAM,GAAG,IAAI,UAAU;;;;;;;AAQvF,MAAa,WAAqC,OAAsB;CACtE,MAAM,wBAAQ,IAAI,KAAK;CACvB,MAAM,SAAS,SAAyB,KAAQ;AAC9C,SAAO,MAAM,IAAI,IAAI,GAAG,MAAM,IAAI,IAAI,GAAG,MAAM,IAAI,KAAK,GAAG,KAAK,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,IAAI;;AAE/F,QAAO,QAAQ;AACf,QAAO;;AAGT,MAAa,oBAAoB,MAAkB,eAAoC;AACrF,KAAI,WAAW,SAAS,KAAK,OAAQ,QAAO;AAC5C,MAAK,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,IACrC,KAAI,KAAK,OAAO,WAAW,GAAI,QAAO;AAExC,QAAO;;AAGT,MAAa,4BAA4B,KAAa,UAAmB;AACvE,KAAI,OAAO,UAAU,SACnB,KAAI;AACF,SAAO,SAAS,MAAM;SAChB;AACN,SAAO,MAAM,UAAU;;AAG3B,QAAO;;AAET,MAAa,UACX,OACA,WAAqD,0BACrD,UACG;AACH,QAAO,KAAK,UAAU,OAAO,UAAU,MAAM;;;AAI/C,MAAa,8BAA8B,iBAA6B,sBAA2C;AACjH,QAAO,KAAK,OAAO,gBAAgB,UAAU,mBAAmB,UAAU,KAAK,KAAK,kBAAkB"}