@ic-reactor/core 2.0.1 → 3.0.0-beta.1

package/dist/display-reactor.d.ts

@@ -0,0 +1,245 @@
+import { Reactor } from "./reactor";
+import { ActorMethodParameters, ActorMethodReturnType, FunctionName, ReactorArgs, ReactorReturnOk, ActorMethodCodecs, ReactorParameters, BaseActor } from "./types/reactor";
+import { ValidationIssue } from "./errors";
+/**
+ * Validation result returned by a validator function.
+ * Either success (true) or failure with issues.
+ */
+export type ValidationResult = {
+    success: true;
+} | {
+    success: false;
+    issues: ValidationIssue[];
+};
+/**
+ * A validator function that validates method arguments.
+ * Receives display types (strings for Principal, bigint, etc.).
+ *
+ * @param args - The display-type arguments to validate
+ * @returns ValidationResult indicating success or failure with issues
+ *
+ * @example
+ * ```typescript
+ * // Validator receives display types
+ * reactor.registerValidator("transfer", ([input]) => {
+ *   const issues = []
+ *
+ *   // input.to is string (not Principal)
+ *   if (!input.to) {
+ *     issues.push({ path: ["to"], message: "Recipient is required" })
+ *   }
+ *
+ *   // input.amount is string (not bigint)
+ *   if (!/^\d+$/.test(input.amount)) {
+ *     issues.push({ path: ["amount"], message: "Must be a valid number" })
+ *   }
+ *
+ *   return issues.length > 0 ? { success: false, issues } : { success: true }
+ * })
+ * ```
+ */
+export type Validator<Args = unknown[]> = (args: Args) => ValidationResult | Promise<ValidationResult>;
+/**
+ * Validator that receives display types for a specific method.
+ */
+export type DisplayValidator<A, M extends FunctionName<A>> = Validator<ReactorArgs<A, M, "display">>;
+export type DisplayReactorParameters<A = BaseActor> = ReactorParameters<A> & {
+    /**
+     * Optional initial validators to register.
+     * Validators receive display types (strings for Principal, bigint, etc.)
+     */
+    validators?: Partial<{
+        [M in FunctionName<A>]: DisplayValidator<A, M>;
+    }>;
+};
+/**
+ * DisplayReactor provides automatic type transformations between Candid and
+ * display-friendly types, plus optional argument validation.
+ *
+ * ### Type Transformations
+ * - `bigint` → `string` (for JSON/UI display)
+ * - `Principal` → `string` (text representation)
+ * - `[T] | []` → `T | null` (optional unwrapping)
+ * - Small blobs → hex strings
+ *
+ * ### Validation (Optional)
+ * Register validators to check arguments before canister calls.
+ * Validators receive **display types** (strings), making them perfect for
+ * form validation.
+ *
+ * @typeParam A - The actor service type
+ *
+ * @example
+ * ```typescript
+ * import { DisplayReactor } from "@ic-reactor/core"
+ *
+ * const reactor = new DisplayReactor<_SERVICE>({
+ *   clientManager,
+ *   canisterId: "...",
+ *   idlFactory,
+ * })
+ *
+ * // Optional: Add validation
+ * reactor.registerValidator("transfer", ([input]) => {
+ *   if (!input.to) {
+ *     return {
+ *       success: false,
+ *       issues: [{ path: ["to"], message: "Recipient is required" }]
+ *     }
+ *   }
+ *   return { success: true }
+ * })
+ *
+ * // Call with display types
+ * await reactor.callMethod({
+ *   functionName: "transfer",
+ *   args: [{ to: "aaaaa-aa", amount: "100" }], // strings!
+ * })
+ * ```
+ */
+export declare class DisplayReactor<A = BaseActor> extends Reactor<A, "display"> {
+    readonly transform = "display";
+    private codecs;
+    private validators;
+    constructor(config: DisplayReactorParameters<A>);
+    /**
+     * Initialize codecs from IDL factory for automatic type transformations
+     */
+    private initializeCodecs;
+    /**
+     * Get a codec for a specific method.
+     * Returns the args and result codecs for bidirectional transformation.
+     * @param methodName - The name of the method
+     * @returns Object with args and result codecs, or null if not found
+     */
+    getCodec<M extends FunctionName<A>>(methodName: M): ActorMethodCodecs<A, M> | null;
+    /**
+     * Register a validator for a specific method.
+     * Validators receive display types (strings for Principal/bigint).
+     *
+     * @param methodName - The name of the method to validate
+     * @param validator - The validator function receiving display types
+     *
+     * @example
+     * ```typescript
+     * // input.to is string, input.amount is string
+     * reactor.registerValidator("transfer", ([input]) => {
+     *   if (!/^\d+$/.test(input.amount)) {
+     *     return {
+     *       success: false,
+     *       issues: [{ path: ["amount"], message: "Must be a valid number" }]
+     *     }
+     *   }
+     *   return { success: true }
+     * })
+     * ```
+     */
+    registerValidator<M extends FunctionName<A>>(methodName: M, validator: DisplayValidator<A, M>): void;
+    /**
+     * Unregister a validator for a specific method.
+     */
+    unregisterValidator<M extends FunctionName<A>>(methodName: M): void;
+    /**
+     * Check if a method has a registered validator.
+     */
+    hasValidator<M extends FunctionName<A>>(methodName: M): boolean;
+    /**
+     * Validate arguments without calling the canister.
+     * Arguments are in display format (strings for Principal/bigint).
+     * Useful for form validation before submission.
+     *
+     * @param methodName - The name of the method
+     * @param args - The display-type arguments to validate
+     * @returns ValidationResult indicating success or failure
+     *
+     * @example
+     * ```typescript
+     * // Validate form data before submission
+     * const result = await reactor.validate("transfer", [{
+     *   to: formData.recipient,  // string
+     *   amount: formData.amount, // string
+     * }])
+     *
+     * if (!result.success) {
+     *   result.issues.forEach(issue => {
+     *     form.setError(issue.path[0], issue.message)
+     *   })
+     * }
+     * ```
+     */
+    validate<M extends FunctionName<A>>(methodName: M, args: ReactorArgs<A, M, "display">): Promise<ValidationResult>;
+    /**
+     * Call a method with async validation support.
+     * Use this instead of callMethod() when you have async validators.
+     *
+     * @example
+     * ```typescript
+     * // Async validator (e.g., check if address is blocked)
+     * reactor.registerValidator("transfer", async ([input]) => {
+     *   const isBlocked = await checkBlocklist(input.to)
+     *   if (isBlocked) {
+     *     return {
+     *       success: false,
+     *       issues: [{ path: ["to"], message: "Address is blocked" }]
+     *     }
+     *   }
+     *   return { success: true }
+     * })
+     *
+     * await reactor.callMethodWithValidation({
+     *   functionName: "transfer",
+     *   args: [{ to: "...", amount: "100" }],
+     * })
+     * ```
+     */
+    callMethodWithValidation<M extends FunctionName<A>>(params: {
+        functionName: M;
+        args?: ReactorArgs<A, M, "display">;
+        callConfig?: Parameters<Reactor<A, "display">["callMethod"]>[0]["callConfig"];
+    }): Promise<ReactorReturnOk<A, M, "display">>;
+    /**
+     * Transform arguments before calling the actor method.
+     * 1. Validates display-type args (if validator registered)
+     * 2. Converts Display → Candid
+     */
+    protected transformArgs<M extends FunctionName<A>>(methodName: M, args?: ReactorArgs<A, M, "display">): ActorMethodParameters<A[M]>;
+    /**
+     * Transform the result after calling the actor method.
+     * Always extracts the Ok value from Result types (throws CanisterError on Err).
+     * Also converts Candid → Display format.
+     */
+    protected transformResult<M extends FunctionName<A>>(methodName: M, result: ActorMethodReturnType<A[M]>): ReactorReturnOk<A, M, "display">;
+}
+/**
+ * Create a validator from a Zod schema.
+ * This is a utility function to easily integrate Zod schemas as validators.
+ *
+ * @param schema - A Zod schema to validate against
+ * @returns A Validator function compatible with DisplayReactor
+ *
+ * @example
+ * ```typescript
+ * import { z } from "zod"
+ * import { fromZodSchema } from "@ic-reactor/core"
+ *
+ * const transferSchema = z.object({
+ *   to: z.string().min(1, "Recipient is required"),
+ *   amount: z.string().regex(/^\d+$/, "Must be a valid number"),
+ * })
+ *
+ * reactor.registerValidator("transfer", fromZodSchema(transferSchema))
+ * ```
+ */
+export declare function fromZodSchema<T>(schema: {
+    safeParse: (data: unknown) => {
+        success: boolean;
+        error?: {
+            issues: Array<{
+                path: (string | number)[];
+                message: string;
+                code?: string;
+            }>;
+        };
+    };
+}): Validator<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":"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"}

package/dist/display-reactor.js

@@ -0,0 +1,331 @@
+import { Reactor } from "./reactor";
+import { didToDisplayCodec, transformArgsWithCodec, transformResultWithCodec, didTypeFromArray, } from "./display";
+import { extractOkResult } from "./utils/helper";
+import { ValidationError } from "./errors";
+// ============================================================================
+// DisplayReactor
+// ============================================================================
+/**
+ * DisplayReactor provides automatic type transformations between Candid and
+ * display-friendly types, plus optional argument validation.
+ *
+ * ### Type Transformations
+ * - `bigint` → `string` (for JSON/UI display)
+ * - `Principal` → `string` (text representation)
+ * - `[T] | []` → `T | null` (optional unwrapping)
+ * - Small blobs → hex strings
+ *
+ * ### Validation (Optional)
+ * Register validators to check arguments before canister calls.
+ * Validators receive **display types** (strings), making them perfect for
+ * form validation.
+ *
+ * @typeParam A - The actor service type
+ *
+ * @example
+ * ```typescript
+ * import { DisplayReactor } from "@ic-reactor/core"
+ *
+ * const reactor = new DisplayReactor<_SERVICE>({
+ *   clientManager,
+ *   canisterId: "...",
+ *   idlFactory,
+ * })
+ *
+ * // Optional: Add validation
+ * reactor.registerValidator("transfer", ([input]) => {
+ *   if (!input.to) {
+ *     return {
+ *       success: false,
+ *       issues: [{ path: ["to"], message: "Recipient is required" }]
+ *     }
+ *   }
+ *   return { success: true }
+ * })
+ *
+ * // Call with display types
+ * await reactor.callMethod({
+ *   functionName: "transfer",
+ *   args: [{ to: "aaaaa-aa", amount: "100" }], // strings!
+ * })
+ * ```
+ */
+export class DisplayReactor extends Reactor {
+    constructor(config) {
+        super(config);
+        Object.defineProperty(this, "transform", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "display"
+        });
+        Object.defineProperty(this, "codecs", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        Object.defineProperty(this, "validators", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        this.initializeCodecs();
+        // Register initial validators if provided
+        if (config.validators) {
+            for (const [methodName, validator] of Object.entries(config.validators)) {
+                if (validator) {
+                    this.validators.set(methodName, validator);
+                }
+            }
+        }
+    }
+    /**
+     * Initialize codecs from IDL factory for automatic type transformations
+     */
+    initializeCodecs() {
+        try {
+            const fields = this.getServiceInterface()?._fields;
+            if (!fields) {
+                throw new Error("No fields found");
+            }
+            for (const [methodName, funcType] of fields) {
+                // Generate args codec
+                const argsIdlType = didTypeFromArray(funcType.argTypes);
+                // Generate result codec
+                const retIdlType = didTypeFromArray(funcType.retTypes);
+                // Set codec in map
+                this.codecs.set(methodName, {
+                    args: didToDisplayCodec(argsIdlType),
+                    result: didToDisplayCodec(retIdlType),
+                });
+            }
+        }
+        catch (error) {
+            console.error("Failed to initialize codecs:", error);
+        }
+    }
+    // ============================================================================
+    // Codec Methods
+    // ============================================================================
+    /**
+     * Get a codec for a specific method.
+     * Returns the args and result codecs for bidirectional transformation.
+     * @param methodName - The name of the method
+     * @returns Object with args and result codecs, or null if not found
+     */
+    getCodec(methodName) {
+        const cached = this.codecs.get(methodName);
+        if (cached) {
+            return cached;
+        }
+        return null;
+    }
+    // ============================================================================
+    // Validation Methods
+    // ============================================================================
+    /**
+     * Register a validator for a specific method.
+     * Validators receive display types (strings for Principal/bigint).
+     *
+     * @param methodName - The name of the method to validate
+     * @param validator - The validator function receiving display types
+     *
+     * @example
+     * ```typescript
+     * // input.to is string, input.amount is string
+     * reactor.registerValidator("transfer", ([input]) => {
+     *   if (!/^\d+$/.test(input.amount)) {
+     *     return {
+     *       success: false,
+     *       issues: [{ path: ["amount"], message: "Must be a valid number" }]
+     *     }
+     *   }
+     *   return { success: true }
+     * })
+     * ```
+     */
+    registerValidator(methodName, validator) {
+        this.validators.set(methodName, validator);
+    }
+    /**
+     * Unregister a validator for a specific method.
+     */
+    unregisterValidator(methodName) {
+        this.validators.delete(methodName);
+    }
+    /**
+     * Check if a method has a registered validator.
+     */
+    hasValidator(methodName) {
+        return this.validators.has(methodName);
+    }
+    /**
+     * Validate arguments without calling the canister.
+     * Arguments are in display format (strings for Principal/bigint).
+     * Useful for form validation before submission.
+     *
+     * @param methodName - The name of the method
+     * @param args - The display-type arguments to validate
+     * @returns ValidationResult indicating success or failure
+     *
+     * @example
+     * ```typescript
+     * // Validate form data before submission
+     * const result = await reactor.validate("transfer", [{
+     *   to: formData.recipient,  // string
+     *   amount: formData.amount, // string
+     * }])
+     *
+     * if (!result.success) {
+     *   result.issues.forEach(issue => {
+     *     form.setError(issue.path[0], issue.message)
+     *   })
+     * }
+     * ```
+     */
+    async validate(methodName, args) {
+        const validator = this.validators.get(methodName);
+        if (!validator) {
+            return { success: true };
+        }
+        return validator(args);
+    }
+    /**
+     * Call a method with async validation support.
+     * Use this instead of callMethod() when you have async validators.
+     *
+     * @example
+     * ```typescript
+     * // Async validator (e.g., check if address is blocked)
+     * reactor.registerValidator("transfer", async ([input]) => {
+     *   const isBlocked = await checkBlocklist(input.to)
+     *   if (isBlocked) {
+     *     return {
+     *       success: false,
+     *       issues: [{ path: ["to"], message: "Address is blocked" }]
+     *     }
+     *   }
+     *   return { success: true }
+     * })
+     *
+     * await reactor.callMethodWithValidation({
+     *   functionName: "transfer",
+     *   args: [{ to: "...", amount: "100" }],
+     * })
+     * ```
+     */
+    async callMethodWithValidation(params) {
+        // Run async validation first (on display types)
+        if (params.args) {
+            const result = await this.validate(params.functionName, params.args);
+            if (!result.success) {
+                throw new ValidationError(String(params.functionName), result.issues);
+            }
+        }
+        // Skip synchronous validation in transformArgs by temporarily removing validator
+        const validator = this.validators.get(params.functionName);
+        if (validator) {
+            this.validators.delete(params.functionName);
+        }
+        try {
+            return await this.callMethod(params);
+        }
+        finally {
+            // Restore validator
+            if (validator) {
+                this.validators.set(params.functionName, validator);
+            }
+        }
+    }
+    // ============================================================================
+    // Transform Methods
+    // ============================================================================
+    /**
+     * Transform arguments before calling the actor method.
+     * 1. Validates display-type args (if validator registered)
+     * 2. Converts Display → Candid
+     */
+    transformArgs(methodName, args) {
+        // 1. Validate FIRST (on display types)
+        const validator = this.validators.get(methodName);
+        if (validator && args) {
+            const result = validator(args);
+            // Handle Promise (async validator)
+            if (result &&
+                typeof result.then === "function") {
+                throw new Error(`Async validators are not supported in callMethod(). ` +
+                    `Use reactor.callMethodWithValidation() for async validation.`);
+            }
+            const syncResult = result;
+            if (!syncResult.success) {
+                throw new ValidationError(String(methodName), syncResult.issues);
+            }
+        }
+        // 2. THEN transform: Display → Candid
+        if (this.codecs.has(methodName)) {
+            const codec = this.codecs.get(methodName);
+            return transformArgsWithCodec(codec.args, args);
+        }
+        if (!args) {
+            return [];
+        }
+        return args;
+    }
+    /**
+     * Transform the result after calling the actor method.
+     * Always extracts the Ok value from Result types (throws CanisterError on Err).
+     * Also converts Candid → Display format.
+     */
+    transformResult(methodName, result) {
+        let transformedResult = result;
+        // 1. Apply display transformation to the FULL result
+        if (this.codecs.has(methodName)) {
+            const codec = this.codecs.get(methodName);
+            transformedResult = transformResultWithCodec(codec.result, result);
+        }
+        // 2. Extract Ok value from the TRANSFORMED (or raw) result
+        //    This handles { ok: T } / { err: E } from Motoko/Rust canisters
+        return extractOkResult(transformedResult);
+    }
+}
+// ============================================================================
+// Zod Integration Helper
+// ============================================================================
+/**
+ * Create a validator from a Zod schema.
+ * This is a utility function to easily integrate Zod schemas as validators.
+ *
+ * @param schema - A Zod schema to validate against
+ * @returns A Validator function compatible with DisplayReactor
+ *
+ * @example
+ * ```typescript
+ * import { z } from "zod"
+ * import { fromZodSchema } from "@ic-reactor/core"
+ *
+ * const transferSchema = z.object({
+ *   to: z.string().min(1, "Recipient is required"),
+ *   amount: z.string().regex(/^\d+$/, "Must be a valid number"),
+ * })
+ *
+ * reactor.registerValidator("transfer", fromZodSchema(transferSchema))
+ * ```
+ */
+export function fromZodSchema(schema) {
+    return (args) => {
+        // Validate the first argument (common IC pattern)
+        const result = schema.safeParse(args[0]);
+        if (result.success) {
+            return { success: true };
+        }
+        const issues = result.error.issues.map((issue) => ({
+            path: issue.path,
+            message: issue.message,
+            code: issue.code,
+        }));
+        return { success: false, issues };
+    };
+}
+//# 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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"}