connectbase-client 3.47.0 → 3.48.1

package/dist/index.d.mts

@@ -173,13 +173,20 @@ declare class HttpClient {
      * 한 번 settle 되면 그 결과(메모리 적재 또는 미로그인)가 항상 반영되어 있다.
      */
     private bootRestorePromise;
+    private bootRestoreAlwaysAwait;
     constructor(config: HttpClientConfig);
     /**
      * 페이지 진입 시 fire-and-forget 으로 시작된 cookie 복구 promise 를 SDK 가 등록한다.
      * 같은 promise 가 `prepareHeaders` 에서 await 되어, 첫 인증 호출이 cookie 복구
      * 완료 후 발화한다.
+     *
+     * options.alwaysAwait=true 면 세션 힌트가 없어도 첫 인증 호출이 이 promise 를
+     * 기다린다 — OAuth 리다이렉트 콜백처럼 "이 부트 promise 가 곧 세션을 만든다"는 것이
+     * 확실한 흐름용 (일반 cookie 복구는 힌트 기반 fast-path 적용).
      */
-    setBootRestorePromise(p: Promise<boolean>): void;
+    setBootRestorePromise(p: Promise<boolean>, options?: {
+        alwaysAwait?: boolean;
+    }): void;
     /** 최근 호출 ring buffer 스냅샷 (시간순). */
     getRecentCalls(): RecentApiCall[];
     /** 최근 호출 buffer clear (테스트/프라이버시 처리). */
@@ -188,6 +195,10 @@ declare class HttpClient {
     updateConfig(config: Partial<HttpClientConfig>): void;
     setTokens(accessToken: string, refreshToken: string): void;
     clearTokens(): void;
+    private buildSessionHintKey;
+    private markSessionHint;
+    private clearSessionHint;
+    private hasSessionHint;
     /**
      * OAuth redirect callback 직후 호출되어 HttpOnly cookie 를 부트스트랩한다.
      *
@@ -1174,7 +1185,12 @@ interface UpdateDataRequest {
 interface FetchDataResponse {
     /** 조회된 문서 배열 */
     data: DataItem[];
-    /** 총 매칭 문서 수 */
+    /**
+     * 총 매칭 문서 수.
+     *
+     * `count: false` 로 조회한 경우: 마지막 페이지(반환 건수 < limit)면 서버가 정확한
+     * 총계를 파생해 돌려주고, 아니면 `-1` (미상) 이 반환됩니다.
+     */
     total_count: number;
 }
 interface QueryOptions {
@@ -1187,6 +1203,14 @@ interface QueryOptions {
     select?: string[];
     /** 제외할 필드 목록 - 지정된 필드를 제외하고 반환 */
     exclude?: string[];
+    /**
+     * `false` 면 `total_count` 계산(서버측 COUNT 쿼리)을 생략합니다.
+     *
+     * 필터가 붙은 COUNT 는 본 조회와 같은 비용의 스캔을 한 번 더 도는 것이므로,
+     * 총계가 필요 없는 목록/무한스크롤 조회는 `count: false` 로 눈에 띄게 빨라집니다.
+     * 생략 시 기본값은 `true` (기존 동작 유지).
+     */
+    count?: boolean;
 }
 type WhereCondition = {
     /** OR 조건: 배열 내 조건들 중 하나 이상 만족 */

package/dist/index.d.ts

@@ -173,13 +173,20 @@ declare class HttpClient {
      * 한 번 settle 되면 그 결과(메모리 적재 또는 미로그인)가 항상 반영되어 있다.
      */
     private bootRestorePromise;
+    private bootRestoreAlwaysAwait;
     constructor(config: HttpClientConfig);
     /**
      * 페이지 진입 시 fire-and-forget 으로 시작된 cookie 복구 promise 를 SDK 가 등록한다.
      * 같은 promise 가 `prepareHeaders` 에서 await 되어, 첫 인증 호출이 cookie 복구
      * 완료 후 발화한다.
+     *
+     * options.alwaysAwait=true 면 세션 힌트가 없어도 첫 인증 호출이 이 promise 를
+     * 기다린다 — OAuth 리다이렉트 콜백처럼 "이 부트 promise 가 곧 세션을 만든다"는 것이
+     * 확실한 흐름용 (일반 cookie 복구는 힌트 기반 fast-path 적용).
      */
-    setBootRestorePromise(p: Promise<boolean>): void;
+    setBootRestorePromise(p: Promise<boolean>, options?: {
+        alwaysAwait?: boolean;
+    }): void;
     /** 최근 호출 ring buffer 스냅샷 (시간순). */
     getRecentCalls(): RecentApiCall[];
     /** 최근 호출 buffer clear (테스트/프라이버시 처리). */
@@ -188,6 +195,10 @@ declare class HttpClient {
     updateConfig(config: Partial<HttpClientConfig>): void;
     setTokens(accessToken: string, refreshToken: string): void;
     clearTokens(): void;
+    private buildSessionHintKey;
+    private markSessionHint;
+    private clearSessionHint;
+    private hasSessionHint;
     /**
      * OAuth redirect callback 직후 호출되어 HttpOnly cookie 를 부트스트랩한다.
      *
@@ -1174,7 +1185,12 @@ interface UpdateDataRequest {
 interface FetchDataResponse {
     /** 조회된 문서 배열 */
     data: DataItem[];
-    /** 총 매칭 문서 수 */
+    /**
+     * 총 매칭 문서 수.
+     *
+     * `count: false` 로 조회한 경우: 마지막 페이지(반환 건수 < limit)면 서버가 정확한
+     * 총계를 파생해 돌려주고, 아니면 `-1` (미상) 이 반환됩니다.
+     */
     total_count: number;
 }
 interface QueryOptions {
@@ -1187,6 +1203,14 @@ interface QueryOptions {
     select?: string[];
     /** 제외할 필드 목록 - 지정된 필드를 제외하고 반환 */
     exclude?: string[];
+    /**
+     * `false` 면 `total_count` 계산(서버측 COUNT 쿼리)을 생략합니다.
+     *
+     * 필터가 붙은 COUNT 는 본 조회와 같은 비용의 스캔을 한 번 더 도는 것이므로,
+     * 총계가 필요 없는 목록/무한스크롤 조회는 `count: false` 로 눈에 띄게 빨라집니다.
+     * 생략 시 기본값은 `true` (기존 동작 유지).
+     */
+    count?: boolean;
 }
 type WhereCondition = {
     /** OR 조건: 배열 내 조건들 중 하나 이상 만족 */

package/dist/index.js

@@ -185,6 +185,9 @@ var HttpClient = class {
      * 한 번 settle 되면 그 결과(메모리 적재 또는 미로그인)가 항상 반영되어 있다.
      */
     this.bootRestorePromise = null;
+    // OAuth 콜백 부트스트랩처럼 세션 힌트 유무와 무관하게 첫 인증 호출이 반드시 기다려야
+    // 하는 boot promise 인지 여부 (setBootRestorePromise 의 alwaysAwait 옵션).
+    this.bootRestoreAlwaysAwait = false;
     this.config = { ...config };
     this.storageKey = this.buildStorageKey();
     this.warnIfUnsafePersistence();
@@ -194,9 +197,14 @@ var HttpClient = class {
    * 페이지 진입 시 fire-and-forget 으로 시작된 cookie 복구 promise 를 SDK 가 등록한다.
    * 같은 promise 가 `prepareHeaders` 에서 await 되어, 첫 인증 호출이 cookie 복구
    * 완료 후 발화한다.
+   *
+   * options.alwaysAwait=true 면 세션 힌트가 없어도 첫 인증 호출이 이 promise 를
+   * 기다린다 — OAuth 리다이렉트 콜백처럼 "이 부트 promise 가 곧 세션을 만든다"는 것이
+   * 확실한 흐름용 (일반 cookie 복구는 힌트 기반 fast-path 적용).
    */
-  setBootRestorePromise(p) {
+  setBootRestorePromise(p, options) {
     this.bootRestorePromise = p.catch(() => false);
+    this.bootRestoreAlwaysAwait = options?.alwaysAwait === true;
   }
   /** 최근 호출 ring buffer 스냅샷 (시간순). */
   getRecentCalls() {
@@ -225,11 +233,49 @@ var HttpClient = class {
     this.config.accessToken = accessToken;
     this.config.refreshToken = refreshToken;
     this.persistTokens();
+    this.markSessionHint();
   }
   clearTokens() {
     this.config.accessToken = void 0;
     this.config.refreshToken = void 0;
     this.removePersistedTokens();
+    this.clearSessionHint();
+  }
+  // ===== 세션 힌트 =====
+  //
+  // "이 origin 에서 이 앱으로 로그인한 적이 있다"는 boolean 마커 (토큰 아님 — 민감정보 없음).
+  // 부트 시 cookie 복구(`/v1/auth/re-issue`)를 첫 인증 호출이 기다릴지 판단하는 데 쓴다:
+  //   - 힌트 있음 → 기존과 동일하게 대기 (로그인 세션의 첫 호출이 익명으로 나가는 것 방지).
+  //   - 힌트 없음 → 대기 생략. 익명 방문자(공개 사이트 첫 방문 대부분)의 첫 조회가
+  //     re-issue 왕복만큼 빨라진다. 복구 자체는 백그라운드로 계속 진행되므로, 드물게
+  //     힌트가 지워졌지만 cookie 세션이 살아있는 경우도 이후 호출부터 자동 회복된다.
+  //
+  // 세션을 만드는 모든 흐름(로그인/OAuth 콜백/토큰 refresh)이 setTokens 를 경유하므로
+  // 그곳에서 마킹하고, clearTokens(로그아웃)에서 지운다.
+  buildSessionHintKey() {
+    return `${this.buildStorageKey()}:has_session`;
+  }
+  markSessionHint() {
+    if (typeof window === "undefined") return;
+    try {
+      localStorage.setItem(this.buildSessionHintKey(), "1");
+    } catch {
+    }
+  }
+  clearSessionHint() {
+    if (typeof window === "undefined") return;
+    try {
+      localStorage.removeItem(this.buildSessionHintKey());
+    } catch {
+    }
+  }
+  hasSessionHint() {
+    if (typeof window === "undefined") return false;
+    try {
+      return localStorage.getItem(this.buildSessionHintKey()) === "1";
+    } catch {
+      return true;
+    }
   }
   /**
    * OAuth redirect callback 직후 호출되어 HttpOnly cookie 를 부트스트랩한다.
@@ -558,7 +604,7 @@ var HttpClient = class {
     if (credential) {
       headers.set("X-Public-Key", credential);
     }
-    if (!config?.skipAuth && !this.config.accessToken && this.config.publicKey && typeof window !== "undefined" && this.bootRestorePromise) {
+    if (!config?.skipAuth && !this.config.accessToken && this.config.publicKey && typeof window !== "undefined" && this.bootRestorePromise && (this.bootRestoreAlwaysAwait || this.hasSessionHint())) {
       try {
         await this.bootRestorePromise;
       } catch {
@@ -1268,6 +1314,7 @@ var DatabaseAPI = class {
     const params = new URLSearchParams();
     if (options?.limit) params.append("limit", options.limit.toString());
     if (options?.offset) params.append("offset", options.offset.toString());
+    if (options?.count === false) params.append("count", "false");
     const queryString = params.toString();
     const url = queryString ? `${prefix}/tables/${tableId}/data?${queryString}` : `${prefix}/tables/${tableId}/data`;
     return this.http.get(url);
@@ -1286,7 +1333,8 @@ var DatabaseAPI = class {
         limit: options.limit,
         offset: options.offset,
         select: options.select,
-        exclude: options.exclude
+        exclude: options.exclude,
+        count: options.count
       }
     );
   }
@@ -1450,7 +1498,8 @@ var DatabaseAPI = class {
         offset: options.offset,
         select: options.select,
         exclude: options.exclude,
-        populate: options.populate
+        populate: options.populate,
+        count: options.count
       }
     );
   }
@@ -11333,7 +11382,7 @@ var ConnectBase = class {
     const shouldAutoRestore = config.autoRestoreSession ?? true;
     if (shouldAutoRestore && typeof window !== "undefined") {
       if (this.isOAuthRedirectCallbackUrl()) {
-        this.http.setBootRestorePromise(this.oauth.consumeRedirectCallbackOnBoot());
+        this.http.setBootRestorePromise(this.oauth.consumeRedirectCallbackOnBoot(), { alwaysAwait: true });
       } else if (!this.isOAuthCallbackUrl()) {
         this.http.setBootRestorePromise(this.http.tryRestoreSessionFromCookie());
       }

package/dist/index.mjs

@@ -139,6 +139,9 @@ var HttpClient = class {
      * 한 번 settle 되면 그 결과(메모리 적재 또는 미로그인)가 항상 반영되어 있다.
      */
     this.bootRestorePromise = null;
+    // OAuth 콜백 부트스트랩처럼 세션 힌트 유무와 무관하게 첫 인증 호출이 반드시 기다려야
+    // 하는 boot promise 인지 여부 (setBootRestorePromise 의 alwaysAwait 옵션).
+    this.bootRestoreAlwaysAwait = false;
     this.config = { ...config };
     this.storageKey = this.buildStorageKey();
     this.warnIfUnsafePersistence();
@@ -148,9 +151,14 @@ var HttpClient = class {
    * 페이지 진입 시 fire-and-forget 으로 시작된 cookie 복구 promise 를 SDK 가 등록한다.
    * 같은 promise 가 `prepareHeaders` 에서 await 되어, 첫 인증 호출이 cookie 복구
    * 완료 후 발화한다.
+   *
+   * options.alwaysAwait=true 면 세션 힌트가 없어도 첫 인증 호출이 이 promise 를
+   * 기다린다 — OAuth 리다이렉트 콜백처럼 "이 부트 promise 가 곧 세션을 만든다"는 것이
+   * 확실한 흐름용 (일반 cookie 복구는 힌트 기반 fast-path 적용).
    */
-  setBootRestorePromise(p) {
+  setBootRestorePromise(p, options) {
     this.bootRestorePromise = p.catch(() => false);
+    this.bootRestoreAlwaysAwait = options?.alwaysAwait === true;
   }
   /** 최근 호출 ring buffer 스냅샷 (시간순). */
   getRecentCalls() {
@@ -179,11 +187,49 @@ var HttpClient = class {
     this.config.accessToken = accessToken;
     this.config.refreshToken = refreshToken;
     this.persistTokens();
+    this.markSessionHint();
   }
   clearTokens() {
     this.config.accessToken = void 0;
     this.config.refreshToken = void 0;
     this.removePersistedTokens();
+    this.clearSessionHint();
+  }
+  // ===== 세션 힌트 =====
+  //
+  // "이 origin 에서 이 앱으로 로그인한 적이 있다"는 boolean 마커 (토큰 아님 — 민감정보 없음).
+  // 부트 시 cookie 복구(`/v1/auth/re-issue`)를 첫 인증 호출이 기다릴지 판단하는 데 쓴다:
+  //   - 힌트 있음 → 기존과 동일하게 대기 (로그인 세션의 첫 호출이 익명으로 나가는 것 방지).
+  //   - 힌트 없음 → 대기 생략. 익명 방문자(공개 사이트 첫 방문 대부분)의 첫 조회가
+  //     re-issue 왕복만큼 빨라진다. 복구 자체는 백그라운드로 계속 진행되므로, 드물게
+  //     힌트가 지워졌지만 cookie 세션이 살아있는 경우도 이후 호출부터 자동 회복된다.
+  //
+  // 세션을 만드는 모든 흐름(로그인/OAuth 콜백/토큰 refresh)이 setTokens 를 경유하므로
+  // 그곳에서 마킹하고, clearTokens(로그아웃)에서 지운다.
+  buildSessionHintKey() {
+    return `${this.buildStorageKey()}:has_session`;
+  }
+  markSessionHint() {
+    if (typeof window === "undefined") return;
+    try {
+      localStorage.setItem(this.buildSessionHintKey(), "1");
+    } catch {
+    }
+  }
+  clearSessionHint() {
+    if (typeof window === "undefined") return;
+    try {
+      localStorage.removeItem(this.buildSessionHintKey());
+    } catch {
+    }
+  }
+  hasSessionHint() {
+    if (typeof window === "undefined") return false;
+    try {
+      return localStorage.getItem(this.buildSessionHintKey()) === "1";
+    } catch {
+      return true;
+    }
   }
   /**
    * OAuth redirect callback 직후 호출되어 HttpOnly cookie 를 부트스트랩한다.
@@ -512,7 +558,7 @@ var HttpClient = class {
     if (credential) {
       headers.set("X-Public-Key", credential);
     }
-    if (!config?.skipAuth && !this.config.accessToken && this.config.publicKey && typeof window !== "undefined" && this.bootRestorePromise) {
+    if (!config?.skipAuth && !this.config.accessToken && this.config.publicKey && typeof window !== "undefined" && this.bootRestorePromise && (this.bootRestoreAlwaysAwait || this.hasSessionHint())) {
       try {
         await this.bootRestorePromise;
       } catch {
@@ -1222,6 +1268,7 @@ var DatabaseAPI = class {
     const params = new URLSearchParams();
     if (options?.limit) params.append("limit", options.limit.toString());
     if (options?.offset) params.append("offset", options.offset.toString());
+    if (options?.count === false) params.append("count", "false");
     const queryString = params.toString();
     const url = queryString ? `${prefix}/tables/${tableId}/data?${queryString}` : `${prefix}/tables/${tableId}/data`;
     return this.http.get(url);
@@ -1240,7 +1287,8 @@ var DatabaseAPI = class {
         limit: options.limit,
         offset: options.offset,
         select: options.select,
-        exclude: options.exclude
+        exclude: options.exclude,
+        count: options.count
       }
     );
   }
@@ -1404,7 +1452,8 @@ var DatabaseAPI = class {
         offset: options.offset,
         select: options.select,
         exclude: options.exclude,
-        populate: options.populate
+        populate: options.populate,
+        count: options.count
       }
     );
   }
@@ -11287,7 +11336,7 @@ var ConnectBase = class {
     const shouldAutoRestore = config.autoRestoreSession ?? true;
     if (shouldAutoRestore && typeof window !== "undefined") {
       if (this.isOAuthRedirectCallbackUrl()) {
-        this.http.setBootRestorePromise(this.oauth.consumeRedirectCallbackOnBoot());
+        this.http.setBootRestorePromise(this.oauth.consumeRedirectCallbackOnBoot(), { alwaysAwait: true });
       } else if (!this.isOAuthCallbackUrl()) {
         this.http.setBootRestorePromise(this.http.tryRestoreSessionFromCookie());
       }

package/package.json

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