@ic-reactor/candid 3.0.9-beta.0 → 3.0.10-beta.1

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

@@ -1,224 +1,100 @@
 import type { BaseActor, FunctionName, FunctionType, ActorMethodReturnType } from "@ic-reactor/core";
-export type ResultFieldType = "record" | "variant" | "tuple" | "optional" | "vector" | "blob" | "recursive" | "principal" | "number" | "text" | "boolean" | "null" | "unknown";
+export type NodeType = "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.
+ * Base properties shared by all result nodes.
  */
-export type DisplayHint = "copyable" | "linkable" | "truncate" | "hex" | "code" | "none";
-export interface ResultFieldBase<Type extends ResultFieldType = ResultFieldType> {
+interface ResultNodeBase<T extends NodeType = NodeType> {
     /** The Candid type category */
-    type: Type;
-    /** Human-readable label from Candid */
+    type: T;
+    /** Human-readable label */
     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<Type>;
-}
-export interface RecordResultField extends ResultFieldBase<"record"> {
-    type: "record";
-    displayType: "object";
-    fields: ResultField[];
-}
-export interface VariantResultField extends ResultFieldBase<"variant"> {
-    type: "variant";
-    displayType: "variant" | "result";
-    options: string[];
-    optionFields: ResultField[];
-}
-export interface TupleResultField extends ResultFieldBase<"tuple"> {
-    type: "tuple";
-    displayType: "array";
-    fields: ResultField[];
-}
-export interface OptionalResultField extends ResultFieldBase<"optional"> {
-    type: "optional";
-    displayType: "nullable";
-    innerField: ResultField;
-}
-export interface VectorResultField extends ResultFieldBase<"vector"> {
-    type: "vector";
-    displayType: "array";
-    itemField: ResultField;
-}
-export interface BlobResultField extends ResultFieldBase<"blob"> {
-    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<"principal"> {
-    type: "principal";
-    displayType: "string";
-    textFormat: TextFormat;
-}
-export interface NumberResultField extends ResultFieldBase<"number"> {
-    type: "number";
-    displayType: "string" | "number";
-    numberFormat: NumberFormat;
-}
-export interface TextResultField extends ResultFieldBase<"text"> {
-    type: "text";
-    displayType: "string";
-    textFormat: TextFormat;
-}
-export interface BooleanResultField extends ResultFieldBase<"boolean"> {
-    type: "boolean";
-    displayType: "boolean";
-}
-export interface NullResultField extends ResultFieldBase<"null"> {
-    type: "null";
-    displayType: "null";
-}
-export interface UnknownResultField extends ResultFieldBase<"unknown"> {
-    type: "unknown";
-    displayType: "unknown";
-}
-export type ResultField = RecordResultField | VariantResultField | TupleResultField | OptionalResultField | VectorResultField | BlobResultField | RecursiveResultField | PrincipalResultField | NumberResultField | TextResultField | BooleanResultField | NullResultField | UnknownResultField;
-export interface RecordResultWithValue<V = unknown> {
-    field: RecordResultField;
-    value: Record<string, ResultFieldWithValue>;
-    raw: V;
-}
-export interface VariantResultWithValue<V = unknown> {
-    field: VariantResultField;
-    value: {
-        option: string;
-        value: ResultFieldWithValue;
-    };
-    raw: V;
-}
-export interface TupleResultWithValue<V = unknown> {
-    field: TupleResultField;
-    value: ResultFieldWithValue[];
-    raw: V;
-}
-export interface OptionalResultWithValue<V = unknown> {
-    field: OptionalResultField;
-    value: ResultFieldWithValue | null;
-    raw: V;
-}
-export interface VectorResultWithValue<V = unknown> {
-    field: VectorResultField;
-    value: ResultFieldWithValue[];
-    raw: V;
-}
-export interface BlobResultWithValue<V = unknown> {
-    field: BlobResultField;
-    value: string;
-    raw: V;
-}
-export interface RecursiveResultWithValue<V = unknown> {
-    field: RecursiveResultField;
-    value: ResultFieldWithValue;
-    raw: V;
-}
-export interface PrincipalResultWithValue<V = unknown> {
-    field: PrincipalResultField;
+    /** Original raw value before transformation (present after resolution) */
+    raw?: unknown;
+}
+type NodeTypeExtras<T extends NodeType> = T extends "record" ? {
+    fields: Record<string, ResultNode>;
+} : T extends "variant" ? {
+    selectedOption: ResultNode;
+    selected?: string;
+} : T extends "tuple" | "vector" ? {
+    items: ResultNode[];
+} : T extends "optional" ? {
+    value: ResultNode | null;
+} : T extends "recursive" ? {
+    inner: ResultNode;
+} : T extends "blob" ? {
     value: string;
-    raw: V;
-}
-export interface NumberResultWithValue<V = unknown> {
-    field: NumberResultField;
+} : T extends "number" ? {
+    format: NumberFormat;
     value: string | number;
-    raw: V;
-}
-export interface TextResultWithValue<V = unknown> {
-    field: TextResultField;
+} : T extends "text" | "principal" ? {
+    format: TextFormat;
     value: string;
-    raw: V;
-}
-export interface BooleanResultWithValue<V = unknown> {
-    field: BooleanResultField;
+} : T extends "boolean" ? {
     value: boolean;
-    raw: V;
-}
-export interface NullResultWithValue<V = unknown> {
-    field: NullResultField;
+} : T extends "null" ? {
     value: null;
-    raw: V;
-}
-export interface UnknownResultWithValue<V = unknown> {
-    field: UnknownResultField;
+} : {
     value: unknown;
-    raw: V;
-}
-/**
- * Mapping from ResultFieldType string to the corresponding *ResultWithValue interface.
- */
-export type ResultWithValueMap<V = unknown> = {
-    record: RecordResultWithValue<V>;
-    variant: VariantResultWithValue<V>;
-    tuple: TupleResultWithValue<V>;
-    optional: OptionalResultWithValue<V>;
-    vector: VectorResultWithValue<V>;
-    blob: BlobResultWithValue<V>;
-    recursive: RecursiveResultWithValue<V>;
-    principal: PrincipalResultWithValue<V>;
-    number: NumberResultWithValue<V>;
-    text: TextResultWithValue<V>;
-    boolean: BooleanResultWithValue<V>;
-    null: NullResultWithValue<V>;
-    unknown: UnknownResultWithValue<V>;
 };
 /**
- * A result field paired with its transformed value for rendering.
- * Can contain nested resolved fields for compound types.
+ * A unified result node that contains both schema and resolved value.
+ * When used as schema only, `raw` is undefined.
+ * When resolved, `raw` contains the original data.
  *
- * It is a discriminated union of all specific result types.
+ * Compound types (record, variant, tuple, optional, vector) store
+ * resolved children directly in their structure fields.
+ * Primitive types store the display value in `value`.
  */
-export type ResultFieldWithValue<P = unknown, V = unknown> = P extends ResultFieldType ? ResultWithValueMap<V>[P] : ResultWithValueMap<V>[ResultFieldType];
+export type ResultNode<T extends NodeType = NodeType> = ResultNodeBase<T> & NodeTypeExtras<T> & {
+    /** Resolve this node with a value, returning a new resolved node */
+    resolve(data: unknown): ResolvedNode<T>;
+    value?: unknown;
+};
 /**
- * Resolved method result containing metadata and resolved field values.
- * This is the output of `generateMetadata()`.
+ * A resolved node has `raw` populated and children resolved.
  */
-export interface ResolvedMethodResult<A = BaseActor> {
-    functionType: FunctionType;
-    functionName: FunctionName<A>;
-    results: ResultFieldWithValue[];
-    raw: ActorMethodReturnType<A[FunctionName<A>]>;
-}
-export interface MethodResultMeta<A = BaseActor, Name extends FunctionName<A> = FunctionName<A>> {
+export type ResolvedNode<T extends NodeType = NodeType> = ResultNode<T> & {
+    raw: unknown;
+};
+export type RecordNode = ResultNode<"record">;
+export type VariantNode = ResultNode<"variant">;
+export type TupleNode = ResultNode<"tuple">;
+export type OptionalNode = ResultNode<"optional">;
+export type VectorNode = ResultNode<"vector">;
+export type BlobNode = ResultNode<"blob">;
+export type RecursiveNode = ResultNode<"recursive">;
+export type PrincipalNode = ResultNode<"principal">;
+export type NumberNode = ResultNode<"number">;
+export type TextNode = ResultNode<"text">;
+export type BooleanNode = ResultNode<"boolean">;
+export type NullNode = ResultNode<"null">;
+export type UnknownNode = ResultNode<"unknown">;
+export interface MethodMeta<A = BaseActor, Name extends FunctionName<A> = FunctionName<A>> {
     functionType: FunctionType;
     functionName: Name;
-    resultFields: ResultField[];
+    returns: ResultNode[];
     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
-     * ```
+     * Resolve the method result schema with actual return data.
      */
-    generateMetadata(data: ActorMethodReturnType<A[Name]>): ResolvedMethodResult<A>;
+    resolve(data: ActorMethodReturnType<A[Name]>): ResolvedMethodResult<A>;
+}
+export interface ResolvedMethodResult<A = BaseActor> {
+    functionType: FunctionType;
+    functionName: FunctionName<A>;
+    results: ResolvedNode[];
+    raw: ActorMethodReturnType<A[FunctionName<A>]>;
 }
-export type ServiceResultMeta<A = BaseActor> = {
-    [K in FunctionName<A>]: MethodResultMeta<A, K>;
+export type ServiceMeta<A = BaseActor> = {
+    [K in FunctionName<A>]: MethodMeta<A, K>;
 };
+export {};
 //# sourceMappingURL=types.d.ts.map

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

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

package/package.json

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

package/src/index.ts

@@ -1,6 +1,7 @@
 export * from "./adapter"
 export * from "./types"
 export * from "./visitor"
+export type { ResolvedNode } from "./visitor/returns/types"
 export * from "./constants"
 export * from "./utils"
 export * from "./reactor"

package/src/metadata-display-reactor.ts

@@ -14,10 +14,10 @@ import {
   ServiceArgumentsMeta,
 } from "./visitor/arguments"
 import {
-  MethodResultMeta,
+  MethodMeta,
   ResolvedMethodResult,
   ResultFieldVisitor,
-  ServiceResultMeta,
+  ServiceMeta,
 } from "./visitor/returns"
 
 // ============================================================================
@@ -51,7 +51,7 @@ export class MetadataDisplayReactor<A = BaseActor> extends CandidDisplayReactor<
 
   // Metadata storage
   private argumentMeta: ServiceArgumentsMeta<A> | null = null
-  private resultMeta: ServiceResultMeta<A> | null = null
+  private resultMeta: ServiceMeta<A> | null = null
 
   // Visitors (stateless, can be reused)
   private static argVisitor = new ArgumentFieldVisitor()
@@ -92,7 +92,7 @@ export class MetadataDisplayReactor<A = BaseActor> extends CandidDisplayReactor<
     this.resultMeta = service.accept(
       MetadataDisplayReactor.resultVisitor,
       null as any
-    ) as ServiceResultMeta<A>
+    ) as ServiceMeta<A>
   }
 
   // ══════════════════════════════════════════════════════════════════════════
@@ -114,7 +114,7 @@ export class MetadataDisplayReactor<A = BaseActor> extends CandidDisplayReactor<
    */
   public getResultMeta<M extends FunctionName<A>>(
     methodName: M
-  ): MethodResultMeta<A, M> | undefined {
+  ): MethodMeta<A, M> | undefined {
     return this.resultMeta?.[methodName]
   }
 
@@ -128,7 +128,7 @@ export class MetadataDisplayReactor<A = BaseActor> extends CandidDisplayReactor<
   /**
    * Get all result metadata.
    */
-  public getAllResultMeta(): ServiceResultMeta<A> | null {
+  public getAllResultMeta(): ServiceMeta<A> | null {
     return this.resultMeta
   }
 
@@ -161,7 +161,7 @@ export class MetadataDisplayReactor<A = BaseActor> extends CandidDisplayReactor<
       throw new Error(`No metadata found for method "${methodName}"`)
     }
 
-    return meta.generateMetadata(result) as ResolvedMethodResult<A>
+    return meta.resolve(result)
   }
 
   /**
@@ -169,7 +169,7 @@ export class MetadataDisplayReactor<A = BaseActor> extends CandidDisplayReactor<
    */
   public async callDynamicWithMeta<T = unknown>(
     options: DynamicMethodOptions & { args?: unknown[] }
-  ): Promise<{ result: T; meta: MethodResultMeta<A> }> {
+  ): Promise<{ result: T; meta: MethodMeta<A> }> {
     await this.registerMethod(options)
 
     const result = (await this.callMethod({