@algorandfoundation/algokit-utils 10.0.0-alpha.12 → 10.0.0-alpha.14

package/types/app-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-factory.js","names":["AppClient","getOptionalAddress","result","ProgramSourceMap","UPDATABLE_TEMPLATE_NAME","DELETABLE_TEMPLATE_NAME","OnApplicationComplete","getABIMethod","argTypeIsTransaction","getABIDecodedValue","getAddress"],"sources":["../../src/types/app-factory.ts"],"sourcesContent":["import { Arc56Contract, argTypeIsTransaction, getABIDecodedValue, getABIMethod } from '@algorandfoundation/algokit-abi'\nimport { Address, ReadableAddress, getAddress, getOptionalAddress } from '@algorandfoundation/algokit-common'\nimport { AddressWithTransactionSigner, OnApplicationComplete, TransactionSigner } from '@algorandfoundation/algokit-transact'\nimport { ProgramSourceMap } from '@algorandfoundation/sdk'\nimport { type AlgorandClient } from './algorand-client'\nimport { AppCompilationResult, DELETABLE_TEMPLATE_NAME, TealTemplateParams, UPDATABLE_TEMPLATE_NAME } from './app'\nimport {\n  AppClient,\n  AppClientBareCallParams,\n  AppClientCompilationParams,\n  AppClientMethodCallParams,\n  AppClientParams,\n  AppSourceMaps,\n  ResolveAppClientByCreatorAndName,\n} from './app-client'\nimport {\n  AppDeployParams,\n  DeployAppDeleteMethodCall,\n  DeployAppDeleteParams,\n  DeployAppUpdateMethodCall,\n  DeployAppUpdateParams,\n} from './app-deployer'\nimport { AppSpec } from './app-spec'\nimport { AppCreateMethodCall, AppCreateParams, AppMethodCall, CommonAppCallParams } from './composer'\nimport { Expand } from './expand'\nimport { SendParams } from './transaction'\n\n/** Parameters to create an app client */\nexport interface AppFactoryParams {\n  /** The ARC-56 or ARC-32 application spec as either:\n   *  * Parsed JSON ARC-56 `Contract`\n   *  * Parsed JSON ARC-32 `AppSpec`\n   *  * Raw JSON string (in either ARC-56 or ARC-32 format)\n   */\n  appSpec: Arc56Contract | AppSpec | string\n\n  /** `AlgorandClient` instance */\n  algorand: AlgorandClient\n\n  /**\n   * Optional override for the app name; used for on-chain metadata and lookups.\n   * Defaults to the ARC-32/ARC-56 app spec name.\n   */\n  appName?: string\n\n  /** Optional address to use for the account to use as the default sender for calls. */\n  defaultSender?: ReadableAddress\n\n  /** Optional signer to use as the default signer for default sender calls (if not specified then the signer will be resolved from `AlgorandClient`). */\n  defaultSigner?: TransactionSigner\n\n  /** The version of app that is / will be deployed; defaults to 1.0 */\n  version?: string\n\n  /**\n   * Whether or not the contract should have deploy-time immutability control set, undefined = ignore.\n   * If specified here will get used in calls to `deploy` and `create` calls unless overridden in those calls.\n   *\n   * Useful if you want to vend multiple contracts from the same factory without specifying this value\n   * for each call.\n   */\n  updatable?: boolean\n\n  /**\n   * Whether or not the contract should have deploy-time permanence control set, undefined = ignore.\n   * If specified here will get used in calls to `deploy` and `create` calls unless overridden in those calls.\n   *\n   * Useful if you want to vend multiple contracts from the same factory without specifying this value\n   * for each call.\n   */\n  deletable?: boolean\n\n  /**\n   * Optional deploy-time TEAL template replacement parameters.\n   * If specified here will get used in calls to `deploy` and `create` calls unless overridden in those calls.\n   *\n   * Useful if you want to vend multiple contracts from the same factory without specifying this value\n   * for each call.\n   */\n  deployTimeParams?: TealTemplateParams\n}\n\n/** onComplete parameter for a create app call */\nexport type CreateOnComplete = {\n  onComplete?: Exclude<OnApplicationComplete, OnApplicationComplete.ClearState>\n}\n\n/** Specifies a schema used for creating an app */\nexport type CreateSchema = {\n  /** The state schema for the app. This is immutable once the app is created. By default uses the ARC32/ARC-56 spec. */\n  schema?: {\n    /** The number of integers saved in global state. */\n    globalInts: number\n    /** The number of byte slices saved in global state. */\n    globalByteSlices: number\n    /** The number of integers saved in local state. */\n    localInts: number\n    /** The number of byte slices saved in local state. */\n    localByteSlices: number\n  }\n  /** Number of extra pages required for the programs.\n   * Defaults to the number needed for the programs in this call if not specified.\n   * This is immutable once the app is created. */\n  extraProgramPages?: number\n}\n\n/** Params to specify a bare (raw) create call for an app */\nexport type AppFactoryCreateParams = Expand<AppClientBareCallParams & AppClientCompilationParams & CreateOnComplete & CreateSchema>\n\n/** Params to specify a create method call for an app */\nexport type AppFactoryCreateMethodCallParams = Expand<\n  AppClientMethodCallParams & AppClientCompilationParams & CreateOnComplete & CreateSchema\n>\n\n/** Params to get an app client by ID from an app factory. */\nexport type AppFactoryAppClientParams = Expand<Omit<AppClientParams, 'algorand' | 'appSpec'>>\n\n/** Params to get an app client by creator address and name from an app factory. */\nexport type AppFactoryResolveAppClientByCreatorAndNameParams = Expand<Omit<ResolveAppClientByCreatorAndName, 'algorand' | 'appSpec'>>\n\n/** Parameters to define a deployment for an `AppFactory` */\nexport type AppFactoryDeployParams = Expand<\n  Omit<AppDeployParams, 'createParams' | 'updateParams' | 'deleteParams' | 'metadata'> & {\n    /** Create transaction parameters to use if a create needs to be issued as part of deployment */\n    createParams?:\n      | Expand<AppClientMethodCallParams & CreateOnComplete & CreateSchema>\n      | Expand<AppClientBareCallParams & CreateOnComplete & CreateSchema>\n    /** Update transaction parameters to use if a create needs to be issued as part of deployment */\n    updateParams?: AppClientMethodCallParams | AppClientBareCallParams\n    /** Delete transaction parameters to use if a create needs to be issued as part of deployment */\n    deleteParams?: AppClientMethodCallParams | AppClientBareCallParams\n    /**\n     * Whether or not the contract should have deploy-time immutability control set.\n     * `undefined` = use AppFactory constructor value if set or base it on the app spec.\n     */\n    updatable?: boolean\n    /**\n     * Whether or not the contract should have deploy-time permanence control set.\n     * `undefined` = use AppFactory constructor value if set or base it on the app spec.\n     */\n    deletable?: boolean\n    /** Override the app name for this deployment */\n    appName?: string\n  }\n>\n\n/**\n * ARC-56/ARC-32 app factory that, for a given app spec, allows you to create\n * and deploy one or more app instances and to create one or more app clients\n * to interact with those (or other) app instances.\n */\nexport class AppFactory {\n  private _appSpec: Arc56Contract\n  private _appName: string\n  private _algorand: AlgorandClient\n  private _version: string\n  private _defaultSender?: Address\n  private _defaultSigner?: TransactionSigner\n  private _deployTimeParams?: TealTemplateParams\n  private _updatable?: boolean\n  private _deletable?: boolean\n\n  private _approvalSourceMap: ProgramSourceMap | undefined\n  private _clearSourceMap: ProgramSourceMap | undefined\n\n  private _paramsMethods: ReturnType<AppFactory['getParamsMethods']>\n\n  /**\n   * Create a new app factory.\n   * @param params The parameters to create the app factory\n   * @returns The `AppFactory` instance\n   * @example\n   * ```typescript\n   * const appFactory = new AppFactory({\n   *   appSpec: appSpec,\n   *   algorand: AlgorandClient.mainNet(),\n   * })\n   */\n  constructor(params: AppFactoryParams) {\n    this._appSpec = AppClient.normaliseAppSpec(params.appSpec)\n    this._appName = params.appName ?? this._appSpec.name\n    this._algorand = params.algorand\n    this._version = params.version ?? '1.0'\n    this._defaultSender = getOptionalAddress(params.defaultSender)\n    this._defaultSigner = params.defaultSigner\n    this._deployTimeParams = params.deployTimeParams\n    this._updatable = params.updatable\n    this._deletable = params.deletable\n    this._paramsMethods = this.getParamsMethods()\n  }\n\n  /** The name of the app (from the ARC-32 / ARC-56 app spec or override). */\n  public get appName() {\n    return this._appName\n  }\n\n  /** The ARC-56 app spec being used */\n  get appSpec() {\n    return this._appSpec\n  }\n\n  /** Return the algorand client this factory is using. */\n  get algorand() {\n    return this._algorand\n  }\n\n  /** Get parameters to create transactions (create and deploy related calls) for the current app.\n   *\n   * A good mental model for this is that these parameters represent a deferred transaction creation.\n   * @example Create a transaction in the future using Algorand Client\n   * ```typescript\n   * const createAppParams = appFactory.params.create({method: 'create_method', args: [123, 'hello']})\n   * // ...\n   * await algorand.send.AppCreateMethodCall(createAppParams)\n   * ```\n   * @example Define a nested transaction as an ABI argument\n   * ```typescript\n   * const createAppParams = appFactory.params.create({method: 'create_method', args: [123, 'hello']})\n   * await appClient.send.call({method: 'my_method', args: [createAppParams]})\n   * ```\n   */\n  get params() {\n    return this._paramsMethods\n  }\n\n  /** Create transactions for the current app */\n  readonly createTransaction = {\n    /** Create bare (raw) transactions for the current app */\n    bare: {\n      /**\n       * Create a create app call transaction using a bare (raw) create call.\n       *\n       * Performs deploy-time TEAL template placeholder substitutions (if specified).\n       * @param params The parameters to create the create call transaction\n       * @returns The create call transaction\n       */\n      create: async (params?: AppFactoryCreateParams) => {\n        return this._algorand.createTransaction.appCreate(await this.params.bare.create(params))\n      },\n    },\n\n    /**\n     * Create a create app call transaction using an ABI create call.\n     *\n     * Performs deploy-time TEAL template placeholder substitutions (if specified).\n     * @param params The parameters to create the create call transaction\n     * @returns The create call transaction\n     */\n    create: async (params: AppFactoryCreateMethodCallParams) => {\n      return this._algorand.createTransaction.appCreateMethodCall(await this.params.create(params))\n    },\n  }\n\n  /** Send transactions to the current app */\n  readonly send = {\n    /** Send bare (raw) transactions for the current app */\n    bare: {\n      /**\n       * Creates an instance of the app using a bare (raw) create call and returns the result\n       * of the creation transaction and an app client to interact with that app instance.\n       *\n       * Performs deploy-time TEAL template placeholder substitutions (if specified).\n       * @param params The parameters to create the app\n       * @returns The app client and the result of the creation transaction\n       */\n      create: async (params?: AppFactoryCreateParams & SendParams) => {\n        const updatable = params?.updatable ?? this._updatable\n        const deletable = params?.deletable ?? this._deletable\n        const deployTimeParams = params?.deployTimeParams ?? this._deployTimeParams\n        const compiled = await this.compile({ deployTimeParams, updatable, deletable })\n        const result = await this.handleCallErrors(async () => ({\n          ...(await this._algorand.send.appCreate(await this.params.bare.create({ ...params, updatable, deletable, deployTimeParams }))),\n          return: undefined,\n        }))\n        return {\n          appClient: this.getAppClientById({\n            appId: result.appId,\n          }),\n          result: {\n            ...result,\n            ...(compiled as Partial<AppCompilationResult>),\n          },\n        }\n      },\n    },\n\n    /**\n     * Creates an instance of the app and returns the result of the creation\n     * transaction and an app client to interact with that app instance.\n     *\n     * Performs deploy-time TEAL template placeholder substitutions (if specified).\n     * @param params The parameters to create the app\n     * @returns The app client and the result of the creation transaction\n     */\n    create: async (params: AppFactoryCreateMethodCallParams & SendParams) => {\n      const updatable = params?.updatable ?? this._updatable\n      const deletable = params?.deletable ?? this._deletable\n      const deployTimeParams = params?.deployTimeParams ?? this._deployTimeParams\n      const compiled = await this.compile({ deployTimeParams, updatable, deletable })\n      const result = await this.handleCallErrors(async () => {\n        const result = await this._algorand.send.appCreateMethodCall(\n          await this.params.create({ ...params, updatable, deletable, deployTimeParams }),\n        )\n        return {\n          ...result,\n          return: result.return?.returnValue,\n        }\n      })\n      return {\n        appClient: this.getAppClientById({\n          appId: result.appId,\n        }),\n        result: {\n          ...result,\n          ...(compiled as Partial<AppCompilationResult>),\n        },\n      }\n    },\n  }\n\n  /**\n   * Idempotently deploy (create if not exists, update if changed) an app against the given name for the given creator account, including deploy-time TEAL template placeholder substitutions (if specified).\n   *\n   * **Note:** When using the return from this function be sure to check `operationPerformed` to get access to various return properties like `transaction`, `confirmation` and `deleteResult`.\n   *\n   * **Note:** if there is a breaking state schema change to an existing app (and `onSchemaBreak` is set to `'replace'`) the existing app will be deleted and re-created.\n   *\n   * **Note:** if there is an update (different TEAL code) to an existing app (and `onUpdate` is set to `'replace'`) the existing app will be deleted and re-created.\n   * @param params The arguments to control the app deployment\n   * @returns The app client and the result of the deployment\n   * @example\n   * ```ts\n   * const { appClient, result } = await factory.deploy({\n   *   createParams: {\n   *     sender: 'SENDER_ADDRESS',\n   *     approvalProgram: 'APPROVAL PROGRAM',\n   *     clearStateProgram: 'CLEAR PROGRAM',\n   *     schema: {\n   *       globalByteSlices: 0,\n   *       globalInts: 0,\n   *       localByteSlices: 0,\n   *       localInts: 0\n   *     }\n   *   },\n   *   updateParams: {\n   *     sender: 'SENDER_ADDRESS'\n   *   },\n   *   deleteParams: {\n   *     sender: 'SENDER_ADDRESS'\n   *   },\n   *   onSchemaBreak: 'append',\n   *   onUpdate: 'append'\n   *  })\n   * ```\n   */\n  public async deploy(params: AppFactoryDeployParams) {\n    const updatable = params.updatable ?? this._updatable ?? this.getDeployTimeControl('updatable')\n    const deletable = params.deletable ?? this._deletable ?? this.getDeployTimeControl('deletable')\n    const deployTimeParams = params.deployTimeParams ?? this._deployTimeParams\n\n    // Compile using a appID 0 AppClient so we can register the error handler and use the programs\n    // to identify the app within the error handler (because we can't use app ID 0)\n    const tempAppClient = this.getAppClientById({ appId: 0n })\n    const compiled = await tempAppClient.compile({ deployTimeParams, updatable, deletable })\n\n    const deployResult = await this._algorand.appDeployer.deploy({\n      ...params,\n      createParams: await (params.createParams && 'method' in params.createParams\n        ? this.params.create({ ...params.createParams, updatable, deletable, deployTimeParams })\n        : this.params.bare.create({ ...params.createParams, updatable, deletable, deployTimeParams })),\n      updateParams:\n        params.updateParams && 'method' in params.updateParams\n          ? this.params.deployUpdate(params.updateParams)\n          : this.params.bare.deployUpdate(params.updateParams),\n      deleteParams:\n        params.deleteParams && 'method' in params.deleteParams\n          ? this.params.deployDelete(params.deleteParams)\n          : this.params.bare.deployDelete(params.deleteParams),\n      metadata: {\n        name: params.appName ?? this._appName,\n        version: this._version,\n        updatable,\n        deletable,\n      },\n    })\n    const appClient = this.getAppClientById({\n      appId: deployResult.appId,\n      appName: params.appName,\n    })\n    const result = {\n      ...deployResult,\n      ...(compiled as Partial<AppCompilationResult>),\n    }\n    return {\n      appClient,\n      result: {\n        ...result,\n        return:\n          'return' in result\n            ? result.operationPerformed === 'update'\n              ? params.updateParams && 'method' in params.updateParams\n                ? result.return?.returnValue\n                : undefined\n              : params.createParams && 'method' in params.createParams\n                ? result.return?.returnValue\n                : undefined\n            : undefined,\n        deleteReturn:\n          'deleteReturn' in result && params.deleteParams && 'method' in params.deleteParams ? result.deleteReturn?.returnValue : undefined,\n      },\n    }\n  }\n\n  /**\n   * Returns a new `AppClient` client for an app instance of the given ID.\n   *\n   * Automatically populates appName, defaultSender and source maps from the factory\n   * if not specified in the params.\n   * @param params The parameters to create the app client\n   * @returns The `AppClient` instance\n   * @example\n   * ```typescript\n   * const appClient = factory.getAppClientById({ appId: 12345n })\n   * ```\n   */\n  public getAppClientById(params: AppFactoryAppClientParams) {\n    return new AppClient({\n      ...params,\n      algorand: this._algorand,\n      appSpec: this._appSpec,\n      appName: params.appName ?? this._appName,\n      defaultSender: params.defaultSender ?? this._defaultSender,\n      defaultSigner: params.defaultSigner ?? this._defaultSigner,\n      approvalSourceMap: params.approvalSourceMap ?? this._approvalSourceMap,\n      clearSourceMap: params.clearSourceMap ?? this._clearSourceMap,\n    })\n  }\n\n  /**\n   * Returns a new `AppClient` client, resolving the app by creator address and name\n   * using AlgoKit app deployment semantics (i.e. looking for the app creation transaction note).\n   *\n   * Automatically populates appName, defaultSender and source maps from the factory\n   * if not specified in the params.\n   * @param params The parameters to create the app client\n   * @returns The `AppClient` instance\n   * @example\n   * ```typescript\n   * const appClient = factory.getAppClientByCreatorAndName({ creatorAddress: 'CREATOR_ADDRESS', appName: 'my_app' })\n   * ```\n   */\n  public getAppClientByCreatorAndName(params: AppFactoryResolveAppClientByCreatorAndNameParams) {\n    return AppClient.fromCreatorAndName({\n      ...params,\n      algorand: this._algorand,\n      appSpec: this._appSpec,\n      appName: params.appName ?? this._appName,\n      defaultSender: params.defaultSender ?? this._defaultSender,\n      approvalSourceMap: params.approvalSourceMap ?? this._approvalSourceMap,\n      clearSourceMap: params.clearSourceMap ?? this._clearSourceMap,\n    })\n  }\n\n  /**\n   * Takes an error that may include a logic error from a call to the current app and re-exposes the\n   * error to include source code information via the source map and ARC-56 spec.\n   * @param e The error to parse\n   * @param isClearStateProgram Whether or not the code was running the clear state program (defaults to approval program)\n   * @returns The new error, or if there was no logic error or source map then the wrapped error with source details\n   */\n  exposeLogicError(e: Error, isClearStateProgram?: boolean): Error {\n    return AppClient.exposeLogicError(e, this._appSpec, {\n      isClearStateProgram,\n      approvalSourceMap: this._approvalSourceMap,\n      clearSourceMap: this._clearSourceMap,\n    })\n  }\n\n  /**\n   * Export the current source maps for the app.\n   * @returns The source maps\n   */\n  exportSourceMaps(): AppSourceMaps {\n    if (!this._approvalSourceMap || !this._clearSourceMap) {\n      throw new Error(\n        \"Unable to export source maps; they haven't been loaded into this client - you need to call create, update, or deploy first\",\n      )\n    }\n\n    return {\n      approvalSourceMap: this._approvalSourceMap,\n      clearSourceMap: this._clearSourceMap,\n    }\n  }\n\n  /**\n   * Import source maps for the app.\n   * @param sourceMaps The source maps to import\n   */\n  importSourceMaps(sourceMaps: AppSourceMaps) {\n    this._approvalSourceMap = new ProgramSourceMap(sourceMaps.approvalSourceMap)\n    this._clearSourceMap = new ProgramSourceMap(sourceMaps.clearSourceMap)\n  }\n\n  private getDeployTimeControl(control: 'updatable' | 'deletable'): boolean | undefined {\n    const approval = this._appSpec.source?.approval ? Buffer.from(this._appSpec.source.approval, 'base64').toString('utf-8') : undefined\n    // variable not present, so unknown control value\n    if (!approval || !approval.includes(control === 'updatable' ? UPDATABLE_TEMPLATE_NAME : DELETABLE_TEMPLATE_NAME)) return undefined\n\n    // A call is present and configured\n    return (\n      this._appSpec.bareActions.call.includes(control === 'updatable' ? 'UpdateApplication' : 'DeleteApplication') ||\n      Object.values(this._appSpec.methods).some((c) =>\n        c.actions.call.includes(control === 'updatable' ? 'UpdateApplication' : 'DeleteApplication'),\n      )\n    )\n  }\n\n  private getParamsMethods() {\n    return {\n      /** Return params for a create ABI call, including deploy-time TEAL template replacements and compilation if provided */\n      create: async (params: AppFactoryCreateMethodCallParams) => {\n        const compiled = await this.compile({ ...params, deployTimeParams: params.deployTimeParams ?? this._deployTimeParams })\n        return this.getABIParams(\n          {\n            ...params,\n            deployTimeParams: params.deployTimeParams ?? this._deployTimeParams,\n            schema: params.schema ?? {\n              globalByteSlices: this._appSpec.state.schema.global.bytes,\n              globalInts: this._appSpec.state.schema.global.ints,\n              localByteSlices: this._appSpec.state.schema.local.bytes,\n              localInts: this._appSpec.state.schema.local.ints,\n            },\n            approvalProgram: compiled.approvalProgram,\n            clearStateProgram: compiled.clearStateProgram,\n          },\n          params.onComplete ?? OnApplicationComplete.NoOp,\n        ) satisfies AppCreateMethodCall\n      },\n      /** Return params for a deployment update ABI call */\n      deployUpdate: (params: AppClientMethodCallParams) => {\n        return this.getABIParams(params, OnApplicationComplete.UpdateApplication) satisfies DeployAppUpdateMethodCall\n      },\n      /** Return params for a deployment delete ABI call */\n      deployDelete: (params: AppClientMethodCallParams) => {\n        return this.getABIParams(params, OnApplicationComplete.DeleteApplication) satisfies DeployAppDeleteMethodCall\n      },\n      bare: {\n        /** Return params for a create bare call, including deploy-time TEAL template replacements and compilation if provided */\n        create: async (params?: AppFactoryCreateParams) => {\n          return this.getBareParams(\n            {\n              ...params,\n              deployTimeParams: params?.deployTimeParams ?? this._deployTimeParams,\n              schema: params?.schema ?? {\n                globalByteSlices: this._appSpec.state.schema.global.bytes,\n                globalInts: this._appSpec.state.schema.global.ints,\n                localByteSlices: this._appSpec.state.schema.local.bytes,\n                localInts: this._appSpec.state.schema.local.ints,\n              },\n              ...(await this.compile({ ...params, deployTimeParams: params?.deployTimeParams ?? this._deployTimeParams })),\n            },\n            params?.onComplete ?? OnApplicationComplete.NoOp,\n          ) satisfies AppCreateParams\n        },\n        /** Return params for a deployment update bare call */\n        deployUpdate: (params?: AppClientBareCallParams) => {\n          return this.getBareParams(params, OnApplicationComplete.UpdateApplication) satisfies DeployAppUpdateParams\n        },\n        /** Return params for a deployment delete bare call */\n        deployDelete: (params?: AppClientBareCallParams) => {\n          return this.getBareParams(params, OnApplicationComplete.DeleteApplication) satisfies DeployAppDeleteParams\n        },\n      },\n    }\n  }\n\n  /** Make the given call and catch any errors, augmenting with debugging information before re-throwing. */\n  private async handleCallErrors<TResult>(call: () => Promise<TResult>) {\n    try {\n      return await call()\n    } catch (e) {\n      throw this.exposeLogicError(e as Error)\n    }\n  }\n\n  /**\n   * Compiles the approval and clear state programs (if TEAL templates provided),\n   * performing any provided deploy-time parameter replacement and stores\n   * the source maps.\n   *\n   * If no TEAL templates provided it will use any byte code provided in the app spec.\n   *\n   * Will store any generated source maps for later use in debugging.\n   * @param compilation Optional compilation parameters to use for the compilation\n   * @returns The compilation result\n   * @example\n   * ```typescript\n   * const result = await factory.compile()\n   * ```\n   */\n  public async compile(compilation?: AppClientCompilationParams) {\n    const result = await AppClient.compile(this._appSpec, this._algorand.app, compilation)\n\n    if (result.compiledApproval) {\n      this._approvalSourceMap = result.compiledApproval.sourceMap\n    }\n    if (result.compiledClear) {\n      this._clearSourceMap = result.compiledClear.sourceMap\n    }\n\n    return result\n  }\n\n  private getBareParams<\n    TParams extends { sender?: ReadableAddress; signer?: TransactionSigner | AddressWithTransactionSigner } | undefined,\n    TOnComplete extends OnApplicationComplete,\n  >(params: TParams, onComplete: TOnComplete) {\n    return {\n      ...params,\n      sender: this.getSender(params?.sender),\n      signer: this.getSigner(params?.sender, params?.signer),\n      onComplete,\n    }\n  }\n\n  private getABIParams<\n    TParams extends {\n      method: string\n      sender?: ReadableAddress\n      signer?: TransactionSigner | AddressWithTransactionSigner\n      args?: AppClientMethodCallParams['args']\n    },\n    TOnComplete extends OnApplicationComplete,\n  >(params: TParams, onComplete: TOnComplete) {\n    return {\n      ...params,\n      sender: this.getSender(params.sender),\n      signer: this.getSigner(params.sender, params.signer),\n      method: getABIMethod(params.method, this._appSpec),\n      args: this.getCreateABIArgsWithDefaultValues(params.method, params.args),\n      onComplete,\n    }\n  }\n\n  private getCreateABIArgsWithDefaultValues(\n    methodNameOrSignature: string,\n    args: AppClientMethodCallParams['args'] | undefined,\n  ): AppMethodCall<CommonAppCallParams>['args'] {\n    const m = getABIMethod(methodNameOrSignature, this._appSpec)\n    return args?.map((arg, i) => {\n      const methodArg = m.args[i]\n      if (arg !== undefined) {\n        return arg\n      }\n      if (argTypeIsTransaction(methodArg.type)) {\n        return arg\n      }\n      const defaultValue = methodArg.defaultValue\n      if (defaultValue) {\n        switch (defaultValue.source) {\n          case 'literal': {\n            const bytes = Buffer.from(defaultValue.data, 'base64')\n            const value_type = defaultValue.type ?? methodArg.type\n            return getABIDecodedValue(value_type, bytes)\n          }\n          default:\n            throw new Error(`Can't provide default value for ${defaultValue.source} for a contract creation call`)\n        }\n      }\n      throw new Error(`No value provided for required argument ${methodArg.name ?? `arg${i + 1}`} in call to method ${m.name}`)\n    })\n  }\n\n  /** Returns the sender for a call, using the `defaultSender`\n   * if none provided and throws an error if neither provided */\n  private getSender(sender: ReadableAddress | undefined): Address {\n    if (!sender && !this._defaultSender) {\n      throw new Error(`No sender provided and no default sender present in app factory for call to app ${this._appName}`)\n    }\n    return getAddress(sender ?? this._defaultSender!)\n  }\n\n  /** Returns the signer for a call, using the provided signer or the `defaultSigner`\n   * if no signer was provided and the sender resolves to the default sender, the call will use default signer\n   * or `undefined` otherwise (so the signer is resolved from `AlgorandClient`) */\n  private getSigner(\n    sender: ReadableAddress | undefined,\n    signer: TransactionSigner | AddressWithTransactionSigner | undefined,\n  ): TransactionSigner | AddressWithTransactionSigner | undefined {\n    return signer ?? (!sender || sender === this._defaultSender ? this._defaultSigner : undefined)\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAuJA,IAAa,aAAb,MAAwB;CACtB,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;CAER,AAAQ;CACR,AAAQ;CAER,AAAQ;;;;;;;;;;;;CAaR,YAAY,QAA0B;AACpC,OAAK,WAAWA,6BAAU,iBAAiB,OAAO,QAAQ;AAC1D,OAAK,WAAW,OAAO,WAAW,KAAK,SAAS;AAChD,OAAK,YAAY,OAAO;AACxB,OAAK,WAAW,OAAO,WAAW;AAClC,OAAK,iBAAiBC,mCAAmB,OAAO,cAAc;AAC9D,OAAK,iBAAiB,OAAO;AAC7B,OAAK,oBAAoB,OAAO;AAChC,OAAK,aAAa,OAAO;AACzB,OAAK,aAAa,OAAO;AACzB,OAAK,iBAAiB,KAAK,kBAAkB;;;CAI/C,IAAW,UAAU;AACnB,SAAO,KAAK;;;CAId,IAAI,UAAU;AACZ,SAAO,KAAK;;;CAId,IAAI,WAAW;AACb,SAAO,KAAK;;;;;;;;;;;;;;;;;CAkBd,IAAI,SAAS;AACX,SAAO,KAAK;;;CAId,AAAS,oBAAoB;EAE3B,MAAM,EAQJ,QAAQ,OAAO,WAAoC;AACjD,UAAO,KAAK,UAAU,kBAAkB,UAAU,MAAM,KAAK,OAAO,KAAK,OAAO,OAAO,CAAC;KAE3F;EASD,QAAQ,OAAO,WAA6C;AAC1D,UAAO,KAAK,UAAU,kBAAkB,oBAAoB,MAAM,KAAK,OAAO,OAAO,OAAO,CAAC;;EAEhG;;CAGD,AAAS,OAAO;EAEd,MAAM,EASJ,QAAQ,OAAO,WAAiD;GAC9D,MAAM,YAAY,QAAQ,aAAa,KAAK;GAC5C,MAAM,YAAY,QAAQ,aAAa,KAAK;GAC5C,MAAM,mBAAmB,QAAQ,oBAAoB,KAAK;GAC1D,MAAM,WAAW,MAAM,KAAK,QAAQ;IAAE;IAAkB;IAAW;IAAW,CAAC;GAC/E,MAAM,SAAS,MAAM,KAAK,iBAAiB,aAAa;IACtD,GAAI,MAAM,KAAK,UAAU,KAAK,UAAU,MAAM,KAAK,OAAO,KAAK,OAAO;KAAE,GAAG;KAAQ;KAAW;KAAW;KAAkB,CAAC,CAAC;IAC7H,QAAQ;IACT,EAAE;AACH,UAAO;IACL,WAAW,KAAK,iBAAiB,EAC/B,OAAO,OAAO,OACf,CAAC;IACF,QAAQ;KACN,GAAG;KACH,GAAI;KACL;IACF;KAEJ;EAUD,QAAQ,OAAO,WAA0D;GACvE,MAAM,YAAY,QAAQ,aAAa,KAAK;GAC5C,MAAM,YAAY,QAAQ,aAAa,KAAK;GAC5C,MAAM,mBAAmB,QAAQ,oBAAoB,KAAK;GAC1D,MAAM,WAAW,MAAM,KAAK,QAAQ;IAAE;IAAkB;IAAW;IAAW,CAAC;GAC/E,MAAM,SAAS,MAAM,KAAK,iBAAiB,YAAY;IACrD,MAAMC,WAAS,MAAM,KAAK,UAAU,KAAK,oBACvC,MAAM,KAAK,OAAO,OAAO;KAAE,GAAG;KAAQ;KAAW;KAAW;KAAkB,CAAC,CAChF;AACD,WAAO;KACL,GAAGA;KACH,QAAQA,SAAO,QAAQ;KACxB;KACD;AACF,UAAO;IACL,WAAW,KAAK,iBAAiB,EAC/B,OAAO,OAAO,OACf,CAAC;IACF,QAAQ;KACN,GAAG;KACH,GAAI;KACL;IACF;;EAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCD,MAAa,OAAO,QAAgC;EAClD,MAAM,YAAY,OAAO,aAAa,KAAK,cAAc,KAAK,qBAAqB,YAAY;EAC/F,MAAM,YAAY,OAAO,aAAa,KAAK,cAAc,KAAK,qBAAqB,YAAY;EAC/F,MAAM,mBAAmB,OAAO,oBAAoB,KAAK;EAKzD,MAAM,WAAW,MADK,KAAK,iBAAiB,EAAE,OAAO,IAAI,CAAC,CACrB,QAAQ;GAAE;GAAkB;GAAW;GAAW,CAAC;EAExF,MAAM,eAAe,MAAM,KAAK,UAAU,YAAY,OAAO;GAC3D,GAAG;GACH,cAAc,OAAO,OAAO,gBAAgB,YAAY,OAAO,eAC3D,KAAK,OAAO,OAAO;IAAE,GAAG,OAAO;IAAc;IAAW;IAAW;IAAkB,CAAC,GACtF,KAAK,OAAO,KAAK,OAAO;IAAE,GAAG,OAAO;IAAc;IAAW;IAAW;IAAkB,CAAC;GAC/F,cACE,OAAO,gBAAgB,YAAY,OAAO,eACtC,KAAK,OAAO,aAAa,OAAO,aAAa,GAC7C,KAAK,OAAO,KAAK,aAAa,OAAO,aAAa;GACxD,cACE,OAAO,gBAAgB,YAAY,OAAO,eACtC,KAAK,OAAO,aAAa,OAAO,aAAa,GAC7C,KAAK,OAAO,KAAK,aAAa,OAAO,aAAa;GACxD,UAAU;IACR,MAAM,OAAO,WAAW,KAAK;IAC7B,SAAS,KAAK;IACd;IACA;IACD;GACF,CAAC;EACF,MAAM,YAAY,KAAK,iBAAiB;GACtC,OAAO,aAAa;GACpB,SAAS,OAAO;GACjB,CAAC;EACF,MAAM,SAAS;GACb,GAAG;GACH,GAAI;GACL;AACD,SAAO;GACL;GACA,QAAQ;IACN,GAAG;IACH,QACE,YAAY,SACR,OAAO,uBAAuB,WAC5B,OAAO,gBAAgB,YAAY,OAAO,eACxC,OAAO,QAAQ,cACf,SACF,OAAO,gBAAgB,YAAY,OAAO,eACxC,OAAO,QAAQ,cACf,SACJ;IACN,cACE,kBAAkB,UAAU,OAAO,gBAAgB,YAAY,OAAO,eAAe,OAAO,cAAc,cAAc;IAC3H;GACF;;;;;;;;;;;;;;CAeH,AAAO,iBAAiB,QAAmC;AACzD,SAAO,IAAIF,6BAAU;GACnB,GAAG;GACH,UAAU,KAAK;GACf,SAAS,KAAK;GACd,SAAS,OAAO,WAAW,KAAK;GAChC,eAAe,OAAO,iBAAiB,KAAK;GAC5C,eAAe,OAAO,iBAAiB,KAAK;GAC5C,mBAAmB,OAAO,qBAAqB,KAAK;GACpD,gBAAgB,OAAO,kBAAkB,KAAK;GAC/C,CAAC;;;;;;;;;;;;;;;CAgBJ,AAAO,6BAA6B,QAA0D;AAC5F,SAAOA,6BAAU,mBAAmB;GAClC,GAAG;GACH,UAAU,KAAK;GACf,SAAS,KAAK;GACd,SAAS,OAAO,WAAW,KAAK;GAChC,eAAe,OAAO,iBAAiB,KAAK;GAC5C,mBAAmB,OAAO,qBAAqB,KAAK;GACpD,gBAAgB,OAAO,kBAAkB,KAAK;GAC/C,CAAC;;;;;;;;;CAUJ,iBAAiB,GAAU,qBAAsC;AAC/D,SAAOA,6BAAU,iBAAiB,GAAG,KAAK,UAAU;GAClD;GACA,mBAAmB,KAAK;GACxB,gBAAgB,KAAK;GACtB,CAAC;;;;;;CAOJ,mBAAkC;AAChC,MAAI,CAAC,KAAK,sBAAsB,CAAC,KAAK,gBACpC,OAAM,IAAI,MACR,6HACD;AAGH,SAAO;GACL,mBAAmB,KAAK;GACxB,gBAAgB,KAAK;GACtB;;;;;;CAOH,iBAAiB,YAA2B;AAC1C,OAAK,qBAAqB,IAAIG,mCAAiB,WAAW,kBAAkB;AAC5E,OAAK,kBAAkB,IAAIA,mCAAiB,WAAW,eAAe;;CAGxE,AAAQ,qBAAqB,SAAyD;EACpF,MAAM,WAAW,KAAK,SAAS,QAAQ,WAAW,OAAO,KAAK,KAAK,SAAS,OAAO,UAAU,SAAS,CAAC,SAAS,QAAQ,GAAG;AAE3H,MAAI,CAAC,YAAY,CAAC,SAAS,SAAS,YAAY,cAAcC,sCAA0BC,oCAAwB,CAAE,QAAO;AAGzH,SACE,KAAK,SAAS,YAAY,KAAK,SAAS,YAAY,cAAc,sBAAsB,oBAAoB,IAC5G,OAAO,OAAO,KAAK,SAAS,QAAQ,CAAC,MAAM,MACzC,EAAE,QAAQ,KAAK,SAAS,YAAY,cAAc,sBAAsB,oBAAoB,CAC7F;;CAIL,AAAQ,mBAAmB;AACzB,SAAO;GAEL,QAAQ,OAAO,WAA6C;IAC1D,MAAM,WAAW,MAAM,KAAK,QAAQ;KAAE,GAAG;KAAQ,kBAAkB,OAAO,oBAAoB,KAAK;KAAmB,CAAC;AACvH,WAAO,KAAK,aACV;KACE,GAAG;KACH,kBAAkB,OAAO,oBAAoB,KAAK;KAClD,QAAQ,OAAO,UAAU;MACvB,kBAAkB,KAAK,SAAS,MAAM,OAAO,OAAO;MACpD,YAAY,KAAK,SAAS,MAAM,OAAO,OAAO;MAC9C,iBAAiB,KAAK,SAAS,MAAM,OAAO,MAAM;MAClD,WAAW,KAAK,SAAS,MAAM,OAAO,MAAM;MAC7C;KACD,iBAAiB,SAAS;KAC1B,mBAAmB,SAAS;KAC7B,EACD,OAAO,cAAcC,uCAAsB,KAC5C;;GAGH,eAAe,WAAsC;AACnD,WAAO,KAAK,aAAa,QAAQA,uCAAsB,kBAAkB;;GAG3E,eAAe,WAAsC;AACnD,WAAO,KAAK,aAAa,QAAQA,uCAAsB,kBAAkB;;GAE3E,MAAM;IAEJ,QAAQ,OAAO,WAAoC;AACjD,YAAO,KAAK,cACV;MACE,GAAG;MACH,kBAAkB,QAAQ,oBAAoB,KAAK;MACnD,QAAQ,QAAQ,UAAU;OACxB,kBAAkB,KAAK,SAAS,MAAM,OAAO,OAAO;OACpD,YAAY,KAAK,SAAS,MAAM,OAAO,OAAO;OAC9C,iBAAiB,KAAK,SAAS,MAAM,OAAO,MAAM;OAClD,WAAW,KAAK,SAAS,MAAM,OAAO,MAAM;OAC7C;MACD,GAAI,MAAM,KAAK,QAAQ;OAAE,GAAG;OAAQ,kBAAkB,QAAQ,oBAAoB,KAAK;OAAmB,CAAC;MAC5G,EACD,QAAQ,cAAcA,uCAAsB,KAC7C;;IAGH,eAAe,WAAqC;AAClD,YAAO,KAAK,cAAc,QAAQA,uCAAsB,kBAAkB;;IAG5E,eAAe,WAAqC;AAClD,YAAO,KAAK,cAAc,QAAQA,uCAAsB,kBAAkB;;IAE7E;GACF;;;CAIH,MAAc,iBAA0B,MAA8B;AACpE,MAAI;AACF,UAAO,MAAM,MAAM;WACZ,GAAG;AACV,SAAM,KAAK,iBAAiB,EAAW;;;;;;;;;;;;;;;;;;CAmB3C,MAAa,QAAQ,aAA0C;EAC7D,MAAM,SAAS,MAAMN,6BAAU,QAAQ,KAAK,UAAU,KAAK,UAAU,KAAK,YAAY;AAEtF,MAAI,OAAO,iBACT,MAAK,qBAAqB,OAAO,iBAAiB;AAEpD,MAAI,OAAO,cACT,MAAK,kBAAkB,OAAO,cAAc;AAG9C,SAAO;;CAGT,AAAQ,cAGN,QAAiB,YAAyB;AAC1C,SAAO;GACL,GAAG;GACH,QAAQ,KAAK,UAAU,QAAQ,OAAO;GACtC,QAAQ,KAAK,UAAU,QAAQ,QAAQ,QAAQ,OAAO;GACtD;GACD;;CAGH,AAAQ,aAQN,QAAiB,YAAyB;AAC1C,SAAO;GACL,GAAG;GACH,QAAQ,KAAK,UAAU,OAAO,OAAO;GACrC,QAAQ,KAAK,UAAU,OAAO,QAAQ,OAAO,OAAO;GACpD,QAAQO,gCAAa,OAAO,QAAQ,KAAK,SAAS;GAClD,MAAM,KAAK,kCAAkC,OAAO,QAAQ,OAAO,KAAK;GACxE;GACD;;CAGH,AAAQ,kCACN,uBACA,MAC4C;EAC5C,MAAM,IAAIA,gCAAa,uBAAuB,KAAK,SAAS;AAC5D,SAAO,MAAM,KAAK,KAAK,MAAM;GAC3B,MAAM,YAAY,EAAE,KAAK;AACzB,OAAI,QAAQ,OACV,QAAO;AAET,OAAIC,wCAAqB,UAAU,KAAK,CACtC,QAAO;GAET,MAAM,eAAe,UAAU;AAC/B,OAAI,aACF,SAAQ,aAAa,QAArB;IACE,KAAK,WAAW;KACd,MAAM,QAAQ,OAAO,KAAK,aAAa,MAAM,SAAS;AAEtD,YAAOC,sCADY,aAAa,QAAQ,UAAU,MACZ,MAAM;;IAE9C,QACE,OAAM,IAAI,MAAM,mCAAmC,aAAa,OAAO,+BAA+B;;AAG5G,SAAM,IAAI,MAAM,2CAA2C,UAAU,QAAQ,MAAM,IAAI,IAAI,qBAAqB,EAAE,OAAO;IACzH;;;;CAKJ,AAAQ,UAAU,QAA8C;AAC9D,MAAI,CAAC,UAAU,CAAC,KAAK,eACnB,OAAM,IAAI,MAAM,mFAAmF,KAAK,WAAW;AAErH,SAAOC,2BAAW,UAAU,KAAK,eAAgB;;;;;CAMnD,AAAQ,UACN,QACA,QAC8D;AAC9D,SAAO,WAAW,CAAC,UAAU,WAAW,KAAK,iBAAiB,KAAK,iBAAiB"}
+{"version":3,"file":"app-factory.js","names":["AppClient","getOptionalAddress","result","ProgramSourceMap","UPDATABLE_TEMPLATE_NAME","DELETABLE_TEMPLATE_NAME","OnApplicationComplete","getABIMethod","argTypeIsTransaction","getABIDecodedValue","getAddress"],"sources":["../../src/types/app-factory.ts"],"sourcesContent":["import { Arc56Contract, argTypeIsTransaction, getABIDecodedValue, getABIMethod } from '@algorandfoundation/algokit-abi'\nimport { Address, Expand, ReadableAddress, getAddress, getOptionalAddress } from '@algorandfoundation/algokit-common'\nimport { AddressWithTransactionSigner, OnApplicationComplete, TransactionSigner } from '@algorandfoundation/algokit-transact'\nimport { ProgramSourceMap } from '@algorandfoundation/sdk'\nimport { type AlgorandClient } from './algorand-client'\nimport { AppCompilationResult, DELETABLE_TEMPLATE_NAME, TealTemplateParams, UPDATABLE_TEMPLATE_NAME } from './app'\nimport {\n  AppClient,\n  AppClientBareCallParams,\n  AppClientCompilationParams,\n  AppClientMethodCallParams,\n  AppClientParams,\n  AppSourceMaps,\n  ResolveAppClientByCreatorAndName,\n} from './app-client'\nimport {\n  AppDeployParams,\n  DeployAppDeleteMethodCall,\n  DeployAppDeleteParams,\n  DeployAppUpdateMethodCall,\n  DeployAppUpdateParams,\n} from './app-deployer'\nimport { AppSpec } from './app-spec'\nimport { AppCreateMethodCall, AppCreateParams, AppMethodCall, CommonAppCallParams } from './composer'\nimport { SendParams } from './transaction'\n\n/** Parameters to create an app client */\nexport interface AppFactoryParams {\n  /** The ARC-56 or ARC-32 application spec as either:\n   *  * Parsed JSON ARC-56 `Contract`\n   *  * Parsed JSON ARC-32 `AppSpec`\n   *  * Raw JSON string (in either ARC-56 or ARC-32 format)\n   */\n  appSpec: Arc56Contract | AppSpec | string\n\n  /** `AlgorandClient` instance */\n  algorand: AlgorandClient\n\n  /**\n   * Optional override for the app name; used for on-chain metadata and lookups.\n   * Defaults to the ARC-32/ARC-56 app spec name.\n   */\n  appName?: string\n\n  /** Optional address to use for the account to use as the default sender for calls. */\n  defaultSender?: ReadableAddress\n\n  /** Optional signer to use as the default signer for default sender calls (if not specified then the signer will be resolved from `AlgorandClient`). */\n  defaultSigner?: TransactionSigner\n\n  /** The version of app that is / will be deployed; defaults to 1.0 */\n  version?: string\n\n  /**\n   * Whether or not the contract should have deploy-time immutability control set, undefined = ignore.\n   * If specified here will get used in calls to `deploy` and `create` calls unless overridden in those calls.\n   *\n   * Useful if you want to vend multiple contracts from the same factory without specifying this value\n   * for each call.\n   */\n  updatable?: boolean\n\n  /**\n   * Whether or not the contract should have deploy-time permanence control set, undefined = ignore.\n   * If specified here will get used in calls to `deploy` and `create` calls unless overridden in those calls.\n   *\n   * Useful if you want to vend multiple contracts from the same factory without specifying this value\n   * for each call.\n   */\n  deletable?: boolean\n\n  /**\n   * Optional deploy-time TEAL template replacement parameters.\n   * If specified here will get used in calls to `deploy` and `create` calls unless overridden in those calls.\n   *\n   * Useful if you want to vend multiple contracts from the same factory without specifying this value\n   * for each call.\n   */\n  deployTimeParams?: TealTemplateParams\n}\n\n/** onComplete parameter for a create app call */\nexport type CreateOnComplete = {\n  onComplete?: Exclude<OnApplicationComplete, OnApplicationComplete.ClearState>\n}\n\n/** Specifies a schema used for creating an app */\nexport type CreateSchema = {\n  /** The state schema for the app. This is immutable once the app is created. By default uses the ARC32/ARC-56 spec. */\n  schema?: {\n    /** The number of integers saved in global state. */\n    globalInts: number\n    /** The number of byte slices saved in global state. */\n    globalByteSlices: number\n    /** The number of integers saved in local state. */\n    localInts: number\n    /** The number of byte slices saved in local state. */\n    localByteSlices: number\n  }\n  /** Number of extra pages required for the programs.\n   * Defaults to the number needed for the programs in this call if not specified.\n   * This is immutable once the app is created. */\n  extraProgramPages?: number\n}\n\n/** Params to specify a bare (raw) create call for an app */\nexport type AppFactoryCreateParams = Expand<AppClientBareCallParams & AppClientCompilationParams & CreateOnComplete & CreateSchema>\n\n/** Params to specify a create method call for an app */\nexport type AppFactoryCreateMethodCallParams = Expand<\n  AppClientMethodCallParams & AppClientCompilationParams & CreateOnComplete & CreateSchema\n>\n\n/** Params to get an app client by ID from an app factory. */\nexport type AppFactoryAppClientParams = Expand<Omit<AppClientParams, 'algorand' | 'appSpec'>>\n\n/** Params to get an app client by creator address and name from an app factory. */\nexport type AppFactoryResolveAppClientByCreatorAndNameParams = Expand<Omit<ResolveAppClientByCreatorAndName, 'algorand' | 'appSpec'>>\n\n/** Parameters to define a deployment for an `AppFactory` */\nexport type AppFactoryDeployParams = Expand<\n  Omit<AppDeployParams, 'createParams' | 'updateParams' | 'deleteParams' | 'metadata'> & {\n    /** Create transaction parameters to use if a create needs to be issued as part of deployment */\n    createParams?:\n      | Expand<AppClientMethodCallParams & CreateOnComplete & CreateSchema>\n      | Expand<AppClientBareCallParams & CreateOnComplete & CreateSchema>\n    /** Update transaction parameters to use if a create needs to be issued as part of deployment */\n    updateParams?: AppClientMethodCallParams | AppClientBareCallParams\n    /** Delete transaction parameters to use if a create needs to be issued as part of deployment */\n    deleteParams?: AppClientMethodCallParams | AppClientBareCallParams\n    /**\n     * Whether or not the contract should have deploy-time immutability control set.\n     * `undefined` = use AppFactory constructor value if set or base it on the app spec.\n     */\n    updatable?: boolean\n    /**\n     * Whether or not the contract should have deploy-time permanence control set.\n     * `undefined` = use AppFactory constructor value if set or base it on the app spec.\n     */\n    deletable?: boolean\n    /** Override the app name for this deployment */\n    appName?: string\n  }\n>\n\n/**\n * ARC-56/ARC-32 app factory that, for a given app spec, allows you to create\n * and deploy one or more app instances and to create one or more app clients\n * to interact with those (or other) app instances.\n */\nexport class AppFactory {\n  private _appSpec: Arc56Contract\n  private _appName: string\n  private _algorand: AlgorandClient\n  private _version: string\n  private _defaultSender?: Address\n  private _defaultSigner?: TransactionSigner\n  private _deployTimeParams?: TealTemplateParams\n  private _updatable?: boolean\n  private _deletable?: boolean\n\n  private _approvalSourceMap: ProgramSourceMap | undefined\n  private _clearSourceMap: ProgramSourceMap | undefined\n\n  private _paramsMethods: ReturnType<AppFactory['getParamsMethods']>\n\n  /**\n   * Create a new app factory.\n   * @param params The parameters to create the app factory\n   * @returns The `AppFactory` instance\n   * @example\n   * ```typescript\n   * const appFactory = new AppFactory({\n   *   appSpec: appSpec,\n   *   algorand: AlgorandClient.mainNet(),\n   * })\n   */\n  constructor(params: AppFactoryParams) {\n    this._appSpec = AppClient.normaliseAppSpec(params.appSpec)\n    this._appName = params.appName ?? this._appSpec.name\n    this._algorand = params.algorand\n    this._version = params.version ?? '1.0'\n    this._defaultSender = getOptionalAddress(params.defaultSender)\n    this._defaultSigner = params.defaultSigner\n    this._deployTimeParams = params.deployTimeParams\n    this._updatable = params.updatable\n    this._deletable = params.deletable\n    this._paramsMethods = this.getParamsMethods()\n  }\n\n  /** The name of the app (from the ARC-32 / ARC-56 app spec or override). */\n  public get appName() {\n    return this._appName\n  }\n\n  /** The ARC-56 app spec being used */\n  get appSpec() {\n    return this._appSpec\n  }\n\n  /** Return the algorand client this factory is using. */\n  get algorand() {\n    return this._algorand\n  }\n\n  /** Get parameters to create transactions (create and deploy related calls) for the current app.\n   *\n   * A good mental model for this is that these parameters represent a deferred transaction creation.\n   * @example Create a transaction in the future using Algorand Client\n   * ```typescript\n   * const createAppParams = appFactory.params.create({method: 'create_method', args: [123, 'hello']})\n   * // ...\n   * await algorand.send.AppCreateMethodCall(createAppParams)\n   * ```\n   * @example Define a nested transaction as an ABI argument\n   * ```typescript\n   * const createAppParams = appFactory.params.create({method: 'create_method', args: [123, 'hello']})\n   * await appClient.send.call({method: 'my_method', args: [createAppParams]})\n   * ```\n   */\n  get params() {\n    return this._paramsMethods\n  }\n\n  /** Create transactions for the current app */\n  readonly createTransaction = {\n    /** Create bare (raw) transactions for the current app */\n    bare: {\n      /**\n       * Create a create app call transaction using a bare (raw) create call.\n       *\n       * Performs deploy-time TEAL template placeholder substitutions (if specified).\n       * @param params The parameters to create the create call transaction\n       * @returns The create call transaction\n       */\n      create: async (params?: AppFactoryCreateParams) => {\n        return this._algorand.createTransaction.appCreate(await this.params.bare.create(params))\n      },\n    },\n\n    /**\n     * Create a create app call transaction using an ABI create call.\n     *\n     * Performs deploy-time TEAL template placeholder substitutions (if specified).\n     * @param params The parameters to create the create call transaction\n     * @returns The create call transaction\n     */\n    create: async (params: AppFactoryCreateMethodCallParams) => {\n      return this._algorand.createTransaction.appCreateMethodCall(await this.params.create(params))\n    },\n  }\n\n  /** Send transactions to the current app */\n  readonly send = {\n    /** Send bare (raw) transactions for the current app */\n    bare: {\n      /**\n       * Creates an instance of the app using a bare (raw) create call and returns the result\n       * of the creation transaction and an app client to interact with that app instance.\n       *\n       * Performs deploy-time TEAL template placeholder substitutions (if specified).\n       * @param params The parameters to create the app\n       * @returns The app client and the result of the creation transaction\n       */\n      create: async (params?: AppFactoryCreateParams & SendParams) => {\n        const updatable = params?.updatable ?? this._updatable\n        const deletable = params?.deletable ?? this._deletable\n        const deployTimeParams = params?.deployTimeParams ?? this._deployTimeParams\n        const compiled = await this.compile({ deployTimeParams, updatable, deletable })\n        const result = await this.handleCallErrors(async () => ({\n          ...(await this._algorand.send.appCreate(await this.params.bare.create({ ...params, updatable, deletable, deployTimeParams }))),\n          return: undefined,\n        }))\n        return {\n          appClient: this.getAppClientById({\n            appId: result.appId,\n          }),\n          result: {\n            ...result,\n            ...(compiled as Partial<AppCompilationResult>),\n          },\n        }\n      },\n    },\n\n    /**\n     * Creates an instance of the app and returns the result of the creation\n     * transaction and an app client to interact with that app instance.\n     *\n     * Performs deploy-time TEAL template placeholder substitutions (if specified).\n     * @param params The parameters to create the app\n     * @returns The app client and the result of the creation transaction\n     */\n    create: async (params: AppFactoryCreateMethodCallParams & SendParams) => {\n      const updatable = params?.updatable ?? this._updatable\n      const deletable = params?.deletable ?? this._deletable\n      const deployTimeParams = params?.deployTimeParams ?? this._deployTimeParams\n      const compiled = await this.compile({ deployTimeParams, updatable, deletable })\n      const result = await this.handleCallErrors(async () => {\n        const result = await this._algorand.send.appCreateMethodCall(\n          await this.params.create({ ...params, updatable, deletable, deployTimeParams }),\n        )\n        return {\n          ...result,\n          return: result.return?.returnValue,\n        }\n      })\n      return {\n        appClient: this.getAppClientById({\n          appId: result.appId,\n        }),\n        result: {\n          ...result,\n          ...(compiled as Partial<AppCompilationResult>),\n        },\n      }\n    },\n  }\n\n  /**\n   * Idempotently deploy (create if not exists, update if changed) an app against the given name for the given creator account, including deploy-time TEAL template placeholder substitutions (if specified).\n   *\n   * **Note:** When using the return from this function be sure to check `operationPerformed` to get access to various return properties like `transaction`, `confirmation` and `deleteResult`.\n   *\n   * **Note:** if there is a breaking state schema change to an existing app (and `onSchemaBreak` is set to `'replace'`) the existing app will be deleted and re-created.\n   *\n   * **Note:** if there is an update (different TEAL code) to an existing app (and `onUpdate` is set to `'replace'`) the existing app will be deleted and re-created.\n   * @param params The arguments to control the app deployment\n   * @returns The app client and the result of the deployment\n   * @example\n   * ```ts\n   * const { appClient, result } = await factory.deploy({\n   *   createParams: {\n   *     sender: 'SENDER_ADDRESS',\n   *     approvalProgram: 'APPROVAL PROGRAM',\n   *     clearStateProgram: 'CLEAR PROGRAM',\n   *     schema: {\n   *       globalByteSlices: 0,\n   *       globalInts: 0,\n   *       localByteSlices: 0,\n   *       localInts: 0\n   *     }\n   *   },\n   *   updateParams: {\n   *     sender: 'SENDER_ADDRESS'\n   *   },\n   *   deleteParams: {\n   *     sender: 'SENDER_ADDRESS'\n   *   },\n   *   onSchemaBreak: 'append',\n   *   onUpdate: 'append'\n   *  })\n   * ```\n   */\n  public async deploy(params: AppFactoryDeployParams) {\n    const updatable = params.updatable ?? this._updatable ?? this.getDeployTimeControl('updatable')\n    const deletable = params.deletable ?? this._deletable ?? this.getDeployTimeControl('deletable')\n    const deployTimeParams = params.deployTimeParams ?? this._deployTimeParams\n\n    // Compile using a appID 0 AppClient so we can register the error handler and use the programs\n    // to identify the app within the error handler (because we can't use app ID 0)\n    const tempAppClient = this.getAppClientById({ appId: 0n })\n    const compiled = await tempAppClient.compile({ deployTimeParams, updatable, deletable })\n\n    const deployResult = await this._algorand.appDeployer.deploy({\n      ...params,\n      createParams: await (params.createParams && 'method' in params.createParams\n        ? this.params.create({ ...params.createParams, updatable, deletable, deployTimeParams })\n        : this.params.bare.create({ ...params.createParams, updatable, deletable, deployTimeParams })),\n      updateParams:\n        params.updateParams && 'method' in params.updateParams\n          ? this.params.deployUpdate(params.updateParams)\n          : this.params.bare.deployUpdate(params.updateParams),\n      deleteParams:\n        params.deleteParams && 'method' in params.deleteParams\n          ? this.params.deployDelete(params.deleteParams)\n          : this.params.bare.deployDelete(params.deleteParams),\n      metadata: {\n        name: params.appName ?? this._appName,\n        version: this._version,\n        updatable,\n        deletable,\n      },\n    })\n    const appClient = this.getAppClientById({\n      appId: deployResult.appId,\n      appName: params.appName,\n    })\n    const result = {\n      ...deployResult,\n      ...(compiled as Partial<AppCompilationResult>),\n    }\n    return {\n      appClient,\n      result: {\n        ...result,\n        return:\n          'return' in result\n            ? result.operationPerformed === 'update'\n              ? params.updateParams && 'method' in params.updateParams\n                ? result.return?.returnValue\n                : undefined\n              : params.createParams && 'method' in params.createParams\n                ? result.return?.returnValue\n                : undefined\n            : undefined,\n        deleteReturn:\n          'deleteReturn' in result && params.deleteParams && 'method' in params.deleteParams ? result.deleteReturn?.returnValue : undefined,\n      },\n    }\n  }\n\n  /**\n   * Returns a new `AppClient` client for an app instance of the given ID.\n   *\n   * Automatically populates appName, defaultSender and source maps from the factory\n   * if not specified in the params.\n   * @param params The parameters to create the app client\n   * @returns The `AppClient` instance\n   * @example\n   * ```typescript\n   * const appClient = factory.getAppClientById({ appId: 12345n })\n   * ```\n   */\n  public getAppClientById(params: AppFactoryAppClientParams) {\n    return new AppClient({\n      ...params,\n      algorand: this._algorand,\n      appSpec: this._appSpec,\n      appName: params.appName ?? this._appName,\n      defaultSender: params.defaultSender ?? this._defaultSender,\n      defaultSigner: params.defaultSigner ?? this._defaultSigner,\n      approvalSourceMap: params.approvalSourceMap ?? this._approvalSourceMap,\n      clearSourceMap: params.clearSourceMap ?? this._clearSourceMap,\n    })\n  }\n\n  /**\n   * Returns a new `AppClient` client, resolving the app by creator address and name\n   * using AlgoKit app deployment semantics (i.e. looking for the app creation transaction note).\n   *\n   * Automatically populates appName, defaultSender and source maps from the factory\n   * if not specified in the params.\n   * @param params The parameters to create the app client\n   * @returns The `AppClient` instance\n   * @example\n   * ```typescript\n   * const appClient = factory.getAppClientByCreatorAndName({ creatorAddress: 'CREATOR_ADDRESS', appName: 'my_app' })\n   * ```\n   */\n  public getAppClientByCreatorAndName(params: AppFactoryResolveAppClientByCreatorAndNameParams) {\n    return AppClient.fromCreatorAndName({\n      ...params,\n      algorand: this._algorand,\n      appSpec: this._appSpec,\n      appName: params.appName ?? this._appName,\n      defaultSender: params.defaultSender ?? this._defaultSender,\n      approvalSourceMap: params.approvalSourceMap ?? this._approvalSourceMap,\n      clearSourceMap: params.clearSourceMap ?? this._clearSourceMap,\n    })\n  }\n\n  /**\n   * Takes an error that may include a logic error from a call to the current app and re-exposes the\n   * error to include source code information via the source map and ARC-56 spec.\n   * @param e The error to parse\n   * @param isClearStateProgram Whether or not the code was running the clear state program (defaults to approval program)\n   * @returns The new error, or if there was no logic error or source map then the wrapped error with source details\n   */\n  exposeLogicError(e: Error, isClearStateProgram?: boolean): Error {\n    return AppClient.exposeLogicError(e, this._appSpec, {\n      isClearStateProgram,\n      approvalSourceMap: this._approvalSourceMap,\n      clearSourceMap: this._clearSourceMap,\n    })\n  }\n\n  /**\n   * Export the current source maps for the app.\n   * @returns The source maps\n   */\n  exportSourceMaps(): AppSourceMaps {\n    if (!this._approvalSourceMap || !this._clearSourceMap) {\n      throw new Error(\n        \"Unable to export source maps; they haven't been loaded into this client - you need to call create, update, or deploy first\",\n      )\n    }\n\n    return {\n      approvalSourceMap: this._approvalSourceMap,\n      clearSourceMap: this._clearSourceMap,\n    }\n  }\n\n  /**\n   * Import source maps for the app.\n   * @param sourceMaps The source maps to import\n   */\n  importSourceMaps(sourceMaps: AppSourceMaps) {\n    this._approvalSourceMap = new ProgramSourceMap(sourceMaps.approvalSourceMap)\n    this._clearSourceMap = new ProgramSourceMap(sourceMaps.clearSourceMap)\n  }\n\n  private getDeployTimeControl(control: 'updatable' | 'deletable'): boolean | undefined {\n    const approval = this._appSpec.source?.approval ? Buffer.from(this._appSpec.source.approval, 'base64').toString('utf-8') : undefined\n    // variable not present, so unknown control value\n    if (!approval || !approval.includes(control === 'updatable' ? UPDATABLE_TEMPLATE_NAME : DELETABLE_TEMPLATE_NAME)) return undefined\n\n    // A call is present and configured\n    return (\n      this._appSpec.bareActions.call.includes(control === 'updatable' ? 'UpdateApplication' : 'DeleteApplication') ||\n      Object.values(this._appSpec.methods).some((c) =>\n        c.actions.call.includes(control === 'updatable' ? 'UpdateApplication' : 'DeleteApplication'),\n      )\n    )\n  }\n\n  private getParamsMethods() {\n    return {\n      /** Return params for a create ABI call, including deploy-time TEAL template replacements and compilation if provided */\n      create: async (params: AppFactoryCreateMethodCallParams) => {\n        const compiled = await this.compile({ ...params, deployTimeParams: params.deployTimeParams ?? this._deployTimeParams })\n        return this.getABIParams(\n          {\n            ...params,\n            deployTimeParams: params.deployTimeParams ?? this._deployTimeParams,\n            schema: params.schema ?? {\n              globalByteSlices: this._appSpec.state.schema.global.bytes,\n              globalInts: this._appSpec.state.schema.global.ints,\n              localByteSlices: this._appSpec.state.schema.local.bytes,\n              localInts: this._appSpec.state.schema.local.ints,\n            },\n            approvalProgram: compiled.approvalProgram,\n            clearStateProgram: compiled.clearStateProgram,\n          },\n          params.onComplete ?? OnApplicationComplete.NoOp,\n        ) satisfies AppCreateMethodCall\n      },\n      /** Return params for a deployment update ABI call */\n      deployUpdate: (params: AppClientMethodCallParams) => {\n        return this.getABIParams(params, OnApplicationComplete.UpdateApplication) satisfies DeployAppUpdateMethodCall\n      },\n      /** Return params for a deployment delete ABI call */\n      deployDelete: (params: AppClientMethodCallParams) => {\n        return this.getABIParams(params, OnApplicationComplete.DeleteApplication) satisfies DeployAppDeleteMethodCall\n      },\n      bare: {\n        /** Return params for a create bare call, including deploy-time TEAL template replacements and compilation if provided */\n        create: async (params?: AppFactoryCreateParams) => {\n          return this.getBareParams(\n            {\n              ...params,\n              deployTimeParams: params?.deployTimeParams ?? this._deployTimeParams,\n              schema: params?.schema ?? {\n                globalByteSlices: this._appSpec.state.schema.global.bytes,\n                globalInts: this._appSpec.state.schema.global.ints,\n                localByteSlices: this._appSpec.state.schema.local.bytes,\n                localInts: this._appSpec.state.schema.local.ints,\n              },\n              ...(await this.compile({ ...params, deployTimeParams: params?.deployTimeParams ?? this._deployTimeParams })),\n            },\n            params?.onComplete ?? OnApplicationComplete.NoOp,\n          ) satisfies AppCreateParams\n        },\n        /** Return params for a deployment update bare call */\n        deployUpdate: (params?: AppClientBareCallParams) => {\n          return this.getBareParams(params, OnApplicationComplete.UpdateApplication) satisfies DeployAppUpdateParams\n        },\n        /** Return params for a deployment delete bare call */\n        deployDelete: (params?: AppClientBareCallParams) => {\n          return this.getBareParams(params, OnApplicationComplete.DeleteApplication) satisfies DeployAppDeleteParams\n        },\n      },\n    }\n  }\n\n  /** Make the given call and catch any errors, augmenting with debugging information before re-throwing. */\n  private async handleCallErrors<TResult>(call: () => Promise<TResult>) {\n    try {\n      return await call()\n    } catch (e) {\n      throw this.exposeLogicError(e as Error)\n    }\n  }\n\n  /**\n   * Compiles the approval and clear state programs (if TEAL templates provided),\n   * performing any provided deploy-time parameter replacement and stores\n   * the source maps.\n   *\n   * If no TEAL templates provided it will use any byte code provided in the app spec.\n   *\n   * Will store any generated source maps for later use in debugging.\n   * @param compilation Optional compilation parameters to use for the compilation\n   * @returns The compilation result\n   * @example\n   * ```typescript\n   * const result = await factory.compile()\n   * ```\n   */\n  public async compile(compilation?: AppClientCompilationParams) {\n    const result = await AppClient.compile(this._appSpec, this._algorand.app, compilation)\n\n    if (result.compiledApproval) {\n      this._approvalSourceMap = result.compiledApproval.sourceMap\n    }\n    if (result.compiledClear) {\n      this._clearSourceMap = result.compiledClear.sourceMap\n    }\n\n    return result\n  }\n\n  private getBareParams<\n    TParams extends { sender?: ReadableAddress; signer?: TransactionSigner | AddressWithTransactionSigner } | undefined,\n    TOnComplete extends OnApplicationComplete,\n  >(params: TParams, onComplete: TOnComplete) {\n    return {\n      ...params,\n      sender: this.getSender(params?.sender),\n      signer: this.getSigner(params?.sender, params?.signer),\n      onComplete,\n    }\n  }\n\n  private getABIParams<\n    TParams extends {\n      method: string\n      sender?: ReadableAddress\n      signer?: TransactionSigner | AddressWithTransactionSigner\n      args?: AppClientMethodCallParams['args']\n    },\n    TOnComplete extends OnApplicationComplete,\n  >(params: TParams, onComplete: TOnComplete) {\n    return {\n      ...params,\n      sender: this.getSender(params.sender),\n      signer: this.getSigner(params.sender, params.signer),\n      method: getABIMethod(params.method, this._appSpec),\n      args: this.getCreateABIArgsWithDefaultValues(params.method, params.args),\n      onComplete,\n    }\n  }\n\n  private getCreateABIArgsWithDefaultValues(\n    methodNameOrSignature: string,\n    args: AppClientMethodCallParams['args'] | undefined,\n  ): AppMethodCall<CommonAppCallParams>['args'] {\n    const m = getABIMethod(methodNameOrSignature, this._appSpec)\n    return args?.map((arg, i) => {\n      const methodArg = m.args[i]\n      if (arg !== undefined) {\n        return arg\n      }\n      if (argTypeIsTransaction(methodArg.type)) {\n        return arg\n      }\n      const defaultValue = methodArg.defaultValue\n      if (defaultValue) {\n        switch (defaultValue.source) {\n          case 'literal': {\n            const bytes = Buffer.from(defaultValue.data, 'base64')\n            const value_type = defaultValue.type ?? methodArg.type\n            return getABIDecodedValue(value_type, bytes)\n          }\n          default:\n            throw new Error(`Can't provide default value for ${defaultValue.source} for a contract creation call`)\n        }\n      }\n      throw new Error(`No value provided for required argument ${methodArg.name ?? `arg${i + 1}`} in call to method ${m.name}`)\n    })\n  }\n\n  /** Returns the sender for a call, using the `defaultSender`\n   * if none provided and throws an error if neither provided */\n  private getSender(sender: ReadableAddress | undefined): Address {\n    if (!sender && !this._defaultSender) {\n      throw new Error(`No sender provided and no default sender present in app factory for call to app ${this._appName}`)\n    }\n    return getAddress(sender ?? this._defaultSender!)\n  }\n\n  /** Returns the signer for a call, using the provided signer or the `defaultSigner`\n   * if no signer was provided and the sender resolves to the default sender, the call will use default signer\n   * or `undefined` otherwise (so the signer is resolved from `AlgorandClient`) */\n  private getSigner(\n    sender: ReadableAddress | undefined,\n    signer: TransactionSigner | AddressWithTransactionSigner | undefined,\n  ): TransactionSigner | AddressWithTransactionSigner | undefined {\n    return signer ?? (!sender || sender === this._defaultSender ? this._defaultSigner : undefined)\n  }\n}\n"],"mappings":"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"}

package/types/app-factory.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"app-factory.mjs","names":["result"],"sources":["../../src/types/app-factory.ts"],"sourcesContent":["import { Arc56Contract, argTypeIsTransaction, getABIDecodedValue, getABIMethod } from '@algorandfoundation/algokit-abi'\nimport { Address, ReadableAddress, getAddress, getOptionalAddress } from '@algorandfoundation/algokit-common'\nimport { AddressWithTransactionSigner, OnApplicationComplete, TransactionSigner } from '@algorandfoundation/algokit-transact'\nimport { ProgramSourceMap } from '@algorandfoundation/sdk'\nimport { type AlgorandClient } from './algorand-client'\nimport { AppCompilationResult, DELETABLE_TEMPLATE_NAME, TealTemplateParams, UPDATABLE_TEMPLATE_NAME } from './app'\nimport {\n  AppClient,\n  AppClientBareCallParams,\n  AppClientCompilationParams,\n  AppClientMethodCallParams,\n  AppClientParams,\n  AppSourceMaps,\n  ResolveAppClientByCreatorAndName,\n} from './app-client'\nimport {\n  AppDeployParams,\n  DeployAppDeleteMethodCall,\n  DeployAppDeleteParams,\n  DeployAppUpdateMethodCall,\n  DeployAppUpdateParams,\n} from './app-deployer'\nimport { AppSpec } from './app-spec'\nimport { AppCreateMethodCall, AppCreateParams, AppMethodCall, CommonAppCallParams } from './composer'\nimport { Expand } from './expand'\nimport { SendParams } from './transaction'\n\n/** Parameters to create an app client */\nexport interface AppFactoryParams {\n  /** The ARC-56 or ARC-32 application spec as either:\n   *  * Parsed JSON ARC-56 `Contract`\n   *  * Parsed JSON ARC-32 `AppSpec`\n   *  * Raw JSON string (in either ARC-56 or ARC-32 format)\n   */\n  appSpec: Arc56Contract | AppSpec | string\n\n  /** `AlgorandClient` instance */\n  algorand: AlgorandClient\n\n  /**\n   * Optional override for the app name; used for on-chain metadata and lookups.\n   * Defaults to the ARC-32/ARC-56 app spec name.\n   */\n  appName?: string\n\n  /** Optional address to use for the account to use as the default sender for calls. */\n  defaultSender?: ReadableAddress\n\n  /** Optional signer to use as the default signer for default sender calls (if not specified then the signer will be resolved from `AlgorandClient`). */\n  defaultSigner?: TransactionSigner\n\n  /** The version of app that is / will be deployed; defaults to 1.0 */\n  version?: string\n\n  /**\n   * Whether or not the contract should have deploy-time immutability control set, undefined = ignore.\n   * If specified here will get used in calls to `deploy` and `create` calls unless overridden in those calls.\n   *\n   * Useful if you want to vend multiple contracts from the same factory without specifying this value\n   * for each call.\n   */\n  updatable?: boolean\n\n  /**\n   * Whether or not the contract should have deploy-time permanence control set, undefined = ignore.\n   * If specified here will get used in calls to `deploy` and `create` calls unless overridden in those calls.\n   *\n   * Useful if you want to vend multiple contracts from the same factory without specifying this value\n   * for each call.\n   */\n  deletable?: boolean\n\n  /**\n   * Optional deploy-time TEAL template replacement parameters.\n   * If specified here will get used in calls to `deploy` and `create` calls unless overridden in those calls.\n   *\n   * Useful if you want to vend multiple contracts from the same factory without specifying this value\n   * for each call.\n   */\n  deployTimeParams?: TealTemplateParams\n}\n\n/** onComplete parameter for a create app call */\nexport type CreateOnComplete = {\n  onComplete?: Exclude<OnApplicationComplete, OnApplicationComplete.ClearState>\n}\n\n/** Specifies a schema used for creating an app */\nexport type CreateSchema = {\n  /** The state schema for the app. This is immutable once the app is created. By default uses the ARC32/ARC-56 spec. */\n  schema?: {\n    /** The number of integers saved in global state. */\n    globalInts: number\n    /** The number of byte slices saved in global state. */\n    globalByteSlices: number\n    /** The number of integers saved in local state. */\n    localInts: number\n    /** The number of byte slices saved in local state. */\n    localByteSlices: number\n  }\n  /** Number of extra pages required for the programs.\n   * Defaults to the number needed for the programs in this call if not specified.\n   * This is immutable once the app is created. */\n  extraProgramPages?: number\n}\n\n/** Params to specify a bare (raw) create call for an app */\nexport type AppFactoryCreateParams = Expand<AppClientBareCallParams & AppClientCompilationParams & CreateOnComplete & CreateSchema>\n\n/** Params to specify a create method call for an app */\nexport type AppFactoryCreateMethodCallParams = Expand<\n  AppClientMethodCallParams & AppClientCompilationParams & CreateOnComplete & CreateSchema\n>\n\n/** Params to get an app client by ID from an app factory. */\nexport type AppFactoryAppClientParams = Expand<Omit<AppClientParams, 'algorand' | 'appSpec'>>\n\n/** Params to get an app client by creator address and name from an app factory. */\nexport type AppFactoryResolveAppClientByCreatorAndNameParams = Expand<Omit<ResolveAppClientByCreatorAndName, 'algorand' | 'appSpec'>>\n\n/** Parameters to define a deployment for an `AppFactory` */\nexport type AppFactoryDeployParams = Expand<\n  Omit<AppDeployParams, 'createParams' | 'updateParams' | 'deleteParams' | 'metadata'> & {\n    /** Create transaction parameters to use if a create needs to be issued as part of deployment */\n    createParams?:\n      | Expand<AppClientMethodCallParams & CreateOnComplete & CreateSchema>\n      | Expand<AppClientBareCallParams & CreateOnComplete & CreateSchema>\n    /** Update transaction parameters to use if a create needs to be issued as part of deployment */\n    updateParams?: AppClientMethodCallParams | AppClientBareCallParams\n    /** Delete transaction parameters to use if a create needs to be issued as part of deployment */\n    deleteParams?: AppClientMethodCallParams | AppClientBareCallParams\n    /**\n     * Whether or not the contract should have deploy-time immutability control set.\n     * `undefined` = use AppFactory constructor value if set or base it on the app spec.\n     */\n    updatable?: boolean\n    /**\n     * Whether or not the contract should have deploy-time permanence control set.\n     * `undefined` = use AppFactory constructor value if set or base it on the app spec.\n     */\n    deletable?: boolean\n    /** Override the app name for this deployment */\n    appName?: string\n  }\n>\n\n/**\n * ARC-56/ARC-32 app factory that, for a given app spec, allows you to create\n * and deploy one or more app instances and to create one or more app clients\n * to interact with those (or other) app instances.\n */\nexport class AppFactory {\n  private _appSpec: Arc56Contract\n  private _appName: string\n  private _algorand: AlgorandClient\n  private _version: string\n  private _defaultSender?: Address\n  private _defaultSigner?: TransactionSigner\n  private _deployTimeParams?: TealTemplateParams\n  private _updatable?: boolean\n  private _deletable?: boolean\n\n  private _approvalSourceMap: ProgramSourceMap | undefined\n  private _clearSourceMap: ProgramSourceMap | undefined\n\n  private _paramsMethods: ReturnType<AppFactory['getParamsMethods']>\n\n  /**\n   * Create a new app factory.\n   * @param params The parameters to create the app factory\n   * @returns The `AppFactory` instance\n   * @example\n   * ```typescript\n   * const appFactory = new AppFactory({\n   *   appSpec: appSpec,\n   *   algorand: AlgorandClient.mainNet(),\n   * })\n   */\n  constructor(params: AppFactoryParams) {\n    this._appSpec = AppClient.normaliseAppSpec(params.appSpec)\n    this._appName = params.appName ?? this._appSpec.name\n    this._algorand = params.algorand\n    this._version = params.version ?? '1.0'\n    this._defaultSender = getOptionalAddress(params.defaultSender)\n    this._defaultSigner = params.defaultSigner\n    this._deployTimeParams = params.deployTimeParams\n    this._updatable = params.updatable\n    this._deletable = params.deletable\n    this._paramsMethods = this.getParamsMethods()\n  }\n\n  /** The name of the app (from the ARC-32 / ARC-56 app spec or override). */\n  public get appName() {\n    return this._appName\n  }\n\n  /** The ARC-56 app spec being used */\n  get appSpec() {\n    return this._appSpec\n  }\n\n  /** Return the algorand client this factory is using. */\n  get algorand() {\n    return this._algorand\n  }\n\n  /** Get parameters to create transactions (create and deploy related calls) for the current app.\n   *\n   * A good mental model for this is that these parameters represent a deferred transaction creation.\n   * @example Create a transaction in the future using Algorand Client\n   * ```typescript\n   * const createAppParams = appFactory.params.create({method: 'create_method', args: [123, 'hello']})\n   * // ...\n   * await algorand.send.AppCreateMethodCall(createAppParams)\n   * ```\n   * @example Define a nested transaction as an ABI argument\n   * ```typescript\n   * const createAppParams = appFactory.params.create({method: 'create_method', args: [123, 'hello']})\n   * await appClient.send.call({method: 'my_method', args: [createAppParams]})\n   * ```\n   */\n  get params() {\n    return this._paramsMethods\n  }\n\n  /** Create transactions for the current app */\n  readonly createTransaction = {\n    /** Create bare (raw) transactions for the current app */\n    bare: {\n      /**\n       * Create a create app call transaction using a bare (raw) create call.\n       *\n       * Performs deploy-time TEAL template placeholder substitutions (if specified).\n       * @param params The parameters to create the create call transaction\n       * @returns The create call transaction\n       */\n      create: async (params?: AppFactoryCreateParams) => {\n        return this._algorand.createTransaction.appCreate(await this.params.bare.create(params))\n      },\n    },\n\n    /**\n     * Create a create app call transaction using an ABI create call.\n     *\n     * Performs deploy-time TEAL template placeholder substitutions (if specified).\n     * @param params The parameters to create the create call transaction\n     * @returns The create call transaction\n     */\n    create: async (params: AppFactoryCreateMethodCallParams) => {\n      return this._algorand.createTransaction.appCreateMethodCall(await this.params.create(params))\n    },\n  }\n\n  /** Send transactions to the current app */\n  readonly send = {\n    /** Send bare (raw) transactions for the current app */\n    bare: {\n      /**\n       * Creates an instance of the app using a bare (raw) create call and returns the result\n       * of the creation transaction and an app client to interact with that app instance.\n       *\n       * Performs deploy-time TEAL template placeholder substitutions (if specified).\n       * @param params The parameters to create the app\n       * @returns The app client and the result of the creation transaction\n       */\n      create: async (params?: AppFactoryCreateParams & SendParams) => {\n        const updatable = params?.updatable ?? this._updatable\n        const deletable = params?.deletable ?? this._deletable\n        const deployTimeParams = params?.deployTimeParams ?? this._deployTimeParams\n        const compiled = await this.compile({ deployTimeParams, updatable, deletable })\n        const result = await this.handleCallErrors(async () => ({\n          ...(await this._algorand.send.appCreate(await this.params.bare.create({ ...params, updatable, deletable, deployTimeParams }))),\n          return: undefined,\n        }))\n        return {\n          appClient: this.getAppClientById({\n            appId: result.appId,\n          }),\n          result: {\n            ...result,\n            ...(compiled as Partial<AppCompilationResult>),\n          },\n        }\n      },\n    },\n\n    /**\n     * Creates an instance of the app and returns the result of the creation\n     * transaction and an app client to interact with that app instance.\n     *\n     * Performs deploy-time TEAL template placeholder substitutions (if specified).\n     * @param params The parameters to create the app\n     * @returns The app client and the result of the creation transaction\n     */\n    create: async (params: AppFactoryCreateMethodCallParams & SendParams) => {\n      const updatable = params?.updatable ?? this._updatable\n      const deletable = params?.deletable ?? this._deletable\n      const deployTimeParams = params?.deployTimeParams ?? this._deployTimeParams\n      const compiled = await this.compile({ deployTimeParams, updatable, deletable })\n      const result = await this.handleCallErrors(async () => {\n        const result = await this._algorand.send.appCreateMethodCall(\n          await this.params.create({ ...params, updatable, deletable, deployTimeParams }),\n        )\n        return {\n          ...result,\n          return: result.return?.returnValue,\n        }\n      })\n      return {\n        appClient: this.getAppClientById({\n          appId: result.appId,\n        }),\n        result: {\n          ...result,\n          ...(compiled as Partial<AppCompilationResult>),\n        },\n      }\n    },\n  }\n\n  /**\n   * Idempotently deploy (create if not exists, update if changed) an app against the given name for the given creator account, including deploy-time TEAL template placeholder substitutions (if specified).\n   *\n   * **Note:** When using the return from this function be sure to check `operationPerformed` to get access to various return properties like `transaction`, `confirmation` and `deleteResult`.\n   *\n   * **Note:** if there is a breaking state schema change to an existing app (and `onSchemaBreak` is set to `'replace'`) the existing app will be deleted and re-created.\n   *\n   * **Note:** if there is an update (different TEAL code) to an existing app (and `onUpdate` is set to `'replace'`) the existing app will be deleted and re-created.\n   * @param params The arguments to control the app deployment\n   * @returns The app client and the result of the deployment\n   * @example\n   * ```ts\n   * const { appClient, result } = await factory.deploy({\n   *   createParams: {\n   *     sender: 'SENDER_ADDRESS',\n   *     approvalProgram: 'APPROVAL PROGRAM',\n   *     clearStateProgram: 'CLEAR PROGRAM',\n   *     schema: {\n   *       globalByteSlices: 0,\n   *       globalInts: 0,\n   *       localByteSlices: 0,\n   *       localInts: 0\n   *     }\n   *   },\n   *   updateParams: {\n   *     sender: 'SENDER_ADDRESS'\n   *   },\n   *   deleteParams: {\n   *     sender: 'SENDER_ADDRESS'\n   *   },\n   *   onSchemaBreak: 'append',\n   *   onUpdate: 'append'\n   *  })\n   * ```\n   */\n  public async deploy(params: AppFactoryDeployParams) {\n    const updatable = params.updatable ?? this._updatable ?? this.getDeployTimeControl('updatable')\n    const deletable = params.deletable ?? this._deletable ?? this.getDeployTimeControl('deletable')\n    const deployTimeParams = params.deployTimeParams ?? this._deployTimeParams\n\n    // Compile using a appID 0 AppClient so we can register the error handler and use the programs\n    // to identify the app within the error handler (because we can't use app ID 0)\n    const tempAppClient = this.getAppClientById({ appId: 0n })\n    const compiled = await tempAppClient.compile({ deployTimeParams, updatable, deletable })\n\n    const deployResult = await this._algorand.appDeployer.deploy({\n      ...params,\n      createParams: await (params.createParams && 'method' in params.createParams\n        ? this.params.create({ ...params.createParams, updatable, deletable, deployTimeParams })\n        : this.params.bare.create({ ...params.createParams, updatable, deletable, deployTimeParams })),\n      updateParams:\n        params.updateParams && 'method' in params.updateParams\n          ? this.params.deployUpdate(params.updateParams)\n          : this.params.bare.deployUpdate(params.updateParams),\n      deleteParams:\n        params.deleteParams && 'method' in params.deleteParams\n          ? this.params.deployDelete(params.deleteParams)\n          : this.params.bare.deployDelete(params.deleteParams),\n      metadata: {\n        name: params.appName ?? this._appName,\n        version: this._version,\n        updatable,\n        deletable,\n      },\n    })\n    const appClient = this.getAppClientById({\n      appId: deployResult.appId,\n      appName: params.appName,\n    })\n    const result = {\n      ...deployResult,\n      ...(compiled as Partial<AppCompilationResult>),\n    }\n    return {\n      appClient,\n      result: {\n        ...result,\n        return:\n          'return' in result\n            ? result.operationPerformed === 'update'\n              ? params.updateParams && 'method' in params.updateParams\n                ? result.return?.returnValue\n                : undefined\n              : params.createParams && 'method' in params.createParams\n                ? result.return?.returnValue\n                : undefined\n            : undefined,\n        deleteReturn:\n          'deleteReturn' in result && params.deleteParams && 'method' in params.deleteParams ? result.deleteReturn?.returnValue : undefined,\n      },\n    }\n  }\n\n  /**\n   * Returns a new `AppClient` client for an app instance of the given ID.\n   *\n   * Automatically populates appName, defaultSender and source maps from the factory\n   * if not specified in the params.\n   * @param params The parameters to create the app client\n   * @returns The `AppClient` instance\n   * @example\n   * ```typescript\n   * const appClient = factory.getAppClientById({ appId: 12345n })\n   * ```\n   */\n  public getAppClientById(params: AppFactoryAppClientParams) {\n    return new AppClient({\n      ...params,\n      algorand: this._algorand,\n      appSpec: this._appSpec,\n      appName: params.appName ?? this._appName,\n      defaultSender: params.defaultSender ?? this._defaultSender,\n      defaultSigner: params.defaultSigner ?? this._defaultSigner,\n      approvalSourceMap: params.approvalSourceMap ?? this._approvalSourceMap,\n      clearSourceMap: params.clearSourceMap ?? this._clearSourceMap,\n    })\n  }\n\n  /**\n   * Returns a new `AppClient` client, resolving the app by creator address and name\n   * using AlgoKit app deployment semantics (i.e. looking for the app creation transaction note).\n   *\n   * Automatically populates appName, defaultSender and source maps from the factory\n   * if not specified in the params.\n   * @param params The parameters to create the app client\n   * @returns The `AppClient` instance\n   * @example\n   * ```typescript\n   * const appClient = factory.getAppClientByCreatorAndName({ creatorAddress: 'CREATOR_ADDRESS', appName: 'my_app' })\n   * ```\n   */\n  public getAppClientByCreatorAndName(params: AppFactoryResolveAppClientByCreatorAndNameParams) {\n    return AppClient.fromCreatorAndName({\n      ...params,\n      algorand: this._algorand,\n      appSpec: this._appSpec,\n      appName: params.appName ?? this._appName,\n      defaultSender: params.defaultSender ?? this._defaultSender,\n      approvalSourceMap: params.approvalSourceMap ?? this._approvalSourceMap,\n      clearSourceMap: params.clearSourceMap ?? this._clearSourceMap,\n    })\n  }\n\n  /**\n   * Takes an error that may include a logic error from a call to the current app and re-exposes the\n   * error to include source code information via the source map and ARC-56 spec.\n   * @param e The error to parse\n   * @param isClearStateProgram Whether or not the code was running the clear state program (defaults to approval program)\n   * @returns The new error, or if there was no logic error or source map then the wrapped error with source details\n   */\n  exposeLogicError(e: Error, isClearStateProgram?: boolean): Error {\n    return AppClient.exposeLogicError(e, this._appSpec, {\n      isClearStateProgram,\n      approvalSourceMap: this._approvalSourceMap,\n      clearSourceMap: this._clearSourceMap,\n    })\n  }\n\n  /**\n   * Export the current source maps for the app.\n   * @returns The source maps\n   */\n  exportSourceMaps(): AppSourceMaps {\n    if (!this._approvalSourceMap || !this._clearSourceMap) {\n      throw new Error(\n        \"Unable to export source maps; they haven't been loaded into this client - you need to call create, update, or deploy first\",\n      )\n    }\n\n    return {\n      approvalSourceMap: this._approvalSourceMap,\n      clearSourceMap: this._clearSourceMap,\n    }\n  }\n\n  /**\n   * Import source maps for the app.\n   * @param sourceMaps The source maps to import\n   */\n  importSourceMaps(sourceMaps: AppSourceMaps) {\n    this._approvalSourceMap = new ProgramSourceMap(sourceMaps.approvalSourceMap)\n    this._clearSourceMap = new ProgramSourceMap(sourceMaps.clearSourceMap)\n  }\n\n  private getDeployTimeControl(control: 'updatable' | 'deletable'): boolean | undefined {\n    const approval = this._appSpec.source?.approval ? Buffer.from(this._appSpec.source.approval, 'base64').toString('utf-8') : undefined\n    // variable not present, so unknown control value\n    if (!approval || !approval.includes(control === 'updatable' ? UPDATABLE_TEMPLATE_NAME : DELETABLE_TEMPLATE_NAME)) return undefined\n\n    // A call is present and configured\n    return (\n      this._appSpec.bareActions.call.includes(control === 'updatable' ? 'UpdateApplication' : 'DeleteApplication') ||\n      Object.values(this._appSpec.methods).some((c) =>\n        c.actions.call.includes(control === 'updatable' ? 'UpdateApplication' : 'DeleteApplication'),\n      )\n    )\n  }\n\n  private getParamsMethods() {\n    return {\n      /** Return params for a create ABI call, including deploy-time TEAL template replacements and compilation if provided */\n      create: async (params: AppFactoryCreateMethodCallParams) => {\n        const compiled = await this.compile({ ...params, deployTimeParams: params.deployTimeParams ?? this._deployTimeParams })\n        return this.getABIParams(\n          {\n            ...params,\n            deployTimeParams: params.deployTimeParams ?? this._deployTimeParams,\n            schema: params.schema ?? {\n              globalByteSlices: this._appSpec.state.schema.global.bytes,\n              globalInts: this._appSpec.state.schema.global.ints,\n              localByteSlices: this._appSpec.state.schema.local.bytes,\n              localInts: this._appSpec.state.schema.local.ints,\n            },\n            approvalProgram: compiled.approvalProgram,\n            clearStateProgram: compiled.clearStateProgram,\n          },\n          params.onComplete ?? OnApplicationComplete.NoOp,\n        ) satisfies AppCreateMethodCall\n      },\n      /** Return params for a deployment update ABI call */\n      deployUpdate: (params: AppClientMethodCallParams) => {\n        return this.getABIParams(params, OnApplicationComplete.UpdateApplication) satisfies DeployAppUpdateMethodCall\n      },\n      /** Return params for a deployment delete ABI call */\n      deployDelete: (params: AppClientMethodCallParams) => {\n        return this.getABIParams(params, OnApplicationComplete.DeleteApplication) satisfies DeployAppDeleteMethodCall\n      },\n      bare: {\n        /** Return params for a create bare call, including deploy-time TEAL template replacements and compilation if provided */\n        create: async (params?: AppFactoryCreateParams) => {\n          return this.getBareParams(\n            {\n              ...params,\n              deployTimeParams: params?.deployTimeParams ?? this._deployTimeParams,\n              schema: params?.schema ?? {\n                globalByteSlices: this._appSpec.state.schema.global.bytes,\n                globalInts: this._appSpec.state.schema.global.ints,\n                localByteSlices: this._appSpec.state.schema.local.bytes,\n                localInts: this._appSpec.state.schema.local.ints,\n              },\n              ...(await this.compile({ ...params, deployTimeParams: params?.deployTimeParams ?? this._deployTimeParams })),\n            },\n            params?.onComplete ?? OnApplicationComplete.NoOp,\n          ) satisfies AppCreateParams\n        },\n        /** Return params for a deployment update bare call */\n        deployUpdate: (params?: AppClientBareCallParams) => {\n          return this.getBareParams(params, OnApplicationComplete.UpdateApplication) satisfies DeployAppUpdateParams\n        },\n        /** Return params for a deployment delete bare call */\n        deployDelete: (params?: AppClientBareCallParams) => {\n          return this.getBareParams(params, OnApplicationComplete.DeleteApplication) satisfies DeployAppDeleteParams\n        },\n      },\n    }\n  }\n\n  /** Make the given call and catch any errors, augmenting with debugging information before re-throwing. */\n  private async handleCallErrors<TResult>(call: () => Promise<TResult>) {\n    try {\n      return await call()\n    } catch (e) {\n      throw this.exposeLogicError(e as Error)\n    }\n  }\n\n  /**\n   * Compiles the approval and clear state programs (if TEAL templates provided),\n   * performing any provided deploy-time parameter replacement and stores\n   * the source maps.\n   *\n   * If no TEAL templates provided it will use any byte code provided in the app spec.\n   *\n   * Will store any generated source maps for later use in debugging.\n   * @param compilation Optional compilation parameters to use for the compilation\n   * @returns The compilation result\n   * @example\n   * ```typescript\n   * const result = await factory.compile()\n   * ```\n   */\n  public async compile(compilation?: AppClientCompilationParams) {\n    const result = await AppClient.compile(this._appSpec, this._algorand.app, compilation)\n\n    if (result.compiledApproval) {\n      this._approvalSourceMap = result.compiledApproval.sourceMap\n    }\n    if (result.compiledClear) {\n      this._clearSourceMap = result.compiledClear.sourceMap\n    }\n\n    return result\n  }\n\n  private getBareParams<\n    TParams extends { sender?: ReadableAddress; signer?: TransactionSigner | AddressWithTransactionSigner } | undefined,\n    TOnComplete extends OnApplicationComplete,\n  >(params: TParams, onComplete: TOnComplete) {\n    return {\n      ...params,\n      sender: this.getSender(params?.sender),\n      signer: this.getSigner(params?.sender, params?.signer),\n      onComplete,\n    }\n  }\n\n  private getABIParams<\n    TParams extends {\n      method: string\n      sender?: ReadableAddress\n      signer?: TransactionSigner | AddressWithTransactionSigner\n      args?: AppClientMethodCallParams['args']\n    },\n    TOnComplete extends OnApplicationComplete,\n  >(params: TParams, onComplete: TOnComplete) {\n    return {\n      ...params,\n      sender: this.getSender(params.sender),\n      signer: this.getSigner(params.sender, params.signer),\n      method: getABIMethod(params.method, this._appSpec),\n      args: this.getCreateABIArgsWithDefaultValues(params.method, params.args),\n      onComplete,\n    }\n  }\n\n  private getCreateABIArgsWithDefaultValues(\n    methodNameOrSignature: string,\n    args: AppClientMethodCallParams['args'] | undefined,\n  ): AppMethodCall<CommonAppCallParams>['args'] {\n    const m = getABIMethod(methodNameOrSignature, this._appSpec)\n    return args?.map((arg, i) => {\n      const methodArg = m.args[i]\n      if (arg !== undefined) {\n        return arg\n      }\n      if (argTypeIsTransaction(methodArg.type)) {\n        return arg\n      }\n      const defaultValue = methodArg.defaultValue\n      if (defaultValue) {\n        switch (defaultValue.source) {\n          case 'literal': {\n            const bytes = Buffer.from(defaultValue.data, 'base64')\n            const value_type = defaultValue.type ?? methodArg.type\n            return getABIDecodedValue(value_type, bytes)\n          }\n          default:\n            throw new Error(`Can't provide default value for ${defaultValue.source} for a contract creation call`)\n        }\n      }\n      throw new Error(`No value provided for required argument ${methodArg.name ?? `arg${i + 1}`} in call to method ${m.name}`)\n    })\n  }\n\n  /** Returns the sender for a call, using the `defaultSender`\n   * if none provided and throws an error if neither provided */\n  private getSender(sender: ReadableAddress | undefined): Address {\n    if (!sender && !this._defaultSender) {\n      throw new Error(`No sender provided and no default sender present in app factory for call to app ${this._appName}`)\n    }\n    return getAddress(sender ?? this._defaultSender!)\n  }\n\n  /** Returns the signer for a call, using the provided signer or the `defaultSigner`\n   * if no signer was provided and the sender resolves to the default sender, the call will use default signer\n   * or `undefined` otherwise (so the signer is resolved from `AlgorandClient`) */\n  private getSigner(\n    sender: ReadableAddress | undefined,\n    signer: TransactionSigner | AddressWithTransactionSigner | undefined,\n  ): TransactionSigner | AddressWithTransactionSigner | undefined {\n    return signer ?? (!sender || sender === this._defaultSender ? this._defaultSigner : undefined)\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAuJA,IAAa,aAAb,MAAwB;CACtB,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;CAER,AAAQ;CACR,AAAQ;CAER,AAAQ;;;;;;;;;;;;CAaR,YAAY,QAA0B;AACpC,OAAK,WAAW,UAAU,iBAAiB,OAAO,QAAQ;AAC1D,OAAK,WAAW,OAAO,WAAW,KAAK,SAAS;AAChD,OAAK,YAAY,OAAO;AACxB,OAAK,WAAW,OAAO,WAAW;AAClC,OAAK,iBAAiB,mBAAmB,OAAO,cAAc;AAC9D,OAAK,iBAAiB,OAAO;AAC7B,OAAK,oBAAoB,OAAO;AAChC,OAAK,aAAa,OAAO;AACzB,OAAK,aAAa,OAAO;AACzB,OAAK,iBAAiB,KAAK,kBAAkB;;;CAI/C,IAAW,UAAU;AACnB,SAAO,KAAK;;;CAId,IAAI,UAAU;AACZ,SAAO,KAAK;;;CAId,IAAI,WAAW;AACb,SAAO,KAAK;;;;;;;;;;;;;;;;;CAkBd,IAAI,SAAS;AACX,SAAO,KAAK;;;CAId,AAAS,oBAAoB;EAE3B,MAAM,EAQJ,QAAQ,OAAO,WAAoC;AACjD,UAAO,KAAK,UAAU,kBAAkB,UAAU,MAAM,KAAK,OAAO,KAAK,OAAO,OAAO,CAAC;KAE3F;EASD,QAAQ,OAAO,WAA6C;AAC1D,UAAO,KAAK,UAAU,kBAAkB,oBAAoB,MAAM,KAAK,OAAO,OAAO,OAAO,CAAC;;EAEhG;;CAGD,AAAS,OAAO;EAEd,MAAM,EASJ,QAAQ,OAAO,WAAiD;GAC9D,MAAM,YAAY,QAAQ,aAAa,KAAK;GAC5C,MAAM,YAAY,QAAQ,aAAa,KAAK;GAC5C,MAAM,mBAAmB,QAAQ,oBAAoB,KAAK;GAC1D,MAAM,WAAW,MAAM,KAAK,QAAQ;IAAE;IAAkB;IAAW;IAAW,CAAC;GAC/E,MAAM,SAAS,MAAM,KAAK,iBAAiB,aAAa;IACtD,GAAI,MAAM,KAAK,UAAU,KAAK,UAAU,MAAM,KAAK,OAAO,KAAK,OAAO;KAAE,GAAG;KAAQ;KAAW;KAAW;KAAkB,CAAC,CAAC;IAC7H,QAAQ;IACT,EAAE;AACH,UAAO;IACL,WAAW,KAAK,iBAAiB,EAC/B,OAAO,OAAO,OACf,CAAC;IACF,QAAQ;KACN,GAAG;KACH,GAAI;KACL;IACF;KAEJ;EAUD,QAAQ,OAAO,WAA0D;GACvE,MAAM,YAAY,QAAQ,aAAa,KAAK;GAC5C,MAAM,YAAY,QAAQ,aAAa,KAAK;GAC5C,MAAM,mBAAmB,QAAQ,oBAAoB,KAAK;GAC1D,MAAM,WAAW,MAAM,KAAK,QAAQ;IAAE;IAAkB;IAAW;IAAW,CAAC;GAC/E,MAAM,SAAS,MAAM,KAAK,iBAAiB,YAAY;IACrD,MAAMA,WAAS,MAAM,KAAK,UAAU,KAAK,oBACvC,MAAM,KAAK,OAAO,OAAO;KAAE,GAAG;KAAQ;KAAW;KAAW;KAAkB,CAAC,CAChF;AACD,WAAO;KACL,GAAGA;KACH,QAAQA,SAAO,QAAQ;KACxB;KACD;AACF,UAAO;IACL,WAAW,KAAK,iBAAiB,EAC/B,OAAO,OAAO,OACf,CAAC;IACF,QAAQ;KACN,GAAG;KACH,GAAI;KACL;IACF;;EAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCD,MAAa,OAAO,QAAgC;EAClD,MAAM,YAAY,OAAO,aAAa,KAAK,cAAc,KAAK,qBAAqB,YAAY;EAC/F,MAAM,YAAY,OAAO,aAAa,KAAK,cAAc,KAAK,qBAAqB,YAAY;EAC/F,MAAM,mBAAmB,OAAO,oBAAoB,KAAK;EAKzD,MAAM,WAAW,MADK,KAAK,iBAAiB,EAAE,OAAO,IAAI,CAAC,CACrB,QAAQ;GAAE;GAAkB;GAAW;GAAW,CAAC;EAExF,MAAM,eAAe,MAAM,KAAK,UAAU,YAAY,OAAO;GAC3D,GAAG;GACH,cAAc,OAAO,OAAO,gBAAgB,YAAY,OAAO,eAC3D,KAAK,OAAO,OAAO;IAAE,GAAG,OAAO;IAAc;IAAW;IAAW;IAAkB,CAAC,GACtF,KAAK,OAAO,KAAK,OAAO;IAAE,GAAG,OAAO;IAAc;IAAW;IAAW;IAAkB,CAAC;GAC/F,cACE,OAAO,gBAAgB,YAAY,OAAO,eACtC,KAAK,OAAO,aAAa,OAAO,aAAa,GAC7C,KAAK,OAAO,KAAK,aAAa,OAAO,aAAa;GACxD,cACE,OAAO,gBAAgB,YAAY,OAAO,eACtC,KAAK,OAAO,aAAa,OAAO,aAAa,GAC7C,KAAK,OAAO,KAAK,aAAa,OAAO,aAAa;GACxD,UAAU;IACR,MAAM,OAAO,WAAW,KAAK;IAC7B,SAAS,KAAK;IACd;IACA;IACD;GACF,CAAC;EACF,MAAM,YAAY,KAAK,iBAAiB;GACtC,OAAO,aAAa;GACpB,SAAS,OAAO;GACjB,CAAC;EACF,MAAM,SAAS;GACb,GAAG;GACH,GAAI;GACL;AACD,SAAO;GACL;GACA,QAAQ;IACN,GAAG;IACH,QACE,YAAY,SACR,OAAO,uBAAuB,WAC5B,OAAO,gBAAgB,YAAY,OAAO,eACxC,OAAO,QAAQ,cACf,SACF,OAAO,gBAAgB,YAAY,OAAO,eACxC,OAAO,QAAQ,cACf,SACJ;IACN,cACE,kBAAkB,UAAU,OAAO,gBAAgB,YAAY,OAAO,eAAe,OAAO,cAAc,cAAc;IAC3H;GACF;;;;;;;;;;;;;;CAeH,AAAO,iBAAiB,QAAmC;AACzD,SAAO,IAAI,UAAU;GACnB,GAAG;GACH,UAAU,KAAK;GACf,SAAS,KAAK;GACd,SAAS,OAAO,WAAW,KAAK;GAChC,eAAe,OAAO,iBAAiB,KAAK;GAC5C,eAAe,OAAO,iBAAiB,KAAK;GAC5C,mBAAmB,OAAO,qBAAqB,KAAK;GACpD,gBAAgB,OAAO,kBAAkB,KAAK;GAC/C,CAAC;;;;;;;;;;;;;;;CAgBJ,AAAO,6BAA6B,QAA0D;AAC5F,SAAO,UAAU,mBAAmB;GAClC,GAAG;GACH,UAAU,KAAK;GACf,SAAS,KAAK;GACd,SAAS,OAAO,WAAW,KAAK;GAChC,eAAe,OAAO,iBAAiB,KAAK;GAC5C,mBAAmB,OAAO,qBAAqB,KAAK;GACpD,gBAAgB,OAAO,kBAAkB,KAAK;GAC/C,CAAC;;;;;;;;;CAUJ,iBAAiB,GAAU,qBAAsC;AAC/D,SAAO,UAAU,iBAAiB,GAAG,KAAK,UAAU;GAClD;GACA,mBAAmB,KAAK;GACxB,gBAAgB,KAAK;GACtB,CAAC;;;;;;CAOJ,mBAAkC;AAChC,MAAI,CAAC,KAAK,sBAAsB,CAAC,KAAK,gBACpC,OAAM,IAAI,MACR,6HACD;AAGH,SAAO;GACL,mBAAmB,KAAK;GACxB,gBAAgB,KAAK;GACtB;;;;;;CAOH,iBAAiB,YAA2B;AAC1C,OAAK,qBAAqB,IAAI,iBAAiB,WAAW,kBAAkB;AAC5E,OAAK,kBAAkB,IAAI,iBAAiB,WAAW,eAAe;;CAGxE,AAAQ,qBAAqB,SAAyD;EACpF,MAAM,WAAW,KAAK,SAAS,QAAQ,WAAW,OAAO,KAAK,KAAK,SAAS,OAAO,UAAU,SAAS,CAAC,SAAS,QAAQ,GAAG;AAE3H,MAAI,CAAC,YAAY,CAAC,SAAS,SAAS,YAAY,cAAc,0BAA0B,wBAAwB,CAAE,QAAO;AAGzH,SACE,KAAK,SAAS,YAAY,KAAK,SAAS,YAAY,cAAc,sBAAsB,oBAAoB,IAC5G,OAAO,OAAO,KAAK,SAAS,QAAQ,CAAC,MAAM,MACzC,EAAE,QAAQ,KAAK,SAAS,YAAY,cAAc,sBAAsB,oBAAoB,CAC7F;;CAIL,AAAQ,mBAAmB;AACzB,SAAO;GAEL,QAAQ,OAAO,WAA6C;IAC1D,MAAM,WAAW,MAAM,KAAK,QAAQ;KAAE,GAAG;KAAQ,kBAAkB,OAAO,oBAAoB,KAAK;KAAmB,CAAC;AACvH,WAAO,KAAK,aACV;KACE,GAAG;KACH,kBAAkB,OAAO,oBAAoB,KAAK;KAClD,QAAQ,OAAO,UAAU;MACvB,kBAAkB,KAAK,SAAS,MAAM,OAAO,OAAO;MACpD,YAAY,KAAK,SAAS,MAAM,OAAO,OAAO;MAC9C,iBAAiB,KAAK,SAAS,MAAM,OAAO,MAAM;MAClD,WAAW,KAAK,SAAS,MAAM,OAAO,MAAM;MAC7C;KACD,iBAAiB,SAAS;KAC1B,mBAAmB,SAAS;KAC7B,EACD,OAAO,cAAc,sBAAsB,KAC5C;;GAGH,eAAe,WAAsC;AACnD,WAAO,KAAK,aAAa,QAAQ,sBAAsB,kBAAkB;;GAG3E,eAAe,WAAsC;AACnD,WAAO,KAAK,aAAa,QAAQ,sBAAsB,kBAAkB;;GAE3E,MAAM;IAEJ,QAAQ,OAAO,WAAoC;AACjD,YAAO,KAAK,cACV;MACE,GAAG;MACH,kBAAkB,QAAQ,oBAAoB,KAAK;MACnD,QAAQ,QAAQ,UAAU;OACxB,kBAAkB,KAAK,SAAS,MAAM,OAAO,OAAO;OACpD,YAAY,KAAK,SAAS,MAAM,OAAO,OAAO;OAC9C,iBAAiB,KAAK,SAAS,MAAM,OAAO,MAAM;OAClD,WAAW,KAAK,SAAS,MAAM,OAAO,MAAM;OAC7C;MACD,GAAI,MAAM,KAAK,QAAQ;OAAE,GAAG;OAAQ,kBAAkB,QAAQ,oBAAoB,KAAK;OAAmB,CAAC;MAC5G,EACD,QAAQ,cAAc,sBAAsB,KAC7C;;IAGH,eAAe,WAAqC;AAClD,YAAO,KAAK,cAAc,QAAQ,sBAAsB,kBAAkB;;IAG5E,eAAe,WAAqC;AAClD,YAAO,KAAK,cAAc,QAAQ,sBAAsB,kBAAkB;;IAE7E;GACF;;;CAIH,MAAc,iBAA0B,MAA8B;AACpE,MAAI;AACF,UAAO,MAAM,MAAM;WACZ,GAAG;AACV,SAAM,KAAK,iBAAiB,EAAW;;;;;;;;;;;;;;;;;;CAmB3C,MAAa,QAAQ,aAA0C;EAC7D,MAAM,SAAS,MAAM,UAAU,QAAQ,KAAK,UAAU,KAAK,UAAU,KAAK,YAAY;AAEtF,MAAI,OAAO,iBACT,MAAK,qBAAqB,OAAO,iBAAiB;AAEpD,MAAI,OAAO,cACT,MAAK,kBAAkB,OAAO,cAAc;AAG9C,SAAO;;CAGT,AAAQ,cAGN,QAAiB,YAAyB;AAC1C,SAAO;GACL,GAAG;GACH,QAAQ,KAAK,UAAU,QAAQ,OAAO;GACtC,QAAQ,KAAK,UAAU,QAAQ,QAAQ,QAAQ,OAAO;GACtD;GACD;;CAGH,AAAQ,aAQN,QAAiB,YAAyB;AAC1C,SAAO;GACL,GAAG;GACH,QAAQ,KAAK,UAAU,OAAO,OAAO;GACrC,QAAQ,KAAK,UAAU,OAAO,QAAQ,OAAO,OAAO;GACpD,QAAQ,aAAa,OAAO,QAAQ,KAAK,SAAS;GAClD,MAAM,KAAK,kCAAkC,OAAO,QAAQ,OAAO,KAAK;GACxE;GACD;;CAGH,AAAQ,kCACN,uBACA,MAC4C;EAC5C,MAAM,IAAI,aAAa,uBAAuB,KAAK,SAAS;AAC5D,SAAO,MAAM,KAAK,KAAK,MAAM;GAC3B,MAAM,YAAY,EAAE,KAAK;AACzB,OAAI,QAAQ,OACV,QAAO;AAET,OAAI,qBAAqB,UAAU,KAAK,CACtC,QAAO;GAET,MAAM,eAAe,UAAU;AAC/B,OAAI,aACF,SAAQ,aAAa,QAArB;IACE,KAAK,WAAW;KACd,MAAM,QAAQ,OAAO,KAAK,aAAa,MAAM,SAAS;AAEtD,YAAO,mBADY,aAAa,QAAQ,UAAU,MACZ,MAAM;;IAE9C,QACE,OAAM,IAAI,MAAM,mCAAmC,aAAa,OAAO,+BAA+B;;AAG5G,SAAM,IAAI,MAAM,2CAA2C,UAAU,QAAQ,MAAM,IAAI,IAAI,qBAAqB,EAAE,OAAO;IACzH;;;;CAKJ,AAAQ,UAAU,QAA8C;AAC9D,MAAI,CAAC,UAAU,CAAC,KAAK,eACnB,OAAM,IAAI,MAAM,mFAAmF,KAAK,WAAW;AAErH,SAAO,WAAW,UAAU,KAAK,eAAgB;;;;;CAMnD,AAAQ,UACN,QACA,QAC8D;AAC9D,SAAO,WAAW,CAAC,UAAU,WAAW,KAAK,iBAAiB,KAAK,iBAAiB"}
+{"version":3,"file":"app-factory.mjs","names":["result"],"sources":["../../src/types/app-factory.ts"],"sourcesContent":["import { Arc56Contract, argTypeIsTransaction, getABIDecodedValue, getABIMethod } from '@algorandfoundation/algokit-abi'\nimport { Address, Expand, ReadableAddress, getAddress, getOptionalAddress } from '@algorandfoundation/algokit-common'\nimport { AddressWithTransactionSigner, OnApplicationComplete, TransactionSigner } from '@algorandfoundation/algokit-transact'\nimport { ProgramSourceMap } from '@algorandfoundation/sdk'\nimport { type AlgorandClient } from './algorand-client'\nimport { AppCompilationResult, DELETABLE_TEMPLATE_NAME, TealTemplateParams, UPDATABLE_TEMPLATE_NAME } from './app'\nimport {\n  AppClient,\n  AppClientBareCallParams,\n  AppClientCompilationParams,\n  AppClientMethodCallParams,\n  AppClientParams,\n  AppSourceMaps,\n  ResolveAppClientByCreatorAndName,\n} from './app-client'\nimport {\n  AppDeployParams,\n  DeployAppDeleteMethodCall,\n  DeployAppDeleteParams,\n  DeployAppUpdateMethodCall,\n  DeployAppUpdateParams,\n} from './app-deployer'\nimport { AppSpec } from './app-spec'\nimport { AppCreateMethodCall, AppCreateParams, AppMethodCall, CommonAppCallParams } from './composer'\nimport { SendParams } from './transaction'\n\n/** Parameters to create an app client */\nexport interface AppFactoryParams {\n  /** The ARC-56 or ARC-32 application spec as either:\n   *  * Parsed JSON ARC-56 `Contract`\n   *  * Parsed JSON ARC-32 `AppSpec`\n   *  * Raw JSON string (in either ARC-56 or ARC-32 format)\n   */\n  appSpec: Arc56Contract | AppSpec | string\n\n  /** `AlgorandClient` instance */\n  algorand: AlgorandClient\n\n  /**\n   * Optional override for the app name; used for on-chain metadata and lookups.\n   * Defaults to the ARC-32/ARC-56 app spec name.\n   */\n  appName?: string\n\n  /** Optional address to use for the account to use as the default sender for calls. */\n  defaultSender?: ReadableAddress\n\n  /** Optional signer to use as the default signer for default sender calls (if not specified then the signer will be resolved from `AlgorandClient`). */\n  defaultSigner?: TransactionSigner\n\n  /** The version of app that is / will be deployed; defaults to 1.0 */\n  version?: string\n\n  /**\n   * Whether or not the contract should have deploy-time immutability control set, undefined = ignore.\n   * If specified here will get used in calls to `deploy` and `create` calls unless overridden in those calls.\n   *\n   * Useful if you want to vend multiple contracts from the same factory without specifying this value\n   * for each call.\n   */\n  updatable?: boolean\n\n  /**\n   * Whether or not the contract should have deploy-time permanence control set, undefined = ignore.\n   * If specified here will get used in calls to `deploy` and `create` calls unless overridden in those calls.\n   *\n   * Useful if you want to vend multiple contracts from the same factory without specifying this value\n   * for each call.\n   */\n  deletable?: boolean\n\n  /**\n   * Optional deploy-time TEAL template replacement parameters.\n   * If specified here will get used in calls to `deploy` and `create` calls unless overridden in those calls.\n   *\n   * Useful if you want to vend multiple contracts from the same factory without specifying this value\n   * for each call.\n   */\n  deployTimeParams?: TealTemplateParams\n}\n\n/** onComplete parameter for a create app call */\nexport type CreateOnComplete = {\n  onComplete?: Exclude<OnApplicationComplete, OnApplicationComplete.ClearState>\n}\n\n/** Specifies a schema used for creating an app */\nexport type CreateSchema = {\n  /** The state schema for the app. This is immutable once the app is created. By default uses the ARC32/ARC-56 spec. */\n  schema?: {\n    /** The number of integers saved in global state. */\n    globalInts: number\n    /** The number of byte slices saved in global state. */\n    globalByteSlices: number\n    /** The number of integers saved in local state. */\n    localInts: number\n    /** The number of byte slices saved in local state. */\n    localByteSlices: number\n  }\n  /** Number of extra pages required for the programs.\n   * Defaults to the number needed for the programs in this call if not specified.\n   * This is immutable once the app is created. */\n  extraProgramPages?: number\n}\n\n/** Params to specify a bare (raw) create call for an app */\nexport type AppFactoryCreateParams = Expand<AppClientBareCallParams & AppClientCompilationParams & CreateOnComplete & CreateSchema>\n\n/** Params to specify a create method call for an app */\nexport type AppFactoryCreateMethodCallParams = Expand<\n  AppClientMethodCallParams & AppClientCompilationParams & CreateOnComplete & CreateSchema\n>\n\n/** Params to get an app client by ID from an app factory. */\nexport type AppFactoryAppClientParams = Expand<Omit<AppClientParams, 'algorand' | 'appSpec'>>\n\n/** Params to get an app client by creator address and name from an app factory. */\nexport type AppFactoryResolveAppClientByCreatorAndNameParams = Expand<Omit<ResolveAppClientByCreatorAndName, 'algorand' | 'appSpec'>>\n\n/** Parameters to define a deployment for an `AppFactory` */\nexport type AppFactoryDeployParams = Expand<\n  Omit<AppDeployParams, 'createParams' | 'updateParams' | 'deleteParams' | 'metadata'> & {\n    /** Create transaction parameters to use if a create needs to be issued as part of deployment */\n    createParams?:\n      | Expand<AppClientMethodCallParams & CreateOnComplete & CreateSchema>\n      | Expand<AppClientBareCallParams & CreateOnComplete & CreateSchema>\n    /** Update transaction parameters to use if a create needs to be issued as part of deployment */\n    updateParams?: AppClientMethodCallParams | AppClientBareCallParams\n    /** Delete transaction parameters to use if a create needs to be issued as part of deployment */\n    deleteParams?: AppClientMethodCallParams | AppClientBareCallParams\n    /**\n     * Whether or not the contract should have deploy-time immutability control set.\n     * `undefined` = use AppFactory constructor value if set or base it on the app spec.\n     */\n    updatable?: boolean\n    /**\n     * Whether or not the contract should have deploy-time permanence control set.\n     * `undefined` = use AppFactory constructor value if set or base it on the app spec.\n     */\n    deletable?: boolean\n    /** Override the app name for this deployment */\n    appName?: string\n  }\n>\n\n/**\n * ARC-56/ARC-32 app factory that, for a given app spec, allows you to create\n * and deploy one or more app instances and to create one or more app clients\n * to interact with those (or other) app instances.\n */\nexport class AppFactory {\n  private _appSpec: Arc56Contract\n  private _appName: string\n  private _algorand: AlgorandClient\n  private _version: string\n  private _defaultSender?: Address\n  private _defaultSigner?: TransactionSigner\n  private _deployTimeParams?: TealTemplateParams\n  private _updatable?: boolean\n  private _deletable?: boolean\n\n  private _approvalSourceMap: ProgramSourceMap | undefined\n  private _clearSourceMap: ProgramSourceMap | undefined\n\n  private _paramsMethods: ReturnType<AppFactory['getParamsMethods']>\n\n  /**\n   * Create a new app factory.\n   * @param params The parameters to create the app factory\n   * @returns The `AppFactory` instance\n   * @example\n   * ```typescript\n   * const appFactory = new AppFactory({\n   *   appSpec: appSpec,\n   *   algorand: AlgorandClient.mainNet(),\n   * })\n   */\n  constructor(params: AppFactoryParams) {\n    this._appSpec = AppClient.normaliseAppSpec(params.appSpec)\n    this._appName = params.appName ?? this._appSpec.name\n    this._algorand = params.algorand\n    this._version = params.version ?? '1.0'\n    this._defaultSender = getOptionalAddress(params.defaultSender)\n    this._defaultSigner = params.defaultSigner\n    this._deployTimeParams = params.deployTimeParams\n    this._updatable = params.updatable\n    this._deletable = params.deletable\n    this._paramsMethods = this.getParamsMethods()\n  }\n\n  /** The name of the app (from the ARC-32 / ARC-56 app spec or override). */\n  public get appName() {\n    return this._appName\n  }\n\n  /** The ARC-56 app spec being used */\n  get appSpec() {\n    return this._appSpec\n  }\n\n  /** Return the algorand client this factory is using. */\n  get algorand() {\n    return this._algorand\n  }\n\n  /** Get parameters to create transactions (create and deploy related calls) for the current app.\n   *\n   * A good mental model for this is that these parameters represent a deferred transaction creation.\n   * @example Create a transaction in the future using Algorand Client\n   * ```typescript\n   * const createAppParams = appFactory.params.create({method: 'create_method', args: [123, 'hello']})\n   * // ...\n   * await algorand.send.AppCreateMethodCall(createAppParams)\n   * ```\n   * @example Define a nested transaction as an ABI argument\n   * ```typescript\n   * const createAppParams = appFactory.params.create({method: 'create_method', args: [123, 'hello']})\n   * await appClient.send.call({method: 'my_method', args: [createAppParams]})\n   * ```\n   */\n  get params() {\n    return this._paramsMethods\n  }\n\n  /** Create transactions for the current app */\n  readonly createTransaction = {\n    /** Create bare (raw) transactions for the current app */\n    bare: {\n      /**\n       * Create a create app call transaction using a bare (raw) create call.\n       *\n       * Performs deploy-time TEAL template placeholder substitutions (if specified).\n       * @param params The parameters to create the create call transaction\n       * @returns The create call transaction\n       */\n      create: async (params?: AppFactoryCreateParams) => {\n        return this._algorand.createTransaction.appCreate(await this.params.bare.create(params))\n      },\n    },\n\n    /**\n     * Create a create app call transaction using an ABI create call.\n     *\n     * Performs deploy-time TEAL template placeholder substitutions (if specified).\n     * @param params The parameters to create the create call transaction\n     * @returns The create call transaction\n     */\n    create: async (params: AppFactoryCreateMethodCallParams) => {\n      return this._algorand.createTransaction.appCreateMethodCall(await this.params.create(params))\n    },\n  }\n\n  /** Send transactions to the current app */\n  readonly send = {\n    /** Send bare (raw) transactions for the current app */\n    bare: {\n      /**\n       * Creates an instance of the app using a bare (raw) create call and returns the result\n       * of the creation transaction and an app client to interact with that app instance.\n       *\n       * Performs deploy-time TEAL template placeholder substitutions (if specified).\n       * @param params The parameters to create the app\n       * @returns The app client and the result of the creation transaction\n       */\n      create: async (params?: AppFactoryCreateParams & SendParams) => {\n        const updatable = params?.updatable ?? this._updatable\n        const deletable = params?.deletable ?? this._deletable\n        const deployTimeParams = params?.deployTimeParams ?? this._deployTimeParams\n        const compiled = await this.compile({ deployTimeParams, updatable, deletable })\n        const result = await this.handleCallErrors(async () => ({\n          ...(await this._algorand.send.appCreate(await this.params.bare.create({ ...params, updatable, deletable, deployTimeParams }))),\n          return: undefined,\n        }))\n        return {\n          appClient: this.getAppClientById({\n            appId: result.appId,\n          }),\n          result: {\n            ...result,\n            ...(compiled as Partial<AppCompilationResult>),\n          },\n        }\n      },\n    },\n\n    /**\n     * Creates an instance of the app and returns the result of the creation\n     * transaction and an app client to interact with that app instance.\n     *\n     * Performs deploy-time TEAL template placeholder substitutions (if specified).\n     * @param params The parameters to create the app\n     * @returns The app client and the result of the creation transaction\n     */\n    create: async (params: AppFactoryCreateMethodCallParams & SendParams) => {\n      const updatable = params?.updatable ?? this._updatable\n      const deletable = params?.deletable ?? this._deletable\n      const deployTimeParams = params?.deployTimeParams ?? this._deployTimeParams\n      const compiled = await this.compile({ deployTimeParams, updatable, deletable })\n      const result = await this.handleCallErrors(async () => {\n        const result = await this._algorand.send.appCreateMethodCall(\n          await this.params.create({ ...params, updatable, deletable, deployTimeParams }),\n        )\n        return {\n          ...result,\n          return: result.return?.returnValue,\n        }\n      })\n      return {\n        appClient: this.getAppClientById({\n          appId: result.appId,\n        }),\n        result: {\n          ...result,\n          ...(compiled as Partial<AppCompilationResult>),\n        },\n      }\n    },\n  }\n\n  /**\n   * Idempotently deploy (create if not exists, update if changed) an app against the given name for the given creator account, including deploy-time TEAL template placeholder substitutions (if specified).\n   *\n   * **Note:** When using the return from this function be sure to check `operationPerformed` to get access to various return properties like `transaction`, `confirmation` and `deleteResult`.\n   *\n   * **Note:** if there is a breaking state schema change to an existing app (and `onSchemaBreak` is set to `'replace'`) the existing app will be deleted and re-created.\n   *\n   * **Note:** if there is an update (different TEAL code) to an existing app (and `onUpdate` is set to `'replace'`) the existing app will be deleted and re-created.\n   * @param params The arguments to control the app deployment\n   * @returns The app client and the result of the deployment\n   * @example\n   * ```ts\n   * const { appClient, result } = await factory.deploy({\n   *   createParams: {\n   *     sender: 'SENDER_ADDRESS',\n   *     approvalProgram: 'APPROVAL PROGRAM',\n   *     clearStateProgram: 'CLEAR PROGRAM',\n   *     schema: {\n   *       globalByteSlices: 0,\n   *       globalInts: 0,\n   *       localByteSlices: 0,\n   *       localInts: 0\n   *     }\n   *   },\n   *   updateParams: {\n   *     sender: 'SENDER_ADDRESS'\n   *   },\n   *   deleteParams: {\n   *     sender: 'SENDER_ADDRESS'\n   *   },\n   *   onSchemaBreak: 'append',\n   *   onUpdate: 'append'\n   *  })\n   * ```\n   */\n  public async deploy(params: AppFactoryDeployParams) {\n    const updatable = params.updatable ?? this._updatable ?? this.getDeployTimeControl('updatable')\n    const deletable = params.deletable ?? this._deletable ?? this.getDeployTimeControl('deletable')\n    const deployTimeParams = params.deployTimeParams ?? this._deployTimeParams\n\n    // Compile using a appID 0 AppClient so we can register the error handler and use the programs\n    // to identify the app within the error handler (because we can't use app ID 0)\n    const tempAppClient = this.getAppClientById({ appId: 0n })\n    const compiled = await tempAppClient.compile({ deployTimeParams, updatable, deletable })\n\n    const deployResult = await this._algorand.appDeployer.deploy({\n      ...params,\n      createParams: await (params.createParams && 'method' in params.createParams\n        ? this.params.create({ ...params.createParams, updatable, deletable, deployTimeParams })\n        : this.params.bare.create({ ...params.createParams, updatable, deletable, deployTimeParams })),\n      updateParams:\n        params.updateParams && 'method' in params.updateParams\n          ? this.params.deployUpdate(params.updateParams)\n          : this.params.bare.deployUpdate(params.updateParams),\n      deleteParams:\n        params.deleteParams && 'method' in params.deleteParams\n          ? this.params.deployDelete(params.deleteParams)\n          : this.params.bare.deployDelete(params.deleteParams),\n      metadata: {\n        name: params.appName ?? this._appName,\n        version: this._version,\n        updatable,\n        deletable,\n      },\n    })\n    const appClient = this.getAppClientById({\n      appId: deployResult.appId,\n      appName: params.appName,\n    })\n    const result = {\n      ...deployResult,\n      ...(compiled as Partial<AppCompilationResult>),\n    }\n    return {\n      appClient,\n      result: {\n        ...result,\n        return:\n          'return' in result\n            ? result.operationPerformed === 'update'\n              ? params.updateParams && 'method' in params.updateParams\n                ? result.return?.returnValue\n                : undefined\n              : params.createParams && 'method' in params.createParams\n                ? result.return?.returnValue\n                : undefined\n            : undefined,\n        deleteReturn:\n          'deleteReturn' in result && params.deleteParams && 'method' in params.deleteParams ? result.deleteReturn?.returnValue : undefined,\n      },\n    }\n  }\n\n  /**\n   * Returns a new `AppClient` client for an app instance of the given ID.\n   *\n   * Automatically populates appName, defaultSender and source maps from the factory\n   * if not specified in the params.\n   * @param params The parameters to create the app client\n   * @returns The `AppClient` instance\n   * @example\n   * ```typescript\n   * const appClient = factory.getAppClientById({ appId: 12345n })\n   * ```\n   */\n  public getAppClientById(params: AppFactoryAppClientParams) {\n    return new AppClient({\n      ...params,\n      algorand: this._algorand,\n      appSpec: this._appSpec,\n      appName: params.appName ?? this._appName,\n      defaultSender: params.defaultSender ?? this._defaultSender,\n      defaultSigner: params.defaultSigner ?? this._defaultSigner,\n      approvalSourceMap: params.approvalSourceMap ?? this._approvalSourceMap,\n      clearSourceMap: params.clearSourceMap ?? this._clearSourceMap,\n    })\n  }\n\n  /**\n   * Returns a new `AppClient` client, resolving the app by creator address and name\n   * using AlgoKit app deployment semantics (i.e. looking for the app creation transaction note).\n   *\n   * Automatically populates appName, defaultSender and source maps from the factory\n   * if not specified in the params.\n   * @param params The parameters to create the app client\n   * @returns The `AppClient` instance\n   * @example\n   * ```typescript\n   * const appClient = factory.getAppClientByCreatorAndName({ creatorAddress: 'CREATOR_ADDRESS', appName: 'my_app' })\n   * ```\n   */\n  public getAppClientByCreatorAndName(params: AppFactoryResolveAppClientByCreatorAndNameParams) {\n    return AppClient.fromCreatorAndName({\n      ...params,\n      algorand: this._algorand,\n      appSpec: this._appSpec,\n      appName: params.appName ?? this._appName,\n      defaultSender: params.defaultSender ?? this._defaultSender,\n      approvalSourceMap: params.approvalSourceMap ?? this._approvalSourceMap,\n      clearSourceMap: params.clearSourceMap ?? this._clearSourceMap,\n    })\n  }\n\n  /**\n   * Takes an error that may include a logic error from a call to the current app and re-exposes the\n   * error to include source code information via the source map and ARC-56 spec.\n   * @param e The error to parse\n   * @param isClearStateProgram Whether or not the code was running the clear state program (defaults to approval program)\n   * @returns The new error, or if there was no logic error or source map then the wrapped error with source details\n   */\n  exposeLogicError(e: Error, isClearStateProgram?: boolean): Error {\n    return AppClient.exposeLogicError(e, this._appSpec, {\n      isClearStateProgram,\n      approvalSourceMap: this._approvalSourceMap,\n      clearSourceMap: this._clearSourceMap,\n    })\n  }\n\n  /**\n   * Export the current source maps for the app.\n   * @returns The source maps\n   */\n  exportSourceMaps(): AppSourceMaps {\n    if (!this._approvalSourceMap || !this._clearSourceMap) {\n      throw new Error(\n        \"Unable to export source maps; they haven't been loaded into this client - you need to call create, update, or deploy first\",\n      )\n    }\n\n    return {\n      approvalSourceMap: this._approvalSourceMap,\n      clearSourceMap: this._clearSourceMap,\n    }\n  }\n\n  /**\n   * Import source maps for the app.\n   * @param sourceMaps The source maps to import\n   */\n  importSourceMaps(sourceMaps: AppSourceMaps) {\n    this._approvalSourceMap = new ProgramSourceMap(sourceMaps.approvalSourceMap)\n    this._clearSourceMap = new ProgramSourceMap(sourceMaps.clearSourceMap)\n  }\n\n  private getDeployTimeControl(control: 'updatable' | 'deletable'): boolean | undefined {\n    const approval = this._appSpec.source?.approval ? Buffer.from(this._appSpec.source.approval, 'base64').toString('utf-8') : undefined\n    // variable not present, so unknown control value\n    if (!approval || !approval.includes(control === 'updatable' ? UPDATABLE_TEMPLATE_NAME : DELETABLE_TEMPLATE_NAME)) return undefined\n\n    // A call is present and configured\n    return (\n      this._appSpec.bareActions.call.includes(control === 'updatable' ? 'UpdateApplication' : 'DeleteApplication') ||\n      Object.values(this._appSpec.methods).some((c) =>\n        c.actions.call.includes(control === 'updatable' ? 'UpdateApplication' : 'DeleteApplication'),\n      )\n    )\n  }\n\n  private getParamsMethods() {\n    return {\n      /** Return params for a create ABI call, including deploy-time TEAL template replacements and compilation if provided */\n      create: async (params: AppFactoryCreateMethodCallParams) => {\n        const compiled = await this.compile({ ...params, deployTimeParams: params.deployTimeParams ?? this._deployTimeParams })\n        return this.getABIParams(\n          {\n            ...params,\n            deployTimeParams: params.deployTimeParams ?? this._deployTimeParams,\n            schema: params.schema ?? {\n              globalByteSlices: this._appSpec.state.schema.global.bytes,\n              globalInts: this._appSpec.state.schema.global.ints,\n              localByteSlices: this._appSpec.state.schema.local.bytes,\n              localInts: this._appSpec.state.schema.local.ints,\n            },\n            approvalProgram: compiled.approvalProgram,\n            clearStateProgram: compiled.clearStateProgram,\n          },\n          params.onComplete ?? OnApplicationComplete.NoOp,\n        ) satisfies AppCreateMethodCall\n      },\n      /** Return params for a deployment update ABI call */\n      deployUpdate: (params: AppClientMethodCallParams) => {\n        return this.getABIParams(params, OnApplicationComplete.UpdateApplication) satisfies DeployAppUpdateMethodCall\n      },\n      /** Return params for a deployment delete ABI call */\n      deployDelete: (params: AppClientMethodCallParams) => {\n        return this.getABIParams(params, OnApplicationComplete.DeleteApplication) satisfies DeployAppDeleteMethodCall\n      },\n      bare: {\n        /** Return params for a create bare call, including deploy-time TEAL template replacements and compilation if provided */\n        create: async (params?: AppFactoryCreateParams) => {\n          return this.getBareParams(\n            {\n              ...params,\n              deployTimeParams: params?.deployTimeParams ?? this._deployTimeParams,\n              schema: params?.schema ?? {\n                globalByteSlices: this._appSpec.state.schema.global.bytes,\n                globalInts: this._appSpec.state.schema.global.ints,\n                localByteSlices: this._appSpec.state.schema.local.bytes,\n                localInts: this._appSpec.state.schema.local.ints,\n              },\n              ...(await this.compile({ ...params, deployTimeParams: params?.deployTimeParams ?? this._deployTimeParams })),\n            },\n            params?.onComplete ?? OnApplicationComplete.NoOp,\n          ) satisfies AppCreateParams\n        },\n        /** Return params for a deployment update bare call */\n        deployUpdate: (params?: AppClientBareCallParams) => {\n          return this.getBareParams(params, OnApplicationComplete.UpdateApplication) satisfies DeployAppUpdateParams\n        },\n        /** Return params for a deployment delete bare call */\n        deployDelete: (params?: AppClientBareCallParams) => {\n          return this.getBareParams(params, OnApplicationComplete.DeleteApplication) satisfies DeployAppDeleteParams\n        },\n      },\n    }\n  }\n\n  /** Make the given call and catch any errors, augmenting with debugging information before re-throwing. */\n  private async handleCallErrors<TResult>(call: () => Promise<TResult>) {\n    try {\n      return await call()\n    } catch (e) {\n      throw this.exposeLogicError(e as Error)\n    }\n  }\n\n  /**\n   * Compiles the approval and clear state programs (if TEAL templates provided),\n   * performing any provided deploy-time parameter replacement and stores\n   * the source maps.\n   *\n   * If no TEAL templates provided it will use any byte code provided in the app spec.\n   *\n   * Will store any generated source maps for later use in debugging.\n   * @param compilation Optional compilation parameters to use for the compilation\n   * @returns The compilation result\n   * @example\n   * ```typescript\n   * const result = await factory.compile()\n   * ```\n   */\n  public async compile(compilation?: AppClientCompilationParams) {\n    const result = await AppClient.compile(this._appSpec, this._algorand.app, compilation)\n\n    if (result.compiledApproval) {\n      this._approvalSourceMap = result.compiledApproval.sourceMap\n    }\n    if (result.compiledClear) {\n      this._clearSourceMap = result.compiledClear.sourceMap\n    }\n\n    return result\n  }\n\n  private getBareParams<\n    TParams extends { sender?: ReadableAddress; signer?: TransactionSigner | AddressWithTransactionSigner } | undefined,\n    TOnComplete extends OnApplicationComplete,\n  >(params: TParams, onComplete: TOnComplete) {\n    return {\n      ...params,\n      sender: this.getSender(params?.sender),\n      signer: this.getSigner(params?.sender, params?.signer),\n      onComplete,\n    }\n  }\n\n  private getABIParams<\n    TParams extends {\n      method: string\n      sender?: ReadableAddress\n      signer?: TransactionSigner | AddressWithTransactionSigner\n      args?: AppClientMethodCallParams['args']\n    },\n    TOnComplete extends OnApplicationComplete,\n  >(params: TParams, onComplete: TOnComplete) {\n    return {\n      ...params,\n      sender: this.getSender(params.sender),\n      signer: this.getSigner(params.sender, params.signer),\n      method: getABIMethod(params.method, this._appSpec),\n      args: this.getCreateABIArgsWithDefaultValues(params.method, params.args),\n      onComplete,\n    }\n  }\n\n  private getCreateABIArgsWithDefaultValues(\n    methodNameOrSignature: string,\n    args: AppClientMethodCallParams['args'] | undefined,\n  ): AppMethodCall<CommonAppCallParams>['args'] {\n    const m = getABIMethod(methodNameOrSignature, this._appSpec)\n    return args?.map((arg, i) => {\n      const methodArg = m.args[i]\n      if (arg !== undefined) {\n        return arg\n      }\n      if (argTypeIsTransaction(methodArg.type)) {\n        return arg\n      }\n      const defaultValue = methodArg.defaultValue\n      if (defaultValue) {\n        switch (defaultValue.source) {\n          case 'literal': {\n            const bytes = Buffer.from(defaultValue.data, 'base64')\n            const value_type = defaultValue.type ?? methodArg.type\n            return getABIDecodedValue(value_type, bytes)\n          }\n          default:\n            throw new Error(`Can't provide default value for ${defaultValue.source} for a contract creation call`)\n        }\n      }\n      throw new Error(`No value provided for required argument ${methodArg.name ?? `arg${i + 1}`} in call to method ${m.name}`)\n    })\n  }\n\n  /** Returns the sender for a call, using the `defaultSender`\n   * if none provided and throws an error if neither provided */\n  private getSender(sender: ReadableAddress | undefined): Address {\n    if (!sender && !this._defaultSender) {\n      throw new Error(`No sender provided and no default sender present in app factory for call to app ${this._appName}`)\n    }\n    return getAddress(sender ?? this._defaultSender!)\n  }\n\n  /** Returns the signer for a call, using the provided signer or the `defaultSigner`\n   * if no signer was provided and the sender resolves to the default sender, the call will use default signer\n   * or `undefined` otherwise (so the signer is resolved from `AlgorandClient`) */\n  private getSigner(\n    sender: ReadableAddress | undefined,\n    signer: TransactionSigner | AddressWithTransactionSigner | undefined,\n  ): TransactionSigner | AddressWithTransactionSigner | undefined {\n    return signer ?? (!sender || sender === this._defaultSender ? this._defaultSigner : undefined)\n  }\n}\n"],"mappings":"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"}

package/types/app.d.ts

@@ -1,4 +1,5 @@
 import { Address } from "../packages/common/src/address.js";
+import { Expand } from "../packages/common/src/expand.js";
 import { ABIValue } from "../packages/abi/src/abi-value.js";
 import { ABIType } from "../packages/abi/src/abi-type.js";
 import { ABIMethod, ABIReturn } from "../packages/abi/src/abi-method.js";
@@ -7,7 +8,6 @@ import { Transaction } from "../packages/transact/src/transactions/transaction.j
 import { SuggestedParams } from "../packages/algod_client/src/models/suggested-params.js";
 import { ProgramSourceMap } from "../packages/sdk/src/logic/sourcemap.js";
 import { BoxIdentifier, BoxReference as BoxReference$1 } from "./app-manager.js";
-import { Expand } from "./expand.js";
 import { SendSingleTransactionResult, SendTransactionFrom, SendTransactionParams, SendTransactionResult, SendTransactionResults, TransactionNote, TransactionToSign } from "./transaction.js";
 import { TransactionWithSigner } from "../transaction/transaction.js";
 

package/types/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","names":[],"sources":["../../src/types/app.ts"],"sourcesContent":["import { ABIMethod, ABIReturn, ABIType, ABIValue } from '@algorandfoundation/algokit-abi'\nimport { SuggestedParams } from '@algorandfoundation/algokit-algod-client'\nimport { Address } from '@algorandfoundation/algokit-common'\nimport { OnApplicationComplete, BoxReference as TransactBoxReference, Transaction } from '@algorandfoundation/algokit-transact'\nimport { ProgramSourceMap } from '@algorandfoundation/sdk'\nimport { TransactionWithSigner } from '../transaction'\nimport { BoxIdentifier, BoxReference } from './app-manager'\nimport { Expand } from './expand'\nimport {\n  SendSingleTransactionResult,\n  SendTransactionFrom,\n  SendTransactionParams,\n  SendTransactionResult,\n  SendTransactionResults,\n  TransactionNote,\n  TransactionToSign,\n} from './transaction'\ntype SourceMap = ProgramSourceMap\n\n/** The name of the TEAL template variable for deploy-time immutability control */\nexport const UPDATABLE_TEMPLATE_NAME = 'TMPL_UPDATABLE'\n\n/** The name of the TEAL template variable for deploy-time permanence control */\nexport const DELETABLE_TEMPLATE_NAME = 'TMPL_DELETABLE'\n\n/** The app create/update [ARC-2](https://github.com/algorandfoundation/ARCs/blob/main/ARCs/arc-0002.md) transaction note prefix */\nexport const APP_DEPLOY_NOTE_DAPP = 'ALGOKIT_DEPLOYER'\n\n/** The maximum number of bytes in a single app code page */\nexport const APP_PAGE_MAX_SIZE = 2048\n\n/** First 4 bytes of SHA-512/256 hash of \"return\" for retrieving ABI return values */\nexport const ABI_RETURN_PREFIX = new Uint8Array([21, 31, 124, 117])\n\n/** Information about an Algorand app */\nexport interface AppReference {\n  /** The id of the app */\n  appId: number | bigint\n  /** The Algorand address of the account associated with the app */\n  appAddress: string\n}\n\n/** Common app call arguments for ABI and non-ABI (raw) calls */\nexport interface CoreAppCallArgs {\n  /** The optional lease for the transaction */\n  lease?: string | Uint8Array\n  /** Any box references to load */\n  boxes?: (TransactBoxReference | BoxReference | BoxIdentifier)[]\n  /** The address of any accounts to load in */\n  accounts?: (string | Address)[]\n  /** IDs of any apps to load into the foreignApps array */\n  apps?: number[]\n  /** IDs of any assets to load into the foreignAssets array */\n  assets?: number[]\n  /** Optional account / account address that should be authorised to transact on behalf of the from account the app call is sent from after this transaction.\n   *\n   * **Note:** Use with extreme caution and review the [official rekey guidance](https://dev.algorand.co/concepts/accounts/rekeying) first.\n   */\n  rekeyTo?: SendTransactionFrom | string\n}\n\n/**\n * App call args with non-ABI (raw) values (minus some processing like encoding strings as binary)\n */\nexport interface RawAppCallArgs extends CoreAppCallArgs {\n  /** Any application arguments to pass through */\n  appArgs?: (Uint8Array | string)[]\n  /** Property to aid intellisense */\n  method?: undefined\n}\n\n/** An argument for an ABI method, either a primitive value, or a transaction with or without signer, or the unawaited async return value of an algokit method that returns a `SendTransactionResult` */\nexport type ABIAppCallArg =\n  | ABIValue\n  | TransactionWithSigner\n  | TransactionToSign\n  | Transaction\n  | Promise<SendTransactionResult>\n  | SendTransactionResult\n  | undefined\n\n/**\n * App call args for an ABI call\n */\nexport type ABIAppCallArgs = CoreAppCallArgs & {\n  /** The ABI method to call */\n  method: ABIMethod\n  /** The ABI method args to pass in */\n  methodArgs: ABIAppCallArg[]\n}\n\n/** Arguments to pass to an app call either:\n *   * The raw app call values to pass through into the transaction (after processing); or\n *   * An ABI method definition (method and args)\n **/\nexport type AppCallArgs = RawAppCallArgs | ABIAppCallArgs\n\n/** Parameters representing a call to an app. */\nexport interface AppCallParams extends SendTransactionParams {\n  /** The id of the app to call */\n  appId: number | bigint\n  /** The type of call, everything except create (see `createApp`) and update (see `updateApp`) */\n  callType: Exclude<OnApplicationComplete, OnApplicationComplete.UpdateApplication>\n  /** The account to make the call from */\n  from: SendTransactionFrom\n  /** Optional transaction parameters */\n  transactionParams?: SuggestedParams\n  /** The (optional) transaction note */\n  note?: TransactionNote\n  /** The arguments passed in to the app call */\n  args?: AppCallArgs\n}\n\n/** Parameters representing the storage schema of an app. */\nexport interface AppStorageSchema {\n  /** Restricts number of ints in per-user local state */\n  localInts: number\n  /** Restricts number of byte slices in per-user local state */\n  localByteSlices: number\n  /** Restricts number of ints in global state */\n  globalInts: number\n  /** Restricts number of byte slices in global state */\n  globalByteSlices: number\n  /** Any extra pages that are needed for the smart contract; if left blank then the right number of pages will be calculated based on the teal code size */\n  extraPages?: number\n}\n\n/** Information about a compiled teal program */\nexport interface CompiledTeal {\n  /** Original TEAL code */\n  teal: string\n  /** The compiled code */\n  compiled: string\n  /** The hash returned by the compiler */\n  compiledHash: string\n  /** The base64 encoded code as a byte array */\n  compiledBase64ToBytes: Uint8Array\n  /** Source map from the compilation */\n  sourceMap: SourceMap\n}\n\nexport interface AppCallTransactionResultOfType<T> extends SendTransactionResults, SendTransactionResult {\n  /** If an ABI method was called the processed return value */\n  return?: T\n}\n\n/** Result from calling an app */\nexport type AppCallTransactionResult = AppCallTransactionResultOfType<ABIReturn>\n\n/**\n * The payload of the metadata to add to the transaction note when deploying an app, noting it will be prefixed with `APP_DEPLOY_NOTE_PREFIX`.\n */\nexport interface AppDeployMetadata {\n  /** The unique name identifier of the app within the creator account */\n  name: string\n  /** The version of app that is / will be deployed */\n  version: string\n  /** Whether or not the app is deletable / permanent / unspecified */\n  deletable?: boolean\n  /** Whether or not the app is updatable / immutable / unspecified */\n  updatable?: boolean\n}\n\n/** The metadata that can be collected about a deployed app */\nexport interface AppMetadata extends AppReference, AppDeployMetadata {\n  /** The round the app was created */\n  createdRound: number\n  /** The last round that the app was updated */\n  updatedRound: number\n  /** The metadata when the app was created */\n  createdMetadata: AppDeployMetadata\n  /** Whether or not the app is deleted */\n  deleted: boolean\n}\n\n/** A lookup of name -> Algorand app for a creator */\nexport interface AppLookup {\n  creator: Readonly<string>\n  apps: Readonly<{\n    [name: string]: AppMetadata\n  }>\n}\n\n/** Dictionary of deploy-time parameters to replace in a teal template.\n *\n * Note: Looks for `TMPL_{parameter}` for template replacements i.e. you can leave out the `TMPL_`.\n *\n */\nexport interface TealTemplateParams {\n  [key: string]: string | bigint | number | Uint8Array\n}\n\n/** What action to perform when deploying an app and an update is detected in the TEAL code */\nexport enum OnUpdate {\n  /** Fail the deployment */\n  Fail,\n  /** Update the app */\n  UpdateApp,\n  /** Delete the app and create a new one in its place */\n  ReplaceApp,\n  /** Create a new app */\n  AppendApp,\n}\n\n/** What action to perform when deploying an app and a breaking schema change is detected */\nexport enum OnSchemaBreak {\n  /** Fail the deployment */\n  Fail,\n  /** Delete the app and create a new one in its place */\n  ReplaceApp,\n  /** Create a new app */\n  AppendApp,\n}\n\n/** The result of compiling the approval and clear state TEAL programs for an app */\nexport interface AppCompilationResult {\n  /** The result of compiling the approval program */\n  compiledApproval: CompiledTeal\n  /** The result of compiling the clear state program */\n  compiledClear: CompiledTeal\n}\n\nexport type AppReturn<TReturn> = {\n  /** The ABI method call return value */\n  return?: TReturn\n}\n\n/** Result from sending a single app transaction. */\nexport type SendAppTransactionResult = Expand<\n  SendSingleTransactionResult & {\n    /** If an ABI method was called the processed return value */\n    return?: ABIReturn\n  }\n>\n\n/** Result from sending a single app transaction. */\nexport type SendAppUpdateTransactionResult = Expand<SendAppTransactionResult & Partial<AppCompilationResult>>\n\n/** Result from sending a single app transaction. */\nexport type SendAppCreateTransactionResult = Expand<\n  SendAppUpdateTransactionResult & {\n    /** The id of the created app */\n    appId: bigint\n    /** The Algorand address of the account associated with the app */\n    appAddress: Address\n  }\n>\n\n/** Object holding app state values */\nexport interface AppState {\n  [key: string]:\n    | {\n        value: bigint\n        keyRaw: Uint8Array\n        keyBase64: string\n      }\n    | {\n        value: string\n        valueRaw: Uint8Array\n        valueBase64: string\n        keyRaw: Uint8Array\n        keyBase64: string\n      }\n}\n\n/**\n * The name of a box storage box */\nexport interface BoxName {\n  /** Name in UTF-8 */\n  name: string\n  /** Name in binary bytes */\n  nameRaw: Uint8Array\n  /** Name in Base64 */\n  nameBase64: string\n}\n\n/**\n * @deprecated Use `types/app-manager/BoxValueRequestParams` instead.\n * Parameters to get and decode a box value as an ABI type.\n */\nexport interface BoxValueRequestParams {\n  /** The ID of the app return box names for */\n  appId: number | bigint\n  /** The name of the box to return either as a string, binary array or `BoxName` */\n  boxName: string | Uint8Array | BoxName\n  /** The ABI type to decode the value using */\n  type: ABIType\n}\n\n/**\n * @deprecated Use `types/app-manager/BoxValuesRequestParams` instead.\n * Parameters to get and decode a box value as an ABI type.\n */\nexport interface BoxValuesRequestParams {\n  /** The ID of the app return box names for */\n  appId: number\n  /** The names of the boxes to return either as a string, binary array or BoxName` */\n  boxNames: (string | Uint8Array | BoxName)[]\n  /** The ABI type to decode the value using */\n  type: ABIType\n}\n"],"mappings":";;;AAoBA,MAAa,0BAA0B;;AAGvC,MAAa,0BAA0B;;AAGvC,MAAa,uBAAuB;;AAGpC,MAAa,oBAAoB;;AAGjC,MAAa,oBAAoB,IAAI,WAAW;CAAC;CAAI;CAAI;CAAK;CAAI,CAAC;;AAiKnE,IAAY,gDAAL;;AAEL;;AAEA;;AAEA;;AAEA;;;;AAIF,IAAY,0DAAL;;AAEL;;AAEA;;AAEA"}
+{"version":3,"file":"app.js","names":[],"sources":["../../src/types/app.ts"],"sourcesContent":["import { ABIMethod, ABIReturn, ABIType, ABIValue } from '@algorandfoundation/algokit-abi'\nimport { SuggestedParams } from '@algorandfoundation/algokit-algod-client'\nimport { Address, Expand } from '@algorandfoundation/algokit-common'\nimport { OnApplicationComplete, BoxReference as TransactBoxReference, Transaction } from '@algorandfoundation/algokit-transact'\nimport { ProgramSourceMap } from '@algorandfoundation/sdk'\nimport { TransactionWithSigner } from '../transaction'\nimport { BoxIdentifier, BoxReference } from './app-manager'\nimport {\n  SendSingleTransactionResult,\n  SendTransactionFrom,\n  SendTransactionParams,\n  SendTransactionResult,\n  SendTransactionResults,\n  TransactionNote,\n  TransactionToSign,\n} from './transaction'\ntype SourceMap = ProgramSourceMap\n\n/** The name of the TEAL template variable for deploy-time immutability control */\nexport const UPDATABLE_TEMPLATE_NAME = 'TMPL_UPDATABLE'\n\n/** The name of the TEAL template variable for deploy-time permanence control */\nexport const DELETABLE_TEMPLATE_NAME = 'TMPL_DELETABLE'\n\n/** The app create/update [ARC-2](https://github.com/algorandfoundation/ARCs/blob/main/ARCs/arc-0002.md) transaction note prefix */\nexport const APP_DEPLOY_NOTE_DAPP = 'ALGOKIT_DEPLOYER'\n\n/** The maximum number of bytes in a single app code page */\nexport const APP_PAGE_MAX_SIZE = 2048\n\n/** First 4 bytes of SHA-512/256 hash of \"return\" for retrieving ABI return values */\nexport const ABI_RETURN_PREFIX = new Uint8Array([21, 31, 124, 117])\n\n/** Information about an Algorand app */\nexport interface AppReference {\n  /** The id of the app */\n  appId: number | bigint\n  /** The Algorand address of the account associated with the app */\n  appAddress: string\n}\n\n/** Common app call arguments for ABI and non-ABI (raw) calls */\nexport interface CoreAppCallArgs {\n  /** The optional lease for the transaction */\n  lease?: string | Uint8Array\n  /** Any box references to load */\n  boxes?: (TransactBoxReference | BoxReference | BoxIdentifier)[]\n  /** The address of any accounts to load in */\n  accounts?: (string | Address)[]\n  /** IDs of any apps to load into the foreignApps array */\n  apps?: number[]\n  /** IDs of any assets to load into the foreignAssets array */\n  assets?: number[]\n  /** Optional account / account address that should be authorised to transact on behalf of the from account the app call is sent from after this transaction.\n   *\n   * **Note:** Use with extreme caution and review the [official rekey guidance](https://dev.algorand.co/concepts/accounts/rekeying) first.\n   */\n  rekeyTo?: SendTransactionFrom | string\n}\n\n/**\n * App call args with non-ABI (raw) values (minus some processing like encoding strings as binary)\n */\nexport interface RawAppCallArgs extends CoreAppCallArgs {\n  /** Any application arguments to pass through */\n  appArgs?: (Uint8Array | string)[]\n  /** Property to aid intellisense */\n  method?: undefined\n}\n\n/** An argument for an ABI method, either a primitive value, or a transaction with or without signer, or the unawaited async return value of an algokit method that returns a `SendTransactionResult` */\nexport type ABIAppCallArg =\n  | ABIValue\n  | TransactionWithSigner\n  | TransactionToSign\n  | Transaction\n  | Promise<SendTransactionResult>\n  | SendTransactionResult\n  | undefined\n\n/**\n * App call args for an ABI call\n */\nexport type ABIAppCallArgs = CoreAppCallArgs & {\n  /** The ABI method to call */\n  method: ABIMethod\n  /** The ABI method args to pass in */\n  methodArgs: ABIAppCallArg[]\n}\n\n/** Arguments to pass to an app call either:\n *   * The raw app call values to pass through into the transaction (after processing); or\n *   * An ABI method definition (method and args)\n **/\nexport type AppCallArgs = RawAppCallArgs | ABIAppCallArgs\n\n/** Parameters representing a call to an app. */\nexport interface AppCallParams extends SendTransactionParams {\n  /** The id of the app to call */\n  appId: number | bigint\n  /** The type of call, everything except create (see `createApp`) and update (see `updateApp`) */\n  callType: Exclude<OnApplicationComplete, OnApplicationComplete.UpdateApplication>\n  /** The account to make the call from */\n  from: SendTransactionFrom\n  /** Optional transaction parameters */\n  transactionParams?: SuggestedParams\n  /** The (optional) transaction note */\n  note?: TransactionNote\n  /** The arguments passed in to the app call */\n  args?: AppCallArgs\n}\n\n/** Parameters representing the storage schema of an app. */\nexport interface AppStorageSchema {\n  /** Restricts number of ints in per-user local state */\n  localInts: number\n  /** Restricts number of byte slices in per-user local state */\n  localByteSlices: number\n  /** Restricts number of ints in global state */\n  globalInts: number\n  /** Restricts number of byte slices in global state */\n  globalByteSlices: number\n  /** Any extra pages that are needed for the smart contract; if left blank then the right number of pages will be calculated based on the teal code size */\n  extraPages?: number\n}\n\n/** Information about a compiled teal program */\nexport interface CompiledTeal {\n  /** Original TEAL code */\n  teal: string\n  /** The compiled code */\n  compiled: string\n  /** The hash returned by the compiler */\n  compiledHash: string\n  /** The base64 encoded code as a byte array */\n  compiledBase64ToBytes: Uint8Array\n  /** Source map from the compilation */\n  sourceMap: SourceMap\n}\n\nexport interface AppCallTransactionResultOfType<T> extends SendTransactionResults, SendTransactionResult {\n  /** If an ABI method was called the processed return value */\n  return?: T\n}\n\n/** Result from calling an app */\nexport type AppCallTransactionResult = AppCallTransactionResultOfType<ABIReturn>\n\n/**\n * The payload of the metadata to add to the transaction note when deploying an app, noting it will be prefixed with `APP_DEPLOY_NOTE_PREFIX`.\n */\nexport interface AppDeployMetadata {\n  /** The unique name identifier of the app within the creator account */\n  name: string\n  /** The version of app that is / will be deployed */\n  version: string\n  /** Whether or not the app is deletable / permanent / unspecified */\n  deletable?: boolean\n  /** Whether or not the app is updatable / immutable / unspecified */\n  updatable?: boolean\n}\n\n/** The metadata that can be collected about a deployed app */\nexport interface AppMetadata extends AppReference, AppDeployMetadata {\n  /** The round the app was created */\n  createdRound: number\n  /** The last round that the app was updated */\n  updatedRound: number\n  /** The metadata when the app was created */\n  createdMetadata: AppDeployMetadata\n  /** Whether or not the app is deleted */\n  deleted: boolean\n}\n\n/** A lookup of name -> Algorand app for a creator */\nexport interface AppLookup {\n  creator: Readonly<string>\n  apps: Readonly<{\n    [name: string]: AppMetadata\n  }>\n}\n\n/** Dictionary of deploy-time parameters to replace in a teal template.\n *\n * Note: Looks for `TMPL_{parameter}` for template replacements i.e. you can leave out the `TMPL_`.\n *\n */\nexport interface TealTemplateParams {\n  [key: string]: string | bigint | number | Uint8Array\n}\n\n/** What action to perform when deploying an app and an update is detected in the TEAL code */\nexport enum OnUpdate {\n  /** Fail the deployment */\n  Fail,\n  /** Update the app */\n  UpdateApp,\n  /** Delete the app and create a new one in its place */\n  ReplaceApp,\n  /** Create a new app */\n  AppendApp,\n}\n\n/** What action to perform when deploying an app and a breaking schema change is detected */\nexport enum OnSchemaBreak {\n  /** Fail the deployment */\n  Fail,\n  /** Delete the app and create a new one in its place */\n  ReplaceApp,\n  /** Create a new app */\n  AppendApp,\n}\n\n/** The result of compiling the approval and clear state TEAL programs for an app */\nexport interface AppCompilationResult {\n  /** The result of compiling the approval program */\n  compiledApproval: CompiledTeal\n  /** The result of compiling the clear state program */\n  compiledClear: CompiledTeal\n}\n\nexport type AppReturn<TReturn> = {\n  /** The ABI method call return value */\n  return?: TReturn\n}\n\n/** Result from sending a single app transaction. */\nexport type SendAppTransactionResult = Expand<\n  SendSingleTransactionResult & {\n    /** If an ABI method was called the processed return value */\n    return?: ABIReturn\n  }\n>\n\n/** Result from sending a single app transaction. */\nexport type SendAppUpdateTransactionResult = Expand<SendAppTransactionResult & Partial<AppCompilationResult>>\n\n/** Result from sending a single app transaction. */\nexport type SendAppCreateTransactionResult = Expand<\n  SendAppUpdateTransactionResult & {\n    /** The id of the created app */\n    appId: bigint\n    /** The Algorand address of the account associated with the app */\n    appAddress: Address\n  }\n>\n\n/** Object holding app state values */\nexport interface AppState {\n  [key: string]:\n    | {\n        value: bigint\n        keyRaw: Uint8Array\n        keyBase64: string\n      }\n    | {\n        value: string\n        valueRaw: Uint8Array\n        valueBase64: string\n        keyRaw: Uint8Array\n        keyBase64: string\n      }\n}\n\n/**\n * The name of a box storage box */\nexport interface BoxName {\n  /** Name in UTF-8 */\n  name: string\n  /** Name in binary bytes */\n  nameRaw: Uint8Array\n  /** Name in Base64 */\n  nameBase64: string\n}\n\n/**\n * @deprecated Use `types/app-manager/BoxValueRequestParams` instead.\n * Parameters to get and decode a box value as an ABI type.\n */\nexport interface BoxValueRequestParams {\n  /** The ID of the app return box names for */\n  appId: number | bigint\n  /** The name of the box to return either as a string, binary array or `BoxName` */\n  boxName: string | Uint8Array | BoxName\n  /** The ABI type to decode the value using */\n  type: ABIType\n}\n\n/**\n * @deprecated Use `types/app-manager/BoxValuesRequestParams` instead.\n * Parameters to get and decode a box value as an ABI type.\n */\nexport interface BoxValuesRequestParams {\n  /** The ID of the app return box names for */\n  appId: number\n  /** The names of the boxes to return either as a string, binary array or BoxName` */\n  boxNames: (string | Uint8Array | BoxName)[]\n  /** The ABI type to decode the value using */\n  type: ABIType\n}\n"],"mappings":";;;AAmBA,MAAa,0BAA0B;;AAGvC,MAAa,0BAA0B;;AAGvC,MAAa,uBAAuB;;AAGpC,MAAa,oBAAoB;;AAGjC,MAAa,oBAAoB,IAAI,WAAW;CAAC;CAAI;CAAI;CAAK;CAAI,CAAC;;AAiKnE,IAAY,gDAAL;;AAEL;;AAEA;;AAEA;;AAEA;;;;AAIF,IAAY,0DAAL;;AAEL;;AAEA;;AAEA"}

package/types/app.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"app.mjs","names":[],"sources":["../../src/types/app.ts"],"sourcesContent":["import { ABIMethod, ABIReturn, ABIType, ABIValue } from '@algorandfoundation/algokit-abi'\nimport { SuggestedParams } from '@algorandfoundation/algokit-algod-client'\nimport { Address } from '@algorandfoundation/algokit-common'\nimport { OnApplicationComplete, BoxReference as TransactBoxReference, Transaction } from '@algorandfoundation/algokit-transact'\nimport { ProgramSourceMap } from '@algorandfoundation/sdk'\nimport { TransactionWithSigner } from '../transaction'\nimport { BoxIdentifier, BoxReference } from './app-manager'\nimport { Expand } from './expand'\nimport {\n  SendSingleTransactionResult,\n  SendTransactionFrom,\n  SendTransactionParams,\n  SendTransactionResult,\n  SendTransactionResults,\n  TransactionNote,\n  TransactionToSign,\n} from './transaction'\ntype SourceMap = ProgramSourceMap\n\n/** The name of the TEAL template variable for deploy-time immutability control */\nexport const UPDATABLE_TEMPLATE_NAME = 'TMPL_UPDATABLE'\n\n/** The name of the TEAL template variable for deploy-time permanence control */\nexport const DELETABLE_TEMPLATE_NAME = 'TMPL_DELETABLE'\n\n/** The app create/update [ARC-2](https://github.com/algorandfoundation/ARCs/blob/main/ARCs/arc-0002.md) transaction note prefix */\nexport const APP_DEPLOY_NOTE_DAPP = 'ALGOKIT_DEPLOYER'\n\n/** The maximum number of bytes in a single app code page */\nexport const APP_PAGE_MAX_SIZE = 2048\n\n/** First 4 bytes of SHA-512/256 hash of \"return\" for retrieving ABI return values */\nexport const ABI_RETURN_PREFIX = new Uint8Array([21, 31, 124, 117])\n\n/** Information about an Algorand app */\nexport interface AppReference {\n  /** The id of the app */\n  appId: number | bigint\n  /** The Algorand address of the account associated with the app */\n  appAddress: string\n}\n\n/** Common app call arguments for ABI and non-ABI (raw) calls */\nexport interface CoreAppCallArgs {\n  /** The optional lease for the transaction */\n  lease?: string | Uint8Array\n  /** Any box references to load */\n  boxes?: (TransactBoxReference | BoxReference | BoxIdentifier)[]\n  /** The address of any accounts to load in */\n  accounts?: (string | Address)[]\n  /** IDs of any apps to load into the foreignApps array */\n  apps?: number[]\n  /** IDs of any assets to load into the foreignAssets array */\n  assets?: number[]\n  /** Optional account / account address that should be authorised to transact on behalf of the from account the app call is sent from after this transaction.\n   *\n   * **Note:** Use with extreme caution and review the [official rekey guidance](https://dev.algorand.co/concepts/accounts/rekeying) first.\n   */\n  rekeyTo?: SendTransactionFrom | string\n}\n\n/**\n * App call args with non-ABI (raw) values (minus some processing like encoding strings as binary)\n */\nexport interface RawAppCallArgs extends CoreAppCallArgs {\n  /** Any application arguments to pass through */\n  appArgs?: (Uint8Array | string)[]\n  /** Property to aid intellisense */\n  method?: undefined\n}\n\n/** An argument for an ABI method, either a primitive value, or a transaction with or without signer, or the unawaited async return value of an algokit method that returns a `SendTransactionResult` */\nexport type ABIAppCallArg =\n  | ABIValue\n  | TransactionWithSigner\n  | TransactionToSign\n  | Transaction\n  | Promise<SendTransactionResult>\n  | SendTransactionResult\n  | undefined\n\n/**\n * App call args for an ABI call\n */\nexport type ABIAppCallArgs = CoreAppCallArgs & {\n  /** The ABI method to call */\n  method: ABIMethod\n  /** The ABI method args to pass in */\n  methodArgs: ABIAppCallArg[]\n}\n\n/** Arguments to pass to an app call either:\n *   * The raw app call values to pass through into the transaction (after processing); or\n *   * An ABI method definition (method and args)\n **/\nexport type AppCallArgs = RawAppCallArgs | ABIAppCallArgs\n\n/** Parameters representing a call to an app. */\nexport interface AppCallParams extends SendTransactionParams {\n  /** The id of the app to call */\n  appId: number | bigint\n  /** The type of call, everything except create (see `createApp`) and update (see `updateApp`) */\n  callType: Exclude<OnApplicationComplete, OnApplicationComplete.UpdateApplication>\n  /** The account to make the call from */\n  from: SendTransactionFrom\n  /** Optional transaction parameters */\n  transactionParams?: SuggestedParams\n  /** The (optional) transaction note */\n  note?: TransactionNote\n  /** The arguments passed in to the app call */\n  args?: AppCallArgs\n}\n\n/** Parameters representing the storage schema of an app. */\nexport interface AppStorageSchema {\n  /** Restricts number of ints in per-user local state */\n  localInts: number\n  /** Restricts number of byte slices in per-user local state */\n  localByteSlices: number\n  /** Restricts number of ints in global state */\n  globalInts: number\n  /** Restricts number of byte slices in global state */\n  globalByteSlices: number\n  /** Any extra pages that are needed for the smart contract; if left blank then the right number of pages will be calculated based on the teal code size */\n  extraPages?: number\n}\n\n/** Information about a compiled teal program */\nexport interface CompiledTeal {\n  /** Original TEAL code */\n  teal: string\n  /** The compiled code */\n  compiled: string\n  /** The hash returned by the compiler */\n  compiledHash: string\n  /** The base64 encoded code as a byte array */\n  compiledBase64ToBytes: Uint8Array\n  /** Source map from the compilation */\n  sourceMap: SourceMap\n}\n\nexport interface AppCallTransactionResultOfType<T> extends SendTransactionResults, SendTransactionResult {\n  /** If an ABI method was called the processed return value */\n  return?: T\n}\n\n/** Result from calling an app */\nexport type AppCallTransactionResult = AppCallTransactionResultOfType<ABIReturn>\n\n/**\n * The payload of the metadata to add to the transaction note when deploying an app, noting it will be prefixed with `APP_DEPLOY_NOTE_PREFIX`.\n */\nexport interface AppDeployMetadata {\n  /** The unique name identifier of the app within the creator account */\n  name: string\n  /** The version of app that is / will be deployed */\n  version: string\n  /** Whether or not the app is deletable / permanent / unspecified */\n  deletable?: boolean\n  /** Whether or not the app is updatable / immutable / unspecified */\n  updatable?: boolean\n}\n\n/** The metadata that can be collected about a deployed app */\nexport interface AppMetadata extends AppReference, AppDeployMetadata {\n  /** The round the app was created */\n  createdRound: number\n  /** The last round that the app was updated */\n  updatedRound: number\n  /** The metadata when the app was created */\n  createdMetadata: AppDeployMetadata\n  /** Whether or not the app is deleted */\n  deleted: boolean\n}\n\n/** A lookup of name -> Algorand app for a creator */\nexport interface AppLookup {\n  creator: Readonly<string>\n  apps: Readonly<{\n    [name: string]: AppMetadata\n  }>\n}\n\n/** Dictionary of deploy-time parameters to replace in a teal template.\n *\n * Note: Looks for `TMPL_{parameter}` for template replacements i.e. you can leave out the `TMPL_`.\n *\n */\nexport interface TealTemplateParams {\n  [key: string]: string | bigint | number | Uint8Array\n}\n\n/** What action to perform when deploying an app and an update is detected in the TEAL code */\nexport enum OnUpdate {\n  /** Fail the deployment */\n  Fail,\n  /** Update the app */\n  UpdateApp,\n  /** Delete the app and create a new one in its place */\n  ReplaceApp,\n  /** Create a new app */\n  AppendApp,\n}\n\n/** What action to perform when deploying an app and a breaking schema change is detected */\nexport enum OnSchemaBreak {\n  /** Fail the deployment */\n  Fail,\n  /** Delete the app and create a new one in its place */\n  ReplaceApp,\n  /** Create a new app */\n  AppendApp,\n}\n\n/** The result of compiling the approval and clear state TEAL programs for an app */\nexport interface AppCompilationResult {\n  /** The result of compiling the approval program */\n  compiledApproval: CompiledTeal\n  /** The result of compiling the clear state program */\n  compiledClear: CompiledTeal\n}\n\nexport type AppReturn<TReturn> = {\n  /** The ABI method call return value */\n  return?: TReturn\n}\n\n/** Result from sending a single app transaction. */\nexport type SendAppTransactionResult = Expand<\n  SendSingleTransactionResult & {\n    /** If an ABI method was called the processed return value */\n    return?: ABIReturn\n  }\n>\n\n/** Result from sending a single app transaction. */\nexport type SendAppUpdateTransactionResult = Expand<SendAppTransactionResult & Partial<AppCompilationResult>>\n\n/** Result from sending a single app transaction. */\nexport type SendAppCreateTransactionResult = Expand<\n  SendAppUpdateTransactionResult & {\n    /** The id of the created app */\n    appId: bigint\n    /** The Algorand address of the account associated with the app */\n    appAddress: Address\n  }\n>\n\n/** Object holding app state values */\nexport interface AppState {\n  [key: string]:\n    | {\n        value: bigint\n        keyRaw: Uint8Array\n        keyBase64: string\n      }\n    | {\n        value: string\n        valueRaw: Uint8Array\n        valueBase64: string\n        keyRaw: Uint8Array\n        keyBase64: string\n      }\n}\n\n/**\n * The name of a box storage box */\nexport interface BoxName {\n  /** Name in UTF-8 */\n  name: string\n  /** Name in binary bytes */\n  nameRaw: Uint8Array\n  /** Name in Base64 */\n  nameBase64: string\n}\n\n/**\n * @deprecated Use `types/app-manager/BoxValueRequestParams` instead.\n * Parameters to get and decode a box value as an ABI type.\n */\nexport interface BoxValueRequestParams {\n  /** The ID of the app return box names for */\n  appId: number | bigint\n  /** The name of the box to return either as a string, binary array or `BoxName` */\n  boxName: string | Uint8Array | BoxName\n  /** The ABI type to decode the value using */\n  type: ABIType\n}\n\n/**\n * @deprecated Use `types/app-manager/BoxValuesRequestParams` instead.\n * Parameters to get and decode a box value as an ABI type.\n */\nexport interface BoxValuesRequestParams {\n  /** The ID of the app return box names for */\n  appId: number\n  /** The names of the boxes to return either as a string, binary array or BoxName` */\n  boxNames: (string | Uint8Array | BoxName)[]\n  /** The ABI type to decode the value using */\n  type: ABIType\n}\n"],"mappings":";;AAoBA,MAAa,0BAA0B;;AAGvC,MAAa,0BAA0B;;AAGvC,MAAa,uBAAuB;;AAGpC,MAAa,oBAAoB;;AAGjC,MAAa,oBAAoB,IAAI,WAAW;CAAC;CAAI;CAAI;CAAK;CAAI,CAAC;;AAiKnE,IAAY,gDAAL;;AAEL;;AAEA;;AAEA;;AAEA;;;;AAIF,IAAY,0DAAL;;AAEL;;AAEA;;AAEA"}
+{"version":3,"file":"app.mjs","names":[],"sources":["../../src/types/app.ts"],"sourcesContent":["import { ABIMethod, ABIReturn, ABIType, ABIValue } from '@algorandfoundation/algokit-abi'\nimport { SuggestedParams } from '@algorandfoundation/algokit-algod-client'\nimport { Address, Expand } from '@algorandfoundation/algokit-common'\nimport { OnApplicationComplete, BoxReference as TransactBoxReference, Transaction } from '@algorandfoundation/algokit-transact'\nimport { ProgramSourceMap } from '@algorandfoundation/sdk'\nimport { TransactionWithSigner } from '../transaction'\nimport { BoxIdentifier, BoxReference } from './app-manager'\nimport {\n  SendSingleTransactionResult,\n  SendTransactionFrom,\n  SendTransactionParams,\n  SendTransactionResult,\n  SendTransactionResults,\n  TransactionNote,\n  TransactionToSign,\n} from './transaction'\ntype SourceMap = ProgramSourceMap\n\n/** The name of the TEAL template variable for deploy-time immutability control */\nexport const UPDATABLE_TEMPLATE_NAME = 'TMPL_UPDATABLE'\n\n/** The name of the TEAL template variable for deploy-time permanence control */\nexport const DELETABLE_TEMPLATE_NAME = 'TMPL_DELETABLE'\n\n/** The app create/update [ARC-2](https://github.com/algorandfoundation/ARCs/blob/main/ARCs/arc-0002.md) transaction note prefix */\nexport const APP_DEPLOY_NOTE_DAPP = 'ALGOKIT_DEPLOYER'\n\n/** The maximum number of bytes in a single app code page */\nexport const APP_PAGE_MAX_SIZE = 2048\n\n/** First 4 bytes of SHA-512/256 hash of \"return\" for retrieving ABI return values */\nexport const ABI_RETURN_PREFIX = new Uint8Array([21, 31, 124, 117])\n\n/** Information about an Algorand app */\nexport interface AppReference {\n  /** The id of the app */\n  appId: number | bigint\n  /** The Algorand address of the account associated with the app */\n  appAddress: string\n}\n\n/** Common app call arguments for ABI and non-ABI (raw) calls */\nexport interface CoreAppCallArgs {\n  /** The optional lease for the transaction */\n  lease?: string | Uint8Array\n  /** Any box references to load */\n  boxes?: (TransactBoxReference | BoxReference | BoxIdentifier)[]\n  /** The address of any accounts to load in */\n  accounts?: (string | Address)[]\n  /** IDs of any apps to load into the foreignApps array */\n  apps?: number[]\n  /** IDs of any assets to load into the foreignAssets array */\n  assets?: number[]\n  /** Optional account / account address that should be authorised to transact on behalf of the from account the app call is sent from after this transaction.\n   *\n   * **Note:** Use with extreme caution and review the [official rekey guidance](https://dev.algorand.co/concepts/accounts/rekeying) first.\n   */\n  rekeyTo?: SendTransactionFrom | string\n}\n\n/**\n * App call args with non-ABI (raw) values (minus some processing like encoding strings as binary)\n */\nexport interface RawAppCallArgs extends CoreAppCallArgs {\n  /** Any application arguments to pass through */\n  appArgs?: (Uint8Array | string)[]\n  /** Property to aid intellisense */\n  method?: undefined\n}\n\n/** An argument for an ABI method, either a primitive value, or a transaction with or without signer, or the unawaited async return value of an algokit method that returns a `SendTransactionResult` */\nexport type ABIAppCallArg =\n  | ABIValue\n  | TransactionWithSigner\n  | TransactionToSign\n  | Transaction\n  | Promise<SendTransactionResult>\n  | SendTransactionResult\n  | undefined\n\n/**\n * App call args for an ABI call\n */\nexport type ABIAppCallArgs = CoreAppCallArgs & {\n  /** The ABI method to call */\n  method: ABIMethod\n  /** The ABI method args to pass in */\n  methodArgs: ABIAppCallArg[]\n}\n\n/** Arguments to pass to an app call either:\n *   * The raw app call values to pass through into the transaction (after processing); or\n *   * An ABI method definition (method and args)\n **/\nexport type AppCallArgs = RawAppCallArgs | ABIAppCallArgs\n\n/** Parameters representing a call to an app. */\nexport interface AppCallParams extends SendTransactionParams {\n  /** The id of the app to call */\n  appId: number | bigint\n  /** The type of call, everything except create (see `createApp`) and update (see `updateApp`) */\n  callType: Exclude<OnApplicationComplete, OnApplicationComplete.UpdateApplication>\n  /** The account to make the call from */\n  from: SendTransactionFrom\n  /** Optional transaction parameters */\n  transactionParams?: SuggestedParams\n  /** The (optional) transaction note */\n  note?: TransactionNote\n  /** The arguments passed in to the app call */\n  args?: AppCallArgs\n}\n\n/** Parameters representing the storage schema of an app. */\nexport interface AppStorageSchema {\n  /** Restricts number of ints in per-user local state */\n  localInts: number\n  /** Restricts number of byte slices in per-user local state */\n  localByteSlices: number\n  /** Restricts number of ints in global state */\n  globalInts: number\n  /** Restricts number of byte slices in global state */\n  globalByteSlices: number\n  /** Any extra pages that are needed for the smart contract; if left blank then the right number of pages will be calculated based on the teal code size */\n  extraPages?: number\n}\n\n/** Information about a compiled teal program */\nexport interface CompiledTeal {\n  /** Original TEAL code */\n  teal: string\n  /** The compiled code */\n  compiled: string\n  /** The hash returned by the compiler */\n  compiledHash: string\n  /** The base64 encoded code as a byte array */\n  compiledBase64ToBytes: Uint8Array\n  /** Source map from the compilation */\n  sourceMap: SourceMap\n}\n\nexport interface AppCallTransactionResultOfType<T> extends SendTransactionResults, SendTransactionResult {\n  /** If an ABI method was called the processed return value */\n  return?: T\n}\n\n/** Result from calling an app */\nexport type AppCallTransactionResult = AppCallTransactionResultOfType<ABIReturn>\n\n/**\n * The payload of the metadata to add to the transaction note when deploying an app, noting it will be prefixed with `APP_DEPLOY_NOTE_PREFIX`.\n */\nexport interface AppDeployMetadata {\n  /** The unique name identifier of the app within the creator account */\n  name: string\n  /** The version of app that is / will be deployed */\n  version: string\n  /** Whether or not the app is deletable / permanent / unspecified */\n  deletable?: boolean\n  /** Whether or not the app is updatable / immutable / unspecified */\n  updatable?: boolean\n}\n\n/** The metadata that can be collected about a deployed app */\nexport interface AppMetadata extends AppReference, AppDeployMetadata {\n  /** The round the app was created */\n  createdRound: number\n  /** The last round that the app was updated */\n  updatedRound: number\n  /** The metadata when the app was created */\n  createdMetadata: AppDeployMetadata\n  /** Whether or not the app is deleted */\n  deleted: boolean\n}\n\n/** A lookup of name -> Algorand app for a creator */\nexport interface AppLookup {\n  creator: Readonly<string>\n  apps: Readonly<{\n    [name: string]: AppMetadata\n  }>\n}\n\n/** Dictionary of deploy-time parameters to replace in a teal template.\n *\n * Note: Looks for `TMPL_{parameter}` for template replacements i.e. you can leave out the `TMPL_`.\n *\n */\nexport interface TealTemplateParams {\n  [key: string]: string | bigint | number | Uint8Array\n}\n\n/** What action to perform when deploying an app and an update is detected in the TEAL code */\nexport enum OnUpdate {\n  /** Fail the deployment */\n  Fail,\n  /** Update the app */\n  UpdateApp,\n  /** Delete the app and create a new one in its place */\n  ReplaceApp,\n  /** Create a new app */\n  AppendApp,\n}\n\n/** What action to perform when deploying an app and a breaking schema change is detected */\nexport enum OnSchemaBreak {\n  /** Fail the deployment */\n  Fail,\n  /** Delete the app and create a new one in its place */\n  ReplaceApp,\n  /** Create a new app */\n  AppendApp,\n}\n\n/** The result of compiling the approval and clear state TEAL programs for an app */\nexport interface AppCompilationResult {\n  /** The result of compiling the approval program */\n  compiledApproval: CompiledTeal\n  /** The result of compiling the clear state program */\n  compiledClear: CompiledTeal\n}\n\nexport type AppReturn<TReturn> = {\n  /** The ABI method call return value */\n  return?: TReturn\n}\n\n/** Result from sending a single app transaction. */\nexport type SendAppTransactionResult = Expand<\n  SendSingleTransactionResult & {\n    /** If an ABI method was called the processed return value */\n    return?: ABIReturn\n  }\n>\n\n/** Result from sending a single app transaction. */\nexport type SendAppUpdateTransactionResult = Expand<SendAppTransactionResult & Partial<AppCompilationResult>>\n\n/** Result from sending a single app transaction. */\nexport type SendAppCreateTransactionResult = Expand<\n  SendAppUpdateTransactionResult & {\n    /** The id of the created app */\n    appId: bigint\n    /** The Algorand address of the account associated with the app */\n    appAddress: Address\n  }\n>\n\n/** Object holding app state values */\nexport interface AppState {\n  [key: string]:\n    | {\n        value: bigint\n        keyRaw: Uint8Array\n        keyBase64: string\n      }\n    | {\n        value: string\n        valueRaw: Uint8Array\n        valueBase64: string\n        keyRaw: Uint8Array\n        keyBase64: string\n      }\n}\n\n/**\n * The name of a box storage box */\nexport interface BoxName {\n  /** Name in UTF-8 */\n  name: string\n  /** Name in binary bytes */\n  nameRaw: Uint8Array\n  /** Name in Base64 */\n  nameBase64: string\n}\n\n/**\n * @deprecated Use `types/app-manager/BoxValueRequestParams` instead.\n * Parameters to get and decode a box value as an ABI type.\n */\nexport interface BoxValueRequestParams {\n  /** The ID of the app return box names for */\n  appId: number | bigint\n  /** The name of the box to return either as a string, binary array or `BoxName` */\n  boxName: string | Uint8Array | BoxName\n  /** The ABI type to decode the value using */\n  type: ABIType\n}\n\n/**\n * @deprecated Use `types/app-manager/BoxValuesRequestParams` instead.\n * Parameters to get and decode a box value as an ABI type.\n */\nexport interface BoxValuesRequestParams {\n  /** The ID of the app return box names for */\n  appId: number\n  /** The names of the boxes to return either as a string, binary array or BoxName` */\n  boxNames: (string | Uint8Array | BoxName)[]\n  /** The ABI type to decode the value using */\n  type: ABIType\n}\n"],"mappings":";;AAmBA,MAAa,0BAA0B;;AAGvC,MAAa,0BAA0B;;AAGvC,MAAa,uBAAuB;;AAGpC,MAAa,oBAAoB;;AAGjC,MAAa,oBAAoB,IAAI,WAAW;CAAC;CAAI;CAAI;CAAK;CAAI,CAAC;;AAiKnE,IAAY,gDAAL;;AAEL;;AAEA;;AAEA;;AAEA;;;;AAIF,IAAY,0DAAL;;AAEL;;AAEA;;AAEA"}

package/types/async-event-emitter.d.ts

@@ -5,12 +5,9 @@ type AsyncEventListener<T = unknown> = (event: T, eventName: string | symbol) =>
 declare class AsyncEventEmitter {
   private listenerWrapperMap;
   private listenerMap;
-  emitAsync<K extends EventType>(eventName: K, event: EventDataMap[K]): Promise<void>;
-  emitAsync(eventName: string | symbol, event: unknown): Promise<void>;
-  on<K extends EventType>(eventName: K, listener: AsyncEventListener<EventDataMap[K]>): AsyncEventEmitter;
-  on<T = unknown>(eventName: string | symbol, listener: AsyncEventListener<T>): AsyncEventEmitter;
-  once<K extends EventType>(eventName: K, listener: AsyncEventListener<EventDataMap[K]>): AsyncEventEmitter;
-  once<T = unknown>(eventName: string | symbol, listener: AsyncEventListener<T>): AsyncEventEmitter;
+  emitAsync<K extends string | symbol>(eventName: K, event: K extends EventType ? EventDataMap[K] : unknown): Promise<void>;
+  on<K extends string | symbol>(eventName: K, listener: AsyncEventListener<K extends EventType ? EventDataMap[K] : unknown>): AsyncEventEmitter;
+  once<K extends string | symbol>(eventName: K, listener: AsyncEventListener<K extends EventType ? EventDataMap[K] : unknown>): AsyncEventEmitter;
   removeListener(eventName: string | symbol, listener: AsyncEventListener): AsyncEventEmitter;
   off: (eventName: string | symbol, listener: AsyncEventListener) => AsyncEventEmitter;
 }

package/types/async-event-emitter.js.map

@@ -1 +1 @@
-{"version":3,"file":"async-event-emitter.js","names":["wrappedListener: AsyncEventListener","eventName"],"sources":["../../src/types/async-event-emitter.ts"],"sourcesContent":["import { EventDataMap, EventType } from './lifecycle-events'\n\nexport type AsyncEventListener<T = unknown> = (event: T, eventName: string | symbol) => Promise<void> | void\n\nexport class AsyncEventEmitter {\n  private listenerWrapperMap = new WeakMap<AsyncEventListener, AsyncEventListener>()\n  private listenerMap: Record<string | symbol, AsyncEventListener[]> = {}\n\n  async emitAsync<K extends EventType>(eventName: K, event: EventDataMap[K]): Promise<void>\n  async emitAsync(eventName: string | symbol, event: unknown): Promise<void>\n  async emitAsync(eventName: string | symbol, event: unknown): Promise<void> {\n    for (const listener of this.listenerMap[eventName] ?? []) {\n      await listener(event, eventName)\n    }\n  }\n\n  on<K extends EventType>(eventName: K, listener: AsyncEventListener<EventDataMap[K]>): AsyncEventEmitter\n  on<T = unknown>(eventName: string | symbol, listener: AsyncEventListener<T>): AsyncEventEmitter\n  on(eventName: string | symbol, listener: AsyncEventListener): AsyncEventEmitter {\n    if (!this.listenerMap[eventName]) this.listenerMap[eventName] = []\n    this.listenerMap[eventName].push(listener as AsyncEventListener)\n    return this\n  }\n\n  once<K extends EventType>(eventName: K, listener: AsyncEventListener<EventDataMap[K]>): AsyncEventEmitter\n  once<T = unknown>(eventName: string | symbol, listener: AsyncEventListener<T>): AsyncEventEmitter\n  once(eventName: string | symbol, listener: AsyncEventListener): AsyncEventEmitter {\n    const wrappedListener: AsyncEventListener = async (event, eventName) => {\n      try {\n        return await listener(event, eventName)\n      } finally {\n        this.removeListener(eventName, wrappedListener)\n      }\n    }\n    this.listenerWrapperMap.set(listener, wrappedListener)\n    return this.on(eventName, wrappedListener)\n  }\n\n  removeListener(eventName: string | symbol, listener: AsyncEventListener): AsyncEventEmitter {\n    const wrappedListener = this.listenerWrapperMap.get(listener)\n    if (wrappedListener) {\n      this.listenerWrapperMap.delete(listener)\n      if (this.listenerMap[eventName]?.indexOf(wrappedListener) !== -1) {\n        this.listenerMap[eventName].splice(this.listenerMap[eventName].indexOf(wrappedListener), 1)\n      }\n    } else {\n      if (this.listenerMap[eventName]?.indexOf(listener) !== -1) {\n        this.listenerMap[eventName].splice(this.listenerMap[eventName].indexOf(listener), 1)\n      }\n    }\n\n    return this\n  }\n\n  off = this.removeListener\n}\n"],"mappings":";;AAIA,IAAa,oBAAb,MAA+B;CAC7B,AAAQ,qCAAqB,IAAI,SAAiD;CAClF,AAAQ,cAA6D,EAAE;CAIvE,MAAM,UAAU,WAA4B,OAA+B;AACzE,OAAK,MAAM,YAAY,KAAK,YAAY,cAAc,EAAE,CACtD,OAAM,SAAS,OAAO,UAAU;;CAMpC,GAAG,WAA4B,UAAiD;AAC9E,MAAI,CAAC,KAAK,YAAY,WAAY,MAAK,YAAY,aAAa,EAAE;AAClE,OAAK,YAAY,WAAW,KAAK,SAA+B;AAChE,SAAO;;CAKT,KAAK,WAA4B,UAAiD;EAChF,MAAMA,kBAAsC,OAAO,OAAO,gBAAc;AACtE,OAAI;AACF,WAAO,MAAM,SAAS,OAAOC,YAAU;aAC/B;AACR,SAAK,eAAeA,aAAW,gBAAgB;;;AAGnD,OAAK,mBAAmB,IAAI,UAAU,gBAAgB;AACtD,SAAO,KAAK,GAAG,WAAW,gBAAgB;;CAG5C,eAAe,WAA4B,UAAiD;EAC1F,MAAM,kBAAkB,KAAK,mBAAmB,IAAI,SAAS;AAC7D,MAAI,iBAAiB;AACnB,QAAK,mBAAmB,OAAO,SAAS;AACxC,OAAI,KAAK,YAAY,YAAY,QAAQ,gBAAgB,KAAK,GAC5D,MAAK,YAAY,WAAW,OAAO,KAAK,YAAY,WAAW,QAAQ,gBAAgB,EAAE,EAAE;aAGzF,KAAK,YAAY,YAAY,QAAQ,SAAS,KAAK,GACrD,MAAK,YAAY,WAAW,OAAO,KAAK,YAAY,WAAW,QAAQ,SAAS,EAAE,EAAE;AAIxF,SAAO;;CAGT,MAAM,KAAK"}
+{"version":3,"file":"async-event-emitter.js","names":["wrappedListener: AsyncEventListener","eventName"],"sources":["../../src/types/async-event-emitter.ts"],"sourcesContent":["import { EventDataMap, EventType } from './lifecycle-events'\n\nexport type AsyncEventListener<T = unknown> = (event: T, eventName: string | symbol) => Promise<void> | void\n\nexport class AsyncEventEmitter {\n  private listenerWrapperMap = new WeakMap<AsyncEventListener, AsyncEventListener>()\n  private listenerMap: Record<string | symbol, AsyncEventListener[]> = {}\n\n  async emitAsync<K extends string | symbol>(eventName: K, event: K extends EventType ? EventDataMap[K] : unknown): Promise<void> {\n    for (const listener of this.listenerMap[eventName] ?? []) {\n      await listener(event, eventName)\n    }\n  }\n\n  on<K extends string | symbol>(\n    eventName: K,\n    listener: AsyncEventListener<K extends EventType ? EventDataMap[K] : unknown>,\n  ): AsyncEventEmitter {\n    if (!this.listenerMap[eventName]) this.listenerMap[eventName] = []\n    this.listenerMap[eventName].push(listener as AsyncEventListener)\n    return this\n  }\n\n  once<K extends string | symbol>(\n    eventName: K,\n    listener: AsyncEventListener<K extends EventType ? EventDataMap[K] : unknown>,\n  ): AsyncEventEmitter {\n    const wrappedListener: AsyncEventListener = async (event, eventName) => {\n      try {\n        return await (listener as AsyncEventListener)(event, eventName)\n      } finally {\n        this.removeListener(eventName, wrappedListener)\n      }\n    }\n    this.listenerWrapperMap.set(listener as AsyncEventListener, wrappedListener)\n    return this.on(eventName, wrappedListener as AsyncEventListener<K extends EventType ? EventDataMap[K] : unknown>)\n  }\n\n  removeListener(eventName: string | symbol, listener: AsyncEventListener): AsyncEventEmitter {\n    const wrappedListener = this.listenerWrapperMap.get(listener)\n    if (wrappedListener) {\n      this.listenerWrapperMap.delete(listener)\n      if (this.listenerMap[eventName]?.indexOf(wrappedListener) !== -1) {\n        this.listenerMap[eventName].splice(this.listenerMap[eventName].indexOf(wrappedListener), 1)\n      }\n    } else {\n      if (this.listenerMap[eventName]?.indexOf(listener) !== -1) {\n        this.listenerMap[eventName].splice(this.listenerMap[eventName].indexOf(listener), 1)\n      }\n    }\n\n    return this\n  }\n\n  off = this.removeListener\n}\n"],"mappings":";;AAIA,IAAa,oBAAb,MAA+B;CAC7B,AAAQ,qCAAqB,IAAI,SAAiD;CAClF,AAAQ,cAA6D,EAAE;CAEvE,MAAM,UAAqC,WAAc,OAAuE;AAC9H,OAAK,MAAM,YAAY,KAAK,YAAY,cAAc,EAAE,CACtD,OAAM,SAAS,OAAO,UAAU;;CAIpC,GACE,WACA,UACmB;AACnB,MAAI,CAAC,KAAK,YAAY,WAAY,MAAK,YAAY,aAAa,EAAE;AAClE,OAAK,YAAY,WAAW,KAAK,SAA+B;AAChE,SAAO;;CAGT,KACE,WACA,UACmB;EACnB,MAAMA,kBAAsC,OAAO,OAAO,gBAAc;AACtE,OAAI;AACF,WAAO,MAAO,SAAgC,OAAOC,YAAU;aACvD;AACR,SAAK,eAAeA,aAAW,gBAAgB;;;AAGnD,OAAK,mBAAmB,IAAI,UAAgC,gBAAgB;AAC5E,SAAO,KAAK,GAAG,WAAW,gBAAuF;;CAGnH,eAAe,WAA4B,UAAiD;EAC1F,MAAM,kBAAkB,KAAK,mBAAmB,IAAI,SAAS;AAC7D,MAAI,iBAAiB;AACnB,QAAK,mBAAmB,OAAO,SAAS;AACxC,OAAI,KAAK,YAAY,YAAY,QAAQ,gBAAgB,KAAK,GAC5D,MAAK,YAAY,WAAW,OAAO,KAAK,YAAY,WAAW,QAAQ,gBAAgB,EAAE,EAAE;aAGzF,KAAK,YAAY,YAAY,QAAQ,SAAS,KAAK,GACrD,MAAK,YAAY,WAAW,OAAO,KAAK,YAAY,WAAW,QAAQ,SAAS,EAAE,EAAE;AAIxF,SAAO;;CAGT,MAAM,KAAK"}

package/types/async-event-emitter.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"async-event-emitter.mjs","names":["wrappedListener: AsyncEventListener","eventName"],"sources":["../../src/types/async-event-emitter.ts"],"sourcesContent":["import { EventDataMap, EventType } from './lifecycle-events'\n\nexport type AsyncEventListener<T = unknown> = (event: T, eventName: string | symbol) => Promise<void> | void\n\nexport class AsyncEventEmitter {\n  private listenerWrapperMap = new WeakMap<AsyncEventListener, AsyncEventListener>()\n  private listenerMap: Record<string | symbol, AsyncEventListener[]> = {}\n\n  async emitAsync<K extends EventType>(eventName: K, event: EventDataMap[K]): Promise<void>\n  async emitAsync(eventName: string | symbol, event: unknown): Promise<void>\n  async emitAsync(eventName: string | symbol, event: unknown): Promise<void> {\n    for (const listener of this.listenerMap[eventName] ?? []) {\n      await listener(event, eventName)\n    }\n  }\n\n  on<K extends EventType>(eventName: K, listener: AsyncEventListener<EventDataMap[K]>): AsyncEventEmitter\n  on<T = unknown>(eventName: string | symbol, listener: AsyncEventListener<T>): AsyncEventEmitter\n  on(eventName: string | symbol, listener: AsyncEventListener): AsyncEventEmitter {\n    if (!this.listenerMap[eventName]) this.listenerMap[eventName] = []\n    this.listenerMap[eventName].push(listener as AsyncEventListener)\n    return this\n  }\n\n  once<K extends EventType>(eventName: K, listener: AsyncEventListener<EventDataMap[K]>): AsyncEventEmitter\n  once<T = unknown>(eventName: string | symbol, listener: AsyncEventListener<T>): AsyncEventEmitter\n  once(eventName: string | symbol, listener: AsyncEventListener): AsyncEventEmitter {\n    const wrappedListener: AsyncEventListener = async (event, eventName) => {\n      try {\n        return await listener(event, eventName)\n      } finally {\n        this.removeListener(eventName, wrappedListener)\n      }\n    }\n    this.listenerWrapperMap.set(listener, wrappedListener)\n    return this.on(eventName, wrappedListener)\n  }\n\n  removeListener(eventName: string | symbol, listener: AsyncEventListener): AsyncEventEmitter {\n    const wrappedListener = this.listenerWrapperMap.get(listener)\n    if (wrappedListener) {\n      this.listenerWrapperMap.delete(listener)\n      if (this.listenerMap[eventName]?.indexOf(wrappedListener) !== -1) {\n        this.listenerMap[eventName].splice(this.listenerMap[eventName].indexOf(wrappedListener), 1)\n      }\n    } else {\n      if (this.listenerMap[eventName]?.indexOf(listener) !== -1) {\n        this.listenerMap[eventName].splice(this.listenerMap[eventName].indexOf(listener), 1)\n      }\n    }\n\n    return this\n  }\n\n  off = this.removeListener\n}\n"],"mappings":";AAIA,IAAa,oBAAb,MAA+B;CAC7B,AAAQ,qCAAqB,IAAI,SAAiD;CAClF,AAAQ,cAA6D,EAAE;CAIvE,MAAM,UAAU,WAA4B,OAA+B;AACzE,OAAK,MAAM,YAAY,KAAK,YAAY,cAAc,EAAE,CACtD,OAAM,SAAS,OAAO,UAAU;;CAMpC,GAAG,WAA4B,UAAiD;AAC9E,MAAI,CAAC,KAAK,YAAY,WAAY,MAAK,YAAY,aAAa,EAAE;AAClE,OAAK,YAAY,WAAW,KAAK,SAA+B;AAChE,SAAO;;CAKT,KAAK,WAA4B,UAAiD;EAChF,MAAMA,kBAAsC,OAAO,OAAO,gBAAc;AACtE,OAAI;AACF,WAAO,MAAM,SAAS,OAAOC,YAAU;aAC/B;AACR,SAAK,eAAeA,aAAW,gBAAgB;;;AAGnD,OAAK,mBAAmB,IAAI,UAAU,gBAAgB;AACtD,SAAO,KAAK,GAAG,WAAW,gBAAgB;;CAG5C,eAAe,WAA4B,UAAiD;EAC1F,MAAM,kBAAkB,KAAK,mBAAmB,IAAI,SAAS;AAC7D,MAAI,iBAAiB;AACnB,QAAK,mBAAmB,OAAO,SAAS;AACxC,OAAI,KAAK,YAAY,YAAY,QAAQ,gBAAgB,KAAK,GAC5D,MAAK,YAAY,WAAW,OAAO,KAAK,YAAY,WAAW,QAAQ,gBAAgB,EAAE,EAAE;aAGzF,KAAK,YAAY,YAAY,QAAQ,SAAS,KAAK,GACrD,MAAK,YAAY,WAAW,OAAO,KAAK,YAAY,WAAW,QAAQ,SAAS,EAAE,EAAE;AAIxF,SAAO;;CAGT,MAAM,KAAK"}
+{"version":3,"file":"async-event-emitter.mjs","names":["wrappedListener: AsyncEventListener","eventName"],"sources":["../../src/types/async-event-emitter.ts"],"sourcesContent":["import { EventDataMap, EventType } from './lifecycle-events'\n\nexport type AsyncEventListener<T = unknown> = (event: T, eventName: string | symbol) => Promise<void> | void\n\nexport class AsyncEventEmitter {\n  private listenerWrapperMap = new WeakMap<AsyncEventListener, AsyncEventListener>()\n  private listenerMap: Record<string | symbol, AsyncEventListener[]> = {}\n\n  async emitAsync<K extends string | symbol>(eventName: K, event: K extends EventType ? EventDataMap[K] : unknown): Promise<void> {\n    for (const listener of this.listenerMap[eventName] ?? []) {\n      await listener(event, eventName)\n    }\n  }\n\n  on<K extends string | symbol>(\n    eventName: K,\n    listener: AsyncEventListener<K extends EventType ? EventDataMap[K] : unknown>,\n  ): AsyncEventEmitter {\n    if (!this.listenerMap[eventName]) this.listenerMap[eventName] = []\n    this.listenerMap[eventName].push(listener as AsyncEventListener)\n    return this\n  }\n\n  once<K extends string | symbol>(\n    eventName: K,\n    listener: AsyncEventListener<K extends EventType ? EventDataMap[K] : unknown>,\n  ): AsyncEventEmitter {\n    const wrappedListener: AsyncEventListener = async (event, eventName) => {\n      try {\n        return await (listener as AsyncEventListener)(event, eventName)\n      } finally {\n        this.removeListener(eventName, wrappedListener)\n      }\n    }\n    this.listenerWrapperMap.set(listener as AsyncEventListener, wrappedListener)\n    return this.on(eventName, wrappedListener as AsyncEventListener<K extends EventType ? EventDataMap[K] : unknown>)\n  }\n\n  removeListener(eventName: string | symbol, listener: AsyncEventListener): AsyncEventEmitter {\n    const wrappedListener = this.listenerWrapperMap.get(listener)\n    if (wrappedListener) {\n      this.listenerWrapperMap.delete(listener)\n      if (this.listenerMap[eventName]?.indexOf(wrappedListener) !== -1) {\n        this.listenerMap[eventName].splice(this.listenerMap[eventName].indexOf(wrappedListener), 1)\n      }\n    } else {\n      if (this.listenerMap[eventName]?.indexOf(listener) !== -1) {\n        this.listenerMap[eventName].splice(this.listenerMap[eventName].indexOf(listener), 1)\n      }\n    }\n\n    return this\n  }\n\n  off = this.removeListener\n}\n"],"mappings":";AAIA,IAAa,oBAAb,MAA+B;CAC7B,AAAQ,qCAAqB,IAAI,SAAiD;CAClF,AAAQ,cAA6D,EAAE;CAEvE,MAAM,UAAqC,WAAc,OAAuE;AAC9H,OAAK,MAAM,YAAY,KAAK,YAAY,cAAc,EAAE,CACtD,OAAM,SAAS,OAAO,UAAU;;CAIpC,GACE,WACA,UACmB;AACnB,MAAI,CAAC,KAAK,YAAY,WAAY,MAAK,YAAY,aAAa,EAAE;AAClE,OAAK,YAAY,WAAW,KAAK,SAA+B;AAChE,SAAO;;CAGT,KACE,WACA,UACmB;EACnB,MAAMA,kBAAsC,OAAO,OAAO,gBAAc;AACtE,OAAI;AACF,WAAO,MAAO,SAAgC,OAAOC,YAAU;aACvD;AACR,SAAK,eAAeA,aAAW,gBAAgB;;;AAGnD,OAAK,mBAAmB,IAAI,UAAgC,gBAAgB;AAC5E,SAAO,KAAK,GAAG,WAAW,gBAAuF;;CAGnH,eAAe,WAA4B,UAAiD;EAC1F,MAAM,kBAAkB,KAAK,mBAAmB,IAAI,SAAS;AAC7D,MAAI,iBAAiB;AACnB,QAAK,mBAAmB,OAAO,SAAS;AACxC,OAAI,KAAK,YAAY,YAAY,QAAQ,gBAAgB,KAAK,GAC5D,MAAK,YAAY,WAAW,OAAO,KAAK,YAAY,WAAW,QAAQ,gBAAgB,EAAE,EAAE;aAGzF,KAAK,YAAY,YAAY,QAAQ,SAAS,KAAK,GACrD,MAAK,YAAY,WAAW,OAAO,KAAK,YAAY,WAAW,QAAQ,SAAS,EAAE,EAAE;AAIxF,SAAO;;CAGT,MAAM,KAAK"}

package/types/client-manager.d.ts

@@ -1,5 +1,5 @@
+import { Expand } from "../packages/common/src/expand.js";
 import { AlgodClient } from "../packages/algod_client/src/client.js";
-import { Expand } from "./expand.js";
 import { IndexerClient } from "../packages/indexer_client/src/client.js";
 import { KmdClient } from "../packages/kmd_client/src/client.js";
 import { AppClient, AppClientParams, ResolveAppClientByCreatorAndName } from "./app-client.js";