@ic-reactor/candid 3.0.0-beta.0

package/dist/adapter.js

@@ -0,0 +1,384 @@
+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";
+/**
+ * CandidAdapter provides functionality to fetch and parse Candid definitions
+ * from Internet Computer canisters.
+ *
+ * It supports multiple methods for retrieving Candid definitions:
+ * 1. From canister metadata (preferred)
+ * 2. From the `__get_candid_interface_tmp_hack` method (fallback)
+ *
+ * It also supports parsing Candid to JavaScript using:
+ * 1. Local WASM parser (@ic-reactor/parser) - faster, no network request
+ * 2. Remote didjs canister - always available fallback
+ *
+ * @example
+ * ```typescript
+ * import { CandidAdapter } from "@ic-reactor/candid"
+ * import { ClientManager } from "@ic-reactor/core"
+ * import { QueryClient } from "@tanstack/query-core"
+ *
+ * const queryClient = new QueryClient()
+ * const clientManager = new ClientManager({ queryClient })
+ * await clientManager.initialize()
+ *
+ * const adapter = new CandidAdapter({ clientManager })
+ *
+ * // Optionally load the local parser for faster processing
+ * await adapter.loadParser()
+ *
+ * // Get the Candid definition for a canister
+ * const { idlFactory } = await adapter.getCandidDefinition("ryjl3-tyaaa-aaaaa-aaaba-cai")
+ * ```
+ */
+export class CandidAdapter {
+    /**
+     * Creates a new CandidAdapter instance.
+     *
+     * @param params - The adapter parameters.
+     */
+    constructor({ clientManager, didjsCanisterId }) {
+        /** The client manager providing agent and identity access. */
+        Object.defineProperty(this, "clientManager", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** The canister ID of the didjs canister for remote Candid compilation. */
+        Object.defineProperty(this, "didjsCanisterId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** The optional local parser module. */
+        Object.defineProperty(this, "parserModule", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** Whether parser auto-loading has been attempted. */
+        Object.defineProperty(this, "parserLoadAttempted", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        /** Function to unsubscribe from identity updates. */
+        Object.defineProperty(this, "unsubscribe", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: noop
+        });
+        this.clientManager = clientManager;
+        this.didjsCanisterId = didjsCanisterId || this.getDefaultDidJsId();
+        // Subscribe to identity changes to update didjs canister ID if needed
+        this.unsubscribe = clientManager.subscribe(() => {
+            if (!didjsCanisterId) {
+                this.didjsCanisterId = this.getDefaultDidJsId();
+            }
+        });
+    }
+    /**
+     * The HTTP agent from the client manager.
+     */
+    get agent() {
+        return this.clientManager.agent;
+    }
+    /**
+     * Whether the local parser is available.
+     */
+    get hasParser() {
+        return this.parserModule !== undefined;
+    }
+    /**
+     * Loads the local parser module for converting Candid to JavaScript.
+     * If no module is provided, attempts to dynamically load @ic-reactor/parser.
+     *
+     * @param module - Optional parser module to use.
+     * @throws Error if the parser loading fails.
+     *
+     * @example
+     * ```typescript
+     * // Load the default parser
+     * await adapter.loadParser()
+     *
+     * // Or provide a custom parser
+     * import * as parser from "@ic-reactor/parser"
+     * await adapter.loadParser(parser)
+     * ```
+     */
+    async loadParser(module) {
+        if (module !== undefined) {
+            this.parserModule = module;
+            this.parserLoadAttempted = true;
+            return;
+        }
+        if (this.parserLoadAttempted) {
+            return; // Already tried loading
+        }
+        this.parserLoadAttempted = true;
+        try {
+            this.parserModule = require("@ic-reactor/parser");
+            if (this.parserModule?.default) {
+                await this.parserModule.default();
+            }
+        }
+        catch (error) {
+            throw new Error(`Error loading parser: ${error}`);
+        }
+    }
+    /**
+     * Attempts to load the parser silently (no error if not available).
+     * Useful for optional parser initialization.
+     */
+    async tryLoadParser() {
+        if (this.parserModule || this.parserLoadAttempted) {
+            return;
+        }
+        this.parserLoadAttempted = true;
+        try {
+            this.parserModule = require("@ic-reactor/parser");
+            if (this.parserModule?.default) {
+                await this.parserModule.default();
+            }
+        }
+        catch {
+            // Silently fail - parser is optional
+            this.parserModule = undefined;
+        }
+    }
+    /**
+     * Gets the default didjs canister ID based on whether the agent is local or not.
+     */
+    getDefaultDidJsId() {
+        return this.clientManager.isLocal
+            ? DEFAULT_LOCAL_DIDJS_ID
+            : DEFAULT_IC_DIDJS_ID;
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // MAIN API - High-level methods for fetching Candid definitions
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Gets the parsed Candid definition for a canister, ready for use with Actor.createActor.
+     * This is the main entry point for fetching a canister's interface.
+     *
+     * @param canisterId - The canister ID to get the Candid definition for.
+     * @returns The parsed Candid definition with idlFactory and optional init.
+     * @throws Error if fetching or parsing fails.
+     *
+     * @example
+     * ```typescript
+     * const { idlFactory } = await adapter.getCandidDefinition("ryjl3-tyaaa-aaaaa-aaaba-cai")
+     * ```
+     */
+    async getCandidDefinition(canisterId) {
+        try {
+            const candidSource = await this.fetchCandidSource(canisterId);
+            return await this.parseCandidSource(candidSource);
+        }
+        catch (error) {
+            throw new Error(`Error fetching canister ${canisterId}: ${error}`);
+        }
+    }
+    /**
+     * Fetches the raw Candid source string for a canister.
+     * First attempts to get it from metadata, then falls back to the tmp hack method.
+     *
+     * @param canisterId - The canister ID to fetch the Candid source for.
+     * @returns The raw Candid source string (.did file contents).
+     * @throws Error if both methods fail.
+     *
+     * @example
+     * ```typescript
+     * const candidSource = await adapter.fetchCandidSource("ryjl3-tyaaa-aaaaa-aaaba-cai")
+     * console.log(candidSource) // service { greet: (text) -> (text) query; }
+     * ```
+     */
+    async fetchCandidSource(canisterId) {
+        // First attempt: Try getting Candid from metadata
+        const fromMetadata = await this.fetchFromMetadata(canisterId).catch(() => undefined);
+        if (fromMetadata) {
+            return fromMetadata;
+        }
+        // Second attempt: Try the temporary hack method
+        const fromTmpHack = await this.fetchFromTmpHack(canisterId).catch(() => undefined);
+        if (fromTmpHack) {
+            return fromTmpHack;
+        }
+        throw new Error("Failed to retrieve Candid source by any method.");
+    }
+    /**
+     * Parses Candid source string and returns the definition with idlFactory.
+     * First attempts to use the local parser, then falls back to the remote didjs canister.
+     *
+     * @param candidSource - The raw Candid source string.
+     * @returns The parsed Candid definition.
+     * @throws Error if parsing fails.
+     */
+    async parseCandidSource(candidSource) {
+        // Try to auto-load parser if not already loaded
+        await this.tryLoadParser();
+        let compiledJs;
+        // First attempt: Try local parser (faster, no network)
+        if (this.parserModule) {
+            try {
+                compiledJs = this.compileLocal(candidSource);
+            }
+            catch {
+                // Fall through to remote compilation
+            }
+        }
+        // Second attempt: Try remote didjs canister
+        if (!compiledJs) {
+            compiledJs = await this.compileRemote(candidSource);
+        }
+        if (!compiledJs) {
+            throw new Error("Failed to compile Candid to JavaScript");
+        }
+        return importCandidDefinition(compiledJs);
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // FETCH METHODS - Low-level methods for fetching Candid source
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Fetches Candid source from the canister's metadata.
+     *
+     * @param canisterId - The canister ID to query.
+     * @returns The Candid source string, or undefined if not available.
+     */
+    async fetchFromMetadata(canisterId) {
+        const status = await CanisterStatus.request({
+            agent: this.agent,
+            canisterId: canisterId,
+            paths: ["candid"],
+        });
+        return status.get("candid");
+    }
+    /**
+     * Fetches Candid source using the temporary hack method.
+     * This calls the `__get_candid_interface_tmp_hack` query method on the canister.
+     *
+     * @param canisterId - The canister ID to query.
+     * @returns The Candid source string.
+     */
+    async fetchFromTmpHack(canisterId) {
+        const canisterIdStr = typeof canisterId === "string" ? canisterId : canisterId.toString();
+        // Use raw agent.query instead of Actor.createActor
+        const response = await this.agent.query(canisterIdStr, {
+            methodName: "__get_candid_interface_tmp_hack",
+            arg: IDL.encode([], []),
+        });
+        if ("reply" in response && response.reply) {
+            const [candidSource] = IDL.decode([IDL.Text], response.reply.arg);
+            return candidSource;
+        }
+        throw new Error(`Query failed: ${JSON.stringify(response)}`);
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // COMPILE METHODS - Methods for compiling Candid to JavaScript
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Compiles Candid source to JavaScript using the local WASM parser.
+     *
+     * @param candidSource - The Candid source to compile.
+     * @returns The compiled JavaScript code.
+     * @throws Error if the parser is not loaded.
+     */
+    compileLocal(candidSource) {
+        if (!this.parserModule) {
+            throw new Error("Parser not loaded. Call loadParser() first.");
+        }
+        return this.parserModule.didToJs(candidSource);
+    }
+    /**
+     * Compiles Candid source to JavaScript using the remote didjs canister.
+     *
+     * @param candidSource - The Candid source to compile.
+     * @param didjsCanisterId - Optional custom didjs canister ID.
+     * @returns The compiled JavaScript code, or undefined if compilation fails.
+     */
+    async compileRemote(candidSource, didjsCanisterId) {
+        const canisterId = didjsCanisterId || this.didjsCanisterId;
+        // Use raw agent.query instead of Actor.createActor
+        const response = await this.agent.query(canisterId, {
+            methodName: "did_to_js",
+            arg: IDL.encode([IDL.Text], [candidSource]),
+        });
+        if ("reply" in response && response.reply) {
+            const [result] = IDL.decode([IDL.Opt(IDL.Text)], response.reply.arg);
+            return result[0];
+        }
+        throw new Error(`Query failed: ${JSON.stringify(response)}`);
+    }
+    /**
+     * Validates Candid source using the local parser.
+     *
+     * @param candidSource - The Candid source to validate.
+     * @returns True if the source is valid, false otherwise.
+     * @throws Error if the parser is not loaded.
+     */
+    validateCandid(candidSource) {
+        if (!this.parserModule) {
+            throw new Error("Parser not loaded. Call loadParser() first.");
+        }
+        return this.parserModule.validateIDL(candidSource);
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // DEPRECATED ALIASES - For backwards compatibility
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * @deprecated Use `loadParser()` instead.
+     */
+    async initializeParser(module) {
+        return this.loadParser(module);
+    }
+    /**
+     * @deprecated Use `fetchCandidSource()` instead.
+     */
+    async fetchCandidDefinition(canisterId) {
+        return this.fetchCandidSource(canisterId);
+    }
+    /**
+     * @deprecated Use `fetchFromMetadata()` instead.
+     */
+    async getFromMetadata(canisterId) {
+        return this.fetchFromMetadata(canisterId);
+    }
+    /**
+     * @deprecated Use `fetchFromTmpHack()` instead.
+     */
+    async getFromTmpHack(canisterId) {
+        return this.fetchFromTmpHack(canisterId);
+    }
+    /**
+     * @deprecated Use `parseCandidSource()` instead.
+     */
+    async evaluateCandidDefinition(data) {
+        return this.parseCandidSource(data);
+    }
+    /**
+     * @deprecated Use `compileRemote()` instead.
+     */
+    async fetchDidTojs(candidSource, didjsCanisterId) {
+        return this.compileRemote(candidSource, didjsCanisterId);
+    }
+    /**
+     * @deprecated Use `compileLocal()` instead.
+     */
+    parseDidToJs(candidSource) {
+        return this.compileLocal(candidSource);
+    }
+    /**
+     * @deprecated Use `validateCandid()` instead.
+     */
+    validateIDL(candidSource) {
+        return this.validateCandid(candidSource);
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Default didjs canister ID for the IC mainnet.
+ * This canister is used to compile Candid to JavaScript.
+ */
+export declare const DEFAULT_IC_DIDJS_ID = "a4gq6-oaaaa-aaaab-qaa4q-cai";
+/**
+ * Default didjs canister ID for local development.
+ * This canister is used to compile Candid to JavaScript locally.
+ */
+export declare const DEFAULT_LOCAL_DIDJS_ID = "bd3sg-teaaa-aaaaa-qaaba-cai";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,mBAAmB,gCAAgC,CAAA;AAEhE;;;GAGG;AACH,eAAO,MAAM,sBAAsB,gCAAgC,CAAA"}

package/dist/constants.js

@@ -0,0 +1,11 @@
+/**
+ * Default didjs canister ID for the IC mainnet.
+ * This canister is used to compile Candid to JavaScript.
+ */
+export const DEFAULT_IC_DIDJS_ID = "a4gq6-oaaaa-aaaab-qaa4q-cai";
+/**
+ * Default didjs canister ID for local development.
+ * This canister is used to compile Candid to JavaScript locally.
+ */
+export const DEFAULT_LOCAL_DIDJS_ID = "bd3sg-teaaa-aaaaa-qaaba-cai";
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,6BAA6B,CAAA;AAEhE;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,6BAA6B,CAAA"}

package/dist/index.d.ts

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

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

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

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/reactor.d.ts

@@ -0,0 +1,103 @@
+import type { BaseActor } from "@ic-reactor/core";
+import type { CandidReactorParameters, DynamicMethodOptions } from "./types";
+import { Reactor } from "@ic-reactor/core";
+import { CandidAdapter } from "./adapter";
+export declare class CandidReactor<A = BaseActor> extends Reactor<A> {
+    adapter: CandidAdapter;
+    private candidSource?;
+    constructor(config: CandidReactorParameters<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 standard Reactor methods (callMethod, fetchQuery, etc.) work.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Register a dynamic method by its Candid signature.
+     * After registration, all standard Reactor methods work with this method name.
+     *
+     * @example
+     * ```typescript
+     * // Register a method
+     * await reactor.registerMethod({
+     *   functionName: "icrc1_balance_of",
+     *   candid: "(record { owner : principal }) -> (nat) query"
+     * })
+     *
+     * // Now use standard Reactor methods!
+     * const balance = await reactor.callMethod({
+     *   functionName: "icrc1_balance_of",
+     *   args: [{ owner }]
+     * })
+     *
+     * // Or with caching
+     * const cachedBalance = await reactor.fetchQuery({
+     *   functionName: "icrc1_balance_of",
+     *   args: [{ owner }]
+     * })
+     * ```
+     */
+    registerMethod(options: DynamicMethodOptions): Promise<void>;
+    /**
+     * Register multiple methods at once.
+     */
+    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.
+     * 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: Principal.fromText("..."), amount: 100n }]
+     * })
+     * ```
+     */
+    callDynamic<T = unknown>(options: DynamicMethodOptions & {
+        args?: unknown[];
+    }): Promise<T>;
+    /**
+     * Perform a dynamic query call in one step.
+     * 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: Principal.fromText("...") }]
+     * })
+     * ```
+     */
+    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.
+     *
+     * @example
+     * ```typescript
+     * const balance = await reactor.fetchQueryDynamic({
+     *   functionName: "icrc1_balance_of",
+     *   candid: "(record { owner : principal }) -> (nat) query",
+     *   args: [{ owner }]
+     * })
+     * ```
+     */
+    fetchQueryDynamic<T = unknown>(options: DynamicMethodOptions & {
+        args?: unknown[];
+    }): Promise<T>;
+}
+//# sourceMappingURL=reactor.d.ts.map

package/dist/reactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactor.d.ts","sourceRoot":"","sources":["../src/reactor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAqB,MAAM,kBAAkB,CAAA;AACpE,OAAO,KAAK,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAE5E,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAGzC,qBAAa,aAAa,CAAC,CAAC,GAAG,SAAS,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IACnD,OAAO,EAAE,aAAa,CAAA;IAC7B,OAAO,CAAC,YAAY,CAAC,CAAQ;gBAEjB,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAgB9C;;;;;OAKG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAcxC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACU,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BzE;;OAEG;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;;;;;;;;;;;;OAYG;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;;;;;;;;;;;;OAYG;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"}