connectbase-client 3.27.1 → 3.29.0

package/dist/index.mjs

@@ -4776,28 +4776,35 @@ var OAuthAPI = class {
    * `error=account_not_found` 를 받아 가입 안내 UX 로 분기해야 한다. 신규 가입까지 한 번에
    * 처리하려면 [signUp] 을 사용한다.
    *
+   * 기본적으로 미가입 사용자는 콜백에서 `error=account_not_found` 로 돌아온다(신규 자동가입 안 됨).
+   * 로그인/가입을 한 버튼으로 처리하려면 `{ createIfNotExists: true }` 를 주거나, 별도 "회원가입"
+   * 버튼에서 [signUp] 을 호출한다.
+   *
    * @param provider - OAuth 프로바이더 (google, naver, github, discord)
    * @param callbackUrl - OAuth 완료 후 리다이렉트될 앱의 URL
    * @param state - 선택적 state 파라미터 (CSRF 방지 등)
+   * @param options - `createIfNotExists: true` 면 미가입 사용자를 자동 가입시킨다([signUp] 과 동일 동작).
    *
    * @example
    * ```typescript
-   * // "로그인" 버튼 클릭 시
+   * // "로그인" 버튼 — 기존 회원만. 신규는 account_not_found.
    * await cb.oauth.signIn('google', 'https://myapp.com/oauth/callback')
+   *
+   * // 로그인=가입 통합 버튼 — 신규면 자동 가입
+   * await cb.oauth.signIn('google', 'https://myapp.com/oauth/callback', undefined, { createIfNotExists: true })
    * ```
    *
    * @example
    * ```typescript
-   * // callback 페이지에서
+   * // callback 페이지에서 — 미가입이면 가입 화면으로 안내
    * const result = await cb.oauth.getCallbackResult()
    * if (result?.error === 'account_not_found') {
-   *     // 가입되지 않은 사용자 — 회원가입 화면으로 안내
    *     window.location.href = '/signup'
    * }
    * ```
    */
-  async signIn(provider, callbackUrl, state) {
-    return this.startCentralOAuth(provider, callbackUrl, state, "signin");
+  async signIn(provider, callbackUrl, state, options) {
+    return this.startCentralOAuth(provider, callbackUrl, state, options?.createIfNotExists ? "signup" : "signin");
   }
   /**
    * 소셜 회원가입 (리다이렉트 방식) — 사용자가 명시적으로 가입 의사를 표시한 경우에만 호출.
@@ -8496,6 +8503,15 @@ var AIAPI = class {
   /**
    * AI 채팅 스트리밍 (SSE)
    *
+   * @param request AI 채팅 요청
+   * @param callbacks 스트림 이벤트 콜백 (토큰/추론/도구/검색/완료/에러/취소)
+   * @param options 선택적 옵션. `options.signal` 에 `AbortSignal` 을 전달하면
+   *   호출자가 진행 중인 스트림을 취소할 수 있다. abort 시 SSE 연결이 닫히고,
+   *   서버는 요청 컨텍스트(`c.Request.Context()`) 취소를 통해 server-side agent
+   *   tool loop (`toolGroupId` 사용 시)까지 함께 중단한다. abort 는 정상적인
+   *   사용자 취소이므로 `onError` 가 아니라 `callbacks.onAbort?.()` 가 호출되며
+   *   (지정 시), `onDone` 은 호출되지 않는다.
+   *
    * @example
    * ```typescript
    * await cb.ai.chatStream({
@@ -8509,76 +8525,109 @@ var AIAPI = class {
    *     onError: (error) => console.error('에러:', error)
    * })
    * ```
+   *
+   * @example 취소(stop 버튼)
+   * ```typescript
+   * const controller = new AbortController()
+   * // stop 버튼: controller.abort()
+   * await cb.ai.chatStream(
+   *     { messages: [{ role: 'user', content: '...' }], toolGroupId: 'tg-id' },
+   *     { onToken: (c) => process.stdout.write(c), onAbort: () => console.log('취소됨') },
+   *     { signal: controller.signal },
+   * )
+   * ```
    */
-  async chatStream(request, callbacks) {
-    const response = await this.http.fetchRaw(
-      "/v1/public/ai/chat/stream",
-      {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(request)
-      }
-    );
-    if (!response.ok) {
-      const errorData = await response.json().catch(() => ({ error: "Stream request failed" }));
-      callbacks.onError?.(errorData.error || "Stream request failed");
-      return;
-    }
-    const reader = response.body?.getReader();
-    if (!reader) {
-      callbacks.onError?.("ReadableStream not supported");
-      return;
-    }
-    const decoder = new TextDecoder();
-    let buffer = "";
-    while (true) {
-      const { done, value } = await reader.read();
-      if (done) break;
-      buffer += decoder.decode(value, { stream: true });
-      const lines = buffer.split("\n");
-      buffer = lines.pop() || "";
-      for (const line of lines) {
-        if (!line.startsWith("data: ")) continue;
-        const data = line.slice(6).trim();
-        if (data === "[DONE]") {
-          callbacks.onDone?.();
-          return;
+  async chatStream(request, callbacks, options) {
+    const signal = options?.signal;
+    const isAbort = (err) => signal?.aborted === true || err instanceof DOMException && err.name === "AbortError" || typeof err === "object" && err !== null && err.name === "AbortError";
+    let reader;
+    try {
+      const response = await this.http.fetchRaw(
+        "/v1/public/ai/chat/stream",
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(request),
+          // 외부 AbortSignal 을 그대로 전달. fetchRaw 는 init 을 spread 하므로
+          // 시그니처 변경 없이 signal 이 fetch 까지 도달한다. abort 시 fetch 가
+          // SSE 연결을 닫고, 서버는 요청 컨텍스트 취소로 tool loop 까지 중단한다.
+          signal
         }
-        try {
-          const event = JSON.parse(data);
-          if (event.error) {
-            callbacks.onError?.(event.message || event.error || "stream error");
-            return;
-          }
-          if (event.type === "sources" && event.sources) {
-            callbacks.onSources?.(event.sources);
-            continue;
-          }
-          if (event.type === "tool_start" || event.type === "tool_end") {
-            callbacks.onToolEvent?.({
-              type: event.type,
-              name: event.name,
-              toolCallId: event.toolCallId,
-              arguments: event.arguments,
-              result: event.result,
-              success: event.success,
-              durationMs: event.durationMs
-            });
-            continue;
-          }
-          if (event.type === "searching") {
-            if (event.searching) callbacks.onSearching?.(event.searching);
-            continue;
-          }
-          if (event.type === "heartbeat") {
-            continue;
-          }
-          if (event.reasoning) callbacks.onReasoning?.(event.reasoning);
-          if (event.content) callbacks.onToken?.(event.content);
-          if (event.done) {
+      );
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({ error: "Stream request failed" }));
+        callbacks.onError?.(errorData.error || "Stream request failed");
+        return;
+      }
+      reader = response.body?.getReader();
+      if (!reader) {
+        callbacks.onError?.("ReadableStream not supported");
+        return;
+      }
+      const decoder = new TextDecoder();
+      let buffer = "";
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() || "";
+        for (const line of lines) {
+          if (!line.startsWith("data: ")) continue;
+          const data = line.slice(6).trim();
+          if (data === "[DONE]") {
             callbacks.onDone?.();
             return;
           }
+          try {
+            const event = JSON.parse(data);
+            if (event.error) {
+              callbacks.onError?.(event.message || event.error || "stream error");
+              return;
+            }
+            if (event.type === "sources" && event.sources) {
+              callbacks.onSources?.(event.sources);
+              continue;
+            }
+            if (event.type === "tool_start" || event.type === "tool_end") {
+              callbacks.onToolEvent?.({
+                type: event.type,
+                name: event.name,
+                toolCallId: event.toolCallId,
+                arguments: event.arguments,
+                result: event.result,
+                success: event.success,
+                durationMs: event.durationMs
+              });
+              continue;
+            }
+            if (event.type === "searching") {
+              if (event.searching) callbacks.onSearching?.(event.searching);
+              continue;
+            }
+            if (event.type === "heartbeat") {
+              continue;
+            }
+            if (event.reasoning) callbacks.onReasoning?.(event.reasoning);
+            if (event.content) callbacks.onToken?.(event.content);
+            if (event.done) {
+              callbacks.onDone?.();
+              return;
+            }
+          } catch {
+          }
+        }
+      }
+    } catch (err) {
+      if (isAbort(err)) {
+        callbacks.onAbort?.();
+        return;
+      }
+      throw err;
+    } finally {
+      if (reader) {
+        try {
+          await reader.cancel();
         } catch {
         }
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "connectbase-client",
-  "version": "3.27.1",
+  "version": "3.29.0",
   "description": "Connect Base JavaScript/TypeScript SDK for browser and Node.js",
   "repository": {
     "type": "git",