marcidb-client 0.6.2 → 0.7.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "marcidb-client",
   "type": "module",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "license": "MIT",
   "author": {
     "name": "den59k"

package/runtime/index.d.ts

@@ -1,4 +1,15 @@
 declare function request(method: string, url: string, body?: any): Promise<any>;
+/**
+* A binary-eligible read over HTTP. Advertises `Accept: <binary>, json` plus the client's schema
+* fingerprint (`X-Marci-Schema`) and inspects the *response* content-type:
+*   - binary (`application/x-marcidb-rows`) → the raw result buffer as a `Uint8Array`
+*   - anything else (JSON) → `{ json }` with the already-parsed result (the server declined binary —
+*     schema/shape mismatch — so it sent the normal JSON body; no second round-trip needed).
+* A single request handles both outcomes; `run()` in the generated client branches on the return shape.
+*/
+declare function requestBinary(url: string, body: any, schemaHash: string): Promise<Uint8Array | {
+	json: any;
+}>;
 type FieldDesc = {
 	n: string;
 	k: "key" | "body" | "one" | "many";
@@ -15,4 +26,4 @@ declare function createDecoderRegistry(MODELS: Record<string, FieldDesc[]>): {
 	decodeBuffer(decoder: (reader: any) => any, bytes: Uint8Array, many: boolean): any;
 };
 declare function encodeId(id: any): string;
-export { request, encodeId, createDecoderRegistry };
+export { requestBinary, request, encodeId, createDecoderRegistry };

package/runtime/index.js

@@ -11,6 +11,27 @@ async function request(method, url, body) {
   }
   return res.json();
 }
+var BINARY_MEDIA_TYPE = "application/x-marcidb-rows";
+async function requestBinary(url, body, schemaHash) {
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Accept: `${BINARY_MEDIA_TYPE}, application/json`,
+      "X-Marci-Schema": schemaHash
+    },
+    body: JSON.stringify(body ?? {})
+  });
+  if (!res.ok) {
+    const text = await res.text();
+    throw new Error(`MarciDB [${res.status}]: ${text}`);
+  }
+  const contentType = res.headers.get("content-type") ?? "";
+  if (contentType.includes(BINARY_MEDIA_TYPE)) {
+    return new Uint8Array(await res.arrayBuffer());
+  }
+  return { json: await res.json() };
+}
 var BINARY_VERSION = 1;
 var AGG_KEYS = ["$count", "$sum", "$avg", "$min", "$max"];
 
@@ -204,6 +225,7 @@ function encodeId(id) {
   return String(id);
 }
 export {
+  requestBinary,
   request,
   encodeId,
   createDecoderRegistry