@ic-reactor/candid 3.0.7-beta.1 → 3.0.8-beta.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -1
- package/dist/display-reactor.d.ts +3 -2
- package/dist/display-reactor.d.ts.map +1 -1
- package/dist/display-reactor.js +6 -0
- package/dist/display-reactor.js.map +1 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/dist/metadata-display-reactor.d.ts +73 -0
- package/dist/metadata-display-reactor.d.ts.map +1 -0
- package/dist/metadata-display-reactor.js +128 -0
- package/dist/metadata-display-reactor.js.map +1 -0
- package/dist/visitor/arguments/index.d.ts +69 -0
- package/dist/visitor/arguments/index.d.ts.map +1 -0
- package/dist/visitor/arguments/index.js +277 -0
- package/dist/visitor/arguments/index.js.map +1 -0
- package/dist/visitor/arguments/types.d.ts +92 -0
- package/dist/visitor/arguments/types.d.ts.map +1 -0
- package/dist/visitor/arguments/types.js +2 -0
- package/dist/visitor/arguments/types.js.map +1 -0
- package/dist/visitor/constants.d.ts +4 -0
- package/dist/visitor/constants.d.ts.map +1 -0
- package/dist/visitor/constants.js +61 -0
- package/dist/visitor/constants.js.map +1 -0
- package/dist/visitor/helpers.d.ts +30 -0
- package/dist/visitor/helpers.d.ts.map +1 -0
- package/dist/visitor/helpers.js +200 -0
- package/dist/visitor/helpers.js.map +1 -0
- package/dist/visitor/returns/index.d.ts +76 -0
- package/dist/visitor/returns/index.d.ts.map +1 -0
- package/dist/visitor/returns/index.js +425 -0
- package/dist/visitor/returns/index.js.map +1 -0
- package/dist/visitor/returns/types.d.ts +142 -0
- package/dist/visitor/returns/types.d.ts.map +1 -0
- package/dist/visitor/returns/types.js +2 -0
- package/dist/visitor/returns/types.js.map +1 -0
- package/dist/visitor/types.d.ts +6 -0
- package/dist/visitor/types.d.ts.map +1 -0
- package/dist/visitor/types.js +3 -0
- package/dist/visitor/types.js.map +1 -0
- package/package.json +4 -2
- package/src/adapter.ts +446 -0
- package/src/constants.ts +11 -0
- package/src/display-reactor.ts +332 -0
- package/src/index.ts +7 -0
- package/src/metadata-display-reactor.ts +184 -0
- package/src/reactor.ts +199 -0
- package/src/types.ts +107 -0
- package/src/utils.ts +28 -0
- package/src/visitor/arguments/index.test.ts +882 -0
- package/src/visitor/arguments/index.ts +405 -0
- package/src/visitor/arguments/types.ts +168 -0
- package/src/visitor/constants.ts +62 -0
- package/src/visitor/helpers.ts +221 -0
- package/src/visitor/returns/index.test.ts +2027 -0
- package/src/visitor/returns/index.ts +545 -0
- package/src/visitor/returns/types.ts +271 -0
- package/src/visitor/types.ts +29 -0
|
@@ -0,0 +1,200 @@
|
|
|
1
|
+
export const extractAndSortArgs = (argsObject) => {
|
|
2
|
+
if (!argsObject || typeof argsObject !== "object")
|
|
3
|
+
return [];
|
|
4
|
+
const args = [];
|
|
5
|
+
let index = 0;
|
|
6
|
+
while (Object.prototype.hasOwnProperty.call(argsObject, `arg${index}`)) {
|
|
7
|
+
args.push(argsObject[`arg${index}`]);
|
|
8
|
+
index++;
|
|
9
|
+
}
|
|
10
|
+
return args;
|
|
11
|
+
};
|
|
12
|
+
/**
|
|
13
|
+
* Normalize form state by converting objects with numeric string keys to arrays.
|
|
14
|
+
* TanStack Form sometimes creates { "0": value, "1": value } instead of [value, value]
|
|
15
|
+
* when using indexed field paths like "parent.0.child".
|
|
16
|
+
*
|
|
17
|
+
* This function also handles the variant cleanup case where objects have mixed
|
|
18
|
+
* numeric and named keys (e.g., { "0": old, "Add": current }) by removing
|
|
19
|
+
* orphaned numeric keys.
|
|
20
|
+
*
|
|
21
|
+
* This function recursively processes the form state and fixes these issues.
|
|
22
|
+
*/
|
|
23
|
+
export const normalizeFormState = (value) => {
|
|
24
|
+
// Handle null/undefined
|
|
25
|
+
if (value === null || value === undefined) {
|
|
26
|
+
return value;
|
|
27
|
+
}
|
|
28
|
+
// Handle arrays - recursively normalize each element
|
|
29
|
+
if (Array.isArray(value)) {
|
|
30
|
+
return value.map(normalizeFormState);
|
|
31
|
+
}
|
|
32
|
+
// Handle objects
|
|
33
|
+
if (typeof value === "object") {
|
|
34
|
+
const obj = value;
|
|
35
|
+
const keys = Object.keys(obj);
|
|
36
|
+
// Separate numeric and non-numeric keys
|
|
37
|
+
const numericKeys = keys.filter((k) => /^\d+$/.test(k));
|
|
38
|
+
const namedKeys = keys.filter((k) => !/^\d+$/.test(k));
|
|
39
|
+
// Case 1: All keys are numeric - convert to array
|
|
40
|
+
if (numericKeys.length > 0 && namedKeys.length === 0) {
|
|
41
|
+
const sortedNums = numericKeys.map(Number).sort((a, b) => a - b);
|
|
42
|
+
// Check if keys are consecutive starting from 0
|
|
43
|
+
if (sortedNums.every((num, idx) => num === idx)) {
|
|
44
|
+
return sortedNums.map((k) => normalizeFormState(obj[String(k)]));
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
// Case 2: Mixed keys (variant case) - keep only named keys, remove orphan numeric keys
|
|
48
|
+
if (numericKeys.length > 0 && namedKeys.length > 0) {
|
|
49
|
+
const result = {};
|
|
50
|
+
for (const key of namedKeys) {
|
|
51
|
+
result[key] = normalizeFormState(obj[key]);
|
|
52
|
+
}
|
|
53
|
+
return result;
|
|
54
|
+
}
|
|
55
|
+
// Case 3: All named keys - recursively normalize all values
|
|
56
|
+
const result = {};
|
|
57
|
+
for (const [key, val] of Object.entries(obj)) {
|
|
58
|
+
result[key] = normalizeFormState(val);
|
|
59
|
+
}
|
|
60
|
+
return result;
|
|
61
|
+
}
|
|
62
|
+
// Return primitives as-is
|
|
63
|
+
return value;
|
|
64
|
+
};
|
|
65
|
+
export const convertNanoToDate = (nano) => {
|
|
66
|
+
return new Date(Number(nano) / 1000000);
|
|
67
|
+
};
|
|
68
|
+
export const convertToCycle = (cycles) => {
|
|
69
|
+
const mcycles = cycles / BigInt(1000000);
|
|
70
|
+
if (mcycles >= BigInt(1000000)) {
|
|
71
|
+
const tcycles = mcycles / BigInt(1000000);
|
|
72
|
+
return `${tcycles.toLocaleString()} T`;
|
|
73
|
+
}
|
|
74
|
+
return `${mcycles.toLocaleString()} M`;
|
|
75
|
+
};
|
|
76
|
+
export const convertStringToNumber = (value) => {
|
|
77
|
+
const bits = value.length;
|
|
78
|
+
if (bits >= 16) {
|
|
79
|
+
return BigInt(value);
|
|
80
|
+
}
|
|
81
|
+
else {
|
|
82
|
+
return Number(value);
|
|
83
|
+
}
|
|
84
|
+
};
|
|
85
|
+
export const validateNumberError = (t) => {
|
|
86
|
+
return function validate(value) {
|
|
87
|
+
if (value === "") {
|
|
88
|
+
return true;
|
|
89
|
+
}
|
|
90
|
+
const bits = value.length;
|
|
91
|
+
if (bits >= 16) {
|
|
92
|
+
try {
|
|
93
|
+
const valueAsBigInt = BigInt(value);
|
|
94
|
+
t.covariant(valueAsBigInt);
|
|
95
|
+
return true;
|
|
96
|
+
}
|
|
97
|
+
catch (error) {
|
|
98
|
+
return error.message || "Failed to convert to BigInt";
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
else {
|
|
102
|
+
try {
|
|
103
|
+
const valueAsNumber = Number(value);
|
|
104
|
+
t.covariant(valueAsNumber);
|
|
105
|
+
return true;
|
|
106
|
+
}
|
|
107
|
+
catch (error) {
|
|
108
|
+
return error.message || "Failed to convert to number";
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
};
|
|
112
|
+
};
|
|
113
|
+
export const validateError = (t) => {
|
|
114
|
+
return function validate(value) {
|
|
115
|
+
try {
|
|
116
|
+
t.covariant(value);
|
|
117
|
+
return true;
|
|
118
|
+
}
|
|
119
|
+
catch (error) {
|
|
120
|
+
return error.message || "An error occurred";
|
|
121
|
+
}
|
|
122
|
+
};
|
|
123
|
+
};
|
|
124
|
+
export function isQuery(func) {
|
|
125
|
+
return (func.annotations.includes("query") ||
|
|
126
|
+
func.annotations.includes("composite_query"));
|
|
127
|
+
}
|
|
128
|
+
export function isUrl(str) {
|
|
129
|
+
if (typeof str !== "string")
|
|
130
|
+
return false;
|
|
131
|
+
return str.startsWith("http") || str.startsWith("https");
|
|
132
|
+
}
|
|
133
|
+
export function isImage(str) {
|
|
134
|
+
if (typeof str !== "string")
|
|
135
|
+
return false;
|
|
136
|
+
// Check if the string starts with 'data:image' (indicating base64-encoded image)
|
|
137
|
+
if (str.startsWith("data:image")) {
|
|
138
|
+
return true;
|
|
139
|
+
}
|
|
140
|
+
// List of common image file extensions
|
|
141
|
+
const imageExtensions = [".jpg", ".jpeg", ".png", ".gif", ".svg"];
|
|
142
|
+
// Check if the string ends with any of the image extensions (indicating image URL)
|
|
143
|
+
if (imageExtensions.some((ext) => str.endsWith(ext))) {
|
|
144
|
+
return true;
|
|
145
|
+
}
|
|
146
|
+
return false;
|
|
147
|
+
}
|
|
148
|
+
export function isUuid(str) {
|
|
149
|
+
if (typeof str !== "string")
|
|
150
|
+
return false;
|
|
151
|
+
return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(str);
|
|
152
|
+
}
|
|
153
|
+
export function isCanisterId(str) {
|
|
154
|
+
if (typeof str !== "string")
|
|
155
|
+
return false;
|
|
156
|
+
if (str.length !== 27)
|
|
157
|
+
return false;
|
|
158
|
+
// All canister IDs end with "-cai"
|
|
159
|
+
return str.endsWith("-cai");
|
|
160
|
+
}
|
|
161
|
+
export function isBtcAddress(str) {
|
|
162
|
+
if (typeof str !== "string")
|
|
163
|
+
return false;
|
|
164
|
+
// Bech32 (Mainnet: bc1, Testnet: tb1, Regtest: bcrt1)
|
|
165
|
+
if (/^(bc1|tb1|bcrt1)[a-zA-HJ-NP-Z0-9]{25,60}$/.test(str))
|
|
166
|
+
return true;
|
|
167
|
+
// Base58 (Mainnet: 1/3, Testnet: m/n/2)
|
|
168
|
+
if (/^[13mn2][a-km-zA-HJ-NP-Z1-9]{25,34}$/.test(str))
|
|
169
|
+
return true;
|
|
170
|
+
return false;
|
|
171
|
+
}
|
|
172
|
+
export function isEthAddress(str) {
|
|
173
|
+
if (typeof str !== "string")
|
|
174
|
+
return false;
|
|
175
|
+
return /^0x[a-fA-F0-9]{40}$/.test(str);
|
|
176
|
+
}
|
|
177
|
+
export function isAccountIdentifier(str) {
|
|
178
|
+
if (typeof str !== "string")
|
|
179
|
+
return false;
|
|
180
|
+
// 64 characters hex string (standard for ICP account ids and hashes)
|
|
181
|
+
return /^[a-fA-F0-9]{64}$/.test(str);
|
|
182
|
+
}
|
|
183
|
+
export function isIsoDate(str) {
|
|
184
|
+
if (typeof str !== "string")
|
|
185
|
+
return false;
|
|
186
|
+
// Basic ISO 8601 / RFC 3339 format check
|
|
187
|
+
// YYYY-MM-DDTHH:mm:ss.sssZ (optional milliseconds/nanoseconds and timezone)
|
|
188
|
+
return /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:?\d{2})$/.test(str);
|
|
189
|
+
}
|
|
190
|
+
export function uint8ArrayToHexString(bytes) {
|
|
191
|
+
if (!bytes)
|
|
192
|
+
return "";
|
|
193
|
+
if (Array.isArray(bytes)) {
|
|
194
|
+
return bytes.map((b) => b.toString(16).padStart(2, "0")).join("");
|
|
195
|
+
}
|
|
196
|
+
return Array.from(bytes)
|
|
197
|
+
.map((b) => b.toString(16).padStart(2, "0"))
|
|
198
|
+
.join("");
|
|
199
|
+
}
|
|
200
|
+
//# sourceMappingURL=helpers.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/visitor/helpers.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
import { IDL } from "../types";
|
|
2
|
+
import type { ResultField, RecordResultField, VariantResultField, TupleResultField, OptionalResultField, VectorResultField, BlobResultField, RecursiveResultField, PrincipalResultField, NumberResultField, TextResultField, BooleanResultField, NullResultField, UnknownResultField, MethodResultMeta, ServiceResultMeta } from "./types";
|
|
3
|
+
import type { BaseActor, FunctionName } from "@ic-reactor/core";
|
|
4
|
+
export * from "./types";
|
|
5
|
+
/**
|
|
6
|
+
* ResultFieldVisitor generates metadata for displaying method results from Candid IDL types.
|
|
7
|
+
*
|
|
8
|
+
* ## Design Principles
|
|
9
|
+
*
|
|
10
|
+
* 1. **Works with raw IDL types BEFORE transformation** - generates metadata at initialization
|
|
11
|
+
* 2. **No value dependencies** - metadata describes structure, not specific values
|
|
12
|
+
* 3. **Describes display format** - includes hints for how values will appear after transformation
|
|
13
|
+
* 4. **Efficient** - single traversal, reusable metadata
|
|
14
|
+
* 5. **Resolvable** - metadata can be combined with values at runtime via .resolve(val)
|
|
15
|
+
*
|
|
16
|
+
* ## Key Insight: Metadata vs Values
|
|
17
|
+
*
|
|
18
|
+
* The visitor generates a "schema" that describes:
|
|
19
|
+
* - What type each field is in Candid (nat, Principal, opt, etc.)
|
|
20
|
+
* - What it becomes after display transformation (string, null, etc.)
|
|
21
|
+
* - How it should be formatted (timestamp, cycle, hex, etc.)
|
|
22
|
+
*
|
|
23
|
+
* Values are NOT passed during traversal. Instead, the generated schema
|
|
24
|
+
* is used at render time to properly display transformed values.
|
|
25
|
+
*
|
|
26
|
+
* ## Display Transformations (applied by DisplayCodecVisitor)
|
|
27
|
+
*
|
|
28
|
+
* | Candid Type | Display Type | Notes |
|
|
29
|
+
* |-------------|--------------|-------|
|
|
30
|
+
* | nat, int, nat64, int64 | string | BigInt → string |
|
|
31
|
+
* | Principal | string | Principal.toText() |
|
|
32
|
+
* | opt T | T \| null | [value] → value, [] → null |
|
|
33
|
+
* | vec nat8 (blob) | string | Uint8Array → hex string |
|
|
34
|
+
* | variant { Ok, Err } | unwrapped | { Ok: val } → val (or throws on Err) |
|
|
35
|
+
*
|
|
36
|
+
* @example
|
|
37
|
+
* ```typescript
|
|
38
|
+
* const visitor = new ResultFieldVisitor()
|
|
39
|
+
* const serviceMeta = service.accept(visitor, null)
|
|
40
|
+
*
|
|
41
|
+
* // Get method result metadata
|
|
42
|
+
* const methodMeta = serviceMeta["icrc1_balance_of"]
|
|
43
|
+
* // methodMeta.resultFields[0] = {
|
|
44
|
+
* // type: "number",
|
|
45
|
+
* // candidType: "nat",
|
|
46
|
+
* // displayType: "string",
|
|
47
|
+
* // numberFormat: "normal"
|
|
48
|
+
* // }
|
|
49
|
+
*
|
|
50
|
+
* // At render time, apply to transformed value:
|
|
51
|
+
* const transformedResult = "1000000000" // Already transformed by DisplayCodec
|
|
52
|
+
* renderField(methodMeta.resultFields[0], transformedResult)
|
|
53
|
+
* ```
|
|
54
|
+
*/
|
|
55
|
+
export declare class ResultFieldVisitor<A = BaseActor> extends IDL.Visitor<string, ResultField | MethodResultMeta<A> | ServiceResultMeta<A>> {
|
|
56
|
+
private displayVisitor;
|
|
57
|
+
visitService(t: IDL.ServiceClass): ServiceResultMeta<A>;
|
|
58
|
+
visitFunc(t: IDL.FuncClass, functionName: FunctionName<A>): MethodResultMeta<A>;
|
|
59
|
+
visitRecord(_t: IDL.RecordClass, fields_: Array<[string, IDL.Type]>, label: string): RecordResultField;
|
|
60
|
+
visitVariant(_t: IDL.VariantClass, fields_: Array<[string, IDL.Type]>, label: string): VariantResultField;
|
|
61
|
+
visitTuple<T extends IDL.Type[]>(_t: IDL.TupleClass<T>, components: IDL.Type[], label: string): TupleResultField;
|
|
62
|
+
visitOpt<T>(_t: IDL.OptClass<T>, ty: IDL.Type<T>, label: string): OptionalResultField;
|
|
63
|
+
visitVec<T>(_t: IDL.VecClass<T>, ty: IDL.Type<T>, label: string): VectorResultField | BlobResultField;
|
|
64
|
+
visitRec<T>(t: IDL.RecClass<T>, ty: IDL.ConstructType<T>, label: string): RecursiveResultField;
|
|
65
|
+
visitPrincipal(t: IDL.PrincipalClass, label: string): PrincipalResultField;
|
|
66
|
+
visitText(t: IDL.TextClass, label: string): TextResultField;
|
|
67
|
+
visitBool(t: IDL.BoolClass, label: string): BooleanResultField;
|
|
68
|
+
visitNull(t: IDL.NullClass, label: string): NullResultField;
|
|
69
|
+
visitInt(t: IDL.IntClass, label: string): NumberResultField;
|
|
70
|
+
visitNat(t: IDL.NatClass, label: string): NumberResultField;
|
|
71
|
+
visitFloat(t: IDL.FloatClass, label: string): NumberResultField;
|
|
72
|
+
visitFixedInt(t: IDL.FixedIntClass, label: string): NumberResultField;
|
|
73
|
+
visitFixedNat(t: IDL.FixedNatClass, label: string): NumberResultField;
|
|
74
|
+
visitType<T>(_t: IDL.Type<T>, label: string): UnknownResultField;
|
|
75
|
+
}
|
|
76
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/visitor/returns/index.ts"],"names":[],"mappings":"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"}
|