move toExternalValue function to util since impl types are not exported

anymore

Author: boblat

package.json

@@ -15,7 +15,7 @@
     "build:1-lint": "eslint \"src/**/*.ts\" \"tests/**/*.ts\" --max-warnings 0",
     "build:2-check-types": "tsc -p tsconfig.json",
     "build:3-build": "rollup -c --configPlugin typescript",
-    "build:4-remove-internal-types": "rimraf dist/impl/**/*.d.ts dist/internal/*.d.ts -g",
+    "build:4-remove-internal-types": "rimraf -g dist/impl/*.d.ts dist/impl/**/*.d.ts dist/internal/*.d.ts",
     "build:5-copy-pkg-json": "tstk copy-package-json -c",
     "build:6-copy-readme": "copyfiles ./README.md ./dist",
     "watch": "rollup -c -w --configPlugin typescript",

src/impl/primitives.ts

@@ -12,46 +12,6 @@ export type StubBigUintCompat = BigUintCompat | BigUintCls | Uint64Cls
 export type StubBytesCompat = BytesCompat | BytesCls
 export type StubUint64Compat = Uint64Compat | Uint64Cls
 
-/**
- * Converts internal Algorand type representations to their external primitive values.
- *
- * @overload
- * @param {uint64} val - A uint64 value to convert
- * @returns {bigint} The uint64 value as a bigint
- *
- * @overload
- * @param {biguint} val - A biguint value to convert
- * @returns {bigint} The biguint value as a bigint
- *
- * @overload
- * @param {bytes} val - A bytes value to convert
- * @returns {Uint8Array} The bytes value as a Uint8Array
- *
- * @overload
- * @param {string} val - A string value to pass through
- * @returns {string} The original string value unchanged
- *
- * @example
- * ```ts
- * const uint64Val = Uint64(123n)
- * toExternalValue(uint64Val) // returns 123n
- *
- * const bytesVal = Bytes.fromBase64("SGVsbG8=");
- * toExternalValue(bytesVal) // returns Uint8Array([72, 101, 108, 108, 111])
- * ```
- */
-export function toExternalValue(val: uint64): bigint
-export function toExternalValue(val: biguint): bigint
-export function toExternalValue(val: bytes): Uint8Array
-export function toExternalValue(val: string): string
-export function toExternalValue(val: uint64 | biguint | bytes | string) {
-  const instance = val as unknown
-  if (instance instanceof BytesCls) return instance.asUint8Array()
-  if (instance instanceof Uint64Cls) return instance.asBigInt()
-  if (instance instanceof BigUintCls) return instance.asBigInt()
-  if (typeof val === 'string') return val
-}
-
 /**
  * Create a uint64 with the default value of 0
  */

src/index.ts

@@ -1,5 +1,5 @@
 export { ApplicationSpy } from './application-spy'
 export { AssertError, AvmError, CodeError, InternalError, NotImplementedError } from './errors'
-export { toExternalValue } from './impl/primitives'
 export { addEqualityTesters } from './set-up'
 export { TestExecutionContext } from './test-execution-context'
+export { toExternalValue } from './util'

src/util.ts

@@ -1,11 +1,51 @@
-import type { bytes } from '@algorandfoundation/algorand-typescript'
+import type { biguint, bytes, uint64 } from '@algorandfoundation/algorand-typescript'
 import { randomBytes } from 'crypto'
 import { BITS_IN_BYTE, MAX_BYTES_SIZE, MAX_UINT512, MAX_UINT8, UINT512_SIZE } from './constants'
 import { AssertError, AvmError, InternalError } from './errors'
 import type { StubBigUintCompat, StubBytesCompat, StubUint64Compat } from './impl/primitives'
 import { BigUintCls, Bytes, BytesCls, Uint64Cls } from './impl/primitives'
 import type { DeliberateAny } from './typescript-helpers'
 
+/**
+ * Converts internal Algorand type representations to their external primitive values.
+ *
+ * @overload
+ * @param {uint64} val - A uint64 value to convert
+ * @returns {bigint} The uint64 value as a bigint
+ *
+ * @overload
+ * @param {biguint} val - A biguint value to convert
+ * @returns {bigint} The biguint value as a bigint
+ *
+ * @overload
+ * @param {bytes} val - A bytes value to convert
+ * @returns {Uint8Array} The bytes value as a Uint8Array
+ *
+ * @overload
+ * @param {string} val - A string value to pass through
+ * @returns {string} The original string value unchanged
+ *
+ * @example
+ * ```ts
+ * const uint64Val = Uint64(123n)
+ * toExternalValue(uint64Val) // returns 123n
+ *
+ * const bytesVal = Bytes.fromBase64("SGVsbG8=");
+ * toExternalValue(bytesVal) // returns Uint8Array([72, 101, 108, 108, 111])
+ * ```
+ */
+export function toExternalValue(val: uint64): bigint
+export function toExternalValue(val: biguint): bigint
+export function toExternalValue(val: bytes): Uint8Array
+export function toExternalValue(val: string): string
+export function toExternalValue(val: uint64 | biguint | bytes | string) {
+  const instance = val as unknown
+  if (instance instanceof BytesCls) return instance.asUint8Array()
+  if (instance instanceof Uint64Cls) return instance.asBigInt()
+  if (instance instanceof BigUintCls) return instance.asBigInt()
+  if (typeof val === 'string') return val
+}
+
 export function* iterBigInt(start: bigint, end: bigint): Generator<bigint> {
   for (let i = start; i < end; i++) {
     yield BigInt(i)