document-dataply 0.0.9-alpha.9 → 0.0.10-alpha.0

package/dist/types/core/bptree/documentComparator.d.ts

@@ -1,7 +1,17 @@
 import type { DataplyTreeValue, Primitive } from '../../types';
 import { ValueComparator } from 'dataply';
 export declare class DocumentValueComparator<T extends DataplyTreeValue<U>, U extends Primitive> extends ValueComparator<T> {
+    private readonly _intlComparator;
     primaryAsc(a: T, b: T): number;
     asc(a: T, b: T): number;
     match(value: T): string;
+    /**
+     * 두 Primitive 값을 비교합니다.
+     */
+    private _compareDiff;
+    /**
+     * 두 v 값을 비교합니다. v는 Primitive 또는 Primitive[] (복합 인덱스)일 수 있습니다.
+     * 배열인 경우 element-by-element로 비교합니다.
+     */
+    private _compareValue;
 }

package/dist/types/core/document.d.ts

@@ -122,7 +122,7 @@ export declare class DocumentDataply<T extends DocumentJSON> {
      * @throws Error if query or orderBy contains non-indexed fields
      */
     select(query: Partial<DocumentDataplyQuery<T>>, options?: DocumentDataplyQueryOptions, tx?: Transaction): {
-        stream: AsyncIterableIterator<DataplyDocument<T>>;
+        stream: () => AsyncIterableIterator<DataplyDocument<T>>;
         drain: () => Promise<DataplyDocument<T>[]>;
     };
     /**

package/dist/types/core/documentAPI.d.ts

@@ -110,6 +110,31 @@ export declare class DocumentDataplyAPI<T extends DocumentJSON> extends DataplyA
      * @returns The verbose query object
      */
     verboseQuery<U extends Partial<DocumentDataplyQuery<T>>, V extends DataplyTreeValue<U>>(query: Partial<DocumentDataplyQuery<U>>): Partial<DocumentDataplyQuery<V>>;
+    /**
+     * B-Tree 타입 인덱스의 선택도를 평가하고 트리에 부여할 조건을 산출합니다.
+     * 필드 매칭 여부를 검사하고, 연속된(Prefix) 조건에 대해 점수를 부여하며 Start/End 바운드를 구성합니다.
+     *
+     * @param indexName 평가할 인덱스의 이름 (예: idx_nickname_createdat)
+     * @param config 등록된 인덱스의 설정 객체
+     * @param query 쿼리 객체
+     * @param queryFields 쿼리에 포함된 필드 목록 집합
+     * @param treeTx 조회를 수행할 B-Tree 트랜잭션 객체
+     * @param orderByField 정렬에 사용할 필드명 (옵션)
+     * @returns B-Tree 인덱스 후보 정보 (조건, 점수, 커버된 필드 등), 적합하지 않으면 null
+     */
+    private evaluateBTreeCandidate;
+    /**
+     * FTS (Full Text Search) 타입 인덱스의 선택도를 평가합니다.
+     * 'match' 연산자가 쿼리에 존재하는지 확인하고, 검색용 토큰으로 분해(tokenize)하여 점수를 매깁니다.
+     *
+     * @param indexName 평가할 인덱스의 이름
+     * @param config 등록된 인덱스의 설정 객체
+     * @param query 쿼리 객체
+     * @param queryFields 쿼리에 포함된 필드 목록 집합
+     * @param treeTx 조회를 수행할 B-Tree 트랜잭션 객체
+     * @returns FTS 인덱스 후보 정보 (조건, 점수, 분석된 토큰 등), 적합하지 않으면 null
+     */
+    private evaluateFTSCandidate;
     /**
      * Choose the best index (driver) for the given query.
      * Scores each index based on field coverage and condition type.
@@ -265,7 +290,7 @@ export declare class DocumentDataplyAPI<T extends DocumentJSON> extends DataplyA
      * @throws Error if query or orderBy contains non-indexed fields
      */
     selectDocuments(query: Partial<DocumentDataplyQuery<T>>, options?: DocumentDataplyQueryOptions, tx?: Transaction): {
-        stream: AsyncIterableIterator<DataplyDocument<T>>;
+        stream: () => AsyncIterableIterator<DataplyDocument<T>>;
         drain: () => Promise<DataplyDocument<T>[]>;
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "document-dataply",
-  "version": "0.0.9-alpha.9",
+  "version": "0.0.10-alpha.0",
   "description": "Simple and powerful JSON document database supporting complex queries and flexible indexing policies.",
   "license": "MIT",
   "author": "izure <admin@izure.org>",
@@ -42,7 +42,7 @@
     "dataply"
   ],
   "dependencies": {
-    "dataply": "^0.0.24-alpha.7"
+    "dataply": "^0.0.25-alpha.0"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",
@@ -51,4 +51,4 @@
     "ts-jest": "^29.4.6",
     "typescript": "^5.9.3"
   }
-}
+}

package/readme.md

@@ -85,7 +85,7 @@ async function main() {
   // Get all results
   const allResults = await query.drain();
   // Or iterate through results
-  for await (const doc of query.stream) {
+  for await (const doc of query.stream()) {
     console.log(doc);
   }
 
@@ -188,7 +188,7 @@ For more information on performance optimization and advanced features, see [TIP
 
 - **Query Optimization**: Automatic index selection for maximum performance.
 - **Sorting and Pagination**: Detailed usage of `limit`, `orderBy`, and `sortOrder`.
-- **Memory Management**: When to use `stream` vs `drain()`.
+- **Memory Management**: When to use `stream()` vs `drain()`.
 - **Performance**: Optimizing bulk data insertion using `insertBatch`.
 - **Indexing Policies**: Dynamic index creation and automatic backfilling.
 - **Composite Indexes**: Indexing multiple fields for complex queries.
@@ -226,7 +226,7 @@ Inserts multiple documents efficiently. Returns an array of `_ids` (`number[]`).
 ### `db.select(query, options?, tx?)`
 Searches for documents matching the query. Passing an empty object (`{}`) as the `query` retrieves all documents.
 Returns an object `{ stream, drain }`.
-- `stream`: An async iterator to traverse results one by one.
+- `stream()`: An async iterator to traverse results one by one.
 - `drain()`: A promise that resolves to an array of all matching documents.
 
 ### `db.partialUpdate(query, newFields, tx?)`