@littlebigbrain/client 0.6.0 → 0.7.0

package/dist/transport.d.ts

@@ -34,6 +34,8 @@ export declare class LbbError extends Error {
     readonly docUrl?: string | null;
     readonly retryable?: boolean;
     readonly retryAfterSeconds?: number;
+    /** Actionable guidance for composite stack-endpoint routing errors. */
+    readonly endpointHint?: string;
     constructor(status: number, body: string, error?: LbbErrorPayload | undefined);
 }
 export type QueryValue = string | number | boolean | undefined;

package/dist/transport.js

@@ -10,6 +10,8 @@ export class LbbError extends Error {
     docUrl;
     retryable;
     retryAfterSeconds;
+    /** Actionable guidance for composite stack-endpoint routing errors. */
+    endpointHint;
     constructor(status, body, error) {
         super(error?.message ?? `Little Big Brain ${status}: ${body}`);
         this.status = status;
@@ -23,8 +25,18 @@ export class LbbError extends Error {
         this.docUrl = error?.doc_url;
         this.retryable = error?.retryable;
         this.retryAfterSeconds = error?.retry_after_seconds;
+        this.endpointHint = endpointMigrationHint(this.code);
     }
 }
+function endpointMigrationHint(code) {
+    if (code === "stack_endpoint_required") {
+        return "Copy endpoint_url from the stack's Connect page and use it as baseUrl.";
+    }
+    if (code === "stack_endpoint_mismatch") {
+        return "Use the endpoint_url and API key from the same stack.";
+    }
+    return undefined;
+}
 export function sleep(ms) {
     if (ms <= 0)
         return Promise.resolve();

package/dist/types.d.ts

@@ -153,7 +153,7 @@ export declare function parseSparqlResults(response: Schemas["SparqlTextResponse
 export declare function firstPatternVariable(patterns: Schemas["AnalyticTriplePattern"][]): string;
 export declare function attributeFilter(filter: AttributeFilter, defaultVar: string): Schemas["SparqlFilter"];
 export interface LbbClientOptions {
-    /** Base URL of the little big brain server, e.g. `https://db.eu.littlebigbrain.com`. */
+    /** Hosted stack endpoint, e.g. `https://7k3m9q2x--production.db.eu.littlebigbrain.com`. */
     baseUrl: string;
     /** Stack API key (`lbb_sk_test_…` / `lbb_sk_live_…`) or single-mode token. */
     apiKey?: string;
@@ -223,82 +223,6 @@ export interface LbbRetryEvent {
     /** Inclusive wall-clock elapsed (ms) across attempts and waits so far. */
     elapsedMs: number;
 }
-export type LbbStackActivityWindow = "1h" | "4h" | "12h" | "24h";
-export interface LbbStackActivityResponse {
-    ok: true;
-    stack: {
-        slug: string;
-        name?: string;
-    };
-    window: {
-        range: LbbStackActivityWindow;
-        from_micros: number;
-        to_micros: number;
-        bucket_seconds: number;
-        freshness_seconds: number;
-    };
-    totals: {
-        requests: number;
-        errors: number;
-        p50_latency_ms: number;
-        p95_latency_ms: number;
-        p99_latency_ms: number;
-        storage_read_ops: number;
-        storage_read_bytes: number;
-        storage_write_ops: number;
-        storage_write_bytes: number;
-        index_read_ops: number;
-        index_read_bytes: number;
-    };
-    details: {
-        total_bucket_count: number;
-        active_bucket_count: number;
-        error_rate: number;
-        storage_total_ops: number;
-        storage_total_bytes: number;
-        non_index_storage_read_ops: number;
-        non_index_storage_read_bytes: number;
-        index_read_share: number;
-        first_activity_bucket_start_micros?: number;
-        last_activity_bucket_start_micros?: number;
-    };
-    series: Array<{
-        bucket_start_micros: number;
-        requests: number;
-        errors: number;
-        p50_latency_ms: number;
-        p95_latency_ms: number;
-        p99_latency_ms: number;
-        storage_read_ops: number;
-        storage_read_bytes: number;
-        storage_write_ops: number;
-        storage_write_bytes: number;
-        index_read_ops: number;
-        index_read_bytes: number;
-    }>;
-    routes: Array<{
-        family: string;
-        requests: number;
-        errors: number;
-        error_rate: number;
-        request_share: number;
-        p50_latency_ms: number;
-        p95_latency_ms: number;
-        p99_latency_ms: number;
-    }>;
-    storage: Array<{
-        family: string;
-        read_ops: number;
-        read_bytes: number;
-        write_ops: number;
-        write_bytes: number;
-        total_ops: number;
-        total_bytes: number;
-        op_share: number;
-        byte_share: number;
-    }>;
-    partial: boolean;
-}
 export interface LbbErrorPayload {
     type?: string;
     code?: string;

package/package.json

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