@howone/sdk 0.3.10 → 0.3.12

package/dist/index.d.mts

@@ -11,6 +11,118 @@ interface FloatingButtonProps {
 }
 declare const FloatingButton: React$1.FC<FloatingButtonProps>;
 
+interface RequestInterceptors<T = AxiosResponse> {
+    requestInterceptor?: (config: InternalAxiosRequestConfig) => InternalAxiosRequestConfig;
+    requestInterceptorCatch?: (error: any) => any;
+    responseInterceptor?: (res: T) => T;
+    responseInterceptorCatch?: (error: any) => any;
+}
+interface RequestConfig<T = AxiosResponse> extends AxiosRequestConfig {
+    interceptors?: RequestInterceptors<T>;
+    showLoading?: boolean;
+}
+
+declare class Request {
+    instance: AxiosInstance;
+    interceptors?: RequestInterceptors;
+    abortControllers: Map<string, AbortController>;
+    constructor(config: RequestConfig);
+    cancelRequest(url: string): void;
+    cancelAllRequests(): void;
+    request<T = any>(config: RequestConfig<T>): Promise<T>;
+    get<T = any>(config: RequestConfig<T>): Promise<T>;
+    post<T = any>(config: RequestConfig<T>): Promise<T>;
+    delete<T = any>(config: RequestConfig<T>): Promise<T>;
+    put<T = any>(config: RequestConfig<T>): Promise<T>;
+    patch<T = any>(config: RequestConfig<T>): Promise<T>;
+}
+
+/**
+ * AI 功能客户端
+ *
+ * 包含图片生成、修改等 AI 相关功能
+ */
+
+/**
+ * 图片生成/修改选项
+ */
+interface GenerateImageOptions {
+    imageUrl: string;
+    description: string;
+    signal?: AbortSignal;
+}
+/**
+ * 图片生成结果
+ */
+interface GenerateImageResponse {
+    imageUrl: string;
+    taskId?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * 创建 AI 客户端
+ */
+declare function createAIClient(req: Request, projectId?: string): {
+    /**
+     * 生成/修改图片
+     *
+     * @example
+     * ```typescript
+     * const result = await client.ai.generateImage({
+     *   imageUrl: 'https://example.com/image.jpg',
+     *   description: '把天空改成蓝色'
+     * })
+     * console.log('新图片:', result.imageUrl)
+     * ```
+     */
+    generateImage(options: GenerateImageOptions): Promise<GenerateImageResponse>;
+};
+
+/**
+ * 文件上传类型定义
+ *
+ * 独立的上传模块，不依赖 Artifact
+ */
+/**
+ * 上传选项
+ */
+interface UploadOptions {
+    onProgress?: (percent: number) => void;
+    signal?: AbortSignal;
+    metadata?: Record<string, any>;
+}
+/**
+ * 上传结果
+ */
+interface UploadResponse {
+    url: string;
+    thumbnailUrl?: string;
+    id?: string;
+    size?: number;
+    mimeType?: string;
+}
+/**
+ * 批量上传选项
+ */
+interface BatchUploadOptions {
+    files: (File | Blob)[];
+    concurrent?: number;
+    onProgress?: (completed: number, total: number) => void;
+    onFileComplete?: (result: UploadResponse | Error, index: number) => void;
+    signal?: AbortSignal;
+}
+/**
+ * 批量上传结果
+ */
+interface BatchUploadResponse {
+    success: UploadResponse[];
+    failed: Array<{
+        index: number;
+        error: string;
+    }>;
+    total: number;
+}
+
 /**
  * 统一的 SSE 工作流执行模块
  *
@@ -336,32 +448,6 @@ declare class AIWorkflowClient {
 declare function createAIWorkflowClient(options?: AIWorkflowClientOptions): AIWorkflowClient;
 declare const aiWorkflow: AIWorkflowClient;
 
-interface RequestInterceptors<T = AxiosResponse> {
-    requestInterceptor?: (config: InternalAxiosRequestConfig) => InternalAxiosRequestConfig;
-    requestInterceptorCatch?: (error: any) => any;
-    responseInterceptor?: (res: T) => T;
-    responseInterceptorCatch?: (error: any) => any;
-}
-interface RequestConfig<T = AxiosResponse> extends AxiosRequestConfig {
-    interceptors?: RequestInterceptors<T>;
-    showLoading?: boolean;
-}
-
-declare class Request {
-    instance: AxiosInstance;
-    interceptors?: RequestInterceptors;
-    abortControllers: Map<string, AbortController>;
-    constructor(config: RequestConfig);
-    cancelRequest(url: string): void;
-    cancelAllRequests(): void;
-    request<T = any>(config: RequestConfig<T>): Promise<T>;
-    get<T = any>(config: RequestConfig<T>): Promise<T>;
-    post<T = any>(config: RequestConfig<T>): Promise<T>;
-    delete<T = any>(config: RequestConfig<T>): Promise<T>;
-    put<T = any>(config: RequestConfig<T>): Promise<T>;
-    patch<T = any>(config: RequestConfig<T>): Promise<T>;
-}
-
 interface AxiosAIWorkflowOptions {
     baseUrl?: string;
     basePath?: string;
@@ -435,6 +521,51 @@ declare function createArtifactsClient(req: Request): {
     canAccessLocal(a: Artifact, ctx: AccessContext): boolean;
 };
 
+/**
+ * 文件上传客户端
+ *
+ * 独立的上传功能，不依赖其他模块
+ */
+
+declare function createUploadClient(req: Request, projectId?: string): {
+    /**
+     * 上传单个文件
+     *
+     * @example
+     * ```typescript
+     * const { url } = await client.upload.file(imageFile)
+     * console.log('文件地址:', url)
+     * ```
+     */
+    file(file: File | Blob | string, options?: UploadOptions): Promise<UploadResponse>;
+    /**
+     * 上传图片（快捷方法，专为 AI 设计）
+     *
+     * @example
+     * ```typescript
+     * const { url } = await client.upload.image(imageFile)
+     * ```
+     */
+    image(file: File | Blob | string): Promise<{
+        url: string;
+    }>;
+    /**
+     * 批量上传文件
+     *
+     * @example
+     * ```typescript
+     * const result = await client.upload.batch({
+     *   files: [file1, file2, file3],
+     *   concurrent: 3,
+     *   onProgress: (completed, total) => {
+     *     console.log(`${completed}/${total}`)
+     *   }
+     * })
+     * ```
+     */
+    batch(options: BatchUploadOptions): Promise<BatchUploadResponse>;
+};
+
 declare const AUTH_TOKEN_KEY = "auth_token";
 declare function setToken(token: string | null): void;
 declare function getToken(): string | null;
@@ -854,6 +985,49 @@ declare function createClient(opts: {
         setVisibility(id: string, visibility: string): Promise<void>;
         delete(id: string): Promise<void>;
     };
+    /**
+     * 文件上传模块（独立，不依赖 artifact）
+     *
+     * @example
+     * ```typescript
+     * // 最简单的用法
+     * const { url } = await client.upload.file(imageFile)
+     * console.log('文件地址:', url)
+     *
+     * // AI 友好版本（只返回 url）
+     * const { url } = await client.upload.image(imageFile)
+     *
+     * // 批量上传
+     * const result = await client.upload.batch({
+     *   files: [file1, file2, file3],
+     *   concurrent: 3,
+     *   onProgress: (completed, total) => console.log(`${completed}/${total}`)
+     * })
+     * ```
+     */
+    upload: {
+        file(file: File | Blob | string, options?: UploadOptions): Promise<UploadResponse>;
+        image(file: File | Blob | string): Promise<{
+            url: string;
+        }>;
+        batch(options: BatchUploadOptions): Promise<BatchUploadResponse>;
+    };
+    /**
+     * AI 功能模块
+     *
+     * @example
+     * ```typescript
+     * // 图片生成/修改
+     * const result = await client.ai.generateImage({
+     *   imageUrl: 'https://example.com/image.jpg',
+     *   description: '把天空改成蓝色'
+     * })
+     * console.log('新图片:', result.imageUrl)
+     * ```
+     */
+    ai: {
+        generateImage(options: GenerateImageOptions): Promise<GenerateImageResponse>;
+    };
     me: () => Promise<{
         id: {};
         email: string;
@@ -1200,4 +1374,4 @@ declare const elementSelector: {
     isActive: () => boolean;
 };
 
-export { type AIWorkflowClientOptions, type AIWorkflowResponse, AUTH_TOKEN_KEY, type AccessContext, type Artifact, type ArtifactCreateInput, type ArtifactListQuery, type AxiosAIWorkflowOptions, ClayxButton, ClayxToast, type CostUpdate, DefaultErrorFallback, type ElementSelectionData, ElementSelector, ElementSelectorProvider, type EmailLoginRequest, type EmailLoginResponse, type Environment, ErrorBoundary, type ExecutionResult, FloatingButton, GlobalToastContainer, HowOneProvider, type HowOneProviderProps, Loading, LoadingSpinner, LoginForm, type NodeExecution, type SSEClient, type SSEClientConfig, type SSEEventPayload, type SSEExecutionOptions, type SSERequest, type SSESession, type SSEStreamConfig, type SSEWorkflowOptions, type SSEWorkflowRequestInit, type SendCodeRequest, type SendCodeResponse, type SourceLocation, ThemeProvider, ThemeToggle, type UseElementSelectorReturn, type UseWorkflowStreamState, type Visibility, aiWorkflow, canAccessArtifact, createAIWorkflowClient, createAIWorkflowClientAxios, createArtifactsClient, createClient, createSSEClient, createSSERequest, elementSelector, type envs, executeSSEWorkflow, 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, useWorkflowStream };
+export { type AIWorkflowClientOptions, type AIWorkflowResponse, AUTH_TOKEN_KEY, type AccessContext, type Artifact, type ArtifactCreateInput, type ArtifactListQuery, type AxiosAIWorkflowOptions, type BatchUploadOptions, type BatchUploadResponse, ClayxButton, ClayxToast, type CostUpdate, DefaultErrorFallback, type ElementSelectionData, ElementSelector, ElementSelectorProvider, type EmailLoginRequest, type EmailLoginResponse, type Environment, ErrorBoundary, type ExecutionResult, FloatingButton, type GenerateImageOptions, type GenerateImageResponse, GlobalToastContainer, HowOneProvider, type HowOneProviderProps, Loading, LoadingSpinner, LoginForm, type NodeExecution, type SSEClient, type SSEClientConfig, type SSEEventPayload, type SSEExecutionOptions, type SSERequest, type SSESession, type SSEStreamConfig, type SSEWorkflowOptions, type SSEWorkflowRequestInit, type SendCodeRequest, type SendCodeResponse, type SourceLocation, ThemeProvider, ThemeToggle, type UploadOptions, type UploadResponse, type UseElementSelectorReturn, type UseWorkflowStreamState, type Visibility, aiWorkflow, canAccessArtifact, createAIClient, createAIWorkflowClient, createAIWorkflowClientAxios, createArtifactsClient, createClient, createSSEClient, createSSERequest, createUploadClient, elementSelector, type envs, executeSSEWorkflow, 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, useWorkflowStream };

package/dist/index.d.ts

@@ -11,6 +11,118 @@ interface FloatingButtonProps {
 }
 declare const FloatingButton: React$1.FC<FloatingButtonProps>;
 
+interface RequestInterceptors<T = AxiosResponse> {
+    requestInterceptor?: (config: InternalAxiosRequestConfig) => InternalAxiosRequestConfig;
+    requestInterceptorCatch?: (error: any) => any;
+    responseInterceptor?: (res: T) => T;
+    responseInterceptorCatch?: (error: any) => any;
+}
+interface RequestConfig<T = AxiosResponse> extends AxiosRequestConfig {
+    interceptors?: RequestInterceptors<T>;
+    showLoading?: boolean;
+}
+
+declare class Request {
+    instance: AxiosInstance;
+    interceptors?: RequestInterceptors;
+    abortControllers: Map<string, AbortController>;
+    constructor(config: RequestConfig);
+    cancelRequest(url: string): void;
+    cancelAllRequests(): void;
+    request<T = any>(config: RequestConfig<T>): Promise<T>;
+    get<T = any>(config: RequestConfig<T>): Promise<T>;
+    post<T = any>(config: RequestConfig<T>): Promise<T>;
+    delete<T = any>(config: RequestConfig<T>): Promise<T>;
+    put<T = any>(config: RequestConfig<T>): Promise<T>;
+    patch<T = any>(config: RequestConfig<T>): Promise<T>;
+}
+
+/**
+ * AI 功能客户端
+ *
+ * 包含图片生成、修改等 AI 相关功能
+ */
+
+/**
+ * 图片生成/修改选项
+ */
+interface GenerateImageOptions {
+    imageUrl: string;
+    description: string;
+    signal?: AbortSignal;
+}
+/**
+ * 图片生成结果
+ */
+interface GenerateImageResponse {
+    imageUrl: string;
+    taskId?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * 创建 AI 客户端
+ */
+declare function createAIClient(req: Request, projectId?: string): {
+    /**
+     * 生成/修改图片
+     *
+     * @example
+     * ```typescript
+     * const result = await client.ai.generateImage({
+     *   imageUrl: 'https://example.com/image.jpg',
+     *   description: '把天空改成蓝色'
+     * })
+     * console.log('新图片:', result.imageUrl)
+     * ```
+     */
+    generateImage(options: GenerateImageOptions): Promise<GenerateImageResponse>;
+};
+
+/**
+ * 文件上传类型定义
+ *
+ * 独立的上传模块，不依赖 Artifact
+ */
+/**
+ * 上传选项
+ */
+interface UploadOptions {
+    onProgress?: (percent: number) => void;
+    signal?: AbortSignal;
+    metadata?: Record<string, any>;
+}
+/**
+ * 上传结果
+ */
+interface UploadResponse {
+    url: string;
+    thumbnailUrl?: string;
+    id?: string;
+    size?: number;
+    mimeType?: string;
+}
+/**
+ * 批量上传选项
+ */
+interface BatchUploadOptions {
+    files: (File | Blob)[];
+    concurrent?: number;
+    onProgress?: (completed: number, total: number) => void;
+    onFileComplete?: (result: UploadResponse | Error, index: number) => void;
+    signal?: AbortSignal;
+}
+/**
+ * 批量上传结果
+ */
+interface BatchUploadResponse {
+    success: UploadResponse[];
+    failed: Array<{
+        index: number;
+        error: string;
+    }>;
+    total: number;
+}
+
 /**
  * 统一的 SSE 工作流执行模块
  *
@@ -336,32 +448,6 @@ declare class AIWorkflowClient {
 declare function createAIWorkflowClient(options?: AIWorkflowClientOptions): AIWorkflowClient;
 declare const aiWorkflow: AIWorkflowClient;
 
-interface RequestInterceptors<T = AxiosResponse> {
-    requestInterceptor?: (config: InternalAxiosRequestConfig) => InternalAxiosRequestConfig;
-    requestInterceptorCatch?: (error: any) => any;
-    responseInterceptor?: (res: T) => T;
-    responseInterceptorCatch?: (error: any) => any;
-}
-interface RequestConfig<T = AxiosResponse> extends AxiosRequestConfig {
-    interceptors?: RequestInterceptors<T>;
-    showLoading?: boolean;
-}
-
-declare class Request {
-    instance: AxiosInstance;
-    interceptors?: RequestInterceptors;
-    abortControllers: Map<string, AbortController>;
-    constructor(config: RequestConfig);
-    cancelRequest(url: string): void;
-    cancelAllRequests(): void;
-    request<T = any>(config: RequestConfig<T>): Promise<T>;
-    get<T = any>(config: RequestConfig<T>): Promise<T>;
-    post<T = any>(config: RequestConfig<T>): Promise<T>;
-    delete<T = any>(config: RequestConfig<T>): Promise<T>;
-    put<T = any>(config: RequestConfig<T>): Promise<T>;
-    patch<T = any>(config: RequestConfig<T>): Promise<T>;
-}
-
 interface AxiosAIWorkflowOptions {
     baseUrl?: string;
     basePath?: string;
@@ -435,6 +521,51 @@ declare function createArtifactsClient(req: Request): {
     canAccessLocal(a: Artifact, ctx: AccessContext): boolean;
 };
 
+/**
+ * 文件上传客户端
+ *
+ * 独立的上传功能，不依赖其他模块
+ */
+
+declare function createUploadClient(req: Request, projectId?: string): {
+    /**
+     * 上传单个文件
+     *
+     * @example
+     * ```typescript
+     * const { url } = await client.upload.file(imageFile)
+     * console.log('文件地址:', url)
+     * ```
+     */
+    file(file: File | Blob | string, options?: UploadOptions): Promise<UploadResponse>;
+    /**
+     * 上传图片（快捷方法，专为 AI 设计）
+     *
+     * @example
+     * ```typescript
+     * const { url } = await client.upload.image(imageFile)
+     * ```
+     */
+    image(file: File | Blob | string): Promise<{
+        url: string;
+    }>;
+    /**
+     * 批量上传文件
+     *
+     * @example
+     * ```typescript
+     * const result = await client.upload.batch({
+     *   files: [file1, file2, file3],
+     *   concurrent: 3,
+     *   onProgress: (completed, total) => {
+     *     console.log(`${completed}/${total}`)
+     *   }
+     * })
+     * ```
+     */
+    batch(options: BatchUploadOptions): Promise<BatchUploadResponse>;
+};
+
 declare const AUTH_TOKEN_KEY = "auth_token";
 declare function setToken(token: string | null): void;
 declare function getToken(): string | null;
@@ -854,6 +985,49 @@ declare function createClient(opts: {
         setVisibility(id: string, visibility: string): Promise<void>;
         delete(id: string): Promise<void>;
     };
+    /**
+     * 文件上传模块（独立，不依赖 artifact）
+     *
+     * @example
+     * ```typescript
+     * // 最简单的用法
+     * const { url } = await client.upload.file(imageFile)
+     * console.log('文件地址:', url)
+     *
+     * // AI 友好版本（只返回 url）
+     * const { url } = await client.upload.image(imageFile)
+     *
+     * // 批量上传
+     * const result = await client.upload.batch({
+     *   files: [file1, file2, file3],
+     *   concurrent: 3,
+     *   onProgress: (completed, total) => console.log(`${completed}/${total}`)
+     * })
+     * ```
+     */
+    upload: {
+        file(file: File | Blob | string, options?: UploadOptions): Promise<UploadResponse>;
+        image(file: File | Blob | string): Promise<{
+            url: string;
+        }>;
+        batch(options: BatchUploadOptions): Promise<BatchUploadResponse>;
+    };
+    /**
+     * AI 功能模块
+     *
+     * @example
+     * ```typescript
+     * // 图片生成/修改
+     * const result = await client.ai.generateImage({
+     *   imageUrl: 'https://example.com/image.jpg',
+     *   description: '把天空改成蓝色'
+     * })
+     * console.log('新图片:', result.imageUrl)
+     * ```
+     */
+    ai: {
+        generateImage(options: GenerateImageOptions): Promise<GenerateImageResponse>;
+    };
     me: () => Promise<{
         id: {};
         email: string;
@@ -1200,4 +1374,4 @@ declare const elementSelector: {
     isActive: () => boolean;
 };
 
-export { type AIWorkflowClientOptions, type AIWorkflowResponse, AUTH_TOKEN_KEY, type AccessContext, type Artifact, type ArtifactCreateInput, type ArtifactListQuery, type AxiosAIWorkflowOptions, ClayxButton, ClayxToast, type CostUpdate, DefaultErrorFallback, type ElementSelectionData, ElementSelector, ElementSelectorProvider, type EmailLoginRequest, type EmailLoginResponse, type Environment, ErrorBoundary, type ExecutionResult, FloatingButton, GlobalToastContainer, HowOneProvider, type HowOneProviderProps, Loading, LoadingSpinner, LoginForm, type NodeExecution, type SSEClient, type SSEClientConfig, type SSEEventPayload, type SSEExecutionOptions, type SSERequest, type SSESession, type SSEStreamConfig, type SSEWorkflowOptions, type SSEWorkflowRequestInit, type SendCodeRequest, type SendCodeResponse, type SourceLocation, ThemeProvider, ThemeToggle, type UseElementSelectorReturn, type UseWorkflowStreamState, type Visibility, aiWorkflow, canAccessArtifact, createAIWorkflowClient, createAIWorkflowClientAxios, createArtifactsClient, createClient, createSSEClient, createSSERequest, elementSelector, type envs, executeSSEWorkflow, 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, useWorkflowStream };
+export { type AIWorkflowClientOptions, type AIWorkflowResponse, AUTH_TOKEN_KEY, type AccessContext, type Artifact, type ArtifactCreateInput, type ArtifactListQuery, type AxiosAIWorkflowOptions, type BatchUploadOptions, type BatchUploadResponse, ClayxButton, ClayxToast, type CostUpdate, DefaultErrorFallback, type ElementSelectionData, ElementSelector, ElementSelectorProvider, type EmailLoginRequest, type EmailLoginResponse, type Environment, ErrorBoundary, type ExecutionResult, FloatingButton, type GenerateImageOptions, type GenerateImageResponse, GlobalToastContainer, HowOneProvider, type HowOneProviderProps, Loading, LoadingSpinner, LoginForm, type NodeExecution, type SSEClient, type SSEClientConfig, type SSEEventPayload, type SSEExecutionOptions, type SSERequest, type SSESession, type SSEStreamConfig, type SSEWorkflowOptions, type SSEWorkflowRequestInit, type SendCodeRequest, type SendCodeResponse, type SourceLocation, ThemeProvider, ThemeToggle, type UploadOptions, type UploadResponse, type UseElementSelectorReturn, type UseWorkflowStreamState, type Visibility, aiWorkflow, canAccessArtifact, createAIClient, createAIWorkflowClient, createAIWorkflowClientAxios, createArtifactsClient, createClient, createSSEClient, createSSERequest, createUploadClient, elementSelector, type envs, executeSSEWorkflow, 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, useWorkflowStream };