@forgerock/davinci-client 1.0.0 → 1.2.0

package/dist/src/lib/client.store.js

@@ -0,0 +1,300 @@
+/*
+ * Copyright (c) 2025 Ping Identity Corporation. All rights reserved.
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+/**
+ * Import RTK slices and api
+ */
+import { logger as loggerFn } from '@forgerock/sdk-logger';
+import { createStorage } from '@forgerock/storage';
+import { createClientStore, handleUpdateValidateError } from './client.store.utils.js';
+import { nodeSlice } from './node.slice.js';
+import { davinciApi } from './davinci.api.js';
+import { configSlice } from './config.slice.js';
+import { wellknownApi } from './wellknown.api.js';
+import { returnValidator } from './collector.utils.js';
+/**
+ * Create a client function that returns a set of methods
+ * to interact with and normalize the DaVinci API.
+ *
+ * @function davinciClient - returns an "observable" client for DaVinci flows
+ * @param {ConfigurationOptions} options - the configuration options for the client
+ * @returns {Observable} - an observable client for DaVinci flows
+ */
+export async function davinci({ config, requestMiddleware, logger, }) {
+    const log = loggerFn({ level: logger?.level || 'error', custom: logger?.custom });
+    const store = createClientStore({ requestMiddleware, logger: log });
+    const serverInfo = createStorage({ storeType: 'localStorage' }, 'serverInfo');
+    if (!config.serverConfig.wellknown) {
+        const error = new Error('`wellknown` property is a required as part of the `config.serverConfig`');
+        log.error(error.message);
+        throw error;
+    }
+    if (!config.clientId) {
+        const error = new Error('`clientId` property is a required as part of the `config`');
+        log.error(error.message);
+        throw error;
+    }
+    const { data: openIdResponse } = await store.dispatch(wellknownApi.endpoints.wellknown.initiate(config.serverConfig.wellknown));
+    if (!openIdResponse) {
+        const error = new Error('error fetching `wellknown` response for OpenId Configuration');
+        log.error(error.message);
+        throw error;
+    }
+    store.dispatch(configSlice.actions.set({ ...config, wellknownResponse: openIdResponse }));
+    return {
+        // Pass store methods to the client
+        subscribe: store.subscribe,
+        /**
+         * Social Login Handler
+         * Use this as part of an event when clicking on
+         * a social login button. Pass in the collector responsible
+         * for the social login being started.
+         *
+         * This method will save the `continueUrl`
+         * and then the app developer can use the url
+         * from the collector to redirect their application
+         *
+         * Can return an error when no continue url is found
+         * or no authenticate url is found in the collectors
+         *
+         * @method: externalIdp
+         * @param collector IdpCollector
+         * @returns {function}
+         */
+        externalIdp: () => {
+            const rootState = store.getState();
+            const serverSlice = nodeSlice.selectors.selectServer(rootState);
+            if (serverSlice && serverSlice.status === 'continue') {
+                return async () => {
+                    await serverInfo.set(serverSlice);
+                };
+            }
+            return async () => {
+                return {
+                    error: {
+                        message: 'Not in a continue node state, must be in a continue node to use external idp method',
+                        type: 'state_error',
+                    },
+                };
+            };
+        },
+        /**
+         * @method flow - Method for initiating a new flow, different than current flow
+         * @param {DaVinciAction} action - the action to initiate the flow
+         * @returns {function} - an async function to call the flow
+         */
+        flow: (action) => {
+            if (!action.action) {
+                log.error('Missing `argument.action`');
+                return async function () {
+                    return {
+                        error: { message: 'Missing argument.action', type: 'argument_error' },
+                        type: 'internal_error',
+                    };
+                };
+            }
+            return async function () {
+                await store.dispatch(davinciApi.endpoints.flow.initiate(action));
+                const node = nodeSlice.selectSlice(store.getState());
+                return node;
+            };
+        },
+        /**
+         * @method next - Method for initiating the next node in the current flow
+         * @param {DaVinciRequest} args - the arguments to pass to the next
+         * @returns {Promise} - a promise that resolves to the next node
+         */
+        next: async (args) => {
+            const nodeCheck = nodeSlice.selectSlice(store.getState());
+            if (nodeCheck.status === 'start') {
+                return {
+                    ...nodeCheck,
+                    error: {
+                        status: 'error',
+                        type: 'state_error',
+                        message: 'Please use `start` before calling `next`',
+                    },
+                };
+            }
+            await store.dispatch(davinciApi.endpoints.next.initiate(args));
+            const node = nodeSlice.selectSlice(store.getState());
+            return node;
+        },
+        /**
+         * @method: resume - Resume a social login flow when returned to application
+         * @returns unknown
+         */
+        resume: async ({ continueToken, }) => {
+            try {
+                const storedServerInfo = (await serverInfo.get());
+                await store.dispatch(davinciApi.endpoints.resume.initiate({ continueToken, serverInfo: storedServerInfo }));
+                await serverInfo.remove();
+                const node = nodeSlice.selectSlice(store.getState());
+                return node;
+            }
+            catch {
+                // logger.error('No url found in collector, social login needs a url in the collector');
+                return {
+                    error: {
+                        message: 'No url found in storage, social login needs a continue url which is saved in local storage. You may have cleared your browser data',
+                        type: 'internal_error',
+                    },
+                    type: 'internal_error',
+                };
+            }
+        },
+        /**
+         * @method start - Method for initiating a DaVinci flow
+         * @returns {Promise} - a promise that initiates a DaVinci flow and returns a node
+         */
+        start: async (options) => {
+            await store.dispatch(davinciApi.endpoints.start.initiate(options));
+            return store.getState().node;
+        },
+        /**
+         * @method update - Exclusive method for updating the current node with user provided values
+         * @param {SingleValueCollector} collector - the collector to update
+         * @returns {function} - a function to call for updating collector value
+         */
+        update: (collector) => {
+            if (!collector.id) {
+                return handleUpdateValidateError('Argument for `collector` has no ID', 'argument_error', log.error);
+            }
+            const { id } = collector;
+            const { error, state: collectorToUpdate } = nodeSlice.selectors.selectCollector(store.getState(), id);
+            if (error) {
+                return handleUpdateValidateError(error.message, 'state_error', log.error);
+            }
+            if (!collectorToUpdate) {
+                return handleUpdateValidateError('Collector not found', 'state_error', log.error);
+            }
+            if (collectorToUpdate.category !== 'MultiValueCollector' &&
+                collectorToUpdate.category !== 'SingleValueCollector' &&
+                collectorToUpdate.category !== 'ValidatedSingleValueCollector' &&
+                collectorToUpdate.category !== 'ObjectValueCollector') {
+                return handleUpdateValidateError('Collector is not a MultiValueCollector, SingleValueCollector or ValidatedSingleValueCollector and cannot be updated', 'state_error', log.error);
+            }
+            return function (value, index) {
+                try {
+                    store.dispatch(nodeSlice.actions.update({ id, value, index }));
+                    return null;
+                }
+                catch (err) {
+                    const error = err;
+                    return {
+                        type: 'internal_error',
+                        error: { message: error.message, type: 'internal_error' },
+                    };
+                }
+            };
+        },
+        /**
+         * @method validate - Method for validating the value against validation rules
+         * @param {SingleValueCollector} collector - the collector to validate
+         * @returns {function} - a function to call for validating collector value
+         * @throws {Error} - if the collector is not a SingleValueCollector
+         */
+        validate: (collector) => {
+            if (!collector.id) {
+                return handleUpdateValidateError('Argument for `collector` has no ID', 'argument_error', log.error);
+            }
+            const { id } = collector;
+            const { error, state: collectorToUpdate } = nodeSlice.selectors.selectCollector(store.getState(), id);
+            if (error) {
+                return handleUpdateValidateError(error.message, 'state_error', log.error);
+            }
+            if (!collectorToUpdate) {
+                return handleUpdateValidateError('Collector not found', 'state_error', log.error);
+            }
+            if (collectorToUpdate.category !== 'ValidatedSingleValueCollector') {
+                return handleUpdateValidateError('Collector is not a SingleValueCollector and cannot be validated', 'state_error', log.error);
+            }
+            if (!('validation' in collectorToUpdate.input)) {
+                return handleUpdateValidateError('Collector has no validation rules', 'state_error', log.error);
+            }
+            return returnValidator(collectorToUpdate);
+        },
+        /**
+         * @method client - Selector to get the node.client from state
+         * @returns {Node.client} - the client property from the current node
+         */
+        getClient: () => nodeSlice.selectors.selectClient(store.getState()),
+        /**
+         * @method collectors - Selector to get the collectors from state
+         * @returns {Collector[]} - The collectors from the current node in state
+         */
+        getCollectors: () => {
+            const state = store.getState();
+            const client = nodeSlice.selectors.selectClient(state);
+            // Let's check if the node has a client and collectors
+            if (client && 'collectors' in client) {
+                const { error, state: collectors } = nodeSlice.selectors.selectCollectors(state) || [];
+                if (error) {
+                    log.error(error.message);
+                    return [];
+                }
+                return collectors;
+            }
+            // Return an empty array if no client or collectors are found
+            return [];
+        },
+        getError: () => {
+            const state = store.getState();
+            return nodeSlice.selectors.selectError(state);
+        },
+        getErrorCollectors: () => {
+            const state = store.getState();
+            const { error, state: collectors } = nodeSlice.selectors.selectErrorCollectors(state);
+            if (error) {
+                log.error(error.message);
+                return [];
+            }
+            return collectors;
+        },
+        /**
+         * @method node - Selector to get the node from state
+         * @returns {Node} - the current node from state
+         */
+        getNode: () => {
+            return nodeSlice.selectSlice(store.getState());
+        },
+        /**
+         * @method server - Selector to get the node.server from state
+         * @returns {Node.server} - the server property from the current node
+         */
+        getServer: () => {
+            const state = store.getState();
+            return nodeSlice.selectors.selectServer(state);
+        },
+        /**
+         * Utilities to help query cached responses from server
+         */
+        cache: {
+            getLatestResponse: () => {
+                const node = nodeSlice.selectSlice(store.getState());
+                if (!node.cache?.key) {
+                    log.error(`Cannot find current node's cache key or no current node`);
+                    return { error: { message: 'Cannot find current node', type: 'state_error' } };
+                }
+                const flowItem = davinciApi.endpoints.flow.select(node.cache.key);
+                const nextItem = davinciApi.endpoints.next.select(node.cache.key);
+                const startItem = davinciApi.endpoints.start.select(node.cache.key);
+                return flowItem || nextItem || startItem;
+            },
+            getResponseWithId: (requestId) => {
+                if (!requestId) {
+                    log.error('Please provide the cache key');
+                    return { error: { message: 'Please provide the cache key', type: 'argument_error' } };
+                }
+                const flowItem = davinciApi.endpoints.flow.select(requestId);
+                const nextItem = davinciApi.endpoints.next.select(requestId);
+                const startItem = davinciApi.endpoints.start.select(requestId);
+                return flowItem || nextItem || startItem;
+            },
+        },
+    };
+}
+//# sourceMappingURL=client.store.js.map

package/dist/src/lib/client.store.js.map

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

package/dist/src/lib/client.store.utils.d.ts

@@ -0,0 +1,74 @@
+import type { ActionTypes, RequestMiddleware } from '@forgerock/sdk-request-middleware';
+import type { logger as loggerFn } from '@forgerock/sdk-logger';
+import { ErrorNode, ContinueNode, StartNode, SuccessNode } from '../types.js';
+import { InternalErrorResponse } from './client.types.js';
+export declare function createClientStore<ActionType extends ActionTypes>({ requestMiddleware, logger, }: {
+    requestMiddleware?: RequestMiddleware<ActionType, unknown>[];
+    logger?: ReturnType<typeof loggerFn>;
+}): import("@reduxjs/toolkit").EnhancedStore<{
+    config: {
+        endpoints: import("./wellknown.types.js").Endpoints;
+        clientId: string;
+        redirectUri: string;
+        responseType: string;
+        scope: string;
+    };
+    node: import("./node.types.js").ContinueNode | import("./node.types.js").ErrorNode | import("./node.types.js").FailureNode | import("./node.types.js").StartNode | import("./node.types.js").SuccessNode;
+    davinci: import("@reduxjs/toolkit/query").CombinedState<{
+        flow: import("@reduxjs/toolkit/query").MutationDefinition<any, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@reduxjs/toolkit/query").FetchArgs, unknown, import("@reduxjs/toolkit/query").FetchBaseQueryError, {}, import("@reduxjs/toolkit/query").FetchBaseQueryMeta>, never, unknown, "davinci", any>;
+        next: import("@reduxjs/toolkit/query").MutationDefinition<any, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@reduxjs/toolkit/query").FetchArgs, unknown, import("@reduxjs/toolkit/query").FetchBaseQueryError, {}, import("@reduxjs/toolkit/query").FetchBaseQueryMeta>, never, unknown, "davinci", any>;
+        start: import("@reduxjs/toolkit/query").MutationDefinition<import("./davinci.types.js").StartOptions<import("./davinci.types.js").OutgoingQueryParams> | undefined, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@reduxjs/toolkit/query").FetchArgs, unknown, import("@reduxjs/toolkit/query").FetchBaseQueryError, {}, import("@reduxjs/toolkit/query").FetchBaseQueryMeta>, never, unknown, "davinci", unknown>;
+        resume: import("@reduxjs/toolkit/query").QueryDefinition<{
+            serverInfo: import("./node.types.js").ContinueNode["server"];
+            continueToken: string;
+        }, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@reduxjs/toolkit/query").FetchArgs, unknown, import("@reduxjs/toolkit/query").FetchBaseQueryError, {}, import("@reduxjs/toolkit/query").FetchBaseQueryMeta>, never, unknown, "davinci", unknown>;
+    }, never, "davinci">;
+    wellknown: import("@reduxjs/toolkit/query").CombinedState<{
+        wellknown: import("@reduxjs/toolkit/query").QueryDefinition<string, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@reduxjs/toolkit/query").FetchArgs, unknown, import("@reduxjs/toolkit/query").FetchBaseQueryError, {}, import("@reduxjs/toolkit/query").FetchBaseQueryMeta>, never, import("./wellknown.types.js").WellknownResponse, "wellknown", unknown>;
+    }, never, "wellknown">;
+}, import("@reduxjs/toolkit").UnknownAction, import("@reduxjs/toolkit").Tuple<[import("@reduxjs/toolkit").StoreEnhancer<{
+    dispatch: import("@reduxjs/toolkit").ThunkDispatch<{
+        config: {
+            endpoints: import("./wellknown.types.js").Endpoints;
+            clientId: string;
+            redirectUri: string;
+            responseType: string;
+            scope: string;
+        };
+        node: import("./node.types.js").ContinueNode | import("./node.types.js").ErrorNode | import("./node.types.js").FailureNode | import("./node.types.js").StartNode | import("./node.types.js").SuccessNode;
+        davinci: import("@reduxjs/toolkit/query").CombinedState<{
+            flow: import("@reduxjs/toolkit/query").MutationDefinition<any, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@reduxjs/toolkit/query").FetchArgs, unknown, import("@reduxjs/toolkit/query").FetchBaseQueryError, {}, import("@reduxjs/toolkit/query").FetchBaseQueryMeta>, never, unknown, "davinci", any>;
+            next: import("@reduxjs/toolkit/query").MutationDefinition<any, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@reduxjs/toolkit/query").FetchArgs, unknown, import("@reduxjs/toolkit/query").FetchBaseQueryError, {}, import("@reduxjs/toolkit/query").FetchBaseQueryMeta>, never, unknown, "davinci", any>;
+            start: import("@reduxjs/toolkit/query").MutationDefinition<import("./davinci.types.js").StartOptions<import("./davinci.types.js").OutgoingQueryParams> | undefined, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@reduxjs/toolkit/query").FetchArgs, unknown, import("@reduxjs/toolkit/query").FetchBaseQueryError, {}, import("@reduxjs/toolkit/query").FetchBaseQueryMeta>, never, unknown, "davinci", unknown>;
+            resume: import("@reduxjs/toolkit/query").QueryDefinition<{
+                serverInfo: import("./node.types.js").ContinueNode["server"];
+                continueToken: string;
+            }, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@reduxjs/toolkit/query").FetchArgs, unknown, import("@reduxjs/toolkit/query").FetchBaseQueryError, {}, import("@reduxjs/toolkit/query").FetchBaseQueryMeta>, never, unknown, "davinci", unknown>;
+        }, never, "davinci">;
+        wellknown: import("@reduxjs/toolkit/query").CombinedState<{
+            wellknown: import("@reduxjs/toolkit/query").QueryDefinition<string, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@reduxjs/toolkit/query").FetchArgs, unknown, import("@reduxjs/toolkit/query").FetchBaseQueryError, {}, import("@reduxjs/toolkit/query").FetchBaseQueryMeta>, never, import("./wellknown.types.js").WellknownResponse, "wellknown", unknown>;
+        }, never, "wellknown">;
+    }, {
+        /**
+         * This becomes the `api.extra` argument, and will be passed into the
+         * customer query wrapper for `baseQuery`
+         */
+        requestMiddleware: RequestMiddleware<ActionType, unknown>[] | undefined;
+        logger: {
+            changeLevel: (level: import("@forgerock/sdk-logger").LogLevel) => void;
+            error: (...args: import("@forgerock/sdk-logger").LogMessage[]) => void;
+            warn: (...args: import("@forgerock/sdk-logger").LogMessage[]) => void;
+            info: (...args: import("@forgerock/sdk-logger").LogMessage[]) => void;
+            debug: (...args: import("@forgerock/sdk-logger").LogMessage[]) => void;
+        } | undefined;
+    }, import("@reduxjs/toolkit").UnknownAction>;
+}>, import("@reduxjs/toolkit").StoreEnhancer]>>;
+export declare function handleUpdateValidateError(message: string, type: 'argument_error' | 'state_error', cb: (message: string) => void): () => InternalErrorResponse;
+type ClientStore = typeof createClientStore;
+export type RootState = ReturnType<ReturnType<ClientStore>['getState']>;
+export interface RootStateWithNode<T extends ErrorNode | ContinueNode | StartNode | SuccessNode> extends RootState {
+    node: T;
+}
+export type AppDispatch = ReturnType<ReturnType<ClientStore>['dispatch']>;
+export {};
+//# sourceMappingURL=client.store.utils.d.ts.map

package/dist/src/lib/client.store.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.store.utils.d.ts","sourceRoot":"","sources":["../../../src/lib/client.store.utils.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACxF,OAAO,KAAK,EAAE,MAAM,IAAI,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAKhE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,wBAAgB,iBAAiB,CAAC,UAAU,SAAS,WAAW,EAAE,EAChE,iBAAiB,EACjB,MAAM,GACP,EAAE;IACD,iBAAiB,CAAC,EAAE,iBAAiB,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC;IAC7D,MAAM,CAAC,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;CACtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAYW;;;WAGG;;;;oBAjCM,GAAG;mBAEZ,GAAG;mBAAwC,GAAG;oBAChD,GAAG;;;gDAuCZ;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,gBAAgB,GAAG,aAAa,EACtC,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC5B,MAAM,qBAAqB,CAW7B;AAED,KAAK,WAAW,GAAG,OAAO,iBAAiB,CAAC;AAE5C,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AAExE,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,CAC7F,SAAQ,SAAS;IACjB,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC"}

package/dist/src/lib/client.store.utils.js

@@ -0,0 +1,48 @@
+/*
+ * Copyright (c) 2025 Ping Identity Corporation. All rights reserved.
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+import { configureStore } from '@reduxjs/toolkit';
+import { configSlice } from './config.slice.js';
+import { nodeSlice } from './node.slice.js';
+import { davinciApi } from './davinci.api.js';
+import { wellknownApi } from './wellknown.api.js';
+export function createClientStore({ requestMiddleware, logger, }) {
+    return configureStore({
+        reducer: {
+            config: configSlice.reducer,
+            node: nodeSlice.reducer,
+            [davinciApi.reducerPath]: davinciApi.reducer,
+            [wellknownApi.reducerPath]: wellknownApi.reducer,
+        },
+        middleware: (getDefaultMiddleware) => getDefaultMiddleware({
+            thunk: {
+                extraArgument: {
+                    /**
+                     * This becomes the `api.extra` argument, and will be passed into the
+                     * customer query wrapper for `baseQuery`
+                     */
+                    requestMiddleware,
+                    logger,
+                },
+            },
+        })
+            .concat(davinciApi.middleware)
+            .concat(wellknownApi.middleware),
+    });
+}
+export function handleUpdateValidateError(message, type, cb) {
+    cb(message);
+    return function () {
+        return {
+            error: {
+                message: message,
+                type: type,
+            },
+            type: 'internal_error',
+        };
+    };
+}
+//# sourceMappingURL=client.store.utils.js.map

package/dist/src/lib/client.store.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.store.utils.js","sourceRoot":"","sources":["../../../src/lib/client.store.utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKlD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,MAAM,UAAU,iBAAiB,CAAiC,EAChE,iBAAiB,EACjB,MAAM,GAIP;IACC,OAAO,cAAc,CAAC;QACpB,OAAO,EAAE;YACP,MAAM,EAAE,WAAW,CAAC,OAAO;YAC3B,IAAI,EAAE,SAAS,CAAC,OAAO;YACvB,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC,OAAO;YAC5C,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC,OAAO;SACjD;QACD,UAAU,EAAE,CAAC,oBAAoB,EAAE,EAAE,CACnC,oBAAoB,CAAC;YACnB,KAAK,EAAE;gBACL,aAAa,EAAE;oBACb;;;uBAGG;oBACH,iBAAiB;oBACjB,MAAM;iBACP;aACF;SACF,CAAC;aACC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC;aAC7B,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC;KACrC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,OAAe,EACf,IAAsC,EACtC,EAA6B;IAE7B,EAAE,CAAC,OAAO,CAAC,CAAC;IACZ,OAAO;QACL,OAAO;YACL,KAAK,EAAE;gBACL,OAAO,EAAE,OAAO;gBAChB,IAAI,EAAE,IAAI;aACX;YACD,IAAI,EAAE,gBAAyB;SAChC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/lib/client.types.d.ts

@@ -0,0 +1,19 @@
+import { PhoneNumberInputValue } from './collector.types.js';
+import { GenericError } from './error.types.js';
+import { ErrorNode, FailureNode, ContinueNode, StartNode, SuccessNode } from './node.types.js';
+export type FlowNode = ContinueNode | ErrorNode | StartNode | SuccessNode | FailureNode;
+export interface InternalErrorResponse {
+    error: GenericError;
+    type: 'internal_error';
+}
+export type InitFlow = () => Promise<FlowNode | InternalErrorResponse>;
+export type Updater = (value: string | string[] | PhoneNumberInputValue, index?: number) => InternalErrorResponse | null;
+export type Validator = (value: string) => string[] | {
+    error: {
+        message: string;
+        type: string;
+    };
+    type: string;
+};
+export type NodeStates = StartNode | ContinueNode | ErrorNode | SuccessNode | FailureNode;
+//# sourceMappingURL=client.types.d.ts.map

package/dist/src/lib/client.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.types.d.ts","sourceRoot":"","sources":["../../../src/lib/client.types.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE/F,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC;AAExF,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,GAAG,qBAAqB,CAAC,CAAC;AAEvE,MAAM,MAAM,OAAO,GAAG,CACpB,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,qBAAqB,EAChD,KAAK,CAAC,EAAE,MAAM,KACX,qBAAqB,GAAG,IAAI,CAAC;AAClC,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,KAClC,MAAM,EAAE,GACR;IACE,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC"}

package/dist/src/lib/client.types.js

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

package/dist/src/lib/client.types.js.map

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