rete-graph 0.1.0 → 0.3.0

package/index.d.ts

@@ -40,6 +40,15 @@ export class Graph {
     relations: [s: string, p: string, o: string, count: number][];
   };
   info(): { quads: number; terms: number; pyramidLevels: number; namedGraphs: number };
+  /** The embedded Dataset Card, or null when the file carries none. */
+  card(): Record<string, unknown> | null;
+  /** Example SPARQL queries from the card; `sparql` plus optional rich fields. */
+  examples(): { sparql: string; title?: string; question?: string }[];
+  /** Validate SHACL Core shapes (Turtle); lazy over remote graphs. */
+  shacl(
+    shapesTurtle: string,
+    opts?: { graph?: string | null; format?: "json" | "text" },
+  ): unknown;
   readonly quads: number;
   graphNames(): string[];
   /** Remote graphs only: cumulative fetch counters; null for bytes graphs. */
@@ -49,17 +58,39 @@ export class Graph {
 }
 
 /**
- * Open a `.rete` graph: bytes, or an http(s) URL read lazily over HTTP Range.
- * Remote opens use synchronous XHR: Node and browser web workers only
- * (browser main threads forbid sync binary XHR — open bytes there).
+ * Open a `.rete` graph: bytes, an http(s) URL read lazily over HTTP Range, or
+ * (Node only) a `file://` URL read lazily off disk — same byte-range path, so
+ * a huge local file is queryable without loading it. Lazy opens use
+ * synchronous XHR: Node and browser web workers only (browser main threads
+ * forbid sync binary XHR — open bytes there).
  */
 export function open(
   source: Uint8Array | ArrayBuffer | string,
   opts?: { headers?: Record<string, string> },
 ): Promise<Graph>;
 
+/** The raw wasm engine — escape hatch for exports this wrapper doesn't wrap. */
+export const wasm: Record<string, (...args: never[]) => unknown>;
+
 /** Build a complete `.rete` file image from RDF text ("nt", "nq", "ttl"). */
 export function build(text: string, format?: "nt" | "nq" | "ttl"): Promise<Uint8Array>;
 
 /** Initialize the wasm engine explicitly (open()/build() do it lazily). */
 export function init(source?: BufferSource | WebAssembly.Module | URL | string | null): Promise<void>;
+
+/**
+ * RDF/JS Source over an open Graph — plugs `.rete` files into Comunica,
+ * LDflex, GraphQL-LD, and anything speaking the RDF/JS Source interface:
+ * `sources: [new ReteSource(graph)]`. Each match() is one pattern lookup
+ * against the file's indexes; Comunica performs the joins. For heavy
+ * multi-join queries over big REMOTE files prefer full pushdown via a
+ * SPARQL endpoint (`rete serve`, or the gateway's `/sparql/<key-or-url>`).
+ */
+export class ReteSource {
+  constructor(graph: Graph);
+  readonly graph: Graph;
+  /** RDF/JS Stream of quads matching the pattern (null/Variable = free). */
+  match(subject?: unknown, predicate?: unknown, object?: unknown, graph?: unknown): unknown;
+  /** Number of matching quads (helps query planners order joins). */
+  countQuads(subject?: unknown, predicate?: unknown, object?: unknown, graph?: unknown): number;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "rete-graph",
-  "version": "0.1.0",
-  "description": "Query local and remote .rete graph files with SPARQL — WebAssembly client for browsers and Node.",
+  "version": "0.3.0",
+  "description": "Query local and remote .rete graph files with SPARQL — WebAssembly client for browsers and Node, with lazy byte-range reads over HTTP and local files.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -28,6 +28,7 @@
     "test": "npm run build && node --test --test-timeout=60000 ./test/*.test.mjs"
   },
   "devDependencies": {
+    "@comunica/query-sparql": "^4.0.0",
     "esbuild": "^0.25.0"
   }
 }