@openloaf-saas/sdk 0.1.35 → 0.1.38

package/dist/index.d.ts

@@ -757,6 +757,7 @@ declare class SaaSContract {
             inputs?: Record<string, unknown> | undefined;
             params?: Record<string, unknown> | undefined;
             count?: number | undefined;
+            stream?: boolean | undefined;
         }, {
             success: true;
             data: {
@@ -1277,6 +1278,8 @@ type BaseSaaSClientOptions<TContract> = {
     fetcher?: typeof fetch;
     headers?: HeaderInput;
     contract: TContract;
+    /** Default locale for APIs that support i18n (e.g. "zh-CN", "en-US"). */
+    locale?: string;
 };
 declare class BaseSaaSClient<TContract> {
     /** Contract definitions used by the client. */
@@ -1289,6 +1292,8 @@ declare class BaseSaaSClient<TContract> {
     private readonly fetcher;
     /** Static headers injected into every request. */
     private readonly headers?;
+    /** Default locale for i18n-aware APIs. */
+    private locale?;
     /** Create a base client instance. */
     constructor(options: BaseSaaSClientOptions<TContract>);
     /** Send a typed request to the SaaS server. */
@@ -1301,6 +1306,10 @@ declare class BaseSaaSClient<TContract> {
     buildAuthHeader(): Promise<Record<string, string>>;
     /** Return the configured base URL. */
     getBaseUrl(): string;
+    /** Return the configured default locale. */
+    getLocale(): string | undefined;
+    /** Update the default locale at runtime. */
+    setLocale(locale: string | undefined): void;
 }
 
 /** Request function signature shared by SDK clients. */
@@ -1319,6 +1328,8 @@ type SdkHost<TContract> = {
     getBaseUrl: () => string;
     /** Build Authorization header for authenticated calls. */
     buildAuthHeader: () => Promise<Record<string, string>>;
+    /** Resolve the configured default locale (e.g. "zh-CN"). */
+    getLocale: () => string | undefined;
 };
 
 declare const aiEndpoints: {
@@ -2045,6 +2056,7 @@ declare const aiEndpoints: {
         inputs?: Record<string, unknown> | undefined;
         params?: Record<string, unknown> | undefined;
         count?: number | undefined;
+        stream?: boolean | undefined;
     }, {
         success: true;
         data: {
@@ -3709,6 +3721,7 @@ declare const v3GenerateRequestSchema: z.ZodObject<{
     inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     count: z.ZodOptional<z.ZodNumber>;
+    stream: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 /** v3 text generate request body. */
 declare const v3TextGenerateRequestSchema: z.ZodObject<{
@@ -4676,6 +4689,13 @@ declare class AiClient {
             taskIds: string[];
         };
     }>;
+    /**
+     * Submit a v3 generate request in streaming mode.
+     * 返回原始 Response，调用方通过 response.body (ReadableStream) 消费 SSE 事件。
+     * 每个 SSE event 的 data 字段是 OpenAI chat completions chunk 格式。
+     * taskId 通过响应头 x-task-id 返回。
+     */
+    v3GenerateStream(payload: Omit<V3GenerateRequest, "stream" | "count">): Promise<Response>;
     /** Get v3 task details by ID. */
     v3Task(taskId: string): Promise<{
         success: true;
@@ -7113,6 +7133,8 @@ declare class SkillMarketClient {
     constructor(sdk: SkillMarketSdkHost);
     /** Build URL query string from params (skip undefined/null values). */
     private buildQuery;
+    /** Resolve effective lang: explicit param > global locale > undefined (server default). */
+    private resolveLang;
     /**
      * List marketplace skills with optional filters.
      * @remarks Public endpoint — no authentication required.