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

package/dist/utils/helper.js

@@ -1,105 +1,38 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.stringToHash = exports.generateActorHash = exports.generateHash = exports.generateRequestHash = exports.jsonToString = exports.getProcessEnvNetwork = exports.isInLocalOrDevelopment = exports.importCandidDefinition = void 0;
-exports.noop = noop;
-exports.createStoreWithOptionalDevtools = createStoreWithOptionalDevtools;
-exports.getNetworkByHostname = getNetworkByHostname;
-exports.isQuery = isQuery;
-exports.createCompiledResult = createCompiledResult;
-exports.extractOkResult = extractOkResult;
-const sha2_1 = require("@noble/hashes/sha2");
-const utils_1 = require("@noble/hashes/utils");
-const middleware_1 = require("zustand/middleware");
-const zustand_1 = require("zustand");
-const hash_1 = require("./hash");
-const constants_1 = require("./constants");
-/**
- * No operation function that does nothing.
- * It can be used as a placeholder or for logging purposes.
- */
-function noop() {
-    // eslint-disable-next-line no-console
-    console.warn("No operation function called");
-}
-/**
- * Creates a Zustand store with optional DevTools middleware.
- *
- * @param initialState - The initial state of the store.
- * @param config - Configuration options for DevTools.
- * @returns A Zustand store with DevTools enabled if configured, otherwise a standard store.
- */
-function createStoreWithOptionalDevtools(initialState, config) {
-    const createState = () => initialState;
-    return (0, zustand_1.createStore)((0, middleware_1.subscribeWithSelector)((0, middleware_1.devtools)(createState, {
-        enabled: !!config.withDevtools,
-        serialize: {
-            replacer: (_, value) => typeof value === "bigint" ? value.toString() : value,
-        },
-        ...config,
-    })));
-}
-const importCandidDefinition = async (candidDef) => {
-    if (typeof window === "undefined") {
-        // Node.js environment - use dynamic evaluation
-        try {
-            const moduleExports = {};
-            const moduleCode = candidDef.replace(/export const /g, "moduleExports.");
-            const func = new Function("moduleExports", moduleCode);
-            func(moduleExports);
-            return moduleExports;
-        }
-        catch (error) {
-            throw new Error(`Error importing candid definition in NodeJs: ${error.message}`);
-        }
-    }
-    else {
-        // Browser environment
-        try {
-            const loaderFunction = new Function(`
-        const blob = new Blob([\`${candidDef}\`], { type: "application/javascript" })
-        const url = URL.createObjectURL(blob)
-        return import(url)
-      `);
-            return loaderFunction();
-        }
-        catch (error) {
-            throw new Error(`Error importing candid definition: ${error}`);
-        }
-    }
+import { LOCAL_HOSTS, REMOTE_HOSTS } from "./constants";
+import { CanisterError } from "../errors";
+export const generateKey = (args) => {
+    return JSON.stringify(args, (_, v) => typeof v === "bigint" ? v.toString() : v);
 };
-exports.importCandidDefinition = importCandidDefinition;
 /**
  * Checks if the current environment is local or development.
  *
  * @returns `true` if running in a local or development environment, otherwise `false`.
  */
-const isInLocalOrDevelopment = () => {
+export const isInLocalOrDevelopment = () => {
     return typeof process !== "undefined" && process.env.DFX_NETWORK === "local";
 };
-exports.isInLocalOrDevelopment = isInLocalOrDevelopment;
 /**
  * Retrieves the network from the process environment variables.
  *
  * @returns The network name, defaulting to "ic" if not specified.
  */
-const getProcessEnvNetwork = () => {
+export const getProcessEnvNetwork = () => {
     if (typeof process === "undefined")
         return "ic";
     else
         return process.env.DFX_NETWORK ?? "ic";
 };
-exports.getProcessEnvNetwork = getProcessEnvNetwork;
 /**
  * Determines the network type based on the provided hostname.
  *
  * @param hostname - The hostname to evaluate.
  * @returns A string indicating the network type: "local", "remote", or "ic".
  */
-function getNetworkByHostname(hostname) {
-    if (constants_1.LOCAL_HOSTS.some((host) => hostname.endsWith(host))) {
+export function getNetworkByHostname(hostname) {
+    if (LOCAL_HOSTS.some((host) => hostname.endsWith(host))) {
         return "local";
     }
-    else if (constants_1.REMOTE_HOSTS.some((host) => hostname.endsWith(host))) {
+    else if (REMOTE_HOSTS.some((host) => hostname.endsWith(host))) {
         return "remote";
     }
     else {
@@ -107,92 +40,57 @@ function getNetworkByHostname(hostname) {
     }
 }
 /**
- * Checks if a given IDL function is a query.
- *
- * @param func - The IDL function to check.
- * @returns `true` if the function is a query or composite query, otherwise `false`.
- */
-function isQuery(func) {
-    return (func.annotations.includes("query") ||
-        func.annotations.includes("composite_query"));
-}
-const jsonToString = (json, space = 2) => {
-    return JSON.stringify(json, (_, value) => (typeof value === "bigint" ? `BigInt(${value})` : value), space);
-};
-exports.jsonToString = jsonToString;
-const generateRequestHash = (args = []) => {
-    const serializedArgs = (0, hash_1.createSimpleHash)(args);
-    return `0x${serializedArgs}`;
-};
-exports.generateRequestHash = generateRequestHash;
-const generateHash = (field) => {
-    const serializedArgs = JSON.stringify(field);
-    return (0, exports.stringToHash)(serializedArgs ?? "");
-};
-exports.generateHash = generateHash;
-const generateActorHash = (actor) => {
-    const serializedArgs = JSON.stringify(actor);
-    return (0, exports.stringToHash)(serializedArgs ?? "");
-};
-exports.generateActorHash = generateActorHash;
-const stringToHash = (str) => {
-    const hashBytes = (0, sha2_1.sha256)(str);
-    return `0x${(0, utils_1.bytesToHex)(hashBytes)}`;
-};
-exports.stringToHash = stringToHash;
-/**
- * Helper function for extracting the value from a compiled result { Ok: T } or { Err: E }
+ * Helper function for extracting the value from a compiled result { Ok: T } or throw a CanisterError if { Err: E }
+ * Supports both uppercase (Ok/Err - Rust) and lowercase (ok/err - Motoko) conventions.
  *
  * @param result - The compiled result to extract from.
- * @returns A `CompiledResult` object indicating success or failure.
+ * @returns The extracted value from the compiled result.
+ * @throws CanisterError with the typed error value if result is { Err: E } or { err: E }
  */
-function createCompiledResult(result) {
-    if (result && typeof result === "object" && "Ok" in result) {
-        return {
-            isOk: true,
-            isErr: false,
-            value: result.Ok,
-            error: null,
-        };
+export function extractOkResult(result) {
+    if (!result || typeof result !== "object") {
+        // Non-object, return as-is
+        return result;
     }
-    else if (result && typeof result === "object" && "Err" in result) {
-        return {
-            isOk: false,
-            isErr: true,
-            value: null,
-            error: result.Err,
-        };
+    // Handle { Ok: T } (Rust convention)
+    if ("Ok" in result) {
+        return result.Ok;
     }
-    else if (result) {
-        // For non-Result types
-        return {
-            isOk: true,
-            isErr: false,
-            value: result,
-            error: null,
-        };
+    // Handle { ok: T } (Motoko convention)
+    if ("ok" in result) {
+        return result.ok;
     }
-    else {
-        // For non-Result types
-        return {
-            isOk: false,
-            isErr: false,
-            value: undefined,
-            error: null,
-        };
+    // Handle { Err: E } (Rust convention) - throw CanisterError
+    if ("Err" in result) {
+        throw new CanisterError(result.Err);
+    }
+    // Handle { err: E } (Motoko convention) - throw CanisterError
+    if ("err" in result) {
+        throw new CanisterError(result.err);
     }
+    // Non-Result type, return as-is
+    return result;
 }
+export const isNullish = (value) => value === null || value === undefined;
+export const nonNullish = (value) => value !== null && value !== undefined;
+export const uint8ArrayToHex = (bytes) => {
+    const hex = Array.from(bytes)
+        .map((b) => b.toString(16).padStart(2, "0"))
+        .join("");
+    return `0x${hex}`;
+};
+export const hexToUint8Array = (hex) => {
+    if (hex.startsWith("0x")) {
+        hex = hex.slice(2);
+    }
+    return new Uint8Array(hex.match(/.{1,2}/g)?.map((byte) => parseInt(byte, 16)) || []);
+};
 /**
- * Helper function for extracting the value from a compiled result { Ok: T } or throw the error if { Err: E }
- *
- * @param result - The compiled result to extract from.
- * @returns The extracted value from the compiled result.
- * @throws The error from the compiled result.
+ * Converts a JSON-serializable value to a string, handling BigInt values.
+ * @param value - The value to convert
+ * @returns A string representation of the value
  */
-function extractOkResult(result) {
-    const compiledResult = createCompiledResult(result);
-    if (compiledResult.isErr) {
-        throw compiledResult.error;
-    }
-    return compiledResult.value;
-}
+export const jsonToString = (value) => {
+    return JSON.stringify(value, (_, v) => (typeof v === "bigint" ? v.toString() : v), 2);
+};
+//# sourceMappingURL=helper.js.map

package/dist/utils/helper.js.map

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

package/dist/utils/index.d.ts

@@ -1,6 +1,5 @@
-export * from "./helper";
+export * from "./candid";
 export * from "./constants";
-export * from "./hash";
-export * as candid from "./candid";
-export * as principal from "./principal";
-export * as agent from "./agent";
+export * from "./helper";
+export * from "./polling";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA"}

package/dist/utils/index.js

@@ -1,49 +1,5 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.agent = exports.principal = exports.candid = void 0;
-__exportStar(require("./helper"), exports);
-__exportStar(require("./constants"), exports);
-__exportStar(require("./hash"), exports);
-// Re-export the peerDependencies
-/// https://agent-js.icp.xyz/candid
-exports.candid = __importStar(require("./candid"));
-/// https://agent-js.icp.xyz/principal
-exports.principal = __importStar(require("./principal"));
-/// https://agent-js.icp.xyz/agent
-exports.agent = __importStar(require("./agent"));
+export * from "./candid";
+export * from "./constants";
+export * from "./helper";
+export * from "./polling";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA"}

package/dist/utils/polling.d.ts

@@ -0,0 +1,176 @@
+/**
+ * @module polling
+ * @description
+ * Polling strategy for Internet Computer (Dfinity) agent update calls.
+ *
+ * This module provides a configurable, intelligent polling mechanism that:
+ * - Starts with rapid polling for quick responses (fast phase)
+ * - Gradually increases delay intervals (ramp phase)
+ * - Settles into steady-state polling (plateau phase)
+ * - Adds jitter to prevent thundering herd problems
+ * - Provides structured logging with elapsed time and status
+ * - Supports graceful cancellation via AbortSignal
+ *
+ * @example
+ * ```typescript
+ * const strategy = createPollingStrategy({
+ *   context: "signer-creation",
+ *   fastAttempts: 10,
+ *   plateauDelayMs: 5000
+ * });
+ *
+ * const result = await actor.createSigner(params, {
+ *   pollingOptions: { strategy }
+ * });
+ * ```
+ */
+import { PollStrategy } from "@icp-sdk/core/agent";
+export interface PollingConfig {
+    /**
+     * Logical operation name used in log messages for identifying the polling context.
+     *
+     * Used to distinguish between different polling operations in console output.
+     * Choose descriptive names that help with debugging and monitoring.
+     *
+     * @default "operation"
+     * @example "sign-transaction", "document-upload"
+     */
+    context?: string;
+    /**
+     * Custom prefix prepended to all log messages from this polling strategy.
+     *
+     * Allows filtering and identifying logs specific to this polling instance.
+     * Useful when running multiple polling operations concurrently.
+     *
+     * @default "[Polling]"
+     * @example "[PaymentPolling]", "[TransactionPolling]", "[SignerPolling]"
+     */
+    logPrefix?: string;
+    /**
+     * Number of initial rapid polling attempts before transitioning to ramp phase.
+     *
+     * During fast phase, polls occur at `fastDelayMs` intervals (plus jitter).
+     * Higher values = more aggressive initial polling for fast responses.
+     * Lower values = faster transition to exponential backoff.
+     *
+     * @default 10
+     * @example 5 (for slower operations), 15 (for very fast operations)
+     */
+    fastAttempts?: number;
+    /**
+     * Base delay in milliseconds between polls during the fast phase.
+     *
+     * This is the baseline interval before jitter is applied.
+     * Actual delay will vary by ±`jitterRatio` percentage.
+     * Lower values = more aggressive polling, higher network load.
+     *
+     * @default 100
+     * @example 50 (aggressive), 200 (conservative)
+     */
+    fastDelayMs?: number;
+    /**
+     * Duration threshold in milliseconds for the ramp phase.
+     *
+     * While elapsed time < rampUntilMs, delay grows exponentially from
+     * `fastDelayMs` up to `plateauDelayMs` using a power curve (0.7 exponent).
+     * After this duration, polling enters plateau phase with constant delays.
+     *
+     * @default 20000 (20 seconds)
+     * @example 10_000 (faster transition), 30_000 (longer ramp for slow ops)
+     */
+    rampUntilMs?: number;
+    /**
+     * Steady-state polling delay in milliseconds during plateau phase.
+     *
+     * Once ramp phase completes, all subsequent polls use this interval (plus jitter).
+     * This is the "cruise speed" for long-running operations.
+     * Balance between responsiveness and network/resource efficiency.
+     *
+     * @default 5000 (5 seconds)
+     * @example 2_000 (more responsive), 10_000 (more efficient)
+     */
+    plateauDelayMs?: number;
+    /**
+     * Randomization ratio (0-1) for adding jitter to prevent thundering herd.
+     *
+     * Jitter adds ±(ratio * delay) randomness to each polling interval.
+     * Higher values = more randomization, better distribution across time.
+     * Lower values = more predictable intervals, less variance.
+     * Prevents synchronized polling when multiple clients start simultaneously.
+     *
+     * @default 0.4 (±40% randomization)
+     * @example 0.2 (±20%, less jitter), 0.5 (±50%, more jitter)
+     */
+    jitterRatio?: number;
+    /**
+     * Maximum time in milliseconds between log outputs (heartbeat interval).
+     *
+     * Forces a log message if this much time passes without logging,
+     * even if normal log throttling would suppress it.
+     * Prevents "silent" long-running operations; ensures monitoring visibility.
+     *
+     * @default 15000 (15 seconds)
+     * @example 10_000 (more frequent heartbeats), 30_000 (less verbose)
+     */
+    maxLogIntervalMs?: number;
+    /**
+     * External abort signal for graceful cancellation of polling operation.
+     *
+     * When the signal is aborted, the polling strategy throws an error
+     * on the next poll attempt. Use AbortController to create signals.
+     * Allows coordinated cancellation across multiple async operations.
+     *
+     * @default undefined (no external cancellation)
+     * @example
+     * ```typescript
+     * const controller = new AbortController();
+     * const strategy = createPollingStrategy({
+     *   abortSignal: controller.signal
+     * });
+     * // Later: controller.abort();
+     * ```
+     */
+    abortSignal?: AbortSignal;
+}
+/**
+ * Creates an polling strategy for Internet Computer agent update calls.
+ *
+ * The strategy implements three phases:
+ * 1. **Fast Phase**: Initial rapid polling (default: 10 attempts @ 100ms intervals)
+ * 2. **Ramp Phase**: Exponential backoff growth (default: up to 20s elapsed)
+ * 3. **Plateau Phase**: Steady-state polling (default: 5s intervals)
+ *
+ * The strategy continues polling while request status is RECEIVED/PROCESSING,
+ * and only terminates on REPLIED/REJECTED/DONE status or when aborted.
+ *
+ * @param {PollingConfig} [cfg={}] - Configuration options
+ * @returns {PollStrategy} - Async strategy function compatible with agent pollingOptions.strategy
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const strategy = createPollingStrategy();
+ *
+ * // Custom configuration for long-running operations
+ * const strategy = createPollingStrategy({
+ *   context: "blockchain-sync",
+ *   fastAttempts: 5,
+ *   fastDelayMs: 200,
+ *   rampUntilMs: 30_000,
+ *   plateauDelayMs: 10_000,
+ *   jitterRatio: 0.3
+ * });
+ *
+ * // With abort signal
+ * const controller = new AbortController();
+ * const strategy = createPollingStrategy({
+ *   context: "transaction-signing",
+ *   abortSignal: controller.signal
+ * });
+ * // Later: controller.abort();
+ * ```
+ *
+ * @throws {Error} When abortSignal is triggered during polling
+ */
+export declare function createPollingStrategy(cfg?: PollingConfig): PollStrategy;
+//# sourceMappingURL=polling.d.ts.map

package/dist/utils/polling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.d.ts","sourceRoot":"","sources":["../../src/utils/polling.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EACL,YAAY,EAGb,MAAM,qBAAqB,CAAA;AAG5B,MAAM,WAAW,aAAa;IAC5B;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAEzB;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,aAAkB,GAAG,YAAY,CA2I3E"}