@ic-reactor/candid 3.0.0-beta.0 → 3.0.0

package/README.md

@@ -9,6 +9,7 @@ Lightweight adapter for fetching and parsing Candid definitions from Internet Co
 - **Local Parsing**: Use the optional WASM-based parser for fast, offline Candid compilation
 - **Remote Fallback**: Falls back to the didjs canister for Candid-to-JavaScript compilation
 - **Dynamic Reactor**: Includes `CandidReactor` for dynamic IDL fetching and interaction
+- **Dynamic Forms**: Generate rich form metadata with validation schemas using `FieldVisitor`
 - **Lightweight**: Uses raw `agent.query` calls - no Actor overhead
 - **ClientManager Compatible**: Seamlessly integrates with `@ic-reactor/core`
 
@@ -86,6 +87,7 @@ await clientManager.initialize()
 const reactor = new CandidReactor({
   canisterId: "ryjl3-tyaaa-aaaaa-aaaba-cai",
   clientManager,
+  name: "my-canister",
 })
 await reactor.initialize() // Fetches IDL from network
 
@@ -93,6 +95,7 @@ await reactor.initialize() // Fetches IDL from network
 const reactor = new CandidReactor({
   canisterId: "ryjl3-tyaaa-aaaaa-aaaba-cai",
   clientManager,
+  name: "my-canister",
   candid: `service : {
     icrc1_name : () -> (text) query;
     icrc1_balance_of : (record { owner : principal }) -> (nat) query;
@@ -117,6 +120,7 @@ You can also register individual methods on-the-fly:
 const reactor = new CandidReactor({
   canisterId: "ryjl3-tyaaa-aaaaa-aaaba-cai",
   clientManager,
+  name: "my-canister",
 })
 
 // Register a method by its Candid signature
@@ -168,6 +172,33 @@ const cachedBalance = await reactor.fetchQueryDynamic({
 })
 ```
 
+### FieldVisitor (Dynamic Forms)
+
+Generate type-safe, enhanced metadata for dynamic forms from Candid definitions.
+
+```typescript
+import { FieldVisitor } from "@ic-reactor/candid"
+
+const visitor = new FieldVisitor()
+const serviceMeta = service.accept(visitor, null)
+
+// Access method metadata
+const methodMeta = serviceMeta["icrc1_transfer"]
+
+// Detected field formats detected automatically
+const amountField = methodMeta.fields[1] // e.g. "amount"
+console.log(amountField.format) // "token"
+console.log(amountField.inputProps)
+// { type: "text", inputMode: "numeric", pattern: "\\d+", ... }
+```
+
+**Features:**
+
+- **Auto-Format Detection**: Identifies `email`, `url`, `uuid`, `timestamp`, `cycle`, `principal`, etc. based on labels.
+- **Enhanced Schemas**: Generates Zod schemas with specific validation (e.g., `z.string().email()`).
+- **Input Props**: Provides ready-to-use HTML attributes (`type="email"`, `pattern`, `min`, `max`) for primitive fields.
+- **Component Hints**: Suggests UI components (`variant-select`, `vector-list`, `blob-upload`).
+
 ### Fetch Raw Candid Source
 
 ```typescript
@@ -272,8 +303,9 @@ new CandidReactor(config: CandidReactorParameters)
 
 | Parameter       | Type               | Required | Description                                      |
 | --------------- | ------------------ | -------- | ------------------------------------------------ |
-| `canisterId`    | `CanisterId`       | Yes      | The canister ID to interact with                 |
+| `name`          | `string`           | Yes      | Name of the canister/reactor                     |
 | `clientManager` | `ClientManager`    | Yes      | Client manager from `@ic-reactor/core`           |
+| `canisterId`    | `CanisterId`       | No       | The canister ID (optional if using env vars)     |
 | `candid`        | `string`           | No       | Candid service definition (avoids network fetch) |
 | `idlFactory`    | `InterfaceFactory` | No       | IDL factory (if already available)               |
 | `actor`         | `A`                | No       | Existing actor instance                          |

package/dist/adapter.js

@@ -1,7 +1,7 @@
 import { CanisterStatus } from "@icp-sdk/core/agent";
 import { IDL } from "@icp-sdk/core/candid";
 import { DEFAULT_IC_DIDJS_ID, DEFAULT_LOCAL_DIDJS_ID } from "./constants";
-import { importCandidDefinition, noop } from "./utils";
+import { importCandidDefinition } from "./utils";
 /**
  * CandidAdapter provides functionality to fetch and parse Candid definitions
  * from Internet Computer canisters.
@@ -381,4 +381,5 @@ export class CandidAdapter {
         return this.validateCandid(candidSource);
     }
 }
+const noop = () => { };
 //# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAA;AAC1C,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACzE,OAAO,EAAE,sBAAsB,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAGtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,OAAO,aAAa;IAgBxB;;;;OAIG;IACH,YAAY,EAAE,aAAa,EAAE,eAAe,EAA2B;QApBvE,8DAA8D;QACvD;;;;;WAAkC;QAEzC,2EAA2E;QACpE;;;;;WAA2B;QAElC,wCAAwC;QAChC;;;;;WAA4B;QAEpC,sDAAsD;QAC9C;;;;mBAAsB,KAAK;WAAA;QAEnC,qDAAqD;QAC9C;;;;mBAA0B,IAAI;WAAA;QAQnC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAA;QAClC,IAAI,CAAC,eAAe,GAAG,eAAe,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAA;QAElE,sEAAsE;QACtE,IAAI,CAAC,WAAW,GAAG,aAAa,CAAC,SAAS,CAAC,GAAG,EAAE;YAC9C,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAA;YACjD,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAA;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,YAAY,KAAK,SAAS,CAAA;IACxC,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACI,KAAK,CAAC,UAAU,CAAC,MAAsB;QAC5C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,YAAY,GAAG,MAAM,CAAA;YAC1B,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAA;YAC/B,OAAM;QACR,CAAC;QAED,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC7B,OAAM,CAAC,wBAAwB;QACjC,CAAC;QAED,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAA;QAE/B,IAAI,CAAC;YACH,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;YACjD,IAAI,IAAI,CAAC,YAAY,EAAE,OAAO,EAAE,CAAC;gBAC/B,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAA;YACnC,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,EAAE,CAAC,CAAA;QACnD,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,aAAa;QACzB,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAClD,OAAM;QACR,CAAC;QAED,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAA;QAE/B,IAAI,CAAC;YACH,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;YACjD,IAAI,IAAI,CAAC,YAAY,EAAE,OAAO,EAAE,CAAC;gBAC/B,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAA;YACnC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;YACrC,IAAI,CAAC,YAAY,GAAG,SAAS,CAAA;QAC/B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,iBAAiB;QACvB,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO;YAC/B,CAAC,CAAC,sBAAsB;YACxB,CAAC,CAAC,mBAAmB,CAAA;IACzB,CAAC;IAED,8EAA8E;IAC9E,gEAAgE;IAChE,8EAA8E;IAE9E;;;;;;;;;;;;OAYG;IACI,KAAK,CAAC,mBAAmB,CAC9B,UAAsB;QAEtB,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAA;YAC7D,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAA;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,2BAA2B,UAAU,KAAK,KAAK,EAAE,CAAC,CAAA;QACpE,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;OAaG;IACI,KAAK,CAAC,iBAAiB,CAAC,UAAsB;QACnD,kDAAkD;QAClD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,KAAK,CACjE,GAAG,EAAE,CAAC,SAAS,CAChB,CAAA;QAED,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,YAAY,CAAA;QACrB,CAAC;QAED,gDAAgD;QAChD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,KAAK,CAC/D,GAAG,EAAE,CAAC,SAAS,CAChB,CAAA;QAED,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,WAAW,CAAA;QACpB,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;IACpE,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,iBAAiB,CAC5B,YAAoB;QAEpB,gDAAgD;QAChD,MAAM,IAAI,CAAC,aAAa,EAAE,CAAA;QAE1B,IAAI,UAA8B,CAAA;QAElC,uDAAuD;QACvD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAA;YAC9C,CAAC;YAAC,MAAM,CAAC;gBACP,qCAAqC;YACvC,CAAC;QACH,CAAC;QAED,4CAA4C;QAC5C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,CAAA;QACrD,CAAC;QAED,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;QAC3D,CAAC;QAED,OAAO,sBAAsB,CAAC,UAAU,CAAC,CAAA;IAC3C,CAAC;IAED,8EAA8E;IAC9E,+DAA+D;IAC/D,8EAA8E;IAE9E;;;;;OAKG;IACI,KAAK,CAAC,iBAAiB,CAC5B,UAAsB;QAEtB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC;YAC1C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,UAAuB;YACnC,KAAK,EAAE,CAAC,QAAQ,CAAC;SAClB,CAAC,CAAA;QAEF,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAuB,CAAA;IACnD,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,gBAAgB,CAAC,UAAsB;QAClD,MAAM,aAAa,GACjB,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAA;QAErE,mDAAmD;QACnD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,EAAE;YACrD,UAAU,EAAE,iCAAiC;YAC7C,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC;SACxB,CAAC,CAAA;QAEF,IAAI,OAAO,IAAI,QAAQ,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC1C,MAAM,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAE/D,CAAA;YACD,OAAO,YAAY,CAAA;QACrB,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IAC9D,CAAC;IAED,8EAA8E;IAC9E,+DAA+D;IAC/D,8EAA8E;IAE9E;;;;;;OAMG;IACI,YAAY,CAAC,YAAoB;QACtC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;QAChE,CAAC;QAED,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;IAChD,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,aAAa,CACxB,YAAoB,EACpB,eAAwB;QAExB,MAAM,UAAU,GAAG,eAAe,IAAI,IAAI,CAAC,eAAe,CAAA;QAE1D,mDAAmD;QACnD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE;YAClD,UAAU,EAAE,WAAW;YACvB,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC;SAC5C,CAAC,CAAA;QAEF,IAAI,OAAO,IAAI,QAAQ,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAElE,CAAA;YACD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAA;QAClB,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IAC9D,CAAC;IAED;;;;;;OAMG;IACI,cAAc,CAAC,YAAoB;QACxC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;QAChE,CAAC;QAED,OAAO,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;IACpD,CAAC;IAED,8EAA8E;IAC9E,mDAAmD;IACnD,8EAA8E;IAE9E;;OAEG;IACI,KAAK,CAAC,gBAAgB,CAAC,MAAsB;QAClD,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;IAChC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,qBAAqB,CAAC,UAAsB;QACvD,OAAO,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAA;IAC3C,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,eAAe,CAC1B,UAAsB;QAEtB,OAAO,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAA;IAC3C,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,cAAc,CAAC,UAAsB;QAChD,OAAO,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAA;IAC1C,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,wBAAwB,CACnC,IAAY;QAEZ,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAA;IACrC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,YAAY,CACvB,YAAoB,EACpB,eAAwB;QAExB,OAAO,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,eAAe,CAAC,CAAA;IAC1D,CAAC;IAED;;OAEG;IACI,YAAY,CAAC,YAAoB;QACtC,OAAO,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAA;IACxC,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,YAAoB;QACrC,OAAO,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,CAAA;IAC1C,CAAC;CACF"}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"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"}

package/dist/display-reactor.d.ts

@@ -0,0 +1,179 @@
+import type { CandidDisplayReactorParameters, DynamicMethodOptions } from "./types";
+import { CandidAdapter } from "./adapter";
+import { BaseActor, TransformKey, DisplayReactor } from "@ic-reactor/core";
+/**
+ * CandidDisplayReactor combines the display transformation capabilities of
+ * DisplayReactor with dynamic Candid parsing from CandidReactor.
+ *
+ * This class provides:
+ * - **Display transformations**: Automatic type conversion between Candid and
+ *   display-friendly types (bigint ↔ string, Principal ↔ string, etc.)
+ * - **Validation**: Optional argument validation with display types
+ * - **Dynamic Candid parsing**: Initialize from Candid source or fetch from network
+ * - **Dynamic method registration**: Register methods at runtime with Candid signatures
+ *
+ * @typeParam A - The actor service type
+ *
+ * @example
+ * ```typescript
+ * import { CandidDisplayReactor } from "@ic-reactor/candid"
+ *
+ * const reactor = new CandidDisplayReactor({
+ *   clientManager,
+ *   canisterId: "ryjl3-tyaaa-aaaaa-aaaba-cai",
+ * })
+ *
+ * // Initialize from network (fetches Candid from canister)
+ * await reactor.initialize()
+ *
+ * // Or provide Candid source directly
+ * const reactor2 = new CandidDisplayReactor({
+ *   clientManager,
+ *   canisterId: "...",
+ *   candid: `service : { greet : (text) -> (text) query }`
+ * })
+ * await reactor2.initialize()
+ *
+ * // Call methods with display types (strings instead of bigint/Principal)
+ * const result = await reactor.callMethod({
+ *   functionName: "transfer",
+ *   args: [{ to: "aaaaa-aa", amount: "1000000" }] // strings!
+ * })
+ *
+ * // Add validation
+ * reactor.registerValidator("transfer", ([input]) => {
+ *   if (!input.to) {
+ *     return { success: false, issues: [{ path: ["to"], message: "Required" }] }
+ *   }
+ *   return { success: true }
+ * })
+ * ```
+ */
+export declare class CandidDisplayReactor<A = BaseActor, T extends TransformKey = "display"> extends DisplayReactor<A, T> {
+    readonly transform: T;
+    adapter: CandidAdapter;
+    private candidSource?;
+    constructor(config: CandidDisplayReactorParameters<A>);
+    /**
+     * Initializes the reactor by parsing the provided Candid string or fetching it from the network.
+     * This updates the internal service definition with the actual canister interface.
+     *
+     * After initialization, all DisplayReactor methods work with display type transformations.
+     *
+     * @example
+     * ```typescript
+     * const reactor = new CandidDisplayReactor({
+     *   clientManager,
+     *   canisterId: "ryjl3-tyaaa-aaaaa-aaaba-cai",
+     * })
+     *
+     * // Fetches Candid from the canister and initializes
+     * await reactor.initialize()
+     *
+     * // Now you can call methods with display types
+     * const balance = await reactor.callMethod({
+     *   functionName: "icrc1_balance_of",
+     *   args: [{ owner: "aaaaa-aa" }] // Principal as string!
+     * })
+     * ```
+     */
+    initialize(): Promise<void>;
+    /**
+     * Re-initialize the display codecs after the service has been updated.
+     * This is called automatically after initialize() or registerMethod().
+     */
+    private reinitializeCodecs;
+    /**
+     * Register a dynamic method by its Candid signature.
+     * After registration, all DisplayReactor methods work with display type transformations.
+     *
+     * @example
+     * ```typescript
+     * // Register a method
+     * await reactor.registerMethod({
+     *   functionName: "icrc1_balance_of",
+     *   candid: "(record { owner : principal }) -> (nat) query"
+     * })
+     *
+     * // Now use with display types!
+     * const balance = await reactor.callMethod({
+     *   functionName: "icrc1_balance_of",
+     *   args: [{ owner: "aaaaa-aa" }] // Principal as string
+     * })
+     * // balance is string (not bigint) due to display transformation
+     * ```
+     */
+    registerMethod(options: DynamicMethodOptions): Promise<void>;
+    /**
+     * Register multiple methods at once.
+     *
+     * @example
+     * ```typescript
+     * await reactor.registerMethods([
+     *   { functionName: "icrc1_balance_of", candid: "(record { owner : principal }) -> (nat) query" },
+     *   { functionName: "icrc1_transfer", candid: "(record { to : principal; amount : nat }) -> (variant { Ok : nat; Err : text })" }
+     * ])
+     * ```
+     */
+    registerMethods(methods: DynamicMethodOptions[]): Promise<void>;
+    /**
+     * Check if a method is registered (either from initialize or registerMethod).
+     */
+    hasMethod(functionName: string): boolean;
+    /**
+     * Get all registered method names.
+     */
+    getMethodNames(): string[];
+    /**
+     * Perform a dynamic update call in one step with display type transformations.
+     * Registers the method if not already registered, then calls it.
+     *
+     * @example
+     * ```typescript
+     * const result = await reactor.callDynamic({
+     *   functionName: "transfer",
+     *   candid: "(record { to : principal; amount : nat }) -> (variant { Ok : nat; Err : text })",
+     *   args: [{ to: "aaaaa-aa", amount: "100" }] // Display types!
+     * })
+     * ```
+     */
+    callDynamic<T = unknown>(options: DynamicMethodOptions & {
+        args?: unknown[];
+    }): Promise<T>;
+    /**
+     * Perform a dynamic query call in one step with display type transformations.
+     * Registers the method if not already registered, then calls it.
+     *
+     * @example
+     * ```typescript
+     * const balance = await reactor.queryDynamic({
+     *   functionName: "icrc1_balance_of",
+     *   candid: "(record { owner : principal }) -> (nat) query",
+     *   args: [{ owner: "aaaaa-aa" }] // Display types!
+     * })
+     * // balance is string (not BigInt)
+     * ```
+     */
+    queryDynamic<T = unknown>(options: DynamicMethodOptions & {
+        args?: unknown[];
+    }): Promise<T>;
+    /**
+     * Fetch with dynamic Candid and TanStack Query caching.
+     * Registers the method if not already registered, then fetches with caching.
+     * Results are transformed to display types.
+     *
+     * @example
+     * ```typescript
+     * const balance = await reactor.fetchQueryDynamic({
+     *   functionName: "icrc1_balance_of",
+     *   candid: "(record { owner : principal }) -> (nat) query",
+     *   args: [{ owner: "aaaaa-aa" }]
+     * })
+     * // Subsequent calls with same args return cached result
+     * ```
+     */
+    fetchQueryDynamic<T = unknown>(options: DynamicMethodOptions & {
+        args?: unknown[];
+    }): Promise<T>;
+}
+//# sourceMappingURL=display-reactor.d.ts.map

package/dist/display-reactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-reactor.d.ts","sourceRoot":"","sources":["../src/display-reactor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC9B,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,OAAO,EACL,SAAS,EAET,YAAY,EACZ,cAAc,EAGf,MAAM,kBAAkB,CAAA;AAOzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,qBAAa,oBAAoB,CAC/B,CAAC,GAAG,SAAS,EACb,CAAC,SAAS,YAAY,GAAG,SAAS,CAClC,SAAQ,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5B,SAAgB,SAAS,EAAgB,CAAC,CAAA;IACnC,OAAO,EAAE,aAAa,CAAA;IAC7B,OAAO,CAAC,YAAY,CAAC,CAAQ;gBAEjB,MAAM,EAAE,8BAA8B,CAAC,CAAC,CAAC;IA+BrD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBxC;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IA4B1B;;;;;;;;;;;;;;;;;;;OAmBG;IACU,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCzE;;;;;;;;;;OAUG;IACU,eAAe,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5E;;OAEG;IACI,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAI/C;;OAEG;IACI,cAAc,IAAI,MAAM,EAAE;IAQjC;;;;;;;;;;;;OAYG;IACU,WAAW,CAAC,CAAC,GAAG,OAAO,EAClC,OAAO,EAAE,oBAAoB,GAAG;QAAE,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,GACnD,OAAO,CAAC,CAAC,CAAC;IAQb;;;;;;;;;;;;;OAaG;IACU,YAAY,CAAC,CAAC,GAAG,OAAO,EACnC,OAAO,EAAE,oBAAoB,GAAG;QAAE,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,GACnD,OAAO,CAAC,CAAC,CAAC;IAQb;;;;;;;;;;;;;;OAcG;IACU,iBAAiB,CAAC,CAAC,GAAG,OAAO,EACxC,OAAO,EAAE,oBAAoB,GAAG;QAAE,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,GACnD,OAAO,CAAC,CAAC,CAAC;CAOd"}

package/dist/display-reactor.js

@@ -0,0 +1,294 @@
+import { CandidAdapter } from "./adapter";
+import { DisplayReactor, didToDisplayCodec, didTypeFromArray, } from "@ic-reactor/core";
+import { IDL } from "@icp-sdk/core/candid";
+// ============================================================================
+// CandidDisplayReactor
+// ============================================================================
+/**
+ * CandidDisplayReactor combines the display transformation capabilities of
+ * DisplayReactor with dynamic Candid parsing from CandidReactor.
+ *
+ * This class provides:
+ * - **Display transformations**: Automatic type conversion between Candid and
+ *   display-friendly types (bigint ↔ string, Principal ↔ string, etc.)
+ * - **Validation**: Optional argument validation with display types
+ * - **Dynamic Candid parsing**: Initialize from Candid source or fetch from network
+ * - **Dynamic method registration**: Register methods at runtime with Candid signatures
+ *
+ * @typeParam A - The actor service type
+ *
+ * @example
+ * ```typescript
+ * import { CandidDisplayReactor } from "@ic-reactor/candid"
+ *
+ * const reactor = new CandidDisplayReactor({
+ *   clientManager,
+ *   canisterId: "ryjl3-tyaaa-aaaaa-aaaba-cai",
+ * })
+ *
+ * // Initialize from network (fetches Candid from canister)
+ * await reactor.initialize()
+ *
+ * // Or provide Candid source directly
+ * const reactor2 = new CandidDisplayReactor({
+ *   clientManager,
+ *   canisterId: "...",
+ *   candid: `service : { greet : (text) -> (text) query }`
+ * })
+ * await reactor2.initialize()
+ *
+ * // Call methods with display types (strings instead of bigint/Principal)
+ * const result = await reactor.callMethod({
+ *   functionName: "transfer",
+ *   args: [{ to: "aaaaa-aa", amount: "1000000" }] // strings!
+ * })
+ *
+ * // Add validation
+ * reactor.registerValidator("transfer", ([input]) => {
+ *   if (!input.to) {
+ *     return { success: false, issues: [{ path: ["to"], message: "Required" }] }
+ *   }
+ *   return { success: true }
+ * })
+ * ```
+ */
+export class CandidDisplayReactor extends DisplayReactor {
+    constructor(config) {
+        const superConfig = { ...config };
+        // If funcClass is provided, build an idlFactory from it
+        if (config.funcClass && !superConfig.idlFactory) {
+            const { methodName, func } = config.funcClass;
+            superConfig.idlFactory = ({ IDL: _IDL }) => _IDL.Service({ [methodName]: func });
+        }
+        if (!superConfig.idlFactory) {
+            superConfig.idlFactory = ({ IDL }) => IDL.Service({});
+        }
+        super(superConfig);
+        Object.defineProperty(this, "transform", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "display"
+        });
+        Object.defineProperty(this, "adapter", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "candidSource", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.candidSource = config.candid;
+        if (config.adapter) {
+            this.adapter = config.adapter;
+        }
+        else {
+            this.adapter = new CandidAdapter({
+                clientManager: this.clientManager,
+            });
+        }
+    }
+    // ══════════════════════════════════════════════════════════════════════════
+    // INITIALIZATION
+    // ══════════════════════════════════════════════════════════════════════════
+    /**
+     * Initializes the reactor by parsing the provided Candid string or fetching it from the network.
+     * This updates the internal service definition with the actual canister interface.
+     *
+     * After initialization, all DisplayReactor methods work with display type transformations.
+     *
+     * @example
+     * ```typescript
+     * const reactor = new CandidDisplayReactor({
+     *   clientManager,
+     *   canisterId: "ryjl3-tyaaa-aaaaa-aaaba-cai",
+     * })
+     *
+     * // Fetches Candid from the canister and initializes
+     * await reactor.initialize()
+     *
+     * // Now you can call methods with display types
+     * const balance = await reactor.callMethod({
+     *   functionName: "icrc1_balance_of",
+     *   args: [{ owner: "aaaaa-aa" }] // Principal as string!
+     * })
+     * ```
+     */
+    async initialize() {
+        let idlFactory;
+        if (this.candidSource) {
+            const definition = await this.adapter.parseCandidSource(this.candidSource);
+            idlFactory = definition.idlFactory;
+        }
+        else {
+            const definition = await this.adapter.getCandidDefinition(this.canisterId);
+            idlFactory = definition.idlFactory;
+        }
+        this.service = idlFactory({ IDL });
+        // Re-initialize codecs after service is updated
+        this.reinitializeCodecs();
+    }
+    /**
+     * Re-initialize the display codecs after the service has been updated.
+     * This is called automatically after initialize() or registerMethod().
+     */
+    reinitializeCodecs() {
+        const fields = this.getServiceInterface()?._fields;
+        if (!fields)
+            return;
+        // Access the private codecs map from DisplayReactor
+        const codecs = this.codecs;
+        for (const [methodName, funcType] of fields) {
+            // Skip if already exists
+            if (codecs.has(methodName))
+                continue;
+            const argsIdlType = didTypeFromArray(funcType.argTypes);
+            const retIdlType = didTypeFromArray(funcType.retTypes);
+            codecs.set(methodName, {
+                args: didToDisplayCodec(argsIdlType),
+                result: didToDisplayCodec(retIdlType),
+            });
+        }
+    }
+    // ══════════════════════════════════════════════════════════════════════════
+    // DYNAMIC METHOD REGISTRATION
+    // ══════════════════════════════════════════════════════════════════════════
+    /**
+     * Register a dynamic method by its Candid signature.
+     * After registration, all DisplayReactor methods work with display type transformations.
+     *
+     * @example
+     * ```typescript
+     * // Register a method
+     * await reactor.registerMethod({
+     *   functionName: "icrc1_balance_of",
+     *   candid: "(record { owner : principal }) -> (nat) query"
+     * })
+     *
+     * // Now use with display types!
+     * const balance = await reactor.callMethod({
+     *   functionName: "icrc1_balance_of",
+     *   args: [{ owner: "aaaaa-aa" }] // Principal as string
+     * })
+     * // balance is string (not bigint) due to display transformation
+     * ```
+     */
+    async registerMethod(options) {
+        const { functionName, candid } = options;
+        // Check if method already registered
+        const existing = this.service._fields.find(([name]) => name === functionName);
+        if (existing)
+            return;
+        // Parse the Candid signature
+        const serviceSource = candid.includes("service :")
+            ? candid
+            : `service : { ${functionName} : ${candid}; }`;
+        const { idlFactory } = await this.adapter.parseCandidSource(serviceSource);
+        const parsedService = idlFactory({ IDL });
+        const funcField = parsedService._fields.find(([name]) => name === functionName);
+        if (!funcField) {
+            throw new Error(`Method "${functionName}" not found in the provided Candid signature`);
+        }
+        // Inject into our service
+        this.service._fields.push(funcField);
+        // Re-initialize codecs for the new method
+        this.reinitializeCodecs();
+    }
+    /**
+     * Register multiple methods at once.
+     *
+     * @example
+     * ```typescript
+     * await reactor.registerMethods([
+     *   { functionName: "icrc1_balance_of", candid: "(record { owner : principal }) -> (nat) query" },
+     *   { functionName: "icrc1_transfer", candid: "(record { to : principal; amount : nat }) -> (variant { Ok : nat; Err : text })" }
+     * ])
+     * ```
+     */
+    async registerMethods(methods) {
+        await Promise.all(methods.map((m) => this.registerMethod(m)));
+    }
+    /**
+     * Check if a method is registered (either from initialize or registerMethod).
+     */
+    hasMethod(functionName) {
+        return this.service._fields.some(([name]) => name === functionName);
+    }
+    /**
+     * Get all registered method names.
+     */
+    getMethodNames() {
+        return this.service._fields.map(([name]) => name);
+    }
+    // ══════════════════════════════════════════════════════════════════════════
+    // DYNAMIC CALL SHORTCUTS
+    // ══════════════════════════════════════════════════════════════════════════
+    /**
+     * Perform a dynamic update call in one step with display type transformations.
+     * Registers the method if not already registered, then calls it.
+     *
+     * @example
+     * ```typescript
+     * const result = await reactor.callDynamic({
+     *   functionName: "transfer",
+     *   candid: "(record { to : principal; amount : nat }) -> (variant { Ok : nat; Err : text })",
+     *   args: [{ to: "aaaaa-aa", amount: "100" }] // Display types!
+     * })
+     * ```
+     */
+    async callDynamic(options) {
+        await this.registerMethod(options);
+        return this.callMethod({
+            functionName: options.functionName,
+            args: options.args,
+        });
+    }
+    /**
+     * Perform a dynamic query call in one step with display type transformations.
+     * Registers the method if not already registered, then calls it.
+     *
+     * @example
+     * ```typescript
+     * const balance = await reactor.queryDynamic({
+     *   functionName: "icrc1_balance_of",
+     *   candid: "(record { owner : principal }) -> (nat) query",
+     *   args: [{ owner: "aaaaa-aa" }] // Display types!
+     * })
+     * // balance is string (not BigInt)
+     * ```
+     */
+    async queryDynamic(options) {
+        await this.registerMethod(options);
+        return this.callMethod({
+            functionName: options.functionName,
+            args: options.args,
+        });
+    }
+    /**
+     * Fetch with dynamic Candid and TanStack Query caching.
+     * Registers the method if not already registered, then fetches with caching.
+     * Results are transformed to display types.
+     *
+     * @example
+     * ```typescript
+     * const balance = await reactor.fetchQueryDynamic({
+     *   functionName: "icrc1_balance_of",
+     *   candid: "(record { owner : principal }) -> (nat) query",
+     *   args: [{ owner: "aaaaa-aa" }]
+     * })
+     * // Subsequent calls with same args return cached result
+     * ```
+     */
+    async fetchQueryDynamic(options) {
+        await this.registerMethod(options);
+        return this.fetchQuery({
+            functionName: options.functionName,
+            args: options.args,
+        });
+    }
+}
+//# sourceMappingURL=display-reactor.js.map

package/dist/display-reactor.js.map

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

package/dist/index.d.ts

@@ -1,6 +1,9 @@
-export { CandidAdapter } from "./adapter";
+export * from "./adapter";
 export * from "./types";
+export * from "./visitor";
 export * from "./constants";
 export * from "./utils";
 export * from "./reactor";
+export * from "./display-reactor";
+export * from "./metadata-display-reactor";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,mBAAmB,CAAA;AACjC,cAAc,4BAA4B,CAAA"}

package/dist/index.js

@@ -1,6 +1,9 @@
-export { CandidAdapter } from "./adapter";
+export * from "./adapter";
 export * from "./types";
+export * from "./visitor";
 export * from "./constants";
 export * from "./utils";
 export * from "./reactor";
+export * from "./display-reactor";
+export * from "./metadata-display-reactor";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,mBAAmB,CAAA;AACjC,cAAc,4BAA4B,CAAA"}