summa-client-typescript 2.0.0

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { SummaClient } from "./client";
+export type { SummaClientOptions } from "./client";
+export type { CandidateScores, FusionCandidate, FusionCandidateList, PassageScores, L1Ranking, DocAddress, Document, DocumentMutationResult, OrdinalScore, SearchHit, SearchResponse, SearchTimings, RrfContribution, SearchTrace, ShardSearchTrace, QueryTrace, IndexInfo, VectorFieldStats, SearchRequest, Query, TermQuery, MatchQuery, BooleanQuery, BoostQuery, AllQuery, SparseVectorQuery, DenseVectorQuery, BinaryDenseVectorQuery, RangeQuery, PrefixQuery, WeightedQuery, FusionQuery, Combiner, Reranker, } from "./types";
+export { SearchServiceDefinition, IndexServiceDefinition, MultiValueCombiner, Query as PbQuery, TermQuery as PbTermQuery, BooleanQuery as PbBooleanQuery, BoostQuery as PbBoostQuery, AllQuery as PbAllQuery, MatchQuery as PbMatchQuery, SparseVectorQuery as PbSparseVectorQuery, DenseVectorQuery as PbDenseVectorQuery, BinaryDenseVectorQuery as PbBinaryDenseVectorQuery, Reranker as PbReranker, SearchRequest as PbSearchRequest, SearchResponse as PbSearchResponse, SearchHit as PbSearchHit, FieldValue, FieldEntry, SparseVector, DenseVector, GetDocumentRequest, DocAddress as PbDocAddress, GetDocumentResponse, GetIndexInfoRequest, GetIndexInfoResponse, CreateIndexRequest, CreateIndexResponse, IndexDocumentRequest, IndexDocumentsResponse, BatchIndexDocumentsRequest, BatchIndexDocumentsResponse, DeleteDocumentsRequest, UpsertDocumentsRequest, DocumentMutationResponse, NamedDocument, CommitRequest, CommitResponse, ForceMergeRequest, ForceMergeResponse, ReorderRequest, ReorderResponse, DeleteIndexRequest, DeleteIndexResponse, ListIndexesRequest, ListIndexesResponse, MemoryStats, IndexingBufferStats, SegmentReaderStats, OrdinalScore as PbOrdinalScore, } from "./generated/summa";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,YAAY,EACV,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,UAAU,EACV,QAAQ,EACR,sBAAsB,EACtB,YAAY,EACZ,SAAS,EACT,cAAc,EACd,aAAa,EACb,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,KAAK,EACL,SAAS,EACT,UAAU,EACV,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,UAAU,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,QAAQ,EACR,QAAQ,GACT,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,IAAI,OAAO,EAChB,SAAS,IAAI,WAAW,EACxB,YAAY,IAAI,cAAc,EAC9B,UAAU,IAAI,YAAY,EAC1B,QAAQ,IAAI,UAAU,EACtB,UAAU,IAAI,YAAY,EAC1B,iBAAiB,IAAI,mBAAmB,EACxC,gBAAgB,IAAI,kBAAkB,EACtC,sBAAsB,IAAI,wBAAwB,EAClD,QAAQ,IAAI,UAAU,EACtB,aAAa,IAAI,eAAe,EAChC,cAAc,IAAI,gBAAgB,EAClC,SAAS,IAAI,WAAW,EACxB,UAAU,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,UAAU,IAAI,YAAY,EAC1B,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,IAAI,cAAc,GAC/B,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PbOrdinalScore = exports.SegmentReaderStats = exports.IndexingBufferStats = exports.MemoryStats = exports.ListIndexesResponse = exports.ListIndexesRequest = exports.DeleteIndexResponse = exports.DeleteIndexRequest = exports.ReorderResponse = exports.ReorderRequest = exports.ForceMergeResponse = exports.ForceMergeRequest = exports.CommitResponse = exports.CommitRequest = exports.NamedDocument = exports.DocumentMutationResponse = exports.UpsertDocumentsRequest = exports.DeleteDocumentsRequest = exports.BatchIndexDocumentsResponse = exports.BatchIndexDocumentsRequest = exports.IndexDocumentsResponse = exports.IndexDocumentRequest = exports.CreateIndexResponse = exports.CreateIndexRequest = exports.GetIndexInfoResponse = exports.GetIndexInfoRequest = exports.GetDocumentResponse = exports.PbDocAddress = exports.GetDocumentRequest = exports.DenseVector = exports.SparseVector = exports.FieldEntry = exports.FieldValue = exports.PbSearchHit = exports.PbSearchResponse = exports.PbSearchRequest = exports.PbReranker = exports.PbBinaryDenseVectorQuery = exports.PbDenseVectorQuery = exports.PbSparseVectorQuery = exports.PbMatchQuery = exports.PbAllQuery = exports.PbBoostQuery = exports.PbBooleanQuery = exports.PbTermQuery = exports.PbQuery = exports.MultiValueCombiner = exports.IndexServiceDefinition = exports.SearchServiceDefinition = exports.SummaClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "SummaClient", { enumerable: true, get: function () { return client_1.SummaClient; } });
+var summa_1 = require("./generated/summa");
+Object.defineProperty(exports, "SearchServiceDefinition", { enumerable: true, get: function () { return summa_1.SearchServiceDefinition; } });
+Object.defineProperty(exports, "IndexServiceDefinition", { enumerable: true, get: function () { return summa_1.IndexServiceDefinition; } });
+Object.defineProperty(exports, "MultiValueCombiner", { enumerable: true, get: function () { return summa_1.MultiValueCombiner; } });
+Object.defineProperty(exports, "PbQuery", { enumerable: true, get: function () { return summa_1.Query; } });
+Object.defineProperty(exports, "PbTermQuery", { enumerable: true, get: function () { return summa_1.TermQuery; } });
+Object.defineProperty(exports, "PbBooleanQuery", { enumerable: true, get: function () { return summa_1.BooleanQuery; } });
+Object.defineProperty(exports, "PbBoostQuery", { enumerable: true, get: function () { return summa_1.BoostQuery; } });
+Object.defineProperty(exports, "PbAllQuery", { enumerable: true, get: function () { return summa_1.AllQuery; } });
+Object.defineProperty(exports, "PbMatchQuery", { enumerable: true, get: function () { return summa_1.MatchQuery; } });
+Object.defineProperty(exports, "PbSparseVectorQuery", { enumerable: true, get: function () { return summa_1.SparseVectorQuery; } });
+Object.defineProperty(exports, "PbDenseVectorQuery", { enumerable: true, get: function () { return summa_1.DenseVectorQuery; } });
+Object.defineProperty(exports, "PbBinaryDenseVectorQuery", { enumerable: true, get: function () { return summa_1.BinaryDenseVectorQuery; } });
+Object.defineProperty(exports, "PbReranker", { enumerable: true, get: function () { return summa_1.Reranker; } });
+Object.defineProperty(exports, "PbSearchRequest", { enumerable: true, get: function () { return summa_1.SearchRequest; } });
+Object.defineProperty(exports, "PbSearchResponse", { enumerable: true, get: function () { return summa_1.SearchResponse; } });
+Object.defineProperty(exports, "PbSearchHit", { enumerable: true, get: function () { return summa_1.SearchHit; } });
+Object.defineProperty(exports, "FieldValue", { enumerable: true, get: function () { return summa_1.FieldValue; } });
+Object.defineProperty(exports, "FieldEntry", { enumerable: true, get: function () { return summa_1.FieldEntry; } });
+Object.defineProperty(exports, "SparseVector", { enumerable: true, get: function () { return summa_1.SparseVector; } });
+Object.defineProperty(exports, "DenseVector", { enumerable: true, get: function () { return summa_1.DenseVector; } });
+Object.defineProperty(exports, "GetDocumentRequest", { enumerable: true, get: function () { return summa_1.GetDocumentRequest; } });
+Object.defineProperty(exports, "PbDocAddress", { enumerable: true, get: function () { return summa_1.DocAddress; } });
+Object.defineProperty(exports, "GetDocumentResponse", { enumerable: true, get: function () { return summa_1.GetDocumentResponse; } });
+Object.defineProperty(exports, "GetIndexInfoRequest", { enumerable: true, get: function () { return summa_1.GetIndexInfoRequest; } });
+Object.defineProperty(exports, "GetIndexInfoResponse", { enumerable: true, get: function () { return summa_1.GetIndexInfoResponse; } });
+Object.defineProperty(exports, "CreateIndexRequest", { enumerable: true, get: function () { return summa_1.CreateIndexRequest; } });
+Object.defineProperty(exports, "CreateIndexResponse", { enumerable: true, get: function () { return summa_1.CreateIndexResponse; } });
+Object.defineProperty(exports, "IndexDocumentRequest", { enumerable: true, get: function () { return summa_1.IndexDocumentRequest; } });
+Object.defineProperty(exports, "IndexDocumentsResponse", { enumerable: true, get: function () { return summa_1.IndexDocumentsResponse; } });
+Object.defineProperty(exports, "BatchIndexDocumentsRequest", { enumerable: true, get: function () { return summa_1.BatchIndexDocumentsRequest; } });
+Object.defineProperty(exports, "BatchIndexDocumentsResponse", { enumerable: true, get: function () { return summa_1.BatchIndexDocumentsResponse; } });
+Object.defineProperty(exports, "DeleteDocumentsRequest", { enumerable: true, get: function () { return summa_1.DeleteDocumentsRequest; } });
+Object.defineProperty(exports, "UpsertDocumentsRequest", { enumerable: true, get: function () { return summa_1.UpsertDocumentsRequest; } });
+Object.defineProperty(exports, "DocumentMutationResponse", { enumerable: true, get: function () { return summa_1.DocumentMutationResponse; } });
+Object.defineProperty(exports, "NamedDocument", { enumerable: true, get: function () { return summa_1.NamedDocument; } });
+Object.defineProperty(exports, "CommitRequest", { enumerable: true, get: function () { return summa_1.CommitRequest; } });
+Object.defineProperty(exports, "CommitResponse", { enumerable: true, get: function () { return summa_1.CommitResponse; } });
+Object.defineProperty(exports, "ForceMergeRequest", { enumerable: true, get: function () { return summa_1.ForceMergeRequest; } });
+Object.defineProperty(exports, "ForceMergeResponse", { enumerable: true, get: function () { return summa_1.ForceMergeResponse; } });
+Object.defineProperty(exports, "ReorderRequest", { enumerable: true, get: function () { return summa_1.ReorderRequest; } });
+Object.defineProperty(exports, "ReorderResponse", { enumerable: true, get: function () { return summa_1.ReorderResponse; } });
+Object.defineProperty(exports, "DeleteIndexRequest", { enumerable: true, get: function () { return summa_1.DeleteIndexRequest; } });
+Object.defineProperty(exports, "DeleteIndexResponse", { enumerable: true, get: function () { return summa_1.DeleteIndexResponse; } });
+Object.defineProperty(exports, "ListIndexesRequest", { enumerable: true, get: function () { return summa_1.ListIndexesRequest; } });
+Object.defineProperty(exports, "ListIndexesResponse", { enumerable: true, get: function () { return summa_1.ListIndexesResponse; } });
+Object.defineProperty(exports, "MemoryStats", { enumerable: true, get: function () { return summa_1.MemoryStats; } });
+Object.defineProperty(exports, "IndexingBufferStats", { enumerable: true, get: function () { return summa_1.IndexingBufferStats; } });
+Object.defineProperty(exports, "SegmentReaderStats", { enumerable: true, get: function () { return summa_1.SegmentReaderStats; } });
+Object.defineProperty(exports, "PbOrdinalScore", { enumerable: true, get: function () { return summa_1.OrdinalScore; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAuC;AAA9B,qGAAA,WAAW,OAAA;AAuCpB,2CAkD2B;AAjDzB,gHAAA,uBAAuB,OAAA;AACvB,+GAAA,sBAAsB,OAAA;AACtB,2GAAA,kBAAkB,OAAA;AAClB,gGAAA,KAAK,OAAW;AAChB,oGAAA,SAAS,OAAe;AACxB,uGAAA,YAAY,OAAkB;AAC9B,qGAAA,UAAU,OAAgB;AAC1B,mGAAA,QAAQ,OAAc;AACtB,qGAAA,UAAU,OAAgB;AAC1B,4GAAA,iBAAiB,OAAuB;AACxC,2GAAA,gBAAgB,OAAsB;AACtC,iHAAA,sBAAsB,OAA4B;AAClD,mGAAA,QAAQ,OAAc;AACtB,wGAAA,aAAa,OAAmB;AAChC,yGAAA,cAAc,OAAoB;AAClC,oGAAA,SAAS,OAAe;AACxB,mGAAA,UAAU,OAAA;AACV,mGAAA,UAAU,OAAA;AACV,qGAAA,YAAY,OAAA;AACZ,oGAAA,WAAW,OAAA;AACX,2GAAA,kBAAkB,OAAA;AAClB,qGAAA,UAAU,OAAgB;AAC1B,4GAAA,mBAAmB,OAAA;AACnB,4GAAA,mBAAmB,OAAA;AACnB,6GAAA,oBAAoB,OAAA;AACpB,2GAAA,kBAAkB,OAAA;AAClB,4GAAA,mBAAmB,OAAA;AACnB,6GAAA,oBAAoB,OAAA;AACpB,+GAAA,sBAAsB,OAAA;AACtB,mHAAA,0BAA0B,OAAA;AAC1B,oHAAA,2BAA2B,OAAA;AAC3B,+GAAA,sBAAsB,OAAA;AACtB,+GAAA,sBAAsB,OAAA;AACtB,iHAAA,wBAAwB,OAAA;AACxB,sGAAA,aAAa,OAAA;AACb,sGAAA,aAAa,OAAA;AACb,uGAAA,cAAc,OAAA;AACd,0GAAA,iBAAiB,OAAA;AACjB,2GAAA,kBAAkB,OAAA;AAClB,uGAAA,cAAc,OAAA;AACd,wGAAA,eAAe,OAAA;AACf,2GAAA,kBAAkB,OAAA;AAClB,4GAAA,mBAAmB,OAAA;AACnB,2GAAA,kBAAkB,OAAA;AAClB,4GAAA,mBAAmB,OAAA;AACnB,oGAAA,WAAW,OAAA;AACX,4GAAA,mBAAmB,OAAA;AACnB,2GAAA,kBAAkB,OAAA;AAClB,uGAAA,YAAY,OAAkB"}

package/dist/types.d.ts

@@ -0,0 +1,284 @@
+import type { CandidateScores, L1Ranking, RrfContribution, SearchTrace } from "./generated/summa";
+export type { CandidateScores, L1Ranking, PassageScores, RrfContribution, SearchTrace, ShardSearchTrace, QueryTrace } from "./generated/summa";
+/** A document with field values. */
+export interface Document {
+    fields: Record<string, any>;
+}
+/** Unique document address: segment + local doc_id. */
+export interface DocAddress {
+    segmentId: string;
+    docId: number;
+}
+/** Score contribution from a specific ordinal in a multi-valued field. */
+export interface OrdinalScore {
+    ordinal: number;
+    score: number;
+}
+/** A single search result. */
+export interface SearchHit {
+    address: DocAddress;
+    score: number;
+    fields: Record<string, any>;
+    ordinalScores: OrdinalScore[];
+    candidateScores?: CandidateScores;
+    rrfScore?: number;
+    rrfContributions?: RrfContribution[];
+}
+/** Detailed timing breakdown for search phases (all values in microseconds). */
+export interface SearchTimings {
+    searchUs: number;
+    rerankUs: number;
+    loadUs: number;
+    totalUs: number;
+    candidateScoringUs?: number;
+}
+export interface FusionCandidate {
+    address: DocAddress;
+    score: number;
+    ordinalScores: OrdinalScore[];
+}
+export interface FusionCandidateList {
+    queryIndex: number;
+    candidates: FusionCandidate[];
+}
+/** Search response with hits and metadata. */
+export interface SearchResponse {
+    hits: SearchHit[];
+    totalHits: number;
+    tookMs: number;
+    timings?: SearchTimings;
+    rankingMethod?: string;
+    seededDocumentPassages?: boolean;
+    fusionCandidates?: FusionCandidateList[];
+    trace?: SearchTrace;
+    truncated?: boolean;
+}
+/** Per-field vector statistics. */
+export interface VectorFieldStats {
+    fieldName: string;
+    vectorType: string;
+    totalVectors: number;
+    dimension: number;
+}
+/** Information about an index. */
+export interface IndexInfo {
+    indexName: string;
+    numDocs: number;
+    numSegments: number;
+    schema: string;
+    vectorStats: VectorFieldStats[];
+    physicalNumDocs?: number;
+    numDeletedDocs?: number;
+    deletedRatio?: number;
+    candidateScoringVersion?: number;
+    unpreparedCandidateFields?: string[];
+}
+export type Combiner = "log_sum_exp" | "max" | "avg" | "sum" | "weighted_top_k";
+export interface TermQuery {
+    field: string;
+    term: string;
+    /** Passed to the field's tokenizer; a dynamic stemmer reads a language list ("ru,en"). */
+    tokenizerHint?: string;
+}
+export interface MatchQuery {
+    field: string;
+    text: string;
+    /** Passed to the field's tokenizer; a dynamic stemmer reads a language list ("ru,en"). */
+    tokenizerHint?: string;
+    /** Proximity rescoring weight for the top BM25 candidates (0 = off). */
+    proximityWeight?: number;
+    /** Unordered proximity window size (0 = 8). */
+    proximityWindow?: number;
+    /** Approximate text top-k: skip candidates below threshold / heapFactor (<= 1 = exact). */
+    heapFactor?: number;
+    /** Keep only the highest-idf terms of a long query (0 = all). */
+    maxTerms?: number;
+}
+/** Consecutive-terms query on a field indexed with token positions. */
+export interface PhraseQuery {
+    field: string;
+    text: string;
+    /** Max positions between terms; 0 = exact phrase. */
+    slop?: number;
+    tokenizerHint?: string;
+}
+export interface BooleanQuery {
+    must?: Query[];
+    should?: Query[];
+    mustNot?: Query[];
+}
+export interface BoostQuery {
+    query: Query;
+    boost: number;
+}
+export interface AllQuery {
+}
+export interface SparseVectorQuery {
+    field: string;
+    /** Pre-computed token indices */
+    indices?: number[];
+    /** Pre-computed token values */
+    values?: number[];
+    /** Raw text (tokenized server-side if tokenizer configured) */
+    text?: string;
+    combiner?: Combiner;
+    /** BMP/MaxScore pruning factor (0 = schema default, 1 = exact). */
+    heapFactor?: number;
+    /** BMP superblock cap; unset is depth-derived, zero is exhaustive. */
+    lspGamma?: number;
+    /** Temperature for LogSumExp combiner (default: 1.5) */
+    combinerTemperature?: number;
+    /** K for WeightedTopK combiner (default: 5) */
+    combinerTopK?: number;
+    /** Decay for WeightedTopK combiner (default: 0.7) */
+    combinerDecay?: number;
+    /** Min abs(weight) for query dims (0 = no filtering) */
+    weightThreshold?: number;
+    /** Max query dimensions to process (0 = all) */
+    maxQueryDims?: number;
+    /** Fraction of query dims to keep (0-1, e.g. 0.1 = top 10%) */
+    pruning?: number;
+    /** Query dimensions used for Seismic nomination (1..64). */
+    seismicCut?: number;
+    seismicFactor?: number;
+    exhaustive?: boolean;
+}
+export interface DenseVectorQuery {
+    field: string;
+    vector: number[];
+    /** Number of clusters to probe (for IVF indexes) */
+    nprobe?: number;
+    combiner?: Combiner;
+    /** Temperature for LogSumExp combiner (default: 1.5) */
+    combinerTemperature?: number;
+    /** K for WeightedTopK combiner (default: 5) */
+    combinerTopK?: number;
+    /** Decay for WeightedTopK combiner (default: 0.7) */
+    combinerDecay?: number;
+}
+export interface BinaryDenseVectorQuery {
+    field: string;
+    /** Packed-bit query vector (ceil(dim/8) bytes) */
+    vector: Uint8Array;
+    combiner?: Combiner;
+    combinerTemperature?: number;
+    combinerTopK?: number;
+    combinerDecay?: number;
+}
+export interface RangeQuery {
+    field: string;
+    /** u64 bounds (inclusive) */
+    minU64?: number;
+    maxU64?: number;
+    /** i64 bounds (inclusive) */
+    minI64?: number;
+    maxI64?: number;
+    /** f64 bounds (inclusive) */
+    minF64?: number;
+    maxF64?: number;
+}
+export interface PrefixQuery {
+    field: string;
+    prefix: string;
+}
+/** Weighted sub-query for hybrid fusion */
+export interface WeightedQuery {
+    /** Required for L1/export; unique coefficient identity. */
+    name?: string;
+    scope?: "document" | "chunk";
+    scoreOnly?: boolean;
+    query: Query;
+    /** Contribution scale (default: 1.0) */
+    weight?: number;
+}
+/**
+ * Union fusion of independently-executed sub-queries (e.g. sparse + dense).
+ * Unlike the reranker, keeps documents found by ANY sub-query.
+ * Only valid at the top level of a search request.
+ */
+export interface FusionQuery {
+    filters?: Query[];
+    candidateDepth?: number;
+    queries: WeightedQuery[];
+    /** Fusion method (default: "rrf") */
+    method?: "rrf" | "normalized_weighted_sum" | "candidates";
+    /** RRF rank constant (default: 60) */
+    rrfK?: number;
+    /**
+     * Combiner for fused per-chunk (ordinal) scores into a document score.
+     * Fusion runs at chunk granularity: same-chunk hits across sub-queries
+     * compound. Default: "max" (recommended for RRF score magnitudes).
+     */
+    combiner?: Combiner;
+}
+/** Discriminated union matching proto Query oneof. Exactly one key must be set. */
+export type Query = {
+    term: TermQuery;
+} | {
+    match: MatchQuery;
+} | {
+    phrase: PhraseQuery;
+} | {
+    boolean: BooleanQuery;
+} | {
+    sparseVector: SparseVectorQuery;
+} | {
+    denseVector: DenseVectorQuery;
+} | {
+    binaryDenseVector: BinaryDenseVectorQuery;
+} | {
+    boost: BoostQuery;
+} | {
+    all: AllQuery;
+} | {
+    range: RangeQuery;
+} | {
+    prefix: PrefixQuery;
+} | {
+    fusion: FusionQuery;
+};
+export interface Reranker {
+    field: string;
+    /** Query vector (f32, for dense fields) */
+    vector?: number[];
+    combiner?: Combiner;
+    combinerTemperature?: number;
+    combinerTopK?: number;
+    combinerDecay?: number;
+    /** Matryoshka pre-filter dims (0 = disabled) */
+    matryoshkaDims?: number;
+    /** Query vector (packed bits, for binary dense fields) */
+    binaryVector?: Uint8Array;
+    /** Reciprocal Rank Fusion k (0 = disabled, typical: 60) */
+    rrfK?: number;
+}
+export interface SearchRequest {
+    /** Add organic RRF score and branch contributions without changing ranking. */
+    includeRrfScores?: boolean;
+    /** Preserve per-shard nomination/selection trace. Default false. */
+    tracing?: boolean;
+    l1?: Pick<L1Ranking, "formula"> & Partial<Omit<L1Ranking, "formula">>;
+    scoreExport?: {
+        passagesPerDocument?: number;
+        allPassages?: boolean;
+        seedDocumentPassages?: boolean;
+    };
+    query: Query;
+    limit?: number;
+    offset?: number;
+    fieldsToLoad?: string[];
+    reranker?: Reranker;
+    /** Shared first-stage candidate pool (0 = result window, maximum: 2x). */
+    candidateLimit?: number;
+    /** Anytime mode: wall-clock budget of the scoring phase in ms (0 = exact). */
+    timeBudgetMs?: number;
+}
+/** Staged operations, not affected rows. Commit publishes accepted work. */
+export interface DocumentMutationResult {
+    acceptedCount: number;
+    errors: Array<{
+        index: number;
+        error: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "summa-client-typescript",
+  "version": "2.0.0",
+  "description": "TypeScript client for Summa search server",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "generate": "bash generate_proto.sh",
+    "build": "tsc",
+    "test": "pnpm run build && node --test tests/*.test.cjs",
+    "check": "pnpm test",
+    "prepublishOnly": "pnpm run build",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "search",
+    "full-text-search",
+    "grpc",
+    "summa",
+    "vector-search"
+  ],
+  "license": "MIT",
+  "author": "izihawa",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SpaceFrontiers/summa",
+    "directory": "summa-client-typescript"
+  },
+  "homepage": "https://github.com/SpaceFrontiers/summa",
+  "dependencies": {
+    "@bufbuild/protobuf": "^2.11.0",
+    "@grpc/grpc-js": "^1.14.4",
+    "nice-grpc": "^2.1.10",
+    "nice-grpc-client-middleware-deadline": "^2.0.14"
+  },
+  "devDependencies": {
+    "grpc-tools": "^1.12.4",
+    "ts-proto": "^2.6.1",
+    "typescript": "^5.8.0"
+  },
+  "pnpm": {
+    "overrides": {
+      "protobufjs": "^7.6.5",
+      "@protobufjs/utf8": "^1.1.2",
+      "tar": "^7.5.20"
+    }
+  }
+}