@jsonbored/metagraphed 0.3.0 → 0.3.1

package/dist/index.d.cts

@@ -632,6 +632,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/rpc/usage": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Fetch RPC reverse-proxy usage analytics — request volume, latency p50/p95, failover + error rate, cache-hit rate, and the per-endpoint request distribution — over a 7d or 30d window (computed live from D1 telemetry). */
+        get: operations["rpcUsage"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/schemas": {
         parameters: {
             query?: never;
@@ -1958,6 +1975,11 @@ interface components {
             github_url?: string;
             id: string;
             kind: components["schemas"]["ProviderKind"];
+            /**
+             * Format: uri
+             * @description Curated provider logo, else backfilled from the on-chain logo of the single subnet this provider operates. Display-only; never feeds completeness.
+             */
+            logo_url?: string;
             name: string;
             /** @description Sorted unique netuids this provider operates a curated surface on (issue #347). Derived/reporting — never feeds completeness. */
             netuids?: number[];
@@ -2543,6 +2565,53 @@ interface components {
         } & {
             [key: string]: unknown;
         });
+        /** @description RPC reverse-proxy usage analytics over a 7d/30d window: request volume, latency percentiles, failover + error rate, cache-hit rate, and the per-endpoint request distribution. Computed live from the rpc_proxy_events telemetry (no static file). */
+        RpcUsageArtifact: {
+            endpoints: ({
+                avg_latency_ms?: number | null;
+                endpoint_id: string | null;
+                error_rate?: number | null;
+                ok_requests: number;
+                provider?: string | null;
+                rank?: number;
+                requests: number;
+            } & {
+                [key: string]: unknown;
+            })[];
+            networks: ({
+                error_rate?: number | null;
+                network: string;
+                ok_requests: number;
+                requests: number;
+            } & {
+                [key: string]: unknown;
+            })[];
+            observed_at?: string | null;
+            schema_version: number;
+            source: string;
+            summary: {
+                cache_hit_rate?: number | null;
+                cache_hits?: number;
+                error_rate?: number | null;
+                error_requests: number;
+                failover_rate?: number | null;
+                failover_requests?: number;
+                latency_ms?: {
+                    avg?: number | null;
+                    p50?: number | null;
+                    p95?: number | null;
+                } & {
+                    [key: string]: unknown;
+                };
+                ok_requests: number;
+                total_requests: number;
+            } & {
+                [key: string]: unknown;
+            };
+            window?: string | null;
+        } & {
+            [key: string]: unknown;
+        };
         SchemaDriftArtifact: components["schemas"]["ArtifactBase"] & ({
             openapi_surface_count: number;
             schema_backed_surface_count: number;
@@ -6474,6 +6543,7 @@ interface operations {
                      *           "github_url": "https://api.metagraph.sh/example",
                      *           "id": "example-subnet",
                      *           "kind": "subnet-team",
+                     *           "logo_url": "https://api.metagraph.sh/example",
                      *           "name": "Example Subnet",
                      *           "netuids": [
                      *             7
@@ -8258,6 +8328,131 @@ interface operations {
             };
         };
     };
+    rpcUsage: {
+        parameters: {
+            query?: {
+                window?: "7d" | "30d";
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Canonical artifact wrapped in the Metagraphed API envelope. */
+            200: {
+                headers: {
+                    "cache-control": components["headers"]["CacheControl"];
+                    etag: components["headers"]["ETag"];
+                    "x-metagraph-contract-version": components["headers"]["ContractVersion"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "data": {
+                     *         "endpoints": [
+                     *           {
+                     *             "endpoint_id": "https://api.metagraph.sh/example",
+                     *             "ok_requests": 1,
+                     *             "requests": 1
+                     *           }
+                     *         ],
+                     *         "networks": [
+                     *           {
+                     *             "network": "example",
+                     *             "ok_requests": 1,
+                     *             "requests": 1
+                     *           }
+                     *         ],
+                     *         "observed_at": "2026-06-01T00:00:00.000Z",
+                     *         "schema_version": 1,
+                     *         "source": "live-cron-prober",
+                     *         "summary": {
+                     *           "cache_hit_rate": 0.5,
+                     *           "cache_hits": 1,
+                     *           "error_rate": 0.5,
+                     *           "error_requests": 1,
+                     *           "failover_rate": 0.5,
+                     *           "failover_requests": 1,
+                     *           "latency_ms": {},
+                     *           "ok_requests": 1,
+                     *           "total_requests": 1
+                     *         },
+                     *         "window": "30d"
+                     *       },
+                     *       "meta": {
+                     *         "artifact_path": "example",
+                     *         "cache": "short",
+                     *         "contract_version": "2026-06-06.1",
+                     *         "generated_at": "2026-06-01T00:00:00.000Z",
+                     *         "pagination": {
+                     *           "collection": "example",
+                     *           "cursor": 1,
+                     *           "limit": 1,
+                     *           "next_cursor": 1,
+                     *           "order": "asc",
+                     *           "returned": 1,
+                     *           "sort": "example",
+                     *           "total": 1
+                     *         },
+                     *         "published_at": "2026-06-01T00:00:00.000Z",
+                     *         "source": "live-cron-prober"
+                     *       },
+                     *       "ok": true,
+                     *       "schema_version": 1
+                     *     }
+                     */
+                    "application/json": components["schemas"]["SuccessEnvelope"] & {
+                        data?: components["schemas"]["RpcUsageArtifact"];
+                    };
+                };
+            };
+            /** @description ETag matched and the cached response is still valid. */
+            304: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Query parameters were malformed or unsupported. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorEnvelope"];
+                };
+            };
+            /** @description Artifact or API route was not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorEnvelope"];
+                };
+            };
+            /** @description HTTP method is not supported. */
+            405: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorEnvelope"];
+                };
+            };
+            /** @description Unexpected backend error. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorEnvelope"];
+                };
+            };
+        };
+    };
     schemas: {
         parameters: {
             query?: never;

package/dist/index.d.ts

@@ -632,6 +632,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/rpc/usage": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Fetch RPC reverse-proxy usage analytics — request volume, latency p50/p95, failover + error rate, cache-hit rate, and the per-endpoint request distribution — over a 7d or 30d window (computed live from D1 telemetry). */
+        get: operations["rpcUsage"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/schemas": {
         parameters: {
             query?: never;
@@ -1958,6 +1975,11 @@ interface components {
             github_url?: string;
             id: string;
             kind: components["schemas"]["ProviderKind"];
+            /**
+             * Format: uri
+             * @description Curated provider logo, else backfilled from the on-chain logo of the single subnet this provider operates. Display-only; never feeds completeness.
+             */
+            logo_url?: string;
             name: string;
             /** @description Sorted unique netuids this provider operates a curated surface on (issue #347). Derived/reporting — never feeds completeness. */
             netuids?: number[];
@@ -2543,6 +2565,53 @@ interface components {
         } & {
             [key: string]: unknown;
         });
+        /** @description RPC reverse-proxy usage analytics over a 7d/30d window: request volume, latency percentiles, failover + error rate, cache-hit rate, and the per-endpoint request distribution. Computed live from the rpc_proxy_events telemetry (no static file). */
+        RpcUsageArtifact: {
+            endpoints: ({
+                avg_latency_ms?: number | null;
+                endpoint_id: string | null;
+                error_rate?: number | null;
+                ok_requests: number;
+                provider?: string | null;
+                rank?: number;
+                requests: number;
+            } & {
+                [key: string]: unknown;
+            })[];
+            networks: ({
+                error_rate?: number | null;
+                network: string;
+                ok_requests: number;
+                requests: number;
+            } & {
+                [key: string]: unknown;
+            })[];
+            observed_at?: string | null;
+            schema_version: number;
+            source: string;
+            summary: {
+                cache_hit_rate?: number | null;
+                cache_hits?: number;
+                error_rate?: number | null;
+                error_requests: number;
+                failover_rate?: number | null;
+                failover_requests?: number;
+                latency_ms?: {
+                    avg?: number | null;
+                    p50?: number | null;
+                    p95?: number | null;
+                } & {
+                    [key: string]: unknown;
+                };
+                ok_requests: number;
+                total_requests: number;
+            } & {
+                [key: string]: unknown;
+            };
+            window?: string | null;
+        } & {
+            [key: string]: unknown;
+        };
         SchemaDriftArtifact: components["schemas"]["ArtifactBase"] & ({
             openapi_surface_count: number;
             schema_backed_surface_count: number;
@@ -6474,6 +6543,7 @@ interface operations {
                      *           "github_url": "https://api.metagraph.sh/example",
                      *           "id": "example-subnet",
                      *           "kind": "subnet-team",
+                     *           "logo_url": "https://api.metagraph.sh/example",
                      *           "name": "Example Subnet",
                      *           "netuids": [
                      *             7
@@ -8258,6 +8328,131 @@ interface operations {
             };
         };
     };
+    rpcUsage: {
+        parameters: {
+            query?: {
+                window?: "7d" | "30d";
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Canonical artifact wrapped in the Metagraphed API envelope. */
+            200: {
+                headers: {
+                    "cache-control": components["headers"]["CacheControl"];
+                    etag: components["headers"]["ETag"];
+                    "x-metagraph-contract-version": components["headers"]["ContractVersion"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "data": {
+                     *         "endpoints": [
+                     *           {
+                     *             "endpoint_id": "https://api.metagraph.sh/example",
+                     *             "ok_requests": 1,
+                     *             "requests": 1
+                     *           }
+                     *         ],
+                     *         "networks": [
+                     *           {
+                     *             "network": "example",
+                     *             "ok_requests": 1,
+                     *             "requests": 1
+                     *           }
+                     *         ],
+                     *         "observed_at": "2026-06-01T00:00:00.000Z",
+                     *         "schema_version": 1,
+                     *         "source": "live-cron-prober",
+                     *         "summary": {
+                     *           "cache_hit_rate": 0.5,
+                     *           "cache_hits": 1,
+                     *           "error_rate": 0.5,
+                     *           "error_requests": 1,
+                     *           "failover_rate": 0.5,
+                     *           "failover_requests": 1,
+                     *           "latency_ms": {},
+                     *           "ok_requests": 1,
+                     *           "total_requests": 1
+                     *         },
+                     *         "window": "30d"
+                     *       },
+                     *       "meta": {
+                     *         "artifact_path": "example",
+                     *         "cache": "short",
+                     *         "contract_version": "2026-06-06.1",
+                     *         "generated_at": "2026-06-01T00:00:00.000Z",
+                     *         "pagination": {
+                     *           "collection": "example",
+                     *           "cursor": 1,
+                     *           "limit": 1,
+                     *           "next_cursor": 1,
+                     *           "order": "asc",
+                     *           "returned": 1,
+                     *           "sort": "example",
+                     *           "total": 1
+                     *         },
+                     *         "published_at": "2026-06-01T00:00:00.000Z",
+                     *         "source": "live-cron-prober"
+                     *       },
+                     *       "ok": true,
+                     *       "schema_version": 1
+                     *     }
+                     */
+                    "application/json": components["schemas"]["SuccessEnvelope"] & {
+                        data?: components["schemas"]["RpcUsageArtifact"];
+                    };
+                };
+            };
+            /** @description ETag matched and the cached response is still valid. */
+            304: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Query parameters were malformed or unsupported. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorEnvelope"];
+                };
+            };
+            /** @description Artifact or API route was not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorEnvelope"];
+                };
+            };
+            /** @description HTTP method is not supported. */
+            405: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorEnvelope"];
+                };
+            };
+            /** @description Unexpected backend error. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorEnvelope"];
+                };
+            };
+        };
+    };
     schemas: {
         parameters: {
             query?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsonbored/metagraphed",
-  "version": "0.3.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": "Apache-2.0",
   "type": "module",
@@ -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"
   }
 }