@howone/sdk 0.1.28 → 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>;
 }
@@ -920,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 ElementSelectionData, ElementSelector, ElementSelectorProvider, 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, type SourceLocation, ThemeProvider, ThemeToggle, type UseElementSelectorReturn, type UserInteraction, type ViewInfo, type Visibility, aiRequest, aiWorkflow, canAccessArtifact, createAIWorkflowClient, createAIWorkflowClientAxios, createArtifactsClient, createClient, getAuthRoot, getCodeStatus, getDefaultProjectId, getToken, howone, isTokenValid, loginWithEmailCode, onAuthStateChanged, parseUserFromToken, request, sendElementSelectionToParent, sendEmailVerificationCode, setAuthRoot, setDefaultProjectId, setToken, unifiedAuth, unifiedOAuth, useAuth, useDebounce, useElementSelector, 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>;
 }
@@ -920,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 ElementSelectionData, ElementSelector, ElementSelectorProvider, 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, type SourceLocation, ThemeProvider, ThemeToggle, type UseElementSelectorReturn, type UserInteraction, type ViewInfo, type Visibility, aiRequest, aiWorkflow, canAccessArtifact, createAIWorkflowClient, createAIWorkflowClientAxios, createArtifactsClient, createClient, getAuthRoot, getCodeStatus, getDefaultProjectId, getToken, howone, isTokenValid, loginWithEmailCode, onAuthStateChanged, parseUserFromToken, request, sendElementSelectionToParent, sendEmailVerificationCode, setAuthRoot, setDefaultProjectId, setToken, unifiedAuth, unifiedOAuth, useAuth, useDebounce, useElementSelector, 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 };