@dreamlake/dreamdb 0.1.1 → 0.2.0

package/dreamdb.d.ts

@@ -0,0 +1,101 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/**
+ * A `fetch`-backed backend rooted at a base URL.
+ */
+export class S3Backend {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Fetch `path` (relative to the base URL) and resolve to its bytes.
+     * `opts.noCache` is accepted for API compatibility (currently a no-op:
+     * content is hash-addressed; refs are read fresh each page load anyway).
+     */
+    get(path: string, _opts: any): Promise<Uint8Array>;
+    /**
+     * List object paths under `prefix`. Stub (returns empty); the current
+     * consumer read paths don't require listing.
+     */
+    list(_prefix: string): Promise<Array<any>>;
+    /**
+     * Construct rooted at `base_url` (trailing slash trimmed).
+     */
+    constructor(base_url: string);
+}
+
+export class Space {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Open a Space from a `.../refs/<name>` or `.../manifests/<hash>` URI,
+     * resolving the ref (if any) and loading the manifest. If `backend` is
+     * provided it handles IO (relative paths); otherwise a direct-fetch
+     * connector rooted at the parsed base URL is used (the `dreamdb-demo`
+     * no-backend path).
+     */
+    static fromUri(uri: string, backend: any): Promise<Space>;
+    /**
+     * Walk the manifest DAG from HEAD, up to `max_depth` entries. Each entry:
+     * `{ manifestHash, ts, writer, tracks: [{modality, address}] }`.
+     */
+    history(max_depth?: number | null): Promise<Array<any>>;
+    /**
+     * Top-K cosine vector search over an embedding `field`. `opts` may be a
+     * number (topK) or `{ topK?, probeCount? }`. Returns `[{ anchor, score }]`
+     * sorted by score descending — the shape dreamdb-ts's `queryVector` yields.
+     *
+     * Delegates to the real (tested) `dreamdb-dataset` query path: ADC cull +
+     * two-pass rerank + HotShard merge + tombstone suppression.
+     */
+    queryVector(field: string, query: Float32Array, opts: any): Promise<Array<any>>;
+    /**
+     * Read a scalar track as a `Map<anchorString, value>`. Single-anchor
+     * entries resolve from the track index; multi-anchor entries fetch (and
+     * de-dupe) their bucket and roaring-decode the anchor set.
+     */
+    readScalarColumn(track: any, _opts: any): Promise<Map<any, any>>;
+    /**
+     * Find a track by its resolved `key` or by `modality`.
+     */
+    trackFor(key_or_modality: string): any;
+    /**
+     * List resolved tracks from this manifest.
+     */
+    tracks(): Array<any>;
+    /**
+     * The base URL objects are fetched relative to (consumers build their own
+     * object URLs from this — e.g. `dreamdb-demo`'s track readers).
+     */
+    readonly connectorBase: string;
+    /**
+     * The manifest's base32 multihash.
+     */
+    readonly manifestHash: string;
+}
+
+/**
+ * Encode arbitrary bytes as lowercase RFC-4648 base32 (no padding).
+ *
+ * Byte-identical to `dreamdb-ts`'s `bytesToBase32` (alphabet
+ * `abcdefghijklmnopqrstuvwxyz234567`) and to `dreamdb_core`'s multihash
+ * `to_base32`, which is how object addresses are spelled on disk.
+ */
+export function bytesToBase32(bytes: Uint8Array): string;
+
+/**
+ * Decode a single CBOR value from `bytes` into its JS representation.
+ */
+export function decodeCbor(bytes: Uint8Array): any;
+
+/**
+ * Package version — useful for consumers to confirm which build is loaded.
+ */
+export function version(): string;
+
+/**
+ * The all-zero spatial-key path segment used for non-spatial (fragment) object
+ * addresses. Matches `dreamdb-ts`'s `ZERO_SPATIAL_KEY` constant exactly.
+ */
+export function zeroSpatialKey(): string;

package/dreamdb.js

@@ -0,0 +1,9 @@
+/* @ts-self-types="./dreamdb.d.ts" */
+import * as wasm from "./dreamdb_bg.wasm";
+import { __wbg_set_wasm } from "./dreamdb_bg.js";
+
+__wbg_set_wasm(wasm);
+wasm.__wbindgen_start();
+export {
+    S3Backend, Space, bytesToBase32, decodeCbor, version, zeroSpatialKey
+} from "./dreamdb_bg.js";