@littlebigbrain/client 0.14.0 → 0.15.0

package/dist/transport.d.ts

@@ -7,8 +7,13 @@ export interface CallOptions {
     maxRetries?: number;
     /** Override the client's deadline-based retry budget (ms) for this request. */
     retryBudgetMs?: number;
-    /** Override retry safety classification. Read-only POST namespaces set this automatically. */
-    retry?: boolean;
+    /**
+     * Override retry safety classification. Read-only POST namespaces set this
+     * automatically. `true` retries a `429`, a `5xx` and a network failure;
+     * `"rate_limited"` retries only a retryable `429`, which the server returns
+     * before it runs the request.
+     */
+    retry?: boolean | "rate_limited";
     /** Abort the request and suppress any further retries. */
     signal?: AbortSignal;
     /** Additional request headers. Values override SDK defaults intentionally. */
@@ -50,6 +55,16 @@ export type Query = Record<string, QueryValue>;
 export declare function sleep(ms: number): Promise<void>;
 export declare function retryableStatus(status: number): boolean;
 export declare function retryAllowed(method: string, idempotencyKey?: string): boolean;
+/**
+ * Whether a request's retry classification covers a network failure.
+ * `"rate_limited"` does not: the request may have run on the server.
+ */
+export declare function retriesNetworkFailure(retry: boolean | "rate_limited"): boolean;
+/**
+ * Whether a request's retry classification covers a retryable status.
+ * `"rate_limited"` covers only `429`.
+ */
+export declare function retriesStatus(retry: boolean | "rate_limited", status: number): boolean;
 /** Parse a Retry-After delta-seconds or HTTP-date value, capped at one minute. */
 export declare function parseRetryAfterMs(value: string | null | undefined, nowMs?: number): number | undefined;
 /**

package/dist/transport.js

@@ -69,6 +69,20 @@ export function retryAllowed(method, idempotencyKey) {
         upper === "OPTIONS" ||
         idempotencyKey !== undefined);
 }
+/**
+ * Whether a request's retry classification covers a network failure.
+ * `"rate_limited"` does not: the request may have run on the server.
+ */
+export function retriesNetworkFailure(retry) {
+    return retry === true;
+}
+/**
+ * Whether a request's retry classification covers a retryable status.
+ * `"rate_limited"` covers only `429`.
+ */
+export function retriesStatus(retry, status) {
+    return retry === "rate_limited" ? status === 429 : retry;
+}
 const MAX_RETRY_AFTER_MS = 60_000;
 /** Parse a Retry-After delta-seconds or HTTP-date value, capped at one minute. */
 export function parseRetryAfterMs(value, nowMs = Date.now()) {

package/dist/types.d.ts

@@ -138,12 +138,19 @@ export interface SparqlResultsJson {
     boolean?: boolean;
 }
 /** Parsed SPARQL results: the head vars, the ASK boolean (or null), the raw
- * typed bindings, and the bindings flattened to `{ variable: lexicalValue }`. */
+ * typed bindings, the bindings flattened to `{ variable: lexicalValue }`, and
+ * the served snapshot (or null). */
 export interface SparqlResults {
     vars: string[];
     boolean: boolean | null;
     bindings: Record<string, SparqlTerm>[];
     rows: Record<string, string>[];
+    /**
+     * The snapshot the rows were read from, for an eventual or pinned
+     * (`as_of_commit_seq`) read: `served_at_seq` is that commit. `null` for a
+     * plain strong read.
+     */
+    snapshot: Schemas["SnapshotView"] | null;
 }
 /**
  * Parse a {@link Schemas.SparqlTextResponse} (whose `results` field carries the

package/dist/types.js

@@ -7,12 +7,13 @@
 export function parseSparqlResults(response) {
     const doc = JSON.parse(response.results);
     const vars = doc.head?.vars ?? [];
+    const snapshot = response.snapshot ?? null;
     if (typeof doc.boolean === "boolean") {
-        return { vars, boolean: doc.boolean, bindings: [], rows: [] };
+        return { vars, boolean: doc.boolean, bindings: [], rows: [], snapshot };
     }
     const bindings = doc.results?.bindings ?? [];
     const rows = bindings.map((binding) => Object.fromEntries(Object.entries(binding).map(([name, term]) => [name, term.value])));
-    return { vars, boolean: null, bindings, rows };
+    return { vars, boolean: null, bindings, rows, snapshot };
 }
 export function firstPatternVariable(patterns) {
     for (const pattern of patterns) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@littlebigbrain/client",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "TypeScript client for little big brain: search, graph queries, and data import",
   "license": "Apache-2.0",
   "repository": {