@howone/sdk 0.1.27 → 0.2.0

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import React$1, { Component, ReactNode } from 'react';
 import * as axios from 'axios';
-import { AxiosResponse, InternalAxiosRequestConfig, AxiosRequestConfig, AxiosInstance } from 'axios';
+import { AxiosResponse, AxiosRequestConfig, InternalAxiosRequestConfig, AxiosInstance } from 'axios';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ToastOptions } from 'react-toastify';
 
@@ -185,6 +185,7 @@ declare function getCodeStatus(email: string): Promise<any>;
  */
 interface AIWorkflowResponse {
     success: boolean;
+    status?: number;
     output?: Record<string, unknown>;
     error?: string;
     metadata?: Record<string, unknown>;
@@ -207,7 +208,7 @@ declare class AIWorkflowClient {
      * 按 ID 执行工作流：POST {baseUrl}/workflow/{workflowId}/execute
      * body: { input, options }
      */
-    executeWorkflow(workflowId: string, inputs: Record<string, unknown>, options?: Record<string, unknown>): Promise<AIWorkflowResponse>;
+    executeWorkflow(workflowId: string, inputs: Record<string, unknown>, options?: Record<string, unknown>): Promise<AIWorkflowResponse | null>;
 }
 declare function createAIWorkflowClient(options?: AIWorkflowClientOptions): AIWorkflowClient;
 declare const aiWorkflow: AIWorkflowClient;
@@ -338,29 +339,28 @@ type AuthState$1 = {
 };
 declare function onAuthStateChanged(cb: (state: AuthState$1) => void): () => void;
 
-declare function setAuthRoot(url: string): void;
-declare function getAuthRoot(): string;
-declare const AUTH_ROOT: string;
+type Environment = 'local' | 'dev' | 'prod';
+type envs = {
+    AUTH_ROOT_VALUE: string;
+    baseUrl: string;
+    aiBaseUrl: string;
+};
+declare function setEnvironment(e: Environment): envs;
+declare function getEnvironment(): Environment;
+declare function getEnvs(): envs;
 declare function setDefaultProjectId(id: string | null): void;
 declare function getDefaultProjectId(): string | null;
+declare function getGlobalEnvironment(): Environment | null;
 
-declare const request: Request;
-declare const aiRequest: Request;
-declare const workflowRequest: Request;
-/**
- * 简单工厂：返回一个对外友好的 client，封装业务 request 与 AI workflow request。
- * 默认使用上面导出的 `request` 和 `aiRequest`，也可以通过 options 覆盖。
- */
 /**
  * Higher-level factory: createClient
  * - minimal surface compatible with `createClient({ projectId, authRequired })`
  * - returns executeWorkflow, request, aiRequest and a tiny auth helper (set/get token)
  */
-declare function createClient(opts?: {
-    projectId?: string;
+declare function createClient(opts: {
+    projectId: string;
+    env?: 'local' | 'dev' | 'prod';
     authRequired?: boolean;
-    baseUrl?: string;
-    aiBaseUrl?: string;
     mode?: "auto" | "standalone" | "embedded";
     auth?: {
         mode?: "none" | "managed" | "headless";
@@ -373,10 +373,8 @@ declare function createClient(opts?: {
             sensitiveParams?: string[];
         };
     };
-    requestInstance?: Request;
-    aiRequestInstance?: Request;
 }): {
-    projectId: string | null;
+    projectId: string;
     request: {
         instance: axios.AxiosInstance;
         request: (config: RequestConfig) => Promise<AxiosResponse<any, any>>;
@@ -536,6 +534,18 @@ interface ErrorFallbackProps {
 }
 declare const DefaultErrorFallback: React$1.FC<ErrorFallbackProps>;
 
+type ButtonSize = "sm" | "md" | "lg";
+type ButtonVariant = "solid" | "ghost" | "flat";
+interface ClayxButtonProps extends React$1.ButtonHTMLAttributes<HTMLButtonElement> {
+    isIconOnly?: boolean;
+    size?: ButtonSize;
+    variant?: ButtonVariant;
+    children?: React$1.ReactNode;
+}
+declare const ClayxButton: React$1.FC<ClayxButtonProps>;
+
+declare function showLimitUpgradeToast(message: string, onUpgrade: () => void): void;
+
 type Theme = "dark" | "light" | "system";
 type ThemeProviderProps = {
     children: React.ReactNode;
@@ -564,6 +574,7 @@ declare function GlobalToastContainer(): react_jsx_runtime.JSX.Element;
 interface ToastParams {
     title?: string;
     message?: string;
+    render?: (closeToast: () => void) => React$1.ReactNode;
     component?: React$1.ReactNode;
     options?: Partial<ToastOptions>;
 }
@@ -575,10 +586,63 @@ declare const ClayxToast: {
     default: (params: ToastParams) => void;
 };
 
+interface SourceLocation {
+    file: string;
+    line: number;
+    component: string;
+}
+interface ElementSelectionData {
+    sourceLocation: SourceLocation | null;
+    element: {
+        tagName: string;
+        className: string;
+        id: string;
+        text: string;
+    };
+    rect: {
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+    };
+}
+interface ElementSelectorProps {
+    active: boolean;
+    onSelect?: (data: ElementSelectionData) => void;
+    onCancel?: () => void;
+}
+declare const ElementSelector: React$1.FC<ElementSelectorProps>;
+
+interface ElementSelectorProviderProps {
+    children: React$1.ReactNode;
+}
+/**
+ * 元素选择器提供者组件
+ * 监听来自 iframe.js 的自定义事件，自动显示/隐藏元素选择器
+ */
+declare const ElementSelectorProvider: React$1.FC<ElementSelectorProviderProps>;
+
 declare function useIsMobile(): boolean;
 
 declare function useDebounce<T>(value: T, delay: number): T;
 
+interface UseElementSelectorReturn {
+    isSelecting: boolean;
+    selectedElement: ElementSelectionData | null;
+    startSelecting: () => void;
+    stopSelecting: () => void;
+    clearSelection: () => void;
+}
+/**
+ * 元素选择器 Hook
+ * 用于管理元素选择状态和向父窗口发送消息
+ */
+declare function useElementSelector(): UseElementSelectorReturn;
+/**
+ * 向父窗口发送元素选择数据
+ */
+declare function sendElementSelectionToParent(data: ElementSelectionData): void;
+
 /**
  * 错误处理模块 - 核心类型定义
  *
@@ -867,4 +931,74 @@ declare class SimpleErrorHandler {
     captureError(error: Error, details?: any): void;
 }
 
-export { type AIWorkflowClientOptions, type AIWorkflowResponse, AUTH_ROOT, AUTH_TOKEN_KEY, type AccessContext, type Artifact, type ArtifactCreateInput, type ArtifactListQuery, type AxiosAIWorkflowOptions, ClayxToast, DEFAULT_SELECTOR_CONFIG, DefaultErrorFallback, ERROR_CONFIG, type EmailLoginRequest, type EmailLoginResponse, type EnhancedErrorConfig, ErrorBoundary, ErrorHandler, type ErrorPayload, type ErrorSeverity, type ErrorStats, type ErrorType, FloatingButton, GLOBAL_CONFIG, GlobalToastContainer, HowOneProvider, type HowOneProviderProps, Loading, LoadingSpinner, LoginForm, type MessageType, type SelectorState, type SendCodeRequest, type SendCodeResponse, type SimpleErrorConfig, SimpleErrorHandler, ThemeProvider, ThemeToggle, type UserInteraction, type ViewInfo, type Visibility, aiRequest, aiWorkflow, canAccessArtifact, createAIWorkflowClient, createAIWorkflowClientAxios, createArtifactsClient, createClient, getAuthRoot, getCodeStatus, getDefaultProjectId, getToken, howone, isTokenValid, loginWithEmailCode, onAuthStateChanged, parseUserFromToken, request, sendEmailVerificationCode, setAuthRoot, setDefaultProjectId, setToken, unifiedAuth, unifiedOAuth, useAuth, useDebounce, useHowoneContext, useIsMobile, useTheme, workflowRequest };
+/**
+ * iframe navigation and element selector utilities
+ * Replaces the standalone iframe.js script
+ */
+declare function customGoBack(): boolean;
+declare function customGoForward(): boolean;
+declare function triggerElementSelection(): void;
+declare function cancelElementSelection(): void;
+/**
+ * Initialize iframe navigation system
+ * Call this once when your app starts
+ */
+declare function initIframeNavigation(): void;
+/**
+ * Public API for iframe navigation
+ */
+declare const iframeNavigation: {
+    /**
+     * Initialize the navigation system
+     */
+    init: typeof initIframeNavigation;
+    /**
+     * Add a page to navigation history
+     */
+    addPage: (url?: string, title?: string) => void;
+    /**
+     * Get current navigation state
+     */
+    getState: () => {
+        canGoBack: boolean;
+        canGoForward: boolean;
+        historyLength: number;
+        currentIndex: number;
+        currentPage: {
+            url: string;
+            title: string;
+            timestamp: number;
+        };
+    };
+    /**
+     * Update navigation state (send to parent)
+     */
+    updateState: () => void;
+    /**
+     * Go back in history
+     */
+    goBack: typeof customGoBack;
+    /**
+     * Go forward in history
+     */
+    goForward: typeof customGoForward;
+};
+/**
+ * Public API for element selector
+ */
+declare const elementSelector: {
+    /**
+     * Start element selection mode
+     */
+    startSelection: typeof triggerElementSelection;
+    /**
+     * Cancel element selection mode
+     */
+    cancel: typeof cancelElementSelection;
+    /**
+     * Check if selector is active
+     */
+    isActive: () => boolean;
+};
+
+export { type AIWorkflowClientOptions, type AIWorkflowResponse, AUTH_TOKEN_KEY, type AccessContext, type Artifact, type ArtifactCreateInput, type ArtifactListQuery, type AxiosAIWorkflowOptions, ClayxButton, ClayxToast, DEFAULT_SELECTOR_CONFIG, DefaultErrorFallback, ERROR_CONFIG, type ElementSelectionData, ElementSelector, ElementSelectorProvider, type EmailLoginRequest, type EmailLoginResponse, type EnhancedErrorConfig, type Environment, ErrorBoundary, ErrorHandler, type ErrorPayload, type ErrorSeverity, type ErrorStats, type ErrorType, FloatingButton, GLOBAL_CONFIG, GlobalToastContainer, HowOneProvider, type HowOneProviderProps, Loading, LoadingSpinner, LoginForm, type MessageType, type SelectorState, type SendCodeRequest, type SendCodeResponse, type SimpleErrorConfig, SimpleErrorHandler, type SourceLocation, ThemeProvider, ThemeToggle, type UseElementSelectorReturn, type UserInteraction, type ViewInfo, type Visibility, aiWorkflow, canAccessArtifact, createAIWorkflowClient, createAIWorkflowClientAxios, createArtifactsClient, createClient, elementSelector, type envs, getCodeStatus, getDefaultProjectId, getEnvironment, getEnvs, getGlobalEnvironment, getToken, howone, iframeNavigation, initIframeNavigation, isTokenValid, loginWithEmailCode, onAuthStateChanged, parseUserFromToken, sendElementSelectionToParent, sendEmailVerificationCode, setDefaultProjectId, setEnvironment, setToken, showLimitUpgradeToast, unifiedAuth, unifiedOAuth, useAuth, useDebounce, useElementSelector, useHowoneContext, useIsMobile, useTheme };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import React$1, { Component, ReactNode } from 'react';
 import * as axios from 'axios';
-import { AxiosResponse, InternalAxiosRequestConfig, AxiosRequestConfig, AxiosInstance } from 'axios';
+import { AxiosResponse, AxiosRequestConfig, InternalAxiosRequestConfig, AxiosInstance } from 'axios';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ToastOptions } from 'react-toastify';
 
@@ -185,6 +185,7 @@ declare function getCodeStatus(email: string): Promise<any>;
  */
 interface AIWorkflowResponse {
     success: boolean;
+    status?: number;
     output?: Record<string, unknown>;
     error?: string;
     metadata?: Record<string, unknown>;
@@ -207,7 +208,7 @@ declare class AIWorkflowClient {
      * 按 ID 执行工作流：POST {baseUrl}/workflow/{workflowId}/execute
      * body: { input, options }
      */
-    executeWorkflow(workflowId: string, inputs: Record<string, unknown>, options?: Record<string, unknown>): Promise<AIWorkflowResponse>;
+    executeWorkflow(workflowId: string, inputs: Record<string, unknown>, options?: Record<string, unknown>): Promise<AIWorkflowResponse | null>;
 }
 declare function createAIWorkflowClient(options?: AIWorkflowClientOptions): AIWorkflowClient;
 declare const aiWorkflow: AIWorkflowClient;
@@ -338,29 +339,28 @@ type AuthState$1 = {
 };
 declare function onAuthStateChanged(cb: (state: AuthState$1) => void): () => void;
 
-declare function setAuthRoot(url: string): void;
-declare function getAuthRoot(): string;
-declare const AUTH_ROOT: string;
+type Environment = 'local' | 'dev' | 'prod';
+type envs = {
+    AUTH_ROOT_VALUE: string;
+    baseUrl: string;
+    aiBaseUrl: string;
+};
+declare function setEnvironment(e: Environment): envs;
+declare function getEnvironment(): Environment;
+declare function getEnvs(): envs;
 declare function setDefaultProjectId(id: string | null): void;
 declare function getDefaultProjectId(): string | null;
+declare function getGlobalEnvironment(): Environment | null;
 
-declare const request: Request;
-declare const aiRequest: Request;
-declare const workflowRequest: Request;
-/**
- * 简单工厂：返回一个对外友好的 client，封装业务 request 与 AI workflow request。
- * 默认使用上面导出的 `request` 和 `aiRequest`，也可以通过 options 覆盖。
- */
 /**
  * Higher-level factory: createClient
  * - minimal surface compatible with `createClient({ projectId, authRequired })`
  * - returns executeWorkflow, request, aiRequest and a tiny auth helper (set/get token)
  */
-declare function createClient(opts?: {
-    projectId?: string;
+declare function createClient(opts: {
+    projectId: string;
+    env?: 'local' | 'dev' | 'prod';
     authRequired?: boolean;
-    baseUrl?: string;
-    aiBaseUrl?: string;
     mode?: "auto" | "standalone" | "embedded";
     auth?: {
         mode?: "none" | "managed" | "headless";
@@ -373,10 +373,8 @@ declare function createClient(opts?: {
             sensitiveParams?: string[];
         };
     };
-    requestInstance?: Request;
-    aiRequestInstance?: Request;
 }): {
-    projectId: string | null;
+    projectId: string;
     request: {
         instance: axios.AxiosInstance;
         request: (config: RequestConfig) => Promise<AxiosResponse<any, any>>;
@@ -536,6 +534,18 @@ interface ErrorFallbackProps {
 }
 declare const DefaultErrorFallback: React$1.FC<ErrorFallbackProps>;
 
+type ButtonSize = "sm" | "md" | "lg";
+type ButtonVariant = "solid" | "ghost" | "flat";
+interface ClayxButtonProps extends React$1.ButtonHTMLAttributes<HTMLButtonElement> {
+    isIconOnly?: boolean;
+    size?: ButtonSize;
+    variant?: ButtonVariant;
+    children?: React$1.ReactNode;
+}
+declare const ClayxButton: React$1.FC<ClayxButtonProps>;
+
+declare function showLimitUpgradeToast(message: string, onUpgrade: () => void): void;
+
 type Theme = "dark" | "light" | "system";
 type ThemeProviderProps = {
     children: React.ReactNode;
@@ -564,6 +574,7 @@ declare function GlobalToastContainer(): react_jsx_runtime.JSX.Element;
 interface ToastParams {
     title?: string;
     message?: string;
+    render?: (closeToast: () => void) => React$1.ReactNode;
     component?: React$1.ReactNode;
     options?: Partial<ToastOptions>;
 }
@@ -575,10 +586,63 @@ declare const ClayxToast: {
     default: (params: ToastParams) => void;
 };
 
+interface SourceLocation {
+    file: string;
+    line: number;
+    component: string;
+}
+interface ElementSelectionData {
+    sourceLocation: SourceLocation | null;
+    element: {
+        tagName: string;
+        className: string;
+        id: string;
+        text: string;
+    };
+    rect: {
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+    };
+}
+interface ElementSelectorProps {
+    active: boolean;
+    onSelect?: (data: ElementSelectionData) => void;
+    onCancel?: () => void;
+}
+declare const ElementSelector: React$1.FC<ElementSelectorProps>;
+
+interface ElementSelectorProviderProps {
+    children: React$1.ReactNode;
+}
+/**
+ * 元素选择器提供者组件
+ * 监听来自 iframe.js 的自定义事件，自动显示/隐藏元素选择器
+ */
+declare const ElementSelectorProvider: React$1.FC<ElementSelectorProviderProps>;
+
 declare function useIsMobile(): boolean;
 
 declare function useDebounce<T>(value: T, delay: number): T;
 
+interface UseElementSelectorReturn {
+    isSelecting: boolean;
+    selectedElement: ElementSelectionData | null;
+    startSelecting: () => void;
+    stopSelecting: () => void;
+    clearSelection: () => void;
+}
+/**
+ * 元素选择器 Hook
+ * 用于管理元素选择状态和向父窗口发送消息
+ */
+declare function useElementSelector(): UseElementSelectorReturn;
+/**
+ * 向父窗口发送元素选择数据
+ */
+declare function sendElementSelectionToParent(data: ElementSelectionData): void;
+
 /**
  * 错误处理模块 - 核心类型定义
  *
@@ -867,4 +931,74 @@ declare class SimpleErrorHandler {
     captureError(error: Error, details?: any): void;
 }
 
-export { type AIWorkflowClientOptions, type AIWorkflowResponse, AUTH_ROOT, AUTH_TOKEN_KEY, type AccessContext, type Artifact, type ArtifactCreateInput, type ArtifactListQuery, type AxiosAIWorkflowOptions, ClayxToast, DEFAULT_SELECTOR_CONFIG, DefaultErrorFallback, ERROR_CONFIG, type EmailLoginRequest, type EmailLoginResponse, type EnhancedErrorConfig, ErrorBoundary, ErrorHandler, type ErrorPayload, type ErrorSeverity, type ErrorStats, type ErrorType, FloatingButton, GLOBAL_CONFIG, GlobalToastContainer, HowOneProvider, type HowOneProviderProps, Loading, LoadingSpinner, LoginForm, type MessageType, type SelectorState, type SendCodeRequest, type SendCodeResponse, type SimpleErrorConfig, SimpleErrorHandler, ThemeProvider, ThemeToggle, type UserInteraction, type ViewInfo, type Visibility, aiRequest, aiWorkflow, canAccessArtifact, createAIWorkflowClient, createAIWorkflowClientAxios, createArtifactsClient, createClient, getAuthRoot, getCodeStatus, getDefaultProjectId, getToken, howone, isTokenValid, loginWithEmailCode, onAuthStateChanged, parseUserFromToken, request, sendEmailVerificationCode, setAuthRoot, setDefaultProjectId, setToken, unifiedAuth, unifiedOAuth, useAuth, useDebounce, useHowoneContext, useIsMobile, useTheme, workflowRequest };
+/**
+ * iframe navigation and element selector utilities
+ * Replaces the standalone iframe.js script
+ */
+declare function customGoBack(): boolean;
+declare function customGoForward(): boolean;
+declare function triggerElementSelection(): void;
+declare function cancelElementSelection(): void;
+/**
+ * Initialize iframe navigation system
+ * Call this once when your app starts
+ */
+declare function initIframeNavigation(): void;
+/**
+ * Public API for iframe navigation
+ */
+declare const iframeNavigation: {
+    /**
+     * Initialize the navigation system
+     */
+    init: typeof initIframeNavigation;
+    /**
+     * Add a page to navigation history
+     */
+    addPage: (url?: string, title?: string) => void;
+    /**
+     * Get current navigation state
+     */
+    getState: () => {
+        canGoBack: boolean;
+        canGoForward: boolean;
+        historyLength: number;
+        currentIndex: number;
+        currentPage: {
+            url: string;
+            title: string;
+            timestamp: number;
+        };
+    };
+    /**
+     * Update navigation state (send to parent)
+     */
+    updateState: () => void;
+    /**
+     * Go back in history
+     */
+    goBack: typeof customGoBack;
+    /**
+     * Go forward in history
+     */
+    goForward: typeof customGoForward;
+};
+/**
+ * Public API for element selector
+ */
+declare const elementSelector: {
+    /**
+     * Start element selection mode
+     */
+    startSelection: typeof triggerElementSelection;
+    /**
+     * Cancel element selection mode
+     */
+    cancel: typeof cancelElementSelection;
+    /**
+     * Check if selector is active
+     */
+    isActive: () => boolean;
+};
+
+export { type AIWorkflowClientOptions, type AIWorkflowResponse, AUTH_TOKEN_KEY, type AccessContext, type Artifact, type ArtifactCreateInput, type ArtifactListQuery, type AxiosAIWorkflowOptions, ClayxButton, ClayxToast, DEFAULT_SELECTOR_CONFIG, DefaultErrorFallback, ERROR_CONFIG, type ElementSelectionData, ElementSelector, ElementSelectorProvider, type EmailLoginRequest, type EmailLoginResponse, type EnhancedErrorConfig, type Environment, ErrorBoundary, ErrorHandler, type ErrorPayload, type ErrorSeverity, type ErrorStats, type ErrorType, FloatingButton, GLOBAL_CONFIG, GlobalToastContainer, HowOneProvider, type HowOneProviderProps, Loading, LoadingSpinner, LoginForm, type MessageType, type SelectorState, type SendCodeRequest, type SendCodeResponse, type SimpleErrorConfig, SimpleErrorHandler, type SourceLocation, ThemeProvider, ThemeToggle, type UseElementSelectorReturn, type UserInteraction, type ViewInfo, type Visibility, aiWorkflow, canAccessArtifact, createAIWorkflowClient, createAIWorkflowClientAxios, createArtifactsClient, createClient, elementSelector, type envs, getCodeStatus, getDefaultProjectId, getEnvironment, getEnvs, getGlobalEnvironment, getToken, howone, iframeNavigation, initIframeNavigation, isTokenValid, loginWithEmailCode, onAuthStateChanged, parseUserFromToken, sendElementSelectionToParent, sendEmailVerificationCode, setDefaultProjectId, setEnvironment, setToken, showLimitUpgradeToast, unifiedAuth, unifiedOAuth, useAuth, useDebounce, useElementSelector, useHowoneContext, useIsMobile, useTheme };