@prodact.ai/sdk 0.0.2

package/dist/react.d.mts

@@ -0,0 +1,244 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import React__default, { ReactNode, CSSProperties } from 'react';
+
+interface ProduckConfig {
+    guiderId?: string;
+    sdkKey?: string;
+    apiUrl?: string;
+    onAction?: (actionKey: string, action: ActionPayload) => void;
+    onMessage?: (message: ChatMessage) => void;
+    onError?: (error: Error) => void;
+    onFlowStart?: (flow: FlowPayload) => void;
+    onFlowStepComplete?: (step: FlowStepResult, flow: FlowPayload) => void;
+    onFlowComplete?: (result: FlowResult) => void;
+}
+interface ActionPayload {
+    actionKey: string;
+    name: string;
+    actionType: string;
+    actionConfig: Record<string, any>;
+    responseMessage?: string;
+}
+interface FlowStep {
+    operationId: string;
+    order: number;
+    condition?: Record<string, any>;
+    inputMapping?: Record<string, any>;
+}
+interface FlowPayload {
+    flowId: string;
+    name: string;
+    description: string;
+    steps: FlowStep[];
+}
+interface FlowStepResult {
+    operationId: string;
+    order: number;
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+interface FlowResult {
+    flowId: string;
+    name: string;
+    steps: FlowStepResult[];
+    completed: boolean;
+    totalSteps: number;
+    successfulSteps: number;
+}
+interface ChatMessage {
+    role: 'user' | 'assistant';
+    content: string;
+    action?: ActionPayload;
+    flow?: FlowPayload;
+    flowResult?: FlowResult;
+}
+interface ActionHandler {
+    (payload: ActionPayload): void | Promise<void>;
+}
+type ProduckEventType = 'action' | 'message' | 'error' | 'ready' | 'flowStart' | 'flowStepComplete' | 'flowComplete';
+declare class ProduckSDK {
+    private config;
+    private actions;
+    private eventListeners;
+    private sessionToken;
+    private isReady;
+    constructor(config: ProduckConfig);
+    /**
+     * Initialize the SDK and create a chat session
+     */
+    init(): Promise<void>;
+    /**
+     * Register an action handler
+     */
+    register(actionKey: string, handler: ActionHandler): void;
+    /**
+     * Unregister an action handler
+     */
+    unregister(actionKey: string): void;
+    /**
+     * Send a message and handle potential action or flow triggers
+     */
+    sendMessage(message: string): Promise<ChatMessage>;
+    /**
+     * Execute a flow by running each step's operation sequentially
+     */
+    executeFlow(flow: FlowPayload): Promise<FlowResult>;
+    /**
+     * Send log data to backend for analytics
+     */
+    private sendLogToBackend;
+    /**
+     * Send detailed log to backend
+     */
+    private log;
+    /**
+     * Execute a registered action
+     */
+    private executeAction;
+    /**
+     * Add event listener
+     */
+    on(event: ProduckEventType, callback: Function): void;
+    /**
+     * Remove event listener
+     */
+    off(event: ProduckEventType, callback: Function): void;
+    /**
+     * Emit event
+     */
+    private emit;
+    /**
+     * Get session token
+     */
+    getSessionToken(): string | null;
+    /**
+     * Check if SDK is ready
+     */
+    getIsReady(): boolean;
+    /**
+     * Get registered action keys
+     */
+    getRegisteredActions(): string[];
+    /**
+     * Destroy the SDK instance
+     */
+    destroy(): void;
+}
+
+interface ProduckProviderProps {
+    config: Omit<ProduckConfig, 'onAction' | 'onMessage' | 'onError' | 'onFlowStart' | 'onFlowStepComplete' | 'onFlowComplete'>;
+    children: ReactNode;
+    onAction?: (actionKey: string, payload: ActionPayload) => void;
+    onError?: (error: Error) => void;
+    onFlowStart?: (flow: FlowPayload) => void;
+    onFlowStepComplete?: (step: FlowStepResult, flow: FlowPayload) => void;
+    onFlowComplete?: (result: FlowResult) => void;
+}
+declare function ProduckProvider({ config, children, onAction, onError, onFlowStart, onFlowStepComplete, onFlowComplete, }: ProduckProviderProps): react_jsx_runtime.JSX.Element;
+
+interface ProduckChatAppearance {
+    width?: string | number;
+    height?: string | number;
+    borderRadius?: string | number;
+    backgroundColor?: string;
+    headerBackgroundColor?: string;
+    headerTextColor?: string;
+    inputBackgroundColor?: string;
+    inputTextColor?: string;
+    inputBorderColor?: string;
+    userMessageBackgroundColor?: string;
+    userMessageTextColor?: string;
+    assistantMessageBackgroundColor?: string;
+    assistantMessageTextColor?: string;
+    buttonBackgroundColor?: string;
+    buttonTextColor?: string;
+    buttonBorderRadius?: string | number;
+    floatingButtonSize?: string | number;
+    fontFamily?: string;
+    fontSize?: string | number;
+    headerFontSize?: string | number;
+    border?: string;
+    boxShadow?: string;
+    floatingButtonIcon?: React__default.ReactNode;
+    floatingButtonLoadingIcon?: React__default.ReactNode;
+    showCloseButton?: boolean;
+    headerIcon?: React__default.ReactNode;
+    sendButtonText?: string;
+    sendButtonIcon?: React__default.ReactNode;
+    emptyStateIcon?: React__default.ReactNode;
+    emptyStateTitle?: string;
+    emptyStateSubtitle?: string;
+}
+interface ProduckChatProps {
+    placeholder?: string;
+    title?: string;
+    position?: 'bottom-right' | 'bottom-left' | 'inline';
+    theme?: 'light' | 'dark';
+    primaryColor?: string;
+    className?: string;
+    style?: CSSProperties;
+    defaultOpen?: boolean;
+    appearance?: ProduckChatAppearance;
+}
+declare function ProduckChat({ placeholder, title, position, theme, primaryColor, className, style, defaultOpen, appearance, }: ProduckChatProps): react_jsx_runtime.JSX.Element;
+
+interface ProduckTargetProps {
+    actionKey: string;
+    children: ReactNode;
+    onTrigger?: (payload: ActionPayload) => void;
+    highlightStyle?: React__default.CSSProperties;
+    highlightDuration?: number;
+    scrollIntoView?: boolean;
+}
+/**
+ * Wrapper component that registers an action and can highlight/scroll to the target
+ */
+declare function ProduckTarget({ actionKey, children, onTrigger, highlightStyle, highlightDuration, scrollIntoView, }: ProduckTargetProps): react_jsx_runtime.JSX.Element;
+
+interface ProduckContextValue {
+    sdk: ProduckSDK | null;
+    isReady: boolean;
+    sessionToken: string | null;
+    messages: ChatMessage[];
+    isLoading: boolean;
+    sendMessage: (message: string) => Promise<void>;
+    register: (actionKey: string, handler: (payload: ActionPayload) => void) => void;
+    unregister: (actionKey: string) => void;
+    activeFlow: FlowPayload | null;
+    flowResult: FlowResult | null;
+    isExecutingFlow: boolean;
+}
+declare const ProduckContext: React.Context<ProduckContextValue | null>;
+
+/**
+ * Hook to access Produck SDK functionality
+ */
+declare function useProduck(): ProduckContextValue;
+/**
+ * Hook to register an action handler
+ */
+declare function useProduckAction(actionKey: string, handler: (payload: ActionPayload) => void, deps?: any[]): void;
+/**
+ * Hook to check if SDK is ready
+ */
+declare function useProduckReady(): boolean;
+/**
+ * Hook to get chat messages
+ */
+declare function useProduckMessages(): {
+    messages: ChatMessage[];
+    isLoading: boolean;
+    sendMessage: (message: string) => Promise<void>;
+};
+/**
+ * Hook to get flow execution status
+ */
+declare function useProduckFlow(): {
+    activeFlow: FlowPayload | null;
+    flowResult: FlowResult | null;
+    isExecutingFlow: boolean;
+};
+
+export { type ActionHandler, type ActionPayload, type ChatMessage, type FlowPayload, type FlowResult, type FlowStep, type FlowStepResult, ProduckChat, type ProduckChatAppearance, type ProduckChatProps, type ProduckConfig, ProduckContext, type ProduckContextValue, ProduckProvider, type ProduckProviderProps, ProduckTarget, type ProduckTargetProps, useProduck, useProduckAction, useProduckFlow, useProduckMessages, useProduckReady };

package/dist/react.d.ts

@@ -0,0 +1,244 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import React__default, { ReactNode, CSSProperties } from 'react';
+
+interface ProduckConfig {
+    guiderId?: string;
+    sdkKey?: string;
+    apiUrl?: string;
+    onAction?: (actionKey: string, action: ActionPayload) => void;
+    onMessage?: (message: ChatMessage) => void;
+    onError?: (error: Error) => void;
+    onFlowStart?: (flow: FlowPayload) => void;
+    onFlowStepComplete?: (step: FlowStepResult, flow: FlowPayload) => void;
+    onFlowComplete?: (result: FlowResult) => void;
+}
+interface ActionPayload {
+    actionKey: string;
+    name: string;
+    actionType: string;
+    actionConfig: Record<string, any>;
+    responseMessage?: string;
+}
+interface FlowStep {
+    operationId: string;
+    order: number;
+    condition?: Record<string, any>;
+    inputMapping?: Record<string, any>;
+}
+interface FlowPayload {
+    flowId: string;
+    name: string;
+    description: string;
+    steps: FlowStep[];
+}
+interface FlowStepResult {
+    operationId: string;
+    order: number;
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+interface FlowResult {
+    flowId: string;
+    name: string;
+    steps: FlowStepResult[];
+    completed: boolean;
+    totalSteps: number;
+    successfulSteps: number;
+}
+interface ChatMessage {
+    role: 'user' | 'assistant';
+    content: string;
+    action?: ActionPayload;
+    flow?: FlowPayload;
+    flowResult?: FlowResult;
+}
+interface ActionHandler {
+    (payload: ActionPayload): void | Promise<void>;
+}
+type ProduckEventType = 'action' | 'message' | 'error' | 'ready' | 'flowStart' | 'flowStepComplete' | 'flowComplete';
+declare class ProduckSDK {
+    private config;
+    private actions;
+    private eventListeners;
+    private sessionToken;
+    private isReady;
+    constructor(config: ProduckConfig);
+    /**
+     * Initialize the SDK and create a chat session
+     */
+    init(): Promise<void>;
+    /**
+     * Register an action handler
+     */
+    register(actionKey: string, handler: ActionHandler): void;
+    /**
+     * Unregister an action handler
+     */
+    unregister(actionKey: string): void;
+    /**
+     * Send a message and handle potential action or flow triggers
+     */
+    sendMessage(message: string): Promise<ChatMessage>;
+    /**
+     * Execute a flow by running each step's operation sequentially
+     */
+    executeFlow(flow: FlowPayload): Promise<FlowResult>;
+    /**
+     * Send log data to backend for analytics
+     */
+    private sendLogToBackend;
+    /**
+     * Send detailed log to backend
+     */
+    private log;
+    /**
+     * Execute a registered action
+     */
+    private executeAction;
+    /**
+     * Add event listener
+     */
+    on(event: ProduckEventType, callback: Function): void;
+    /**
+     * Remove event listener
+     */
+    off(event: ProduckEventType, callback: Function): void;
+    /**
+     * Emit event
+     */
+    private emit;
+    /**
+     * Get session token
+     */
+    getSessionToken(): string | null;
+    /**
+     * Check if SDK is ready
+     */
+    getIsReady(): boolean;
+    /**
+     * Get registered action keys
+     */
+    getRegisteredActions(): string[];
+    /**
+     * Destroy the SDK instance
+     */
+    destroy(): void;
+}
+
+interface ProduckProviderProps {
+    config: Omit<ProduckConfig, 'onAction' | 'onMessage' | 'onError' | 'onFlowStart' | 'onFlowStepComplete' | 'onFlowComplete'>;
+    children: ReactNode;
+    onAction?: (actionKey: string, payload: ActionPayload) => void;
+    onError?: (error: Error) => void;
+    onFlowStart?: (flow: FlowPayload) => void;
+    onFlowStepComplete?: (step: FlowStepResult, flow: FlowPayload) => void;
+    onFlowComplete?: (result: FlowResult) => void;
+}
+declare function ProduckProvider({ config, children, onAction, onError, onFlowStart, onFlowStepComplete, onFlowComplete, }: ProduckProviderProps): react_jsx_runtime.JSX.Element;
+
+interface ProduckChatAppearance {
+    width?: string | number;
+    height?: string | number;
+    borderRadius?: string | number;
+    backgroundColor?: string;
+    headerBackgroundColor?: string;
+    headerTextColor?: string;
+    inputBackgroundColor?: string;
+    inputTextColor?: string;
+    inputBorderColor?: string;
+    userMessageBackgroundColor?: string;
+    userMessageTextColor?: string;
+    assistantMessageBackgroundColor?: string;
+    assistantMessageTextColor?: string;
+    buttonBackgroundColor?: string;
+    buttonTextColor?: string;
+    buttonBorderRadius?: string | number;
+    floatingButtonSize?: string | number;
+    fontFamily?: string;
+    fontSize?: string | number;
+    headerFontSize?: string | number;
+    border?: string;
+    boxShadow?: string;
+    floatingButtonIcon?: React__default.ReactNode;
+    floatingButtonLoadingIcon?: React__default.ReactNode;
+    showCloseButton?: boolean;
+    headerIcon?: React__default.ReactNode;
+    sendButtonText?: string;
+    sendButtonIcon?: React__default.ReactNode;
+    emptyStateIcon?: React__default.ReactNode;
+    emptyStateTitle?: string;
+    emptyStateSubtitle?: string;
+}
+interface ProduckChatProps {
+    placeholder?: string;
+    title?: string;
+    position?: 'bottom-right' | 'bottom-left' | 'inline';
+    theme?: 'light' | 'dark';
+    primaryColor?: string;
+    className?: string;
+    style?: CSSProperties;
+    defaultOpen?: boolean;
+    appearance?: ProduckChatAppearance;
+}
+declare function ProduckChat({ placeholder, title, position, theme, primaryColor, className, style, defaultOpen, appearance, }: ProduckChatProps): react_jsx_runtime.JSX.Element;
+
+interface ProduckTargetProps {
+    actionKey: string;
+    children: ReactNode;
+    onTrigger?: (payload: ActionPayload) => void;
+    highlightStyle?: React__default.CSSProperties;
+    highlightDuration?: number;
+    scrollIntoView?: boolean;
+}
+/**
+ * Wrapper component that registers an action and can highlight/scroll to the target
+ */
+declare function ProduckTarget({ actionKey, children, onTrigger, highlightStyle, highlightDuration, scrollIntoView, }: ProduckTargetProps): react_jsx_runtime.JSX.Element;
+
+interface ProduckContextValue {
+    sdk: ProduckSDK | null;
+    isReady: boolean;
+    sessionToken: string | null;
+    messages: ChatMessage[];
+    isLoading: boolean;
+    sendMessage: (message: string) => Promise<void>;
+    register: (actionKey: string, handler: (payload: ActionPayload) => void) => void;
+    unregister: (actionKey: string) => void;
+    activeFlow: FlowPayload | null;
+    flowResult: FlowResult | null;
+    isExecutingFlow: boolean;
+}
+declare const ProduckContext: React.Context<ProduckContextValue | null>;
+
+/**
+ * Hook to access Produck SDK functionality
+ */
+declare function useProduck(): ProduckContextValue;
+/**
+ * Hook to register an action handler
+ */
+declare function useProduckAction(actionKey: string, handler: (payload: ActionPayload) => void, deps?: any[]): void;
+/**
+ * Hook to check if SDK is ready
+ */
+declare function useProduckReady(): boolean;
+/**
+ * Hook to get chat messages
+ */
+declare function useProduckMessages(): {
+    messages: ChatMessage[];
+    isLoading: boolean;
+    sendMessage: (message: string) => Promise<void>;
+};
+/**
+ * Hook to get flow execution status
+ */
+declare function useProduckFlow(): {
+    activeFlow: FlowPayload | null;
+    flowResult: FlowResult | null;
+    isExecutingFlow: boolean;
+};
+
+export { type ActionHandler, type ActionPayload, type ChatMessage, type FlowPayload, type FlowResult, type FlowStep, type FlowStepResult, ProduckChat, type ProduckChatAppearance, type ProduckChatProps, type ProduckConfig, ProduckContext, type ProduckContextValue, ProduckProvider, type ProduckProviderProps, ProduckTarget, type ProduckTargetProps, useProduck, useProduckAction, useProduckFlow, useProduckMessages, useProduckReady };