fix(hazard_symbol): start fixing dual-package hazard symbol

[p2arthur]

Fix Dual Package Hazard with Symbol.hasInstance (Draft)

Status: Draft — currently updating utils-ts

Problem

When a package is loaded as both CommonJS and ESM, instanceof checks can fail across boundaries because the same class is created twice (one per loader). This can make instanceof return false for valid instances.

Solution

Add a unique instance marker property and a static Symbol.hasInstance method to each class so instanceof works regardless of how the class was loaded.

Pattern example:

export class SomeClass {
  // unique marker on instances
  private readonly _isSomeClass = true;

  // cross-module instanceof check
  static [Symbol.hasInstance](instance: unknown): boolean {
    return !!(instance && (instance as any)._isSomeClass === true);
  }
}

After applying the pattern to a file, change [] to [x].

---

Files to Update (tick as you go)

• ./types/account.ts:20 — MultisigAccount
• ./types/account.ts:79 — SigningAccount (implements Account)
• [] ./types/app-arc56.ts:23 — Arc56Method (extends algosdk.ABIMethod)
• [] ./types/app-client.ts:478 — AppClient
• [] ./types/app-client.ts:1794 — ApplicationClient
• [] ./types/app-manager.ts:98 — AppManager
• [] ./types/account-manager.ts:46 — AccountManager
• [] ./types/algorand-client-transaction-sender.ts:36 — AlgorandClientTransactionSender
• ./types/app-deployer.ts:112 — AppDeployer
• [] ./types/logic-error.ts:22 — LogicError (extends Error)
• [] ./types/client-manager.ts:48 — ClientManager
• [] ./types/algorand-client.ts:18 — AlgorandClient
• [] ./types/async-event-emitter.ts:5 — AsyncEventEmitter
• [] ./types/kmd-account-manager.ts:10 — KmdAccountManager
• [] ./types/algorand-client-transaction-creator.ts:8 — AlgorandClientTransactionCreator
• ./types/composer.ts:547 — TransactionComposer
• [] ./types/algo-http-client-with-retry.ts:6 — AlgoHttpClientWithRetry (extends URLTokenBaseHTTPClient)
• [] ./types/dispenser-client.ts:72 — TestNetDispenserApiClient
• [] ./types/config.ts:28 — UpdatableConfig (implements Readonly<Config>)
• [] ./types/amount.ts:4 — AlgoAmount
• [] ./types/asset-manager.ts:138 — AssetManager
• [] ./types/app-factory.ts:170 — AppFactory
• ./testing/test-logger.ts:8 — TestLogger (implements Logger)
• [] ./testing/transaction-logger.ts:12 — TransactionLogger
• [] ./util.ts:25 — UnsafeConversionError (extends Error)

---

Testing

• tests/11.DualPackageHazard.ts verifies cross-module instanceof for both CJS and ESM.
• Optional manual check: import the same class via CJS and ESM and confirm instanceof returns true across boundaries.