harperdb 4.6.0-alpha.1 → 4.6.0-alpha.3

package/resources/databases.d.ts

@@ -80,52 +80,42 @@ export declare function table(tableDefinition: TableDefinition): {
     new (identifier: import("./ResourceInterface.js").Id, source: any): {
         "__#5@#record": any;
         "__#5@#changes": any;
-        "__#5@#version": number;
-        "__#5@#entry": {
-            key: any;
-            value: any;
-            version: number;
-            localTime: number;
-            expiresAt: number;
-            deref?: () => any;
-        };
-        "__#5@#saveMode": boolean;
-        "__#5@#loadedFromSource": boolean;
+        "__#5@#version"?: number;
+        "__#5@#entry"?: import("./RecordEncoder.ts").Entry;
+        "__#5@#saveMode"?: boolean;
+        "__#5@#loadedFromSource"?: boolean;
+        getProperty: (name: string) => any;
         ensureLoaded(): any;
-        get(query?: import("./ResourceInterface.js").Query | string): Promise<object | void> | object | void;
+        get(target?: import("./RequestTarget.js").RequestTarget): Promise<object | void> | object | void;
         allowRead(user: any, query: any): any;
         allowUpdate(user: any, updatedData: any): boolean;
         allowCreate(user: any, newData: {}): boolean;
         allowDelete(user: any): boolean;
-        update(updates?: any, fullUpdate?: boolean): /*elided*/ any;
+        update(target: import("./RequestTarget.js").RequestTarget, updates?: any): any;
         addTo(property: any, value: any): void;
         subtractFrom(property: any, value: any): void;
-        getMetadata(): {
-            key: any;
-            value: any;
-            version: number;
-            localTime: number;
-            expiresAt: number;
-            deref?: () => any;
-        };
+        getMetadata(): import("./RecordEncoder.ts").Entry;
         getRecord(): any;
         getChanges(): any;
         _setChanges(changes: any): void;
         setRecord(record: any): void;
-        invalidate(): void;
-        _writeInvalidate(partialRecord?: any, options?: any): void;
-        _writeRelocate(options: any): void;
+        invalidate(target: import("./ResourceInterface.js").RequestTargetOrId): void;
+        _writeInvalidate(id: import("./ResourceInterface.js").Id, partialRecord?: any, options?: any): void;
+        _writeRelocate(id: import("./ResourceInterface.js").Id, options: any): void;
         lock(): void;
-        put(record: any): void;
-        patch(recordUpdate: any): void;
-        _writeUpdate(recordUpdate: any, fullUpdate: boolean, options?: any): void;
-        delete(request?: import("./ResourceInterface.js").Query | string): Promise<boolean>;
-        _writeDelete(options?: any): boolean;
-        search(request: import("./ResourceInterface.js").Query): AsyncIterable<any>;
+        put(target: import("./RequestTarget.js").RequestTarget, record: any): void;
+        patch(target: import("./RequestTarget.js").RequestTarget, recordUpdate: any): void | Promise<void>;
+        _writeUpdate(id: import("./ResourceInterface.js").Id, recordUpdate: any, fullUpdate: boolean, options?: any): void;
+        delete(target: import("./RequestTarget.js").RequestTarget): Promise<boolean>;
+        _writeDelete(id: import("./ResourceInterface.js").Id, options?: any): boolean;
+        search(request: import("./RequestTarget.js").RequestTarget): AsyncIterable<any>;
         subscribe(request: import("./ResourceInterface.js").SubscriptionRequest): Promise<{
-            listener: (key: any) => any;
+            listener: (recordId: import("./ResourceInterface.js").Id, auditEntry: any, localTime: number, beginTxn: boolean) => void;
             subscriptions: [];
             startTime?: number;
+            includeDescendants?: boolean;
+            supportsTransactions?: boolean;
+            onlyChildren?: boolean;
             end(): void;
             toJSON(): {
                 name: string;
@@ -171,8 +161,8 @@ export declare function table(tableDefinition: TableDefinition): {
             eventNames(): (string | symbol)[];
         }>;
         doesExist(): boolean;
-        publish(message: any, options?: any): void;
-        _writePublish(message: any, options?: any): void;
+        publish(target: import("./RequestTarget.js").RequestTarget, message: any, options?: any): void;
+        _writePublish(id: import("./ResourceInterface.js").Id, message: any, options?: any): void;
         validate(record: any, patch?: any): void;
         getUpdatedTime(): number;
         wasLoadedFromSource(): boolean | void;
@@ -181,7 +171,7 @@ export declare function table(tableDefinition: TableDefinition): {
         "__#6@#isCollection": boolean;
         post(newRecord: any): Promise<any>;
         readonly isCollection: boolean;
-        connect(query?: {}): AsyncIterable<any>;
+        connect(incomingMessages: import("./IterableEventQueue.js").IterableEventQueue, query?: {}): AsyncIterable<any>;
         getId(): import("./ResourceInterface.js").Id;
         getContext(): import("./ResourceInterface.js").Context;
     };
@@ -199,25 +189,13 @@ export declare function table(tableDefinition: TableDefinition): {
     replicate: any;
     sealed: any;
     splitSegments: any;
-    createdTimeProperty: {
-        name: string;
-        type: string;
-        assignCreatedTime?: boolean;
-        assignUpdatedTime?: boolean;
-        expiresAt?: boolean;
-        isPrimaryKey?: boolean;
-    };
-    updatedTimeProperty: {
-        name: string;
-        type: string;
-        assignCreatedTime?: boolean;
-        assignUpdatedTime?: boolean;
-        expiresAt?: boolean;
-        isPrimaryKey?: boolean;
-    };
+    createdTimeProperty: import("./Table.ts").Attribute;
+    updatedTimeProperty: import("./Table.ts").Attribute;
     propertyResolvers: any;
     userResolvers: {};
-    sources: any[];
+    sources: (/*elided*/ any)[];
+    sourceOptions: any;
+    intermediateSource: boolean;
     getResidencyById: (id: import("./ResourceInterface.js").Id) => number | void;
     readonly expirationMS: any;
     dbisDB: any;
@@ -228,52 +206,42 @@ export declare function table(tableDefinition: TableDefinition): {
     getResource(id: import("./ResourceInterface.js").Id, request: import("./ResourceInterface.js").Context, resourceOptions?: any): Promise<{
         "__#5@#record": any;
         "__#5@#changes": any;
-        "__#5@#version": number;
-        "__#5@#entry": {
-            key: any;
-            value: any;
-            version: number;
-            localTime: number;
-            expiresAt: number;
-            deref?: () => any;
-        };
-        "__#5@#saveMode": boolean;
-        "__#5@#loadedFromSource": boolean;
+        "__#5@#version"?: number;
+        "__#5@#entry"?: import("./RecordEncoder.ts").Entry;
+        "__#5@#saveMode"?: boolean;
+        "__#5@#loadedFromSource"?: boolean;
+        getProperty: (name: string) => any;
         ensureLoaded(): any;
-        get(query?: import("./ResourceInterface.js").Query | string): Promise<object | void> | object | void;
+        get(target?: import("./RequestTarget.js").RequestTarget): Promise<object | void> | object | void;
         allowRead(user: any, query: any): any;
         allowUpdate(user: any, updatedData: any): boolean;
         allowCreate(user: any, newData: {}): boolean;
         allowDelete(user: any): boolean;
-        update(updates?: any, fullUpdate?: boolean): /*elided*/ any;
+        update(target: import("./RequestTarget.js").RequestTarget, updates?: any): any;
         addTo(property: any, value: any): void;
         subtractFrom(property: any, value: any): void;
-        getMetadata(): {
-            key: any;
-            value: any;
-            version: number;
-            localTime: number;
-            expiresAt: number;
-            deref?: () => any;
-        };
+        getMetadata(): import("./RecordEncoder.ts").Entry;
         getRecord(): any;
         getChanges(): any;
         _setChanges(changes: any): void;
         setRecord(record: any): void;
-        invalidate(): void;
-        _writeInvalidate(partialRecord?: any, options?: any): void;
-        _writeRelocate(options: any): void;
+        invalidate(target: import("./ResourceInterface.js").RequestTargetOrId): void;
+        _writeInvalidate(id: import("./ResourceInterface.js").Id, partialRecord?: any, options?: any): void;
+        _writeRelocate(id: import("./ResourceInterface.js").Id, options: any): void;
         lock(): void;
-        put(record: any): void;
-        patch(recordUpdate: any): void;
-        _writeUpdate(recordUpdate: any, fullUpdate: boolean, options?: any): void;
-        delete(request?: import("./ResourceInterface.js").Query | string): Promise<boolean>;
-        _writeDelete(options?: any): boolean;
-        search(request: import("./ResourceInterface.js").Query): AsyncIterable<any>;
+        put(target: import("./RequestTarget.js").RequestTarget, record: any): void;
+        patch(target: import("./RequestTarget.js").RequestTarget, recordUpdate: any): void | Promise<void>;
+        _writeUpdate(id: import("./ResourceInterface.js").Id, recordUpdate: any, fullUpdate: boolean, options?: any): void;
+        delete(target: import("./RequestTarget.js").RequestTarget): Promise<boolean>;
+        _writeDelete(id: import("./ResourceInterface.js").Id, options?: any): boolean;
+        search(request: import("./RequestTarget.js").RequestTarget): AsyncIterable<any>;
         subscribe(request: import("./ResourceInterface.js").SubscriptionRequest): Promise<{
-            listener: (key: any) => any;
+            listener: (recordId: import("./ResourceInterface.js").Id, auditEntry: any, localTime: number, beginTxn: boolean) => void;
             subscriptions: [];
             startTime?: number;
+            includeDescendants?: boolean;
+            supportsTransactions?: boolean;
+            onlyChildren?: boolean;
             end(): void;
             toJSON(): {
                 name: string;
@@ -319,8 +287,8 @@ export declare function table(tableDefinition: TableDefinition): {
             eventNames(): (string | symbol)[];
         }>;
         doesExist(): boolean;
-        publish(message: any, options?: any): void;
-        _writePublish(message: any, options?: any): void;
+        publish(target: import("./RequestTarget.js").RequestTarget, message: any, options?: any): void;
+        _writePublish(id: import("./ResourceInterface.js").Id, message: any, options?: any): void;
         validate(record: any, patch?: any): void;
         getUpdatedTime(): number;
         wasLoadedFromSource(): boolean | void;
@@ -329,58 +297,48 @@ export declare function table(tableDefinition: TableDefinition): {
         "__#6@#isCollection": boolean;
         post(newRecord: any): Promise<any>;
         readonly isCollection: boolean;
-        connect(query?: {}): AsyncIterable<any>;
+        connect(incomingMessages: import("./IterableEventQueue.js").IterableEventQueue, query?: {}): AsyncIterable<any>;
         getId(): import("./ResourceInterface.js").Id;
         getContext(): import("./ResourceInterface.js").Context;
     }> | {
         "__#5@#record": any;
         "__#5@#changes": any;
-        "__#5@#version": number;
-        "__#5@#entry": {
-            key: any;
-            value: any;
-            version: number;
-            localTime: number;
-            expiresAt: number;
-            deref?: () => any;
-        };
-        "__#5@#saveMode": boolean;
-        "__#5@#loadedFromSource": boolean;
+        "__#5@#version"?: number;
+        "__#5@#entry"?: import("./RecordEncoder.ts").Entry;
+        "__#5@#saveMode"?: boolean;
+        "__#5@#loadedFromSource"?: boolean;
+        getProperty: (name: string) => any;
         ensureLoaded(): any;
-        get(query?: import("./ResourceInterface.js").Query | string): Promise<object | void> | object | void;
+        get(target?: import("./RequestTarget.js").RequestTarget): Promise<object | void> | object | void;
         allowRead(user: any, query: any): any;
         allowUpdate(user: any, updatedData: any): boolean;
         allowCreate(user: any, newData: {}): boolean;
         allowDelete(user: any): boolean;
-        update(updates?: any, fullUpdate?: boolean): /*elided*/ any;
+        update(target: import("./RequestTarget.js").RequestTarget, updates?: any): any;
         addTo(property: any, value: any): void;
         subtractFrom(property: any, value: any): void;
-        getMetadata(): {
-            key: any;
-            value: any;
-            version: number;
-            localTime: number;
-            expiresAt: number;
-            deref?: () => any;
-        };
+        getMetadata(): import("./RecordEncoder.ts").Entry;
         getRecord(): any;
         getChanges(): any;
         _setChanges(changes: any): void;
         setRecord(record: any): void;
-        invalidate(): void;
-        _writeInvalidate(partialRecord?: any, options?: any): void;
-        _writeRelocate(options: any): void;
+        invalidate(target: import("./ResourceInterface.js").RequestTargetOrId): void;
+        _writeInvalidate(id: import("./ResourceInterface.js").Id, partialRecord?: any, options?: any): void;
+        _writeRelocate(id: import("./ResourceInterface.js").Id, options: any): void;
         lock(): void;
-        put(record: any): void;
-        patch(recordUpdate: any): void;
-        _writeUpdate(recordUpdate: any, fullUpdate: boolean, options?: any): void;
-        delete(request?: import("./ResourceInterface.js").Query | string): Promise<boolean>;
-        _writeDelete(options?: any): boolean;
-        search(request: import("./ResourceInterface.js").Query): AsyncIterable<any>;
+        put(target: import("./RequestTarget.js").RequestTarget, record: any): void;
+        patch(target: import("./RequestTarget.js").RequestTarget, recordUpdate: any): void | Promise<void>;
+        _writeUpdate(id: import("./ResourceInterface.js").Id, recordUpdate: any, fullUpdate: boolean, options?: any): void;
+        delete(target: import("./RequestTarget.js").RequestTarget): Promise<boolean>;
+        _writeDelete(id: import("./ResourceInterface.js").Id, options?: any): boolean;
+        search(request: import("./RequestTarget.js").RequestTarget): AsyncIterable<any>;
         subscribe(request: import("./ResourceInterface.js").SubscriptionRequest): Promise<{
-            listener: (key: any) => any;
+            listener: (recordId: import("./ResourceInterface.js").Id, auditEntry: any, localTime: number, beginTxn: boolean) => void;
             subscriptions: [];
             startTime?: number;
+            includeDescendants?: boolean;
+            supportsTransactions?: boolean;
+            onlyChildren?: boolean;
             end(): void;
             toJSON(): {
                 name: string;
@@ -426,8 +384,8 @@ export declare function table(tableDefinition: TableDefinition): {
             eventNames(): (string | symbol)[];
         }>;
         doesExist(): boolean;
-        publish(message: any, options?: any): void;
-        _writePublish(message: any, options?: any): void;
+        publish(target: import("./RequestTarget.js").RequestTarget, message: any, options?: any): void;
+        _writePublish(id: import("./ResourceInterface.js").Id, message: any, options?: any): void;
         validate(record: any, patch?: any): void;
         getUpdatedTime(): number;
         wasLoadedFromSource(): boolean | void;
@@ -436,7 +394,7 @@ export declare function table(tableDefinition: TableDefinition): {
         "__#6@#isCollection": boolean;
         post(newRecord: any): Promise<any>;
         readonly isCollection: boolean;
-        connect(query?: {}): AsyncIterable<any>;
+        connect(incomingMessages: import("./IterableEventQueue.js").IterableEventQueue, query?: {}): AsyncIterable<any>;
         getId(): import("./ResourceInterface.js").Id;
         getContext(): import("./ResourceInterface.js").Context;
     };
@@ -447,7 +405,7 @@ export declare function table(tableDefinition: TableDefinition): {
         eviction?: number;
         scanInterval?: number;
     }): void;
-    getResidencyRecord(id: any): any;
+    getResidencyRecord(id: import("./ResourceInterface.js").Id): any;
     setResidency(getResidency?: (record: object, context: import("./ResourceInterface.js").Context) => number | void | string[]): void;
     setResidencyById(getResidencyById?: (id: import("./ResourceInterface.js").Id) => number | void): void;
     getResidency(record: object, context: import("./ResourceInterface.js").Context): number | void | string[];
@@ -458,7 +416,7 @@ export declare function table(tableDefinition: TableDefinition): {
     evict(id: any, existingRecord: any, existingVersion: any): Promise<void>;
     operation(operation: any, context: any): any;
     transformToOrderedSelect(entries: any[], select: (string | import("./ResourceInterface.js").SubSelect)[], sort: import("./ResourceInterface.js").Sort, context: import("./ResourceInterface.js").Context, readTxn: any, transformToRecord: Function): any;
-    transformEntryForSelect(select: any, context: any, readTxn: any, filtered: any, ensure_loaded?: any, canSkip?: any): (entry: any) => any;
+    transformEntryForSelect(select: any, context: any, readTxn: any, filtered: any, ensure_loaded?: any, canSkip?: any): (entry: import("./RecordEncoder.ts").Entry) => any;
     subscribeOnThisThread(workerIndex: any, options: any): boolean;
     addAttributes(attributesToAdd: any): Promise<any>;
     removeAttributes(names: string[]): Promise<any>;
@@ -494,14 +452,15 @@ export declare function table(tableDefinition: TableDefinition): {
         timestamp: number;
     };
     directURLMapping: boolean;
+    loadAsInstance: boolean;
     get(identifier: import("./ResourceInterface.js").Id, context?: import("./ResourceInterface.js").Context): Promise<import("./Resource.js").Resource>;
-    get(query: import("./ResourceInterface.js").Query, context?: import("./ResourceInterface.js").Context): Promise<AsyncIterable<object>>;
+    get(target: import("./RequestTarget.js").RequestTarget, context?: import("./ResourceInterface.js").Context): Promise<AsyncIterable<object>>;
     put: {
-        (idOrQuery: string | import("./ResourceInterface.js").Id, dataOrContext?: any, context?: import("./ResourceInterface.js").Context): any;
+        (idOrQuery: string | import("./ResourceInterface.js").Id | import("./ResourceInterface.js").Query, dataOrContext?: any, context?: import("./ResourceInterface.js").Context): any;
         reliesOnPrototype: boolean;
     };
     patch: {
-        (idOrQuery: string | import("./ResourceInterface.js").Id, dataOrContext?: any, context?: import("./ResourceInterface.js").Context): any;
+        (idOrQuery: string | import("./ResourceInterface.js").Id | import("./ResourceInterface.js").Query, dataOrContext?: any, context?: import("./ResourceInterface.js").Context): any;
         reliesOnPrototype: boolean;
     };
     delete(identifier: import("./ResourceInterface.js").Id, context?: import("./ResourceInterface.js").Context): Promise<boolean>;
@@ -509,15 +468,19 @@ export declare function table(tableDefinition: TableDefinition): {
     create(idPrefix: import("./ResourceInterface.js").Id, record: any, context: import("./ResourceInterface.js").Context): Promise<import("./ResourceInterface.js").Id>;
     create(record: any, context: import("./ResourceInterface.js").Context): Promise<import("./ResourceInterface.js").Id>;
     invalidate: {
-        (idOrQuery: string | import("./ResourceInterface.js").Id, dataOrContext?: any, context?: import("./ResourceInterface.js").Context): any;
+        (idOrQuery: string | import("./ResourceInterface.js").Id | import("./ResourceInterface.js").Query, dataOrContext?: any, context?: import("./ResourceInterface.js").Context): any;
         reliesOnPrototype: boolean;
     };
     post: {
-        (idOrQuery: string | import("./ResourceInterface.js").Id, dataOrContext?: any, context?: import("./ResourceInterface.js").Context): any;
+        (idOrQuery: string | import("./ResourceInterface.js").Id | import("./ResourceInterface.js").Query, dataOrContext?: any, context?: import("./ResourceInterface.js").Context): any;
+        reliesOnPrototype: boolean;
+    };
+    update: {
+        (idOrQuery: string | import("./ResourceInterface.js").Id | import("./ResourceInterface.js").Query, dataOrContext?: any, context?: import("./ResourceInterface.js").Context): any;
         reliesOnPrototype: boolean;
     };
     connect: {
-        (idOrQuery: string | import("./ResourceInterface.js").Id, dataOrContext?: any, context?: import("./ResourceInterface.js").Context): any;
+        (idOrQuery: string | import("./ResourceInterface.js").Id | import("./ResourceInterface.js").Query, dataOrContext?: any, context?: import("./ResourceInterface.js").Context): any;
         reliesOnPrototype: boolean;
     };
     subscribe(request: import("./ResourceInterface.js").SubscriptionRequest): Promise<AsyncIterable<{
@@ -526,27 +489,27 @@ export declare function table(tableDefinition: TableDefinition): {
         value: object;
     }>>;
     publish: {
-        (idOrQuery: string | import("./ResourceInterface.js").Id, dataOrContext?: any, context?: import("./ResourceInterface.js").Context): any;
+        (idOrQuery: string | import("./ResourceInterface.js").Id | import("./ResourceInterface.js").Query, dataOrContext?: any, context?: import("./ResourceInterface.js").Context): any;
         reliesOnPrototype: boolean;
     };
     search: {
-        (idOrQuery: string | import("./ResourceInterface.js").Id, dataOrContext?: any, context?: import("./ResourceInterface.js").Context): any;
+        (idOrQuery: string | import("./ResourceInterface.js").Id | import("./ResourceInterface.js").Query, dataOrContext?: any, context?: import("./ResourceInterface.js").Context): any;
         reliesOnPrototype: boolean;
     };
     query: {
-        (idOrQuery: string | import("./ResourceInterface.js").Id, dataOrContext?: any, context?: import("./ResourceInterface.js").Context): any;
+        (idOrQuery: string | import("./ResourceInterface.js").Id | import("./ResourceInterface.js").Query, dataOrContext?: any, context?: import("./ResourceInterface.js").Context): any;
         reliesOnPrototype: boolean;
     };
     copy: {
-        (idOrQuery: string | import("./ResourceInterface.js").Id, dataOrContext?: any, context?: import("./ResourceInterface.js").Context): any;
+        (idOrQuery: string | import("./ResourceInterface.js").Id | import("./ResourceInterface.js").Query, dataOrContext?: any, context?: import("./ResourceInterface.js").Context): any;
         reliesOnPrototype: boolean;
     };
     move: {
-        (idOrQuery: string | import("./ResourceInterface.js").Id, dataOrContext?: any, context?: import("./ResourceInterface.js").Context): any;
+        (idOrQuery: string | import("./ResourceInterface.js").Id | import("./ResourceInterface.js").Query, dataOrContext?: any, context?: import("./ResourceInterface.js").Context): any;
         reliesOnPrototype: boolean;
     };
     isCollection(resource: any): any;
-    parseQuery(search: any): any;
+    parseQuery(search: any, query: any): URLSearchParams | import("./RequestTarget.js").RequestTarget;
     parsePath(path: any, context: any, query: any): any;
 };
 export declare function dropTableMeta({ table: tableName, database: databaseName }: {

package/resources/indexes/HierarchicalNavigableSmallWorld.d.ts

@@ -0,0 +1,87 @@
+import type { Id } from '../../resources/ResourceInterface.ts';
+/**
+ * Represents a Hierarchical Navigable Small World (HNSW) index for approximate nearest neighbor search.
+ * This implementation is based on hierarchical graph navigation to efficiently index and search high-dimensional vectors.
+ * A HNSW is basically a multi-dimensional skip list. Each node has (potentially) higher levels that are used for quickly
+ * traversing the graph get in the neighborhood of the node, and then lower levels are used to more accurately find the
+ * closest neighbors.
+ *
+ * This implementation is based on the paper "Efficient and Robust Approximate Nearest Neighbor Search in High Dimensions"
+ * (mostly influenced AI's contributions)
+ */
+export declare class HierarchicalNavigableSmallWorld {
+    static useObjectStore: boolean;
+    indexStore: any;
+    M: number;
+    efConstruction: number;
+    efConstructionSearch: number;
+    mL: number;
+    optimizeRouting: number;
+    nodesVisitedCount: number;
+    idIncrementer: BigInt64Array | undefined;
+    distance: (a: number[], b: number[]) => number;
+    constructor(indexStore: any, options: any);
+    index(primaryKey: Id, vector: number[], existingVector?: number[]): void;
+    private getEntryPoint;
+    /**
+     * Search one layer of the skip-list using HNSW algorithm for creating a candidate list and navigating the graph
+     * TODO: This should be async, but we can't really do that with lmdb-js's transaction system right now. Should be
+     * doable with RocksDB. We could also create an async version for searching.
+     * @param queryVector
+     * @param entryPointId
+     * @param entryPoint
+     * @param ef
+     * @param level
+     * @param distanceFunction
+     * @private
+     */
+    private searchLayer;
+    /**
+     * This the main entry from Harper's query functionality, where we actually search for an ordered list of nearest
+     * neighbors, using the provided sort/order definition object and performing the multi-layer skip-list search.
+     * This returns an iterable of the nearest neighbors to the provided target vector, with nearest ordered first.
+     * @param target
+     * @param value
+     * @param descending
+     * @param distance
+     * @param comparator
+     * @param context
+     */
+    search({ target, value, descending, distance, comparator, }: {
+        target: number[];
+        value: number;
+        descending: boolean;
+        distance: string;
+        comparator: string;
+    }): {
+        key: string;
+        distance: number;
+    }[];
+    private checkSymmetry;
+    private addConnection;
+    validateConnectivity(startLevel?: number): {
+        isFullyConnected: boolean;
+        averageConnections: number;
+    };
+    get totalNodes(): number;
+    /**
+     * This is used by the query planner to determine what order to apply conditions. It is our best guess at an estimated count.
+     * This unit is typically the number of records that need to be accessed to satisfy the query. We know that we will visit
+     * a minimum of efConstructionSearch nodes and a maximum of the total nodes (in absolute worst case).
+     * The original paper described the complexity as polylogarithmic. From my testing, the
+     * best and simplest guess at the number of nodes that need to be accessed is the geometric mean of the total number of nodes
+     * and the efConstruction parameter (for search), which clearly constrains the estimate to the correct range and is
+     * similar to polylogarithmic for realistic values.
+     *
+     * @returns
+     */
+    estimateCount(): number;
+    /**
+     * This is used to resolve the vector property, which should be resolved to the distance when used in a sort comparator
+     * We also want to cache distance calculations so they can be accessed efficently later
+     * @param vector
+     * @param context
+     * @param entry
+     */
+    propertyResolver(vector: number[], context: any, entry: any): any;
+}

package/resources/indexes/customIndexes.d.ts

@@ -0,0 +1,4 @@
+import { HierarchicalNavigableSmallWorld } from './HierarchicalNavigableSmallWorld.ts';
+export declare const CUSTOM_INDEXES: {
+    HNSW: typeof HierarchicalNavigableSmallWorld;
+};

package/resources/indexes/vector.d.ts

@@ -0,0 +1,2 @@
+export declare function euclideanDistance(a: number[], b: number[]): number;
+export declare function cosineDistance(a: number[], b: number[]): number;

package/resources/search.d.ts

@@ -1,4 +1,5 @@
 import type { DirectCondition, Id } from './ResourceInterface.ts';
+import { RequestTarget } from './RequestTarget.ts';
 export declare const COERCIBLE_OPERATORS: {
     lt: boolean;
     le: boolean;
@@ -17,7 +18,7 @@ export declare function executeConditions(conditions: any, operator: any, table:
  * @param allowFullScan
  * @param filtered
  */
-export declare function searchByIndex(searchCondition: DirectCondition, transaction: any, reverse: boolean, Table: any, allowFullScan?: boolean, filtered?: boolean): AsyncIterable<Id | {
+export declare function searchByIndex(searchCondition: DirectCondition, transaction: any, reverse: boolean, Table: any, allowFullScan?: boolean, filtered?: boolean, context?: any): AsyncIterable<Id | {
     key: Id;
     value: any;
 }>;
@@ -30,16 +31,9 @@ export declare function findAttribute(attributes: any, attribute_name: any): any
 export declare function filterByType(searchCondition: any, Table: any, context: any, filtered: any, isPrimaryKey?: any, estimatedIncomingCount?: any): any;
 export declare function estimateCondition(table: any): (condition: any) => any;
 /**
- * This is responsible for taking a query string (from a get()) and converting it to a standard query object
- * structure
+ * This is responsible for taking a query string (from a get()) and merging the parsed elements into a RequestTarget object.
  * @param queryString
  */
-export declare function parseQuery(queryToParse: any): any;
+export declare function parseQuery(queryToParse: string, query: RequestTarget): URLSearchParams | RequestTarget;
 export declare function flattenKey(key: any): any;
 export declare function intersectionEstimate(store: any, left: any, right: any): number;
-export declare class SimpleURLQuery {
-    url: string;
-    constructor(url: string);
-    get(): void;
-    [Symbol.iterator](): ArrayIterator<any>;
-}

package/resources/tracked.d.ts

@@ -9,7 +9,7 @@
  * @param Target Class to add accessors to
  * @param typeDef Type definition for determining property
  */
-export declare function assignTrackedAccessors(Target: any, typeDef: any): void;
+export declare function assignTrackedAccessors(Target: any, typeDef: any, useFullPropertyProxy?: boolean): void;
 export declare class GenericTrackedObject {
     #private;
     constructor(sourceObject: any);

package/resources/transactionBroadcast.d.ts

@@ -1,4 +1,5 @@
 import { IterableEventQueue } from './IterableEventQueue.ts';
+import type { Id } from './ResourceInterface.ts';
 /**
  * This module/function is responsible for the main work of tracking subscriptions and listening for new transactions
  * that have occurred on any thread, and then reading through the transaction log to notify listeners. This is
@@ -14,9 +15,12 @@ export declare function addSubscription(table: any, key: any, listener?: (key: a
  * subscription and get the initial state.
  */
 declare class Subscription extends IterableEventQueue {
-    listener: (key: any) => any;
+    listener: (recordId: Id, auditEntry: any, localTime: number, beginTxn: boolean) => void;
     subscriptions: [];
     startTime?: number;
+    includeDescendants?: boolean;
+    supportsTransactions?: boolean;
+    onlyChildren?: boolean;
     constructor(listener: any);
     end(): void;
     toJSON(): {

package/server/Server.d.ts

@@ -1,10 +1,11 @@
 import { Socket } from 'net';
 import type { Value } from '../resources/analytics/write.ts';
+import type { Resources } from '../resources/Resources.ts';
 /**
  * This is the central interface by which we define entry points for different server protocol plugins to listen for
  * incoming connections and requests.
  */
-interface Server {
+export interface Server {
     socket?(listener: (socket: Socket) => void, options: ServerOptions): void;
     http?(listener: (request: Request, nextLayer: (request: Request) => Response) => void, options?: ServerOptions): void;
     request?(listener: (request: Request, nextLayer: (request: Request) => Response) => void, options?: ServerOptions): void;
@@ -17,6 +18,7 @@ interface Server {
     nodes: string[];
     shards: Map<number, string[]>;
     hostname: string;
+    resources: Resources;
 }
 export interface ServerOptions {
     port?: number;