@jsonbored/metagraphed 0.2.0 → 0.3.1

package/dist/index.js

@@ -1,6 +1,48 @@
 // src/metagraphed-client.ts
+var MetagraphedError = class extends Error {
+  status;
+  code;
+  envelope;
+  constructor(message, status, code, envelope) {
+    super(message);
+    this.name = "MetagraphedError";
+    this.status = status;
+    this.code = code;
+    this.envelope = envelope;
+  }
+};
+function isErrorEnvelope(body) {
+  return typeof body === "object" && body !== null && body.ok === false;
+}
+async function readJsonBody(response) {
+  const text = await response.text();
+  if (!text) {
+    return void 0;
+  }
+  try {
+    return JSON.parse(text);
+  } catch {
+    throw new MetagraphedError(
+      `Response body was not valid JSON (status ${response.status})`,
+      response.status
+    );
+  }
+}
+function resolveSignal(signal, timeoutMs) {
+  if (signal) {
+    return signal;
+  }
+  return timeoutMs > 0 ? AbortSignal.timeout(timeoutMs) : void 0;
+}
 async function metagraphedFetch(path, options = {}) {
-  const { baseUrl = "https://api.metagraph.sh", pathParams, query, ...init } = options;
+  const {
+    baseUrl = "https://api.metagraph.sh",
+    pathParams,
+    query,
+    timeoutMs = 3e4,
+    signal,
+    ...init
+  } = options;
   const resolvedPath = interpolatePath(
     String(path),
     pathParams
@@ -17,9 +59,83 @@ async function metagraphedFetch(path, options = {}) {
     headers: {
       accept: "application/json",
       ...init.headers || {}
+    },
+    signal: resolveSignal(signal, timeoutMs)
+  });
+  const body = await readJsonBody(response);
+  if (!response.ok) {
+    const envelope = isErrorEnvelope(body) ? body : void 0;
+    throw new MetagraphedError(
+      envelope?.error?.message ?? `GET ${url.pathname} failed with status ${response.status}`,
+      response.status,
+      envelope?.error?.code,
+      envelope
+    );
+  }
+  return body;
+}
+async function* metagraphedPaginate(path, options = {}) {
+  const baseQuery = {
+    ...options.query
+  };
+  let cursor = baseQuery.cursor;
+  for (; ; ) {
+    if (cursor !== void 0 && cursor !== null) {
+      baseQuery.cursor = cursor;
+    }
+    const page = await metagraphedFetch(path, {
+      ...options,
+      query: baseQuery
+    });
+    yield page;
+    const next = page?.meta?.pagination?.next_cursor;
+    if (next === void 0 || next === null) {
+      return;
     }
+    cursor = next;
+  }
+}
+async function metagraphedRpc(network, request, options = {}) {
+  const {
+    baseUrl = "https://api.metagraph.sh",
+    timeoutMs = 3e4,
+    signal,
+    id = 1
+  } = options;
+  const url = new URL(`/rpc/v1/${encodeURIComponent(network)}`, baseUrl);
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      "content-type": "application/json",
+      accept: "application/json"
+    },
+    body: JSON.stringify({
+      jsonrpc: "2.0",
+      id,
+      method: request.method,
+      params: request.params ?? []
+    }),
+    signal: resolveSignal(signal, timeoutMs)
   });
-  return await response.json();
+  const body = await readJsonBody(response);
+  if (!response.ok) {
+    const envelope = isErrorEnvelope(body) ? body : void 0;
+    throw new MetagraphedError(
+      envelope?.error?.message ?? `RPC ${request.method} failed with status ${response.status}`,
+      response.status,
+      envelope?.error?.code,
+      envelope
+    );
+  }
+  const rpcError = body?.error;
+  if (rpcError) {
+    throw new MetagraphedError(
+      typeof rpcError.message === "string" ? rpcError.message : "JSON-RPC error",
+      response.status,
+      rpcError.code === void 0 || rpcError.code === null ? void 0 : String(rpcError.code)
+    );
+  }
+  return body?.result;
 }
 function interpolatePath(path, params) {
   if (!params) {
@@ -34,4 +150,4 @@ function interpolatePath(path, params) {
   });
 }
 
-export { metagraphedFetch };
+export { MetagraphedError, metagraphedFetch, metagraphedPaginate, metagraphedRpc };

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@jsonbored/metagraphed",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Typed TypeScript client for the metagraph.sh backend API — operational metadata, health, schemas, and interface discovery for Bittensor subnets.",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "type": "module",
   "homepage": "https://metagraph.sh",
   "repository": {
@@ -41,7 +41,10 @@
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {
-    "tsup": "^8.5.0",
-    "typescript": "^5.9.0"
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "overrides": {
+    "esbuild": "^0.28.1"
   }
 }