@dreamlake/dreamdb 0.3.0 → 0.4.0

package/web/dreamdb_bg.wasm.d.ts

@@ -0,0 +1,56 @@
+/* tslint:disable */
+/* eslint-disable */
+export const memory: WebAssembly.Memory;
+export const __wbg_s3backend_free: (a: number, b: number) => void;
+export const __wbg_space_free: (a: number, b: number) => void;
+export const __wbg_writer_free: (a: number, b: number) => void;
+export const addressRoundTrip: (a: number, b: number) => [number, number, number, number];
+export const addressVariant: (a: number, b: number) => [number, number, number, number];
+export const bytesToBase32: (a: number, b: number) => [number, number];
+export const decodeCbor: (a: number, b: number) => [number, number, number];
+export const encodeCbor: (a: any) => [number, number, number, number];
+export const modalityParse: (a: number, b: number) => [number, number, number];
+export const multihashBase32: (a: number, b: number) => [number, number];
+export const multihashHex: (a: number, b: number) => [number, number];
+export const rangeHeader: (a: bigint, b: bigint) => [number, number, number, number];
+export const s3backend_get: (a: number, b: number, c: number, d: any) => any;
+export const s3backend_list: (a: number, b: number, c: number) => any;
+export const s3backend_new: (a: number, b: number) => number;
+export const space_connectorBase: (a: number) => [number, number];
+export const space_fromUri: (a: number, b: number, c: any) => any;
+export const space_history: (a: number, b: number) => any;
+export const space_manifestHash: (a: number) => [number, number];
+export const space_queryHybrid: (a: number, b: number, c: number, d: any) => any;
+export const space_queryScalar: (a: number, b: number, c: number, d: number, e: number, f: any) => any;
+export const space_queryText: (a: number, b: number, c: number, d: number, e: number, f: number) => any;
+export const space_queryVector: (a: number, b: number, c: number, d: number, e: number, f: any) => any;
+export const space_readScalarColumn: (a: number, b: any, c: any) => any;
+export const space_resolveObjectIndex: (a: number, b: any) => any;
+export const space_timelineId: (a: number) => [number, number, number, number];
+export const space_trackFor: (a: number, b: number, c: number) => any;
+export const space_tracks: (a: number) => any;
+export const spatialKeyRoundTrip: (a: number, b: number) => [number, number, number, number];
+export const timeAnchorFromHex: (a: number, b: number) => [bigint, number, number];
+export const timeAnchorHex: (a: bigint) => [number, number];
+export const timeBucket: (a: bigint, b: number, c: number) => [bigint, number, number];
+export const version: () => [number, number];
+export const writer_appendMany: (a: number, b: any) => any;
+export const writer_commit: (a: number) => any;
+export const writer_deleteRecords: (a: number, b: number, c: number, d: number, e: number) => any;
+export const writer_manifestHash: (a: number) => [number, number, number, number];
+export const writer_open: (a: number, b: number, c: any) => any;
+export const writer_refName: (a: number) => [number, number];
+export const writer_snapshot: (a: number, b: number, c: number) => any;
+export const zeroSpatialKey: () => [number, number];
+export const __wasm_init: () => void;
+export const wasm_bindgen_f7c54996eb9137d9___convert__closures_____invoke___wasm_bindgen_f7c54996eb9137d9___JsValue__core_7d5f0a2ba6a62c33___result__Result_____wasm_bindgen_f7c54996eb9137d9___JsError___true_: (a: number, b: number, c: any) => [number, number];
+export const wasm_bindgen_f7c54996eb9137d9___convert__closures_____invoke___js_sys_ac40961855821e8e___Function_fn_wasm_bindgen_f7c54996eb9137d9___JsValue_____wasm_bindgen_f7c54996eb9137d9___sys__Undefined___js_sys_ac40961855821e8e___Function_fn_wasm_bindgen_f7c54996eb9137d9___JsValue_____wasm_bindgen_f7c54996eb9137d9___sys__Undefined_______true_: (a: number, b: number, c: any, d: any) => void;
+export const __wbindgen_malloc: (a: number, b: number) => number;
+export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
+export const __wbindgen_exn_store: (a: number) => void;
+export const __externref_table_alloc: () => number;
+export const __wbindgen_externrefs: WebAssembly.Table;
+export const __wbindgen_destroy_closure: (a: number, b: number) => void;
+export const __externref_table_dealloc: (a: number) => void;
+export const __wbindgen_free: (a: number, b: number, c: number) => void;
+export const __wbindgen_start: () => void;

package/web.mjs

@@ -0,0 +1,17 @@
+// No-bundler entry, for `<script type="module">` and Deno.
+//
+// Unlike the bundler build this one cannot instantiate itself: the browser has
+// to fetch the .wasm at runtime. `init()` is the default export and MUST be
+// awaited before any other export is used. Calling `Space.fromUri` first
+// throws from inside wasm-bindgen's glue with no useful message, which is why
+// this entry exists rather than pointing people at './web/dreamdb.js'.
+import init from './web/dreamdb.js'
+export * from './web/dreamdb.js'
+export { ZERO_SPATIAL_KEY, PresignedBackend, Authoring } from './browser-extras.mjs'
+
+let started
+/** Fetch and instantiate the wasm. Idempotent; await before anything else. */
+export default function ready(input) {
+  started ??= init(input)
+  return started
+}

package/dreamdb.d.ts

@@ -1,150 +0,0 @@
-/* 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>>;
-    /**
-     * Hybrid search fusing a lexical (BM25) sub-query and a dense (vector)
-     * sub-query per spec/0015 §5/§6. Returns the fused `[{ anchor, score }]`
-     * list sorted by fused score descending — the same scored shape as
-     * `queryVector`.
-     *
-     * `vector` is the dense sub-query embedding (a `Float32Array`). `opts` is a
-     * plain JS object:
-     * ```js
-     * {
-     *   textField, textQuery,        // BM25 sub-query (required)
-     *   vectorField,                 // dense field the `vector` targets (required)
-     *   topK = 10,                   // fused results to return
-     *   fusion = 'rrf',              // 'rrf' | 'linear' | 'max' | 'pareto'
-     *   rrfK = 60,                   // RRF rank constant (fusion='rrf')
-     *   textWeight = 1, vectorWeight = 1, // Linear weights (fusion='linear')
-     *   textK = topK, vectorK = topK,     // per-sub-query candidate depths
-     *   textRequired = false, vectorRequired = false, // §5.3 boolean-AND gates
-     * }
-     * ```
-     *
-     * Delegates to the real (tested) `dreamdb-dataset::Dataset::query_hybrid`.
-     * (v0 does not expose the optional scalar pre/post-filter; it runs with no
-     * scalar gate.)
-     */
-    queryHybrid(vector: Float32Array, opts: any): Promise<Array<any>>;
-    /**
-     * Lexical BM25 text search over a text `field` (spec/0015 §3.6).
-     *
-     * Tokenizes `query` with the built-in `dreamdb.utf8-words` tokenizer
-     * (lowercase + split on non-alphanumeric — pure Rust, compiled into the
-     * wasm; no external model needed even though the field's embeddings were
-     * produced elsewhere), scores docs with BM25, and suppresses tombstoned
-     * anchors. Returns `[{ anchor, score }]` sorted by score descending — the
-     * same scored shape as `queryVector`.
-     *
-     * Delegates to the real (tested) `dreamdb-dataset::Dataset::query_text`.
-     */
-    queryText(field: string, query: string, top_k: number): 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>>;
-    /**
-     * Fetch a track object and return its `object_index` (array of CBOR
-     * entries). Inline indexes only — paged indexes are not resolved (matching
-     * dreamdb-ts, which also doesn't support them on this path).
-     */
-    resolveObjectIndex(track: any): Promise<Array<any>>;
-    /**
-     * Base32 hash of the manifest's first timeline.
-     */
-    timelineId(): string;
-    /**
-     * 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

@@ -1,9 +0,0 @@
-/* @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";

package/index.js

@@ -1,6 +0,0 @@
-// @dreamlake/dreamdb — public entry. Re-exports the wasm-bindgen bindings and
-// adds the plain-constant / type members consumers import.
-export * from './dreamdb.js'
-
-/** Zero spatial-key path segment for non-spatial (fragment) object addresses. */
-export const ZERO_SPATIAL_KEY = '0000000000000000'