@delali/narsil 0.1.7 → 0.1.9

package/dist/index.d.ts

@@ -1,463 +1,19 @@
-import { L as LanguageModule } from './language-ClUGLuoC.js';
-import { E as EmbeddingAdapter, P as PersistenceAdapter, I as InvalidationAdapter } from './adapters-BbRkoiu9.js';
-export { a as InvalidationEvent, b as PartitionStatistics } from './adapters-BbRkoiu9.js';
-
-type AnyDocument = Record<string, unknown> & {
-    id?: string;
-};
-type FieldType = 'string' | 'number' | 'boolean' | 'enum' | 'geopoint' | `vector[${number}]` | 'string[]' | 'number[]' | 'boolean[]' | 'enum[]';
-type SchemaDefinition = {
-    [field: string]: FieldType | SchemaDefinition;
-};
-type VectorQuantizationMode = 'sq8' | 'none';
-interface VectorIndexConfig {
-    threshold?: number;
-    filterThreshold?: number;
-    hnswConfig?: {
-        m?: number;
-        efConstruction?: number;
-        metric?: 'cosine' | 'dotProduct' | 'euclidean';
-    };
-    quantization?: VectorQuantizationMode;
-}
-interface EmbeddingFieldConfig {
-    adapter?: EmbeddingAdapter;
-    fields: Record<string, string | string[]>;
-}
-interface IndexConfig {
-    schema: SchemaDefinition;
-    language?: string;
-    partitions?: PartitionConfig;
-    defaultScoring?: ScoringMode;
-    bm25?: BM25Params;
-    stopWords?: Set<string> | ((defaults: Set<string>) => Set<string>);
-    tokenizer?: CustomTokenizer;
-    trackPositions?: boolean;
-    vectorPromotion?: VectorIndexConfig;
-    strict?: boolean;
-    embedding?: EmbeddingFieldConfig;
-    required?: string[];
-}
-interface BM25Params {
-    k1?: number;
-    b?: number;
-}
-interface CustomTokenizer {
-    tokenize(text: string): Array<{
-        token: string;
-        position: number;
-    }>;
-}
-interface PartitionConfig {
-    maxDocsPerPartition?: number;
-    maxPartitions?: number;
-}
-type ScoringMode = 'local' | 'dfs' | 'broadcast';
-interface InsertOptions {
-    skipClone?: boolean;
-}
+export { A as ArrayFilter, B as BatchResult, C as ComparisonFilter, E as ErrorCode, a as ErrorCodes, F as FacetConfig, b as FacetResult, c as FilterExpression, d as FlushConfig, G as GeoPolygonFilter, e as GeoRadiusFilter, f as GroupConfig, g as GroupReducer, h as GroupResult, H as HighlightConfig, i as HighlightMatch, j as Hit, k as HybridConfig, I as IndexContext, l as IndexInfo, m as IndexStats, n as InsertContext, M as MemoryStats, N as NarsilConfig, o as NarsilError, p as NarsilPlugin, P as PartitionContext, q as PartitionStatsResult, r as PreflightResult, s as PresenceFilter, t as ProcessMemoryReport, Q as QueryParams, u as QueryResult, R as RemoveContext, S as ScoreComponents, v as SearchContext, w as SearchMode, x as StringFilter, y as SuggestParams, z as SuggestResult, T as TermMatchPolicy, U as UpdateContext, V as VectorMaintenanceResult, D as VectorQueryConfig, W as WorkerConfig, J as WorkerContext } from './config-DX--2Owg.js';
+import { L as LanguageModule } from './language-ONQ3iVDf.js';
+export { N as Narsil, a as NarsilEventMap, c as createNarsil } from './narsil-B3jKyXCr.js';
+export { E as EmbeddingAdapter, I as InvalidationAdapter, a as InvalidationEvent, P as PartitionStatistics, b as PersistenceAdapter } from './adapters-Bo2JQg8b.js';
+export { A as AnyDocument, B as BM25Params, C as CustomTokenizer, E as EmbeddingFieldConfig, F as FieldType, I as IndexConfig, a as InsertOptions, P as PartitionConfig, S as SchemaDefinition, b as ScoringMode } from './schema-C3VhNvfw.js';
 
 declare function configureNormalizationCache(maxSize: number): void;
 declare function clearNormalizationCache(): void;
 declare function resetNormalizationCache(): void;
 declare function getNormalizationCacheSize(): number;
 
-declare const ErrorCodes: {
-    readonly SCHEMA_INVALID_TYPE: "SCHEMA_INVALID_TYPE";
-    readonly SCHEMA_MISSING_FIELD: "SCHEMA_MISSING_FIELD";
-    readonly SCHEMA_DEPTH_EXCEEDED: "SCHEMA_DEPTH_EXCEEDED";
-    readonly SCHEMA_INVALID_VECTOR_DIMENSION: "SCHEMA_INVALID_VECTOR_DIMENSION";
-    readonly SCHEMA_INVALID_GEOPOINT: "SCHEMA_INVALID_GEOPOINT";
-    readonly DOC_NOT_FOUND: "DOC_NOT_FOUND";
-    readonly DOC_ALREADY_EXISTS: "DOC_ALREADY_EXISTS";
-    readonly DOC_VALIDATION_FAILED: "DOC_VALIDATION_FAILED";
-    readonly INDEX_NOT_FOUND: "INDEX_NOT_FOUND";
-    readonly INDEX_ALREADY_EXISTS: "INDEX_ALREADY_EXISTS";
-    readonly PARTITION_CORRUPTED: "PARTITION_CORRUPTED";
-    readonly PARTITION_REBALANCING_BACKPRESSURE: "PARTITION_REBALANCING_BACKPRESSURE";
-    readonly WORKER_CRASHED: "WORKER_CRASHED";
-    readonly WORKER_BUSY: "WORKER_BUSY";
-    readonly WORKER_TIMEOUT: "WORKER_TIMEOUT";
-    readonly PERSISTENCE_SAVE_FAILED: "PERSISTENCE_SAVE_FAILED";
-    readonly PERSISTENCE_LOAD_FAILED: "PERSISTENCE_LOAD_FAILED";
-    readonly PERSISTENCE_DELETE_FAILED: "PERSISTENCE_DELETE_FAILED";
-    readonly PERSISTENCE_CRC_MISMATCH: "PERSISTENCE_CRC_MISMATCH";
-    readonly SEARCH_INVALID_FIELD: "SEARCH_INVALID_FIELD";
-    readonly SEARCH_INVALID_VECTOR_SIZE: "SEARCH_INVALID_VECTOR_SIZE";
-    readonly VECTOR_DIMENSION_MISMATCH: "VECTOR_DIMENSION_MISMATCH";
-    readonly SEARCH_INVALID_FILTER: "SEARCH_INVALID_FILTER";
-    readonly SEARCH_INVALID_MODE: "SEARCH_INVALID_MODE";
-    readonly SEARCH_INVALID_CURSOR: "SEARCH_INVALID_CURSOR";
-    readonly LANGUAGE_NOT_SUPPORTED: "LANGUAGE_NOT_SUPPORTED";
-    readonly ENVELOPE_VERSION_MISMATCH: "ENVELOPE_VERSION_MISMATCH";
-    readonly ENVELOPE_INVALID_MAGIC: "ENVELOPE_INVALID_MAGIC";
-    readonly PARTITION_CAPACITY_EXCEEDED: "PARTITION_CAPACITY_EXCEEDED";
-    readonly EMBEDDING_FAILED: "EMBEDDING_FAILED";
-    readonly EMBEDDING_DIMENSION_MISMATCH: "EMBEDDING_DIMENSION_MISMATCH";
-    readonly EMBEDDING_NO_SOURCE: "EMBEDDING_NO_SOURCE";
-    readonly EMBEDDING_CONFIG_INVALID: "EMBEDDING_CONFIG_INVALID";
-    readonly DOC_MISSING_REQUIRED_FIELD: "DOC_MISSING_REQUIRED_FIELD";
-    readonly CONFIG_INVALID: "CONFIG_INVALID";
-};
-type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
-declare class NarsilError extends Error {
-    readonly code: ErrorCode;
-    readonly details: Record<string, unknown>;
-    constructor(code: ErrorCode, message: string, details?: Record<string, unknown>);
-}
-
 declare function registerLanguage(module: LanguageModule): void;
 declare function getLanguage(name: string): LanguageModule;
 
-interface QueryResult<T = AnyDocument> {
-    hits: Array<Hit<T>>;
-    count: number;
-    elapsed: number;
-    cursor?: string;
-    facets?: Record<string, FacetResult>;
-    groups?: GroupResult[];
-}
-interface Hit<T = AnyDocument> {
-    id: string;
-    score: number;
-    document: T;
-    scoreComponents?: ScoreComponents;
-    highlights?: Record<string, HighlightMatch>;
-}
-interface ScoreComponents {
-    termFrequencies: Record<string, number>;
-    fieldLengths: Record<string, number>;
-    idf: Record<string, number>;
-}
-interface HighlightMatch {
-    snippet: string;
-    positions: Array<{
-        start: number;
-        end: number;
-    }>;
-}
-interface FacetResult {
-    values: Record<string, number>;
-    count: number;
-}
-interface GroupResult {
-    values: Record<string, unknown>;
-    hits: Array<Hit>;
-}
-interface PreflightResult {
-    count: number;
-    elapsed: number;
-}
-interface BatchResult {
-    succeeded: string[];
-    failed: Array<{
-        docId: string;
-        error: NarsilError;
-    }>;
-}
-interface IndexStats {
-    documentCount: number;
-    partitionCount: number;
-    memoryBytes: number;
-    indexSizeBytes: number;
-    language: string;
-    schema: SchemaDefinition;
-}
-interface IndexInfo {
-    name: string;
-    documentCount: number;
-    partitionCount: number;
-    language: string;
-}
-interface PartitionStatsResult {
-    partitionId: number;
-    documentCount: number;
-    estimatedMemoryBytes: number;
-}
-interface SuggestResult {
-    terms: Array<{
-        term: string;
-        documentFrequency: number;
-    }>;
-    elapsed: number;
-}
-interface MemoryStats {
-    totalBytes: number;
-    workers: Array<{
-        workerId: number;
-        heapUsed: number;
-        heapTotal: number;
-        external: number;
-    }>;
-}
-interface VectorMaintenanceResult {
-    fieldName: string;
-    tombstoneRatio: number;
-    graphCount: number;
-    bufferSize: number;
-    building: boolean;
-    estimatedCompactMs: number;
-    estimatedOptimizeMs: number;
-}
-
-type ComparisonFilter = {
-    eq?: number | string | boolean;
-    ne?: number | string | boolean;
-    gt?: number;
-    lt?: number;
-    gte?: number;
-    lte?: number;
-    between?: [number, number];
-};
-type StringFilter = ComparisonFilter & {
-    in?: string[];
-    nin?: string[];
-    startsWith?: string;
-    endsWith?: string;
-};
-type ArrayFilter = {
-    containsAll?: (string | number | boolean)[];
-    matchesAny?: (string | number | boolean)[];
-    size?: ComparisonFilter;
-};
-type PresenceFilter = {
-    exists?: boolean;
-    notExists?: boolean;
-    isEmpty?: boolean;
-    isNotEmpty?: boolean;
-};
-type GeoRadiusFilter = {
-    radius: {
-        lat: number;
-        lon: number;
-        distance: number;
-        unit: 'km' | 'mi' | 'm';
-        inside?: boolean;
-        highPrecision?: boolean;
-    };
-};
-type GeoPolygonFilter = {
-    polygon: {
-        points: Array<{
-            lat: number;
-            lon: number;
-        }>;
-        inside?: boolean;
-    };
-};
-type GeoFilter = GeoRadiusFilter | GeoPolygonFilter;
-type FieldFilter = ComparisonFilter | StringFilter | ArrayFilter | PresenceFilter | GeoFilter;
-type FilterExpression = {
-    fields?: Record<string, FieldFilter>;
-    and?: FilterExpression[];
-    or?: FilterExpression[];
-    not?: FilterExpression;
-};
-
-type SearchMode = 'fulltext' | 'vector' | 'hybrid';
-type TermMatchPolicy = 'all' | 'any' | number;
-interface QueryParams {
-    term?: string;
-    fields?: string[];
-    filters?: FilterExpression;
-    boost?: Record<string, number>;
-    scoring?: ScoringMode;
-    minScore?: number;
-    termMatch?: TermMatchPolicy;
-    tolerance?: number;
-    prefixLength?: number;
-    exact?: boolean;
-    facets?: FacetConfig;
-    sort?: Record<string, 'asc' | 'desc'>;
-    group?: GroupConfig;
-    limit?: number;
-    offset?: number;
-    searchAfter?: string;
-    highlight?: HighlightConfig;
-    pinned?: Array<{
-        docId: string;
-        position: number;
-    }>;
-    mode?: SearchMode;
-    vector?: VectorQueryConfig;
-    hybrid?: HybridConfig;
-    includeScoreComponents?: boolean;
-}
-interface VectorQueryConfig {
-    field: string;
-    value?: number[];
-    text?: string;
-    similarity?: number;
-    metric?: 'cosine' | 'dotProduct' | 'euclidean';
-    efSearch?: number;
-}
-interface HybridConfig {
-    strategy?: 'rrf' | 'linear';
-    k?: number;
-    alpha?: number;
-}
-interface FacetConfig {
-    [field: string]: {
-        limit?: number;
-        sort?: 'asc' | 'desc';
-        ranges?: Array<{
-            from: number;
-            to: number;
-        }>;
-    };
-}
-interface GroupConfig {
-    fields: string[];
-    maxPerGroup?: number;
-    reduce?: GroupReducer;
-}
-type GroupReducer = {
-    reducer: (accumulator: unknown, doc: AnyDocument, score: number) => unknown;
-    initialValue: () => unknown;
-};
-interface HighlightConfig {
-    fields: string[];
-    preTag?: string;
-    postTag?: string;
-    maxSnippetLength?: number;
-}
-interface SuggestParams {
-    prefix: string;
-    limit?: number;
-}
-
-interface NarsilPlugin {
-    name: string;
-    beforeInsert?(ctx: InsertContext): void | Promise<void>;
-    afterInsert?(ctx: InsertContext): void | Promise<void>;
-    beforeRemove?(ctx: RemoveContext): void | Promise<void>;
-    afterRemove?(ctx: RemoveContext): void | Promise<void>;
-    beforeUpdate?(ctx: UpdateContext): void | Promise<void>;
-    afterUpdate?(ctx: UpdateContext): void | Promise<void>;
-    beforeSearch?(ctx: SearchContext): void | Promise<void>;
-    afterSearch?(ctx: SearchContext): void | Promise<void>;
-    onIndexCreate?(ctx: IndexContext): void | Promise<void>;
-    onIndexDrop?(ctx: IndexContext): void | Promise<void>;
-    onPartitionSplit?(ctx: PartitionContext): void | Promise<void>;
-    onWorkerPromote?(ctx: WorkerContext): void | Promise<void>;
-}
-interface InsertContext {
-    indexName: string;
-    docId: string;
-    document: AnyDocument;
-}
-interface RemoveContext {
-    indexName: string;
-    docId: string;
-}
-interface UpdateContext {
-    indexName: string;
-    docId: string;
-    oldDocument: AnyDocument;
-    newDocument: AnyDocument;
-}
-interface SearchContext {
-    indexName: string;
-    params: QueryParams;
-    results?: QueryResult;
-}
-interface IndexContext {
-    indexName: string;
-    config: IndexConfig;
-}
-interface PartitionContext {
-    indexName: string;
-    oldPartitionCount: number;
-    newPartitionCount: number;
-}
-interface WorkerContext {
-    workerCount: number;
-    reason: string;
-}
-
-interface NarsilConfig {
-    persistence?: PersistenceAdapter;
-    invalidation?: InvalidationAdapter;
-    plugins?: NarsilPlugin[];
-    idGenerator?: () => string;
-    workers?: WorkerConfig;
-    flush?: FlushConfig;
-    eagerLoad?: boolean;
-    embedding?: EmbeddingAdapter;
-}
-interface WorkerConfig {
-    enabled?: boolean;
-    count?: number;
-    promotionThreshold?: number;
-    totalPromotionThreshold?: number;
-}
-interface FlushConfig {
-    interval?: number;
-    mutationThreshold?: number;
-}
-
-type NarsilEventMap = {
-    persistenceError: {
-        indexName: string;
-        partitionId: number;
-        error: Error;
-        retriesExhausted: boolean;
-    };
-    workerCrash: {
-        workerId: number;
-        indexNames: string[];
-        error: Error;
-    };
-    workerPromote: {
-        workerCount: number;
-        reason: string;
-    };
-    partitionRebalance: {
-        indexName: string;
-        oldCount: number;
-        newCount: number;
-    };
-};
-
-interface Narsil {
-    createIndex(name: string, config: IndexConfig): Promise<void>;
-    dropIndex(name: string): Promise<void>;
-    listIndexes(): IndexInfo[];
-    getStats(indexName: string): IndexStats;
-    getPartitionStats(indexName: string): PartitionStatsResult[];
-    insert(indexName: string, document: AnyDocument, docId?: string, options?: InsertOptions): Promise<string>;
-    insertBatch(indexName: string, documents: AnyDocument[], options?: InsertOptions): Promise<BatchResult>;
-    remove(indexName: string, docId: string): Promise<void>;
-    removeBatch(indexName: string, docIds: string[]): Promise<BatchResult>;
-    update(indexName: string, docId: string, document: AnyDocument): Promise<void>;
-    updateBatch(indexName: string, updates: Array<{
-        docId: string;
-        document: AnyDocument;
-    }>): Promise<BatchResult>;
-    get(indexName: string, docId: string): Promise<AnyDocument | undefined>;
-    getMultiple(indexName: string, docIds: string[]): Promise<Map<string, AnyDocument>>;
-    has(indexName: string, docId: string): Promise<boolean>;
-    countDocuments(indexName: string): Promise<number>;
-    query<T = AnyDocument>(indexName: string, params: QueryParams): Promise<QueryResult<T>>;
-    preflight(indexName: string, params: QueryParams): Promise<PreflightResult>;
-    suggest(indexName: string, params: SuggestParams): Promise<SuggestResult>;
-    snapshot(indexName: string): Promise<Uint8Array>;
-    restore(indexName: string, data: Uint8Array): Promise<void>;
-    clear(indexName: string): Promise<void>;
-    rebalance(indexName: string, targetPartitionCount: number): Promise<void>;
-    updatePartitionConfig(indexName: string, config: Partial<PartitionConfig>): Promise<void>;
-    getMemoryStats(): MemoryStats;
-    compactVectors(indexName: string, fieldName?: string): Promise<void>;
-    optimizeVectors(indexName: string, fieldName?: string): Promise<void>;
-    vectorMaintenanceStatus(indexName: string): VectorMaintenanceResult[];
-    on<K extends keyof NarsilEventMap>(event: K, handler: (payload: NarsilEventMap[K]) => void): void;
-    off<K extends keyof NarsilEventMap>(event: K, handler: (payload: NarsilEventMap[K]) => void): void;
-    shutdown(): Promise<void>;
-}
-declare function createNarsil(config?: NarsilConfig): Promise<Narsil>;
-
 declare function isSimdAvailable(): boolean;
 
 declare const VERSION = "0.1.0";
 
-export { type AnyDocument, type ArrayFilter, type BM25Params, type BatchResult, type ComparisonFilter, type CustomTokenizer, EmbeddingAdapter, type EmbeddingFieldConfig, type ErrorCode, ErrorCodes, type FacetConfig, type FacetResult, type FieldType, type FilterExpression, type FlushConfig, type GeoPolygonFilter, type GeoRadiusFilter, type GroupConfig, type GroupReducer, type GroupResult, type HighlightConfig, type HighlightMatch, type Hit, type HybridConfig, type IndexConfig, type IndexContext, type IndexInfo, type IndexStats, type InsertContext, type InsertOptions, InvalidationAdapter, LanguageModule, type MemoryStats, type Narsil, type NarsilConfig, NarsilError, type NarsilEventMap, type NarsilPlugin, type PartitionConfig, type PartitionContext, type PartitionStatsResult, PersistenceAdapter, type PreflightResult, type PresenceFilter, type QueryParams, type QueryResult, type RemoveContext, type SchemaDefinition, type ScoreComponents, type ScoringMode, type SearchContext, type SearchMode, type StringFilter, type SuggestParams, type SuggestResult, type TermMatchPolicy, type UpdateContext, VERSION, type VectorMaintenanceResult, type VectorQueryConfig, type WorkerConfig, type WorkerContext, clearNormalizationCache, configureNormalizationCache, createNarsil, getLanguage, getNormalizationCacheSize, isSimdAvailable, registerLanguage, resetNormalizationCache };
+export { LanguageModule, VERSION, clearNormalizationCache, configureNormalizationCache, getLanguage, getNormalizationCacheSize, isSimdAvailable, registerLanguage, resetNormalizationCache };