Add a test showing API graphs for TypeScript types.

Author: Max Schaefer

javascript/ql/test/ApiGraphs/typescript-test/ApiGraph.expected

@@ -0,0 +1,19 @@
+#-----| root
+#-----| module mongoose -> use (module mongoose)
+#-----| module typescript-test -> def (module typescript-test)
+
+#-----| def (module typescript-test)
+#-----| member exports -> def (member exports (module typescript-test))
+
+#-----| use (module mongoose)
+#-----| member exports -> use (member exports (module mongoose))
+
+#-----| def (member exports (module typescript-test))
+#-----| member Sized -> def (member Sized (member exports (module typescript-test)))
+
+#-----| use (member exports (module mongoose))
+#-----| member Model -> use (member Model (member exports (module mongoose)))
+
+#-----| def (member Sized (member exports (module typescript-test)))
+
+#-----| use (member Model (member exports (module mongoose)))

javascript/ql/test/ApiGraphs/typescript-test/ApiGraph.ql

@@ -0,0 +1,61 @@
+/**
+ * @name API graph
+ * @description Shows the API graph of a code base.
+ * @kind graph
+ * @id js/api-graph
+ */
+
+import javascript
+
+/** Gets a string representation of the location information for `nd`. */
+string locationString(API::Node nd) {
+  exists(string fp, int sl, int sc, int el, int ec | nd.hasLocationInfo(fp, sl, sc, el, ec) |
+    result = fp + ":" + sl + ":" + sc + ":" + el + ":" + ec
+  )
+}
+
+/**
+ * Gets the rank of node `nd` among all nodes ordered by depth, string representation,
+ * and location.
+ */
+int nodeRank(API::Node nd) {
+  nd =
+    rank[result + 1](API::Node nd2 |
+      |
+      nd2 order by nd2.getDepth(), nd2.toString(), locationString(nd2)
+    )
+}
+
+/**
+ * Gets the rank of `lbl` among all labels on outgoing edges of `pred`, ordered alphabetically.
+ */
+int labelRank(API::Node pred, string lbl, API::Node succ) {
+  lbl + "->" + nodeRank(succ) =
+    rank[result + 1](string l, API::Node s |
+      s = pred.getASuccessor(l)
+      or
+      pred.refersTo(s) and l = ""
+    |
+      l + "->" + nodeRank(s)
+    )
+}
+
+query predicate nodes(API::Node f, string key, string value) {
+  key = "semmle.order" and
+  value = nodeRank(f).toString()
+}
+
+query predicate edges(API::Node pred, API::Node succ, string key, string value) {
+  exists(string lbl |
+    succ = pred.getASuccessor(lbl)
+    or
+    pred.refersTo(succ) and
+    lbl = ""
+  |
+    key = "semmle.label" and
+    value = lbl
+    or
+    key = "semmle.order" and
+    value = labelRank(pred, lbl, succ).toString()
+  )
+}

javascript/ql/test/ApiGraphs/typescript-test/index.ts

@@ -0,0 +1,6 @@
+export interface Sized {
+  getSize(): number;
+}
+
+import * as mongoose from "mongoose";
+var myModel : mongoose.Model;

javascript/ql/test/ApiGraphs/typescript-test/package.json

@@ -0,0 +1,6 @@
+{
+    "name": "typescript-test",
+    "dependencies": {
+        "mongoose": "*"
+    }
+}

javascript/ql/test/ApiGraphs/typescript-test/tsconfig.json

@@ -0,0 +1,6 @@
+{
+  "include": ["."],
+  "compilerOptions": {
+    "esModuleInterop": true
+  }
+}