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

package/dist/types/transform.d.ts

@@ -0,0 +1,7 @@
+type UnionToIntersection<U> = (U extends any ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
+type Last<T> = UnionToIntersection<T extends any ? (x: T) => void : never> extends (x: infer L) => void ? L : never;
+export type UnionToTuple<T, L = Last<T>> = [T] extends [never] ? [] : [...UnionToTuple<Exclude<T, L>>, L];
+export type IsBlobType<T> = T extends Uint8Array | number[] ? true : false;
+export type IsOptionalType<T> = [T] extends [[] | [any]] ? true : false;
+export {};
+//# sourceMappingURL=transform.d.ts.map

package/dist/types/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/types/transform.ts"],"names":[],"mappings":"AAAA,KAAK,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,KAAK,CAAC,SAAS,CAC7E,CAAC,EAAE,MAAM,CAAC,KACP,IAAI,GACL,CAAC,GACD,KAAK,CAAA;AAGT,KAAK,IAAI,CAAC,CAAC,IACT,mBAAmB,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,KAAK,CAAC,SAAS,CAClE,CAAC,EAAE,MAAM,CAAC,KACP,IAAI,GACL,CAAC,GACD,KAAK,CAAA;AAIX,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAC1D,EAAE,GACF,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAEvC,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,UAAU,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,KAAK,CAAA;AAE1E,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK,CAAA"}

package/dist/types/transform.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transform.js.map

package/dist/types/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../src/types/transform.ts"],"names":[],"mappings":""}

package/dist/types/variant.d.ts

@@ -0,0 +1,18 @@
+export type IsCandidVariant<T> = [T] extends [CandidVariantToIntersection<T>] ? false : true;
+export type CandidVariantToIntersection<U> = (U extends object ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+export type CandidVariantKey<T> = T extends any ? keyof T : never;
+export type CandidVariantValue<T, K extends CandidVariantKey<T>> = T extends Record<K, infer U> ? U : never;
+export type CandidVariant<T> = IsCandidVariant<T> extends true ? {
+    _type: CandidVariantKey<T> & string;
+} & {
+    [K in CandidVariantKey<T> & string as CandidVariantValue<T, K> extends null ? never : K]: CandidVariantValue<T, K>;
+} : T;
+/**
+ * A type that represents the extracted key and value from a variant
+ * Designed to be used with the extractVariant function
+ */
+export type CandidKeyValue<T> = T extends infer U ? [
+    CandidVariantKey<U> & string,
+    CandidVariantValue<U, CandidVariantKey<U> & string>
+] : never;
+//# sourceMappingURL=variant.d.ts.map

package/dist/types/variant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variant.d.ts","sourceRoot":"","sources":["../../src/types/variant.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,GACzE,KAAK,GACL,IAAI,CAAA;AAER,MAAM,MAAM,2BAA2B,CAAC,CAAC,IAAI,CAC3C,CAAC,SAAS,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,KAAK,CAC1C,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,IAAI,GAC1B,CAAC,GACD,KAAK,CAAA;AAET,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,GAAG,MAAM,CAAC,GAAG,KAAK,CAAA;AAEjE,MAAM,MAAM,kBAAkB,CAAC,CAAC,EAAE,CAAC,SAAS,gBAAgB,CAAC,CAAC,CAAC,IAC7D,CAAC,SAAS,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;AAE1C,MAAM,MAAM,aAAa,CAAC,CAAC,IACzB,eAAe,CAAC,CAAC,CAAC,SAAS,IAAI,GAC3B;IACE,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM,CAAA;CACpC,GAAG;KACD,CAAC,IAAI,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,kBAAkB,CACtD,CAAC,EACD,CAAC,CACF,SAAS,IAAI,GACV,KAAK,GACL,CAAC,GAAG,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC;CACjC,GACD,CAAC,CAAA;AAEP;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,GAC7C;IACE,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM;IAC5B,kBAAkB,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;CACpD,GACD,KAAK,CAAA"}

package/dist/types/variant.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=variant.js.map

package/dist/types/variant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variant.js","sourceRoot":"","sources":["../../src/types/variant.ts"],"names":[],"mappings":""}

package/dist/utils/agent.d.ts

@@ -1 +1,30 @@
-export * from "@dfinity/agent";
+import type { ApiQueryResponse, HttpAgent, PollingOptions, SubmitResponse } from "@icp-sdk/core/agent";
+import { Principal } from "@icp-sdk/core/principal";
+/**
+ * Process a query call response following the exact logic from @icp-sdk/core/agent Actor.
+ *
+ * @param response - The query call response options
+ * @returns The raw reply bytes
+ * @throws CallError if the query was rejected
+ */
+export declare function processQueryCallResponse(response: ApiQueryResponse, canisterId: Principal, methodName: string): Uint8Array;
+/**
+ * Process an update call response following the exact logic from @icp-sdk/core/agent Actor.
+ *
+ * This handles:
+ * - V4 responses with embedded certificate (sync call response)
+ * - V2 responses with immediate rejection
+ * - 202 responses that require polling
+ *
+ * @param result - The submit response from agent.call()
+ * @param canisterId - The target canister ID
+ * @param methodName - The method name being called
+ * @param agent - The HTTP agent
+ * @param pollingOptions - Options for polling
+ * @param blsVerify - Optional BLS verification function
+ * @returns The raw reply bytes
+ * @throws RejectError if the call was rejected
+ * @throws UnknownError if the response format is unexpected
+ */
+export declare function processUpdateCallResponse(result: SubmitResponse, canisterId: Principal, methodName: string, agent: HttpAgent, pollingOptions: PollingOptions): Promise<Uint8Array>;
+//# sourceMappingURL=agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/utils/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,SAAS,EAET,cAAc,EACd,cAAc,EACf,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAuBnD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,gBAAgB,EAC1B,UAAU,EAAE,SAAS,EACrB,UAAU,EAAE,MAAM,GACjB,UAAU,CAqBZ;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,SAAS,EACrB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS,EAChB,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,UAAU,CAAC,CA4GrB"}

package/dist/utils/agent.js

@@ -1,17 +1,119 @@
-"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]; } };
+import { isV2ResponseBody, isV4ResponseBody, Certificate, lookupResultToBuffer, pollForResponse, QueryResponseStatus, UncertifiedRejectErrorCode, RejectError, UncertifiedRejectUpdateErrorCode, CertifiedRejectErrorCode, MissingRootKeyErrorCode, ExternalError, UnknownError, UnexpectedErrorCode, } from "@icp-sdk/core/agent";
+// ══════════════════════════════════════════════════════════════════════
+// QUERY CALL RESPONSE PROCESSING
+// ══════════════════════════════════════════════════════════════════════
+/**
+ * Process a query call response following the exact logic from @icp-sdk/core/agent Actor.
+ *
+ * @param response - The query call response options
+ * @returns The raw reply bytes
+ * @throws CallError if the query was rejected
+ */
+export function processQueryCallResponse(response, canisterId, methodName) {
+    switch (response.status) {
+        case QueryResponseStatus.Rejected: {
+            const uncertifiedRejectErrorCode = new UncertifiedRejectErrorCode(response.requestId, response.reject_code, response.reject_message, response.error_code, response.signatures);
+            uncertifiedRejectErrorCode.callContext = {
+                canisterId,
+                methodName,
+                httpDetails: response.httpDetails,
+            };
+            throw RejectError.fromCode(uncertifiedRejectErrorCode);
+        }
+        case QueryResponseStatus.Replied:
+            return response.reply.arg;
     }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-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);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("@dfinity/agent"), exports);
+}
+// ══════════════════════════════════════════════════════════════════════
+// UPDATE CALL RESPONSE PROCESSING
+// ══════════════════════════════════════════════════════════════════════
+/**
+ * Process an update call response following the exact logic from @icp-sdk/core/agent Actor.
+ *
+ * This handles:
+ * - V4 responses with embedded certificate (sync call response)
+ * - V2 responses with immediate rejection
+ * - 202 responses that require polling
+ *
+ * @param result - The submit response from agent.call()
+ * @param canisterId - The target canister ID
+ * @param methodName - The method name being called
+ * @param agent - The HTTP agent
+ * @param pollingOptions - Options for polling
+ * @param blsVerify - Optional BLS verification function
+ * @returns The raw reply bytes
+ * @throws RejectError if the call was rejected
+ * @throws UnknownError if the response format is unexpected
+ */
+export async function processUpdateCallResponse(result, canisterId, methodName, agent, pollingOptions) {
+    let reply;
+    let certificate;
+    if (isV4ResponseBody(result.response.body)) {
+        if (agent.rootKey == null) {
+            throw ExternalError.fromCode(new MissingRootKeyErrorCode());
+        }
+        const cert = result.response.body.certificate;
+        certificate = await Certificate.create({
+            certificate: cert,
+            rootKey: agent.rootKey,
+            principal: { canisterId },
+            agent,
+        });
+        const path = [new TextEncoder().encode("request_status"), result.requestId];
+        const status = new TextDecoder().decode(lookupResultToBuffer(certificate.lookup_path([...path, "status"])));
+        switch (status) {
+            case "replied":
+                reply = lookupResultToBuffer(certificate.lookup_path([...path, "reply"]));
+                break;
+            case "rejected": {
+                // Find rejection details in the certificate
+                const rejectCode = new Uint8Array(lookupResultToBuffer(certificate.lookup_path([...path, "reject_code"])))[0];
+                const rejectMessage = new TextDecoder().decode(lookupResultToBuffer(certificate.lookup_path([...path, "reject_message"])));
+                const error_code_buf = lookupResultToBuffer(certificate.lookup_path([...path, "error_code"]));
+                const error_code = error_code_buf
+                    ? new TextDecoder().decode(error_code_buf)
+                    : undefined;
+                const certifiedRejectErrorCode = new CertifiedRejectErrorCode(result.requestId, rejectCode, rejectMessage, error_code);
+                certifiedRejectErrorCode.callContext = {
+                    canisterId,
+                    methodName,
+                    httpDetails: result.response,
+                };
+                throw RejectError.fromCode(certifiedRejectErrorCode);
+            }
+        }
+    }
+    else if (isV2ResponseBody(result.response.body)) {
+        const { reject_code, reject_message, error_code } = result.response.body;
+        const errorCode = new UncertifiedRejectUpdateErrorCode(result.requestId, reject_code, reject_message, error_code);
+        errorCode.callContext = {
+            canisterId,
+            methodName,
+            httpDetails: result.response,
+        };
+        throw RejectError.fromCode(errorCode);
+    }
+    // Fall back to polling if we receive an Accepted response code
+    if (result.response.status === 202) {
+        // Contains the certificate and the reply from the boundary node
+        const response = await pollForResponse(agent, canisterId, result.requestId, pollingOptions);
+        certificate = response.certificate;
+        reply = response.reply;
+    }
+    if (reply !== undefined) {
+        return reply;
+    }
+    // Unexpected response format
+    const httpDetails = {
+        ...result.response,
+        requestDetails: result.requestDetails,
+    };
+    const errorCode = new UnexpectedErrorCode(`Call was returned undefined. We cannot determine if the call was successful or not.`);
+    errorCode.callContext = {
+        canisterId,
+        methodName,
+        httpDetails,
+    };
+    throw UnknownError.fromCode(errorCode);
+}
+//# sourceMappingURL=agent.js.map

package/dist/utils/agent.js.map

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

package/dist/utils/candid.d.ts

@@ -1 +1,39 @@
-export * from "@dfinity/candid";
+import { CandidVariant, CandidVariantKey, CandidVariantValue, CandidKeyValue } from "../types";
+/**
+ * Creates a Candid variant from a string value.
+ * @param str - The string to convert into a variant
+ * @returns An object representing the Candid variant
+ */
+export declare function createNullVariant<T extends string>(str: T): Record<T, null>;
+/**
+ * Creates a Candid variant from a record.
+ * @param variant - The record to convert into a variant
+ * @returns An object representing the Candid variant
+ */
+export declare function createVariant<T extends Record<string, any>>(variant: T): CandidVariant<T>;
+/**
+ * Extract variant key and value from a variant type
+ * Works with types like:
+ * type User = { 'Business': BusinessUser } | { 'Individual': IndividualUser }
+ *
+ * @template T - The variant type
+ * @returns A tuple containing the key and value of the variant
+ * @throws Error if the variant object does not have exactly one key
+ */
+export declare function getVariantKeyValue<T extends Record<string, any>>(variant: T): CandidKeyValue<T>;
+/**
+ * Extracts the key from a Candid variant type.
+ * Variants in Candid are represented as objects with a single key-value pair.
+ * @param variant - The variant object
+ * @returns The key of the variant
+ */
+export declare function getVariantKey<T extends Record<string, any>>(variant: T): CandidVariantKey<T>;
+/**
+ * Extracts the value from a Candid variant type.
+ * @param variant - The variant object
+ * @returns The value associated with the variant's key
+ */
+export declare function getVariantValue<T extends Record<string, any>, K extends CandidVariantKey<T> = CandidVariantKey<T>>(variant: T): CandidVariantValue<T, K>;
+export declare function getVariantValueByKey<T extends Record<string, any>, K extends CandidVariantKey<T>>(variant: T, key: K): CandidVariantValue<T, K>;
+export declare function isKeyMatchVariant<T extends Record<string, any>, K extends CandidVariantKey<T>>(variant: T, key: K): variant is T & Record<K, unknown>;
+//# sourceMappingURL=candid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"candid.d.ts","sourceRoot":"","sources":["../../src/utils/candid.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACf,MAAM,UAAU,CAAA;AAEjB;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzD,OAAO,EAAE,CAAC,GACT,aAAa,CAAC,CAAC,CAAC,CAgBlB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9D,OAAO,EAAE,CAAC,GACT,cAAc,CAAC,CAAC,CAAC,CAUnB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzD,OAAO,EAAE,CAAC,GACT,gBAAgB,CAAC,CAAC,CAAC,CAQrB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,CAAC,SAAS,gBAAgB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,EACnD,OAAO,EAAE,CAAC,GAAG,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAEtC;AAED,wBAAgB,oBAAoB,CAClC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,CAAC,SAAS,gBAAgB,CAAC,CAAC,CAAC,EAC7B,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAO9C;AAED,wBAAgB,iBAAiB,CAC/B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,CAAC,SAAS,gBAAgB,CAAC,CAAC,CAAC,EAC7B,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAEvD"}

package/dist/utils/candid.js

@@ -1,17 +1,77 @@
-"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]; } };
+/**
+ * Creates a Candid variant from a string value.
+ * @param str - The string to convert into a variant
+ * @returns An object representing the Candid variant
+ */
+export function createNullVariant(str) {
+    return { [str]: null };
+}
+/**
+ * Creates a Candid variant from a record.
+ * @param variant - The record to convert into a variant
+ * @returns An object representing the Candid variant
+ */
+export function createVariant(variant) {
+    const keys = Object.keys(variant);
+    if (keys.length !== 1) {
+        throw new Error(`
+      Invalid variant: must have exactly one key but found ${keys.length} keys: ${keys.map((key) => `${key}: ${variant[key]}`)}
+    `);
     }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-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);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("@dfinity/candid"), exports);
+    const key = keys[0];
+    const value = variant[key];
+    return {
+        _type: key,
+        ...(value !== null ? { [key]: value } : {}),
+    };
+}
+/**
+ * Extract variant key and value from a variant type
+ * Works with types like:
+ * type User = { 'Business': BusinessUser } | { 'Individual': IndividualUser }
+ *
+ * @template T - The variant type
+ * @returns A tuple containing the key and value of the variant
+ * @throws Error if the variant object does not have exactly one key
+ */
+export function getVariantKeyValue(variant) {
+    const keys = Object.keys(variant);
+    if (keys.length !== 1) {
+        const msg = `Invalid variant: must have exactly one key but found ${keys.length} keys: ${keys}`;
+        throw new Error(msg);
+    }
+    const key = keys[0];
+    const value = variant[key];
+    return [key, value];
+}
+/**
+ * Extracts the key from a Candid variant type.
+ * Variants in Candid are represented as objects with a single key-value pair.
+ * @param variant - The variant object
+ * @returns The key of the variant
+ */
+export function getVariantKey(variant) {
+    const keys = Object.keys(variant);
+    if (keys.length !== 1) {
+        throw new Error(`Invalid variant: must have exactly one key but found ${keys}`);
+    }
+    return keys[0];
+}
+/**
+ * Extracts the value from a Candid variant type.
+ * @param variant - The variant object
+ * @returns The value associated with the variant's key
+ */
+export function getVariantValue(variant) {
+    return variant[getVariantKey(variant)];
+}
+export function getVariantValueByKey(variant, key) {
+    if (getVariantKey(variant) !== key) {
+        throw new Error(`Variant key mismatch: expected ${key}, got ${getVariantKey(variant)}`);
+    }
+    return variant[key];
+}
+export function isKeyMatchVariant(variant, key) {
+    return getVariantKey(variant) === key;
+}
+//# sourceMappingURL=candid.js.map

package/dist/utils/candid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candid.js","sourceRoot":"","sources":["../../src/utils/candid.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAmB,GAAM;IACxD,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAqB,CAAA;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAU;IAEV,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC;6DACyC,IAAI,CAAC,MAAM,UAAU,IAAI,CAAC,GAAG,CAClF,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE,CACnC;KACF,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAY,CAAA;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IAE1B,OAAO;QACL,KAAK,EAAE,GAAG;QACV,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxB,CAAA;AACvB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAU;IAEV,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,wDAAwD,IAAI,CAAC,MAAM,UAAU,IAAI,EAAE,CAAA;QAC/F,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAA;IACtB,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAyB,CAAA;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAyB,CAAA;IAElD,OAAO,CAAC,GAAG,EAAE,KAAK,CAAsB,CAAA;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAU;IAEV,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,wDAAwD,IAAI,EAAE,CAC/D,CAAA;IACH,CAAC;IACD,OAAO,IAAI,CAAC,CAAC,CAAwB,CAAA;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAG7B,OAAU;IACV,OAAO,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAA;AACxC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAGlC,OAAU,EAAE,GAAM;IAClB,IAAI,aAAa,CAAC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,kCAAkC,GAAG,SAAS,aAAa,CAAC,OAAO,CAAC,EAAE,CACvE,CAAA;IACH,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAA;AACrB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAG/B,OAAU,EAAE,GAAM;IAClB,OAAO,aAAa,CAAC,OAAO,CAAC,KAAK,GAAG,CAAA;AACvC,CAAC"}

package/dist/utils/constants.d.ts

@@ -2,7 +2,6 @@ export declare const REMOTE_HOSTS: string[];
 export declare const LOCAL_HOSTS: string[];
 export declare const IC_HOST_NETWORK_URI = "https://ic0.app";
 export declare const LOCAL_HOST_NETWORK_URI = "http://127.0.0.1:4943";
-export declare const DEFAULT_LOCAL_DIDJS_ID = "bd3sg-teaaa-aaaaa-qaaba-cai";
-export declare const DEFAULT_IC_DIDJS_ID = "a4gq6-oaaaa-aaaab-qaa4q-cai";
-export declare const IC_INTERNET_IDENTITY_PROVIDER = "https://identity.ic0.app/#authorize";
-export declare const LOCAL_INTERNET_IDENTITY_PROVIDER = "http://rdmx6-jaaaa-aaaaa-aaadq-cai.localhost:4943/#authorize";
+export declare const IC_INTERNET_IDENTITY_PROVIDER = "https://identity.ic0.app";
+export declare const LOCAL_INTERNET_IDENTITY_PROVIDER = "http://rdmx6-jaaaa-aaaaa-aaadq-cai.localhost:4943";
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,UAAgC,CAAA;AAEzD,eAAO,MAAM,WAAW,UAA6B,CAAA;AAErD,eAAO,MAAM,mBAAmB,oBAAoB,CAAA;AAEpD,eAAO,MAAM,sBAAsB,0BAA0B,CAAA;AAE7D,eAAO,MAAM,6BAA6B,6BAA6B,CAAA;AAEvE,eAAO,MAAM,gCAAgC,sDACQ,CAAA"}

package/dist/utils/constants.js

@@ -1,11 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LOCAL_INTERNET_IDENTITY_PROVIDER = exports.IC_INTERNET_IDENTITY_PROVIDER = exports.DEFAULT_IC_DIDJS_ID = exports.DEFAULT_LOCAL_DIDJS_ID = exports.LOCAL_HOST_NETWORK_URI = exports.IC_HOST_NETWORK_URI = exports.LOCAL_HOSTS = exports.REMOTE_HOSTS = void 0;
-exports.REMOTE_HOSTS = [".github.dev", ".gitpod.io"];
-exports.LOCAL_HOSTS = ["localhost", "127.0.0.1"];
-exports.IC_HOST_NETWORK_URI = "https://ic0.app";
-exports.LOCAL_HOST_NETWORK_URI = "http://127.0.0.1:4943";
-exports.DEFAULT_LOCAL_DIDJS_ID = "bd3sg-teaaa-aaaaa-qaaba-cai";
-exports.DEFAULT_IC_DIDJS_ID = "a4gq6-oaaaa-aaaab-qaa4q-cai";
-exports.IC_INTERNET_IDENTITY_PROVIDER = "https://identity.ic0.app/#authorize";
-exports.LOCAL_INTERNET_IDENTITY_PROVIDER = "http://rdmx6-jaaaa-aaaaa-aaadq-cai.localhost:4943/#authorize";
+export const REMOTE_HOSTS = [".github.dev", ".gitpod.io"];
+export const LOCAL_HOSTS = ["localhost", "127.0.0.1"];
+export const IC_HOST_NETWORK_URI = "https://ic0.app";
+export const LOCAL_HOST_NETWORK_URI = "http://127.0.0.1:4943";
+export const IC_INTERNET_IDENTITY_PROVIDER = "https://identity.ic0.app";
+export const LOCAL_INTERNET_IDENTITY_PROVIDER = "http://rdmx6-jaaaa-aaaaa-aaadq-cai.localhost:4943";
+//# sourceMappingURL=constants.js.map

package/dist/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,aAAa,EAAE,YAAY,CAAC,CAAA;AAEzD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC,CAAA;AAErD,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAA;AAEpD,MAAM,CAAC,MAAM,sBAAsB,GAAG,uBAAuB,CAAA;AAE7D,MAAM,CAAC,MAAM,6BAA6B,GAAG,0BAA0B,CAAA;AAEvE,MAAM,CAAC,MAAM,gCAAgC,GAC3C,mDAAmD,CAAA"}

package/dist/utils/helper.d.ts

@@ -1,21 +1,5 @@
-import { DevtoolsOptions } from "zustand/middleware";
-import type { CompiledResult, BaseActor, CandidDefenition, IDL, ExtractOk, StoreWithAllMiddleware } from "../types";
-/**
- * No operation function that does nothing.
- * It can be used as a placeholder or for logging purposes.
- */
-export declare function noop(): void;
-/**
- * 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.
- */
-export declare function createStoreWithOptionalDevtools<T extends object>(initialState: T, config: DevtoolsOptions & {
-    withDevtools?: boolean;
-}): StoreWithAllMiddleware<T>;
-export declare const importCandidDefinition: (candidDef: string) => Promise<CandidDefenition>;
+import { OkResult } from "../types";
+export declare const generateKey: (args: any[]) => string;
 /**
  * Checks if the current environment is local or development.
  *
@@ -36,29 +20,22 @@ export declare const getProcessEnvNetwork: () => string;
  */
 export declare function getNetworkByHostname(hostname: string): "local" | "remote" | "ic";
 /**
- * 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`.
- */
-export declare function isQuery(func: IDL.FuncClass): boolean;
-export declare const jsonToString: (json: unknown, space?: number) => string;
-export declare const generateRequestHash: (args?: unknown[]) => `0x${string}`;
-export declare const generateHash: (field?: unknown) => `0x${string}`;
-export declare const generateActorHash: (actor: BaseActor) => `0x${string}`;
-export declare const stringToHash: (str: string) => `0x${string}`;
-/**
- * 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 }
  */
-export declare function createCompiledResult<T>(result: T): CompiledResult<T>;
+export declare function extractOkResult<T>(result: T): OkResult<T>;
+export declare const isNullish: (value: unknown) => value is null | undefined;
+export declare const nonNullish: <T>(value: T | null | undefined) => value is T;
+export declare const uint8ArrayToHex: (bytes: Uint8Array | number[]) => `0x${string}`;
+export declare const hexToUint8Array: (hex: string) => Uint8Array<ArrayBuffer>;
 /**
- * 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
  */
-export declare function extractOkResult<T>(result: T): ExtractOk<T>;
+export declare const jsonToString: (value: any) => string;
+//# sourceMappingURL=helper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../src/utils/helper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAEnC,eAAO,MAAM,WAAW,GAAI,MAAM,GAAG,EAAE,WAItC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,eAElC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,cAGhC,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,GACf,OAAO,GAAG,QAAQ,GAAG,IAAI,CAQ3B;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CA0BzD;AAED,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,IAAI,GAAG,SACpB,CAAA;AAEvC,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,KAAG,KAAK,IAAI,CAC9B,CAAA;AAEvC,eAAO,MAAM,eAAe,GAC1B,OAAO,UAAU,GAAG,MAAM,EAAE,KAC3B,KAAK,MAAM,EAKb,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,KAAG,UAAU,CAAC,WAAW,CAOnE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,GAAG,KAAG,MAMzC,CAAA"}