@jsonbored/metagraphed 0.1.0

package/README.md

@@ -0,0 +1,47 @@
+# @jsonbored/metagraphed
+
+Typed TypeScript client for the [metagraph.sh](https://metagraph.sh) backend API —
+operational metadata, health, schemas, and public-interface discovery for
+Bittensor subnets.
+
+The client is generated from the live, versioned `openapi.json`, so request
+paths, query parameters, and response shapes are fully typed and stay in lockstep
+with the API contract.
+
+## Install
+
+```sh
+npm install @jsonbored/metagraphed
+```
+
+## Usage
+
+```ts
+import { metagraphedFetch } from "@jsonbored/metagraphed";
+
+// Fully typed path + query params + response envelope.
+const subnets = await metagraphedFetch("/api/v1/subnets", {
+  query: { limit: 10, sort: "completeness_score", order: "desc" },
+});
+console.log(subnets.data, subnets.meta.pagination);
+
+// One call for everything a subnet page needs.
+const overview = await metagraphedFetch("/api/v1/subnets/{netuid}/overview", {
+  pathParams: { netuid: 7 },
+});
+
+// Point at a different origin (e.g. a preview deployment).
+const health = await metagraphedFetch("/api/v1/health", {
+  baseUrl: "https://metagraph.sh",
+});
+```
+
+Every response is the standard envelope `{ ok, schema_version, data, meta }`
+(`meta.pagination` on list routes, `meta.published_at` for freshness). See the
+[API stability guide](https://github.com/JSONbored/metagraphed/blob/main/docs/api-stability.md)
+for the envelope, pagination, caching, error codes, and `x-metagraph-*` headers.
+
+## Versioning
+
+The package tracks the `/api/v1` contract; changes within v1 are additive. The
+exported types are regenerated from `openapi.json` on each release.

package/dist/index.cjs

@@ -0,0 +1,39 @@
+'use strict';
+
+// src/metagraphed-client.ts
+async function metagraphedFetch(path, options = {}) {
+  const { baseUrl = "https://api.metagraph.sh", pathParams, query, ...init } = options;
+  const resolvedPath = interpolatePath(
+    String(path),
+    pathParams
+  );
+  const url = new URL(resolvedPath, baseUrl);
+  for (const [key, value] of Object.entries(query || {})) {
+    if (value !== void 0 && value !== null) {
+      url.searchParams.set(key, String(value));
+    }
+  }
+  const response = await fetch(url, {
+    ...init,
+    method: "GET",
+    headers: {
+      accept: "application/json",
+      ...init.headers || {}
+    }
+  });
+  return await response.json();
+}
+function interpolatePath(path, params) {
+  if (!params) {
+    return path;
+  }
+  return path.replace(/\{([^}]+)\}/g, (_match, key) => {
+    const value = params[key];
+    if (value === void 0 || value === null) {
+      throw new Error(`Missing path parameter: ${key}`);
+    }
+    return encodeURIComponent(String(value));
+  });
+}
+
+exports.metagraphedFetch = metagraphedFetch;