Firebase Functions ships with a binary (#1003)

We introduce a bin associated with the firebase-functions SDK! The binary exposes a simple server on localhost that describes the Firebase Functions defined in the current directory:

```
$ STACK_CONTROL_API_PORT=8181 npx firebase-functions  # Optionally can pass in a FUNCTIONS_DIR as first arg 
Serving at port 8181

$ curl localhost:8181/__/stack.yaml | jq
{
  "endpoints": {
    "onreqv2": {
      "platform": "gcfv2",
      "labels": {},
      "httpsTrigger": {},
      "entryPoint": "onreqv2"
    },
    "onRequest": {
      "platform": "gcfv1",
      "httpsTrigger": {},
      "entryPoint": "onRequest"
    }
  },
  "specVersion": "v1alpha1",
  "requiredAPIs": []
}
```

.github/workflows/test.yaml

@@ -31,4 +31,4 @@ jobs:
       - run: npm install
       - run: npm run lint
       - run: npm run format
-      - run: npm run test
+      - run: npm run build && npm run test

package.json

@@ -22,6 +22,9 @@
     "lib"
   ],
   "main": "lib/index.js",
+  "bin": {
+    "firebase-functions": "./lib/bin/firebase-functions.js"
+  },
   "types": "lib/index.d.ts",
   "exports": {
     ".": "./lib/index.js",
@@ -178,6 +181,7 @@
     "mz": "^2.7.0",
     "nock": "^10.0.6",
     "prettier": "^1.18.2",
+    "semver": "^7.3.5",
     "sinon": "^7.3.2",
     "ts-node": "^8.3.0",
     "tslint": "^5.18.0",

spec/fixtures/sources/commonjs-grouped/g1.js

@@ -0,0 +1,9 @@
+const functions = require("../../../../src/index");
+
+exports.groupedhttp = functions.https.onRequest((req, resp) => {
+    resp.status(200).send("PASS");
+});
+
+exports.groupedcallable = functions.https.onCall(() => {
+    return "PASS";
+});

spec/fixtures/sources/commonjs-grouped/index.js

@@ -0,0 +1,20 @@
+const functions = require("../../../../src/index");
+const functionsv2 = require("../../../../src/v2/index");
+
+exports.v1http = functions.https.onRequest((req, resp) => {
+    resp.status(200).send("PASS");
+});
+
+exports.v1callable = functions.https.onCall(() => {
+    return "PASS";
+});
+
+exports.v2http = functionsv2.https.onRequest((req, resp) => {
+    resp.status(200).send("PASS");
+});
+
+exports.v2callable = functionsv2.https.onCall(() => {
+    return "PASS";
+});
+
+exports.g1 = require("./g1");

spec/fixtures/sources/commonjs-grouped/package.json

@@ -0,0 +1,3 @@
+{
+  "name": "commonjs-grouped"
+}

spec/fixtures/sources/commonjs-main/functions.js

@@ -0,0 +1,18 @@
+const functions = require("../../../../src/index");
+const functionsv2 = require("../../../../src/v2/index");
+
+exports.v1http = functions.https.onRequest((req, resp) => {
+    resp.status(200).send("PASS");
+});
+
+exports.v1callable = functions.https.onCall(() => {
+    return "PASS";
+});
+
+exports.v2http = functionsv2.https.onRequest((req, resp) => {
+    resp.status(200).send("PASS");
+});
+
+exports.v2callable = functionsv2.https.onCall(() => {
+    return "PASS";
+});

spec/fixtures/sources/commonjs-main/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "commonjs-main",
+  "main": "functions.js"
+}

spec/fixtures/sources/commonjs/index.js

@@ -0,0 +1,18 @@
+const functions = require("../../../../src/index");
+const functionsv2 = require("../../../../src/v2/index");
+
+exports.v1http = functions.https.onRequest((req, resp) => {
+    resp.status(200).send("PASS");
+});
+
+exports.v1callable = functions.https.onCall(() => {
+    return "PASS";
+});
+
+exports.v2http = functionsv2.https.onRequest((req, resp) => {
+    resp.status(200).send("PASS");
+});
+
+exports.v2callable = functionsv2.https.onCall(() => {
+    return "PASS";
+});

spec/fixtures/sources/commonjs/package.json

@@ -0,0 +1,3 @@
+{
+  "name": "commonjs"
+}

spec/fixtures/sources/esm-ext/index.mjs

@@ -0,0 +1,18 @@
+import * as functions from '../../../../lib/index.js';
+import * as functionsv2 from "../../../../lib/v2/index.js";
+
+export const v1http = functions.https.onRequest((req, resp) => {
+  resp.status(200).send("PASS");
+});
+
+export const v1callable = functions.https.onCall(() => {
+  return "PASS";
+});
+
+export const v2http = functionsv2.https.onRequest((req, resp) => {
+  resp.status(200).send("PASS");
+});
+
+export const v2callable = functionsv2.https.onCall(() => {
+  return "PASS";
+});

spec/fixtures/sources/esm-ext/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "esm-ext",
+  "main": "index.mjs"
+}

spec/fixtures/sources/esm-main/functions.js

@@ -0,0 +1,18 @@
+import * as functions from "../../../../lib/index.js";
+import * as functionsv2 from "../../../../lib/v2/index.js";
+
+export const v1http = functions.https.onRequest((req, resp) => {
+    resp.status(200).send("PASS");
+});
+
+export const v1callable = functions.https.onCall(() => {
+    return "PASS";
+});
+
+export const v2http = functionsv2.https.onRequest((req, resp) => {
+    resp.status(200).send("PASS");
+});
+
+export const v2callable = functionsv2.https.onCall(() => {
+    return "PASS";
+});

spec/fixtures/sources/esm-main/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "esm-main",
+  "main": "functions.js",
+  "type": "module"
+}

spec/fixtures/sources/esm/index.js

@@ -0,0 +1,18 @@
+import * as functions from "../../../../lib/index.js";
+import * as functionsv2 from "../../../../lib/v2/index.js";
+
+export const v1http = functions.https.onRequest((req, resp) => {
+    resp.status(200).send("PASS");
+});
+
+export const v1callable = functions.https.onCall(() => {
+    return "PASS";
+});
+
+export const v2http = functionsv2.https.onRequest((req, resp) => {
+    resp.status(200).send("PASS");
+});
+
+export const v2callable = functionsv2.https.onCall(() => {
+    return "PASS";
+});

spec/fixtures/sources/esm/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "esm",
+  "type": "module"
+}