sphereql-graphql 0.3.0

GraphQL integration for sphereQL spatial queries
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

# sphereql-graphql

GraphQL integration for the [sphereQL](https://github.com/bkahan/sphereQL) project.

Provides an `async-graphql` schema with two surfaces unified behind a
`MergedQueryRoot`:

- **Spatial** — cone, shell, band, wedge, and region lookups,
  k-nearest-neighbor search, distance calculations, and real-time
  subscriptions via a broadcast event bus.
- **Category enrichment** — seven resolvers covering the full
  `sphereql-embed` category surface: `conceptPath`,
  `categoryConceptPath`, `categoryNeighbors`, `drillDown`,
  `hierarchicalNearest`, `categoryStats`, `domainGroups`.

Resolvers that take a `queryText: String` embed it server-side through
a pluggable `TextEmbedder` trait (from `sphereql-embed`). The default
`NoEmbedder` returns a descriptive error until a real embedder is
wired in, so text-query deployments never silently no-op.

```rust
use std::sync::Arc;
use sphereql_embed::{Embedding, EmbedderError, FnEmbedder};
use sphereql_graphql::{
    build_unified_schema, build_pipeline_handle_from_items,
    create_default_index, SpatialEventBus,
};

let embedder = Arc::new(FnEmbedder::new(|text: &str| {
    Ok::<_, EmbedderError>(Embedding::new(embed(text)))
}));
let pipeline = build_pipeline_handle_from_items(&items)?;
let schema = build_unified_schema(
    create_default_index(),
    SpatialEventBus::new(256),
    pipeline,
    embedder,
);
```

For tests and quickstarts, `build_unified_schema_from_items(&items)`
wires all four resources (default index, a 16-slot event bus, a
default-config pipeline, and `NoEmbedder`) in one call.

Spatial-only deployments keep using the existing `build_schema(index,
event_bus)` entry point — the pipeline and embedder resources are
additive.

## Status

Part of the sphereQL workspace, currently `0.3.0`. Pre-1.0:
expect breaking changes between minor versions.

See the [main repository](https://github.com/bkahan/sphereQL) for full
documentation, examples, and architecture overview.