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

package/dist/classes/types.js

@@ -1,20 +0,0 @@
-"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 __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 });
-// Re-export existing types
-__exportStar(require("./agent/types"), exports);
-__exportStar(require("./actor/types"), exports);
-__exportStar(require("./adapter/types"), exports);

package/dist/createActorManager.d.ts

@@ -1,12 +0,0 @@
-import { ActorManager } from "./classes/actor";
-import type { ActorManagerParameters, BaseActor } from "./types";
-/**
- * Actor manager handles the lifecycle of the actors.
- * It is responsible for creating and managing the actors.
- * You can use it to call and visit the actor's methods.
- * It also provides a way to interact with the actor's state.
- *
- * @category Main
- * @includeExample ./packages/core/README.md:268-283
- */
-export declare const createActorManager: <A = BaseActor>(config: ActorManagerParameters) => ActorManager<A>;

package/dist/createActorManager.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createActorManager = void 0;
-const actor_1 = require("./classes/actor");
-/**
- * Actor manager handles the lifecycle of the actors.
- * It is responsible for creating and managing the actors.
- * You can use it to call and visit the actor's methods.
- * It also provides a way to interact with the actor's state.
- *
- * @category Main
- * @includeExample ./packages/core/README.md:268-283
- */
-const createActorManager = (config) => {
-    return new actor_1.ActorManager(config);
-};
-exports.createActorManager = createActorManager;

package/dist/createAgentManager.d.ts

@@ -1,12 +0,0 @@
-import { AgentManager } from "./classes/agent";
-import type { AgentManagerParameters } from "./types";
-/**
- * Agent manager handles the lifecycle of the `@dfinity/agent`.
- * It is responsible for creating agent and managing the agent's state.
- * You can use it to subscribe to the agent changes.
- * login and logout to the internet identity.
- *
- * @category Main
- * @includeExample ./packages/core/README.md:232-260
- */
-export declare const createAgentManager: (config?: AgentManagerParameters) => AgentManager;

package/dist/createAgentManager.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createAgentManager = void 0;
-const agent_1 = require("./classes/agent");
-/**
- * Agent manager handles the lifecycle of the `@dfinity/agent`.
- * It is responsible for creating agent and managing the agent's state.
- * You can use it to subscribe to the agent changes.
- * login and logout to the internet identity.
- *
- * @category Main
- * @includeExample ./packages/core/README.md:232-260
- */
-const createAgentManager = (config) => {
-    return new agent_1.AgentManager(config);
-};
-exports.createAgentManager = createAgentManager;

package/dist/createCandidAdapter.d.ts

@@ -1,11 +0,0 @@
-import { CandidAdapter } from "./classes/adapter";
-import type { CandidAdapterParameters } from "./types";
-/**
- * The `CandidAdapter` class is used to interact with a canister and retrieve its Candid interface definition.
- * It provides methods to fetch the Candid definition either from the canister's metadata or by using a temporary hack method.
- * If both methods fail, it throws an error.
- *
- * @category Main
- * @includeExample ./packages/core/README.md:151-192
- */
-export declare const createCandidAdapter: (config: CandidAdapterParameters) => CandidAdapter;

package/dist/createCandidAdapter.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createCandidAdapter = void 0;
-const adapter_1 = require("./classes/adapter");
-/**
- * The `CandidAdapter` class is used to interact with a canister and retrieve its Candid interface definition.
- * It provides methods to fetch the Candid definition either from the canister's metadata or by using a temporary hack method.
- * If both methods fail, it throws an error.
- *
- * @category Main
- * @includeExample ./packages/core/README.md:151-192
- */
-const createCandidAdapter = (config) => {
-    return new adapter_1.CandidAdapter(config);
-};
-exports.createCandidAdapter = createCandidAdapter;

package/dist/createReactorCore.d.ts

@@ -1,10 +0,0 @@
-import type { BaseActor, CreateReactorCoreParameters, CreateReactorCoreReturnType } from "./types";
-/**
- * The Core module is the main entry point for the library.
- * Create a new actor manager with the given options.
- * Its create a new agent manager if not provided.
- *
- * @category Main
- * @includeExample ./packages/core/README.md:32-86
- */
-export declare const createReactorCore: <A = BaseActor>(config: CreateReactorCoreParameters) => CreateReactorCoreReturnType<A>;

package/dist/createReactorCore.js

@@ -1,112 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createReactorCore = void 0;
-const createReactorStore_1 = require("./createReactorStore");
-const utils_1 = require("./utils");
-/**
- * The Core module is the main entry point for the library.
- * Create a new actor manager with the given options.
- * Its create a new agent manager if not provided.
- *
- * @category Main
- * @includeExample ./packages/core/README.md:32-86
- */
-const createReactorCore = (config) => {
-    const { subscribeActorState, updateMethodState, callMethodWithOptions, callMethod, getState, agentManager, ...rest } = (0, createReactorStore_1.createReactorStore)(config);
-    const actorMethod = (functionName, args, options = {}) => {
-        const requestHash = (0, utils_1.generateRequestHash)(args);
-        const updateState = (newState = {}) => {
-            updateMethodState(functionName, requestHash, newState);
-        };
-        updateState();
-        try {
-            const methodState = ((key) => {
-                const state = getState().methodState[functionName][requestHash];
-                switch (key) {
-                    case "data":
-                        return state.data;
-                    case "loading":
-                        return state.loading;
-                    case "error":
-                        return state.error;
-                    default:
-                        return state;
-                }
-            });
-            const subscribe = (callback) => {
-                callback(methodState());
-                const unsubscribe = subscribeActorState((state) => {
-                    const methodState = state.methodState[functionName];
-                    const methodStateHash = methodState[requestHash];
-                    if (methodStateHash) {
-                        callback(methodStateHash);
-                    }
-                });
-                return unsubscribe;
-            };
-            const call = async (replaceArgs) => {
-                updateState({
-                    loading: true,
-                    error: undefined,
-                });
-                try {
-                    const data = await callMethodWithOptions(options)(functionName, ...(replaceArgs ?? args));
-                    updateState({ data, loading: false });
-                    return data;
-                }
-                catch (error) {
-                    updateState({
-                        error: error,
-                        loading: false,
-                    });
-                    throw error;
-                }
-            };
-            return {
-                requestHash,
-                subscribe,
-                getState: methodState,
-                call,
-            };
-        }
-        catch (error) {
-            updateState({
-                error: error,
-                loading: false,
-            });
-            throw error;
-        }
-    };
-    const queryCall = ({ functionName, args = [], refetchOnMount = true, refetchInterval = false, ...options }) => {
-        let intervalId = null;
-        const { call, ...rest } = actorMethod(functionName, args, options);
-        if (refetchInterval) {
-            intervalId = setInterval(() => {
-                call();
-            }, refetchInterval);
-        }
-        const clearRefetchInterval = () => {
-            if (intervalId) {
-                clearInterval(intervalId);
-            }
-        };
-        let dataPromise = Promise.resolve();
-        if (refetchOnMount)
-            dataPromise = call();
-        return { ...rest, call, dataPromise, intervalId, clearRefetchInterval };
-    };
-    const updateCall = ({ functionName, args = [], ...options }) => {
-        return actorMethod(functionName, args, options);
-    };
-    return {
-        getState,
-        queryCall,
-        updateCall,
-        callMethod,
-        callMethodWithOptions,
-        subscribeActorState,
-        ...agentManager,
-        ...rest,
-    };
-};
-exports.createReactorCore = createReactorCore;

package/dist/createReactorStore.d.ts

@@ -1,11 +0,0 @@
-import { ActorManager } from "./classes/actor";
-import type { BaseActor, CreateReactorStoreParameters } from "./types";
-/**
- * Create a new actor manager with the given options.
- * Its create a new agent manager if not provided.
- * It also creates a new actor manager with the given options.
- *
- * @category Main
- * @includeExample ./packages/core/README.md:200-225
- */
-export declare const createReactorStore: <A = BaseActor>(config: CreateReactorStoreParameters) => ActorManager<A>;

package/dist/createReactorStore.js

@@ -1,31 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createReactorStore = void 0;
-const createActorManager_1 = require("./createActorManager");
-const createAgentManager_1 = require("./createAgentManager");
-/**
- * Create a new actor manager with the given options.
- * Its create a new agent manager if not provided.
- * It also creates a new actor manager with the given options.
- *
- * @category Main
- * @includeExample ./packages/core/README.md:200-225
- */
-const createReactorStore = (config) => {
-    const { idlFactory, canisterId, withDevtools = false, initializeOnCreate = true, withVisitor = false, agentManager: maybeAgentManager, ...agentParameters } = config;
-    const agentManager = maybeAgentManager ||
-        (0, createAgentManager_1.createAgentManager)({
-            withDevtools,
-            ...agentParameters,
-        });
-    const actorManager = (0, createActorManager_1.createActorManager)({
-        idlFactory,
-        canisterId,
-        agentManager,
-        withVisitor,
-        withDevtools,
-        initializeOnCreate,
-    });
-    return actorManager;
-};
-exports.createReactorStore = createReactorStore;

package/dist/types.d.ts

@@ -1,96 +0,0 @@
-import type { ActorMethod, ActorSubclass, HttpAgentOptions, HttpAgent, Identity, CallConfig } from "@dfinity/agent";
-import type { Principal } from "@dfinity/principal";
-import type { IDL } from "@dfinity/candid";
-import type { ActorManagerParameters, ActorMethodParameters, ActorMethodReturnType, ActorMethodState, BaseActor, FunctionName } from "./classes/actor/types";
-import type { ActorManager } from "./classes/actor";
-import type { AgentManager } from "./classes/agent";
-import type { AuthClientLoginOptions } from "@dfinity/auth-client";
-export * from "./classes/types";
-export type { ActorManager, AgentManager, ActorMethod, AuthClientLoginOptions, HttpAgentOptions, ActorSubclass, Principal, HttpAgent, Identity, IDL, };
-export interface CreateReactorStoreParameters extends HttpAgentOptions, Omit<ActorManagerParameters, "agentManager"> {
-    agentManager?: AgentManager;
-    withProcessEnv?: boolean;
-    withLocalEnv?: boolean;
-    port?: number;
-}
-export type ActorGetStateFunction<A, M extends FunctionName<A>> = {
-    (key: "data"): ActorMethodReturnType<A[M]>;
-    (key: "loading"): boolean;
-    (key: "error"): Error | undefined;
-    (): ActorMethodState<A, M>[string];
-};
-export type ActorSubscribeFunction<A, M extends FunctionName<A>> = (callback: (state: ActorMethodState<A, M>[string]) => void) => () => void;
-export type ActorCallFunction<A, M extends FunctionName<A>> = (replaceArgs?: ActorMethodParameters<A[M]>) => Promise<ActorMethodReturnType<A[M]>>;
-export type ActorQueryReturnType<A, M extends FunctionName<A>> = {
-    intervalId: NodeJS.Timeout | null;
-    requestHash: string;
-    getState: ActorGetStateFunction<A, M>;
-    subscribe: ActorSubscribeFunction<A, M>;
-    call: ActorCallFunction<A, M>;
-    dataPromise: Promise<ActorMethodReturnType<A[M]>>;
-};
-export type ActorUpdateReturnType<A, M extends FunctionName<A>> = {
-    requestHash: string;
-    getState: ActorGetStateFunction<A, M>;
-    subscribe: ActorSubscribeFunction<A, M>;
-    call: ActorCallFunction<A, M>;
-};
-export interface ActorQueryParameters<A, M extends FunctionName<A>> extends CallConfig {
-    functionName: M;
-    args?: ActorMethodParameters<A[M]>;
-    refetchOnMount?: boolean;
-    refetchInterval?: number | false;
-}
-export interface ActorUpdateParameters<A, M extends FunctionName<A>> extends CallConfig {
-    functionName: M;
-    args?: ActorMethodParameters<A[M]>;
-}
-export type ActorMethodCall<A = Record<string, ActorMethod>> = <M extends FunctionName<A>>(functionName: M, args: ActorMethodParameters<A[M]>, options?: CallConfig) => ActorUpdateReturnType<A, M>;
-export type ActorQuery<A = Record<string, ActorMethod>> = <M extends FunctionName<A>>(params: ActorQueryParameters<A, M>) => ActorQueryReturnType<A, M>;
-export type ActorUpdate<A = Record<string, ActorMethod>> = <M extends FunctionName<A>>(params: ActorUpdateParameters<A, M>) => ActorUpdateReturnType<A, M>;
-export type CreateReactorCoreParameters = CreateReactorStoreParameters;
-export interface CreateReactorCoreReturnType<A = BaseActor> extends AgentManager, Omit<ActorManager<A>, "updateMethodState"> {
-    queryCall: ActorQuery<A>;
-    updateCall: ActorUpdate<A>;
-}
-export type UnwrapResult<T> = T extends {
-    Ok: infer U;
-} ? U : T extends {
-    Err: infer E;
-} ? E : T;
-type ExtractOkErr<T> = T extends {
-    Ok: infer U;
-} ? {
-    OkType: U;
-    ErrType: never;
-} : T extends {
-    Err: infer E;
-} ? {
-    OkType: never;
-    ErrType: E;
-} : {
-    OkType: T;
-    ErrType: never;
-};
-export type ExtractOk<T> = T extends {
-    Ok: infer U;
-} ? U : never;
-export type ExtractErr<T> = T extends {
-    Err: infer E;
-} ? E : never;
-export type CompiledOkResult<U> = {
-    isOk: true;
-    isErr: false;
-    value: U;
-    error: null;
-};
-export type CompiledErrResult<E> = {
-    isOk: false;
-    isErr: true;
-    value: null;
-    error: E;
-};
-export type CompiledResult<T> = ExtractOkErr<T> extends {
-    OkType: infer U;
-    ErrType: infer E;
-} ? CompiledOkResult<U> | CompiledErrResult<E> : never;

package/dist/types.js

@@ -1,17 +0,0 @@
-"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 __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("./classes/types"), exports);

package/dist/utils/hash.d.ts

@@ -1,12 +0,0 @@
-/**
- * Creates a stable string representation of any JavaScript value
- * Handles circular references and maintains consistent object key ordering
- */
-export declare function stringifyStable(value: unknown): string;
-/**
- * Creates a simple numeric hash code and returns it as a hex string
- * @param value - Any JavaScript value
- * @param length - Desired length of the hex string (default: 8)
- * @returns string - Hex string of specified length
- */
-export declare function createSimpleHash(value: unknown, length?: number): string;

package/dist/utils/hash.js

@@ -1,70 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.stringifyStable = stringifyStable;
-exports.createSimpleHash = createSimpleHash;
-/**
- * Creates a stable string representation of any JavaScript value
- * Handles circular references and maintains consistent object key ordering
- */
-function stringifyStable(value) {
-    const seen = new WeakSet();
-    return JSON.stringify(value, (_, value) => {
-        if (value === undefined)
-            return "[undefined]";
-        if (value === null)
-            return "[null]";
-        if (Number.isNaN(value))
-            return "[NaN]";
-        if (value === Infinity)
-            return "[Infinity]";
-        if (value === -Infinity)
-            return "[-Infinity]";
-        if (typeof value === "bigint")
-            return value.toString();
-        if (typeof value === "function")
-            return value.toString();
-        if (value instanceof Date)
-            return value.toISOString();
-        if (value instanceof RegExp)
-            return value.toString();
-        if (ArrayBuffer.isView(value)) {
-            return Array.from(value).join(",");
-        }
-        if (typeof value === "object" && value !== null) {
-            if (seen.has(value))
-                return "[Circular]";
-            seen.add(value);
-            if (Array.isArray(value)) {
-                return value;
-            }
-            const sortedObj = {};
-            const sortedKeys = Object.keys(value).sort();
-            for (const key of sortedKeys) {
-                sortedObj[key] = value[key];
-            }
-            return sortedObj;
-        }
-        return value;
-    });
-}
-/**
- * Creates a simple numeric hash code and returns it as a hex string
- * @param value - Any JavaScript value
- * @param length - Desired length of the hex string (default: 8)
- * @returns string - Hex string of specified length
- */
-function createSimpleHash(value, length = 8) {
-    const str = stringifyStable(value);
-    let hash = 0;
-    // Generate a more distributed hash
-    for (let i = 0; i < str.length; i++) {
-        const char = str.charCodeAt(i);
-        hash = (hash << 5) - hash + char;
-        hash = hash & hash; // Convert to 32-bit integer
-    }
-    // Convert to positive hex string and ensure proper length
-    const positiveHash = Math.abs(hash);
-    const hexString = positiveHash.toString(16);
-    // Pad with zeros to match desired length
-    return hexString.padStart(length, "0");
-}

package/dist/utils/principal.d.ts

@@ -1 +0,0 @@
-export * from "@dfinity/principal";

package/dist/utils/principal.js

@@ -1,17 +0,0 @@
-"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 __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/principal"), exports);