Parameterizing Future types

[liamgriffiths]

The main idea here is that we'd like to use a parameterized Future type instead of more specific instances with associated methods and instead implement additional helpers as functions that are also parameterized by the Future types they accept and return.

This change would incur some amount of breaking changes, but maintain equivalent functionality with the goal of simplifying code/understandability for future SDK user code.

⚠️ Breaking Changes

Future types will be represented as a single Future generic type

// eg.
FutureString -> Future<string>
FutureNumber -> Future<number>
FutureObject -> Future<Object>
FutureBoolean -> Future<boolean>
FutureAnyObject -> Future<Object>

String Futures no longer implement the .concat instance method

This method was already exported under sb and can continue to be used as expected.

// before
let before = futureString.concat("some", "more", "strings"); // -> FutureString

// after
import { sb } from "substrate";
let after = sb.concat(futureString, "some", "more", "strings"); // -> Future<string>

Object Futures no longer implement the .get instance method

This method will be exported under sb (similar to other future methods)

// before
let before = futureObject.get("someProperty"); // -> FutureAnyObject
let before2 = futureObject.get("someProperty.path[123]"); // -> FutureAnyObject

// after
import { sb } from "substrate";
let after = sb.get<someType>(futureObject, "someProperty"); // -> Future<someType>
let after2 = sb.get<someType>(futureObject, "someProperty.path[123]"); // -> Future<someType>
let after3 = sb.get(futureObject, "someProperty"); // -> Future<unknown>

sb.jq helper function accepts non-string type parameters and deprecates type-mapping argument

Code that uses these previous type mappings should be updated.

// before
let before = sb.jq<"number">(futureObject, ".property", "number"); // -> FutureNumber

// after
let after = sb.jq<string>(futureObject, ".property"); // -> Future<string>
let after = sb.jq(futureObject, ".property"); // -> Future<unknown>

[kousun12]

i love this