@littlebigbrain/client 0.9.0 → 0.9.1

package/README.md

@@ -90,7 +90,8 @@ console.log(completed.state, completed.committed_commit_seq);
 
 `records()` may be an iterable or async iterable. Success means every grouped
 commit is durable and final publication was enqueued; it does not mean indexes
-have already reached `committed_commit_seq`.
+have already reached `committed_commit_seq`. An empty iterable is rejected
+locally before an import POST is sent.
 
 **Time-travel read.** Pin any search to a past instant — results reflect the graph as it was then:
 

package/dist/client.js

@@ -29,14 +29,27 @@ function durableImportIterator(source) {
         },
     };
 }
-function durableImportBody(source) {
+async function durableImportBody(source) {
     const iterator = durableImportIterator(source);
+    const first = await iterator.next();
+    if (first.done) {
+        await iterator.return?.();
+        throw new TypeError("submitImport requires at least one NDJSON record or byte chunk");
+    }
+    let firstPending = true;
+    const next = async () => {
+        if (firstPending) {
+            firstPending = false;
+            return { done: false, value: first.value };
+        }
+        return iterator.next();
+    };
     const Stream = globalThis.ReadableStream;
     if (Stream) {
         return new Stream({
             async pull(controller) {
                 try {
-                    const item = await iterator.next();
+                    const item = await next();
                     if (item.done) {
                         controller.close();
                     }
@@ -57,7 +70,7 @@ function durableImportBody(source) {
         async *[Symbol.asyncIterator]() {
             try {
                 for (;;) {
-                    const item = await iterator.next();
+                    const item = await next();
                     if (item.done)
                         return;
                     yield durableImportBytes(item.value);
@@ -467,8 +480,9 @@ export class LbbClient {
             throw new TypeError("submitImport requires a non-empty idempotencyKey");
         }
         await this.requireCapability("durable_import_jobs_v1");
+        const rawBody = await durableImportBody(lines);
         return this.request("POST", "/v1/graph/import-jobs", {
-            rawBody: durableImportBody(lines),
+            rawBody,
             contentType: "application/x-ndjson",
             duplex: "half",
             query: {

package/dist/schema.d.ts

@@ -3243,12 +3243,30 @@ export interface components {
          *     structured server logs.
          */
         GraphImportJobFailure: {
+            /**
+             * Format: int32
+             * @description Delivery attempts consumed when the job became terminal.
+             */
+            attempts: number;
             code: string;
+            /**
+             * @description Stable opaque correlation id for server-side logs. It is intentionally
+             *     not an object key, worker id, or graph identity.
+             */
+            diagnostic_id: string;
             message: string;
             retryable: boolean;
+            /** @description Last durable low-cardinality stage reached by the worker. */
+            stage: components["schemas"]["GraphImportJobStage"];
         };
         /** @description Bounded progress persisted by an import worker after every grouped commit. */
         GraphImportJobProgress: {
+            /** Format: int64 */
+            active_group_bytes?: number;
+            /** Format: int64 */
+            active_group_index?: number | null;
+            /** Format: int64 */
+            active_group_records?: number;
             /** Format: int64 */
             bytes_processed: number;
             committed_commit_seq?: null | components["schemas"]["CommitSeq"];
@@ -3263,11 +3281,17 @@ export interface components {
             observations: number;
             /** Format: int64 */
             properties: number;
+            stage?: components["schemas"]["GraphImportJobStage"];
             /** Format: int64 */
             triplets: number;
             /** Format: int64 */
             upload_bytes: number;
         };
+        /**
+         * @description Low-cardinality execution stage exposed while a durable import is active.
+         * @enum {string}
+         */
+        GraphImportJobStage: "queued" | "reading_payload" | "committing_group" | "persisting_checkpoint" | "enqueueing_publication" | "completed";
         /**
          * @description Lifecycle of a durable NDJSON import submitted through
          *     `POST /v1/graph/import-jobs`.

package/package.json

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