@kite-copilot/chat-panel 0.1.2 → 0.2.0

package/dist/createKiteChat-C67AkIPX.d.cts

@@ -0,0 +1,168 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+type Page = "dashboard" | "customers" | "payments" | "settings" | "support" | "disputes" | "radar";
+type SettingsTab = "general" | "billing" | "security" | "api" | "notifications" | "integrations";
+type NavigationTarget = {
+    page: Page;
+    subtab?: SettingsTab;
+};
+type ActionType = "updateCompanyInfo" | "addApiKey" | "addCustomer" | "enable2FA" | "disable2FA" | "changePassword" | "revokeSession" | "toggleNotification" | "connectIntegration" | "disconnectIntegration" | "addPaymentMethod" | "removePaymentMethod" | "deleteApiKey" | "addWebhook" | "updateCurrency" | "updateTimezone" | "refundPayment" | "createSubscription" | "exportCertificate" | "toggleBlockRule" | "enableBlockRule" | "disableBlockRule";
+type CompanyInfoData = {
+    companyName?: string;
+    email?: string;
+    address?: string;
+    phone?: string;
+    website?: string;
+};
+type ApiKeyData = {
+    name?: string;
+    keyId?: string;
+};
+type CustomerData = {
+    name?: string;
+    email?: string;
+    location?: string;
+    subscription?: "Starter" | "Professional" | "Enterprise";
+};
+type PasswordData = {
+    currentPassword?: string;
+    newPassword?: string;
+    confirmPassword?: string;
+};
+type NotificationData = {
+    notificationType?: "paymentReceived" | "paymentFailed" | "invoicePaid" | "monthlySummary" | "productUpdates";
+    enabled?: boolean;
+};
+type IntegrationData = {
+    integrationName?: "Slack" | "Zapier" | "Webhook";
+};
+type SessionData = {
+    sessionId?: string;
+    device?: string;
+};
+type PaymentMethodData = {
+    cardNumber?: string;
+    expiryDate?: string;
+};
+type WebhookData = {
+    url?: string;
+    name?: string;
+};
+type CurrencyData = {
+    currency?: "USD" | "EUR" | "GBP" | "JPY";
+};
+type TimezoneData = {
+    timezone?: "America/Los_Angeles" | "America/New_York" | "Europe/London" | "Asia/Tokyo";
+};
+type RefundData = {
+    transactionId?: string;
+    customer?: string;
+    amount?: string;
+    reason?: string;
+};
+type SubscriptionData = {
+    customerEmail?: string;
+    customerId?: string;
+    plan?: "Starter" | "Professional" | "Enterprise";
+    billingCycle?: "monthly" | "yearly";
+};
+type CertificateData = {
+    format?: "pdf" | "json";
+};
+type BlockRuleData = {
+    ruleId?: string;
+    ruleName?: string;
+    disabled?: boolean;
+};
+type ActionData = CompanyInfoData | ApiKeyData | CustomerData | PasswordData | NotificationData | IntegrationData | SessionData | PaymentMethodData | WebhookData | CurrencyData | TimezoneData | RefundData | SubscriptionData | CertificateData | BlockRuleData;
+
+interface ChatPanelProps {
+    onBack?: () => void;
+    onNavigate?: (page: Page, subtab?: SettingsTab) => void;
+    onActionComplete?: (actionType: ActionType, data: ActionData) => void;
+    currentPage?: Page;
+    agentUrl?: string;
+}
+declare function ChatPanel({ onBack, onNavigate, onActionComplete, currentPage, agentUrl }?: ChatPanelProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * @kite-copilot/chat-panel - Programmatic API
+ *
+ * Industry-standard SDK pattern for embedding the Kite chat widget.
+ * No globals, explicit lifecycle control, tree-shakeable.
+ *
+ * Usage:
+ * ```ts
+ * import { createKiteChat } from '@kite-copilot/chat-panel';
+ * import '@kite-copilot/chat-panel/style.css';
+ *
+ * const chat = createKiteChat({
+ *   userId: 'user-123',
+ *   orgId: 'org-456',
+ *   agentUrl: 'https://api.example.com',
+ *   onNavigate: (page) => router.push(`/${page}`),
+ * });
+ *
+ * chat.mount('#chat-container');
+ * chat.setCurrentPage('settings');
+ * chat.unmount();
+ * ```
+ */
+
+/**
+ * Configuration options for the Kite chat widget.
+ */
+interface KiteChatConfig {
+    /** Unique identifier for the current user */
+    userId: string;
+    /** Organization identifier */
+    orgId: string;
+    /** Backend agent API URL (defaults to http://localhost:5002) */
+    agentUrl?: string;
+    /** Current page context for the chat (e.g., 'dashboard', 'settings') */
+    currentPage?: string;
+    /** Theme mode */
+    theme?: 'light' | 'dark' | 'system';
+    /** Callback when the chat suggests navigation */
+    onNavigate?: (page: string, subtab?: string) => void;
+    /** Callback when an action is completed */
+    onActionComplete?: (actionType: ActionType, data: ActionData) => void;
+}
+/**
+ * Instance returned by createKiteChat with lifecycle control methods.
+ */
+interface KiteChatInstance {
+    /** Mount the chat widget into a container element */
+    mount: (container: string | HTMLElement) => void;
+    /** Unmount and clean up the chat widget */
+    unmount: () => void;
+    /** Update the current page context */
+    setCurrentPage: (page: string) => void;
+    /** Update configuration (userId, orgId, callbacks, etc.) */
+    updateConfig: (config: Partial<KiteChatConfig>) => void;
+    /** Check if the widget is currently mounted */
+    isMounted: () => boolean;
+}
+/**
+ * Create a new Kite chat widget instance.
+ *
+ * This is the primary API for embedding the chat widget.
+ * Returns an instance with explicit lifecycle control.
+ *
+ * @param config - Configuration options
+ * @returns KiteChatInstance with mount/unmount/update methods
+ *
+ * @example
+ * ```ts
+ * const chat = createKiteChat({
+ *   userId: 'user-123',
+ *   orgId: 'org-456',
+ *   onNavigate: (page) => router.push(`/${page}`)
+ * });
+ *
+ * chat.mount('#chat-container');
+ * ```
+ */
+declare function createKiteChat(config: KiteChatConfig): KiteChatInstance;
+
+export { type ActionType as A, ChatPanel as C, type KiteChatConfig as K, type NavigationTarget as N, type Page as P, type SettingsTab as S, type KiteChatInstance as a, type ChatPanelProps as b, createKiteChat as c, type ActionData as d };

package/dist/createKiteChat-C67AkIPX.d.ts

@@ -0,0 +1,168 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+type Page = "dashboard" | "customers" | "payments" | "settings" | "support" | "disputes" | "radar";
+type SettingsTab = "general" | "billing" | "security" | "api" | "notifications" | "integrations";
+type NavigationTarget = {
+    page: Page;
+    subtab?: SettingsTab;
+};
+type ActionType = "updateCompanyInfo" | "addApiKey" | "addCustomer" | "enable2FA" | "disable2FA" | "changePassword" | "revokeSession" | "toggleNotification" | "connectIntegration" | "disconnectIntegration" | "addPaymentMethod" | "removePaymentMethod" | "deleteApiKey" | "addWebhook" | "updateCurrency" | "updateTimezone" | "refundPayment" | "createSubscription" | "exportCertificate" | "toggleBlockRule" | "enableBlockRule" | "disableBlockRule";
+type CompanyInfoData = {
+    companyName?: string;
+    email?: string;
+    address?: string;
+    phone?: string;
+    website?: string;
+};
+type ApiKeyData = {
+    name?: string;
+    keyId?: string;
+};
+type CustomerData = {
+    name?: string;
+    email?: string;
+    location?: string;
+    subscription?: "Starter" | "Professional" | "Enterprise";
+};
+type PasswordData = {
+    currentPassword?: string;
+    newPassword?: string;
+    confirmPassword?: string;
+};
+type NotificationData = {
+    notificationType?: "paymentReceived" | "paymentFailed" | "invoicePaid" | "monthlySummary" | "productUpdates";
+    enabled?: boolean;
+};
+type IntegrationData = {
+    integrationName?: "Slack" | "Zapier" | "Webhook";
+};
+type SessionData = {
+    sessionId?: string;
+    device?: string;
+};
+type PaymentMethodData = {
+    cardNumber?: string;
+    expiryDate?: string;
+};
+type WebhookData = {
+    url?: string;
+    name?: string;
+};
+type CurrencyData = {
+    currency?: "USD" | "EUR" | "GBP" | "JPY";
+};
+type TimezoneData = {
+    timezone?: "America/Los_Angeles" | "America/New_York" | "Europe/London" | "Asia/Tokyo";
+};
+type RefundData = {
+    transactionId?: string;
+    customer?: string;
+    amount?: string;
+    reason?: string;
+};
+type SubscriptionData = {
+    customerEmail?: string;
+    customerId?: string;
+    plan?: "Starter" | "Professional" | "Enterprise";
+    billingCycle?: "monthly" | "yearly";
+};
+type CertificateData = {
+    format?: "pdf" | "json";
+};
+type BlockRuleData = {
+    ruleId?: string;
+    ruleName?: string;
+    disabled?: boolean;
+};
+type ActionData = CompanyInfoData | ApiKeyData | CustomerData | PasswordData | NotificationData | IntegrationData | SessionData | PaymentMethodData | WebhookData | CurrencyData | TimezoneData | RefundData | SubscriptionData | CertificateData | BlockRuleData;
+
+interface ChatPanelProps {
+    onBack?: () => void;
+    onNavigate?: (page: Page, subtab?: SettingsTab) => void;
+    onActionComplete?: (actionType: ActionType, data: ActionData) => void;
+    currentPage?: Page;
+    agentUrl?: string;
+}
+declare function ChatPanel({ onBack, onNavigate, onActionComplete, currentPage, agentUrl }?: ChatPanelProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * @kite-copilot/chat-panel - Programmatic API
+ *
+ * Industry-standard SDK pattern for embedding the Kite chat widget.
+ * No globals, explicit lifecycle control, tree-shakeable.
+ *
+ * Usage:
+ * ```ts
+ * import { createKiteChat } from '@kite-copilot/chat-panel';
+ * import '@kite-copilot/chat-panel/style.css';
+ *
+ * const chat = createKiteChat({
+ *   userId: 'user-123',
+ *   orgId: 'org-456',
+ *   agentUrl: 'https://api.example.com',
+ *   onNavigate: (page) => router.push(`/${page}`),
+ * });
+ *
+ * chat.mount('#chat-container');
+ * chat.setCurrentPage('settings');
+ * chat.unmount();
+ * ```
+ */
+
+/**
+ * Configuration options for the Kite chat widget.
+ */
+interface KiteChatConfig {
+    /** Unique identifier for the current user */
+    userId: string;
+    /** Organization identifier */
+    orgId: string;
+    /** Backend agent API URL (defaults to http://localhost:5002) */
+    agentUrl?: string;
+    /** Current page context for the chat (e.g., 'dashboard', 'settings') */
+    currentPage?: string;
+    /** Theme mode */
+    theme?: 'light' | 'dark' | 'system';
+    /** Callback when the chat suggests navigation */
+    onNavigate?: (page: string, subtab?: string) => void;
+    /** Callback when an action is completed */
+    onActionComplete?: (actionType: ActionType, data: ActionData) => void;
+}
+/**
+ * Instance returned by createKiteChat with lifecycle control methods.
+ */
+interface KiteChatInstance {
+    /** Mount the chat widget into a container element */
+    mount: (container: string | HTMLElement) => void;
+    /** Unmount and clean up the chat widget */
+    unmount: () => void;
+    /** Update the current page context */
+    setCurrentPage: (page: string) => void;
+    /** Update configuration (userId, orgId, callbacks, etc.) */
+    updateConfig: (config: Partial<KiteChatConfig>) => void;
+    /** Check if the widget is currently mounted */
+    isMounted: () => boolean;
+}
+/**
+ * Create a new Kite chat widget instance.
+ *
+ * This is the primary API for embedding the chat widget.
+ * Returns an instance with explicit lifecycle control.
+ *
+ * @param config - Configuration options
+ * @returns KiteChatInstance with mount/unmount/update methods
+ *
+ * @example
+ * ```ts
+ * const chat = createKiteChat({
+ *   userId: 'user-123',
+ *   orgId: 'org-456',
+ *   onNavigate: (page) => router.push(`/${page}`)
+ * });
+ *
+ * chat.mount('#chat-container');
+ * ```
+ */
+declare function createKiteChat(config: KiteChatConfig): KiteChatInstance;
+
+export { type ActionType as A, ChatPanel as C, type KiteChatConfig as K, type NavigationTarget as N, type Page as P, type SettingsTab as S, type KiteChatInstance as a, type ChatPanelProps as b, createKiteChat as c, type ActionData as d };