feat: field "kind" for TheGraph

feat: getLatestRelease

Author: PaulRBerg

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sablier/deployments",
   "description": "Keeping track of Sablier deployments",
-  "version": "1.0.0-alpha.17",
+  "version": "1.0.0-alpha.18",
   "author": {
     "name": "Sablier Labs Ltd",
     "url": "https://sablier.com"

src/indexers/thegraph.ts

@@ -200,6 +200,7 @@ export function getTheGraph(protocol: Sablier.Protocol, chainId: number): Sablie
   if (officialSubgraph) {
     return {
       explorer: `https://thegraph.com/explorer/subgraphs/${officialSubgraph.id}`,
+      kind: "official",
       studio: `https://api.studio.thegraph.com/query/${THEGRAPH_ORG_ID}/${officialSubgraph.name}/version/latest`,
       subgraph: {
         id: officialSubgraph.id,
@@ -213,6 +214,7 @@ export function getTheGraph(protocol: Sablier.Protocol, chainId: number): Sablie
     return {
       customURL: customSubgraph.url,
       explorer: customSubgraph.explorer,
+      kind: "custom",
     };
   }
 

src/releases/index.ts

@@ -27,6 +27,10 @@ export function getAllContractsFor(release: Sablier.Release): Sablier.Contract[]
   return release.deployments.flatMap((deployment) => deployment.contracts);
 }
 
+export function getLatestRelease(protocol: Sablier.Protocol): Sablier.Release | undefined {
+  return _.find(releasesByProtocol[protocol], { isLatest: true });
+}
+
 export function getRelease(protocol: Sablier.Protocol, version: Sablier.Version): Sablier.Release | undefined {
   const versionMap: Record<Sablier.Protocol, (v: Sablier.Version) => boolean> = {
     airdrops: isValidAirdropsVersion,

src/types.ts

@@ -138,7 +138,7 @@ export declare namespace Sablier {
     url: `https://github.com/sablier-labs/${string}`;
   };
 
-  /** Shared “explorer” + “studio” fields (docs written only once) */
+  /** Shared "explorer" + "studio" fields (docs written only once) */
   interface TheGraphCommon {
     /** @description URL to The Graph explorer. */
     explorer?: string;
@@ -148,11 +148,13 @@ export declare namespace Sablier {
   interface TheGraphCustom extends TheGraphCommon {
     /** @description URL to a custom subgraph. */
     customURL: string;
+    kind: "custom";
     subgraph?: never;
   }
 
   interface TheGraphOfficial extends TheGraphCommon {
     customURL?: never;
+    kind: "official";
     subgraph: {
       /** @description ID of the subgraph. */
       id: string;