@ic-reactor/candid 3.0.7-beta.2 → 3.0.8-beta.0

package/dist/visitor/returns/index.js

@@ -0,0 +1,425 @@
+import { isQuery } from "../helpers";
+import { checkTextFormat, checkNumberFormat } from "../constants";
+import { IDL } from "../types";
+import { DisplayCodecVisitor } from "@ic-reactor/core";
+export * from "./types";
+/**
+ * ResultFieldVisitor generates metadata for displaying method results from Candid IDL types.
+ *
+ * ## Design Principles
+ *
+ * 1. **Works with raw IDL types BEFORE transformation** - generates metadata at initialization
+ * 2. **No value dependencies** - metadata describes structure, not specific values
+ * 3. **Describes display format** - includes hints for how values will appear after transformation
+ * 4. **Efficient** - single traversal, reusable metadata
+ * 5. **Resolvable** - metadata can be combined with values at runtime via .resolve(val)
+ *
+ * ## Key Insight: Metadata vs Values
+ *
+ * The visitor generates a "schema" that describes:
+ * - What type each field is in Candid (nat, Principal, opt, etc.)
+ * - What it becomes after display transformation (string, null, etc.)
+ * - How it should be formatted (timestamp, cycle, hex, etc.)
+ *
+ * Values are NOT passed during traversal. Instead, the generated schema
+ * is used at render time to properly display transformed values.
+ *
+ * ## Display Transformations (applied by DisplayCodecVisitor)
+ *
+ * | Candid Type | Display Type | Notes |
+ * |-------------|--------------|-------|
+ * | nat, int, nat64, int64 | string | BigInt → string |
+ * | Principal | string | Principal.toText() |
+ * | opt T | T \| null | [value] → value, [] → null |
+ * | vec nat8 (blob) | string | Uint8Array → hex string |
+ * | variant { Ok, Err } | unwrapped | { Ok: val } → val (or throws on Err) |
+ *
+ * @example
+ * ```typescript
+ * const visitor = new ResultFieldVisitor()
+ * const serviceMeta = service.accept(visitor, null)
+ *
+ * // Get method result metadata
+ * const methodMeta = serviceMeta["icrc1_balance_of"]
+ * // methodMeta.resultFields[0] = {
+ * //   type: "number",
+ * //   candidType: "nat",
+ * //   displayType: "string",
+ * //   numberFormat: "normal"
+ * // }
+ *
+ * // At render time, apply to transformed value:
+ * const transformedResult = "1000000000" // Already transformed by DisplayCodec
+ * renderField(methodMeta.resultFields[0], transformedResult)
+ * ```
+ */
+export class ResultFieldVisitor extends IDL.Visitor {
+    constructor() {
+        super(...arguments);
+        Object.defineProperty(this, "displayVisitor", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new DisplayCodecVisitor()
+        });
+    }
+    // ════════════════════════════════════════════════════════════════════════
+    // Service & Function Level
+    // ════════════════════════════════════════════════════════════════════════
+    visitService(t) {
+        const result = {};
+        for (const [functionName, func] of t._fields) {
+            result[functionName] = func.accept(this, functionName);
+        }
+        return result;
+    }
+    visitFunc(t, functionName) {
+        const functionType = isQuery(t) ? "query" : "update";
+        const resultFields = t.retTypes.map((retType, index) => retType.accept(this, `__ret${index}`));
+        const generateMetadata = (data) => {
+            const dataArray = resultFields.length === 0
+                ? []
+                : resultFields.length === 1
+                    ? [data]
+                    : data;
+            const results = resultFields.map((field, index) => field.resolve(dataArray[index]));
+            return {
+                functionType,
+                functionName,
+                results,
+            };
+        };
+        return {
+            functionType,
+            functionName,
+            resultFields,
+            returnCount: t.retTypes.length,
+            generateMetadata,
+        };
+    }
+    // ════════════════════════════════════════════════════════════════════════
+    // Compound Types
+    // ════════════════════════════════════════════════════════════════════════
+    visitRecord(_t, fields_, label) {
+        const fields = fields_.map(([key, type]) => type.accept(this, key));
+        const field = {
+            type: "record",
+            label,
+            candidType: "record",
+            displayType: "object",
+            fields,
+            resolve(value) {
+                const record = value;
+                if (record == null) {
+                    return { field, value: null, raw: value };
+                }
+                const resolvedFields = {};
+                for (const f of fields) {
+                    resolvedFields[f.label] = f.resolve(record[f.label]);
+                }
+                return { field, value: resolvedFields, raw: value };
+            },
+        };
+        return field;
+    }
+    visitVariant(_t, fields_, label) {
+        const options = [];
+        const optionFields = [];
+        for (const [key, type] of fields_) {
+            options.push(key);
+            optionFields.push(type.accept(this, key));
+        }
+        // Detect if this is a Result type (has Ok and Err options)
+        const isResult = options.includes("Ok") && options.includes("Err");
+        const displayType = isResult ? "result" : "variant";
+        const field = {
+            type: "variant",
+            label,
+            candidType: "variant",
+            displayType,
+            options,
+            optionFields,
+            resolve(value) {
+                if (value == null) {
+                    return { field, value: null, raw: value };
+                }
+                const variant = value;
+                const optionsInValue = Object.keys(variant);
+                const activeOption = optionsInValue.find((opt) => options.includes(opt));
+                if (!activeOption) {
+                    return { field, value: null, raw: value };
+                }
+                const activeValue = variant[activeOption];
+                const optionIndex = options.indexOf(activeOption);
+                const optionField = optionFields[optionIndex];
+                const specificField = {
+                    ...field,
+                    options,
+                    optionFields: [optionField],
+                };
+                return {
+                    field: specificField,
+                    value: {
+                        option: activeOption,
+                        value: optionField?.resolve(activeValue) ?? {
+                            field: optionField,
+                            value: activeValue,
+                            raw: activeValue,
+                        },
+                    },
+                    raw: value,
+                };
+            },
+        };
+        return field;
+    }
+    visitTuple(_t, components, label) {
+        const fields = components.map((type, index) => type.accept(this, `_${index}`));
+        const field = {
+            type: "tuple",
+            label,
+            candidType: "tuple",
+            displayType: "array",
+            fields,
+            resolve(value) {
+                const tuple = value;
+                if (tuple == null) {
+                    return { field, value: null, raw: value };
+                }
+                const resolvedItems = fields.map((f, index) => f.resolve(tuple[index]));
+                return { field, value: resolvedItems, raw: value };
+            },
+        };
+        return field;
+    }
+    visitOpt(_t, ty, label) {
+        const innerField = ty.accept(this, label);
+        const field = {
+            type: "optional",
+            label,
+            candidType: "opt",
+            displayType: "nullable",
+            innerField,
+            resolve(value) {
+                const opt = value;
+                if (opt == null || opt.length === 0) {
+                    return { field, value: null, raw: value };
+                }
+                return { field, value: innerField.resolve(opt[0]), raw: value };
+            },
+        };
+        return field;
+    }
+    visitVec(_t, ty, label) {
+        // Check if it's blob (vec nat8)
+        if (ty instanceof IDL.FixedNatClass && ty._bits === 8) {
+            const codec = _t.accept(this.displayVisitor, null);
+            const blobField = {
+                type: "blob",
+                label,
+                candidType: "blob",
+                displayType: "string", // Transformed to hex string
+                displayHint: "hex",
+                resolve(value) {
+                    return {
+                        field: blobField,
+                        value: codec.decode(value),
+                        raw: value,
+                    };
+                },
+            };
+            return blobField;
+        }
+        const itemField = ty.accept(this, "item");
+        const field = {
+            type: "vector",
+            label,
+            candidType: "vec",
+            displayType: "array",
+            itemField,
+            resolve(value) {
+                const vec = value;
+                if (vec == null) {
+                    return { field, value: null, raw: value };
+                }
+                const resolvedItems = vec.map((item) => itemField.resolve(item));
+                return { field, value: resolvedItems, raw: value };
+            },
+        };
+        return field;
+    }
+    visitRec(t, ty, label) {
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const self = this;
+        const field = {
+            type: "recursive",
+            label,
+            candidType: "rec",
+            displayType: "recursive",
+            typeName: t.name,
+            // Lazy extraction to prevent infinite loops
+            extract: () => ty.accept(self, label),
+            resolve(value) {
+                // Extract the inner field and resolve with it
+                const innerField = field.extract();
+                return innerField.resolve(value);
+            },
+        };
+        return field;
+    }
+    // ════════════════════════════════════════════════════════════════════════
+    // Primitive Types
+    // ════════════════════════════════════════════════════════════════════════
+    visitPrincipal(t, label) {
+        const codec = t.accept(this.displayVisitor, null);
+        const field = {
+            type: "principal",
+            label,
+            candidType: "principal",
+            displayType: "string", // Principal.toText()
+            textFormat: checkTextFormat(label),
+            resolve(value) {
+                return {
+                    field,
+                    value: codec.decode(value),
+                    raw: value,
+                };
+            },
+        };
+        return field;
+    }
+    visitText(t, label) {
+        const codec = t.accept(this.displayVisitor, null);
+        const field = {
+            type: "text",
+            label,
+            candidType: "text",
+            displayType: "string",
+            textFormat: checkTextFormat(label),
+            resolve(value) {
+                return { field, value: codec.decode(value), raw: value };
+            },
+        };
+        return field;
+    }
+    visitBool(t, label) {
+        const codec = t.accept(this.displayVisitor, null);
+        const field = {
+            type: "boolean",
+            label,
+            candidType: "bool",
+            displayType: "boolean",
+            resolve(value) {
+                return { field, value: codec.decode(value), raw: value };
+            },
+        };
+        return field;
+    }
+    visitNull(t, label) {
+        const codec = t.accept(this.displayVisitor, null);
+        const field = {
+            type: "null",
+            label,
+            candidType: "null",
+            displayType: "null",
+            resolve(value) {
+                return { field, value: codec.decode(value), raw: value };
+            },
+        };
+        return field;
+    }
+    // Numbers
+    visitInt(t, label) {
+        const codec = t.accept(this.displayVisitor, null);
+        const field = {
+            type: "number",
+            label,
+            candidType: "int",
+            displayType: "string", // BigInt → string
+            numberFormat: checkNumberFormat(label),
+            resolve(value) {
+                return { field, value: codec.decode(value), raw: value };
+            },
+        };
+        return field;
+    }
+    visitNat(t, label) {
+        const codec = t.accept(this.displayVisitor, null);
+        const field = {
+            type: "number",
+            label,
+            candidType: "nat",
+            displayType: "string", // BigInt → string
+            numberFormat: checkNumberFormat(label),
+            resolve(value) {
+                return { field, value: codec.decode(value), raw: value };
+            },
+        };
+        return field;
+    }
+    visitFloat(t, label) {
+        const codec = t.accept(this.displayVisitor, null);
+        const field = {
+            type: "number",
+            label,
+            candidType: `float${t._bits}`,
+            displayType: "number", // Floats stay as numbers
+            numberFormat: checkNumberFormat(label),
+            resolve(value) {
+                return { field, value: codec.decode(value), raw: value };
+            },
+        };
+        return field;
+    }
+    visitFixedInt(t, label) {
+        const bits = t._bits;
+        const codec = t.accept(this.displayVisitor, null);
+        const field = {
+            type: "number",
+            label,
+            candidType: `int${bits}`,
+            displayType: bits <= 32 ? "number" : "string", // int64 → string
+            numberFormat: checkNumberFormat(label),
+            resolve(value) {
+                return {
+                    field,
+                    value: codec.decode(value),
+                    raw: value,
+                };
+            },
+        };
+        return field;
+    }
+    visitFixedNat(t, label) {
+        const bits = t._bits;
+        const codec = t.accept(this.displayVisitor, null);
+        const field = {
+            type: "number",
+            label,
+            candidType: `nat${bits}`,
+            displayType: bits <= 32 ? "number" : "string", // nat64 → string
+            numberFormat: checkNumberFormat(label),
+            resolve(value) {
+                return {
+                    field,
+                    value: codec.decode(value),
+                    raw: value,
+                };
+            },
+        };
+        return field;
+    }
+    visitType(_t, label) {
+        const field = {
+            type: "unknown",
+            label,
+            candidType: "unknown",
+            displayType: "unknown",
+            resolve(value) {
+                return { field, value, raw: value };
+            },
+        };
+        return field;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/visitor/returns/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/visitor/returns/index.ts"],"names":[],"mappings":"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"}

package/dist/visitor/returns/types.d.ts

@@ -0,0 +1,142 @@
+import type { BaseActor, FunctionName, DisplayOf, FunctionType, ActorMethodReturnType } from "@ic-reactor/core";
+export type ResultFieldType = "record" | "variant" | "tuple" | "optional" | "vector" | "blob" | "recursive" | "principal" | "number" | "text" | "boolean" | "null" | "unknown";
+export type DisplayType = "string" | "number" | "boolean" | "null" | "object" | "array" | "variant" | "result" | "nullable" | "recursive" | "unknown";
+/**
+ * Number-specific formatting hints derived from field names.
+ */
+export type NumberFormat = "timestamp" | "cycle" | "value" | "token" | "normal";
+/**
+ * Text-specific formatting hints derived from field names.
+ */
+export type TextFormat = "plain" | "timestamp" | "uuid" | "url" | "email" | "phone" | "btc" | "eth" | "account-id" | "principal";
+/**
+ * Display hints for UI rendering.
+ */
+export type DisplayHint = "copyable" | "linkable" | "truncate" | "hex" | "code" | "none";
+export interface ResultFieldBase {
+    /** The Candid type category */
+    type: ResultFieldType;
+    /** Human-readable label from Candid */
+    label: string;
+    /** Original Candid type name */
+    candidType: string;
+    /** What it becomes after display transformation */
+    displayType: DisplayType;
+    /**
+     * Combine metadata with value to create a render-ready tree.
+     * This allows "zipping" the static schema with dynamic runtime data.
+     */
+    resolve(value: unknown): ResultFieldWithValue;
+}
+export interface RecordResultField extends ResultFieldBase {
+    type: "record";
+    displayType: "object";
+    fields: ResultField[];
+}
+export interface VariantResultField extends ResultFieldBase {
+    type: "variant";
+    displayType: "variant" | "result";
+    options: string[];
+    optionFields: ResultField[];
+}
+export interface TupleResultField extends ResultFieldBase {
+    type: "tuple";
+    displayType: "array";
+    fields: ResultField[];
+}
+export interface OptionalResultField extends ResultFieldBase {
+    type: "optional";
+    displayType: "nullable";
+    innerField: ResultField;
+}
+export interface VectorResultField extends ResultFieldBase {
+    type: "vector";
+    displayType: "array";
+    itemField: ResultField;
+}
+export interface BlobResultField extends ResultFieldBase {
+    type: "blob";
+    displayType: "string";
+    displayHint: "hex";
+}
+export interface RecursiveResultField extends ResultFieldBase {
+    type: "recursive";
+    displayType: "recursive";
+    typeName: string;
+    /** Lazily extract the inner field to prevent infinite loops */
+    extract: () => ResultField;
+}
+export interface PrincipalResultField extends ResultFieldBase {
+    type: "principal";
+    displayType: "string";
+    textFormat: TextFormat;
+}
+export interface NumberResultField extends ResultFieldBase {
+    type: "number";
+    displayType: "string" | "number";
+    numberFormat: NumberFormat;
+}
+export interface TextResultField extends ResultFieldBase {
+    type: "text";
+    displayType: "string";
+    textFormat: TextFormat;
+}
+export interface BooleanResultField extends ResultFieldBase {
+    type: "boolean";
+    displayType: "boolean";
+}
+export interface NullResultField extends ResultFieldBase {
+    type: "null";
+    displayType: "null";
+}
+export interface UnknownResultField extends ResultFieldBase {
+    type: "unknown";
+    displayType: "unknown";
+}
+export type ResultField = RecordResultField | VariantResultField | TupleResultField | OptionalResultField | VectorResultField | BlobResultField | RecursiveResultField | PrincipalResultField | NumberResultField | TextResultField | BooleanResultField | NullResultField | UnknownResultField;
+/**
+ * A result field paired with its transformed value for rendering.
+ * Can contain nested resolved fields for compound types.
+ */
+export interface ResultFieldWithValue<T = unknown> {
+    field: ResultField;
+    value: DisplayOf<T>;
+    raw: T;
+}
+/**
+ * Resolved method result containing metadata and resolved field values.
+ * This is the output of `generateMetadata()`.
+ */
+export interface ResolvedMethodResult<A = BaseActor> {
+    functionType: FunctionType;
+    functionName: FunctionName<A>;
+    results: ResultFieldWithValue[];
+}
+export interface MethodResultMeta<A = BaseActor, Name extends FunctionName<A> = FunctionName<A>> {
+    functionType: FunctionType;
+    functionName: Name;
+    resultFields: ResultField[];
+    returnCount: number;
+    /**
+     * Generate metadata by resolving each result field with its corresponding display value.
+     * This "zips" the static schema with dynamic runtime data for easy rendering.
+     *
+     * @param data - Array of display-transformed return values from the canister method call
+     * @returns Resolved method result with metadata attached to each value
+     *
+     * @example
+     * ```ts
+     * const result = await reactor.callMethod({ functionName: "myMethod", args: [] })
+     * const resolved = methodMeta.generateMetadata(result)
+     * // resolved.results contains fields with their display values for rendering
+     * ```
+     */
+    generateMetadata(data: ActorMethodReturnType<A[Name]>): ResolvedMethodResult<A>;
+}
+export type ServiceResultMeta<A = BaseActor> = {
+    [K in FunctionName<A>]: MethodResultMeta<A, K>;
+};
+export type ResultFieldByType<T extends ResultFieldType> = Extract<ResultField, {
+    type: T;
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/visitor/returns/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/visitor/returns/types.ts"],"names":[],"mappings":"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"}

package/dist/visitor/returns/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/visitor/returns/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/visitor/returns/types.ts"],"names":[],"mappings":""}

package/dist/visitor/types.d.ts

@@ -0,0 +1,6 @@
+export type FieldType = "functionRecord" | "function" | "record" | "variant" | "tuple" | "optional" | "vector" | "table" | "blob" | "blob-large" | "recursive" | "unknown" | "text" | "number" | "principal" | "boolean" | "null";
+export { IDL } from "@icp-sdk/core/candid";
+export { Principal } from "@icp-sdk/core/principal";
+import { IDL } from "@icp-sdk/core/candid";
+export type AllNumberTypes = IDL.NatClass | IDL.IntClass | IDL.FixedNatClass | IDL.FixedIntClass | IDL.FloatClass;
+//# sourceMappingURL=types.d.ts.map

package/dist/visitor/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/visitor/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,gBAAgB,GAChB,UAAU,GACV,QAAQ,GACR,SAAS,GACT,OAAO,GACP,UAAU,GACV,QAAQ,GACR,OAAO,GACP,MAAM,GACN,YAAY,GACZ,WAAW,GACX,SAAS,GACT,MAAM,GACN,QAAQ,GACR,WAAW,GACX,SAAS,GACT,MAAM,CAAA;AAEV,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAEnD,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAA;AAC1C,MAAM,MAAM,cAAc,GACtB,GAAG,CAAC,QAAQ,GACZ,GAAG,CAAC,QAAQ,GACZ,GAAG,CAAC,aAAa,GACjB,GAAG,CAAC,aAAa,GACjB,GAAG,CAAC,UAAU,CAAA"}

package/dist/visitor/types.js

@@ -0,0 +1,3 @@
+export { IDL } from "@icp-sdk/core/candid";
+export { Principal } from "@icp-sdk/core/principal";
+//# sourceMappingURL=types.js.map

package/dist/visitor/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/visitor/types.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ic-reactor/candid",
-  "version": "3.0.7-beta.2",
+  "version": "3.0.8-beta.0",
   "description": "IC Reactor Candid Adapter - Fetch and parse Candid definitions from Internet Computer canisters",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -42,7 +42,8 @@
   "author": "Behrad Deylami",
   "license": "MIT",
   "dependencies": {
-    "@ic-reactor/core": "^3.0.7-beta.2"
+    "@noble/hashes": "^1.8.0",
+    "@ic-reactor/core": "^3.0.8-beta.0"
   },
   "peerDependencies": {
     "@icp-sdk/core": "^5.0.0"

package/src/display-reactor.ts

@@ -1,4 +1,8 @@
-import type { BaseActor, DisplayReactorParameters } from "@ic-reactor/core"
+import type {
+  BaseActor,
+  DisplayReactorParameters,
+  TransformKey,
+} from "@ic-reactor/core"
 import type {
   CandidDisplayReactorParameters,
   DynamicMethodOptions,
@@ -64,7 +68,11 @@ import { IDL } from "@icp-sdk/core/candid"
  * })
  * ```
  */
-export class CandidDisplayReactor<A = BaseActor> extends DisplayReactor<A> {
+export class CandidDisplayReactor<
+  A = BaseActor,
+  T extends TransformKey = "display",
+> extends DisplayReactor<A, T> {
+  public readonly transform = "display" as T
   public adapter: CandidAdapter
   private candidSource?: string
 

package/src/index.ts

@@ -4,3 +4,4 @@ export * from "./constants"
 export * from "./utils"
 export * from "./reactor"
 export * from "./display-reactor"
+export * from "./metadata-display-reactor"