using module-alias programmatically because we want different aliases in dev and prod mode

(in dev mode, we want to directly reference /shared/dist to avoid needing a copy of this directory)

Author: fcamblor

cloud/functions/package-lock.json

@@ -7,6 +7,7 @@
     "serve": "npm run build && env-cmd -f ./.env.local firebase emulators:start --import data --export-on-exit --inspect-functions --project ${FIREBASE_PROJECT_NAME:-voxxrin-v3}",
     "shell": "npm run build && firebase functions:shell",
     "start": "npm run shell",
+    "predeploy": "npm run build && cp -r ../../shared/dist ./lib/shared",
     "deploy": "firebase deploy --only functions --project ${FIREBASE_PROJECT_NAME:-voxxrin-v3}",
     "logs": "firebase functions:log",
     "test": "vitest"
@@ -15,7 +16,7 @@
   "engines": {
     "node": "20"
   },
-  "main": "lib/index.js",
+  "main": "lib/cloud-functions/index.js",
   "dependencies": {
     "@googleapis/youtube": "15.0.0",
     "@js-temporal/polyfill": "^0.4.3",
@@ -36,6 +37,7 @@
     "zod": "3.22.4"
   },
   "devDependencies": {
+    "@types/module-alias": "2.0.4",
     "@types/uuid": "9.0.2",
     "@typescript-eslint/eslint-plugin": "^5.12.0",
     "@typescript-eslint/parser": "^5.12.0",
@@ -49,8 +51,5 @@
     "typescript": "5.4.5",
     "vitest": "0.31.1"
   },
-  "private": true,
-  "_moduleAliases": {
-    "@shared": "../../shared/dist"
-  }
+  "private": true
 }

cloud/functions/package.json

@@ -0,0 +1,9 @@
+import moduleAlias from 'module-alias';
+
+// This needs to be done as soon as possible in the loading process...
+
+const isEmulator = !!process.env.FIREBASE_EMULATOR_HUB || !!process.env.FUNCTIONS_EMULATOR;
+moduleAlias.addAliases({
+  // In Emulator (dev mode) it's easier to directly reference shared/dist folder (so that we don't need to copy its content into lib/shared/ folder)
+  '@shared': isEmulator ? `${__dirname}/../../../../shared/dist`:`${__dirname}/../shared`,
+})

cloud/functions/src/configure-early-module-aliases.ts

@@ -1,4 +1,4 @@
-import 'module-alias/register';
+import './configure-early-module-aliases'
 import express from 'express';
 import * as functions from 'firebase-functions';
 import {declareExpressHttpRoutes} from "./functions/http/api/routes";

cloud/functions/src/index.ts

@@ -4,7 +4,7 @@
     "noImplicitReturns": true,
     "noUnusedLocals": false,
     "rootDir": "./src",
-    "outDir": "lib",
+    "outDir": "lib/cloud-functions/",
     "sourceMap": true,
     "strict": true,
     "target": "es2017",