@dikolab/kbdb 0.1.6 → 0.2.0

package/src/wasm/kb-worker/kbdb_worker.d.ts

@@ -48,6 +48,22 @@ declare namespace wasm_bindgen {
      */
     export function db_gc(_ptr: number, _len: number): number;
 
+    /**
+     * Returns back-references pointing to a section.
+     * `ptr`/`len` point to a UTF-8 kbid string.
+     * On success encodes `u32 count` followed by entries (peer_id, marker_type,
+     * context_snippet) into the return slot.
+     */
+    export function db_get_back_refs(ptr: number, len: number): number;
+
+    /**
+     * Returns forward references for a section.
+     * `ptr`/`len` point to a UTF-8 kbid string.
+     * On success encodes `u32 count` followed by entries (peer_id, marker_type,
+     * context_snippet) into the return slot.
+     */
+    export function db_get_forward_refs(ptr: number, len: number): number;
+
     /**
      * Initialises the database context path.
      *
@@ -431,6 +447,20 @@ declare namespace wasm_bindgen {
      */
     export function worker_rebuild_indexes(): number;
 
+    /**
+     * Recalls section content with optional progressive context expansion.
+     *
+     * Input format (binary):
+     * - `u8 tag`: 0 = single kbid, 1 = batch kbids
+     * - If tag=0: `String kbid`
+     * - If tag=1: `u32 count` + `String[]` kbids
+     * - `u32 depth` (0-3, values above 3 are clamped to 3)
+     *
+     * On success writes the encoded result to the return slot and returns 0.
+     * On error writes an error message to the return slot and returns -1.
+     */
+    export function worker_recall(ptr: number, len: number): number;
+
     /**
      * Removes a document grouping. Returns 0 on success, -1 on error.
      */
@@ -457,6 +487,11 @@ declare namespace wasm_bindgen {
 
     /**
      * Performs a search, returning an async result token.
+     *
+     * Input format: `"query\nmode\nlimit\noffset"` (offset is optional,
+     * defaults to 0).
+     *
+     * The result is a `PagedSearchResult` envelope encoded as binary.
      */
     export function worker_search(ptr: number, len: number): number;
 
@@ -502,6 +537,7 @@ declare interface InitOutput {
     readonly worker_query: (a: number, b: number) => number;
     readonly worker_read_sections: (a: number, b: number) => number;
     readonly worker_rebuild_indexes: () => number;
+    readonly worker_recall: (a: number, b: number) => number;
     readonly worker_remove_grouping: (a: number, b: number) => number;
     readonly worker_remove_section: (a: number, b: number) => number;
     readonly worker_result_status: (a: number) => number;
@@ -530,6 +566,8 @@ declare interface InitOutput {
     readonly db_check_integrity: (a: number, b: number) => number;
     readonly db_check_version: (a: number, b: number) => number;
     readonly db_gc: (a: number, b: number) => number;
+    readonly db_get_back_refs: (a: number, b: number) => number;
+    readonly db_get_forward_refs: (a: number, b: number) => number;
     readonly db_init: (a: number, b: number) => number;
     readonly db_init_catalog: (a: number, b: number) => number;
     readonly db_init_directory: (a: number, b: number) => number;

package/src/wasm/kb-worker/kbdb_worker.js

@@ -85,6 +85,36 @@ let wasm_bindgen = (function(exports) {
     }
     exports.db_gc = db_gc;
 
+    /**
+     * Returns back-references pointing to a section.
+     * `ptr`/`len` point to a UTF-8 kbid string.
+     * On success encodes `u32 count` followed by entries (peer_id, marker_type,
+     * context_snippet) into the return slot.
+     * @param {number} ptr
+     * @param {number} len
+     * @returns {number}
+     */
+    function db_get_back_refs(ptr, len) {
+        const ret = wasm.db_get_back_refs(ptr, len);
+        return ret;
+    }
+    exports.db_get_back_refs = db_get_back_refs;
+
+    /**
+     * Returns forward references for a section.
+     * `ptr`/`len` point to a UTF-8 kbid string.
+     * On success encodes `u32 count` followed by entries (peer_id, marker_type,
+     * context_snippet) into the return slot.
+     * @param {number} ptr
+     * @param {number} len
+     * @returns {number}
+     */
+    function db_get_forward_refs(ptr, len) {
+        const ret = wasm.db_get_forward_refs(ptr, len);
+        return ret;
+    }
+    exports.db_get_forward_refs = db_get_forward_refs;
+
     /**
      * Initialises the database context path.
      *
@@ -813,6 +843,27 @@ let wasm_bindgen = (function(exports) {
     }
     exports.worker_rebuild_indexes = worker_rebuild_indexes;
 
+    /**
+     * Recalls section content with optional progressive context expansion.
+     *
+     * Input format (binary):
+     * - `u8 tag`: 0 = single kbid, 1 = batch kbids
+     * - If tag=0: `String kbid`
+     * - If tag=1: `u32 count` + `String[]` kbids
+     * - `u32 depth` (0-3, values above 3 are clamped to 3)
+     *
+     * On success writes the encoded result to the return slot and returns 0.
+     * On error writes an error message to the return slot and returns -1.
+     * @param {number} ptr
+     * @param {number} len
+     * @returns {number}
+     */
+    function worker_recall(ptr, len) {
+        const ret = wasm.worker_recall(ptr, len);
+        return ret;
+    }
+    exports.worker_recall = worker_recall;
+
     /**
      * Removes a document grouping. Returns 0 on success, -1 on error.
      * @param {number} ptr
@@ -866,6 +917,11 @@ let wasm_bindgen = (function(exports) {
 
     /**
      * Performs a search, returning an async result token.
+     *
+     * Input format: `"query\nmode\nlimit\noffset"` (offset is optional,
+     * defaults to 0).
+     *
+     * The result is a `PagedSearchResult` envelope encoded as binary.
      * @param {number} ptr
      * @param {number} len
      * @returns {number}

package/src/wasm/kb-worker/kbdb_worker_bg.wasm.d.ts

@@ -20,6 +20,7 @@ export const worker_list_docs_by_type: (a: number, b: number) => number;
 export const worker_query: (a: number, b: number) => number;
 export const worker_read_sections: (a: number, b: number) => number;
 export const worker_rebuild_indexes: () => number;
+export const worker_recall: (a: number, b: number) => number;
 export const worker_remove_grouping: (a: number, b: number) => number;
 export const worker_remove_section: (a: number, b: number) => number;
 export const worker_result_status: (a: number) => number;
@@ -48,6 +49,8 @@ export const db_add_to_index: (a: number, b: number) => number;
 export const db_check_integrity: (a: number, b: number) => number;
 export const db_check_version: (a: number, b: number) => number;
 export const db_gc: (a: number, b: number) => number;
+export const db_get_back_refs: (a: number, b: number) => number;
+export const db_get_forward_refs: (a: number, b: number) => number;
 export const db_init: (a: number, b: number) => number;
 export const db_init_catalog: (a: number, b: number) => number;
 export const db_init_directory: (a: number, b: number) => number;