aifastdb 0.2.1

package/dist/types.d.ts

@@ -0,0 +1,475 @@
+/**
+ * TypeScript type definitions for AiFastDb
+ */
+import type { MemoryNode, SearchResult, FilterCondition, Collection, CollectionStats } from './native';
+/**
+ * Collection configuration for creating new collections
+ */
+export interface CollectionConfig {
+    /** Collection name */
+    name: string;
+    /** Vector dimension */
+    dimension: number;
+    /** Optional description */
+    description?: string;
+    /** Custom metadata */
+    metadata?: Record<string, unknown>;
+    /** Foreign key constraints */
+    foreignKeys?: ForeignKeyConfig[];
+}
+/**
+ * Action to take when a referenced record is deleted
+ */
+export type OnDeleteAction = 'restrict' | 'cascade' | 'set_null' | 'no_action';
+/**
+ * Foreign key configuration
+ */
+export interface ForeignKeyConfig {
+    /** Field name in this collection that holds the foreign key value */
+    field: string;
+    /** Name of the referenced collection */
+    references: string;
+    /** Field in the referenced collection (default: "id") */
+    referenceField?: string;
+    /** Action when the referenced record is deleted */
+    onDelete?: OnDeleteAction;
+    /** Alias for the populated field (optional) */
+    alias?: string;
+}
+/**
+ * Result of foreign key validation
+ */
+export interface ForeignKeyValidationResult {
+    /** Whether all foreign keys are valid */
+    valid: boolean;
+    /** Error messages for invalid foreign keys */
+    errors: string[];
+}
+/**
+ * Result of cascade delete operation
+ */
+export interface CascadeDeleteResult {
+    /** IDs deleted from each collection { collectionName: string[] } */
+    deleted: Record<string, string[]>;
+    /** IDs with null set in each collection { collectionName: string[] } */
+    nullified: Record<string, string[]>;
+}
+/**
+ * Configuration for populating (joining) related documents
+ * Similar to Mongoose's populate()
+ */
+export interface PopulateConfig {
+    /** Foreign key field to populate */
+    field: string;
+    /** Target collection (optional, inferred from foreign key config if not set) */
+    from?: string;
+    /** Alias for the populated field in results */
+    alias?: string;
+    /** Fields to select from the referenced document (optional, all if not set) */
+    select?: string[];
+    /** Nested populations (optional) */
+    populate?: PopulateConfig[];
+}
+/**
+ * Helper to create a populate config
+ */
+export declare function populate(field: string, options?: Omit<PopulateConfig, 'field'>): PopulateConfig;
+/**
+ * Helper to create a foreign key config
+ */
+export declare function foreignKey(field: string, references: string, options?: Omit<ForeignKeyConfig, 'field' | 'references'>): ForeignKeyConfig;
+/**
+ * Extended query options with collection support
+ */
+export interface MultiCollectionQueryOptions {
+    /** Text query */
+    query?: string;
+    /** Vector embedding to search for */
+    vector?: number[];
+    /** Weight for vector search (0-1) */
+    vectorWeight?: number;
+    /** Weight for text search (0-1) */
+    textWeight?: number;
+    /** Metadata filters */
+    filters?: FilterCondition[];
+    /** Time range start (Unix ms) */
+    timeStart?: number;
+    /** Time range end (Unix ms) */
+    timeEnd?: number;
+    /** Minimum importance threshold */
+    minImportance?: number;
+    /** Maximum number of results */
+    limit?: number;
+    /** Result offset */
+    offset?: number;
+    /** Collections to search in (empty = default collection only) */
+    collections?: string[];
+}
+export type { Collection, CollectionStats };
+/**
+ * Embedding function type
+ * Takes text content and returns a vector embedding
+ */
+export type EmbeddingFunction = (text: string) => Promise<number[]>;
+/**
+ * Batch embedding function type
+ */
+export type BatchEmbeddingFunction = (texts: string[]) => Promise<number[][]>;
+/**
+ * Embedding provider configuration
+ */
+export interface EmbeddingProvider {
+    /** Generate embedding for a single text */
+    embed: EmbeddingFunction;
+    /** Generate embeddings for multiple texts (optional, for efficiency) */
+    embedBatch?: BatchEmbeddingFunction;
+    /** Vector dimension */
+    dimension: number;
+}
+/**
+ * OpenAI embedding configuration
+ */
+export interface OpenAIEmbeddingConfig {
+    /** OpenAI API key */
+    apiKey: string;
+    /** Model name (default: text-embedding-ada-002) */
+    model?: string;
+    /** Base URL for API (optional, for Azure or proxies) */
+    baseUrl?: string;
+}
+/**
+ * Memory with computed properties
+ */
+export interface EnrichedMemory extends MemoryNode {
+    /** Computed current importance with decay */
+    currentImportance: number;
+    /** Age in milliseconds */
+    ageMs: number;
+    /** Human-readable age */
+    ageHuman: string;
+}
+/**
+ * Query result with enriched data
+ */
+export interface EnrichedSearchResult extends SearchResult {
+    node: EnrichedMemory;
+    /** Score breakdown */
+    breakdown?: {
+        vectorScore?: number;
+        textScore?: number;
+        importanceScore?: number;
+        recencyScore?: number;
+    };
+}
+/**
+ * Chunking options for document ingestion
+ */
+export interface ChunkingOptions {
+    /** Maximum chunk size in characters */
+    maxChunkSize?: number;
+    /** Overlap between chunks */
+    overlap?: number;
+    /** Chunking strategy */
+    strategy?: 'sentence' | 'paragraph' | 'fixed' | 'semantic';
+    /** Separator for splitting */
+    separator?: string | RegExp;
+}
+/**
+ * Document to ingest
+ */
+export interface Document {
+    /** Document content */
+    content: string;
+    /** Document metadata */
+    metadata?: Record<string, unknown>;
+    /** Document ID (optional, will be generated if not provided) */
+    id?: string;
+}
+/**
+ * Ingestion result
+ */
+export interface IngestionResult {
+    /** Document ID */
+    documentId: string;
+    /** Created chunk IDs */
+    chunkIds: string[];
+    /** Number of chunks created */
+    chunkCount: number;
+}
+/**
+ * Entity for knowledge graph
+ */
+export interface Entity {
+    id: string;
+    name: string;
+    entityType: string;
+    properties: Record<string, unknown>;
+    memoryRefs: string[];
+    createdAt: number;
+    updatedAt: number;
+}
+/**
+ * Relation for knowledge graph
+ */
+export interface Relation {
+    id: string;
+    source: string;
+    target: string;
+    relationType: string;
+    weight: number;
+    bidirectional: boolean;
+    metadata: Record<string, unknown>;
+    createdAt: number;
+}
+/**
+ * Graph traversal result
+ */
+export interface GraphTraversalResult {
+    entity: Entity;
+    depth: number;
+    path: string[];
+}
+/**
+ * Filter builder helpers
+ */
+export declare const Filters: {
+    eq: (field: string, value: unknown) => FilterCondition;
+    ne: (field: string, value: unknown) => FilterCondition;
+    gt: (field: string, value: unknown) => FilterCondition;
+    gte: (field: string, value: unknown) => FilterCondition;
+    lt: (field: string, value: unknown) => FilterCondition;
+    lte: (field: string, value: unknown) => FilterCondition;
+    contains: (field: string, value: unknown) => FilterCondition;
+    startsWith: (field: string, value: string) => FilterCondition;
+    endsWith: (field: string, value: string) => FilterCondition;
+    in: (field: string, values: unknown[]) => FilterCondition;
+    notIn: (field: string, values: unknown[]) => FilterCondition;
+    isNull: (field: string) => FilterCondition;
+    isNotNull: (field: string) => FilterCondition;
+    exists: (field: string) => FilterCondition;
+};
+/**
+ * Common relation types
+ */
+export declare const RelationTypes: {
+    readonly RELATES_TO: "relates_to";
+    readonly PART_OF: "part_of";
+    readonly CONTAINS: "contains";
+    readonly CAUSES: "causes";
+    readonly CAUSED_BY: "caused_by";
+    readonly SIMILAR_TO: "similar_to";
+    readonly OPPOSITE_OF: "opposite_of";
+    readonly DERIVED_FROM: "derived_from";
+    readonly INSTANCE_OF: "instance_of";
+    readonly SUBCLASS_OF: "subclass_of";
+    readonly CREATED_BY: "created_by";
+    readonly LOCATED_IN: "located_in";
+    readonly BELONGS_TO: "belongs_to";
+    readonly ASSOCIATED_WITH: "associated_with";
+};
+/**
+ * Common entity types
+ */
+export declare const EntityTypes: {
+    readonly PERSON: "person";
+    readonly ORGANIZATION: "organization";
+    readonly LOCATION: "location";
+    readonly EVENT: "event";
+    readonly CONCEPT: "concept";
+    readonly OBJECT: "object";
+    readonly DOCUMENT: "document";
+    readonly TOPIC: "topic";
+    readonly DATE: "date";
+    readonly QUANTITY: "quantity";
+};
+/**
+ * Modality types supported by perception engines
+ */
+export type Modality = 'text' | 'code' | 'audio' | 'image' | 'video';
+/**
+ * Perception engine configuration
+ */
+export interface PerceptionConfig {
+    /** Engine type: "candle" | "none" */
+    engineType?: string;
+    /** Model ID (HuggingFace model ID or local path) */
+    modelId?: string;
+    /** Output embedding dimension */
+    dimension?: number;
+    /** Device: "cpu" | "cuda" | "metal" */
+    device?: string;
+    /** Whether to auto-download model from HuggingFace */
+    autoDownload?: boolean;
+    /** Local cache directory for models */
+    cacheDir?: string;
+}
+/**
+ * Reasoning engine configuration (for LLM API)
+ */
+export interface ReasoningConfig {
+    /** Provider: "ollama" | "openai" | "azure" */
+    provider: 'ollama' | 'openai' | 'azure' | string;
+    /** API endpoint URL */
+    endpoint: string;
+    /** Model name */
+    model: string;
+    /** API key (optional for local providers like Ollama) */
+    apiKey?: string;
+    /** Request timeout in seconds */
+    timeoutSecs?: number;
+    /** Maximum tokens for generation */
+    maxTokens?: number;
+    /** Temperature (0.0 - 2.0) */
+    temperature?: number;
+}
+/**
+ * VibeSynapse configuration
+ */
+export interface VibeSynapseConfig {
+    /** Storage path for database files */
+    storage: string;
+    /** Vector dimension (default: 384 for MiniLM) */
+    dimension?: number;
+    /** HNSW index configuration */
+    hnsw?: {
+        m?: number;
+        efConstruction?: number;
+        efSearch?: number;
+        maxElements?: number;
+    };
+    /** Built-in perception engine configuration */
+    perception?: PerceptionConfig;
+    /** External reasoning engine (LLM) configuration */
+    reasoning?: ReasoningConfig;
+    /** Multimodal configuration */
+    multimodal?: {
+        /** Enable audio processing */
+        audio?: boolean;
+        /** Enable image processing */
+        image?: boolean;
+        /** Auto-generate tags from content */
+        autoTag?: boolean;
+    };
+}
+/**
+ * Multimodal input for VibeSynapse
+ */
+export interface MultimodalInput {
+    /** Input type */
+    type: Modality;
+    /** Content (text) or description */
+    content?: string;
+    /** File path (for audio/image/video) */
+    file?: string;
+    /** Raw data buffer (alternative to file) */
+    data?: Buffer;
+    /** MIME type */
+    mimeType?: string;
+    /** Tags */
+    tags?: string[];
+    /** Metadata */
+    metadata?: Record<string, unknown>;
+    /** Importance score (0-1) */
+    importance?: number;
+}
+/**
+ * Perception result
+ */
+export interface PerceptionResult {
+    /** Generated embedding vector */
+    embedding: number[];
+    /** Detected modality */
+    modality: Modality;
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** Extracted metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Reasoning result
+ */
+export interface ReasoningResult {
+    /** Generated content */
+    content: string;
+    /** Token usage */
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    /** Model used */
+    model?: string;
+}
+/**
+ * Logic check result
+ */
+export interface LogicCheckResult {
+    /** Whether statements are logically consistent */
+    consistent: boolean;
+    /** Explanation (if available) */
+    explanation?: string;
+}
+/**
+ * Cross-modal search options
+ */
+export interface CrossModalSearchOptions {
+    /** Query text */
+    query?: string;
+    /** Query embedding (alternative to query) */
+    embedding?: number[];
+    /** Filter by modality */
+    modality?: Modality | Modality[];
+    /** Tags filter */
+    tags?: string[];
+    /** Minimum importance */
+    minImportance?: number;
+    /** Maximum results */
+    limit?: number;
+    /** Time range start */
+    timeStart?: number;
+    /** Time range end */
+    timeEnd?: number;
+}
+/**
+ * Preset perception configurations
+ */
+export declare const PerceptionPresets: {
+    /** Lightweight English model (22M params, 384 dim) */
+    readonly miniLM: () => PerceptionConfig;
+    /** High-quality English model (33M params, 384 dim) */
+    readonly bgeSmall: () => PerceptionConfig;
+    /** Multilingual model (118M params, 384 dim) */
+    readonly multilingualE5: () => PerceptionConfig;
+    /**
+     * EmbeddingGemma - Google's state-of-the-art embedding model (308M params, 768 dim)
+     *
+     * Features:
+     * - Highest MTEB score among models under 500M params
+     * - Supports 100+ languages
+     * - 2048 token context window
+     * - Matryoshka representation learning (can truncate to 512/256/128 dims)
+     */
+    readonly embeddingGemma: () => PerceptionConfig;
+    /**
+     * EmbeddingGemma with Matryoshka dimension truncation
+     *
+     * @param dim - Target dimension (768, 512, 256, or 128)
+     */
+    readonly embeddingGemmaMatryoshka: (dim?: 768 | 512 | 256 | 128) => PerceptionConfig;
+    /** No perception (manual embeddings required) */
+    readonly none: () => PerceptionConfig;
+};
+/**
+ * Preset reasoning configurations
+ */
+export declare const ReasoningPresets: {
+    /** Ollama with Llama 3.2 */
+    readonly ollamaLlama: (model?: string) => ReasoningConfig;
+    /** Ollama with Gemma */
+    readonly ollamaGemma: (model?: string) => ReasoningConfig;
+    /** OpenAI GPT-4 */
+    readonly openaiGpt4: (apiKey: string) => ReasoningConfig;
+    /** OpenAI GPT-3.5 Turbo */
+    readonly openaiGpt35: (apiKey: string) => ReasoningConfig;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../ts/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAMvG;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,8BAA8B;IAC9B,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAMD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,yCAAyC;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,8CAA8C;IAC9C,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAClC,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACrC;AAMD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,GAAG,cAAc,CAE/F;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,YAAY,CAAC,GACvD,gBAAgB,CAElB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAGD,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,KAAK,EAAE,iBAAiB,CAAC;IACzB,wEAAwE;IACxE,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,6CAA6C;IAC7C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACxD,IAAI,EAAE,cAAc,CAAC;IACrB,sBAAsB;IACtB,SAAS,CAAC,EAAE;QACV,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,UAAU,CAAC;IAC3D,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,gEAAgE;IAChE,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,OAAO;gBACN,MAAM,SAAS,OAAO,KAAG,eAAe;gBACxC,MAAM,SAAS,OAAO,KAAG,eAAe;gBACxC,MAAM,SAAS,OAAO,KAAG,eAAe;iBACvC,MAAM,SAAS,OAAO,KAAG,eAAe;gBACzC,MAAM,SAAS,OAAO,KAAG,eAAe;iBACvC,MAAM,SAAS,OAAO,KAAG,eAAe;sBACnC,MAAM,SAAS,OAAO,KAAG,eAAe;wBACtC,MAAM,SAAS,MAAM,KAAG,eAAe;sBACzC,MAAM,SAAS,MAAM,KAAG,eAAe;gBAC7C,MAAM,UAAU,OAAO,EAAE,KAAG,eAAe;mBACxC,MAAM,UAAU,OAAO,EAAE,KAAG,eAAe;oBAC1C,MAAM,KAAG,eAAe;uBACrB,MAAM,KAAG,eAAe;oBAC3B,MAAM,KAAG,eAAe;CACzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;CAehB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;CAWd,CAAC;AAMX;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IACjD,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,IAAI,CAAC,EAAE;QACL,CAAC,CAAC,EAAE,MAAM,CAAC;QACX,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,+CAA+C;IAC/C,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,oDAAoD;IACpD,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,+BAA+B;IAC/B,UAAU,CAAC,EAAE;QACX,8BAA8B;QAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,8BAA8B;QAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,sCAAsC;QACtC,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iBAAiB;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,wBAAwB;IACxB,QAAQ,EAAE,QAAQ,CAAC;IACnB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,UAAU,EAAE,OAAO,CAAC;IACpB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAAC;IACjC,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,yBAAyB;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAC5B,sDAAsD;2BAC1C,gBAAgB;IAM5B,uDAAuD;6BACzC,gBAAgB;IAM9B,gDAAgD;mCAC5B,gBAAgB;IAMpC;;;;;;;;OAQG;mCACiB,gBAAgB;IAMpC;;;;OAIG;8CAC6B,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,KAAS,gBAAgB;IAM9E,iDAAiD;yBACvC,gBAAgB;CAGlB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B,4BAA4B;8CACO,eAAe;IAKlD,wBAAwB;8CACa,eAAe;IAKpD,mBAAmB;kCACE,MAAM,KAAG,eAAe;IAM7C,2BAA2B;mCACL,MAAM,KAAG,eAAe;CAMtC,CAAC"}

package/dist/types.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * TypeScript type definitions for AiFastDb
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReasoningPresets = exports.PerceptionPresets = exports.EntityTypes = exports.RelationTypes = exports.Filters = void 0;
+exports.populate = populate;
+exports.foreignKey = foreignKey;
+/**
+ * Helper to create a populate config
+ */
+function populate(field, options) {
+    return { field, ...options };
+}
+/**
+ * Helper to create a foreign key config
+ */
+function foreignKey(field, references, options) {
+    return { field, references, ...options };
+}
+/**
+ * Filter builder helpers
+ */
+exports.Filters = {
+    eq: (field, value) => ({ field, op: 'eq', value }),
+    ne: (field, value) => ({ field, op: 'ne', value }),
+    gt: (field, value) => ({ field, op: 'gt', value }),
+    gte: (field, value) => ({ field, op: 'gte', value }),
+    lt: (field, value) => ({ field, op: 'lt', value }),
+    lte: (field, value) => ({ field, op: 'lte', value }),
+    contains: (field, value) => ({ field, op: 'contains', value }),
+    startsWith: (field, value) => ({ field, op: 'starts_with', value }),
+    endsWith: (field, value) => ({ field, op: 'ends_with', value }),
+    in: (field, values) => ({ field, op: 'in', value: values }),
+    notIn: (field, values) => ({ field, op: 'not_in', value: values }),
+    isNull: (field) => ({ field, op: 'is_null', value: null }),
+    isNotNull: (field) => ({ field, op: 'is_not_null', value: null }),
+    exists: (field) => ({ field, op: 'exists', value: null }),
+};
+/**
+ * Common relation types
+ */
+exports.RelationTypes = {
+    RELATES_TO: 'relates_to',
+    PART_OF: 'part_of',
+    CONTAINS: 'contains',
+    CAUSES: 'causes',
+    CAUSED_BY: 'caused_by',
+    SIMILAR_TO: 'similar_to',
+    OPPOSITE_OF: 'opposite_of',
+    DERIVED_FROM: 'derived_from',
+    INSTANCE_OF: 'instance_of',
+    SUBCLASS_OF: 'subclass_of',
+    CREATED_BY: 'created_by',
+    LOCATED_IN: 'located_in',
+    BELONGS_TO: 'belongs_to',
+    ASSOCIATED_WITH: 'associated_with',
+};
+/**
+ * Common entity types
+ */
+exports.EntityTypes = {
+    PERSON: 'person',
+    ORGANIZATION: 'organization',
+    LOCATION: 'location',
+    EVENT: 'event',
+    CONCEPT: 'concept',
+    OBJECT: 'object',
+    DOCUMENT: 'document',
+    TOPIC: 'topic',
+    DATE: 'date',
+    QUANTITY: 'quantity',
+};
+/**
+ * Preset perception configurations
+ */
+exports.PerceptionPresets = {
+    /** Lightweight English model (22M params, 384 dim) */
+    miniLM: () => ({
+        engineType: 'candle',
+        modelId: 'sentence-transformers/all-MiniLM-L6-v2',
+        dimension: 384,
+        autoDownload: true,
+    }),
+    /** High-quality English model (33M params, 384 dim) */
+    bgeSmall: () => ({
+        engineType: 'candle',
+        modelId: 'BAAI/bge-small-en-v1.5',
+        dimension: 384,
+        autoDownload: true,
+    }),
+    /** Multilingual model (118M params, 384 dim) */
+    multilingualE5: () => ({
+        engineType: 'candle',
+        modelId: 'intfloat/multilingual-e5-small',
+        dimension: 384,
+        autoDownload: true,
+    }),
+    /**
+     * EmbeddingGemma - Google's state-of-the-art embedding model (308M params, 768 dim)
+     *
+     * Features:
+     * - Highest MTEB score among models under 500M params
+     * - Supports 100+ languages
+     * - 2048 token context window
+     * - Matryoshka representation learning (can truncate to 512/256/128 dims)
+     */
+    embeddingGemma: () => ({
+        engineType: 'embedding_gemma',
+        modelId: 'google/embeddinggemma-300m',
+        dimension: 768,
+        autoDownload: true,
+    }),
+    /**
+     * EmbeddingGemma with Matryoshka dimension truncation
+     *
+     * @param dim - Target dimension (768, 512, 256, or 128)
+     */
+    embeddingGemmaMatryoshka: (dim = 256) => ({
+        engineType: 'embedding_gemma',
+        modelId: 'google/embeddinggemma-300m',
+        dimension: dim,
+        autoDownload: true,
+    }),
+    /** No perception (manual embeddings required) */
+    none: () => ({
+        engineType: 'none',
+    }),
+};
+/**
+ * Preset reasoning configurations
+ */
+exports.ReasoningPresets = {
+    /** Ollama with Llama 3.2 */
+    ollamaLlama: (model = 'llama3.2') => ({
+        provider: 'ollama',
+        endpoint: 'http://localhost:11434/v1',
+        model,
+    }),
+    /** Ollama with Gemma */
+    ollamaGemma: (model = 'gemma3:27b') => ({
+        provider: 'ollama',
+        endpoint: 'http://localhost:11434/v1',
+        model,
+    }),
+    /** OpenAI GPT-4 */
+    openaiGpt4: (apiKey) => ({
+        provider: 'openai',
+        endpoint: 'https://api.openai.com/v1',
+        model: 'gpt-4',
+        apiKey,
+    }),
+    /** OpenAI GPT-3.5 Turbo */
+    openaiGpt35: (apiKey) => ({
+        provider: 'openai',
+        endpoint: 'https://api.openai.com/v1',
+        model: 'gpt-3.5-turbo',
+        apiKey,
+    }),
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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