@littlebigbrain/client 0.7.0 → 0.8.1

package/dist/types.d.ts

@@ -11,14 +11,9 @@ export type GraphMetadata = Schemas["GraphMetadataResponse"];
 export type Snapshot = Schemas["SnapshotView"];
 export type CommitRequest = Schemas["TripletCommitFile"];
 export type CommitResponse = Schemas["GraphCommitResponse"];
-export type AskRequest = Schemas["AskRequest"];
-export type AskResponse = Schemas["AskResponse"];
 export type SchemaView = Schemas["SchemaBundleView"];
 /**
- * The unified list-response envelope returned by every collection read
- * (`/v1/graph/entities`, `/v1/graph/edges`, `/v1/graph/observations`): the rows
- * in `data`, plus `next_cursor` (echo back as `cursor` for the next page) and
- * the pre-page `total_count`. Walk pages with {@link LbbClient.listAll}.
+ * Cursor-based list envelope used by bounded collection reads.
  */
 export interface ListResponse<T> {
     object: "list";
@@ -49,7 +44,7 @@ export interface RdfImportOptions {
     format?: "ntriples" | "turtle" | "nquads" | "trig";
     baseIri?: string;
     graphUri?: string;
-    /** Stable document scope for blank labels across chunks; omit for legacy stable labels. */
+    /** Stable document scope for blank labels across chunks. */
     blankNodeScope?: string;
     batch?: number;
     strict?: boolean;
@@ -58,14 +53,6 @@ export interface RdfImportOptions {
     edgeIdempotency?: "append" | "skip_unchanged";
     idempotencyKey?: string;
 }
-export interface RdfExportOptions {
-    format?: "turtle" | "ntriples" | "trig" | "nquads";
-    maxTriples?: number;
-    asOfValidTime?: string;
-    asOfCommitSeq?: number;
-    entailment?: "subclass" | "none";
-    reason?: boolean;
-}
 export type AttributeFilterOp = "eq" | "ne" | "lt" | "le" | "gt" | "ge";
 export type AttributeFilterValue = string | number | boolean | {
     dateTime: string;
@@ -91,8 +78,6 @@ export interface EntityAttributeFilterOptions {
     select?: string[];
     limit?: number;
     offset?: number;
-    asOfValidTime?: string;
-    asOfCommitSeq?: number;
     orderBy?: Schemas["SparqlOrderBy"][];
     reason?: boolean;
     maxSolutions?: number;
@@ -192,6 +177,32 @@ export interface LbbClientOptions {
     onResponse?: (event: LbbResponseEvent) => void;
     /** Called before each backoff sleep, so absorbed retries are observable. Bodies and credentials are never included. */
     onRetry?: (event: LbbRetryEvent) => void;
+    /**
+     * A5 default read consistency, applied when a read call omits its own
+     * `consistency`. Since A5 the server default is `eventual`; set `"strong"`
+     * here to keep every read head-exact by default (carried across `withScope`).
+     * A per-call `consistency` always wins.
+     */
+    defaultConsistency?: SearchConsistency;
+}
+/** A5 read consistency level. Since A5 the server default is `eventual`. */
+export type SearchConsistency = "strong" | "eventual";
+/**
+ * A5 read-consistency options shared by the query / search / summary surfaces.
+ * Merged into the request as `consistency` / `min_indexed_seq`; a per-call value
+ * wins over the client's `defaultConsistency`.
+ */
+export interface ReadConsistencyOptions {
+    /** Read consistency. Omit to use the client's `defaultConsistency`, else the
+     * server default (`eventual`). */
+    consistency?: SearchConsistency;
+    /**
+     * Read-your-writes floor: require the read to be served from state whose
+     * watermark ≥ this `commit_seq` (the committed sequence a write returned).
+     * Under eventual, a floor not yet covered yields a retryable
+     * `read_your_writes_pending` `429` — poll until the write lands.
+     */
+    minIndexedSeq?: number;
 }
 export interface LbbRequestEvent {
     method: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@littlebigbrain/client",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "TypeScript client for the little big brain graph + hybrid search HTTP API",
   "license": "Apache-2.0",
   "repository": {