WIP implement proof of concept for single top-level presenter factory

.gitignore

@@ -50,3 +50,6 @@ auth_config.json
 **content.config.ts
 # TODO Be careful not to git-ignore third-party configs
 **config.json
+
+# COSCRAD CLI command e2e test dummy files
+__cli-command-test-files__

.prettierrc

@@ -2,4 +2,4 @@
   "trailingComma": "es5",
   "tabWidth": 4,
   "singleQuote": true
-}
+}

Jenkinsfile

@@ -1,3 +1,5 @@
+def nodeInstallationName = 'NodeJS 18.12.0'
+
 /* groovylint-disable DuplicateStringLiteral */
 /* groovylint-disable-next-line CompileStatic */
 pipeline {
@@ -9,11 +11,9 @@ pipeline {
     stages {
         stage('ci') {
             agent {
-                docker {
-                    image 'node:18-alpine'
-                    args '-u root'
-                }
+                label 'jenkins-build-agent'
             }
+            tools { nodejs nodeInstallationName }
             environment {
                 NODE_ENV = 'test'
                 NODE_PORT = 3131
@@ -38,6 +38,10 @@ pipeline {
             targetLocation: 'apps/coscrad-frontend/src/auth_config.json')]) {
                     echo 'PR opened or updated...'
                     echo "NODE ENV: ${NODE_ENV}"
+                    echo 'node version:'
+                    sh 'node -v'
+                    echo 'npm version'
+                    sh 'npm -v'
                     echo 'Installing dependencies'
                     sh 'npm ci --legacy-peer-deps'
 
@@ -58,7 +62,7 @@ pipeline {
                     sh 'npm run build:coscrad:prod'
 
                     echo 'testing coscrad-frontend'
-                    sh 'npx nx test coscrad-frontend'
+                    sh 'npx nx test coscrad-frontend --skip-nx-cache'
 
                     echo 'testing api (coscrad back-end)'
 
@@ -72,17 +76,15 @@ pipeline {
                 /* groovylint-disable-next-line LineLength */
                     sh 'touch apps/api/src/app/config/test.env'
 
-                    sh 'npx nx test api'
+                    sh 'npx nx test api --skip-nx-cache'
             }
             }
         }
         stage('deploy to staging') {
             agent {
-                docker {
-                    image 'node:18-alpine'
-                    args '-u root'
-                }
+                label 'jenkins-build-agent'
             }
+            tools { nodejs nodeInstallationName }
             environment {
                 NODE_ENV = 'staging'
                 NODE_PORT = 3131
@@ -123,6 +125,8 @@ pipeline {
                     sh 'cp apps/coscrad-frontend/src/configurable-front-matter/data/content.config.SAMPLE.ts apps/coscrad-frontend/src/configurable-front-matter/data/content.config.ts'
 
                     sh 'npm run build:coscrad:prod'
+
+                    sh 'npx nx run api:build:cli'
             }
             }
                 post {
@@ -137,6 +141,6 @@ pipeline {
                         publishers: [sshPublisherDesc(configName: '[email protected]', transfers: [sshTransfer(cleanRemote: false, excludes: '', execCommand: 'rm -rf archive ; mv build archive; touch archive/dist/apps/api/staging.env; PATH=$PATH://home/coscradmin/.nvm/versions/node/v18.16.0/bin pm2 restart main; echo API restarted', execTimeout: 120000, flatten: false, makeEmptyDirs: false, noDefaultExcludes: false, patternSeparator: '[, ]+', remoteDirectory: 'build', remoteDirectorySDF: false, removePrefix: '', sourceFiles: 'dist/**, node_modules/**')], usePromotionTimestamp: false, useWorkspaceInPromotion: false, verbose: false)])
                     }
                 }
-                }
+        }
     }
 }

apps/api/project.json

@@ -45,6 +45,19 @@
                             "with": "apps/api/src/environments/environment.prod.ts"
                         }
                     ]
+                },
+                "cli": {
+                    "outputPath": "dist/apps/coscrad-cli",
+                    "main": "apps/api/src/cli.ts",
+                    "optimization": true,
+                    "extractLicenses": true,
+                    "inspect": false,
+                    "fileReplacements": [
+                        {
+                            "replace": "apps/api/src/environments/environment.ts",
+                            "with": "apps/api/src/environments/environment.prod.ts"
+                        }
+                    ]  
                 }
             }
         },

apps/api/src/app/controllers/__tests__/__snapshots__/edgeConnectionQueries.e2e.spec.ts.snap

@@ -2504,6 +2504,64 @@ exports[`When querying for edge connections GET /connections/notes should return
       "note": "this library book has the lyrics from the song, but we do not have access to the book",
       "tags": [],
     },
+    {
+      "actions": [],
+      "connectedResources": [
+        {
+          "compositeIdentifier": {
+            "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b110003",
+            "type": "bibliographicReference",
+          },
+          "context": {
+            "type": "general",
+          },
+          "role": "from",
+        },
+        {
+          "compositeIdentifier": {
+            "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b110024",
+            "type": "book",
+          },
+          "context": {
+            "type": "general",
+          },
+          "role": "to",
+        },
+      ],
+      "connectionType": "dual",
+      "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b113201",
+      "note": "this is why bibliographic_references/3 is connected to book/24",
+      "tags": [],
+    },
+    {
+      "actions": [],
+      "connectedResources": [
+        {
+          "compositeIdentifier": {
+            "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b110023",
+            "type": "bibliographicReference",
+          },
+          "context": {
+            "type": "general",
+          },
+          "role": "from",
+        },
+        {
+          "compositeIdentifier": {
+            "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b110024",
+            "type": "book",
+          },
+          "context": {
+            "type": "general",
+          },
+          "role": "to",
+        },
+      ],
+      "connectionType": "dual",
+      "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b113202",
+      "note": "this is why bibliographic_references/23 is connected to book/24",
+      "tags": [],
+    },
   ],
   "indexScopedActions": [],
 }

apps/api/src/app/controllers/__tests__/__snapshots__/fetchManyViewModels.e2e.spec.ts.snap

@@ -5,7 +5,7 @@ exports[`When fetching multiple resources GET /resources/audioItems when all of
   "entities": [
     {
       "actions": [],
-      "audioURL": "https://www.metalmondays.com/1.mp3",
+      "audioURL": "https://be.tsilhqotinlanguage.ca:3003/download?id=5671983.mp3",
       "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b110110",
       "lengthMilliseconds": 20000,
       "mimeType": "audio/mpeg",
@@ -24,7 +24,7 @@ exports[`When fetching multiple resources GET /resources/audioItems when all of
     },
     {
       "actions": [],
-      "audioURL": "https://www.metalmondays.com/1.mp3",
+      "audioURL": "https://be.tsilhqotinlanguage.ca:3003/download?id=5670051.mp3",
       "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b110111",
       "lengthMilliseconds": 23409,
       "mimeType": "audio/mpeg",
@@ -44,7 +44,7 @@ exports[`When fetching multiple resources GET /resources/audioItems when all of
     },
     {
       "actions": [],
-      "audioURL": "https://www.metalmondays.com/1.mp3",
+      "audioURL": "https://be.tsilhqotinlanguage.ca:3003/download?id=5671983.mp3",
       "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b110113",
       "lengthMilliseconds": 32989,
       "mimeType": "audio/mpeg",
@@ -71,7 +71,7 @@ exports[`When fetching multiple resources GET /resources/audioItems when some of
   "entities": [
     {
       "actions": [],
-      "audioURL": "https://www.metalmondays.com/1.mp3",
+      "audioURL": "https://be.tsilhqotinlanguage.ca:3003/download?id=5671983.mp3",
       "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b110110",
       "lengthMilliseconds": 20000,
       "mimeType": "audio/mpeg",
@@ -90,7 +90,7 @@ exports[`When fetching multiple resources GET /resources/audioItems when some of
     },
     {
       "actions": [],
-      "audioURL": "https://www.metalmondays.com/1.mp3",
+      "audioURL": "https://be.tsilhqotinlanguage.ca:3003/download?id=5670051.mp3",
       "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b110111",
       "lengthMilliseconds": 23409,
       "mimeType": "audio/mpeg",
@@ -110,7 +110,7 @@ exports[`When fetching multiple resources GET /resources/audioItems when some of
     },
     {
       "actions": [],
-      "audioURL": "https://www.metalmondays.com/1.mp3",
+      "audioURL": "https://be.tsilhqotinlanguage.ca:3003/download?id=5671983.mp3",
       "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b110113",
       "lengthMilliseconds": 32989,
       "mimeType": "audio/mpeg",
@@ -144,14 +144,18 @@ exports[`When fetching multiple resources GET /resources/bibliographicReferences
             "name": "Alana Duvernay",
             "type": "author",
           },
+          {
+            "name": "James Smith",
+            "type": "author",
+          },
         ],
         "isbn": "978-1-895811-34-6",
         "numberOfPages": 455,
         "place": "Kennebunk Port, Maine",
         "publisher": "Atlantic Publishing",
         "title": "A Day in the Life",
         "type": "book",
-        "url": "https://atlanticpublishing.com",
+        "url": "https://atlanticpublishing.com/authors/Duvernay/NewBook/BookInformation/",
         "year": 1999,
       },
       "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b110001",
@@ -216,10 +220,10 @@ exports[`When fetching multiple resources GET /resources/bibliographicReferences
     {
       "actions": [],
       "data": {
-        "abstract": "William, June
-- Nemiah Valley
-- Qualifying as an expert in Tsilhqot'in written language",
-        "caseName": "2002-07-08_Tsilhqot'inTitleCase",
+        "abstract": "Doe, Jane
+- Large Valley
+- Qualifying as an expert in the written language",
+        "caseName": "2002-07-08_NationTitleCase",
         "court": "Supreme Court of British Columbia",
         "dateDecided": "Recorded 2002-07-08",
         "pages": "Pages 1-6",
@@ -261,14 +265,18 @@ exports[`When fetching multiple resources GET /resources/bibliographicReferences
             "name": "Alana Duvernay",
             "type": "author",
           },
+          {
+            "name": "James Smith",
+            "type": "author",
+          },
         ],
         "isbn": "978-1-895811-34-6",
         "numberOfPages": 455,
         "place": "Kennebunk Port, Maine",
         "publisher": "Atlantic Publishing",
         "title": "A Day in the Life",
         "type": "book",
-        "url": "https://atlanticpublishing.com",
+        "url": "https://atlanticpublishing.com/authors/Duvernay/NewBook/BookInformation/",
         "year": 1999,
       },
       "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b110001",
@@ -333,10 +341,10 @@ exports[`When fetching multiple resources GET /resources/bibliographicReferences
     {
       "actions": [],
       "data": {
-        "abstract": "William, June
-- Nemiah Valley
-- Qualifying as an expert in Tsilhqot'in written language",
-        "caseName": "2002-07-08_Tsilhqot'inTitleCase",
+        "abstract": "Doe, Jane
+- Large Valley
+- Qualifying as an expert in the written language",
+        "caseName": "2002-07-08_NationTitleCase",
         "court": "Supreme Court of British Columbia",
         "dateDecided": "Recorded 2002-07-08",
         "pages": "Pages 1-6",
@@ -682,7 +690,7 @@ exports[`When fetching multiple resources GET /resources/mediaItems when all of
       ],
       "title": "episode title (in language)",
       "titleEnglish": "Metal Mondays episode 1",
-      "url": "https://www.metalmondays.com/1.mp3",
+      "url": "https://be.tsilhqotinlanguage.ca:3003/download?id=5671983.mp3",
     },
     {
       "actions": [],
@@ -694,6 +702,16 @@ exports[`When fetching multiple resources GET /resources/mediaItems when all of
       "titleEnglish": "cool video",
       "url": "https://be.tsilhqotinlanguage.ca:3003/download?id=3028_6d3b2a922b.mp4",
     },
+    {
+      "actions": [],
+      "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b110003",
+      "lengthMilliseconds": 2500,
+      "mimeType": "audio/mpeg",
+      "tags": [],
+      "title": "episode title (in language)",
+      "titleEnglish": "Metal Mondays episode 2",
+      "url": "https://be.tsilhqotinlanguage.ca:3003/download?id=5670051.mp3",
+    },
   ],
   "indexScopedActions": [],
 }
@@ -741,7 +759,7 @@ exports[`When fetching multiple resources GET /resources/mediaItems when some of
       ],
       "title": "episode title (in language)",
       "titleEnglish": "Metal Mondays episode 1",
-      "url": "https://www.metalmondays.com/1.mp3",
+      "url": "https://be.tsilhqotinlanguage.ca:3003/download?id=5671983.mp3",
     },
     {
       "actions": [],
@@ -753,6 +771,16 @@ exports[`When fetching multiple resources GET /resources/mediaItems when some of
       "titleEnglish": "cool video",
       "url": "https://be.tsilhqotinlanguage.ca:3003/download?id=3028_6d3b2a922b.mp4",
     },
+    {
+      "actions": [],
+      "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b110003",
+      "lengthMilliseconds": 2500,
+      "mimeType": "audio/mpeg",
+      "tags": [],
+      "title": "episode title (in language)",
+      "titleEnglish": "Metal Mondays episode 2",
+      "url": "https://be.tsilhqotinlanguage.ca:3003/download?id=5670051.mp3",
+    },
   ],
   "indexScopedActions": [],
 }
@@ -906,7 +934,16 @@ exports[`When fetching multiple resources GET /resources/playlists when all of t
     {
       "actions": [],
       "episodes": [
-        "audioItem/9b1deb4d-3b7d-4bad-9bdd-2b0d7b110110",
+        {
+          "mediaItemUrl": "https://be.tsilhqotinlanguage.ca:3003/download?id=5671983.mp3",
+          "mimeType": "audio/mpeg",
+          "name": "{eng}: The Wooden Boy",
+        },
+        {
+          "mediaItemUrl": "https://be.tsilhqotinlanguage.ca:3003/download?id=5670051.mp3",
+          "mimeType": "audio/mpeg",
+          "name": "{clc}: Down at the River",
+        },
       ],
       "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b110501",
       "name": {
@@ -946,7 +983,16 @@ exports[`When fetching multiple resources GET /resources/playlists when some of
     {
       "actions": [],
       "episodes": [
-        "audioItem/9b1deb4d-3b7d-4bad-9bdd-2b0d7b110110",
+        {
+          "mediaItemUrl": "https://be.tsilhqotinlanguage.ca:3003/download?id=5671983.mp3",
+          "mimeType": "audio/mpeg",
+          "name": "{eng}: The Wooden Boy",
+        },
+        {
+          "mediaItemUrl": "https://be.tsilhqotinlanguage.ca:3003/download?id=5670051.mp3",
+          "mimeType": "audio/mpeg",
+          "name": "{clc}: Down at the River",
+        },
       ],
       "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b110501",
       "name": {