chore(deps): lock file maintenance (#166)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -14,6 +14,9 @@ body:
         4. Before creating this bug report, ensure you updated your applications to the latest versions.
            Check your configurations to ensure there are no typos or errors.
            Docker users should attempt to re-pull the TVApp2 image to ensure caching is not the cause of an issue.
+        5. To get detailed logs of the issue, set the environment variable:
+               `LOG_LEVEL=5`
+           Restart the docker container and you should get more detailed logs.
 
         <br />
 
@@ -126,9 +129,9 @@ body:
   - type: textarea
     id: docker-compose
     attributes:
-      label: docker-compose.yml
+      label: docker-compose.yml / Run command
       description: |
-        Copy / paste your `docker-compose.yml` file here
+        Copy / paste your `docker-compose.yml` file or run command here
 
   - type: textarea
     id: logs
@@ -137,6 +140,7 @@ body:
       description: |
         Paste your docker logs here.
         You can get your docker logs by opening terminal and running `docker logs tvapp2`
+        To get detailed logs, set the environment variable `LOG_LEVEL=5` and restart the container.
 
   - type: textarea
     id: screenshots

.github/ISSUE_TEMPLATE/roadmap.yml

@@ -41,6 +41,7 @@ body:
             - Distribution
             - Documentation
             - M3U / EPG Functionality
+            - Refactor (Code)
             - Repository
             - S6-Overlay
         default: 0

.github/workflows/cache-clean.yml

@@ -0,0 +1,302 @@
+# #
+#   @type               github workflow
+#   @author             Aetherinox
+#   @url                https://github.com/Aetherinox
+#   @usage              cleans up the cache for a repository.
+#   
+#   
+#   You can view your current cached items by going to Github and going to the page:
+#       https://github.com/USERNAME/REPO/actions/caches
+#   
+#   Caches have branch scope restrictions in place, which means some caches have limited usage options. For more information
+#   on cache scope restrictions, see Restrictions for accessing a cache, earlier in this article. If caches limited to a specific
+#   branch are using a lot of storage quota, it may cause caches from the default branch to be created and deleted at a high frequency.
+#   
+#   For example, a repository could have many new pull requests opened, each with their own caches that are restricted to that branch.
+#   These caches could take up the majority of the cache storage for that repository. Once a repository has reached its maximum cache
+#   storage, the cache eviction policy will create space by deleting the caches in order of last access date, from oldest to most
+#   recent. In order to prevent cache thrashing when this happens, you can set up workflows to delete caches on a faster cadence than
+#   the cache eviction policy will. You can use the GitHub CLI to delete caches for specific branches.
+#   
+#   @reference          https://docs.github.com/en/actions/writing-workflows/choosing-what-your-workflow-does/caching-dependencies-to-speed-up-workflows#deleting-cache-entries
+#   
+#   
+#   @secrets            secrets.SELF_TOKEN                                          self github personal access token (fine-grained)
+#                       secrets.SELF_TOKEN_CL                                       self github personal access token (classic)
+#                       secrets.NPM_TOKEN                                           self npmjs access token
+#                       secrets.PYPI_API_TOKEN                                      self Pypi API token (production site) - https://pypi.org/
+#                       secrets.PYPI_API_TEST_TOKEN                                 self Pypi API token (test site) - https://test.pypi.org/
+#                       secrets.SELF_DOCKERHUB_TOKEN                                self Dockerhub token
+#                       secrets.CODECOV_TOKEN                                       codecov upload token for nodejs projects
+#                       secrets.MAXMIND_GELITE_TOKEN                                maxmind API token
+#                       secrets.CF_ACCOUNT_ID                                       cloudflare account id
+#                       secrets.CF_ACCOUNT_TOKEN                                    cloudflare account token
+#                       secrets.ORG_TOKEN                                           org github personal access token (fine-grained)
+#                       secrets.ORG_TOKEN_CL                                        org github personal access token (classic)
+#                       secrets.ORG_DOCKERHUB_TOKEN                                 org dockerhub secret
+#                       secrets.ORG_GITEA_TOKEN                                     org gitea personal access token (classic) with package:write permission
+#                       secrets.BOT_GPG_KEY_ASC                                     bot gpg private key (armored) | BEGIN PGP PRIVATE KEY BLOCK
+#                       secrets.BOT_GPG_KEY_B64                                     bot gpg private key (binary) converted to base64
+#                       secrets.BOT_GPG_PASSPHRASE                                  bot gpg private key passphrase
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_RELEASES                discord webhook to report release notifications from github to discord
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_WORKFLOWS               discord webhook to report workflow notifications from github to discord
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_UPDATES                 discord webhook to report activity notifications from github to discord
+#   
+#
+#   @local              these workflows can be tested locally through the use of `act`
+#                           https://github.com/nektos/act
+#                       Extract act to folder
+#                       Add system env var with path to act.exe
+#                       Run the commands:
+#                           git pull https://github.com/username/repo
+#                           act -W .github/workflows/cache-clean.yml -P ubuntu-latest=catthehacker/ubuntu:full-22.04
+#                           act -W .github/workflows/cache-clean.yml -s TOKEN_CL=XXXXXXXXXX --pull=false
+# #
+
+# #
+
+name: '🧹 Cache › Clean'
+run-name: '🧹 Cache › Clean'
+
+# #
+#   triggers
+# #
+
+on:
+
+    # #
+    #   Trigger › Workflow Dispatch
+    # #
+
+    workflow_dispatch:
+        inputs:
+
+            # #
+            #   Cache › Num Per Page
+            #   
+            #   this is the number of cached items to fetch per page.
+            # #
+
+            NUM_PER_PAGE:
+                description:    '📦 Number Per Page'
+                required:       true
+                default:        '100'
+                type:           string
+
+# #
+#   environment variables
+# #
+
+env:
+    NUM_PER_PAGE:               ${{ github.event.inputs.NUM_PER_PAGE || '100' }}
+    BOT_NAME_1:                 EuropaServ
+    BOT_NAME_2:                 BinaryServ
+    BOT_NAME_DEPENDABOT:        dependabot[bot]
+    BOT_NAME_RENOVATE:          renovate[bot]
+
+# #
+#   jobs
+# #
+
+jobs:
+    cleanup:
+        name: >-
+            🧹 Cache › Clean
+        runs-on: ubuntu-latest
+      # runs-on: apollo-x64
+        timeout-minutes: 5
+        permissions: write-all
+
+        steps:
+
+            # #
+            #   Cache › Clean › Checkout
+            # #
+
+            - name: '☑️ Checkout'
+              uses: actions/checkout@v4
+              with:
+                  fetch-depth: 0
+
+            # #
+            #   Cache › Clean › Job Information
+            # #
+
+            - name: >-
+                  🔄 Load Job
+              uses: qoomon/actions--context@v4
+              id: 'context'
+
+            # #
+            #   Cache › Clean › Start
+            # #
+
+            - name: >-
+                  ✅ Start
+              run: |
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo " Starting Job ${{ steps.context.outputs.job_name }}"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+
+                  YEAR="$(date +'%Y')"
+                  echo "YEAR=${YEAR}" >> $GITHUB_ENV
+
+                  NOW="$(date +'%m-%d-%Y %H:%M:%S')"                                                #  02-25-2025 12:49:48
+                  echo "NOW=${NOW}" >> $GITHUB_ENV
+
+                  NOW_SHORT="$(date +'%m-%d-%Y')"                                                   #  02-25-2025
+                  echo "NOW_SHORT=${NOW_SHORT}" >> $GITHUB_ENV
+
+                  NOW_LONG="$(date +'%m-%d-%Y %H:%M')"                                              #  02-25-2025 12:49
+                  echo "NOW_LONG=${NOW_LONG}" >> $GITHUB_ENV
+
+                  NOW_DOCKER="$(date +'%Y%m%d')"                                                    #  20250225
+                  echo "NOW_DOCKER=${NOW_DOCKER}" >> $GITHUB_ENV
+
+                  NOW_DOCKER_TS="$(date -u +'%FT%T.%3NZ')"                                          #  2025-02-25T12:50:11.569Z
+                  echo "NOW_DOCKER_TS=${NOW_DOCKER_TS}" >> $GITHUB_ENV
+
+                  SHA1="$(git rev-parse HEAD)"                                                      #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1=${SHA1}" >> $GITHUB_ENV
+
+                  SHA1_GH="$(echo ${GITHUB_SHA})"                                                   #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1_GH=${SHA1_GH}" >> $GITHUB_ENV
+
+                  PKG_VER_1DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -d '.' -f1-1)"              #  3.22 > 3
+                  echo "PKG_VER_1DIGIT=${PKG_VER_1DIGIT}" >> $GITHUB_ENV
+
+                  PKG_VER_2DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -f2 -d ":" | cut -c1-3)"    #  3.22 > 3.2
+                  echo "PKG_VER_2DIGIT=${PKG_VER_2DIGIT}" >> $GITHUB_ENV
+
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  sudo apt -qq update
+                  sudo apt -qq install tree
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo " Runner .............. ${{ runner.name }}"
+                  echo " Workflow ............ ${{ github.workflow }} (#${{ github.workflow_ref }})"
+                  echo " Run Number .......... ${{ github.run_number }}"
+                  echo " Ref ................. ${{ github.ref }}"
+                  echo " Ref Name ............ ${{ github.ref_name }}"
+                  echo " Event Name .......... ${{ github.event_name }}"
+                  echo " Repo ................ ${{ github.repository }}"
+                  echo " Repo Owner .......... ${{ github.repository_owner }}"
+                  echo " Run ID .............. https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+                  echo " Triggered By ........ ${{ github.actor }}"
+                  echo " SHA 1 (GITHUB_SHA) .. ${GITHUB_SHA}"
+                  echo " SHA 2 (github.sha) .. ${{ github.sha }}"
+                  echo " SHA 3 (env.SHA1) .... ${SHA1}"
+                  echo " SHA 4 (env.SHA1_GH) . ${SHA1_GH}"
+                  echo " Workspace ........... ${{ github.workspace }}"
+                  echo " PWD ................. ${PWD}"
+                  echo " Job Name ............ ${{ steps.context.outputs.job_name }}"
+                  echo " Job ID .............. ${{ steps.context.outputs.job_id }}"
+                  echo " Job URL ............. ${{ steps.context.outputs.job_url }}"
+                  echo " Run ID .............. ${{ steps.context.outputs.run_id }}"
+                  echo " Run Attempt ......... ${{ steps.context.outputs.run_attempt }}"
+                  echo " Run Number .......... ${{ steps.context.outputs.run_number }}"
+                  echo " Run URL ............. ${{ steps.context.outputs.run_url }}"
+                  echo " Run Env ............. ${{ steps.context.outputs.environment }}"
+                  echo " Run Env URL ......... ${{ steps.context.outputs.environment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Deployment URL .. ${{ steps.context.outputs.deployment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Runner Name ..... ${{ steps.context.outputs.runner_name }}"
+                  echo " Run Runner ID ....... ${{ steps.context.outputs.runner_id }}"
+                  echo " Year ................ ${YEAR}"
+                  echo " Now ................. ${NOW}"
+                  echo " Now (Short) ......... ${NOW_SHORT}"
+                  echo " Now (Long) .......... ${NOW_LONG}"
+                  echo " Now (Docker) ........ ${NOW_DOCKER}"
+                  echo " Now (Docker TS) ..... ${NOW_DOCKER_TS}"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  tree -I node_modules -I .git
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+
+            # #
+            #   Cache › Clean › Start
+            #   
+            #   You can view your current cached items by going to Github and going to the page:
+            #       https://github.com/USERNAME/REPO/actions/caches
+            #   
+            #   Caches have branch scope restrictions in place, which means some caches have limited usage options. For more information
+            #   on cache scope restrictions, see Restrictions for accessing a cache, earlier in this article. If caches limited to a specific
+            #   branch are using a lot of storage quota, it may cause caches from the default branch to be created and deleted at a high frequency.
+            #   
+            #   For example, a repository could have many new pull requests opened, each with their own caches that are restricted to that branch.
+            #   These caches could take up the majority of the cache storage for that repository. Once a repository has reached its maximum cache
+            #   storage, the cache eviction policy will create space by deleting the caches in order of last access date, from oldest to most
+            #   recent. In order to prevent cache thrashing when this happens, you can set up workflows to delete caches on a faster cadence than
+            #   the cache eviction policy will. You can use the GitHub CLI to delete caches for specific branches.
+            #   
+            #   @reference      https://docs.github.com/en/actions/writing-workflows/choosing-what-your-workflow-does/caching-dependencies-to-speed-up-workflows#deleting-cache-entries
+            # #
+
+            - name: >-
+                🪣 Cache › Clean
+              uses: actions/github-script@v7
+              with:
+                  script: |
+                          try
+                          {
+                              const cacheConf =
+                              {
+                                  owner: context.repo.owner,
+                                  repo: context.repo.repo,
+                                  per_page: ${{ env.NUM_PER_PAGE }},
+                              };
+
+                              console.log( `✅ Starting to clean cache; showing ${{ env.NUM_PER_PAGE }} cached items per page` )
+                              const caches = await github.rest.actions.getActionsCacheList( cacheConf )
+
+                              while( caches.data.actions_caches.length )
+                              {
+                                  for ( const cache of caches.data.actions_caches )
+                                  {
+                                      console.log( `⚠️ Clearing cache id: ${cache.key} (${cache.id})` )
+                                      const res = await github.rest.actions.deleteActionsCacheById(
+                                      {
+                                          owner: context.repo.owner,
+                                          repo: context.repo.repo,
+                                          cache_id: cache.id,
+                                      });
+
+                                      console.log( `✔️ Cache item ${cache.key} (${cache.id}) cleared at ${new Date().toISOString()}` )
+                                  }
+
+                                  caches = await github.rest.actions.getActionsCacheList(congif);
+                                  console.log( `Getting another ${caches.data.actions_caches.length} caches from github ...` );
+                              }
+
+                              console.log( `✔️ Finished cleaning the cache` );
+                          }
+                          catch( e )
+                          {
+                              console.log( `❌ The workflow has terminated with an error:`, e )
+                              return;
+                          }
+
+            # #
+            #   Cache › Clean › Get Weekly Commits
+            # #
+
+            - name: >-
+                🕛 Get Weekly Commit List
+              run: |
+                  echo 'WEEKLY_COMMITS<<EOF' >> $GITHUB_ENV
+                  git log --format="[\`%h\`](${{ github.server_url }}/${{ github.repository }}/commit/%H) %s - %an" --since=7.days >> $GITHUB_ENV
+                  echo 'EOF' >> $GITHUB_ENV

.github/workflows/deploy-clean.yml

@@ -12,15 +12,21 @@
 #                       secrets.PYPI_API_TOKEN                                      self Pypi API token (production site) - https://pypi.org/
 #                       secrets.PYPI_API_TEST_TOKEN                                 self Pypi API token (test site) - https://test.pypi.org/
 #                       secrets.SELF_DOCKERHUB_TOKEN                                self Dockerhub token
-#                       secrets.ORG_BINARYNINJA_TOKEN                               org github personal access token (fine-grained)
+#                       secrets.CODECOV_TOKEN                                       codecov upload token for nodejs projects
-#                       secrets.ORG_BINARYNINJA_TOKEN_CL                            org github personal access token (classic)
+#                       secrets.MAXMIND_GELITE_TOKEN                                maxmind API token
-#                       secrets.ORG_BINARYNINJA_DOCKERHUB_TOKEN                     org dockerhub secret
+#                       secrets.CF_ACCOUNT_ID                                       cloudflare account id
-#                       secrets.ORG_BINARYNINJA_GITEA_TOKEN                         org gitea personal access token (classic) with package:write permission
+#                       secrets.CF_ACCOUNT_TOKEN                                    cloudflare account token
-#                       secrets.BINARYSERV_GPG_KEY_ASC                              bot gpg private key (armored) | BEGIN PGP PRIVATE KEY BLOCK
+#                       secrets.ORG_TOKEN                                           org github personal access token (fine-grained)
-#                       secrets.BINARYSERV_GPG_PASSPHRASE                           bot gpg private key passphrase
+#                       secrets.ORG_TOKEN_CL                                        org github personal access token (classic)
-#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_RELEASES         discord webhook to report release notifications from github to discord
+#                       secrets.ORG_DOCKERHUB_TOKEN                                 org dockerhub secret
-#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_WORKFLOWS        discord webhook to report workflow notifications from github to discord
+#                       secrets.ORG_GITEA_TOKEN                                     org gitea personal access token (classic) with package:write permission
-#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_UPDATES          discord webhook to report activity notifications from github to discord
+#                       secrets.BOT_GPG_KEY_ASC                                     bot gpg private key (armored) | BEGIN PGP PRIVATE KEY BLOCK
+#                       secrets.BOT_GPG_KEY_B64                                     bot gpg private key (binary) converted to base64
+#                       secrets.BOT_GPG_PASSPHRASE                                  bot gpg private key passphrase
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_RELEASES                discord webhook to report release notifications from github to discord
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_WORKFLOWS               discord webhook to report workflow notifications from github to discord
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_UPDATES                 discord webhook to report activity notifications from github to discord
+#
 #
 #   @local              these workflows can be tested locally through the use of `act`
 #                           https://github.com/nektos/act
@@ -32,14 +38,21 @@
 #                           act -W .github/workflows/deploy-clean.yml -s TOKEN_CL=XXXXXXXXXX --pull=false
 # #
 
-name: "⚙️ Deploy › Clean"
+# #
-run-name: "⚙️ Deploy › Clean"
+
+name: '🧹 Deployments › Clean'
+run-name: '🧹 Deployments › Clean'
 
 # #
 #   triggers
 # #
 
 on:
+
+    # #
+    #   Trigger > Workflow Dispatch
+    # #
+
     workflow_dispatch:
         inputs:
 
@@ -67,78 +80,69 @@ on:
                 default:        '1000'
                 type:           string
 
+            # #
+            #   Discord Bot › Name
+            #
+            #   The discord bot name
+            # #
+
+            DISCORD_BOT_NAME:
+                description:    '🤖 Bot Name'
+                required:       true
+                default:        'Europa'
+                type:           string
+
+            # #
+            #   Discord Bot › Avatar
+            #
+            #   The discord bot avatar to show; let's use some weird picture
+            # #
+
+            DISCORD_BOT_AVATAR:
+                description:    '🤖 Avatar URL'
+                required:       true
+                default:        'https://i.imgur.com/UqwMom1.jpeg'
+                type:           string
+
+            # #
+            #   Discord Bot › Author Icon URL
+            #
+            #   A small picture shown to the top-right of each post
+            # #
+
+            DISCORD_BOT_EMBED_AUTHOR_ICON:
+                description:    '🤖 Embed Author Icon'
+                required:       true
+                default:        'https://avatars.githubusercontent.com/u/200161462'
+                type:           string
+
+            # #
+            #   Discord Bot › Thumbnail URL
+            #
+            #   A small picture shown to the top-right of each post
+            # #
+
+            DISCORD_BOT_EMBED_THUMBNAIL:
+                description:    '🤖 Embed Thumbnail URL'
+                required:       true
+                default:        'https://avatars.githubusercontent.com/u/200161462'
+                type:           string
+
 # #
 #   environment variables
 # #
 
 env:
-    DEPLOYMENT_ENV:             ${{ github.event.inputs.DEPLOYMENT_ENV || 'orion' }}
+    DEPLOYMENT_ENV:                   ${{ github.event.inputs.DEPLOYMENT_ENV || 'orion' }}
-    DEPLOYMENT_DELAY:           ${{ github.event.inputs.DEPLOYMENT_DELAY || '1000' }}
+    DEPLOYMENT_DELAY:                 ${{ github.event.inputs.DEPLOYMENT_DELAY || '1000' }}
-    BOT_NAME_1:                 EuropaServ
+    DISCORD_BOT_NAME:                 ${{ github.event.inputs.DISCORD_BOT_NAME || 'Europa' }}
-    BOT_NAME_2:                 BinaryServ
+    DISCORD_BOT_AVATAR:               ${{ github.event.inputs.DISCORD_BOT_AVATAR || 'https://i.imgur.com/UqwMom1.jpeg' }}
-    BOT_NAME_DEPENDABOT:        dependabot[bot]
+    DISCORD_BOT_EMBED_AUTHOR_ICON:    ${{ github.event.inputs.DISCORD_BOT_EMBED_AUTHOR_ICON || 'https://avatars.githubusercontent.com/u/200161462' }}
-    BOT_NAME_RENOVATE:          renovate[bot]
+    DISCORD_BOT_EMBED_THUMBNAIL:      ${{ github.event.inputs.DISCORD_BOT_EMBED_THUMBNAIL || 'https://avatars.githubusercontent.com/u/200161462' }}
-    LABELS_JSON: |
+    BOT_NAME_1:                       EuropaServ
-      [
+    BOT_NAME_2:                       BinaryServ
-          { "name": "AC › Changes Made",           "color": "8F1784", "description": "Requested changes have been made and are pending a re-scan" },
+    BOT_NAME_DEPENDABOT:              dependabot[bot]
-          { "name": "AC › Changes Required",       "color": "8F1784", "description": "Requires changes to be made to the package before being accepted" },
+    BOT_NAME_RENOVATE:                renovate[bot]
-          { "name": "AC › Failed",                 "color": "a61f2d", "description": "Autocheck failed to run through a complete cycle, requires investigation" },
-          { "name": "AC › Needs Rebase",           "color": "8F1784", "description": "Due to the permissions on the requesting repo, this pull request must be rebased by the author" },
-          { "name": "AC › Passed",                 "color": "146b4a", "description": "Ready to be reviewed" },
-          { "name": "AC › Review Required",        "color": "8F1784", "description": "PR needs to be reviewed by another person, after the requested changes have been made" },
-          { "name": "AC › Security Warning",       "color": "761620", "description": "Does not conform to developer policies, or includes potentially dangerous code" },
-          { "name": "AC › Skipped Scan",           "color": "8F1784", "description": "Author has skipped code scan" },
-          { "name": "Status 𐄂 Duplicate",          "color": "75536b", "description": "Issue or pull request already exists" },
-          { "name": "Status 𐄂 Accepted",            "color": "2e7539", "description": "This pull request has been accepted" },
-          { "name": "Status 𐄂 Autoclosed",          "color": "3E0915", "description": "Originally stale and was autoclosed for no activity" },
-          { "name": "Status 𐄂 Denied",              "color": "ba4058", "description": "Pull request has been denied" },
-          { "name": "Status 𐄂 Locked",              "color": "550F45", "description": "Automatically locked by EuropaServ for a prolonged period of inactivity" },
-          { "name": "Status 𐄂 Need Info",           "color": "2E3C4C", "description": "Not enough information to resolve" },
-          { "name": "Status 𐄂 No Action",           "color": "030406", "description": "Closed without any action being taken" },
-          { "name": "Status 𐄂 Pending",             "color": "984b12", "description": "Pending pull request" },
-          { "name": "Status 𐄂 Released",            "color": "1b6626", "description": "Issues or PR has been implemented and is now live" },
-          { "name": "Status 𐄂 Reopened",            "color": "8a6f14", "description": "A previously closed PR which has been re-opened" },
-          { "name": "Status 𐄂 Review",              "color": "9e1451", "description": "Currently pending review" },
-          { "name": "Status 𐄂 Stale",               "color": "928282", "description": "Has not had any activity in over 30 days" },
-          { "name": "Type ◦ Bug",                   "color": "9a2c2c", "description": "Something isn't working" },
-          { "name": "Type ◦ Dependency",            "color": "243759", "description": "Item is associated to dependency" },
-          { "name": "Type ◦ Docs",                  "color": "0e588d", "description": "Improvements or modifications to docs" },
-          { "name": "Type ◦ Feature",               "color": "3c4e93", "description": "Feature request" },
-          { "name": "Type ◦ Git Action",            "color": "030406", "description": "GitHub Action / workflow" },
-          { "name": "Type ◦ Pull Request",          "color": "8F1784", "description": "Normal pull request" },
-          { "name": "Type ◦ Roadmap",               "color": "8F1784", "description": "Feature or bug currently planned for implementation" },
-          { "name": "Type ◦ Internal",              "color": "A51994", "description": "Assigned items are for internal developer use" },
-          { "name": "Build ◦ Desktop",              "color": "c7ca4a", "description": "Specific to desktop" },
-          { "name": "Build ◦ Linux",                "color": "c7ca4a", "description": "Specific to Linux" },
-          { "name": "Build ◦ MacOS",                "color": "c7ca4a", "description": "Specific to MacOS" },
-          { "name": "Build ◦ Mobile",               "color": "c7ca4a", "description": "Specific to mobile" },
-          { "name": "Build ◦ Web",                  "color": "c7ca4a", "description": "Specific to web" },
-          { "name": "Build ◦ Windows",              "color": "c7ca4a", "description": "Specific to Windows" },
-          { "name": "› API",                        "color": "F99B50", "description": "Plugin API, CLI, browser JS API" },
-          { "name": "› Auto-type",                  "color": "9141E0", "description": "Auto-type functionality in desktop apps" },
-          { "name": "› Browser",                    "color": "9141E0", "description": "Browser plugins and passing data to <=> from app" },
-          { "name": "› Customization",              "color": "E3F0FC", "description": "Customizations: plugins, themes, configs" },
-          { "name": "› Design",                     "color": "FA70DE", "description": "Design related queries" },
-          { "name": "› Dist",                       "color": "FA70DE", "description": "Installers and other forms of software distribution" },
-          { "name": "› Enterprise",                 "color": "11447a", "description": "Issues about collaboration, administration, and so on" },
-          { "name": "› Hardware",                   "color": "5a7503", "description": "YubiKey, other tokens, biometrics" },
-          { "name": "› Import/Export",              "color": "F5FFCC", "description": "Import from and export to different file formats" },
-          { "name": "› Improvement",                "color": "185c98", "description": "Enhance an existing feature" },
-          { "name": "› Performance",                "color": "006b75", "description": "Web and desktop performance issues" },
-          { "name": "› Plugin Request",             "color": "FCE9CA", "description": "Requested changes should be implemented as a plugin" },
-          { "name": "› Security",                   "color": "F75D39", "description": "Security issues" },
-          { "name": "› Self-Hosting",               "color": "fad8c7", "description": "Self-hosting installations and configs" },
-          { "name": "› Storage",                    "color": "5319e7", "description": "Storage providers: Dropbox, Google, WebDAV, etc." },
-          { "name": "› Updater",                    "color": "1BADDE", "description": "Auto-updater issues" },
-          { "name": "› UX",                         "color": "1BADDE", "description": "UX and usability" },
-          { "name": "› Website",                    "color": "fef2c0", "description": "Website related issues" },
-          { "name": "⚠ Urgent",                     "color": "a8740e", "description": "Requires urgent attention" },
-          { "name": "⚠ Announcement",               "color": "DB4712", "description": "Announcements" },
-          { "name": "📰 Progress Report",           "color": "392297", "description": "Development updates" },
-          { "name": "📦 Release",                   "color": "277542", "description": "Release announcements" },
-          { "name": "✔️ Poll",                      "color": "972255", "description": "Community polls" },
-          { "name": "❔ Question",                  "color": "FFFFFF", "description": "All questions" }
-      ]
 
 # #
 #   jobs
@@ -146,43 +150,139 @@ env:
 
 jobs:
     cleanup:
-      # runs-on: ubuntu-latest
+        name: >-
-        runs-on: apollo-x64
+            🧹 Deployments › Clean
-        timeout-minutes: 20
+        runs-on: ubuntu-latest
+      # runs-on: apollo-x64
+        timeout-minutes: 5
         permissions: write-all
+
         steps:
 
             # #
-            #   Cleanup › Set Env Variables
+            #   Deployments › Cleanup › Checkout
             # #
 
-            - name: >-
+            - name: '☑️ Checkout'
-                🕛 Get Timestamp
-              id: task_cleanup_set_timestamp
-              run: |
-                  echo "NOW=$(date +'%m-%d-%Y %H:%M:%S')" >> $GITHUB_ENV
-                  echo "NOW_SHORT=$(date +'%m-%d-%Y')" >> $GITHUB_ENV
-                  echo "NOW_LONG=$(date +'%m-%d-%Y %H:%M')" >> $GITHUB_ENV
-                  echo "NOW_DOCKER_LABEL=$(date +'%Y%m%d')" >> $GITHUB_ENV
-
-            # #
-            #   Release › Github › Checkout › Arm64
-            # #
-
-            - name: >-
-                ✅ Checkout
-              id: task_cleanup_gh_checkout
               uses: actions/checkout@v4
               with:
                   fetch-depth: 0
 
             # #
-            #   Cleanup › Start
+            #   Deployments › Cleanup › Job Information
+            # #
+
+            - name: >-
+                  🔄 Load Job
+              uses: qoomon/actions--context@v4
+              id: 'context'
+
+            # #
+            #   Deployments › Cleanup › Start
+            # #
+
+            - name: >-
+                  ✅ Start
+              run: |
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo " Starting Job ${{ steps.context.outputs.job_name }}"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+
+                  YEAR="$(date +'%Y')"
+                  echo "YEAR=${YEAR}" >> $GITHUB_ENV
+
+                  NOW="$(date +'%m-%d-%Y %H:%M:%S')"                                                #  02-25-2025 12:49:48
+                  echo "NOW=${NOW}" >> $GITHUB_ENV
+
+                  NOW_SHORT="$(date +'%m-%d-%Y')"                                                   #  02-25-2025
+                  echo "NOW_SHORT=${NOW_SHORT}" >> $GITHUB_ENV
+
+                  NOW_LONG="$(date +'%m-%d-%Y %H:%M')"                                              #  02-25-2025 12:49
+                  echo "NOW_LONG=${NOW_LONG}" >> $GITHUB_ENV
+
+                  NOW_DOCKER="$(date +'%Y%m%d')"                                                    #  20250225
+                  echo "NOW_DOCKER=${NOW_DOCKER}" >> $GITHUB_ENV
+
+                  NOW_DOCKER_TS="$(date -u +'%FT%T.%3NZ')"                                          #  2025-02-25T12:50:11.569Z
+                  echo "NOW_DOCKER_TS=${NOW_DOCKER_TS}" >> $GITHUB_ENV
+
+                  SHA1="$(git rev-parse HEAD)"                                                      #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1=${SHA1}" >> $GITHUB_ENV
+
+                  SHA1_GH="$(echo ${GITHUB_SHA})"                                                   #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1_GH=${SHA1_GH}" >> $GITHUB_ENV
+
+                  PKG_VER_1DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -d '.' -f1-1)"              #  3.22 > 3
+                  echo "PKG_VER_1DIGIT=${PKG_VER_1DIGIT}" >> $GITHUB_ENV
+
+                  PKG_VER_2DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -f2 -d ":" | cut -c1-3)"    #  3.22 > 3.2
+                  echo "PKG_VER_2DIGIT=${PKG_VER_2DIGIT}" >> $GITHUB_ENV
+
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  sudo apt -qq update
+                  sudo apt -qq install tree
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo " Runner .............. ${{ runner.name }}"
+                  echo " Workflow ............ ${{ github.workflow }} (#${{ github.workflow_ref }})"
+                  echo " Run Number .......... ${{ github.run_number }}"
+                  echo " Ref ................. ${{ github.ref }}"
+                  echo " Ref Name ............ ${{ github.ref_name }}"
+                  echo " Event Name .......... ${{ github.event_name }}"
+                  echo " Repo ................ ${{ github.repository }}"
+                  echo " Repo Owner .......... ${{ github.repository_owner }}"
+                  echo " Run ID .............. https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+                  echo " Triggered By ........ ${{ github.actor }}"
+                  echo " SHA 1 (GITHUB_SHA) .. ${GITHUB_SHA}"
+                  echo " SHA 2 (github.sha) .. ${{ github.sha }}"
+                  echo " SHA 3 (env.SHA1) .... ${SHA1}"
+                  echo " SHA 4 (env.SHA1_GH) . ${SHA1_GH}"
+                  echo " Workspace ........... ${{ github.workspace }}"
+                  echo " PWD ................. ${PWD}"
+                  echo " Job Name ............ ${{ steps.context.outputs.job_name }}"
+                  echo " Job ID .............. ${{ steps.context.outputs.job_id }}"
+                  echo " Job URL ............. ${{ steps.context.outputs.job_url }}"
+                  echo " Run ID .............. ${{ steps.context.outputs.run_id }}"
+                  echo " Run Attempt ......... ${{ steps.context.outputs.run_attempt }}"
+                  echo " Run Number .......... ${{ steps.context.outputs.run_number }}"
+                  echo " Run URL ............. ${{ steps.context.outputs.run_url }}"
+                  echo " Run Env ............. ${{ steps.context.outputs.environment }}"
+                  echo " Run Env URL ......... ${{ steps.context.outputs.environment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Deployment URL .. ${{ steps.context.outputs.deployment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Runner Name ..... ${{ steps.context.outputs.runner_name }}"
+                  echo " Run Runner ID ....... ${{ steps.context.outputs.runner_id }}"
+                  echo " Year ................ ${YEAR}"
+                  echo " Now ................. ${NOW}"
+                  echo " Now (Short) ......... ${NOW_SHORT}"
+                  echo " Now (Long) .......... ${NOW_LONG}"
+                  echo " Now (Docker) ........ ${NOW_DOCKER}"
+                  echo " Now (Docker TS) ..... ${NOW_DOCKER_TS}"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  tree -I node_modules -I .git
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+
+            # #
+            #   Deployments › Cleanup › Start
             # #
 
             - name: >-
                 ⚙️ Deployments › Clean
-              id: task_cleanup_start
               uses: Aetherinox/delete-deploy-env-action@v3
               with:
                   token: ${{ secrets.SELF_TOKEN_CL }}
@@ -191,33 +291,31 @@ jobs:
                   delay: "${{ env.DEPLOYMENT_DELAY }}"
 
             # #
-            #   Cleanup › Get Weekly Commits
+            #   Deployments › Cleanup › Get Weekly Commits
             # #
 
             - name: >-
                 🕛 Get Weekly Commit List
-              id: task_cleanup_set_weekly_commit_list
               run: |
                   echo 'WEEKLY_COMMITS<<EOF' >> $GITHUB_ENV
                   git log --format="[\`%h\`](${{ github.server_url }}/${{ github.repository }}/commit/%H) %s - %an" --since=7.days >> $GITHUB_ENV
                   echo 'EOF' >> $GITHUB_ENV
 
             # #
-            #   Cleanup › Notify Github › Success
+            #   Deployments › Cleanup › Notify Github › Success
             # #
 
             - name: >-
                 🔔 Send Discord Webhook Message (Success)
-              id: task_cleanup_notify_discord_success
               uses: tsickert/discord-webhook@v7.0.0
               if: success()
               with:
-                  username: 'Io'
+                  username: ${{ env.DISCORD_BOT_NAME }}
-                  avatar-url: 'https://i.imgur.com/8BVDkla.jpg'
+                  avatar-url: ${{ env.DISCORD_BOT_AVATAR }}
                   webhook-url: ${{ secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_WORKfLOWS }}
                   embed-title: "⚙️ ${{ github.workflow_ref }}"
                   embed-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-thumbnail-url: 'https://i.imgur.com/zDIzE8T.jpg'
+                  embed-thumbnail-url: ${{ env.DISCORD_BOT_EMBED_THUMBNAIL }}
                   embed-description: |
                       ## 📦 ᲼Deployment Cleanup ᲼${{ job.status == 'success' && '✅' || '❌' }}
 
@@ -236,24 +334,23 @@ jobs:
                   embed-timestamp: "${{ env.NOW_LONG }}"
                   embed-author-name: "${{ github.repository_owner }}"
                   embed-author-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-author-icon-url: "https://avatars.githubusercontent.com/u/200161462"
+                  embed-author-icon-url: ${{ env.DISCORD_BOT_EMBED_AUTHOR_ICON }}
 
             # #
-            #   Cleanup › Notify Github › Failure
+            #   Deployments › Cleanup › Notify Github › Failure
             # #
 
             - name: >-
                 🔔 Send Discord Webhook Message (Failure)
-              id: task_cleanup_notify_discord_failure
               uses: tsickert/discord-webhook@v7.0.0
               if: failure()
               with:
-                  username: 'Io'
+                  username: ${{ env.DISCORD_BOT_NAME }}
-                  avatar-url: 'https://i.imgur.com/8BVDkla.jpg'
+                  avatar-url: ${{ env.DISCORD_BOT_AVATAR }}
                   webhook-url: ${{ secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_WORKfLOWS }}
                   embed-title: "⚙️ ${{ github.workflow_ref }}"
                   embed-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-thumbnail-url: 'https://i.imgur.com/zDIzE8T.jpg'
+                  embed-thumbnail-url: ${{ env.DISCORD_BOT_EMBED_THUMBNAIL }}
                   embed-description: |
                       ## 📦 ᲼Deployment Cleanup ᲼${{ job.status == 'success' && '✅' || '❌' }}
 
@@ -272,5 +369,5 @@ jobs:
                   embed-timestamp: "${{ env.NOW_LONG }}"
                   embed-author-name: "${{ github.repository_owner }}"
                   embed-author-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-author-icon-url: "https://avatars.githubusercontent.com/u/200161462"
+                  embed-author-icon-url: ${{ env.DISCORD_BOT_EMBED_AUTHOR_ICON }}
 

.github/workflows/deploy-docker-dockerhub.yml

@@ -63,15 +63,18 @@ on:
                 type:           string
 
             # #
-            #   Image Version
+            #   Registry Name
             #
-            #   used to create new release tag, and add version to docker image name
+            #   options:
+            #       - github
+            #       - dockerhub
+            #       - gitea
             # #
 
-            IMAGE_VERSION:
+            IMAGE_REGISTRY:
-                description:    '🏷️ Image Version'
+                description:    '📘 Registry Name'
                 required:       true
-                default:        '1.0.0'
+                default:        'dockerhub'
                 type:           string
 
             # #
@@ -100,6 +103,18 @@ on:
                 default:        'thebinaryninja'
                 type:           string
 
+            # #
+            #   Alpine Version
+            #
+            #   specifies the alpine base docker image version
+            # #
+
+            IMAGE_ALPINE_VERSION:
+                description:    '📀 Alpine Version'
+                required:       true
+                default:        '3.22'
+                type:           string
+
             # #
             #   true            no changes to the repo will be made
             #   false           workflow will behave normally, and push any changes detected to the files
@@ -135,15 +150,20 @@ on:
 # #
 
 env:
-    IMAGE_NAME:                 ${{ github.event.inputs.IMAGE_NAME || 'tvapp2' }}
+    IMAGE_NAME:                       ${{ github.event.inputs.IMAGE_NAME || 'tvapp2' }}
-    IMAGE_VERSION:              ${{ github.event.inputs.IMAGE_VERSION || '1.0.0' }}
+    IMAGE_REGISTRY:                   ${{ github.event.inputs.IMAGE_REGISTRY || 'dockerhub' }}
-    IMAGE_DOCKERHUB_AUTHOR:     ${{ github.event.inputs.IMAGE_DOCKERHUB_AUTHOR || 'thebinaryninja' }}
+    IMAGE_DOCKERHUB_AUTHOR:           ${{ github.event.inputs.IMAGE_DOCKERHUB_AUTHOR || 'thebinaryninja' }}
-    IMAGE_DOCKERHUB_USERNAME:   ${{ github.event.inputs.IMAGE_DOCKERHUB_USERNAME || 'thebinaryninja' }}
+    IMAGE_DOCKERHUB_USERNAME:         ${{ github.event.inputs.IMAGE_DOCKERHUB_USERNAME || 'thebinaryninja' }}
+    IMAGE_ALPINE_VERSION:             ${{ github.event.inputs.IMAGE_ALPINE_VERSION || '3.22' }}
+    DISCORD_BOT_NAME:                 'Europa'
+    DISCORD_BOT_AVATAR:               'https://i.imgur.com/UqwMom1.jpeg'
+    DISCORD_BOT_EMBED_AUTHOR_ICON:    'https://avatars.githubusercontent.com/u/200161462'
+    DISCORD_BOT_EMBED_THUMBNAIL:      'https://avatars.githubusercontent.com/u/200161462'
 
-    BOT_NAME_1:                 EuropaServ
+    BOT_NAME_1:                       EuropaServ
-    BOT_NAME_2:                 BinaryServ
+    BOT_NAME_2:                       BinaryServ
-    BOT_NAME_DEPENDABOT:        dependabot[bot]
+    BOT_NAME_DEPENDABOT:              dependabot[bot]
-    BOT_NAME_RENOVATE:          renovate[bot]
+    BOT_NAME_RENOVATE:                renovate[bot]
 
 # #
 #   Jobs
@@ -162,9 +182,11 @@ jobs:
     job-docker-release-tags-create:
         name: >-
             📦 Release › Create Tag
-      # runs-on: ubuntu-latest
+        runs-on: ubuntu-latest
-        runs-on: apollo-x64
+      # runs-on: apollo-x64
         timeout-minutes: 4
+        outputs:
+            package_version: ${{ steps.task_initialize_package_getversion.outputs.PACKAGE_VERSION }}
         permissions:
             contents: write
             packages: write
@@ -172,25 +194,144 @@ jobs:
             id-token: write
         steps:
 
-            # #
-            #   Release › Tags › Start
-            # #
-
-            - name: '🏳️ Start'
-              id: task_release_tags_start
-              run: |
-                  echo "Creating Tag"
-
             # #
             #   Release › Tags › Checkout
             # #
 
-            - name: '✅ Checkout'
+            - name: '☑️ Checkout'
-              id: task_release_tags_checkout
               uses: actions/checkout@v4
               with:
                   fetch-depth: 0
 
+            # #
+            #   Release › Tags › Job Information
+            # #
+
+            - name: >-
+                  🔄 Load Job
+              uses: qoomon/actions--context@v4
+              id: 'context'
+
+            # #
+            #   Release › Tags › Set › Package.json › Version
+            # #
+
+            - name: '👁️‍🗨️ Package Version › Set'
+              id: task_initialize_package_getversion
+              working-directory: ./tvapp2
+              run: |
+                  VER=$(cat package.json | jq -r '.version')
+                  echo "PACKAGE_VERSION=${VER}" >> $GITHUB_OUTPUT
+                  echo "PACKAGE_VERSION=${VER}" >> $GITHUB_ENV
+
+            # #
+            #   Initialize › Get › Package.json › Version
+            # #
+
+            - name: '👁️‍🗨️ Package Version › Get'
+              run: |
+                  echo "VERSION: ${{ steps.task_initialize_package_getversion.outputs.PACKAGE_VERSION }}"
+
+            # #
+            #   Release › Tags › Start
+            # #
+
+            - name: >-
+                  ✅ Start
+              run: |
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo " Starting Job ${{ steps.context.outputs.job_name }}"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+
+                  YEAR="$(date +'%Y')"
+                  echo "YEAR=${YEAR}" >> $GITHUB_ENV
+
+                  NOW="$(date +'%m-%d-%Y %H:%M:%S')"                                                #  02-25-2025 12:49:48
+                  echo "NOW=${NOW}" >> $GITHUB_ENV
+
+                  NOW_SHORT="$(date +'%m-%d-%Y')"                                                   #  02-25-2025
+                  echo "NOW_SHORT=${NOW_SHORT}" >> $GITHUB_ENV
+
+                  NOW_LONG="$(date +'%m-%d-%Y %H:%M')"                                              #  02-25-2025 12:49
+                  echo "NOW_LONG=${NOW_LONG}" >> $GITHUB_ENV
+
+                  NOW_DOCKER="$(date +'%Y%m%d')"                                                    #  20250225
+                  echo "NOW_DOCKER=${NOW_DOCKER}" >> $GITHUB_ENV
+
+                  NOW_DOCKER_TS="$(date -u +'%FT%T.%3NZ')"                                          #  2025-02-25T12:50:11.569Z
+                  echo "NOW_DOCKER_TS=${NOW_DOCKER_TS}" >> $GITHUB_ENV
+
+                  SHA1="$(git rev-parse HEAD)"                                                      #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1=${SHA1}" >> $GITHUB_ENV
+
+                  SHA1_GH="$(echo ${GITHUB_SHA})"                                                   #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1_GH=${SHA1_GH}" >> $GITHUB_ENV
+
+                  PKG_VER_1DIGIT="$(echo ${{ env.PACKAGE_VERSION }} | cut -d '.' -f1-1)"            #  3.22 > 3
+                  echo "PKG_VER_1DIGIT=${PKG_VER_1DIGIT}" >> $GITHUB_ENV
+
+                  PKG_VER_2DIGIT="$(echo ${{ env.PACKAGE_VERSION }} | cut -f2 -d ":" | cut -c1-3)"  #  3.22 > 3.2
+                  echo "PKG_VER_2DIGIT=${PKG_VER_2DIGIT}" >> $GITHUB_ENV
+
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  sudo apt -qq update
+                  sudo apt -qq install tree
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo " Runner .............. ${{ runner.name }}"
+                  echo " Workflow ............ ${{ github.workflow }} (#${{ github.workflow_ref }})"
+                  echo " Run Number .......... ${{ github.run_number }}"
+                  echo " Ref ................. ${{ github.ref }}"
+                  echo " Ref Name ............ ${{ github.ref_name }}"
+                  echo " Event Name .......... ${{ github.event_name }}"
+                  echo " Repo ................ ${{ github.repository }}"
+                  echo " Repo Owner .......... ${{ github.repository_owner }}"
+                  echo " Run ID .............. https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+                  echo " Triggered By ........ ${{ github.actor }}"
+                  echo " SHA 1 (GITHUB_SHA) .. ${GITHUB_SHA}"
+                  echo " SHA 2 (env.SHA1) .. ${{ env.SHA1 }}"
+                  echo " SHA 3 (env.SHA1) .... ${SHA1}"
+                  echo " SHA 4 (env.SHA1_GH) . ${SHA1_GH}"
+                  echo " Workspace ........... ${{ github.workspace }}"
+                  echo " PWD ................. ${PWD}"
+                  echo " Job Name ............ ${{ steps.context.outputs.job_name }}"
+                  echo " Job ID .............. ${{ steps.context.outputs.job_id }}"
+                  echo " Job URL ............. ${{ steps.context.outputs.job_url }}"
+                  echo " Run ID .............. ${{ steps.context.outputs.run_id }}"
+                  echo " Run Attempt ......... ${{ steps.context.outputs.run_attempt }}"
+                  echo " Run Number .......... ${{ steps.context.outputs.run_number }}"
+                  echo " Run URL ............. ${{ steps.context.outputs.run_url }}"
+                  echo " Run Env ............. ${{ steps.context.outputs.environment }}"
+                  echo " Run Env URL ......... ${{ steps.context.outputs.environment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Deployment URL .. ${{ steps.context.outputs.deployment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Runner Name ..... ${{ steps.context.outputs.runner_name }}"
+                  echo " Run Runner ID ....... ${{ steps.context.outputs.runner_id }}"
+                  echo " Year ................ ${YEAR}"
+                  echo " Now ................. ${NOW}"
+                  echo " Now (Short) ......... ${NOW_SHORT}"
+                  echo " Now (Long) .......... ${NOW_LONG}"
+                  echo " Now (Docker) ........ ${NOW_DOCKER}"
+                  echo " Now (Docker TS) ..... ${NOW_DOCKER_TS}"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  tree -I node_modules -I .git
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+
             # #
             #   Release › Tags › Fix Permissions
             # #
@@ -220,9 +361,9 @@ jobs:
               id: task_release_tags_create
               if: ( github.event_name != 'workflow_dispatch' && inputs.DRY_RUN == false )
               with:
-                  tag: "${{ env.IMAGE_VERSION }}"
+                  tag: "${{ env.PACKAGE_VERSION }}"
                   tag_exists_error: false
-                  message: '${{ env.IMAGE_NAME }}-${{ env.IMAGE_VERSION }}'
+                  message: '${{ env.IMAGE_NAME }}-${{ env.PACKAGE_VERSION }}'
                   gpg_private_key: ${{ secrets.ADMINSERV_GPG_KEY_ASC }}
                   gpg_passphrase: ${{ secrets.ADMINSERV_GPG_PASSPHRASE }}
 
@@ -233,60 +374,152 @@ jobs:
     job-docker-release-dockerhub:
         name: >-
           📦 Release › Dockerhub
-      # runs-on: ubuntu-latest
+        runs-on: ubuntu-latest
-        runs-on: apollo-x64
+      # runs-on: apollo-x64
         timeout-minutes: 10
+        needs: [ job-docker-release-tags-create ]
         permissions:
             contents: write
             packages: write
             attestations: write
             id-token: write
-        needs: [ job-docker-release-tags-create ]
+        env:
+            PACKAGE_VERSION: ${{ needs.job-docker-release-tags-create.outputs.package_version }}
         steps:
 
             # #
-            #   Release › Dockerhub › Start › Amd64
+            #   Release › Dockerhub › Checkout
             # #
 
-            - name: '🏳️ Start'
+            - name: '☑️ Checkout'
-              id: task_release_dh_start
-              run: |
-                  echo "Starting Dockerhub docker release"
-
-            # #
-            #   Release › Dockerhub › Checkout › Amd64
-            # #
-
-            - name: '✅ Checkout'
-              id: task_release_gh_checkout
               uses: actions/checkout@v4
               with:
                   fetch-depth: 0
 
             # #
-            #   Release › Dockerhub › Get Timestamp
+            #   Release › Dockerhub › Job Information
             # #
 
-            - name: '🕛 Get Timestamp'
+            - name: >-
+                  🔄 Load Job
+              uses: qoomon/actions--context@v4
+              id: 'context'
+
+            # #
+            #   Release › Dockerhub › Start
+            # #
+
+            - name: >-
+                  ✅ Start
+              run: |
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo " Starting Job ${{ steps.context.outputs.job_name }}"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+
+                  YEAR="$(date +'%Y')"
+                  echo "YEAR=${YEAR}" >> $GITHUB_ENV
+
+                  NOW="$(date +'%m-%d-%Y %H:%M:%S')"                                                #  02-25-2025 12:49:48
+                  echo "NOW=${NOW}" >> $GITHUB_ENV
+
+                  NOW_SHORT="$(date +'%m-%d-%Y')"                                                   #  02-25-2025
+                  echo "NOW_SHORT=${NOW_SHORT}" >> $GITHUB_ENV
+
+                  NOW_LONG="$(date +'%m-%d-%Y %H:%M')"                                              #  02-25-2025 12:49
+                  echo "NOW_LONG=${NOW_LONG}" >> $GITHUB_ENV
+
+                  NOW_DOCKER="$(date +'%Y%m%d')"                                                    #  20250225
+                  echo "NOW_DOCKER=${NOW_DOCKER}" >> $GITHUB_ENV
+
+                  NOW_DOCKER_TS="$(date -u +'%FT%T.%3NZ')"                                          #  2025-02-25T12:50:11.569Z
+                  echo "NOW_DOCKER_TS=${NOW_DOCKER_TS}" >> $GITHUB_ENV
+
+                  SHA1="$(git rev-parse HEAD)"                                                      #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1=${SHA1}" >> $GITHUB_ENV
+
+                  SHA1_GH="$(echo ${GITHUB_SHA})"                                                   #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1_GH=${SHA1_GH}" >> $GITHUB_ENV
+
+                  PKG_VER_1DIGIT="$(echo ${{ env.PACKAGE_VERSION }} | cut -d '.' -f1-1)"            #  3.22 > 3
+                  echo "PKG_VER_1DIGIT=${PKG_VER_1DIGIT}" >> $GITHUB_ENV
+
+                  PKG_VER_2DIGIT="$(echo ${{ env.PACKAGE_VERSION }} | cut -f2 -d ":" | cut -c1-3)"  #  3.22 > 3.2
+                  echo "PKG_VER_2DIGIT=${PKG_VER_2DIGIT}" >> $GITHUB_ENV
+
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  sudo apt -qq update
+                  sudo apt -qq install tree
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo " Runner .............. ${{ runner.name }}"
+                  echo " Workflow ............ ${{ github.workflow }} (#${{ github.workflow_ref }})"
+                  echo " Run Number .......... ${{ github.run_number }}"
+                  echo " Ref ................. ${{ github.ref }}"
+                  echo " Ref Name ............ ${{ github.ref_name }}"
+                  echo " Event Name .......... ${{ github.event_name }}"
+                  echo " Repo ................ ${{ github.repository }}"
+                  echo " Repo Owner .......... ${{ github.repository_owner }}"
+                  echo " Run ID .............. https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+                  echo " Triggered By ........ ${{ github.actor }}"
+                  echo " SHA 1 (GITHUB_SHA) .. ${GITHUB_SHA}"
+                  echo " SHA 2 (env.SHA1) .. ${{ env.SHA1 }}"
+                  echo " SHA 3 (env.SHA1) .... ${SHA1}"
+                  echo " SHA 4 (env.SHA1_GH) . ${SHA1_GH}"
+                  echo " Workspace ........... ${{ github.workspace }}"
+                  echo " PWD ................. ${PWD}"
+                  echo " Job Name ............ ${{ steps.context.outputs.job_name }}"
+                  echo " Job ID .............. ${{ steps.context.outputs.job_id }}"
+                  echo " Job URL ............. ${{ steps.context.outputs.job_url }}"
+                  echo " Run ID .............. ${{ steps.context.outputs.run_id }}"
+                  echo " Run Attempt ......... ${{ steps.context.outputs.run_attempt }}"
+                  echo " Run Number .......... ${{ steps.context.outputs.run_number }}"
+                  echo " Run URL ............. ${{ steps.context.outputs.run_url }}"
+                  echo " Run Env ............. ${{ steps.context.outputs.environment }}"
+                  echo " Run Env URL ......... ${{ steps.context.outputs.environment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Deployment URL .. ${{ steps.context.outputs.deployment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Runner Name ..... ${{ steps.context.outputs.runner_name }}"
+                  echo " Run Runner ID ....... ${{ steps.context.outputs.runner_id }}"
+                  echo " Year ................ ${YEAR}"
+                  echo " Now ................. ${NOW}"
+                  echo " Now (Short) ......... ${NOW_SHORT}"
+                  echo " Now (Long) .......... ${NOW_LONG}"
+                  echo " Now (Docker) ........ ${NOW_DOCKER}"
+                  echo " Now (Docker TS) ..... ${NOW_DOCKER_TS}"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  tree -I node_modules -I .git
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+
+            # #
+            #   Release › Dockerhub › Set Vars
+            # #
+
+            - name: '🕛 Set Vars'
               id: task_release_set_timestamp
               run: |
-                  echo "IMAGE_VERSION_1DIGIT=`echo ${{ env.IMAGE_VERSION }} | cut -d '.' -f1-1`" >> ${GITHUB_ENV}                                                   #  1
-                  echo "IMAGE_VERSION_2DIGIT=`echo ${{ env.IMAGE_VERSION }} | cut -d '.' -f1-2`" >> ${GITHUB_ENV}                                                   #  1.0
                   echo "REGISTRY_REPO_ORG_AUTHOR_LC=`echo ${{ env.IMAGE_DOCKERHUB_AUTHOR }}/${{ env.IMAGE_NAME }} | tr '[:upper:]' '[:lower:]'`" >> ${GITHUB_ENV}   #  thebinaryninja/tvapp2
                   echo "REGISTRY_REPO_AUTHOR_LC=`echo ${{ env.IMAGE_DOCKERHUB_AUTHOR }} | tr '[:upper:]' '[:lower:]'`" >> ${GITHUB_ENV}                             #  thebinaryninja
-                  echo "DOCKER_SHA=${GITHUB_SHA}" >> $GITHUB_ENV                                                                                                    #  71fad013cfce9116ec62779e4a7e627fe4c33627
-                  echo "NOW=$(date +'%m-%d-%Y %H:%M:%S')" >> $GITHUB_ENV                                                                                            #  02-25-2025 12:49:48
-                  echo "NOW_SHORT=$(date +'%m-%d-%Y')" >> $GITHUB_ENV                                                                                               #  02-25-2025
-                  echo "NOW_LONG=$(date +'%m-%d-%Y %H:%M')" >> $GITHUB_ENV                                                                                          #  02-25-2025 12:49
-                  echo "NOW_DOCKER_LABEL=$(date +'%Y%m%d')" >> $GITHUB_ENV                                                                                          #  20250225
-                  echo "NOW_DOCKER_TS=$(date -u +'%FT%T.%3NZ')" >> $GITHUB_ENV                                                                                      #  2025-02-25T12:50:11.569Z
 
             # #
             #   Release › Dockerhub › Install Dependencies
             # #
 
             - name: '📦 Install Dependencies'
-              id: task_release_dh_dependencies
               run:
                   sudo apt-get install -qq dos2unix
 
@@ -295,7 +528,6 @@ jobs:
             # #
 
             - name: '🔐 Apply dos2unix'
-              id: task_release_dh_dos2unix
               run: |
                   echo "⚠️⚠️⚠️ Running DOS2UNIX ⚠️⚠️⚠️"
                   find ./ \( -path "./.git" -o -path "./docs" -o -path "./.github" -o -path "*.png" -o -path "*.jpg" \) -prune -o -name '*' -print | xargs dos2unix --
@@ -306,7 +538,6 @@ jobs:
             # #
 
             - name: '#️⃣ Manage Permissions'
-              id: task_release_dh_permissions
               run: |
                   find ./ -name 'run' -exec chmod 755 {} \;
                   WRONG_PERM=$(find ./  -path "./.git" -prune -o \( -name "run" -o -name "finish" -o -name "check" \) -not -perm -u=x,g=x,o=x -print)
@@ -396,13 +627,13 @@ jobs:
                       type=ref,enable=${{ github.event_name == 'pull_request' || github.event_name == 'push' }},priority=600,prefix=,suffix=,event=tag
 
                       #  tag            add 1.0.0             ( dispatch only + no dev )
-                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=450,prefix=,suffix=,value=${{ env.IMAGE_VERSION }}
+                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=450,prefix=,suffix=,value=${{ env.PACKAGE_VERSION }}
 
                       #  tag            add 1.0               ( dispatch only + no dev )
-                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=425,prefix=,suffix=,value=${{ env.IMAGE_VERSION_2DIGIT }}
+                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=425,prefix=,suffix=,value=${{ env.PKG_VER_2DIGIT }}
 
                       #  tag            add 1                 ( dispatch only + no dev )
-                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=400,prefix=,suffix=,value=${{ env.IMAGE_VERSION_1DIGIT }}
+                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=400,prefix=,suffix=,value=${{ env.PKG_VER_1DIGIT }}
 
                       #  tag            add development       ( dispatch only + only dev )
                       type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == true }},priority=300,prefix=,suffix=,value=development
@@ -412,25 +643,33 @@ jobs:
                   flavor: |
                       latest=false
                   labels: |
+                      org.opencontainers.image.description=TVApp2
                       org.opencontainers.image.created=${{ env.NOW_DOCKER_TS }}
-                      org.opencontainers.image.version=${{ env.IMAGE_VERSION }}
+                      org.opencontainers.image.version=${{ env.PACKAGE_VERSION }}
                       org.opencontainers.image.licenses=MIT
-                      org.opencontainers.image.revision=${{ github.sha }}
+                      org.opencontainers.image.revision=${{ env.SHA1 }}
                       org.opencontainers.image.vendor=${{ env.REGISTRY_REPO_AUTHOR_LC }}
                       org.opencontainers.image.ref.name=${{ github.ref_name }}
                       org.opencontainers.image.development=${{ inputs.DEV_RELEASE == true && 'true' || 'false' }}
-                      org.opencontainers.image.registry=dockerhub
+                      org.opencontainers.image.registry=${{ env.IMAGE_REGISTRY }}
-                      org.tvapp2.image.build-version="Version:- ${{ env.IMAGE_VERSION }} Date:- ${{ env.NOW_DOCKER_LABEL }}"
+                      org.tvapp2.image.build-version="Version: ${{ env.PACKAGE_VERSION }} Date: ${{ env.NOW_DOCKER }}"
-                  annotations: |
+                      org.tvapp2.image.build-version-alpine=${{ env.IMAGE_ALPINE_VERSION }}
+                      org.tvapp2.image.build-release="${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}"
+                      org.tvapp2.image.build-sha1=${{ env.SHA1 }}
+                  annotations: |-
+                      org.opencontainers.image.description=TVApp2
                       org.opencontainers.image.created=${{ env.NOW_DOCKER_TS }}
-                      org.opencontainers.image.version=${{ env.IMAGE_VERSION }}
+                      org.opencontainers.image.version=${{ env.PACKAGE_VERSION }}
                       org.opencontainers.image.licenses=MIT
-                      org.opencontainers.image.revision=${{ github.sha }}
+                      org.opencontainers.image.revision=${{ env.SHA1 }}
                       org.opencontainers.image.vendor=${{ env.REGISTRY_REPO_AUTHOR_LC }}
                       org.opencontainers.image.ref.name=${{ github.ref_name }}
                       org.opencontainers.image.development=${{ inputs.DEV_RELEASE == true && 'true' || 'false' }}
-                      org.opencontainers.image.registry=dockerhub
+                      org.opencontainers.image.registry=${{ env.IMAGE_REGISTRY }}
-                      org.tvapp2.image.build-version="Version:- ${{ env.IMAGE_VERSION }} Date:- ${{ env.NOW_DOCKER_LABEL }}"
+                      org.tvapp2.image.build-version="Version: ${{ env.PACKAGE_VERSION }} Date: ${{ env.NOW_DOCKER }}"
+                      org.tvapp2.image.build-version-alpine=${{ env.IMAGE_ALPINE_VERSION }}
+                      org.tvapp2.image.build-release="${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}"
+                      org.tvapp2.image.build-sha1=${{ env.SHA1 }}
 
             # #
             #   Release › Dockerhub › Build and Push › Amd64
@@ -441,20 +680,41 @@ jobs:
               uses: docker/build-push-action@v6
               if: ( github.event_name == 'workflow_dispatch' && inputs.DRY_RUN == false ) || ( github.event_name == 'push' )
               with:
+                  allow: |
+                      network.host
+                  network: host
                   context: .
                   file: Dockerfile
                   platforms: linux/amd64
                   push: ${{ github.event_name != 'pull_request' }}
                   labels: ${{ steps.task_release_dh_meta.outputs.labels }}
-                  tags: |
-                      ${{ steps.task_release_dh_meta.outputs.tags }}
                   provenance: false
                   sbom: false
+                  tags: |
+                      ${{ steps.task_release_dh_meta.outputs.tags }}
                   build-args: |-
                       ARCH=amd64
                       RELEASE=${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}
-                      VERSION=${{ env.IMAGE_VERSION }}
+                      VERSION=${{ env.PACKAGE_VERSION }}
-                      BUILDDATE=${{ env.NOW_DOCKER_LABEL }}
+                      BUILDDATE=${{ env.NOW_DOCKER }}
+                      GIT_SHA1=${{ env.SHA1 }}
+                      ALPINE_VERSION=${{ env.IMAGE_ALPINE_VERSION }}
+                  annotations: |-
+                      org.opencontainers.image.description=TVApp2
+                      org.opencontainers.image.created=${{ env.NOW_DOCKER_TS }}
+                      org.opencontainers.image.version=${{ env.PACKAGE_VERSION }}
+                      org.opencontainers.image.licenses=MIT
+                      org.opencontainers.image.architecture=amd64
+                      org.opencontainers.image.revision=${{ env.SHA1 }}
+                      org.opencontainers.image.vendor=${{ env.REGISTRY_REPO_AUTHOR_LC }}
+                      org.opencontainers.image.ref.name=${{ github.ref_name }}
+                      org.opencontainers.image.development=${{ inputs.DEV_RELEASE == true && 'true' || 'false' }}
+                      org.opencontainers.image.registry=${{ env.IMAGE_REGISTRY }}
+                      org.tvapp2.image.build-version="Version: ${{ env.PACKAGE_VERSION }} Date: ${{ env.NOW_DOCKER }}"
+                      org.tvapp2.image.build-version-alpine=${{ env.IMAGE_ALPINE_VERSION }}
+                      org.tvapp2.image.build-architecture=amd64
+                      org.tvapp2.image.build-release="${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}"
+                      org.tvapp2.image.build-sha1=${{ env.SHA1 }}
 
             # #
             #   Release › Dockerhub › Export Digest › Amd64
@@ -493,20 +753,41 @@ jobs:
               uses: docker/build-push-action@v6
               if: ( github.event_name == 'workflow_dispatch' && inputs.DRY_RUN == false ) || ( github.event_name == 'push' )
               with:
+                  allow: |
+                      network.host
+                  network: host
                   context: .
                   file: Dockerfile
                   platforms: linux/arm64
                   push: ${{ github.event_name != 'pull_request' }}
                   labels: ${{ steps.task_release_dh_meta.outputs.labels }}
-                  tags: |
-                      ${{ steps.task_release_dh_meta.outputs.tags }}
                   provenance: false
                   sbom: false
+                  tags: |
+                      ${{ steps.task_release_dh_meta.outputs.tags }}
                   build-args: |-
                       ARCH=arm64
                       RELEASE=${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}
-                      VERSION=${{ env.IMAGE_VERSION }}
+                      VERSION=${{ env.PACKAGE_VERSION }}
-                      BUILDDATE=${{ env.NOW_DOCKER_LABEL }}
+                      BUILDDATE=${{ env.NOW_DOCKER }}
+                      GIT_SHA1=${{ env.SHA1 }}
+                      ALPINE_VERSION=${{ env.IMAGE_ALPINE_VERSION }}
+                  annotations: |-
+                      org.opencontainers.image.description=TVApp2
+                      org.opencontainers.image.created=${{ env.NOW_DOCKER_TS }}
+                      org.opencontainers.image.version=${{ env.PACKAGE_VERSION }}
+                      org.opencontainers.image.licenses=MIT
+                      org.opencontainers.image.architecture=arm64
+                      org.opencontainers.image.revision=${{ env.SHA1 }}
+                      org.opencontainers.image.vendor=${{ env.REGISTRY_REPO_AUTHOR_LC }}
+                      org.opencontainers.image.ref.name=${{ github.ref_name }}
+                      org.opencontainers.image.development=${{ inputs.DEV_RELEASE == true && 'true' || 'false' }}
+                      org.opencontainers.image.registry=${{ env.IMAGE_REGISTRY }}
+                      org.tvapp2.image.build-version="Version: ${{ env.PACKAGE_VERSION }} Date: ${{ env.NOW_DOCKER }}"
+                      org.tvapp2.image.build-version-alpine=${{ env.IMAGE_ALPINE_VERSION }}
+                      org.tvapp2.image.build-architecture=arm64
+                      org.tvapp2.image.build-release="${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}"
+                      org.tvapp2.image.build-sha1=${{ env.SHA1 }}
 
             # #
             #   Release › Dockerhub › Export Digest › Arm64
@@ -536,6 +817,64 @@ jobs:
                   if-no-files-found: error
                   retention-days: 10
 
+            # #
+            #   Release › Dockerhub › Checkpoint › Amd64
+            # #
+
+            - name: '⚠️ Checkpoint'
+              run: |
+                  echo "‎"
+                  echo "---- [ GITHUB ] ----------------------------------------------------------------------------------------"
+                  echo "github.actor.............................. ${{ github.actor }}"
+                  echo "github.ref ............................... ${{ github.ref }}"
+                  echo "github.ref_name .......................... ${{ github.ref_name }}"
+                  echo "github.event_name ........................ ${{ github.event_name }}"
+                  echo "github.repository_owner .................. ${{ github.repository_owner }}"
+                  echo "github.repository ........................ ${{ github.repository }}"
+                  echo "github.sha ............................... ${{ github.sha }}"
+                  echo "‎"
+                  echo "---- [ INPUTS ] ----------------------------------------------------------------------------------------"
+                  echo "inputs.IMAGE_NAME ........................ ${{ inputs.IMAGE_NAME }}"
+                  echo "inputs.IMAGE_DOCKERHUB_AUTHOR ............ ${{ inputs.IMAGE_DOCKERHUB_AUTHOR }}"
+                  echo "inputs.IMAGE_DOCKERHUB_USERNAME .......... ${{ inputs.IMAGE_DOCKERHUB_USERNAME }}"
+                  echo "inputs.DEV_RELEASE ....................... ${{ inputs.DEV_RELEASE }}"
+                  echo "inputs.DRY_RUN ........................... ${{ inputs.DRY_RUN }}"
+                  echo "‎"
+                  echo "---- [ ENV ] -------------------------------------------------------------------------------------------"
+                  echo "env.IMAGE_NAME ........................... ${{ env.IMAGE_NAME }}"
+                  echo "env.PACKAGE_VERSION ...................... ${{ env.PACKAGE_VERSION }}"
+                  echo "env.PKG_VER_1DIGIT ....................... ${{ env.PKG_VER_1DIGIT }}"
+                  echo "env.PKG_VER_2DIGIT ....................... ${{ env.PKG_VER_2DIGIT }}"
+                  echo "env.IMAGE_DOCKERHUB_AUTHOR ............... ${{ env.IMAGE_DOCKERHUB_AUTHOR }}"
+                  echo "env.IMAGE_DOCKERHUB_USERNAME ............. ${{ env.IMAGE_DOCKERHUB_USERNAME }}"
+                  echo "env.NOW .................................. ${{ env.NOW }}"
+                  echo "env.NOW_SHORT ............................ ${{ env.NOW_SHORT }}"
+                  echo "env.NOW_LONG ............................. ${{ env.NOW_LONG }}"
+                  echo "env.NOW_DOCKER ........................... ${{ env.NOW_DOCKER }}"
+                  echo "env.NOW_DOCKER_TS ........................ ${{ env.NOW_DOCKER_TS }}"
+                  echo "env.REGISTRY_REPO_ORG_AUTHOR_LC .......... ${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}"
+                  echo "env.REGISTRY_REPO_AUTHOR_LC .............. ${{ env.REGISTRY_REPO_AUTHOR_LC }}"
+                  echo " SHA 1 (GITHUB_SHA) ...................... ${GITHUB_SHA}"
+                  echo " SHA 2 (github.sha) ...................... ${{ github.sha }}"
+                  echo " SHA 3 (env.SHA1) ........................ ${{ env.SHA1 }}"
+                  echo " SHA 4 (env.SHA1_GH) ..................... ${{ env.SHA1_GH }}"
+                  echo "‎"
+                  echo "---- [ DOCKER IMAGES ] ---------------------------------------------------------------------------------"
+                  echo "registry ................................. Dockerhub"
+                  echo "tags ..................................... ${{ steps.task_release_dh_meta.outputs.tags }}"
+                  echo "labels ................................... ${{ steps.task_release_dh_meta.outputs.labels }}"
+                  echo "digest ................................... ${{ steps.task_release_dh_push_amd64.outputs.digest }}"
+                  echo "‎"
+                  echo "(release) tags ........................... ${{ steps.task_release_dh_meta.outputs.tags }}"
+                  echo "(release) labels ......................... ${{ steps.task_release_dh_meta.outputs.labels }}"
+                  echo "‎"
+                  echo "---- [ DOCKER DIGESTS ] --------------------------------------------------------------------------------"
+                  echo "docker image id (amd64) .................. ${{ steps.task_release_dh_push_amd64.outputs.imageid }}"
+                  echo "docker digest (amd64) .................... ${{ steps.task_release_dh_push_amd64.outputs.digest }}"
+                  echo "docker image id (arm64) .................. ${{ steps.task_release_dh_push_arm64.outputs.imageid }}"
+                  echo "docker digest (arm64) .................... ${{ steps.task_release_dh_push_arm64.outputs.digest }}"
+                  echo "‎"
+
             # #
             #   Release › Dockerhub › Push Manifest
             # #
@@ -552,67 +891,11 @@ jobs:
                 index-annotations: |
                     ${{ steps.task_release_dh_meta.outputs.labels }}
 
-            # #
-            #   Release › Dockerhub › Checkpoint › Amd64
-            # #
-
-            - name: '⚠️ Checkpoint'
-              id: task_release_dh_checkpoint
-              run: |
-                  echo ""
-                  echo "[ GITHUB ] ---------------------------------------------------------------------------------------------"
-                  echo "github.actor.............................. ${{ github.actor }}"
-                  echo "github.ref ............................... ${{ github.ref }}"
-                  echo "github.ref_name .......................... ${{ github.ref_name }}"
-                  echo "github.event_name ........................ ${{ github.event_name }}"
-                  echo "github.repository_owner .................. ${{ github.repository_owner }}"
-                  echo "github.repository ........................ ${{ github.repository }}"
-                  echo ""
-                  echo "[ INPUTS ] ---------------------------------------------------------------------------------------------"
-                  echo "inputs.IMAGE_NAME ........................ ${{ inputs.IMAGE_NAME }}"
-                  echo "inputs.IMAGE_VERSION ..................... ${{ inputs.IMAGE_VERSION }}"
-                  echo "inputs.IMAGE_DOCKERHUB_AUTHOR ............ ${{ inputs.IMAGE_DOCKERHUB_AUTHOR }}"
-                  echo "inputs.IMAGE_DOCKERHUB_USERNAME .......... ${{ inputs.IMAGE_DOCKERHUB_USERNAME }}"
-                  echo "inputs.DEV_RELEASE ....................... ${{ inputs.DEV_RELEASE }}"
-                  echo "inputs.DRY_RUN ........................... ${{ inputs.DRY_RUN }}"
-                  echo ""
-                  echo "[ ENV ] ------------------------------------------------------------------------------------------------"
-                  echo "env.IMAGE_NAME ........................... ${{ env.IMAGE_NAME }}"
-                  echo "env.IMAGE_VERSION ........................ ${{ env.IMAGE_VERSION }}"
-                  echo "env.IMAGE_VERSION_1DIGIT ................. ${{ env.IMAGE_VERSION_1DIGIT }}"
-                  echo "env.IMAGE_VERSION_2DIGIT ................. ${{ env.IMAGE_VERSION_2DIGIT }}"
-                  echo "env.IMAGE_DOCKERHUB_AUTHOR ............... ${{ env.IMAGE_DOCKERHUB_AUTHOR }}"
-                  echo "env.IMAGE_DOCKERHUB_USERNAME ............. ${{ env.IMAGE_DOCKERHUB_USERNAME }}"
-                  echo "env.NOW .................................. ${{ env.NOW }}"
-                  echo "env.NOW_SHORT ............................ ${{ env.NOW_SHORT }}"
-                  echo "env.NOW_LONG ............................. ${{ env.NOW_LONG }}"
-                  echo "env.NOW_DOCKER_LABEL ..................... ${{ env.NOW_DOCKER_LABEL }}"
-                  echo "env.NOW_DOCKER_TS ........................ ${{ env.NOW_DOCKER_TS }}"
-                  echo "env.REGISTRY_REPO_ORG_AUTHOR_LC .......... ${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}"
-                  echo "env.REGISTRY_REPO_AUTHOR_LC .............. ${{ env.REGISTRY_REPO_AUTHOR_LC }}"
-                  echo "env.DOCKER_SHA ........................... ${{ env.DOCKER_SHA }}"
-                  echo ""
-                  echo "[ DOCKER IMAGES ] --------------------------------------------------------------------------------------"
-                  echo "registry ................................. Dockerhub"
-                  echo "tags ..................................... ${{ steps.task_release_dh_meta.outputs.tags }}"
-                  echo "labels ................................... ${{ steps.task_release_dh_meta.outputs.labels }}"
-                  echo "digest ................................... ${{ steps.task_release_dh_push_amd64.outputs.digest }}"
-                  echo ""
-                  echo "(release) tags ........................... ${{ steps.task_release_dh_meta.outputs.tags }}"
-                  echo "(release) labels ......................... ${{ steps.task_release_dh_meta.outputs.labels }}"
-                  echo ""
-                  echo "[ DOCKER DIGESTS ] -------------------------------------------------------------------------------------"
-                  echo "docker image id (amd64) .................. ${{ steps.task_release_dh_push_amd64.outputs.imageid }}"
-                  echo "docker digest (amd64) .................... ${{ steps.task_release_dh_push_amd64.outputs.digest }}"
-                  echo "docker image id (arm64) .................. ${{ steps.task_release_dh_push_arm64.outputs.imageid }}"
-                  echo "docker digest (arm64) .................... ${{ steps.task_release_dh_push_arm64.outputs.digest }}"
-
             # #
             #   Release › Dockerhub › Get Weekly Commits
             # #
 
             - name: '🕛 Get Weekly Commit List'
-              id: task_release_set_weekly_commit_list
               run: |
                   echo 'WEEKLY_COMMITS<<EOF' >> $GITHUB_ENV
                   git log --format="[\`%h\`](${{ github.server_url }}/${{ github.repository }}/commit/%H) %s - %an" --since=7.days >> $GITHUB_ENV
@@ -626,27 +909,27 @@ jobs:
               uses: tsickert/discord-webhook@v7.0.0
               if: success()
               with:
-                  username: 'Io'
+                  username: ${{ env.DISCORD_BOT_NAME }}
-                  avatar-url: 'https://i.imgur.com/8BVDkla.jpg'
+                  avatar-url: ${{ env.DISCORD_BOT_AVATAR }}
                   webhook-url: ${{ secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_RELEASES }}
                   embed-title: "⚙️ ${{ github.workflow_ref }}"
                   embed-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-thumbnail-url: 'https://i.imgur.com/zDIzE8T.jpg'
+                  embed-thumbnail-url: ${{ env.DISCORD_BOT_EMBED_THUMBNAIL }}
                   embed-description: |
-                      ### 📦 ᲼Deploy (Dockerhub) ᲼${{ job.status == 'success' && '✅' || '❌' }}᲼ › `${{ env.IMAGE_NAME }}-${{ env.IMAGE_VERSION }}${{ inputs.DEV_RELEASE == true && '-development' || '' }}`
+                      ### 📦 ᲼Deploy (Dockerhub) ᲼${{ job.status == 'success' && '✅' || '❌' }}᲼ › `${{ env.IMAGE_NAME }}-${{ env.PACKAGE_VERSION }}${{ inputs.DEV_RELEASE == true && '-development' || '' }}`
                       ${{ inputs.DEV_RELEASE == true && '### ⚠️⚠️ Development / Pre-release ⚠️⚠️' || '' }}
 
                       A new version of the docker container `${{ env.IMAGE_NAME }}` has been released from Github to Dockerhub. The image is available at:
                       - https://hub.docker.com/r/${{ env.IMAGE_DOCKERHUB_USERNAME }}/${{ env.IMAGE_NAME }}
 
-                      - Version: `${{ env.IMAGE_VERSION }}`
+                      - Version: `${{ env.PACKAGE_VERSION }}`
                       - Release Type: `${{ inputs.DEV_RELEASE == true && '⚠️⚠️ Development / Pre-release ⚠️⚠️' || 'Stable' }}`
-                      - Pull: `docker pull ${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}:${{ inputs.DEV_RELEASE == true && 'development' || env.IMAGE_VERSION }}`
+                      - Pull: `docker pull ${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}:${{ inputs.DEV_RELEASE == true && 'development' || env.PACKAGE_VERSION }}`
                       - Pull (amd64): `docker pull ${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}@${{ steps.task_release_dh_push_amd64.outputs.digest }}`
                       - Pull (arm64): `docker pull ${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}@${{ steps.task_release_dh_push_arm64.outputs.digest }}`
                       - Dry Run: `${{ inputs.DRY_RUN }}`
                       - Source: `Dockerhub` https://hub.docker.com/r/${{ env.IMAGE_DOCKERHUB_USERNAME }}/${{ env.IMAGE_NAME }}
-                      - Docker Image: `${{ env.IMAGE_NAME }}-${{ env.IMAGE_VERSION }}${{ inputs.DEV_RELEASE == true && '-development' || '' }}`
+                      - Docker Image: `${{ env.IMAGE_NAME }}-${{ env.PACKAGE_VERSION }}${{ inputs.DEV_RELEASE == true && '-development' || '' }}`
                       - Branch: `${{ github.ref_name }}`
                       - Workflow: `${{ github.workflow }} (#${{github.run_number}})`
                       - Runner: `${{ runner.name }}`
@@ -671,4 +954,4 @@ jobs:
                   embed-timestamp: "${{ env.NOW_LONG }}"
                   embed-author-name: "${{ github.repository_owner }}"
                   embed-author-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-author-icon-url: "https://avatars.githubusercontent.com/u/200161462"
+                  embed-author-icon-url: ${{ env.DISCORD_BOT_EMBED_AUTHOR_ICON }}

.github/workflows/deploy-docker-gitea.yml

@@ -63,15 +63,18 @@ on:
                 type:           string
 
             # #
-            #   Image Version
+            #   Registry Name
             #
-            #   used to create new release tag, and add version to docker image name
+            #   options:
+            #       - github
+            #       - dockerhub
+            #       - gitea
             # #
 
-            IMAGE_VERSION:
+            IMAGE_REGISTRY:
-                description:    '🏷️ Image Version'
+                description:    '📘 Registry Name'
                 required:       true
-                default:        '1.0.0'
+                default:        'gitea'
                 type:           string
 
             # #
@@ -106,10 +109,22 @@ on:
             # #
 
             IMAGE_GITEA_WEBSITE:
-              description:      '🌎 Gitea Website'
+                description:    '🌎 Gitea Website'
-              required:         true
+                required:       true
-              default:          'git.binaryninja.net'
+                default:        'git.binaryninja.net'
-              type:             string
+                type:           string
+
+            # #
+            #   Alpine Version
+            #
+            #   specifies the alpine base docker image version
+            # #
+
+            IMAGE_ALPINE_VERSION:
+                description:    '📀 Alpine Version'
+                required:       true
+                default:        '3.22'
+                type:           string
 
             # #
             #   true            no changes to the repo will be made
@@ -146,16 +161,21 @@ on:
 # #
 
 env:
-    IMAGE_NAME:                 ${{ github.event.inputs.IMAGE_NAME || 'tvapp2' }}
+    IMAGE_NAME:                       ${{ github.event.inputs.IMAGE_NAME || 'tvapp2' }}
-    IMAGE_VERSION:              ${{ github.event.inputs.IMAGE_VERSION || '1.0.0' }}
+    IMAGE_REGISTRY:                   ${{ github.event.inputs.IMAGE_REGISTRY || 'gitea' }}
-    IMAGE_GITEA_AUTHOR:         ${{ github.event.inputs.IMAGE_GITEA_AUTHOR || 'BinaryNinja' }}
+    IMAGE_GITEA_AUTHOR:               ${{ github.event.inputs.IMAGE_GITEA_AUTHOR || 'BinaryNinja' }}
-    IMAGE_GITEA_USERNAME:       ${{ github.event.inputs.IMAGE_GITEA_USERNAME || 'BinaryNinja' }}
+    IMAGE_GITEA_USERNAME:             ${{ github.event.inputs.IMAGE_GITEA_USERNAME || 'BinaryNinja' }}
-    IMAGE_GITEA_WEBSITE:        ${{ github.event.inputs.IMAGE_GITEA_WEBSITE || 'git.binaryninja.net' }}
+    IMAGE_GITEA_WEBSITE:              ${{ github.event.inputs.IMAGE_GITEA_WEBSITE || 'git.binaryninja.net' }}
+    IMAGE_ALPINE_VERSION:             ${{ github.event.inputs.IMAGE_ALPINE_VERSION || '3.22' }}
+    DISCORD_BOT_NAME:                 'Europa'
+    DISCORD_BOT_AVATAR:               'https://i.imgur.com/UqwMom1.jpeg'
+    DISCORD_BOT_EMBED_AUTHOR_ICON:    'https://avatars.githubusercontent.com/u/200161462'
+    DISCORD_BOT_EMBED_THUMBNAIL:      'https://avatars.githubusercontent.com/u/200161462'
 
-    BOT_NAME_1:                 EuropaServ
+    BOT_NAME_1:                       EuropaServ
-    BOT_NAME_2:                 BinaryServ
+    BOT_NAME_2:                       BinaryServ
-    BOT_NAME_DEPENDABOT:        dependabot[bot]
+    BOT_NAME_DEPENDABOT:              dependabot[bot]
-    BOT_NAME_RENOVATE:          renovate[bot]
+    BOT_NAME_RENOVATE:                renovate[bot]
 
 # #
 #   Jobs
@@ -174,9 +194,11 @@ jobs:
     job-docker-release-tags-create:
         name: >-
             📦 Release › Create Tag
-      # runs-on: ubuntu-latest
+        runs-on: ubuntu-latest
-        runs-on: apollo-x64
+      # runs-on: apollo-x64
         timeout-minutes: 4
+        outputs:
+            package_version: ${{ steps.task_initialize_package_getversion.outputs.PACKAGE_VERSION }}
         permissions:
             contents: write
             packages: write
@@ -184,25 +206,144 @@ jobs:
             id-token: write
         steps:
 
-            # #
-            #   Release › Tags › Start
-            # #
-
-            - name: '🏳️ Start'
-              id: task_release_tags_start
-              run: |
-                  echo "Creating Tag"
-
             # #
             #   Release › Tags › Checkout
             # #
 
-            - name: '✅ Checkout'
+            - name: '☑️ Checkout'
-              id: task_release_tags_checkout
               uses: actions/checkout@v4
               with:
                   fetch-depth: 0
 
+            # #
+            #   Release › Tags › Job Information
+            # #
+
+            - name: >-
+                  🔄 Load Job
+              uses: qoomon/actions--context@v4
+              id: 'context'
+
+            # #
+            #   Release › Tags › Set › Package.json › Version
+            # #
+
+            - name: '👁️‍🗨️ Package Version › Set'
+              id: task_initialize_package_getversion
+              working-directory: ./tvapp2
+              run: |
+                  VER=$(cat package.json | jq -r '.version')
+                  echo "PACKAGE_VERSION=${VER}" >> $GITHUB_OUTPUT
+                  echo "PACKAGE_VERSION=${VER}" >> $GITHUB_ENV
+
+            # #
+            #   Initialize › Get › Package.json › Version
+            # #
+
+            - name: '👁️‍🗨️ Package Version › Get'
+              run: |
+                  echo "VERSION: ${{ steps.task_initialize_package_getversion.outputs.PACKAGE_VERSION }}"
+
+            # #
+            #   Release › Tags › Start
+            # #
+
+            - name: >-
+                  ✅ Start
+              run: |
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo " Starting Job ${{ steps.context.outputs.job_name }}"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+
+                  YEAR="$(date +'%Y')"
+                  echo "YEAR=${YEAR}" >> $GITHUB_ENV
+
+                  NOW="$(date +'%m-%d-%Y %H:%M:%S')"                                                #  02-25-2025 12:49:48
+                  echo "NOW=${NOW}" >> $GITHUB_ENV
+
+                  NOW_SHORT="$(date +'%m-%d-%Y')"                                                   #  02-25-2025
+                  echo "NOW_SHORT=${NOW_SHORT}" >> $GITHUB_ENV
+
+                  NOW_LONG="$(date +'%m-%d-%Y %H:%M')"                                              #  02-25-2025 12:49
+                  echo "NOW_LONG=${NOW_LONG}" >> $GITHUB_ENV
+
+                  NOW_DOCKER="$(date +'%Y%m%d')"                                                    #  20250225
+                  echo "NOW_DOCKER=${NOW_DOCKER}" >> $GITHUB_ENV
+
+                  NOW_DOCKER_TS="$(date -u +'%FT%T.%3NZ')"                                          #  2025-02-25T12:50:11.569Z
+                  echo "NOW_DOCKER_TS=${NOW_DOCKER_TS}" >> $GITHUB_ENV
+
+                  SHA1="$(git rev-parse HEAD)"                                                      #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1=${SHA1}" >> $GITHUB_ENV
+
+                  SHA1_GH="$(echo ${GITHUB_SHA})"                                                   #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1_GH=${SHA1_GH}" >> $GITHUB_ENV
+
+                  PKG_VER_1DIGIT="$(echo ${{ env.PACKAGE_VERSION }} | cut -d '.' -f1-1)"            #  3.22 > 3
+                  echo "PKG_VER_1DIGIT=${PKG_VER_1DIGIT}" >> $GITHUB_ENV
+
+                  PKG_VER_2DIGIT="$(echo ${{ env.PACKAGE_VERSION }} | cut -f2 -d ":" | cut -c1-3)"  #  3.22 > 3.2
+                  echo "PKG_VER_2DIGIT=${PKG_VER_2DIGIT}" >> $GITHUB_ENV
+
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  sudo apt -qq update
+                  sudo apt -qq install tree
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo " Runner .............. ${{ runner.name }}"
+                  echo " Workflow ............ ${{ github.workflow }} (#${{ github.workflow_ref }})"
+                  echo " Run Number .......... ${{ github.run_number }}"
+                  echo " Ref ................. ${{ github.ref }}"
+                  echo " Ref Name ............ ${{ github.ref_name }}"
+                  echo " Event Name .......... ${{ github.event_name }}"
+                  echo " Repo ................ ${{ github.repository }}"
+                  echo " Repo Owner .......... ${{ github.repository_owner }}"
+                  echo " Run ID .............. https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+                  echo " Triggered By ........ ${{ github.actor }}"
+                  echo " SHA 1 (GITHUB_SHA) .. ${GITHUB_SHA}"
+                  echo " SHA 2 (env.SHA1) .. ${{ env.SHA1 }}"
+                  echo " SHA 3 (env.SHA1) .... ${SHA1}"
+                  echo " SHA 4 (env.SHA1_GH) . ${SHA1_GH}"
+                  echo " Workspace ........... ${{ github.workspace }}"
+                  echo " PWD ................. ${PWD}"
+                  echo " Job Name ............ ${{ steps.context.outputs.job_name }}"
+                  echo " Job ID .............. ${{ steps.context.outputs.job_id }}"
+                  echo " Job URL ............. ${{ steps.context.outputs.job_url }}"
+                  echo " Run ID .............. ${{ steps.context.outputs.run_id }}"
+                  echo " Run Attempt ......... ${{ steps.context.outputs.run_attempt }}"
+                  echo " Run Number .......... ${{ steps.context.outputs.run_number }}"
+                  echo " Run URL ............. ${{ steps.context.outputs.run_url }}"
+                  echo " Run Env ............. ${{ steps.context.outputs.environment }}"
+                  echo " Run Env URL ......... ${{ steps.context.outputs.environment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Deployment URL .. ${{ steps.context.outputs.deployment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Runner Name ..... ${{ steps.context.outputs.runner_name }}"
+                  echo " Run Runner ID ....... ${{ steps.context.outputs.runner_id }}"
+                  echo " Year ................ ${YEAR}"
+                  echo " Now ................. ${NOW}"
+                  echo " Now (Short) ......... ${NOW_SHORT}"
+                  echo " Now (Long) .......... ${NOW_LONG}"
+                  echo " Now (Docker) ........ ${NOW_DOCKER}"
+                  echo " Now (Docker TS) ..... ${NOW_DOCKER_TS}"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  tree -I node_modules -I .git
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+
             # #
             #   Release › Tags › Fix Permissions
             # #
@@ -232,9 +373,9 @@ jobs:
               id: task_release_tags_create
               if: ( github.event_name != 'workflow_dispatch' && inputs.DRY_RUN == false )
               with:
-                  tag: "${{ env.IMAGE_VERSION }}"
+                  tag: "${{ env.PACKAGE_VERSION }}"
                   tag_exists_error: false
-                  message: '${{ env.IMAGE_NAME }}-${{ env.IMAGE_VERSION }}'
+                  message: '${{ env.IMAGE_NAME }}-${{ env.PACKAGE_VERSION }}'
                   gpg_private_key: ${{ secrets.ADMINSERV_GPG_KEY_ASC }}
                   gpg_passphrase: ${{ secrets.ADMINSERV_GPG_PASSPHRASE }}
 
@@ -245,60 +386,152 @@ jobs:
     job-docker-release-gitea:
         name: >-
             📦 Release › Gitea
-      # runs-on: ubuntu-latest
+        runs-on: ubuntu-latest
-        runs-on: apollo-x64
+      # runs-on: apollo-x64
         timeout-minutes: 10
+        needs: [ job-docker-release-tags-create ]
         permissions:
             contents: write
             packages: write
             attestations: write
             id-token: write
-        needs: [ job-docker-release-tags-create ]
+        env:
+            PACKAGE_VERSION: ${{ needs.job-docker-release-tags-create.outputs.package_version }}
         steps:
 
-            # #
-            #   Release › Gitea › Start › Amd64
-            # #
-
-            - name: '🏳️ Start'
-              id: task_release_gi_start
-              run: |
-                  echo "Starting Gitea docker release"
-
             # #
             #   Release › Gitea › Checkout
             # #
 
-            - name: '✅ Checkout'
+            - name: '☑️ Checkout'
-              id: task_release_gh_checkout
               uses: actions/checkout@v4
               with:
                   fetch-depth: 0
 
             # #
-            #   Release › Gitea › Get Timestamp
+            #   Release › Gitea › Job Information
             # #
 
-            - name: '🕛 Get Timestamp'
+            - name: >-
+                  🔄 Load Job
+              uses: qoomon/actions--context@v4
+              id: 'context'
+
+            # #
+            #   Release › Gitea › Start
+            # #
+
+            - name: >-
+                  ✅ Start
+              run: |
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo " Starting Job ${{ steps.context.outputs.job_name }}"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+
+                  YEAR="$(date +'%Y')"
+                  echo "YEAR=${YEAR}" >> $GITHUB_ENV
+
+                  NOW="$(date +'%m-%d-%Y %H:%M:%S')"                                                #  02-25-2025 12:49:48
+                  echo "NOW=${NOW}" >> $GITHUB_ENV
+
+                  NOW_SHORT="$(date +'%m-%d-%Y')"                                                   #  02-25-2025
+                  echo "NOW_SHORT=${NOW_SHORT}" >> $GITHUB_ENV
+
+                  NOW_LONG="$(date +'%m-%d-%Y %H:%M')"                                              #  02-25-2025 12:49
+                  echo "NOW_LONG=${NOW_LONG}" >> $GITHUB_ENV
+
+                  NOW_DOCKER="$(date +'%Y%m%d')"                                                    #  20250225
+                  echo "NOW_DOCKER=${NOW_DOCKER}" >> $GITHUB_ENV
+
+                  NOW_DOCKER_TS="$(date -u +'%FT%T.%3NZ')"                                          #  2025-02-25T12:50:11.569Z
+                  echo "NOW_DOCKER_TS=${NOW_DOCKER_TS}" >> $GITHUB_ENV
+
+                  SHA1="$(git rev-parse HEAD)"                                                      #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1=${SHA1}" >> $GITHUB_ENV
+
+                  SHA1_GH="$(echo ${GITHUB_SHA})"                                                   #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1_GH=${SHA1_GH}" >> $GITHUB_ENV
+
+                  PKG_VER_1DIGIT="$(echo ${{ env.PACKAGE_VERSION }} | cut -d '.' -f1-1)"            #  3.22 > 3
+                  echo "PKG_VER_1DIGIT=${PKG_VER_1DIGIT}" >> $GITHUB_ENV
+
+                  PKG_VER_2DIGIT="$(echo ${{ env.PACKAGE_VERSION }} | cut -f2 -d ":" | cut -c1-3)"  #  3.22 > 3.2
+                  echo "PKG_VER_2DIGIT=${PKG_VER_2DIGIT}" >> $GITHUB_ENV
+
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  sudo apt -qq update
+                  sudo apt -qq install tree
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo " Runner .............. ${{ runner.name }}"
+                  echo " Workflow ............ ${{ github.workflow }} (#${{ github.workflow_ref }})"
+                  echo " Run Number .......... ${{ github.run_number }}"
+                  echo " Ref ................. ${{ github.ref }}"
+                  echo " Ref Name ............ ${{ github.ref_name }}"
+                  echo " Event Name .......... ${{ github.event_name }}"
+                  echo " Repo ................ ${{ github.repository }}"
+                  echo " Repo Owner .......... ${{ github.repository_owner }}"
+                  echo " Run ID .............. https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+                  echo " Triggered By ........ ${{ github.actor }}"
+                  echo " SHA 1 (GITHUB_SHA) .. ${GITHUB_SHA}"
+                  echo " SHA 2 (env.SHA1) .. ${{ env.SHA1 }}"
+                  echo " SHA 3 (env.SHA1) .... ${SHA1}"
+                  echo " SHA 4 (env.SHA1_GH) . ${SHA1_GH}"
+                  echo " Workspace ........... ${{ github.workspace }}"
+                  echo " PWD ................. ${PWD}"
+                  echo " Job Name ............ ${{ steps.context.outputs.job_name }}"
+                  echo " Job ID .............. ${{ steps.context.outputs.job_id }}"
+                  echo " Job URL ............. ${{ steps.context.outputs.job_url }}"
+                  echo " Run ID .............. ${{ steps.context.outputs.run_id }}"
+                  echo " Run Attempt ......... ${{ steps.context.outputs.run_attempt }}"
+                  echo " Run Number .......... ${{ steps.context.outputs.run_number }}"
+                  echo " Run URL ............. ${{ steps.context.outputs.run_url }}"
+                  echo " Run Env ............. ${{ steps.context.outputs.environment }}"
+                  echo " Run Env URL ......... ${{ steps.context.outputs.environment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Deployment URL .. ${{ steps.context.outputs.deployment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Runner Name ..... ${{ steps.context.outputs.runner_name }}"
+                  echo " Run Runner ID ....... ${{ steps.context.outputs.runner_id }}"
+                  echo " Year ................ ${YEAR}"
+                  echo " Now ................. ${NOW}"
+                  echo " Now (Short) ......... ${NOW_SHORT}"
+                  echo " Now (Long) .......... ${NOW_LONG}"
+                  echo " Now (Docker) ........ ${NOW_DOCKER}"
+                  echo " Now (Docker TS) ..... ${NOW_DOCKER_TS}"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  tree -I node_modules -I .git
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+
+            # #
+            #   Release › Gitea › Set Vars
+            # #
+
+            - name: '🕛 Set Vars'
               id: task_release_set_timestamp
               run: |
-                  echo "IMAGE_VERSION_1DIGIT=`echo ${{ env.IMAGE_VERSION }} | cut -d '.' -f1-1`" >> ${GITHUB_ENV}                                                   #  1
-                  echo "IMAGE_VERSION_2DIGIT=`echo ${{ env.IMAGE_VERSION }} | cut -d '.' -f1-2`" >> ${GITHUB_ENV}                                                   #  1.0
                   echo "REGISTRY_REPO_ORG_AUTHOR_LC=`echo ${{ env.IMAGE_GITEA_AUTHOR }}/${{ env.IMAGE_NAME }} | tr '[:upper:]' '[:lower:]'`" >> ${GITHUB_ENV}       #  thebinaryninja/tvapp2
                   echo "REGISTRY_REPO_AUTHOR_LC=`echo ${{ env.IMAGE_GITEA_AUTHOR }} | tr '[:upper:]' '[:lower:]'`" >> ${GITHUB_ENV}                                 #  thebinaryninja
-                  echo "DOCKER_SHA=${GITHUB_SHA}" >> $GITHUB_ENV                                                                                                    #  71fad013cfce9116ec62779e4a7e627fe4c33627
-                  echo "NOW=$(date +'%m-%d-%Y %H:%M:%S')" >> $GITHUB_ENV                                                                                            #  02-25-2025 12:49:48
-                  echo "NOW_SHORT=$(date +'%m-%d-%Y')" >> $GITHUB_ENV                                                                                               #  02-25-2025
-                  echo "NOW_LONG=$(date +'%m-%d-%Y %H:%M')" >> $GITHUB_ENV                                                                                          #  02-25-2025 12:49
-                  echo "NOW_DOCKER_LABEL=$(date +'%Y%m%d')" >> $GITHUB_ENV                                                                                          #  20250225
-                  echo "NOW_DOCKER_TS=$(date -u +'%FT%T.%3NZ')" >> $GITHUB_ENV                                                                                      #  2025-02-25T12:50:11.569Z
 
             # #
             #   Release › Gitea › Install Dependencies
             # #
 
             - name: '📦 Install Dependencies'
-              id: task_release_gi_dependencies
               run:
                   sudo apt-get install -qq dos2unix
 
@@ -307,7 +540,6 @@ jobs:
             # #
 
             - name: '🔐 Apply dos2unix'
-              id: task_release_gi_dos2unix
               run: |
                   echo "⚠️⚠️⚠️ Running DOS2UNIX ⚠️⚠️⚠️"
                   find ./ \( -path "./.git" -o -path "./docs" -o -path "./.github" -o -path "*.png" -o -path "*.jpg" \) -prune -o -name '*' -print | xargs dos2unix --
@@ -318,7 +550,6 @@ jobs:
             # #
 
             - name: '#️⃣ Manage Permissions'
-              id: task_release_gi_permissions
               run: |
                   find ./ -name 'run' -exec chmod 755 {} \;
                   WRONG_PERM=$(find ./  -path "./.git" -prune -o \( -name "run" -o -name "finish" -o -name "check" \) -not -perm -u=x,g=x,o=x -print)
@@ -340,6 +571,32 @@ jobs:
               id: task_release_gi_qemu
               uses: docker/setup-qemu-action@v3
 
+            # #
+            #   Required to fix insecure SSL error with docker buildx
+            # #
+
+            - name: '⚙️ Configure Docker daemon to allow insecure registry'
+              run: |
+                  echo "Configuring daemon to treat ${REGISTRY_HOST} as insecure"
+                  sudo mkdir -p /etc/docker
+                  sudo tee /etc/docker/daemon.json > /dev/null <<'JSON'
+                  {
+                    "insecure-registries": ["git.binaryninja.net:443"]
+                  }
+                  JSON
+
+                  # Restart Docker
+                  sudo service docker restart
+              env:
+                  REGISTRY_HOST: git.binaryninja.net
+
+            # #
+            #   Make sure change in docker daemon config successful
+            # #
+
+            - name: '⚙️ Check Docker Daemon Configuration'
+              run: cat /etc/docker/daemon.json
+
             # #
             #   Release › Gitea › Setup BuildX › Amd64
             # #
@@ -350,6 +607,10 @@ jobs:
               with:
                   version: latest
                   driver-opts: 'image=moby/buildkit:latest'
+                  driver: docker
+                  buildkitd-flags: --allow-insecure-entitlement
+                  install: true
+                  use: true
 
             # #
             #   Release › Gitea › Registry Login › Amd64
@@ -409,16 +670,16 @@ jobs:
                       type=ref,enable=${{ github.event_name == 'pull_request' || github.event_name == 'push' }},priority=600,prefix=,suffix=-amd64,event=tag
 
                       #  tag            add 1.0.0-amd64       ( dispatch only + no dev )
-                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=500,prefix=,suffix=-amd64,value=${{ env.IMAGE_VERSION }}
+                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=500,prefix=,suffix=-amd64,value=${{ env.PACKAGE_VERSION }}
 
                       #  tag            add 1.0.0             ( dispatch only + no dev )
-                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=450,prefix=,suffix=,value=${{ env.IMAGE_VERSION }}
+                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=450,prefix=,suffix=,value=${{ env.PACKAGE_VERSION }}
 
                       #  tag            add 1.0               ( dispatch only + no dev )
-                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=425,prefix=,suffix=,value=${{ env.IMAGE_VERSION_2DIGIT }}
+                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=425,prefix=,suffix=,value=${{ env.PKG_VER_2DIGIT }}
 
                       #  tag            add 1                 ( dispatch only + no dev )
-                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=400,prefix=,suffix=,value=${{ env.IMAGE_VERSION_1DIGIT }}
+                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=400,prefix=,suffix=,value=${{ env.PKG_VER_1DIGIT }}
 
                       #  dispatch       add development-amd64 ( dispatch only + only dev )
                       type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == true }},priority=300,prefix=development-,suffix=,value=amd64
@@ -428,25 +689,33 @@ jobs:
                   flavor: |
                       latest=false
                   labels: |
+                      org.opencontainers.image.description=TVApp2
                       org.opencontainers.image.created=${{ env.NOW_DOCKER_TS }}
-                      org.opencontainers.image.version=${{ env.IMAGE_VERSION }}
+                      org.opencontainers.image.version=${{ env.PACKAGE_VERSION }}
                       org.opencontainers.image.licenses=MIT
-                      org.opencontainers.image.revision=${{ github.sha }}
+                      org.opencontainers.image.revision=${{ env.SHA1 }}
                       org.opencontainers.image.vendor=${{ env.REGISTRY_REPO_AUTHOR_LC }}
                       org.opencontainers.image.ref.name=${{ github.ref_name }}
                       org.opencontainers.image.development=${{ inputs.DEV_RELEASE == true && 'true' || 'false' }}
-                      org.opencontainers.image.registry=gitea
+                      org.opencontainers.image.registry=${{ env.IMAGE_REGISTRY }}
-                      org.tvapp2.image.build-version="Version:- ${{ env.IMAGE_VERSION }} Date:- ${{ env.NOW_DOCKER_LABEL }}"
+                      org.tvapp2.image.build-version="Version: ${{ env.PACKAGE_VERSION }} Date: ${{ env.NOW_DOCKER }}"
-                  annotations: |
+                      org.tvapp2.image.build-version-alpine=${{ env.IMAGE_ALPINE_VERSION }}
+                      org.tvapp2.image.build-release="${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}"
+                      org.tvapp2.image.build-sha1=${{ env.SHA1 }}
+                  annotations: |-
+                      org.opencontainers.image.description=TVApp2
                       org.opencontainers.image.created=${{ env.NOW_DOCKER_TS }}
-                      org.opencontainers.image.version=${{ env.IMAGE_VERSION }}
+                      org.opencontainers.image.version=${{ env.PACKAGE_VERSION }}
                       org.opencontainers.image.licenses=MIT
-                      org.opencontainers.image.revision=${{ github.sha }}
+                      org.opencontainers.image.revision=${{ env.SHA1 }}
                       org.opencontainers.image.vendor=${{ env.REGISTRY_REPO_AUTHOR_LC }}
                       org.opencontainers.image.ref.name=${{ github.ref_name }}
                       org.opencontainers.image.development=${{ inputs.DEV_RELEASE == true && 'true' || 'false' }}
-                      org.opencontainers.image.registry=gitea
+                      org.opencontainers.image.registry=${{ env.IMAGE_REGISTRY }}
-                      org.tvapp2.image.build-version="Version:- ${{ env.IMAGE_VERSION }} Date:- ${{ env.NOW_DOCKER_LABEL }}"
+                      org.tvapp2.image.build-version="Version: ${{ env.PACKAGE_VERSION }} Date: ${{ env.NOW_DOCKER }}"
+                      org.tvapp2.image.build-version-alpine=${{ env.IMAGE_ALPINE_VERSION }}
+                      org.tvapp2.image.build-release="${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}"
+                      org.tvapp2.image.build-sha1=${{ env.SHA1 }}
 
             # #
             #   Release › Gitea › Meta › arm64
@@ -469,32 +738,40 @@ jobs:
                       type=ref,enable=${{ github.event_name == 'pull_request' || github.event_name == 'push' }},priority=600,prefix=,suffix=-arm64,event=tag
 
                       #  tag            add 1.0.0-arm64       ( dispatch only + no dev )
-                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=500,prefix=,suffix=-arm64,value=${{ env.IMAGE_VERSION }}
+                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=500,prefix=,suffix=-arm64,value=${{ env.PACKAGE_VERSION }}
 
                       #  dispatch       add development-arm64 ( dispatch only + only dev )
                       type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == true }},priority=300,prefix=,suffix=-arm64,value=development
                   flavor: |
                       latest=false
                   labels: |
+                      org.opencontainers.image.description=TVApp2
                       org.opencontainers.image.created=${{ env.NOW_DOCKER_TS }}
-                      org.opencontainers.image.version=${{ env.IMAGE_VERSION }}
+                      org.opencontainers.image.version=${{ env.PACKAGE_VERSION }}
                       org.opencontainers.image.licenses=MIT
-                      org.opencontainers.image.revision=${{ github.sha }}
+                      org.opencontainers.image.revision=${{ env.SHA1 }}
                       org.opencontainers.image.vendor=${{ env.REGISTRY_REPO_AUTHOR_LC }}
                       org.opencontainers.image.ref.name=${{ github.ref_name }}
                       org.opencontainers.image.development=${{ inputs.DEV_RELEASE == true && 'true' || 'false' }}
-                      org.opencontainers.image.registry=gitea
+                      org.opencontainers.image.registry=${{ env.IMAGE_REGISTRY }}
-                      org.tvapp2.image.build-version="Version:- ${{ env.IMAGE_VERSION }} Date:- ${{ env.NOW_DOCKER_LABEL }}"
+                      org.tvapp2.image.build-version="Version: ${{ env.PACKAGE_VERSION }} Date: ${{ env.NOW_DOCKER }}"
-                  annotations: |
+                      org.tvapp2.image.build-version-alpine=${{ env.IMAGE_ALPINE_VERSION }}
+                      org.tvapp2.image.build-release="${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}"
+                      org.tvapp2.image.build-sha1=${{ env.SHA1 }}
+                  annotations: |-
+                      org.opencontainers.image.description=TVApp2
                       org.opencontainers.image.created=${{ env.NOW_DOCKER_TS }}
-                      org.opencontainers.image.version=${{ env.IMAGE_VERSION }}
+                      org.opencontainers.image.version=${{ env.PACKAGE_VERSION }}
                       org.opencontainers.image.licenses=MIT
-                      org.opencontainers.image.revision=${{ github.sha }}
+                      org.opencontainers.image.revision=${{ env.SHA1 }}
                       org.opencontainers.image.vendor=${{ env.REGISTRY_REPO_AUTHOR_LC }}
                       org.opencontainers.image.ref.name=${{ github.ref_name }}
                       org.opencontainers.image.development=${{ inputs.DEV_RELEASE == true && 'true' || 'false' }}
-                      org.opencontainers.image.registry=gitea
+                      org.opencontainers.image.registry=${{ env.IMAGE_REGISTRY }}
-                      org.tvapp2.image.build-version="Version:- ${{ env.IMAGE_VERSION }} Date:- ${{ env.NOW_DOCKER_LABEL }}"
+                      org.tvapp2.image.build-version="Version: ${{ env.PACKAGE_VERSION }} Date: ${{ env.NOW_DOCKER }}"
+                      org.tvapp2.image.build-version-alpine=${{ env.IMAGE_ALPINE_VERSION }}
+                      org.tvapp2.image.build-release="${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}"
+                      org.tvapp2.image.build-sha1=${{ env.SHA1 }}
 
             # #
             #   Release › Gitea › Meta › Release
@@ -520,13 +797,13 @@ jobs:
                       type=ref,enable=${{ github.event_name == 'pull_request' || github.event_name == 'push' }},priority=600,prefix=,suffix=,event=tag
 
                       #  tag            add 1.0.0             ( dispatch only + no dev )
-                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=450,prefix=,suffix=,value=${{ env.IMAGE_VERSION }}
+                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=450,prefix=,suffix=,value=${{ env.PACKAGE_VERSION }}
 
                       #  tag            add 1.0               ( dispatch only + no dev )
-                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=425,prefix=,suffix=,value=${{ env.IMAGE_VERSION_2DIGIT }}
+                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=425,prefix=,suffix=,value=${{ env.PKG_VER_2DIGIT }}
 
                       #  tag            add 1                 ( dispatch only + no dev )
-                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=400,prefix=,suffix=,value=${{ env.IMAGE_VERSION_1DIGIT }}
+                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=400,prefix=,suffix=,value=${{ env.PKG_VER_1DIGIT }}
 
                       #  tag            add development       ( dispatch only + only dev )
                       type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == true }},priority=300,prefix=,suffix=,value=development
@@ -536,25 +813,33 @@ jobs:
                   flavor: |
                       latest=false
                   labels: |
+                      org.opencontainers.image.description=TVApp2
                       org.opencontainers.image.created=${{ env.NOW_DOCKER_TS }}
-                      org.opencontainers.image.version=${{ env.IMAGE_VERSION }}
+                      org.opencontainers.image.version=${{ env.PACKAGE_VERSION }}
                       org.opencontainers.image.licenses=MIT
-                      org.opencontainers.image.revision=${{ github.sha }}
+                      org.opencontainers.image.revision=${{ env.SHA1 }}
                       org.opencontainers.image.vendor=${{ env.REGISTRY_REPO_AUTHOR_LC }}
                       org.opencontainers.image.ref.name=${{ github.ref_name }}
                       org.opencontainers.image.development=${{ inputs.DEV_RELEASE == true && 'true' || 'false' }}
-                      org.opencontainers.image.registry=gitea
+                      org.opencontainers.image.registry=${{ env.IMAGE_REGISTRY }}
-                      org.tvapp2.image.build-version="Version:- ${{ env.IMAGE_VERSION }} Date:- ${{ env.NOW_DOCKER_LABEL }}"
+                      org.tvapp2.image.build-version="Version: ${{ env.PACKAGE_VERSION }} Date: ${{ env.NOW_DOCKER }}"
-                  annotations: |
+                      org.tvapp2.image.build-version-alpine=${{ env.IMAGE_ALPINE_VERSION }}
+                      org.tvapp2.image.build-release="${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}"
+                      org.tvapp2.image.build-sha1=${{ env.SHA1 }}
+                  annotations: |-
+                      org.opencontainers.image.description=TVApp2
                       org.opencontainers.image.created=${{ env.NOW_DOCKER_TS }}
-                      org.opencontainers.image.version=${{ env.IMAGE_VERSION }}
+                      org.opencontainers.image.version=${{ env.PACKAGE_VERSION }}
                       org.opencontainers.image.licenses=MIT
-                      org.opencontainers.image.revision=${{ github.sha }}
+                      org.opencontainers.image.revision=${{ env.SHA1 }}
                       org.opencontainers.image.vendor=${{ env.REGISTRY_REPO_AUTHOR_LC }}
                       org.opencontainers.image.ref.name=${{ github.ref_name }}
                       org.opencontainers.image.development=${{ inputs.DEV_RELEASE == true && 'true' || 'false' }}
-                      org.opencontainers.image.registry=gitea
+                      org.opencontainers.image.registry=${{ env.IMAGE_REGISTRY }}
-                      org.tvapp2.image.build-version="Version:- ${{ env.IMAGE_VERSION }} Date:- ${{ env.NOW_DOCKER_LABEL }}"
+                      org.tvapp2.image.build-version="Version: ${{ env.PACKAGE_VERSION }} Date: ${{ env.NOW_DOCKER }}"
+                      org.tvapp2.image.build-version-alpine=${{ env.IMAGE_ALPINE_VERSION }}
+                      org.tvapp2.image.build-release="${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}"
+                      org.tvapp2.image.build-sha1=${{ env.SHA1 }}
 
             # #
             #   Release › Gitea › Build and Push › Amd64
@@ -565,20 +850,41 @@ jobs:
               uses: docker/build-push-action@v6
               if: ( github.event_name == 'workflow_dispatch' && inputs.DRY_RUN == false ) || ( github.event_name == 'push' )
               with:
+                  allow: |
+                      network.host
+                  network: host
                   context: .
                   file: Dockerfile
                   platforms: linux/amd64
                   push: ${{ github.event_name != 'pull_request' }}
                   labels: ${{ steps.task_release_gi_meta_amd64.outputs.labels }}
-                  tags: |
-                      ${{ steps.task_release_gi_meta_amd64.outputs.tags }}
                   provenance: false
                   sbom: false
+                  tags: |
+                      ${{ steps.task_release_gi_meta_amd64.outputs.tags }}
                   build-args: |-
                       ARCH=amd64
                       RELEASE=${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}
-                      VERSION=${{ env.IMAGE_VERSION }}
+                      VERSION=${{ env.PACKAGE_VERSION }}
-                      BUILDDATE=${{ env.NOW_DOCKER_LABEL }}
+                      BUILDDATE=${{ env.NOW_DOCKER }}
+                      GIT_SHA1=${{ env.SHA1 }}
+                      ALPINE_VERSION=${{ env.IMAGE_ALPINE_VERSION }}
+                  annotations: |-
+                      org.opencontainers.image.description=TVApp2
+                      org.opencontainers.image.created=${{ env.NOW_DOCKER_TS }}
+                      org.opencontainers.image.version=${{ env.PACKAGE_VERSION }}
+                      org.opencontainers.image.licenses=MIT
+                      org.opencontainers.image.architecture=amd64
+                      org.opencontainers.image.revision=${{ env.SHA1 }}
+                      org.opencontainers.image.vendor=${{ env.REGISTRY_REPO_AUTHOR_LC }}
+                      org.opencontainers.image.ref.name=${{ github.ref_name }}
+                      org.opencontainers.image.development=${{ inputs.DEV_RELEASE == true && 'true' || 'false' }}
+                      org.opencontainers.image.registry=${{ env.IMAGE_REGISTRY }}
+                      org.tvapp2.image.build-version="Version: ${{ env.PACKAGE_VERSION }} Date: ${{ env.NOW_DOCKER }}"
+                      org.tvapp2.image.build-version-alpine=${{ env.IMAGE_ALPINE_VERSION }}
+                      org.tvapp2.image.build-architecture=amd64
+                      org.tvapp2.image.build-release="${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}"
+                      org.tvapp2.image.build-sha1=${{ env.SHA1 }}
 
             # #
             #   Release › Gitea › Export Digest › Amd64
@@ -617,20 +923,41 @@ jobs:
               uses: docker/build-push-action@v6
               if: ( github.event_name == 'workflow_dispatch' && inputs.DRY_RUN == false ) || ( github.event_name == 'push' )
               with:
+                  allow: |
+                      network.host
+                  network: host
                   context: .
                   file: Dockerfile
                   platforms: linux/arm64
                   push: ${{ github.event_name != 'pull_request' }}
                   labels: ${{ steps.task_release_gi_meta_arm64.outputs.labels }}
-                  tags: |
-                      ${{ steps.task_release_gi_meta_arm64.outputs.tags }}
                   provenance: false
                   sbom: false
+                  tags: |
+                      ${{ steps.task_release_gi_meta_arm64.outputs.tags }}
                   build-args: |-
                       ARCH=arm64
                       RELEASE=${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}
-                      VERSION=${{ env.IMAGE_VERSION }}
+                      VERSION=${{ env.PACKAGE_VERSION }}
-                      BUILDDATE=${{ env.NOW_DOCKER_LABEL }}
+                      BUILDDATE=${{ env.NOW_DOCKER }}
+                      GIT_SHA1=${{ env.SHA1 }}
+                      ALPINE_VERSION=${{ env.IMAGE_ALPINE_VERSION }}
+                  annotations: |-
+                      org.opencontainers.image.description=TVApp2
+                      org.opencontainers.image.created=${{ env.NOW_DOCKER_TS }}
+                      org.opencontainers.image.version=${{ env.PACKAGE_VERSION }}
+                      org.opencontainers.image.licenses=MIT
+                      org.opencontainers.image.architecture=arm64
+                      org.opencontainers.image.revision=${{ env.SHA1 }}
+                      org.opencontainers.image.vendor=${{ env.REGISTRY_REPO_AUTHOR_LC }}
+                      org.opencontainers.image.ref.name=${{ github.ref_name }}
+                      org.opencontainers.image.development=${{ inputs.DEV_RELEASE == true && 'true' || 'false' }}
+                      org.opencontainers.image.registry=${{ env.IMAGE_REGISTRY }}
+                      org.tvapp2.image.build-version="Version: ${{ env.PACKAGE_VERSION }} Date: ${{ env.NOW_DOCKER }}"
+                      org.tvapp2.image.build-version-alpine=${{ env.IMAGE_ALPINE_VERSION }}
+                      org.tvapp2.image.build-architecture=arm64
+                      org.tvapp2.image.build-release="${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}"
+                      org.tvapp2.image.build-sha1=${{ env.SHA1 }}
 
             # #
             #   Release › Gitea › Export Digest › Arm64
@@ -660,6 +987,70 @@ jobs:
                   if-no-files-found: error
                   retention-days: 10
 
+            # #
+            #   Release › Gitea › Checkpoint
+            # #
+
+            - name: '⚠️ Checkpoint'
+              run: |
+                  echo "‎"
+                  echo "---- [ GITHUB ] ----------------------------------------------------------------------------------------"
+                  echo "github.actor.............................. ${{ github.actor }}"
+                  echo "github.ref ............................... ${{ github.ref }}"
+                  echo "github.ref_name .......................... ${{ github.ref_name }}"
+                  echo "github.event_name ........................ ${{ github.event_name }}"
+                  echo "github.repository_owner .................. ${{ github.repository_owner }}"
+                  echo "github.repository ........................ ${{ github.repository }}"
+                  echo "github.sha ............................... ${{ github.sha }}"
+                  echo "‎"
+                  echo "---- [ INPUTS ] ----------------------------------------------------------------------------------------"
+                  echo "inputs.IMAGE_NAME ........................ ${{ inputs.IMAGE_NAME }}"
+                  echo "inputs.IMAGE_GITEA_USERNAME .............. ${{ inputs.IMAGE_GITEA_AUTHOR }}"
+                  echo "inputs.IMAGE_GITEA_USERNAME .............. ${{ inputs.IMAGE_GITEA_USERNAME }}"
+                  echo "inputs.IMAGE_GITEA_WEBSITE ............... ${{ inputs.IMAGE_GITEA_WEBSITE }}"
+                  echo "inputs.DEV_RELEASE ....................... ${{ inputs.DEV_RELEASE }}"
+                  echo "inputs.DRY_RUN ........................... ${{ inputs.DRY_RUN }}"
+                  echo "‎"
+                  echo "---- [ ENV ] -------------------------------------------------------------------------------------------"
+                  echo "env.IMAGE_NAME ........................... ${{ env.IMAGE_NAME }}"
+                  echo "env.PACKAGE_VERSION ...................... ${{ env.PACKAGE_VERSION }}"
+                  echo "env.PKG_VER_1DIGIT ....................... ${{ env.PKG_VER_1DIGIT }}"
+                  echo "env.PKG_VER_2DIGIT ....................... ${{ env.PKG_VER_2DIGIT }}"
+                  echo "env.IMAGE_GITEA_AUTHOR ................... ${{ env.IMAGE_GITEA_AUTHOR }}"
+                  echo "env.IMAGE_GITEA_USERNAME ................. ${{ env.IMAGE_GITEA_USERNAME }}"
+                  echo "env.IMAGE_GITEA_WEBSITE .................. ${{ env.IMAGE_GITEA_WEBSITE }}"
+                  echo "env.NOW .................................. ${{ env.NOW }}"
+                  echo "env.NOW_SHORT ............................ ${{ env.NOW_SHORT }}"
+                  echo "env.NOW_LONG ............................. ${{ env.NOW_LONG }}"
+                  echo "env.NOW_DOCKER ........................... ${{ env.NOW_DOCKER }}"
+                  echo "env.NOW_DOCKER_TS ........................ ${{ env.NOW_DOCKER_TS }}"
+                  echo "env.REGISTRY_REPO_ORG_AUTHOR_LC .......... ${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}"
+                  echo "env.REGISTRY_REPO_AUTHOR_LC .............. ${{ env.REGISTRY_REPO_AUTHOR_LC }}"
+                  echo " SHA 1 (GITHUB_SHA) ...................... ${GITHUB_SHA}"
+                  echo " SHA 2 (github.sha) ...................... ${{ github.sha }}"
+                  echo " SHA 3 (env.SHA1) ........................ ${{ env.SHA1 }}"
+                  echo " SHA 4 (env.SHA1_GH) ..................... ${{ env.SHA1_GH }}"
+                  echo "‎"
+                  echo "---- [ DOCKER IMAGES ] ---------------------------------------------------------------------------------"
+                  echo "registry ................................. Gitea"
+                  echo "(amd64) tags ............................. ${{ steps.task_release_gi_meta_amd64.outputs.tags }}"
+                  echo "(amd64) labels ........................... ${{ steps.task_release_gi_meta_amd64.outputs.labels }}"
+                  echo "(amd64) digest ........................... ${{ steps.task_release_gi_push_amd64.outputs.digest }}"
+                  echo "‎"
+                  echo "(arm64) tags ............................. ${{ steps.task_release_gi_meta_arm64.outputs.tags }}"
+                  echo "(arm64) labels ........................... ${{ steps.task_release_gi_meta_arm64.outputs.labels }}"
+                  echo "(arm64) digest ........................... ${{ steps.task_release_gi_push_arm64.outputs.digest }}"
+                  echo "‎"
+                  echo "(release) tags ........................... ${{ steps.task_release_gi_meta_release.outputs.tags }}"
+                  echo "(release) labels ......................... ${{ steps.task_release_gi_meta_release.outputs.labels }}"
+                  echo "‎"
+                  echo "---- [ DOCKER DIGESTS ] --------------------------------------------------------------------------------"
+                  echo "docker image id (amd64) .................. ${{ steps.task_release_gi_push_amd64.outputs.imageid }}"
+                  echo "docker digest (amd64) .................... ${{ steps.task_release_gi_push_amd64.outputs.digest }}"
+                  echo "docker image id (arm64) .................. ${{ steps.task_release_gi_push_arm64.outputs.imageid }}"
+                  echo "docker digest (arm64) .................... ${{ steps.task_release_gi_push_arm64.outputs.digest }}"
+                  echo "‎"
+
             # #
             #   Release › Gitea › Push Manifest
             # #
@@ -668,81 +1059,19 @@ jobs:
               id: task_release_gi_manifest
               uses: int128/docker-manifest-create-action@v2
               with:
-                tags: |
+                  tags: |
-                    ${{ steps.task_release_gi_meta_release.outputs.tags }}
+                      ${{ steps.task_release_gi_meta_release.outputs.tags }}
-                sources: |
+                  sources: |
-                    ${{ env.IMAGE_GITEA_WEBSITE }}/${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}@${{ steps.task_release_gi_push_amd64.outputs.digest }}
+                      ${{ env.IMAGE_GITEA_WEBSITE }}/${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}@${{ steps.task_release_gi_push_amd64.outputs.digest }}
-                    ${{ env.IMAGE_GITEA_WEBSITE }}/${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}@${{ steps.task_release_gi_push_arm64.outputs.digest }}
+                      ${{ env.IMAGE_GITEA_WEBSITE }}/${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}@${{ steps.task_release_gi_push_arm64.outputs.digest }}
-                index-annotations: |
+                  index-annotations: |
-                    ${{ steps.task_release_gi_meta_release.outputs.labels }}
+                      ${{ steps.task_release_gi_meta_release.outputs.labels }}
-
-            # #
-            #   Release › Gitea › Checkpoint
-            # #
-
-            - name: '⚠️ Checkpoint'
-              id: task_release_gi_checkpoint
-              run: |
-                  echo ""
-                  echo "[ GITHUB ] ---------------------------------------------------------------------------------------------"
-                  echo "github.actor.............................. ${{ github.actor }}"
-                  echo "github.ref ............................... ${{ github.ref }}"
-                  echo "github.ref_name .......................... ${{ github.ref_name }}"
-                  echo "github.event_name ........................ ${{ github.event_name }}"
-                  echo "github.repository_owner .................. ${{ github.repository_owner }}"
-                  echo "github.repository ........................ ${{ github.repository }}"
-                  echo ""
-                  echo "[ INPUTS ] ---------------------------------------------------------------------------------------------"
-                  echo "inputs.IMAGE_NAME ........................ ${{ inputs.IMAGE_NAME }}"
-                  echo "inputs.IMAGE_VERSION ..................... ${{ inputs.IMAGE_VERSION }}"
-                  echo "inputs.IMAGE_GITEA_USERNAME .............. ${{ inputs.IMAGE_GITEA_AUTHOR }}"
-                  echo "inputs.IMAGE_GITEA_USERNAME .............. ${{ inputs.IMAGE_GITEA_USERNAME }}"
-                  echo "inputs.IMAGE_GITEA_WEBSITE ............... ${{ inputs.IMAGE_GITEA_WEBSITE }}"
-                  echo "inputs.DEV_RELEASE ....................... ${{ inputs.DEV_RELEASE }}"
-                  echo "inputs.DRY_RUN ........................... ${{ inputs.DRY_RUN }}"
-                  echo ""
-                  echo "[ ENV ] ------------------------------------------------------------------------------------------------"
-                  echo "env.IMAGE_NAME ........................... ${{ env.IMAGE_NAME }}"
-                  echo "env.IMAGE_VERSION ........................ ${{ env.IMAGE_VERSION }}"
-                  echo "env.IMAGE_VERSION_1DIGIT ................. ${{ env.IMAGE_VERSION_1DIGIT }}"
-                  echo "env.IMAGE_VERSION_2DIGIT ................. ${{ env.IMAGE_VERSION_2DIGIT }}"
-                  echo "env.IMAGE_GITEA_AUTHOR ................... ${{ env.IMAGE_GITEA_AUTHOR }}"
-                  echo "env.IMAGE_GITEA_USERNAME ................. ${{ env.IMAGE_GITEA_USERNAME }}"
-                  echo "env.IMAGE_GITEA_WEBSITE .................. ${{ env.IMAGE_GITEA_WEBSITE }}"
-                  echo "env.NOW .................................. ${{ env.NOW }}"
-                  echo "env.NOW_SHORT ............................ ${{ env.NOW_SHORT }}"
-                  echo "env.NOW_LONG ............................. ${{ env.NOW_LONG }}"
-                  echo "env.NOW_DOCKER_LABEL ..................... ${{ env.NOW_DOCKER_LABEL }}"
-                  echo "env.NOW_DOCKER_TS ........................ ${{ env.NOW_DOCKER_TS }}"
-                  echo "env.REGISTRY_REPO_ORG_AUTHOR_LC .......... ${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}"
-                  echo "env.REGISTRY_REPO_AUTHOR_LC .............. ${{ env.REGISTRY_REPO_AUTHOR_LC }}"
-                  echo "env.DOCKER_SHA ........................... ${{ env.DOCKER_SHA }}"
-                  echo ""
-                  echo "[ DOCKER IMAGES ] --------------------------------------------------------------------------------------"
-                  echo "registry ................................. Gitea"
-                  echo "(amd64) tags ............................. ${{ steps.task_release_gi_meta_amd64.outputs.tags }}"
-                  echo "(amd64) labels ........................... ${{ steps.task_release_gi_meta_amd64.outputs.labels }}"
-                  echo "(amd64) digest ........................... ${{ steps.task_release_gi_push_amd64.outputs.digest }}"
-                  echo ""
-                  echo "(arm64) tags ............................. ${{ steps.task_release_gi_meta_arm64.outputs.tags }}"
-                  echo "(arm64) labels ........................... ${{ steps.task_release_gi_meta_arm64.outputs.labels }}"
-                  echo "(arm64) digest ........................... ${{ steps.task_release_gi_push_arm64.outputs.digest }}"
-                  echo ""
-                  echo "(release) tags ........................... ${{ steps.task_release_gi_meta_release.outputs.tags }}"
-                  echo "(release) labels ......................... ${{ steps.task_release_gi_meta_release.outputs.labels }}"
-                  echo ""
-                  echo "[ DOCKER DIGESTS ] -------------------------------------------------------------------------------------"
-                  echo "docker image id (amd64) .................. ${{ steps.task_release_gi_push_amd64.outputs.imageid }}"
-                  echo "docker digest (amd64) .................... ${{ steps.task_release_gi_push_amd64.outputs.digest }}"
-                  echo "docker image id (arm64) .................. ${{ steps.task_release_gi_push_arm64.outputs.imageid }}"
-                  echo "docker digest (arm64) .................... ${{ steps.task_release_gi_push_arm64.outputs.digest }}"
 
             # #
             #   Release › Gitea › Get Weekly Commits
             # #
 
             - name: '🕛 Get Weekly Commit List'
-              id: task_release_set_weekly_commit_list
               run: |
                   echo 'WEEKLY_COMMITS<<EOF' >> $GITHUB_ENV
                   git log --format="[\`%h\`](${{ github.server_url }}/${{ github.repository }}/commit/%H) %s - %an" --since=7.days >> $GITHUB_ENV
@@ -756,27 +1085,27 @@ jobs:
               uses: tsickert/discord-webhook@v7.0.0
               if: success()
               with:
-                  username: 'Io'
+                  username: ${{ env.DISCORD_BOT_NAME }}
-                  avatar-url: 'https://i.imgur.com/8BVDkla.jpg'
+                  avatar-url: ${{ env.DISCORD_BOT_AVATAR }}
                   webhook-url: ${{ secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_RELEASES }}
                   embed-title: "⚙️ ${{ github.workflow_ref }}"
                   embed-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-thumbnail-url: 'https://i.imgur.com/zDIzE8T.jpg'
+                  embed-thumbnail-url: ${{ env.DISCORD_BOT_EMBED_THUMBNAIL }}
                   embed-description: |
-                      ### 📦 ᲼Deploy (Gitea) ᲼${{ job.status == 'success' && '✅' || '❌' }}᲼ › `${{ env.IMAGE_NAME }}-${{ env.IMAGE_VERSION }}${{ inputs.DEV_RELEASE == true && '-development' || '' }}`
+                      ### 📦 ᲼Deploy (Gitea) ᲼${{ job.status == 'success' && '✅' || '❌' }}᲼ › `${{ env.IMAGE_NAME }}-${{ env.PACKAGE_VERSION }}${{ inputs.DEV_RELEASE == true && '-development' || '' }}`
                       ${{ inputs.DEV_RELEASE == true && '### ⚠️⚠️ Development / Pre-release ⚠️⚠️' || '' }}
 
                       A new version of the docker container `${{ env.IMAGE_NAME }}` has been released from Github to Gitea. The image is available at:
                       - https://${{ env.IMAGE_GITEA_WEBSITE }}/${{ env.IMAGE_GITEA_USERNAME }}/${{ env.IMAGE_NAME }}/packages
 
-                      - Version: `${{ env.IMAGE_VERSION }}`
+                      - Version: `${{ env.PACKAGE_VERSION }}`
                       - Release Type: `${{ inputs.DEV_RELEASE == true && '⚠️⚠️ Development / Pre-release ⚠️⚠️' || 'Stable' }}`
-                      - Pull: `docker pull ${{ env.IMAGE_GITEA_WEBSITE }}/${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}:${{ inputs.DEV_RELEASE == true && 'development' || env.IMAGE_VERSION }}`
+                      - Pull: `docker pull ${{ env.IMAGE_GITEA_WEBSITE }}/${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}:${{ inputs.DEV_RELEASE == true && 'development' || env.PACKAGE_VERSION }}`
                       - Pull (amd64): `docker pull ${{ env.IMAGE_GITEA_WEBSITE }}/${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}@${{ steps.task_release_gi_push_amd64.outputs.digest }}`
                       - Pull (arm64): `docker pull ${{ env.IMAGE_GITEA_WEBSITE }}/${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}@${{ steps.task_release_gi_push_arm64.outputs.digest }}`
                       - Dry Run: `${{ inputs.DRY_RUN }}`
                       - Source: `Gitea` https://${{ env.IMAGE_GITEA_WEBSITE }}/${{ env.IMAGE_GITEA_USERNAME }}/${{ env.IMAGE_NAME }}/packages
-                      - Docker Image: `${{ env.IMAGE_NAME }}-${{ env.IMAGE_VERSION }}${{ inputs.DEV_RELEASE == true && '-development' || '' }}`
+                      - Docker Image: `${{ env.IMAGE_NAME }}-${{ env.PACKAGE_VERSION }}${{ inputs.DEV_RELEASE == true && '-development' || '' }}`
                       - Branch: `${{ github.ref_name }}`
                       - Workflow: `${{ github.workflow }} (#${{github.run_number}})`
                       - Runner: `${{ runner.name }}`
@@ -801,4 +1130,4 @@ jobs:
                   embed-timestamp: "${{ env.NOW_LONG }}"
                   embed-author-name: "${{ github.repository_owner }}"
                   embed-author-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-author-icon-url: "https://avatars.githubusercontent.com/u/200161462"
+                  embed-author-icon-url: ${{ env.DISCORD_BOT_EMBED_AUTHOR_ICON }}

.github/workflows/deploy-docker-github.yml

@@ -31,8 +31,8 @@
 #                           act -W .github/workflows/deploy-docker-github.yml -s TOKEN_CL=XXXXXXXXXX --pull=false
 # #
 
-name: "📦 Deploy › Docker › Github"
+name: '📦 Deploy › Docker › Github'
-run-name: "📦 Deploy › Docker › Github"
+run-name: '📦 Deploy › Docker › Github'
 
 # #
 #   Triggers
@@ -63,15 +63,18 @@ on:
                 type:           string
 
             # #
-            #   Image Version
+            #   Registry Name
             #
-            #   used to create new release tag, and add version to docker image name
+            #   options:
+            #       - github
+            #       - dockerhub
+            #       - gitea
             # #
 
-            IMAGE_VERSION:
+            IMAGE_REGISTRY:
-                description:    '🏷️ Image Version'
+                description:    '📘 Registry Name'
                 required:       true
-                default:        '1.0.0'
+                default:        'github'
                 type:           string
 
             # #
@@ -99,6 +102,18 @@ on:
                 default:        'TheBinaryNinja'
                 type:           string
 
+            # #
+            #   Alpine Version
+            #
+            #   specifies the alpine base docker image version
+            # #
+
+            IMAGE_ALPINE_VERSION:
+                description:    '📀 Alpine Version'
+                required:       true
+                default:        '3.22'
+                type:           string
+
             # #
             #   true            no changes to the repo will be made
             #   false           workflow will behave normally, and push any changes detected to the files
@@ -134,15 +149,20 @@ on:
 # #
 
 env:
-    IMAGE_NAME:                 ${{ github.event.inputs.IMAGE_NAME || 'tvapp2' }}
+    IMAGE_NAME:                       ${{ github.event.inputs.IMAGE_NAME || 'tvapp2' }}
-    IMAGE_VERSION:              ${{ github.event.inputs.IMAGE_VERSION || '1.0.0' }}
+    IMAGE_REGISTRY:                   ${{ github.event.inputs.IMAGE_REGISTRY || 'github' }}
-    IMAGE_GHCR_AUTHOR:          ${{ github.event.inputs.IMAGE_GHCR_AUTHOR || 'BinaryNinja' }}
+    IMAGE_GHCR_AUTHOR:                ${{ github.event.inputs.IMAGE_GHCR_AUTHOR || 'BinaryNinja' }}
-    IMAGE_GHCR_USERNAME:        ${{ github.event.inputs.IMAGE_GHCR_USERNAME || 'BinaryNinja' }}
+    IMAGE_GHCR_USERNAME:              ${{ github.event.inputs.IMAGE_GHCR_USERNAME || 'BinaryNinja' }}
+    IMAGE_ALPINE_VERSION:             ${{ github.event.inputs.IMAGE_ALPINE_VERSION || '3.22' }}
+    DISCORD_BOT_NAME:                 'Europa'
+    DISCORD_BOT_AVATAR:               'https://i.imgur.com/UqwMom1.jpeg'
+    DISCORD_BOT_EMBED_AUTHOR_ICON:    'https://avatars.githubusercontent.com/u/200161462'
+    DISCORD_BOT_EMBED_THUMBNAIL:      'https://avatars.githubusercontent.com/u/200161462'
 
-    BOT_NAME_1:                 EuropaServ
+    BOT_NAME_1:                       EuropaServ
-    BOT_NAME_2:                 BinaryServ
+    BOT_NAME_2:                       BinaryServ
-    BOT_NAME_DEPENDABOT:        dependabot[bot]
+    BOT_NAME_DEPENDABOT:              dependabot[bot]
-    BOT_NAME_RENOVATE:          renovate[bot]
+    BOT_NAME_RENOVATE:                renovate[bot]
 
 # #
 #   Jobs
@@ -161,9 +181,11 @@ jobs:
     job-docker-release-tags-create:
         name: >-
             📦 Release › Create Tag
-      # runs-on: ubuntu-latest
+        runs-on: ubuntu-latest
-        runs-on: apollo-x64
+      # runs-on: apollo-x64
         timeout-minutes: 4
+        outputs:
+            package_version: ${{ steps.task_initialize_package_getversion.outputs.PACKAGE_VERSION }}
         permissions:
             contents: write
             packages: write
@@ -171,31 +193,149 @@ jobs:
             id-token: write
         steps:
 
-            # #
-            #   Release › Tags › Start
-            # #
-
-            - name: '🏳️ Start'
-              id: task_release_tags_start
-              run: |
-                  echo "Creating Tag"
-
             # #
             #   Release › Tags › Checkout
             # #
 
-            - name: '✅ Checkout'
+            - name: '☑️ Checkout'
-              id: task_release_tags_checkout
               uses: actions/checkout@v4
               with:
                   fetch-depth: 0
 
+            # #
+            #   Release › Tags › Job Information
+            # #
+
+            - name: >-
+                  🔄 Load Job
+              uses: qoomon/actions--context@v4
+              id: 'context'
+
+            # #
+            #   Release › Tags › Set › Package.json › Version
+            # #
+
+            - name: '👁️‍🗨️ Package Version › Set'
+              id: task_initialize_package_getversion
+              working-directory: ./tvapp2
+              run: |
+                  VER=$(cat package.json | jq -r '.version')
+                  echo "PACKAGE_VERSION=${VER}" >> $GITHUB_OUTPUT
+                  echo "PACKAGE_VERSION=${VER}" >> $GITHUB_ENV
+
+            # #
+            #   Initialize › Get › Package.json › Version
+            # #
+
+            - name: '👁️‍🗨️ Package Version › Get'
+              run: |
+                  echo "VERSION: ${{ steps.task_initialize_package_getversion.outputs.PACKAGE_VERSION }}"
+
+            # #
+            #   Release › Tags › Start
+            # #
+
+            - name: >-
+                  ✅ Start
+              run: |
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo " Starting Job ${{ steps.context.outputs.job_name }}"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+
+                  YEAR="$(date +'%Y')"
+                  echo "YEAR=${YEAR}" >> $GITHUB_ENV
+
+                  NOW="$(date +'%m-%d-%Y %H:%M:%S')"                                                #  02-25-2025 12:49:48
+                  echo "NOW=${NOW}" >> $GITHUB_ENV
+
+                  NOW_SHORT="$(date +'%m-%d-%Y')"                                                   #  02-25-2025
+                  echo "NOW_SHORT=${NOW_SHORT}" >> $GITHUB_ENV
+
+                  NOW_LONG="$(date +'%m-%d-%Y %H:%M')"                                              #  02-25-2025 12:49
+                  echo "NOW_LONG=${NOW_LONG}" >> $GITHUB_ENV
+
+                  NOW_DOCKER="$(date +'%Y%m%d')"                                                    #  20250225
+                  echo "NOW_DOCKER=${NOW_DOCKER}" >> $GITHUB_ENV
+
+                  NOW_DOCKER_TS="$(date -u +'%FT%T.%3NZ')"                                          #  2025-02-25T12:50:11.569Z
+                  echo "NOW_DOCKER_TS=${NOW_DOCKER_TS}" >> $GITHUB_ENV
+
+                  SHA1="$(git rev-parse HEAD)"                                                      #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1=${SHA1}" >> $GITHUB_ENV
+
+                  SHA1_GH="$(echo ${GITHUB_SHA})"                                                   #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1_GH=${SHA1_GH}" >> $GITHUB_ENV
+
+                  PKG_VER_1DIGIT="$(echo ${{ env.PACKAGE_VERSION }} | cut -d '.' -f1-1)"            #  3.22 > 3
+                  echo "PKG_VER_1DIGIT=${PKG_VER_1DIGIT}" >> $GITHUB_ENV
+
+                  PKG_VER_2DIGIT="$(echo ${{ env.PACKAGE_VERSION }} | cut -f2 -d ":" | cut -c1-3)"  #  3.22 > 3.2
+                  echo "PKG_VER_2DIGIT=${PKG_VER_2DIGIT}" >> $GITHUB_ENV
+
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  sudo apt -qq update
+                  sudo apt -qq install tree
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo " Runner .............. ${{ runner.name }}"
+                  echo " Workflow ............ ${{ github.workflow }} (#${{ github.workflow_ref }})"
+                  echo " Run Number .......... ${{ github.run_number }}"
+                  echo " Ref ................. ${{ github.ref }}"
+                  echo " Ref Name ............ ${{ github.ref_name }}"
+                  echo " Event Name .......... ${{ github.event_name }}"
+                  echo " Repo ................ ${{ github.repository }}"
+                  echo " Repo Owner .......... ${{ github.repository_owner }}"
+                  echo " Run ID .............. https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+                  echo " Triggered By ........ ${{ github.actor }}"
+                  echo " SHA 1 (GITHUB_SHA) .. ${GITHUB_SHA}"
+                  echo " SHA 2 (github.sha) .. ${{ github.sha }}"
+                  echo " SHA 3 (env.SHA1) .... ${SHA1}"
+                  echo " SHA 4 (env.SHA1_GH) . ${SHA1_GH}"
+                  echo " Workspace ........... ${{ github.workspace }}"
+                  echo " PWD ................. ${PWD}"
+                  echo " Job Name ............ ${{ steps.context.outputs.job_name }}"
+                  echo " Job ID .............. ${{ steps.context.outputs.job_id }}"
+                  echo " Job URL ............. ${{ steps.context.outputs.job_url }}"
+                  echo " Run ID .............. ${{ steps.context.outputs.run_id }}"
+                  echo " Run Attempt ......... ${{ steps.context.outputs.run_attempt }}"
+                  echo " Run Number .......... ${{ steps.context.outputs.run_number }}"
+                  echo " Run URL ............. ${{ steps.context.outputs.run_url }}"
+                  echo " Run Env ............. ${{ steps.context.outputs.environment }}"
+                  echo " Run Env URL ......... ${{ steps.context.outputs.environment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Deployment URL .. ${{ steps.context.outputs.deployment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Runner Name ..... ${{ steps.context.outputs.runner_name }}"
+                  echo " Run Runner ID ....... ${{ steps.context.outputs.runner_id }}"
+                  echo " Year ................ ${YEAR}"
+                  echo " Now ................. ${NOW}"
+                  echo " Now (Short) ......... ${NOW_SHORT}"
+                  echo " Now (Long) .......... ${NOW_LONG}"
+                  echo " Now (Docker) ........ ${NOW_DOCKER}"
+                  echo " Now (Docker TS) ..... ${NOW_DOCKER_TS}"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  tree -I node_modules -I .git
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+
             # #
             #   Release › Tags › Fix Permissions
             # #
 
             - name: '#️⃣ Manage Permissions'
-              id: task_release_tags_permissions
               run: |
                   find ./ -name 'run' -exec chmod 755 {} \;
                   WRONG_PERM=$(find ./  -path "./.git" -prune -o \( -name "run" -o -name "finish" -o -name "check" \) -not -perm -u=x,g=x,o=x -print)
@@ -210,18 +350,17 @@ jobs:
                   fi
 
             # #
-            #   Release › Tags › Create Tag
+            #   Tags › Tags › Create Tag
             #
             #   only called in dispatch mode
             # #
 
             - uses: rickstaa/action-create-tag@v1
-              id: task_release_tags_create
               if: ( github.event_name != 'workflow_dispatch' && inputs.DRY_RUN == false )
               with:
-                  tag: "${{ env.IMAGE_VERSION }}"
+                  tag: "${{ env.PACKAGE_VERSION }}"
                   tag_exists_error: false
-                  message: '${{ env.IMAGE_NAME }}-${{ env.IMAGE_VERSION }}'
+                  message: '${{ env.IMAGE_NAME }}-${{ env.PACKAGE_VERSION }}'
                   gpg_private_key: ${{ secrets.ADMINSERV_GPG_KEY_ASC }}
                   gpg_passphrase: ${{ secrets.ADMINSERV_GPG_PASSPHRASE }}
 
@@ -232,58 +371,151 @@ jobs:
     job-docker-release-github:
         name: >-
             📦 Release › Github
-      # runs-on: ubuntu-latest
+        runs-on: ubuntu-latest
-        runs-on: apollo-x64
+      # runs-on: apollo-x64
         timeout-minutes: 10
+        needs: [ job-docker-release-tags-create ]
         permissions:
             contents: write
             packages: write
             attestations: write
             id-token: write
-        needs: [ job-docker-release-tags-create ]
+        env:
+            PACKAGE_VERSION: ${{ needs.job-docker-release-tags-create.outputs.package_version }}
         steps:
 
             # #
-            #   Release › Github › Start › Amd64
+            #   Release › Github › Checkout
             # #
 
-            - name: '🏳️ Start'
+            - name: '☑️ Checkout'
-              id: task_release_gh_start
-              run: |
-                  echo "Starting Github docker release"
-
-            # #
-            #   Release › Github › Checkout › Amd64
-            # #
-
-            - name: '✅ Checkout'
-              id: task_release_gh_checkout
               uses: actions/checkout@v4
+              with:
+                  fetch-depth: 0
 
             # #
-            #   Release › Github › Get Timestamp
+            #   Release › Github › Job Information
             # #
 
-            - name: '🕛 Get Timestamp'
+            - name: >-
-              id: task_release_set_timestamp
+                  🔄 Load Job
+              uses: qoomon/actions--context@v4
+              id: 'context'
+
+            # #
+            #   Release › Github › Start
+            # #
+
+            - name: >-
+                  ✅ Start
+              run: |
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo " Starting Job ${{ steps.context.outputs.job_name }}"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+
+                  YEAR="$(date +'%Y')"
+                  echo "YEAR=${YEAR}" >> $GITHUB_ENV
+
+                  NOW="$(date +'%m-%d-%Y %H:%M:%S')"                                                #  02-25-2025 12:49:48
+                  echo "NOW=${NOW}" >> $GITHUB_ENV
+
+                  NOW_SHORT="$(date +'%m-%d-%Y')"                                                   #  02-25-2025
+                  echo "NOW_SHORT=${NOW_SHORT}" >> $GITHUB_ENV
+
+                  NOW_LONG="$(date +'%m-%d-%Y %H:%M')"                                              #  02-25-2025 12:49
+                  echo "NOW_LONG=${NOW_LONG}" >> $GITHUB_ENV
+
+                  NOW_DOCKER="$(date +'%Y%m%d')"                                                    #  20250225
+                  echo "NOW_DOCKER=${NOW_DOCKER}" >> $GITHUB_ENV
+
+                  NOW_DOCKER_TS="$(date -u +'%FT%T.%3NZ')"                                          #  2025-02-25T12:50:11.569Z
+                  echo "NOW_DOCKER_TS=${NOW_DOCKER_TS}" >> $GITHUB_ENV
+
+                  SHA1="$(git rev-parse HEAD)"                                                      #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1=${SHA1}" >> $GITHUB_ENV
+
+                  SHA1_GH="$(echo ${GITHUB_SHA})"                                                   #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1_GH=${SHA1_GH}" >> $GITHUB_ENV
+
+                  PKG_VER_1DIGIT="$(echo ${{ env.PACKAGE_VERSION }} | cut -d '.' -f1-1)"            #  3.22 > 3
+                  echo "PKG_VER_1DIGIT=${PKG_VER_1DIGIT}" >> $GITHUB_ENV
+
+                  PKG_VER_2DIGIT="$(echo ${{ env.PACKAGE_VERSION }} | cut -f2 -d ":" | cut -c1-3)"  #  3.22 > 3.2
+                  echo "PKG_VER_2DIGIT=${PKG_VER_2DIGIT}" >> $GITHUB_ENV
+
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  sudo apt -qq update
+                  sudo apt -qq install tree
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo " Runner .............. ${{ runner.name }}"
+                  echo " Workflow ............ ${{ github.workflow }} (#${{ github.workflow_ref }})"
+                  echo " Run Number .......... ${{ github.run_number }}"
+                  echo " Ref ................. ${{ github.ref }}"
+                  echo " Ref Name ............ ${{ github.ref_name }}"
+                  echo " Event Name .......... ${{ github.event_name }}"
+                  echo " Repo ................ ${{ github.repository }}"
+                  echo " Repo Owner .......... ${{ github.repository_owner }}"
+                  echo " Run ID .............. https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+                  echo " Triggered By ........ ${{ github.actor }}"
+                  echo " SHA 1 (GITHUB_SHA) .. ${GITHUB_SHA}"
+                  echo " SHA 2 (github.sha) .. ${{ github.sha }}"
+                  echo " SHA 3 (env.SHA1) .... ${SHA1}"
+                  echo " SHA 4 (env.SHA1_GH) . ${SHA1_GH}"
+                  echo " Workspace ........... ${{ github.workspace }}"
+                  echo " PWD ................. ${PWD}"
+                  echo " Job Name ............ ${{ steps.context.outputs.job_name }}"
+                  echo " Job ID .............. ${{ steps.context.outputs.job_id }}"
+                  echo " Job URL ............. ${{ steps.context.outputs.job_url }}"
+                  echo " Run ID .............. ${{ steps.context.outputs.run_id }}"
+                  echo " Run Attempt ......... ${{ steps.context.outputs.run_attempt }}"
+                  echo " Run Number .......... ${{ steps.context.outputs.run_number }}"
+                  echo " Run URL ............. ${{ steps.context.outputs.run_url }}"
+                  echo " Run Env ............. ${{ steps.context.outputs.environment }}"
+                  echo " Run Env URL ......... ${{ steps.context.outputs.environment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Deployment URL .. ${{ steps.context.outputs.deployment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Runner Name ..... ${{ steps.context.outputs.runner_name }}"
+                  echo " Run Runner ID ....... ${{ steps.context.outputs.runner_id }}"
+                  echo " Year ................ ${YEAR}"
+                  echo " Now ................. ${NOW}"
+                  echo " Now (Short) ......... ${NOW_SHORT}"
+                  echo " Now (Long) .......... ${NOW_LONG}"
+                  echo " Now (Docker) ........ ${NOW_DOCKER}"
+                  echo " Now (Docker TS) ..... ${NOW_DOCKER_TS}"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  tree -I node_modules -I .git
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+
+            # #
+            #   Release › Github › Set Vars
+            # #
+
+            - name: '🕛 Set Vars'
               run: |
-                  echo "IMAGE_VERSION_1DIGIT=`echo ${{ env.IMAGE_VERSION }} | cut -d '.' -f1-1`" >> ${GITHUB_ENV}                                                   #  1
-                  echo "IMAGE_VERSION_2DIGIT=`echo ${{ env.IMAGE_VERSION }} | cut -d '.' -f1-2`" >> ${GITHUB_ENV}                                                   #  1.0
                   echo "REGISTRY_REPO_ORG_AUTHOR_LC=`echo ${{ env.IMAGE_GHCR_AUTHOR }}/${{ env.IMAGE_NAME }} | tr '[:upper:]' '[:lower:]'`" >> ${GITHUB_ENV}        #  thebinaryninja/tvapp2
                   echo "REGISTRY_REPO_AUTHOR_LC=`echo ${{ env.IMAGE_GHCR_AUTHOR }} | tr '[:upper:]' '[:lower:]'`" >> ${GITHUB_ENV}                                  #  thebinaryninja
-                  echo "DOCKER_SHA=${GITHUB_SHA}" >> $GITHUB_ENV                                                                                                    #  71fad013cfce9116ec62779e4a7e627fe4c33627
-                  echo "NOW=$(date +'%m-%d-%Y %H:%M:%S')" >> $GITHUB_ENV                                                                                            #  02-25-2025 12:49:48
-                  echo "NOW_SHORT=$(date +'%m-%d-%Y')" >> $GITHUB_ENV                                                                                               #  02-25-2025
-                  echo "NOW_LONG=$(date +'%m-%d-%Y %H:%M')" >> $GITHUB_ENV                                                                                          #  02-25-2025 12:49
-                  echo "NOW_DOCKER_LABEL=$(date +'%Y%m%d')" >> $GITHUB_ENV                                                                                          #  20250225
-                  echo "NOW_DOCKER_TS=$(date -u +'%FT%T.%3NZ')" >> $GITHUB_ENV                                                                                      #  2025-02-25T12:50:11.569Z
 
             # #
             #   Release › Github › Install Dependencies
             # #
 
             - name: '📦 Install Dependencies'
-              id: task_release_gh_dependencies
               run:
                   sudo apt-get install -qq dos2unix
 
@@ -292,7 +524,6 @@ jobs:
             # #
 
             - name: '🔐 Apply dos2unix'
-              id: task_release_gh_dos2unix
               run: |
                   echo "⚠️⚠️⚠️ Running DOS2UNIX ⚠️⚠️⚠️"
                   find ./ \( -path "./.git" -o -path "./docs" -o -path "./.github" -o -path "*.png" -o -path "*.jpg" \) -prune -o -name '*' -print | xargs dos2unix --
@@ -303,7 +534,6 @@ jobs:
             # #
 
             - name: '#️⃣ Manage Permissions'
-              id: task_release_gh_permissions
               run: |
                   find ./ -name 'run' -exec chmod 755 {} \;
                   WRONG_PERM=$(find ./  -path "./.git" -prune -o \( -name "run" -o -name "finish" -o -name "check" \) -not -perm -u=x,g=x,o=x -print)
@@ -322,7 +552,6 @@ jobs:
             # #
 
             - name: '⚙️ Set up QEMU'
-              id: task_release_gh_qemu
               uses: docker/setup-qemu-action@v3
 
             # #
@@ -330,7 +559,6 @@ jobs:
             # #
 
             - name: '⚙️ Setup Buildx'
-              id: task_release_gh_buildx
               uses: docker/setup-buildx-action@v3
               with:
                   version: latest
@@ -341,7 +569,6 @@ jobs:
             # #
 
             - name: '⚙️ Login to Github'
-              id: task_release_gh_registry
               uses: docker/login-action@v3
               with:
                   registry: ghcr.io
@@ -364,11 +591,12 @@ jobs:
 
                     const { promises: fs } = require('fs')
 
-                    const main = async () => {
+                    const main = async () =>
-                      const path = "README.md"
+                    {
-                      let content = await fs.readFile(path, 'utf8')
+                        const path = "README.md"
+                        let content = await fs.readFile(path, 'utf8')
 
-                      core.setOutput('content', content)
+                        core.setOutput('content', content)
                     }
 
                     main().catch(err => core.setFailed(err.message))
@@ -394,13 +622,13 @@ jobs:
                       type=ref,enable=${{ github.event_name == 'pull_request' || github.event_name == 'push' }},priority=600,prefix=,suffix=,event=tag
 
                       #  tag            add 1.0.0             ( dispatch only + no dev )
-                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=450,prefix=,suffix=,value=${{ env.IMAGE_VERSION }}
+                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=450,prefix=,suffix=,value=${{ env.PACKAGE_VERSION }}
 
                       #  tag            add 1.0               ( dispatch only + no dev )
-                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=425,prefix=,suffix=,value=${{ env.IMAGE_VERSION_2DIGIT }}
+                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=425,prefix=,suffix=,value=${{ env.PKG_VER_2DIGIT }}
 
                       #  tag            add 1                 ( dispatch only + no dev )
-                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=400,prefix=,suffix=,value=${{ env.IMAGE_VERSION_1DIGIT }}
+                      type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == false }},priority=400,prefix=,suffix=,value=${{ env.PKG_VER_1DIGIT }}
 
                       #  tag            add development       ( dispatch only + only dev )
                       type=raw,enable=${{ github.event_name == 'workflow_dispatch' && inputs.DEV_RELEASE == true }},priority=300,prefix=,suffix=,value=development
@@ -410,25 +638,33 @@ jobs:
                   flavor: |
                       latest=false
                   labels: |
+                      org.opencontainers.image.description=TVApp2
                       org.opencontainers.image.created=${{ env.NOW_DOCKER_TS }}
-                      org.opencontainers.image.version=${{ env.IMAGE_VERSION }}
+                      org.opencontainers.image.version=${{ env.PACKAGE_VERSION }}
                       org.opencontainers.image.licenses=MIT
-                      org.opencontainers.image.revision=${{ github.sha }}
+                      org.opencontainers.image.revision=${{ env.SHA1 }}
                       org.opencontainers.image.vendor=${{ env.REGISTRY_REPO_AUTHOR_LC }}
                       org.opencontainers.image.ref.name=${{ github.ref_name }}
                       org.opencontainers.image.development=${{ inputs.DEV_RELEASE == true && 'true' || 'false' }}
-                      org.opencontainers.image.registry=github
+                      org.opencontainers.image.registry=${{ env.IMAGE_REGISTRY }}
-                      org.tvapp2.image.build-version="Version:- ${{ env.IMAGE_VERSION }} Date:- ${{ env.NOW_DOCKER_LABEL }}"
+                      org.tvapp2.image.build-version="Version: ${{ env.PACKAGE_VERSION }} Date: ${{ env.NOW_DOCKER }}"
-                  annotations: |
+                      org.tvapp2.image.build-version-alpine=${{ env.IMAGE_ALPINE_VERSION }}
+                      org.tvapp2.image.build-release="${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}"
+                      org.tvapp2.image.build-sha1=${{ env.SHA1 }}
+                  annotations: |-
+                      org.opencontainers.image.description=TVApp2
                       org.opencontainers.image.created=${{ env.NOW_DOCKER_TS }}
-                      org.opencontainers.image.version=${{ env.IMAGE_VERSION }}
+                      org.opencontainers.image.version=${{ env.PACKAGE_VERSION }}
                       org.opencontainers.image.licenses=MIT
-                      org.opencontainers.image.revision=${{ github.sha }}
+                      org.opencontainers.image.revision=${{ env.SHA1 }}
                       org.opencontainers.image.vendor=${{ env.REGISTRY_REPO_AUTHOR_LC }}
                       org.opencontainers.image.ref.name=${{ github.ref_name }}
                       org.opencontainers.image.development=${{ inputs.DEV_RELEASE == true && 'true' || 'false' }}
-                      org.opencontainers.image.registry=github
+                      org.opencontainers.image.registry=${{ env.IMAGE_REGISTRY }}
-                      org.tvapp2.image.build-version="Version:- ${{ env.IMAGE_VERSION }} Date:- ${{ env.NOW_DOCKER_LABEL }}"
+                      org.tvapp2.image.build-version="Version: ${{ env.PACKAGE_VERSION }} Date: ${{ env.NOW_DOCKER }}"
+                      org.tvapp2.image.build-version-alpine=${{ env.IMAGE_ALPINE_VERSION }}
+                      org.tvapp2.image.build-release="${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}"
+                      org.tvapp2.image.build-sha1=${{ env.SHA1 }}
 
             # #
             #   Release › Github › Build and Push › Amd64
@@ -440,31 +676,46 @@ jobs:
               if: ( github.event_name == 'workflow_dispatch' && inputs.DRY_RUN == false ) || ( github.event_name == 'push' )
               with:
                   allow: |
-                    network.host
+                      network.host
                   network: host
                   context: .
                   file: Dockerfile
                   platforms: linux/amd64
+                  provenance: false
+                  sbom: false
                   push: ${{ github.event_name != 'pull_request' }}
                   labels: ${{ steps.task_release_gh_meta.outputs.labels }}
                   tags: |
                       ${{ steps.task_release_gh_meta.outputs.tags }}
-                  annotations: |
-                      ${{ steps.task_release_gh_meta.outputs.annotations }}
-                  provenance: false
-                  sbom: false
                   build-args: |-
                       ARCH=amd64
                       RELEASE=${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}
-                      VERSION=${{ env.IMAGE_VERSION }}
+                      VERSION=${{ env.PACKAGE_VERSION }}
-                      BUILDDATE=${{ env.NOW_DOCKER_LABEL }}
+                      BUILDDATE=${{ env.NOW_DOCKER }}
+                      GIT_SHA1=${{ env.SHA1 }}
+                      ALPINE_VERSION=${{ env.IMAGE_ALPINE_VERSION }}
+                  annotations: |-
+                      org.opencontainers.image.description=TVApp2
+                      org.opencontainers.image.created=${{ env.NOW_DOCKER_TS }}
+                      org.opencontainers.image.version=${{ env.PACKAGE_VERSION }}
+                      org.opencontainers.image.licenses=MIT
+                      org.opencontainers.image.architecture=amd64
+                      org.opencontainers.image.revision=${{ env.SHA1 }}
+                      org.opencontainers.image.vendor=${{ env.REGISTRY_REPO_AUTHOR_LC }}
+                      org.opencontainers.image.ref.name=${{ github.ref_name }}
+                      org.opencontainers.image.development=${{ inputs.DEV_RELEASE == true && 'true' || 'false' }}
+                      org.opencontainers.image.registry=${{ env.IMAGE_REGISTRY }}
+                      org.tvapp2.image.build-version="Version: ${{ env.PACKAGE_VERSION }} Date: ${{ env.NOW_DOCKER }}"
+                      org.tvapp2.image.build-version-alpine=${{ env.IMAGE_ALPINE_VERSION }}
+                      org.tvapp2.image.build-architecture=amd64
+                      org.tvapp2.image.build-release="${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}"
+                      org.tvapp2.image.build-sha1=${{ env.SHA1 }}
 
             # #
             #   Release › Github › Export Digest › Amd64
             # #
 
             - name: '📄 Export Digest (linux/amd64)'
-              id: task_release_gh_digest_export_amd64
               if: ( github.event_name == 'workflow_dispatch' && inputs.DRY_RUN == false ) || ( github.event_name == 'push' )
               run: |
                   mkdir -p /tmp/build-digest-amd64
@@ -478,7 +729,6 @@ jobs:
             # #
 
             - name: '🔼 Upload Digest (linux/amd64)'
-              id: task_release_gh_digest_upload_amd64
               uses: actions/upload-artifact@v4
               if: ( github.event_name == 'workflow_dispatch' && inputs.DRY_RUN == false ) || ( github.event_name == 'push' )
               with:
@@ -497,31 +747,46 @@ jobs:
               if: ( github.event_name == 'workflow_dispatch' && inputs.DRY_RUN == false ) || ( github.event_name == 'push' )
               with:
                   allow: |
-                    network.host
+                      network.host
                   network: host
                   context: .
                   file: Dockerfile
                   platforms: linux/arm64
+                  provenance: false
+                  sbom: false
                   push: ${{ github.event_name != 'pull_request' }}
                   labels: ${{ steps.task_release_gh_meta.outputs.labels }}
                   tags: |
                       ${{ steps.task_release_gh_meta.outputs.tags }}
-                  annotations: |
-                      ${{ steps.task_release_gh_meta.outputs.annotations }}
-                  provenance: false
-                  sbom: false
                   build-args: |-
                       ARCH=arm64
                       RELEASE=${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}
-                      VERSION=${{ env.IMAGE_VERSION }}
+                      VERSION=${{ env.PACKAGE_VERSION }}
-                      BUILDDATE=${{ env.NOW_DOCKER_LABEL }}
+                      BUILDDATE=${{ env.NOW_DOCKER }}
+                      GIT_SHA1=${{ env.SHA1 }}
+                      ALPINE_VERSION=${{ env.IMAGE_ALPINE_VERSION }}
+                  annotations: |-
+                      org.opencontainers.image.description=TVApp2
+                      org.opencontainers.image.created=${{ env.NOW_DOCKER_TS }}
+                      org.opencontainers.image.version=${{ env.PACKAGE_VERSION }}
+                      org.opencontainers.image.licenses=MIT
+                      org.opencontainers.image.architecture=arm64
+                      org.opencontainers.image.revision=${{ env.SHA1 }}
+                      org.opencontainers.image.vendor=${{ env.REGISTRY_REPO_AUTHOR_LC }}
+                      org.opencontainers.image.ref.name=${{ github.ref_name }}
+                      org.opencontainers.image.development=${{ inputs.DEV_RELEASE == true && 'true' || 'false' }}
+                      org.opencontainers.image.registry=${{ env.IMAGE_REGISTRY }}
+                      org.tvapp2.image.build-version="Version: ${{ env.PACKAGE_VERSION }} Date: ${{ env.NOW_DOCKER }}"
+                      org.tvapp2.image.build-version-alpine=${{ env.IMAGE_ALPINE_VERSION }}
+                      org.tvapp2.image.build-architecture=arm64
+                      org.tvapp2.image.build-release="${{ inputs.DEV_RELEASE == true && 'development' || 'stable' }}"
+                      org.tvapp2.image.build-sha1=${{ env.SHA1 }}
 
             # #
             #   Release › Github › Export Digest › Arm64
             # #
 
             - name: '📄 Export Digest (linux/arm64)'
-              id: task_release_gh_digest_export_arm64
               if: ( github.event_name == 'workflow_dispatch' && inputs.DRY_RUN == false ) || ( github.event_name == 'push' )
               run: |
                   mkdir -p /tmp/build-digest-arm64
@@ -535,7 +800,6 @@ jobs:
             # #
 
             - name: '🔼 Upload Digest (linux/arm64)'
-              id: task_release_gh_digest_upload_arm64
               uses: actions/upload-artifact@v4
               if: ( github.event_name == 'workflow_dispatch' && inputs.DRY_RUN == false ) || ( github.event_name == 'push' )
               with:
@@ -544,12 +808,69 @@ jobs:
                   if-no-files-found: error
                   retention-days: 10
 
+            # #
+            #   Release › Github › Checkpoint
+            # #
+
+            - name: '⚠️ Checkpoint'
+              run: |
+                  echo "‎"
+                  echo "---- [ GITHUB ] ----------------------------------------------------------------------------------------"
+                  echo "github.actor.............................. ${{ github.actor }}"
+                  echo "github.ref ............................... ${{ github.ref }}"
+                  echo "github.ref_name .......................... ${{ github.ref_name }}"
+                  echo "github.event_name ........................ ${{ github.event_name }}"
+                  echo "github.repository_owner .................. ${{ github.repository_owner }}"
+                  echo "github.repository ........................ ${{ github.repository }}"
+                  echo "github.sha ............................... ${{ github.sha }}"
+                  echo "‎"
+                  echo "---- [ INPUTS ] ----------------------------------------------------------------------------------------"
+                  echo "inputs.IMAGE_NAME ........................ ${{ inputs.IMAGE_NAME }}"
+                  echo "inputs.IMAGE_GHCR_AUTHOR ................. ${{ inputs.IMAGE_GHCR_AUTHOR }}"
+                  echo "inputs.IMAGE_GHCR_USERNAME ............... ${{ inputs.IMAGE_GHCR_USERNAME }}"
+                  echo "inputs.DEV_RELEASE ....................... ${{ inputs.DEV_RELEASE }}"
+                  echo "inputs.DRY_RUN ........................... ${{ inputs.DRY_RUN }}"
+                  echo "‎"
+                  echo "---- [ ENV ] -------------------------------------------------------------------------------------------"
+                  echo "env.IMAGE_NAME ........................... ${{ env.IMAGE_NAME }}"
+                  echo "env.PACKAGE_VERSION ...................... ${{ env.PACKAGE_VERSION }}"
+                  echo "env.PKG_VER_1DIGIT ....................... ${{ env.PKG_VER_1DIGIT }}"
+                  echo "env.PKG_VER_2DIGIT ....................... ${{ env.PKG_VER_2DIGIT }}"
+                  echo "env.IMAGE_GHCR_AUTHOR .................... ${{ env.IMAGE_GHCR_AUTHOR }}"
+                  echo "env.IMAGE_GHCR_USERNAME .................. ${{ env.IMAGE_GHCR_USERNAME }}"
+                  echo "env.NOW .................................. ${{ env.NOW }}"
+                  echo "env.NOW_SHORT ............................ ${{ env.NOW_SHORT }}"
+                  echo "env.NOW_LONG ............................. ${{ env.NOW_LONG }}"
+                  echo "env.NOW_DOCKER ........................... ${{ env.NOW_DOCKER }}"
+                  echo "env.NOW_DOCKER_TS ........................ ${{ env.NOW_DOCKER_TS }}"
+                  echo "env.REGISTRY_REPO_ORG_AUTHOR_LC .......... ${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}"
+                  echo "env.REGISTRY_REPO_AUTHOR_LC .............. ${{ env.REGISTRY_REPO_AUTHOR_LC }}"
+                  echo " SHA 1 (GITHUB_SHA) ...................... ${GITHUB_SHA}"
+                  echo " SHA 2 (github.sha) ...................... ${{ github.sha }}"
+                  echo " SHA 3 (env.SHA1) ........................ ${{ env.SHA1 }}"
+                  echo " SHA 4 (env.SHA1_GH) ..................... ${{ env.SHA1_GH }}"
+                  echo "‎"
+                  echo "---- [ DOCKER IMAGES ] ---------------------------------------------------------------------------------"
+                  echo "registry ................................. Github GHCR"
+                  echo "tags ..................................... ${{ steps.task_release_gh_meta.outputs.tags }}"
+                  echo "labels ................................... ${{ steps.task_release_gh_meta.outputs.labels }}"
+                  echo "digest ................................... ${{ steps.task_release_gh_push_amd64.outputs.digest }}"
+                  echo "‎"
+                  echo "(release) tags ........................... ${{ steps.task_release_gh_meta.outputs.tags }}"
+                  echo "(release) labels ......................... ${{ steps.task_release_gh_meta.outputs.labels }}"
+                  echo "‎"
+                  echo "---- [ DOCKER DIGESTS ] --------------------------------------------------------------------------------"
+                  echo "docker image id (amd64) .................. ${{ steps.task_release_gh_push_amd64.outputs.imageid }}"
+                  echo "docker digest (amd64) .................... ${{ steps.task_release_gh_push_amd64.outputs.digest }}"
+                  echo "docker image id (arm64) .................. ${{ steps.task_release_gh_push_arm64.outputs.imageid }}"
+                  echo "docker digest (arm64) .................... ${{ steps.task_release_gh_push_arm64.outputs.digest }}"
+                  echo "‎"
+
             # #
             #   Release › Github › Push Manifest
             # #
 
             - name: '📦 Push Manifest'
-              id: task_release_gh_manifest
               uses: int128/docker-manifest-create-action@v2
               with:
                   push: ${{ !inputs.DRY_RUN }}
@@ -561,68 +882,11 @@ jobs:
                   index-annotations: |
                       ${{ steps.task_release_gh_meta.outputs.labels }}
 
-            # #
-            #   Release › Github › Checkpoint
-            # #
-
-            - name: '⚠️ Checkpoint'
-              id: task_release_gh_checkpoint
-              run: |
-                  echo ""
-                  echo "[ GITHUB ] ---------------------------------------------------------------------------------------------"
-                  echo "github.actor.............................. ${{ github.actor }}"
-                  echo "github.ref ............................... ${{ github.ref }}"
-                  echo "github.ref_name .......................... ${{ github.ref_name }}"
-                  echo "github.event_name ........................ ${{ github.event_name }}"
-                  echo "github.repository_owner .................. ${{ github.repository_owner }}"
-                  echo "github.repository ........................ ${{ github.repository }}"
-                  echo ""
-                  echo "[ INPUTS ] ---------------------------------------------------------------------------------------------"
-                  echo "inputs.IMAGE_NAME ........................ ${{ inputs.IMAGE_NAME }}"
-                  echo "inputs.IMAGE_VERSION ..................... ${{ inputs.IMAGE_VERSION }}"
-                  echo "inputs.IMAGE_GHCR_AUTHOR ................. ${{ inputs.IMAGE_GHCR_AUTHOR }}"
-                  echo "inputs.IMAGE_GHCR_USERNAME ............... ${{ inputs.IMAGE_GHCR_USERNAME }}"
-                  echo "inputs.DEV_RELEASE ....................... ${{ inputs.DEV_RELEASE }}"
-                  echo "inputs.DRY_RUN ........................... ${{ inputs.DRY_RUN }}"
-                  echo ""
-                  echo "[ ENV ] ------------------------------------------------------------------------------------------------"
-                  echo "env.IMAGE_NAME ........................... ${{ env.IMAGE_NAME }}"
-                  echo "env.IMAGE_VERSION ........................ ${{ env.IMAGE_VERSION }}"
-                  echo "env.IMAGE_VERSION_1DIGIT ................. ${{ env.IMAGE_VERSION_1DIGIT }}"
-                  echo "env.IMAGE_VERSION_2DIGIT ................. ${{ env.IMAGE_VERSION_2DIGIT }}"
-                  echo "env.IMAGE_GHCR_AUTHOR .................... ${{ env.IMAGE_GHCR_AUTHOR }}"
-                  echo "env.IMAGE_GHCR_USERNAME .................. ${{ env.IMAGE_GHCR_USERNAME }}"
-                  echo "env.NOW .................................. ${{ env.NOW }}"
-                  echo "env.NOW_SHORT ............................ ${{ env.NOW_SHORT }}"
-                  echo "env.NOW_LONG ............................. ${{ env.NOW_LONG }}"
-                  echo "env.NOW_DOCKER_LABEL ..................... ${{ env.NOW_DOCKER_LABEL }}"
-                  echo "env.NOW_DOCKER_TS ........................ ${{ env.NOW_DOCKER_TS }}"
-                  echo "env.DOCKER_IMAGE ......................... ${{ env.DOCKER_IMAGE }}"
-                  echo "env.REGISTRY_REPO_ORG_AUTHOR_LC .......... ${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}"
-                  echo "env.REGISTRY_REPO_AUTHOR_LC .............. ${{ env.REGISTRY_REPO_AUTHOR_LC }}"
-                  echo "env.DOCKER_SHA ........................... ${{ env.DOCKER_SHA }}"
-                  echo ""
-                  echo "[ DOCKER IMAGES ] --------------------------------------------------------------------------------------"
-                  echo "registry ................................. Github GHCR"
-                  echo "tags ..................................... ${{ steps.task_release_gh_meta.outputs.tags }}"
-                  echo "labels ................................... ${{ steps.task_release_gh_meta.outputs.labels }}"
-                  echo "digest ................................... ${{ steps.task_release_gh_push_amd64.outputs.digest }}"
-                  echo ""
-                  echo "(release) tags ........................... ${{ steps.task_release_gh_meta.outputs.tags }}"
-                  echo "(release) labels ......................... ${{ steps.task_release_gh_meta.outputs.labels }}"
-                  echo ""
-                  echo "[ DOCKER DIGESTS ] -------------------------------------------------------------------------------------"
-                  echo "docker image id (amd64) .................. ${{ steps.task_release_gh_push_amd64.outputs.imageid }}"
-                  echo "docker digest (amd64) .................... ${{ steps.task_release_gh_push_amd64.outputs.digest }}"
-                  echo "docker image id (arm64) .................. ${{ steps.task_release_gh_push_arm64.outputs.imageid }}"
-                  echo "docker digest (arm64) .................... ${{ steps.task_release_gh_push_arm64.outputs.digest }}"
-
             # #
             #   Release › Github › Get Weekly Commits
             # #
 
             - name: '🕛 Get Weekly Commit List'
-              id: task_release_set_weekly_commit_list
               run: |
                   echo 'WEEKLY_COMMITS<<EOF' >> $GITHUB_ENV
                   git log --format="[\`%h\`](${{ github.server_url }}/${{ github.repository }}/commit/%H) %s - %an" --since=7.days >> $GITHUB_ENV
@@ -636,27 +900,27 @@ jobs:
               uses: tsickert/discord-webhook@v7.0.0
               if: success()
               with:
-                  username: 'Io'
+                  username: ${{ env.DISCORD_BOT_NAME }}
-                  avatar-url: 'https://i.imgur.com/8BVDkla.jpg'
+                  avatar-url: ${{ env.DISCORD_BOT_AVATAR }}
                   webhook-url: ${{ secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_RELEASES }}
                   embed-title: "⚙️ ${{ github.workflow_ref }}"
                   embed-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-thumbnail-url: 'https://i.imgur.com/zDIzE8T.jpg'
+                  embed-thumbnail-url: ${{ env.DISCORD_BOT_EMBED_THUMBNAIL }}
                   embed-description: |
-                      ### 📦 ᲼Deploy (Github) ᲼${{ job.status == 'success' && '✅' || '❌' }}᲼ › `${{ env.IMAGE_NAME }}-${{ env.IMAGE_VERSION }}${{ inputs.DEV_RELEASE == true && '-development' || '' }}`
+                      ### 📦 ᲼Deploy (Github) ᲼${{ job.status == 'success' && '✅' || '❌' }}᲼ › `${{ env.IMAGE_NAME }}-${{ env.PACKAGE_VERSION }}${{ inputs.DEV_RELEASE == true && '-development' || '' }}`
                       ${{ inputs.DEV_RELEASE == true && '### ⚠️⚠️ Development / Pre-release ⚠️⚠️' || '' }}
 
                       A new version of the docker container `${{ env.IMAGE_NAME }}` has been released from Github to Github GHCR. The image is available at:
                       - https://github.com/${{ github.repository }}/pkgs/container/${{ env.IMAGE_NAME }}
 
-                      - Version: `${{ env.IMAGE_VERSION }}`
+                      - Version: `${{ env.PACKAGE_VERSION }}`
                       - Release Type: `${{ inputs.DEV_RELEASE == true && '⚠️⚠️ Development / Pre-release ⚠️⚠️' || 'Stable' }}`
-                      - Pull: `docker pull ghcr.io/${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}:${{ inputs.DEV_RELEASE == true && 'development' || env.IMAGE_VERSION }}`
+                      - Pull: `docker pull ghcr.io/${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}:${{ inputs.DEV_RELEASE == true && 'development' || env.PACKAGE_VERSION }}`
                       - Pull (amd64): `docker pull ghcr.io/${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}@${{ steps.task_release_gh_push_amd64.outputs.digest }}`
                       - Pull (arm64): `docker pull ghcr.io/${{ env.REGISTRY_REPO_ORG_AUTHOR_LC }}@${{ steps.task_release_gh_push_arm64.outputs.digest }}`
                       - Dry Run: `${{ inputs.DRY_RUN }}`
                       - Source: `Github` https://github.com/${{ github.repository }}
-                      - Docker Image: `${{ env.IMAGE_NAME }}-${{ env.IMAGE_VERSION }}${{ inputs.DEV_RELEASE == true && '-development' || '' }}`
+                      - Docker Image: `${{ env.IMAGE_NAME }}-${{ env.PACKAGE_VERSION }}${{ inputs.DEV_RELEASE == true && '-development' || '' }}`
                       - Branch: `${{ github.ref_name }}`
                       - Workflow: `${{ github.workflow }} (#${{github.run_number}})`
                       - Runner: `${{ runner.name }}`
@@ -681,7 +945,7 @@ jobs:
                   embed-timestamp: "${{ env.NOW_LONG }}"
                   embed-author-name: "${{ github.repository_owner }}"
                   embed-author-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-author-icon-url: "https://avatars.githubusercontent.com/u/200161462"
+                  embed-author-icon-url: ${{ env.DISCORD_BOT_EMBED_AUTHOR_ICON }}
 
     # #
     #   Job › Docker Release › Cleanup
@@ -690,42 +954,41 @@ jobs:
     job-docker-release-cleanup:
         name: >-
             🧹 Release › Cleanup
-      # runs-on: ubuntu-latest
+        runs-on: ubuntu-latest
-        runs-on: apollo-x64
+      # runs-on: apollo-x64
         timeout-minutes: 5
+        needs: [ job-docker-release-tags-create, job-docker-release-github ]
         permissions:
             contents: write
             packages: write
             attestations: write
             id-token: write
-        needs: [ job-docker-release-tags-create, job-docker-release-github ]
+        env:
+            PACKAGE_VERSION: ${{ needs.job-docker-release-tags-create.outputs.package_version }}
         steps:
 
-            # #
-            #   Release › Cleanup
-            # #
-
-            - name: '🏳️ Start'
-              id: task_cleanup_gh_start
-              run: |
-                  echo "Cleaning up untagged docker images"
-
             # #
             #   Release › Cleanup › Checkout
             # #
 
             - name: '✅ Checkout'
-              id: task_cleanup_gh_checkout
               uses: actions/checkout@v4
               with:
-                fetch-depth: 0
+                  fetch-depth: 0
+
+            # #
+            #   Release › Cleanup › Print Version Debug
+            # #
+
+            - name: '🪪 Get Package Version'
+              run: |
+                  echo "VERSION: ${{ env.PACKAGE_VERSION }}"
 
             # #
             #   Release › Cleanup › Clean Untagged Images
             # #
 
             - name: '🧹 Clean Untagged Images'
-              id: task_cleanup_clean
               uses: quartx-analytics/ghcr-cleaner@v1
               with:
                   owner-type: org

.github/workflows/documentation.yml

@@ -15,15 +15,20 @@
 #                       secrets.PYPI_API_TOKEN                                      self Pypi API token (production site) - https://pypi.org/
 #                       secrets.PYPI_API_TEST_TOKEN                                 self Pypi API token (test site) - https://test.pypi.org/
 #                       secrets.SELF_DOCKERHUB_TOKEN                                self Dockerhub token
-#                       secrets.ORG_BINARYNINJA_TOKEN                               org github personal access token (fine-grained)
+#                       secrets.CODECOV_TOKEN                                       codecov upload token for nodejs projects
-#                       secrets.ORG_BINARYNINJA_TOKEN_CL                            org github personal access token (classic)
+#                       secrets.MAXMIND_GELITE_TOKEN                                maxmind API token
-#                       secrets.ORG_BINARYNINJA_DOCKERHUB_TOKEN                     org dockerhub secret
+#                       secrets.CF_ACCOUNT_ID                                       cloudflare account id
-#                       secrets.ORG_BINARYNINJA_GITEA_TOKEN                         org gitea personal access token (classic) with package:write permission
+#                       secrets.CF_ACCOUNT_TOKEN                                    cloudflare account token
-#                       secrets.BINARYSERV_GPG_KEY_ASC                              bot gpg private key (armored) | BEGIN PGP PRIVATE KEY BLOCK
+#                       secrets.ORG_TOKEN                                           org github personal access token (fine-grained)
-#                       secrets.BINARYSERV_GPG_PASSPHRASE                           bot gpg private key passphrase
+#                       secrets.ORG_TOKEN_CL                                        org github personal access token (classic)
-#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_RELEASES         discord webhook to report release notifications from github to discord
+#                       secrets.ORG_DOCKERHUB_TOKEN                                 org dockerhub secret
-#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_WORKFLOWS        discord webhook to report workflow notifications from github to discord
+#                       secrets.ORG_GITEA_TOKEN                                     org gitea personal access token (classic) with package:write permission
-#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_UPDATES          discord webhook to report activity notifications from github to discord
+#                       secrets.BOT_GPG_KEY_ASC                                     bot gpg private key (armored) | BEGIN PGP PRIVATE KEY BLOCK
+#                       secrets.BOT_GPG_KEY_B64                                     bot gpg private key (binary) converted to base64
+#                       secrets.BOT_GPG_PASSPHRASE                                  bot gpg private key passphrase
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_RELEASES                discord webhook to report release notifications from github to discord
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_WORKFLOWS               discord webhook to report workflow notifications from github to discord
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_UPDATES                 discord webhook to report activity notifications from github to discord
 #
 #   @local              these workflows can be tested locally through the use of `act`
 #                           https://github.com/nektos/act
@@ -35,8 +40,8 @@
 #                           act -W .github/workflows/documentation.yml -s TOKEN_CL=XXXXXXXXXX --pull=false
 # #
 
-name: "📒 Docs › Build"
+name: '📒 Docs › Build'
-run-name: "📒 Docs › Build"
+run-name: '📒 Docs › Build'
 
 # #
 #   triggers
@@ -86,26 +91,78 @@ on:
                 default:        './docs/site'
                 type:           string
 
+            # #
+            #   Discord Bot › Name
+            #
+            #   The discord bot name
+            # #
+
+            DISCORD_BOT_NAME:
+                description:    '🤖 Bot Name'
+                required:       true
+                default:        'Europa'
+                type:           string
+
+            # #
+            #   Discord Bot › Avatar
+            #
+            #   The discord bot avatar to show; let's use some weird picture
+            # #
+
+            DISCORD_BOT_AVATAR:
+                description:    '🤖 Avatar URL'
+                required:       true
+                default:        'https://i.imgur.com/UqwMom1.jpeg'
+                type:           string
+
+            # #
+            #   Discord Bot › Author Icon URL
+            #
+            #   A small picture shown to the top-right of each post
+            # #
+
+            DISCORD_BOT_EMBED_AUTHOR_ICON:
+                description:    '🤖 Embed Author Icon'
+                required:       true
+                default:        'https://avatars.githubusercontent.com/u/200161462'
+                type:           string
+
+            # #
+            #   Discord Bot › Thumbnail URL
+            #
+            #   A small picture shown to the top-right of each post
+            # #
+
+            DISCORD_BOT_EMBED_THUMBNAIL:
+                description:    '🤖 Embed Thumbnail URL'
+                required:       true
+                default:        'https://avatars.githubusercontent.com/u/200161462'
+                type:           string
+
     # #
     #   Trigger › Cron
     #
     #   update documentation every X hours
     # #
 
-    schedule:
+    # schedule:
-        - cron: "0 */12 * * *"
+    #   - cron: "0 */12 * * *"
 
 # #
 #   environment variables
 # #
 
 env:
-    WORKING_DIR:                ${{ github.event.inputs.WORKING_DIR || './docs/site' }}
+    WORKING_DIR:                      ${{ github.event.inputs.WORKING_DIR || './docs/site' }}
-    ASSIGN_USER:                Aetherinox
+    DISCORD_BOT_NAME:                 ${{ github.event.inputs.DISCORD_BOT_NAME || 'Europa' }}
-    BOT_NAME_1:                 EuropaServ
+    DISCORD_BOT_AVATAR:               ${{ github.event.inputs.DISCORD_BOT_AVATAR || 'https://i.imgur.com/UqwMom1.jpeg' }}
-    BOT_NAME_2:                 BinaryServ
+    DISCORD_BOT_EMBED_AUTHOR_ICON:    ${{ github.event.inputs.DISCORD_BOT_EMBED_AUTHOR_ICON || 'https://avatars.githubusercontent.com/u/200161462' }}
-    BOT_NAME_DEPENDABOT:        dependabot[bot]
+    DISCORD_BOT_EMBED_THUMBNAIL:      ${{ github.event.inputs.DISCORD_BOT_EMBED_THUMBNAIL || 'https://avatars.githubusercontent.com/u/200161462' }}
-    BOT_NAME_RENOVATE:          renovate[bot]
+    ASSIGN_USER:                      Aetherinox
+    BOT_NAME_1:                       EuropaServ
+    BOT_NAME_2:                       BinaryServ
+    BOT_NAME_DEPENDABOT:              dependabot[bot]
+    BOT_NAME_RENOVATE:                renovate[bot]
 
 # #
 #   jobs
@@ -113,9 +170,9 @@ env:
 
 jobs:
     build-docs:
-      # runs-on: ubuntu-latest
+        runs-on: ubuntu-latest
-        runs-on: apollo-x64
+      # runs-on: apollo-x64
-        timeout-minutes: 20
+        timeout-minutes: 10
         permissions:
             contents: write
             pages: write
@@ -124,45 +181,139 @@ jobs:
         steps:
 
             # #
-            #   Documentation › Checkout › Arm64
+            #   Documentation › Build › Checkout
             # #
 
-            - name: >-
+            - name: '☑️ Checkout'
-                ✅ Checkout
-              id: task_docs_checkout
               uses: actions/checkout@v4
+              with:
+                  fetch-depth: 0
 
             # #
-            #   Documentation › Set Env Variables
+            #   Documentation › Build › Job Information
             # #
 
             - name: >-
-                🕛 Get Timestamp
+                  🔄 Load Job
-              id: task_docs_set_timestamp
+              uses: qoomon/actions--context@v4
-              run: |
+              id: 'context'
-                  echo "NOW=$(date +'%m-%d-%Y %H:%M:%S')" >> $GITHUB_ENV
-                  echo "NOW_SHORT=$(date +'%m-%d-%Y')" >> $GITHUB_ENV
-                  echo "NOW_LONG=$(date +'%m-%d-%Y %H:%M')" >> $GITHUB_ENV
-                  echo "NOW_DOCKER_LABEL=$(date +'%Y%m%d')" >> $GITHUB_ENV
 
             # #
-            #   Documentation › Setup Python
+            #   Documentation › Build › Start
+            # #
+
+            - name: >-
+                  ✅ Start
+              run: |
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo " Starting Job ${{ steps.context.outputs.job_name }}"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+
+                  YEAR="$(date +'%Y')"
+                  echo "YEAR=${YEAR}" >> $GITHUB_ENV
+
+                  NOW="$(date +'%m-%d-%Y %H:%M:%S')"                                                #  02-25-2025 12:49:48
+                  echo "NOW=${NOW}" >> $GITHUB_ENV
+
+                  NOW_SHORT="$(date +'%m-%d-%Y')"                                                   #  02-25-2025
+                  echo "NOW_SHORT=${NOW_SHORT}" >> $GITHUB_ENV
+
+                  NOW_LONG="$(date +'%m-%d-%Y %H:%M')"                                              #  02-25-2025 12:49
+                  echo "NOW_LONG=${NOW_LONG}" >> $GITHUB_ENV
+
+                  NOW_DOCKER="$(date +'%Y%m%d')"                                                    #  20250225
+                  echo "NOW_DOCKER=${NOW_DOCKER}" >> $GITHUB_ENV
+
+                  NOW_DOCKER_TS="$(date -u +'%FT%T.%3NZ')"                                          #  2025-02-25T12:50:11.569Z
+                  echo "NOW_DOCKER_TS=${NOW_DOCKER_TS}" >> $GITHUB_ENV
+
+                  SHA1="$(git rev-parse HEAD)"                                                      #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1=${SHA1}" >> $GITHUB_ENV
+
+                  SHA1_GH="$(echo ${GITHUB_SHA})"                                                   #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1_GH=${SHA1_GH}" >> $GITHUB_ENV
+
+                  PKG_VER_1DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -d '.' -f1-1)"              #  3.22 > 3
+                  echo "PKG_VER_1DIGIT=${PKG_VER_1DIGIT}" >> $GITHUB_ENV
+
+                  PKG_VER_2DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -f2 -d ":" | cut -c1-3)"    #  3.22 > 3.2
+                  echo "PKG_VER_2DIGIT=${PKG_VER_2DIGIT}" >> $GITHUB_ENV
+
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  sudo apt -qq update
+                  sudo apt -qq install tree
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo " Runner .............. ${{ runner.name }}"
+                  echo " Workflow ............ ${{ github.workflow }} (#${{ github.workflow_ref }})"
+                  echo " Run Number .......... ${{ github.run_number }}"
+                  echo " Ref ................. ${{ github.ref }}"
+                  echo " Ref Name ............ ${{ github.ref_name }}"
+                  echo " Event Name .......... ${{ github.event_name }}"
+                  echo " Repo ................ ${{ github.repository }}"
+                  echo " Repo Owner .......... ${{ github.repository_owner }}"
+                  echo " Run ID .............. https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+                  echo " Triggered By ........ ${{ github.actor }}"
+                  echo " SHA 1 (GITHUB_SHA) .. ${GITHUB_SHA}"
+                  echo " SHA 2 (github.sha) .. ${{ github.sha }}"
+                  echo " SHA 3 (env.SHA1) .... ${SHA1}"
+                  echo " SHA 4 (env.SHA1_GH) . ${SHA1_GH}"
+                  echo " Workspace ........... ${{ github.workspace }}"
+                  echo " PWD ................. ${PWD}"
+                  echo " Job Name ............ ${{ steps.context.outputs.job_name }}"
+                  echo " Job ID .............. ${{ steps.context.outputs.job_id }}"
+                  echo " Job URL ............. ${{ steps.context.outputs.job_url }}"
+                  echo " Run ID .............. ${{ steps.context.outputs.run_id }}"
+                  echo " Run Attempt ......... ${{ steps.context.outputs.run_attempt }}"
+                  echo " Run Number .......... ${{ steps.context.outputs.run_number }}"
+                  echo " Run URL ............. ${{ steps.context.outputs.run_url }}"
+                  echo " Run Env ............. ${{ steps.context.outputs.environment }}"
+                  echo " Run Env URL ......... ${{ steps.context.outputs.environment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Deployment URL .. ${{ steps.context.outputs.deployment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Runner Name ..... ${{ steps.context.outputs.runner_name }}"
+                  echo " Run Runner ID ....... ${{ steps.context.outputs.runner_id }}"
+                  echo " Year ................ ${YEAR}"
+                  echo " Now ................. ${NOW}"
+                  echo " Now (Short) ......... ${NOW_SHORT}"
+                  echo " Now (Long) .......... ${NOW_LONG}"
+                  echo " Now (Docker) ........ ${NOW_DOCKER}"
+                  echo " Now (Docker TS) ..... ${NOW_DOCKER_TS}"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  tree -I node_modules -I .git
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+
+            # #
+            #   Documentation › Build › Setup Python
             # #
 
             - name: >-
                 🐍 Setup Python
-              id: task_docs_python_setup
               uses: actions/setup-python@v5
               with:
                   python-version: 3.x
 
             # #
-            #   Documentation › Build Documentation
+            #   Documentation › Build › Build
             # #
 
             - name: >-
                 📕 Build Documentation
-              id: task_docs_build
               run: |
                   export DOCS_NAME=${{ secrets.DOCS_NAME || 'TVApp2' }}
                   export DOCS_SECRET_L1=${{ secrets.DOCS_SECRET_L1 }}
@@ -183,12 +334,11 @@ jobs:
                   GH_TOKEN: ${{ secrets.ADMINSERV_TOKEN }}
 
             # #
-            #   Documentation › Deploy
+            #   Documentation › Build › Deploy
             # #
 
             - name: >-
                 💽 Deploy
-              id: task_docs_deploy
               uses: peaceiris/actions-gh-pages@v4
               with:
                   personal_token: ${{ secrets.ADMINSERV_TOKEN_CL }}
@@ -196,33 +346,31 @@ jobs:
 
 
             # #
-            #   Documentation › Get Weekly Commits
+            #   Documentation › Build › Get Weekly Commits
             # #
 
             - name: >-
                 🕛 Get Weekly Commit List
-              id: task_docs_set_weekly_commit_list
               run: |
                   echo 'WEEKLY_COMMITS<<EOF' >> $GITHUB_ENV
                   git log --format="[\`%h\`](${{ github.server_url }}/${{ github.repository }}/commit/%H) %s - %an" --since=7.days >> $GITHUB_ENV
                   echo 'EOF' >> $GITHUB_ENV
 
             # #
-            #   Documentation › Notify Github › Success
+            #   Documentation › Build › Notify Github › Success
             # #
 
             - name: >-
                 🔔 Send Discord Webhook Message (Success)
-              id: task_docs_notify_discord_success
               uses: tsickert/discord-webhook@v7.0.0
               if: success()
               with:
-                  username: 'Io'
+                  username: ${{ env.DISCORD_BOT_NAME }}
-                  avatar-url: 'https://i.imgur.com/8BVDkla.jpg'
+                  avatar-url: ${{ env.DISCORD_BOT_AVATAR }}
                   webhook-url: ${{ secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_WORKfLOWS }}
                   embed-title: "⚙️ ${{ github.workflow_ref }}"
                   embed-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-thumbnail-url: 'https://i.imgur.com/zDIzE8T.jpg'
+                  embed-thumbnail-url: ${{ env.DISCORD_BOT_EMBED_THUMBNAIL }}
                   embed-description: |
                       ## 📦 Documentation Deployment᲼${{ job.status == 'success' && '✅' || '❌' }}
 
@@ -239,24 +387,23 @@ jobs:
                   embed-timestamp: "${{ env.NOW_LONG }}"
                   embed-author-name: "${{ github.repository_owner }}"
                   embed-author-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-author-icon-url: "https://avatars.githubusercontent.com/u/200161462"
+                  embed-author-icon-url: ${{ env.DISCORD_BOT_EMBED_AUTHOR_ICON }}
 
             # #
-            #   Documentation › Notify Github › Failure
+            #   Documentation › Build › Notify Github › Failure
             # #
 
             - name: >-
                 🔔 Send Discord Webhook Message (Failure)
-              id: task_docs_notify_discord_failure
               uses: tsickert/discord-webhook@v7.0.0
               if: failure()
               with:
-                  username: 'Io'
+                  username: ${{ env.DISCORD_BOT_NAME }}
-                  avatar-url: 'https://i.imgur.com/8BVDkla.jpg'
+                  avatar-url: ${{ env.DISCORD_BOT_AVATAR }}
                   webhook-url: ${{ secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_WORKfLOWS }}
                   embed-title: "⚙️ ${{ github.workflow_ref }}"
                   embed-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-thumbnail-url: 'https://i.imgur.com/zDIzE8T.jpg'
+                  embed-thumbnail-url: ${{ env.DISCORD_BOT_EMBED_THUMBNAIL }}
                   embed-description: |
                       ## 📦 Documentation Deployment᲼${{ job.status == 'success' && '✅' || '❌' }}
 
@@ -273,5 +420,5 @@ jobs:
                   embed-timestamp: "${{ env.NOW_LONG }}"
                   embed-author-name: "${{ github.repository_owner }}"
                   embed-author-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-author-icon-url: "https://avatars.githubusercontent.com/u/200161462"
+                  embed-author-icon-url: ${{ env.DISCORD_BOT_EMBED_AUTHOR_ICON }}
 

.github/workflows/gpg-tests.yml

@@ -0,0 +1,366 @@
+# #
+#   @type               github workflow
+#   @author             Aetherinox
+#   @url                https://github.com/Aetherinox
+#   @usage              tests gpg keys
+#
+#   @secrets            secrets.SELF_TOKEN                                          self github personal access token (fine-grained)
+#                       secrets.SELF_TOKEN_CL                                       self github personal access token (classic)
+#                       secrets.NPM_TOKEN                                           self npmjs access token
+#                       secrets.PYPI_API_TOKEN                                      self Pypi API token (production site) - https://pypi.org/
+#                       secrets.PYPI_API_TEST_TOKEN                                 self Pypi API token (test site) - https://test.pypi.org/
+#                       secrets.SELF_DOCKERHUB_TOKEN                                self Dockerhub token
+#                       secrets.CODECOV_TOKEN                                       codecov upload token for nodejs projects
+#                       secrets.MAXMIND_GELITE_TOKEN                                maxmind API token
+#                       secrets.CF_ACCOUNT_ID                                       cloudflare account id
+#                       secrets.CF_ACCOUNT_TOKEN                                    cloudflare account token
+#                       secrets.ORG_TOKEN                                           org github personal access token (fine-grained)
+#                       secrets.ORG_TOKEN_CL                                        org github personal access token (classic)
+#                       secrets.ORG_DOCKERHUB_TOKEN                                 org dockerhub secret
+#                       secrets.ORG_GITEA_TOKEN                                     org gitea personal access token (classic) with package:write permission
+#                       secrets.BOT_GPG_KEY_ASC                                     bot gpg private key (armored) | BEGIN PGP PRIVATE KEY BLOCK
+#                       secrets.BOT_GPG_KEY_B64                                     bot gpg private key (binary) converted to base64
+#                       secrets.BOT_GPG_PASSPHRASE                                  bot gpg private key passphrase
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_RELEASES                discord webhook to report release notifications from github to discord
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_WORKFLOWS               discord webhook to report workflow notifications from github to discord
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_UPDATES                 discord webhook to report activity notifications from github to discord
+#
+#   @local              these workflows can be tested locally through the use of `act`
+#                           https://github.com/nektos/act
+#                       Extract act to folder
+#                       Add system env var with path to act.exe
+#                       Run the commands:
+#                           git pull https://github.com/username/repo
+#                           act -W .github/workflows/gpg-tests.yml -P ubuntu-latest=catthehacker/ubuntu:full-22.04
+#                           act -W .github/workflows/gpg-tests.yml -s TOKEN_CL=XXXXXXXXXX --pull=false
+# #
+
+name: '🔑 GPG › Tests'
+run-name: '🔑 GPG › Tests'
+
+# #
+#   triggers
+# #
+
+on:
+    workflow_dispatch:
+        inputs:
+
+            # #
+            #   Name of the plugin to use when creating the release zip filename
+            #     e.g: ntfy-desktop-v1.0.0.zip
+            # #
+
+            PROJECT_NAME:
+                description:          '📦 Name of App'
+                required:             true
+                default:              'ntfy-desktop'
+                type:                 string
+
+# #
+#   environment variables
+# #
+
+env:
+    PROJECT_NAME:                   ${{ github.event.inputs.PROJECT_NAME || 'ntfy-desktop' }}
+    ASSIGN_USER:                    Aetherinox
+    BOT_NAME_1:                     EuropaServ
+    BOT_NAME_2:                     BinaryServ
+    BOT_NAME_DEPENDABOT:            dependabot[bot]
+    BOT_NAME_RENOVATE:              renovate[bot]
+    GPG_KEY_BASE64:                 ${{ secrets.ADMINSERV_GPG_KEY_B64 }}
+    GPG_KEY_PASSPHRASE:             ${{ secrets.ADMINSERV_GPG_PASSPHRASE }}
+
+# #
+#   Jobs
+# #
+
+jobs:
+
+    # #
+    #   JOB > INITIALIZE
+    # #
+
+    job-initialize:
+        name: >-
+            🔑 GPG › Tests
+        runs-on: ubuntu-latest
+      # runs-on: apollo-x64
+        timeout-minutes: 5
+        outputs:
+            package_version: ${{ steps.task_initialize_package_getversion.outputs.PACKAGE_VERSION }}
+        permissions:
+            contents: write
+            packages: write
+        steps:
+
+            # #
+            #   GPG › Checkout
+            # #
+
+            - name: '☑️ Checkout'
+              uses: actions/checkout@v4
+              with:
+                  fetch-depth: 0
+
+            # #
+            #   GPG › Job Information
+            # #
+
+            - name: >-
+                  🔄 Load Job
+              uses: qoomon/actions--context@v4
+              id: 'context'
+
+            # #
+            #   GPG › Start
+            # #
+
+            - name: >-
+                  ✅ Start
+              run: |
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo " Starting Job ${{ steps.context.outputs.job_name }}"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+
+                  YEAR="$(date +'%Y')"
+                  echo "YEAR=${YEAR}" >> $GITHUB_ENV
+
+                  NOW="$(date +'%m-%d-%Y %H:%M:%S')"                                                #  02-25-2025 12:49:48
+                  echo "NOW=${NOW}" >> $GITHUB_ENV
+
+                  NOW_SHORT="$(date +'%m-%d-%Y')"                                                   #  02-25-2025
+                  echo "NOW_SHORT=${NOW_SHORT}" >> $GITHUB_ENV
+
+                  NOW_LONG="$(date +'%m-%d-%Y %H:%M')"                                              #  02-25-2025 12:49
+                  echo "NOW_LONG=${NOW_LONG}" >> $GITHUB_ENV
+
+                  NOW_DOCKER="$(date +'%Y%m%d')"                                                    #  20250225
+                  echo "NOW_DOCKER=${NOW_DOCKER}" >> $GITHUB_ENV
+
+                  NOW_DOCKER_TS="$(date -u +'%FT%T.%3NZ')"                                          #  2025-02-25T12:50:11.569Z
+                  echo "NOW_DOCKER_TS=${NOW_DOCKER_TS}" >> $GITHUB_ENV
+
+                  SHA1="$(git rev-parse HEAD)"                                                      #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1=${SHA1}" >> $GITHUB_ENV
+
+                  SHA1_GH="$(echo ${GITHUB_SHA})"                                                   #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1_GH=${SHA1_GH}" >> $GITHUB_ENV
+
+                  PKG_VER_1DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -d '.' -f1-1)"              #  3.22 > 3
+                  echo "PKG_VER_1DIGIT=${PKG_VER_1DIGIT}" >> $GITHUB_ENV
+
+                  PKG_VER_2DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -f2 -d ":" | cut -c1-3)"    #  3.22 > 3.2
+                  echo "PKG_VER_2DIGIT=${PKG_VER_2DIGIT}" >> $GITHUB_ENV
+
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  sudo apt -qq update
+                  sudo apt -qq install tree
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo " Runner .............. ${{ runner.name }}"
+                  echo " Workflow ............ ${{ github.workflow }} (#${{ github.workflow_ref }})"
+                  echo " Run Number .......... ${{ github.run_number }}"
+                  echo " Ref ................. ${{ github.ref }}"
+                  echo " Ref Name ............ ${{ github.ref_name }}"
+                  echo " Event Name .......... ${{ github.event_name }}"
+                  echo " Repo ................ ${{ github.repository }}"
+                  echo " Repo Owner .......... ${{ github.repository_owner }}"
+                  echo " Run ID .............. https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+                  echo " Triggered By ........ ${{ github.actor }}"
+                  echo " SHA 1 (GITHUB_SHA) .. ${GITHUB_SHA}"
+                  echo " SHA 2 (github.sha) .. ${{ github.sha }}"
+                  echo " SHA 3 (env.SHA1) .... ${SHA1}"
+                  echo " SHA 4 (env.SHA1_GH) . ${SHA1_GH}"
+                  echo " Workspace ........... ${{ github.workspace }}"
+                  echo " PWD ................. ${PWD}"
+                  echo " Job Name ............ ${{ steps.context.outputs.job_name }}"
+                  echo " Job ID .............. ${{ steps.context.outputs.job_id }}"
+                  echo " Job URL ............. ${{ steps.context.outputs.job_url }}"
+                  echo " Run ID .............. ${{ steps.context.outputs.run_id }}"
+                  echo " Run Attempt ......... ${{ steps.context.outputs.run_attempt }}"
+                  echo " Run Number .......... ${{ steps.context.outputs.run_number }}"
+                  echo " Run URL ............. ${{ steps.context.outputs.run_url }}"
+                  echo " Run Env ............. ${{ steps.context.outputs.environment }}"
+                  echo " Run Env URL ......... ${{ steps.context.outputs.environment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Deployment URL .. ${{ steps.context.outputs.deployment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Runner Name ..... ${{ steps.context.outputs.runner_name }}"
+                  echo " Run Runner ID ....... ${{ steps.context.outputs.runner_id }}"
+                  echo " Year ................ ${YEAR}"
+                  echo " Now ................. ${NOW}"
+                  echo " Now (Short) ......... ${NOW_SHORT}"
+                  echo " Now (Long) .......... ${NOW_LONG}"
+                  echo " Now (Docker) ........ ${NOW_DOCKER}"
+                  echo " Now (Docker TS) ..... ${NOW_DOCKER_TS}"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  tree -I node_modules -I .git
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+
+            # #
+            #   GPG › Get version from package.json VERSION value
+            # #
+
+            - name: '👁️‍🗨️ Get Package Version'
+              id: task_initialize_package_getversion
+              run: |
+                  VER=$(cat package.json | jq -r '.version')
+                  echo "PACKAGE_VERSION=$VER" >> $GITHUB_OUTPUT
+
+            - name: '👁️‍🗨️ Get Package Version › Print'
+              id: task_initialize_package_getversion_debug
+              run: |
+                  echo "VERSION: ${{ steps.task_initialize_package_getversion.outputs.PACKAGE_VERSION }}"
+
+            # #
+            #   GPG › Import Key (No Passphrase)
+            #
+            #   requires your GPG private key, converted to base64 binary .gpg (not armored .asc)
+            # #
+
+            - name: '🪪 GPG › Import Signing Key › W/o Passphrase'
+              if: env.GPG_KEY_BASE64 != '' && env.GPG_KEY_PASSPHRASE == ''
+              run: |
+                  echo "$GPG_KEY_BASE64" | base64 -di | gpg --import
+
+            # #
+            #   GPG › Import Key (With Passphrase)
+            #
+            #   requires your GPG private key, converted to base64 binary .gpg (not armored .asc)
+            # #
+
+            - name: '🪪 GPG › Import Signing Key › w/ Passphrase'
+              if: env.GPG_KEY_BASE64 != '' && env.GPG_KEY_PASSPHRASE != ''
+              run: |
+                  echo "$GPG_KEY_BASE64" | base64 -di > /tmp/signing-key.gpg
+                  echo "$GPG_KEY_PASSPHRASE" | gpg --pinentry-mode loopback --passphrase-fd 0 --import /tmp/signing-key.gpg
+                  (echo "$GPG_KEY_PASSPHRASE"; echo; echo) | gpg --command-fd 0 --pinentry-mode loopback --change-passphrase $(gpg --list-secret-keys --with-colons 2> /dev/null | grep '^sec:' | cut --delimiter ':' --fields 5 | tail -n 1)
+
+            # #
+            #   GPG › Checksum › Stable
+            # #
+
+            - name: '🆔 Checksum › Stable'
+              run: |
+                  #  windows
+                  file_1_example="package.json"
+                  file_2_example="package-lock.json"
+
+
+                  #  get sha1 and sha256 for .json
+                  find . -maxdepth 1 \( -name '*.json' -o -name '*.gz' \) -printf '%P\n' | xargs -r sha1sum | gpg --digest-algo sha256 --clearsign > sha1sum.txt.asc
+                  find . -maxdepth 1 \( -name '*.json' -o -name '*.gz' \) -printf '%P\n' | xargs -r sha256sum | gpg --digest-algo sha256 --clearsign > sha256sum.txt.asc
+
+
+                  #  SHA1SUM
+                  sha1sum_file_1="$(shasum --algorithm 1 ${file_1_example} | awk '{ print $1 }')"
+                  echo "SHA1SUM_FILE_1=${sha1sum_file_1}" >> $GITHUB_ENV
+
+                  sha1sum_file_2="$(shasum --algorithm 1 ${file_2_example} | awk '{ print $1 }')"
+                  echo "SHA1SUM_FILE_2=${sha1sum_file_2}" >> $GITHUB_ENV
+
+
+                  #  SHA256SUM
+                  sha256sum_file_1="$(shasum --algorithm 256 ${file_1_example} | awk '{ print $1 }')"
+                  echo "SHA256SUM_FILE_1=${sha256sum_file_1}" >> $GITHUB_ENV
+
+                  sha256sum_file_2="$(shasum --algorithm 256 ${file_2_example} | awk '{ print $1 }')"
+                  echo "SHA256SUM_FILE_2=${sha256sum_file_2}" >> $GITHUB_ENV
+
+
+                  #  no longer needed, replaced by find . command
+                  #  shasum --algorithm 256 ${file_file_1} > SHA256SUMS.txt
+                  echo "FILE_1_EXAMPLE=${file_1_example}" >> $GITHUB_ENV
+                  echo "FILE_2_EXAMPLE=${file_2_example}" >> $GITHUB_ENV
+
+
+                  #  generate sha256sum.sig from sha256sum.txt.asc file
+                  gpg --batch --yes --quiet --armor --detach-sig --sign --output sha256sum.sig sha256sum.txt.asc
+
+            # #
+            #   GPG › Verbose › Print Results
+            # #
+
+            - name: '⚙️ Verbose › Print Results'
+              run: |
+                  echo "‎"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo -e " 🌲 Tree"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  tree -I node_modules
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo -e " 📄 sha256sum.txt.asc"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  cat sha256sum.txt.asc
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo -e " 📄 sha1sum.txt.asc"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  cat sha1sum.txt.asc
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo -e " 📄 sha256sum.sig"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  cat sha256sum.sig
+                  echo "‎"
+                  echo "‎"
+                  echo "‎"
+                  echo "Running command gpg --verify sha256sum.sig sha256sum.txt.asc"
+                  echo "‎"
+                  gpg --verify sha256sum.sig sha256sum.txt.asc
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo -e " 🔑 List GPG Keys"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  gpg --list-keys --keyid-format=long --fingerprint --with-fingerprint
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo "‎"
+
+            # #
+            #   GPG › Checksum › Print
+            # #
+
+            - name: '🆔 Checksum › Print'
+              run: |
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo " Checksums"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo " ${{ env.FILE_1_EXAMPLE }}                 ${{ env.SHA256SUM_FILE_1 }}"
+                  echo " ${{ env.FILE_2_EXAMPLE }}            ${{ env.SHA256SUM_FILE_2 }}"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"

.github/workflows/history-clean.yml

@@ -0,0 +1,313 @@
+# #
+#   @type               github workflow
+#   @author             Aetherinox
+#   @url                https://github.com/Aetherinox
+#   @usage              cleans all commit history for a repository
+#                       edit the 'environment:' to determine which deployment to keep clean
+#                           - can be ran manually
+#
+#   @secrets            secrets.SELF_TOKEN                                          self github personal access token (fine-grained)
+#                       secrets.SELF_TOKEN_CL                                       self github personal access token (classic)
+#                       secrets.NPM_TOKEN                                           self npmjs access token
+#                       secrets.PYPI_API_TOKEN                                      self Pypi API token (production site) - https://pypi.org/
+#                       secrets.PYPI_API_TEST_TOKEN                                 self Pypi API token (test site) - https://test.pypi.org/
+#                       secrets.SELF_DOCKERHUB_TOKEN                                self Dockerhub token
+#                       secrets.CODECOV_TOKEN                                       codecov upload token for nodejs projects
+#                       secrets.MAXMIND_GELITE_TOKEN                                maxmind API token
+#                       secrets.CF_ACCOUNT_ID                                       cloudflare account id
+#                       secrets.CF_ACCOUNT_TOKEN                                    cloudflare account token
+#                       secrets.ORG_TOKEN                                           org github personal access token (fine-grained)
+#                       secrets.ORG_TOKEN_CL                                        org github personal access token (classic)
+#                       secrets.ORG_DOCKERHUB_TOKEN                                 org dockerhub secret
+#                       secrets.ORG_GITEA_TOKEN                                     org gitea personal access token (classic) with package:write permission
+#                       secrets.BOT_GPG_KEY_ASC                                     bot gpg private key (armored) | BEGIN PGP PRIVATE KEY BLOCK
+#                       secrets.BOT_GPG_KEY_B64                                     bot gpg private key (binary) converted to base64
+#                       secrets.BOT_GPG_PASSPHRASE                                  bot gpg private key passphrase
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_RELEASES                discord webhook to report release notifications from github to discord
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_WORKFLOWS               discord webhook to report workflow notifications from github to discord
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_UPDATES                 discord webhook to report activity notifications from github to discord
+#
+#
+#   @local              these workflows can be tested locally through the use of `act`
+#                           https://github.com/nektos/act
+#                       Extract act to folder
+#                       Add system env var with path to act.exe
+#                       Run the commands:
+#                           git pull https://github.com/username/repo
+#                           act -W .github/workflows/history-clean.yml -P ubuntu-latest=catthehacker/ubuntu:full-22.04
+#                           act -W .github/workflows/history-clean.yml -s TOKEN_CL=XXXXXXXXXX --pull=false
+# #
+
+name: '🧹 History › Clean'
+run-name: '🧹 History › Clean'
+
+# #
+#   triggers
+# #
+
+on:
+
+    # #
+    #   Trigger > Workflow Dispatch
+    # #
+
+    workflow_dispatch:
+        inputs:
+
+            # #
+            #   Commit Label
+            #
+            #   the label to use when repository is cleaned
+            # #
+
+            COMMIT_LABEL:
+                description:    '🏷️ Commit Label'
+                required:       true
+                default:        'cleanup'
+                type:           string
+
+            # #
+            #   Branch
+            #
+            #   select branch to clean
+            #   you must also run the workflow from that branch
+            # #
+
+            BRANCH:
+                description:    '🌳 Branch'
+                required:       true
+                default:        'main'
+                type:           string
+
+# #
+#   environment variables
+# #
+
+env:
+    COMMIT_LABEL:               ${{ github.event.inputs.COMMIT_LABEL || 'cleanup' }}
+    BRANCH:                     ${{ github.event.inputs.BRANCH || 'main' }}
+    BOT_NAME_1:                 EuropaServ
+    BOT_NAME_2:                 BinaryServ
+    BOT_NAME_DEPENDABOT:        dependabot[bot]
+    BOT_NAME_RENOVATE:          renovate[bot]
+
+# #
+#   jobs
+# #
+
+jobs:
+    history-clean:
+        name: >-
+            🧹 History › Clean
+        runs-on: ubuntu-latest
+      # runs-on: apollo-x64
+        timeout-minutes: 15
+        permissions:
+            contents: write
+        steps:
+
+            # #
+            #   History › Clean › Checkout
+            # #
+
+            - name: '☑️ Checkout'
+              uses: actions/checkout@v4
+              with:
+                  fetch-depth: 0
+
+            # #
+            #   History › Clean › Job Information
+            # #
+
+            - name: >-
+                  🔄 Load Job
+              uses: qoomon/actions--context@v4
+              id: 'context'
+
+            # #
+            #   History › Clean › Start
+            # #
+
+            - name: >-
+                  ✅ Start
+              run: |
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo " Starting Job ${{ steps.context.outputs.job_name }}"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+
+                  YEAR="$(date +'%Y')"
+                  echo "YEAR=${YEAR}" >> $GITHUB_ENV
+
+                  NOW="$(date +'%m-%d-%Y %H:%M:%S')"                                                #  02-25-2025 12:49:48
+                  echo "NOW=${NOW}" >> $GITHUB_ENV
+
+                  NOW_SHORT="$(date +'%m-%d-%Y')"                                                   #  02-25-2025
+                  echo "NOW_SHORT=${NOW_SHORT}" >> $GITHUB_ENV
+
+                  NOW_LONG="$(date +'%m-%d-%Y %H:%M')"                                              #  02-25-2025 12:49
+                  echo "NOW_LONG=${NOW_LONG}" >> $GITHUB_ENV
+
+                  NOW_DOCKER="$(date +'%Y%m%d')"                                                    #  20250225
+                  echo "NOW_DOCKER=${NOW_DOCKER}" >> $GITHUB_ENV
+
+                  NOW_DOCKER_TS="$(date -u +'%FT%T.%3NZ')"                                          #  2025-02-25T12:50:11.569Z
+                  echo "NOW_DOCKER_TS=${NOW_DOCKER_TS}" >> $GITHUB_ENV
+
+                  SHA1="$(git rev-parse HEAD)"                                                      #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1=${SHA1}" >> $GITHUB_ENV
+
+                  SHA1_GH="$(echo ${GITHUB_SHA})"                                                   #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1_GH=${SHA1_GH}" >> $GITHUB_ENV
+
+                  PKG_VER_1DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -d '.' -f1-1)"              #  3.22 > 3
+                  echo "PKG_VER_1DIGIT=${PKG_VER_1DIGIT}" >> $GITHUB_ENV
+
+                  PKG_VER_2DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -f2 -d ":" | cut -c1-3)"    #  3.22 > 3.2
+                  echo "PKG_VER_2DIGIT=${PKG_VER_2DIGIT}" >> $GITHUB_ENV
+
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  sudo apt -qq update
+                  sudo apt -qq install tree
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo " Runner .............. ${{ runner.name }}"
+                  echo " Workflow ............ ${{ github.workflow }} (#${{ github.workflow_ref }})"
+                  echo " Run Number .......... ${{ github.run_number }}"
+                  echo " Ref ................. ${{ github.ref }}"
+                  echo " Ref Name ............ ${{ github.ref_name }}"
+                  echo " Event Name .......... ${{ github.event_name }}"
+                  echo " Repo ................ ${{ github.repository }}"
+                  echo " Repo Owner .......... ${{ github.repository_owner }}"
+                  echo " Run ID .............. https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+                  echo " Triggered By ........ ${{ github.actor }}"
+                  echo " SHA 1 (GITHUB_SHA) .. ${GITHUB_SHA}"
+                  echo " SHA 2 (github.sha) .. ${{ github.sha }}"
+                  echo " SHA 3 (env.SHA1) .... ${SHA1}"
+                  echo " SHA 4 (env.SHA1_GH) . ${SHA1_GH}"
+                  echo " Workspace ........... ${{ github.workspace }}"
+                  echo " PWD ................. ${PWD}"
+                  echo " Job Name ............ ${{ steps.context.outputs.job_name }}"
+                  echo " Job ID .............. ${{ steps.context.outputs.job_id }}"
+                  echo " Job URL ............. ${{ steps.context.outputs.job_url }}"
+                  echo " Run ID .............. ${{ steps.context.outputs.run_id }}"
+                  echo " Run Attempt ......... ${{ steps.context.outputs.run_attempt }}"
+                  echo " Run Number .......... ${{ steps.context.outputs.run_number }}"
+                  echo " Run URL ............. ${{ steps.context.outputs.run_url }}"
+                  echo " Run Env ............. ${{ steps.context.outputs.environment }}"
+                  echo " Run Env URL ......... ${{ steps.context.outputs.environment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Deployment URL .. ${{ steps.context.outputs.deployment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Runner Name ..... ${{ steps.context.outputs.runner_name }}"
+                  echo " Run Runner ID ....... ${{ steps.context.outputs.runner_id }}"
+                  echo " Year ................ ${YEAR}"
+                  echo " Now ................. ${NOW}"
+                  echo " Now (Short) ......... ${NOW_SHORT}"
+                  echo " Now (Long) .......... ${NOW_LONG}"
+                  echo " Now (Docker) ........ ${NOW_DOCKER}"
+                  echo " Now (Docker TS) ..... ${NOW_DOCKER_TS}"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  tree -I node_modules -I .git
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+
+            # #
+            #   History › Clean › Git Identify
+            # #
+
+            - name: >-
+                  🪪 Configure Git Identity
+              run: |
+                    git config --local user.email "github-actions[bot]@users.noreply.github.com"
+                    git config --local user.name "github-actions[bot]"
+
+            # #
+            #   History › Clean › Pre-Commit
+            # #
+
+            - name: >-
+                  📦 Commit › Pre-commit
+              run: |
+                  now=$(date -u '+%m/%d/%Y %H:%M')
+                  commit_label="${{ env.COMMIT_LABEL }}" >> $GITHUB_ENV
+                  echo -e "$commit_label"
+                  commit_message="chore(maint): \\\`️️🧹 $commit_label 🧹\\\` \\\`$now UTC\\\`" >> $GITHUB_ENV
+                  echo -e "$commit_message"
+                  echo "COMMIT_MESSAGE=$(echo $commit_message)" >> $GITHUB_ENV
+                  echo "NOW=$(echo $now)" >> $GITHUB_ENV
+
+            # #
+            #   History › Clean › Pre-Commit › Debug
+            # #
+
+            - name: >-
+                  📦 Commit › Pre-commit › Debug
+              run: |
+                  echo -e "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo -e " Printing Values"
+                  echo -e "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo -e " env.COMMIT_LABEL .................... ${{ env.COMMIT_LABEL }}"
+                  echo -e " env.COMMIT_MESSAGE .................. ${{ env.COMMIT_MESSAGE }}"
+                  echo -e " env.NOW ............................. ${{ env.NOW }}"
+
+            # #
+            #   History › Clean › Start
+            # #
+
+            - name: >-
+                  🧹 Clean Repo History
+              run: |
+                    # Create a new orphan branch
+                    git checkout --orphan temp-branch
+
+                    # Add all files to the new branch
+                    git add -A
+
+                    # Commit the files to the new branch
+                    git commit -m "${{ env.COMMIT_MESSAGE }}"
+
+                    # Delete the old main branch
+                    git branch -D ${{ env.BRANCH }}
+
+                    # Rename the new orphan branch to main
+                    git branch -m ${{ env.BRANCH }}
+
+                    # Force push the new main branch to the remote repository
+                    git push -f origin ${{ env.BRANCH }}
+
+            # #
+            #   History › Clean › References
+            # #
+
+            - name: >-
+                  🗑️ Garbage Collection (Aggressive)
+              run: |
+                    # Remove remote-tracking references to deleted branches (optional)
+                    git fetch origin --prune
+                    git repack
+                    git prune-packed
+                    git reflog expire --expire=now --all
+                    git gc --prune=now --aggressive
+
+            # #
+            #   History › Clean › Commit
+            # #
+
+            - name: >-
+                  📦 Commit › Execute
+              uses: stefanzweifel/git-auto-commit-action@v5
+              with:
+                  commit_message: ${{ env.COMMIT_MESSAGE }}

.github/workflows/issues-scan.yml

@@ -2,7 +2,7 @@
 #   @type               github workflow
 #   @author             Aetherinox
 #   @url                https://github.com/Aetherinox
-#   @desc               pull request auto-scan
+#   @usage              pull request auto-scan
 #                           scans all of the files related to a particular pull request
 #                           if the code in the files being submitted contains code that is forbidden,
 #                           a report is generated and posted as a comment in the PR.
@@ -16,15 +16,20 @@
 #                       secrets.PYPI_API_TOKEN                                      self Pypi API token (production site) - https://pypi.org/
 #                       secrets.PYPI_API_TEST_TOKEN                                 self Pypi API token (test site) - https://test.pypi.org/
 #                       secrets.SELF_DOCKERHUB_TOKEN                                self Dockerhub token
-#                       secrets.ORG_BINARYNINJA_TOKEN                               org github personal access token (fine-grained)
+#                       secrets.CODECOV_TOKEN                                       codecov upload token for nodejs projects
-#                       secrets.ORG_BINARYNINJA_TOKEN_CL                            org github personal access token (classic)
+#                       secrets.MAXMIND_GELITE_TOKEN                                maxmind API token
-#                       secrets.ORG_BINARYNINJA_DOCKERHUB_TOKEN                     org dockerhub secret
+#                       secrets.CF_ACCOUNT_ID                                       cloudflare account id
-#                       secrets.ORG_BINARYNINJA_GITEA_TOKEN                         org gitea personal access token (classic) with package:write permission
+#                       secrets.CF_ACCOUNT_TOKEN                                    cloudflare account token
-#                       secrets.BINARYSERV_GPG_KEY_ASC                              bot gpg private key (armored) | BEGIN PGP PRIVATE KEY BLOCK
+#                       secrets.ORG_TOKEN                                           org github personal access token (fine-grained)
-#                       secrets.BINARYSERV_GPG_PASSPHRASE                           bot gpg private key passphrase
+#                       secrets.ORG_TOKEN_CL                                        org github personal access token (classic)
-#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_RELEASES         discord webhook to report release notifications from github to discord
+#                       secrets.ORG_DOCKERHUB_TOKEN                                 org dockerhub secret
-#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_WORKFLOWS        discord webhook to report workflow notifications from github to discord
+#                       secrets.ORG_GITEA_TOKEN                                     org gitea personal access token (classic) with package:write permission
-#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_UPDATES          discord webhook to report activity notifications from github to discord
+#                       secrets.BOT_GPG_KEY_ASC                                     bot gpg private key (armored) | BEGIN PGP PRIVATE KEY BLOCK
+#                       secrets.BOT_GPG_KEY_B64                                     bot gpg private key (binary) converted to base64
+#                       secrets.BOT_GPG_PASSPHRASE                                  bot gpg private key passphrase
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_RELEASES                discord webhook to report release notifications from github to discord
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_WORKFLOWS               discord webhook to report workflow notifications from github to discord
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_UPDATES                 discord webhook to report activity notifications from github to discord
 #
 #   @local              these workflows can be tested locally through the use of `act`
 #                           https://github.com/nektos/act
@@ -36,8 +41,8 @@
 #                           act -W .github/workflows/issues-scan.yml -s TOKEN_CL=XXXXXXXXXX --pull=false
 # #
 
-name: "🎫 Issues › Scan"
+name: '🎫 PR › Scan'
-run-name: "🎫 Issues › Scan"
+run-name: '🎫 PR › Scan'
 
 # #
 #   triggers
@@ -53,6 +58,11 @@ on:
 # #
 
 env:
+    DISCORD_BOT_NAME:                 'Europa'
+    DISCORD_BOT_AVATAR:               'https://i.imgur.com/UqwMom1.jpeg'
+    DISCORD_BOT_EMBED_AUTHOR_ICON:    'https://avatars.githubusercontent.com/u/200161462'
+    DISCORD_BOT_EMBED_THUMBNAIL:      'https://avatars.githubusercontent.com/u/200161462'
+
     LABEL_CHECK_STATUS_FAILED:      AC › Failed
     LABEL_CHECK_REVIEW_READY:       AC › Passed
     LABEL_CHECK_CHANGES_REQ:        AC › Changes Required
@@ -61,9 +71,10 @@ env:
     LABEL_CHECK_SECURITY_ERR:       AC › Security Warning
     LABEL_CHECK_STATUS_CHGMADE:     AC › Changes Made
     LABEL_CHECK_SCAN_SKIPPED:       AC › Skipped Scan
-    LABEL_TYPE_PR:                  Type ◦ Pull Request
+    LABEL_TYPE_PR:                  Type › Pull Request
-    LABEL_TYPE_DEPENDENCY:          Type ◦ Dependency
+    LABEL_TYPE_DEPENDENCY:          Type › Dependency
-    LABEL_TYPE_GITACTION:           Type ◦ Git Action
+    LABEL_TYPE_GITACTION:           Type › Git Action
+    LABEL_TYPE_MAINTENANCE:         Type › Lock Maintenance
 
     ASSIGN_USER:                    Aetherinox
     BOT_NAME_1:                     EuropaServ
@@ -73,64 +84,65 @@ env:
 
     LABELS_JSON: |
       [
-            { "name": "AC › Changes Made",           "color": "8F1784", "description": "Requested changes have been made and are pending a re-scan" },
+          { "name": "AC › Changes Made",            "color": "8F1784", "description": "Requested changes have been made and are pending a re-scan" },
-            { "name": "AC › Changes Required",       "color": "8F1784", "description": "Requires changes to be made to the package before being accepted" },
+          { "name": "AC › Changes Required",        "color": "8F1784", "description": "Requires changes to be made to the package before being accepted" },
-            { "name": "AC › Failed",                 "color": "a61f2d", "description": "Autocheck failed to run through a complete cycle, requires investigation" },
+          { "name": "AC › Failed",                  "color": "a61f2d", "description": "Autocheck failed to run through a complete cycle, requires investigation" },
-            { "name": "AC › Needs Rebase",           "color": "8F1784", "description": "Due to the permissions on the requesting repo, this pull request must be rebased by the author" },
+          { "name": "AC › Needs Rebase",            "color": "8F1784", "description": "Due to the permissions on the requesting repo, this pull request must be rebased by the author" },
-            { "name": "AC › Passed",                 "color": "146b4a", "description": "Ready to be reviewed" },
+          { "name": "AC › Passed",                  "color": "146b4a", "description": "Ready to be reviewed" },
-            { "name": "AC › Review Required",        "color": "8F1784", "description": "PR needs to be reviewed by another person, after the requested changes have been made" },
+          { "name": "AC › Review Required",         "color": "8F1784", "description": "PR needs to be reviewed by another person, after the requested changes have been made" },
-            { "name": "AC › Security Warning",       "color": "761620", "description": "Does not conform to developer policies, or includes potentially dangerous code" },
+          { "name": "AC › Security Warning",        "color": "761620", "description": "Does not conform to developer policies, or includes potentially dangerous code" },
-            { "name": "AC › Skipped Scan",           "color": "8F1784", "description": "Author has skipped code scan" },
+          { "name": "AC › Skipped Scan",            "color": "8F1784", "description": "Author has skipped code scan" },
-            { "name": "Status 𐄂 Duplicate",          "color": "75536b", "description": "Issue or pull request already exists" },
+          { "name": "Status › Duplicate",           "color": "75536b", "description": "Issue or pull request already exists" },
-            { "name": "Status 𐄂 Accepted",            "color": "2e7539", "description": "This pull request has been accepted" },
+          { "name": "Status › Accepted",            "color": "2e7539", "description": "This pull request has been accepted" },
-            { "name": "Status 𐄂 Autoclosed",          "color": "3E0915", "description": "Originally stale and was autoclosed for no activity" },
+          { "name": "Status › Autoclosed",          "color": "3E0915", "description": "Originally stale and was autoclosed for no activity" },
-            { "name": "Status 𐄂 Denied",              "color": "ba4058", "description": "Pull request has been denied" },
+          { "name": "Status › Denied",              "color": "ba4058", "description": "Pull request has been denied" },
-            { "name": "Status 𐄂 Locked",              "color": "550F45", "description": "Automatically locked by EuropaServ for a prolonged period of inactivity" },
+          { "name": "Status › Locked",              "color": "550F45", "description": "Automatically locked by AdminServ for a prolonged period of inactivity" },
-            { "name": "Status 𐄂 Need Info",           "color": "2E3C4C", "description": "Not enough information to resolve" },
+          { "name": "Status › Need Info",           "color": "2E3C4C", "description": "Not enough information to resolve" },
-            { "name": "Status 𐄂 No Action",           "color": "030406", "description": "Closed without any action being taken" },
+          { "name": "Status › No Action",           "color": "030406", "description": "Closed without any action being taken" },
-            { "name": "Status 𐄂 Pending",             "color": "984b12", "description": "Pending pull request" },
+          { "name": "Status › Pending",             "color": "984b12", "description": "Pending pull request" },
-            { "name": "Status 𐄂 Released",            "color": "1b6626", "description": "Issues or PR has been implemented and is now live" },
+          { "name": "Status › Released",            "color": "1b6626", "description": "Issues or PR has been implemented and is now live" },
-            { "name": "Status 𐄂 Reopened",            "color": "8a6f14", "description": "A previously closed PR which has been re-opened" },
+          { "name": "Status › Reopened",            "color": "8a6f14", "description": "A previously closed PR which has been re-opened" },
-            { "name": "Status 𐄂 Review",              "color": "9e1451", "description": "Currently pending review" },
+          { "name": "Status › Review",              "color": "9e1451", "description": "Currently pending review" },
-            { "name": "Status 𐄂 Stale",               "color": "928282", "description": "Has not had any activity in over 30 days" },
+          { "name": "Status › Stale",               "color": "928282", "description": "Has not had any activity in over 30 days" },
-            { "name": "Type ◦ Bug",                   "color": "9a2c2c", "description": "Something isn't working" },
+          { "name": "Type › Bug",                   "color": "9a2c2c", "description": "Something isn't working" },
-            { "name": "Type ◦ Dependency",            "color": "243759", "description": "Item is associated to dependency" },
+          { "name": "Type › Dependency",            "color": "243759", "description": "Item is associated to dependency" },
-            { "name": "Type ◦ Docs",                  "color": "0e588d", "description": "Improvements or modifications to docs" },
+          { "name": "Type › Lock Maintenance",      "color": "FBCA04", "description": "Sync package-lock.json" },
-            { "name": "Type ◦ Feature",               "color": "3c4e93", "description": "Feature request" },
+          { "name": "Type › Docs",                  "color": "0e588d", "description": "Improvements or modifications to docs" },
-            { "name": "Type ◦ Git Action",            "color": "030406", "description": "GitHub Action / workflow" },
+          { "name": "Type › Feature",               "color": "3c4e93", "description": "Feature request" },
-            { "name": "Type ◦ Pull Request",          "color": "8F1784", "description": "Normal pull request" },
+          { "name": "Type › Git Action",            "color": "030406", "description": "GitHub Action / workflow" },
-            { "name": "Type ◦ Roadmap",               "color": "8F1784", "description": "Feature or bug currently planned for implementation" },
+          { "name": "Type › Pull Request",          "color": "8F1784", "description": "Normal pull request" },
-            { "name": "Type ◦ Internal",              "color": "A51994", "description": "Assigned items are for internal developer use" },
+          { "name": "Type › Roadmap",               "color": "8F1784", "description": "Feature or bug currently planned for implementation" },
-            { "name": "Build ◦ Desktop",              "color": "c7ca4a", "description": "Specific to desktop" },
+          { "name": "Type › Internal",              "color": "A51994", "description": "Assigned items are for internal developer use" },
-            { "name": "Build ◦ Linux",                "color": "c7ca4a", "description": "Specific to Linux" },
+          { "name": "Build › Desktop",              "color": "c7ca4a", "description": "Specific to desktop" },
-            { "name": "Build ◦ MacOS",                "color": "c7ca4a", "description": "Specific to MacOS" },
+          { "name": "Build › Linux",                "color": "c7ca4a", "description": "Specific to Linux" },
-            { "name": "Build ◦ Mobile",               "color": "c7ca4a", "description": "Specific to mobile" },
+          { "name": "Build › MacOS",                "color": "c7ca4a", "description": "Specific to MacOS" },
-            { "name": "Build ◦ Web",                  "color": "c7ca4a", "description": "Specific to web" },
+          { "name": "Build › Mobile",               "color": "c7ca4a", "description": "Specific to mobile" },
-            { "name": "Build ◦ Windows",              "color": "c7ca4a", "description": "Specific to Windows" },
+          { "name": "Build › Web",                  "color": "c7ca4a", "description": "Specific to web" },
-            { "name": "› API",                        "color": "F99B50", "description": "Plugin API, CLI, browser JS API" },
+          { "name": "Build › Windows",              "color": "c7ca4a", "description": "Specific to Windows" },
-            { "name": "› Auto-type",                  "color": "9141E0", "description": "Auto-type functionality in desktop apps" },
+          { "name": "› API",                        "color": "F99B50", "description": "Plugin API, CLI, browser JS API" },
-            { "name": "› Browser",                    "color": "9141E0", "description": "Browser plugins and passing data to <=> from app" },
+          { "name": "› Auto-type",                  "color": "9141E0", "description": "Auto-type functionality in desktop apps" },
-            { "name": "› Customization",              "color": "E3F0FC", "description": "Customizations: plugins, themes, configs" },
+          { "name": "› Browser",                    "color": "9141E0", "description": "Browser plugins and passing data to <=> from app" },
-            { "name": "› Design",                     "color": "FA70DE", "description": "Design related queries" },
+          { "name": "› Customization",              "color": "E3F0FC", "description": "Customizations: plugins, themes, configs" },
-            { "name": "› Dist",                       "color": "FA70DE", "description": "Installers and other forms of software distribution" },
+          { "name": "› Design",                     "color": "FA70DE", "description": "Design related queries" },
-            { "name": "› Enterprise",                 "color": "11447a", "description": "Issues about collaboration, administration, and so on" },
+          { "name": "› Dist",                       "color": "FA70DE", "description": "Installers and other forms of software distribution" },
-            { "name": "› Hardware",                   "color": "5a7503", "description": "YubiKey, other tokens, biometrics" },
+          { "name": "› Enterprise",                 "color": "11447a", "description": "Issues about collaboration, administration, and so on" },
-            { "name": "› Import/Export",              "color": "F5FFCC", "description": "Import from and export to different file formats" },
+          { "name": "› Hardware",                   "color": "5a7503", "description": "YubiKey, other tokens, biometrics" },
-            { "name": "› Improvement",                "color": "185c98", "description": "Enhance an existing feature" },
+          { "name": "› Import/Export",              "color": "F5FFCC", "description": "Import from and export to different file formats" },
-            { "name": "› Performance",                "color": "006b75", "description": "Web and desktop performance issues" },
+          { "name": "› Improvement",                "color": "185c98", "description": "Enhance an existing feature" },
-            { "name": "› Plugin Request",             "color": "FCE9CA", "description": "Requested changes should be implemented as a plugin" },
+          { "name": "› Performance",                "color": "006b75", "description": "Web and desktop performance issues" },
-            { "name": "› Security",                   "color": "F75D39", "description": "Security issues" },
+          { "name": "› Plugin Request",             "color": "FCE9CA", "description": "Requested changes should be implemented as a plugin" },
-            { "name": "› Self-Hosting",               "color": "fad8c7", "description": "Self-hosting installations and configs" },
+          { "name": "› Security",                   "color": "F75D39", "description": "Security issues" },
-            { "name": "› Storage",                    "color": "5319e7", "description": "Storage providers: Dropbox, Google, WebDAV, etc." },
+          { "name": "› Self-Hosting",               "color": "fad8c7", "description": "Self-hosting installations and configs" },
-            { "name": "› Updater",                    "color": "1BADDE", "description": "Auto-updater issues" },
+          { "name": "› Storage",                    "color": "5319e7", "description": "Storage providers: Dropbox, Google, WebDAV, etc." },
-            { "name": "› UX",                         "color": "1BADDE", "description": "UX and usability" },
+          { "name": "› Updater",                    "color": "1BADDE", "description": "Auto-updater issues" },
-            { "name": "› Website",                    "color": "fef2c0", "description": "Website related issues" },
+          { "name": "› UX",                         "color": "1BADDE", "description": "UX and usability" },
-            { "name": "⚠ Urgent",                     "color": "a8740e", "description": "Requires urgent attention" },
+          { "name": "› Website",                    "color": "fef2c0", "description": "Website related issues" },
-            { "name": "⚠ Announcement",               "color": "DB4712", "description": "Announcements" },
+          { "name": "⚠ Urgent",                     "color": "a8740e", "description": "Requires urgent attention" },
-            { "name": "📰 Progress Report",           "color": "392297", "description": "Development updates" },
+          { "name": "⚠ Announcement",               "color": "DB4712", "description": "Announcements" },
-            { "name": "📦 Release",                   "color": "277542", "description": "Release announcements" },
+          { "name": "📰 Progress Report",           "color": "392297", "description": "Development updates" },
-            { "name": "✔️ Poll",                      "color": "972255", "description": "Community polls" },
+          { "name": "📦 Release",                   "color": "277542", "description": "Release announcements" },
-            { "name": "❔ Question",                  "color": "FFFFFF", "description": "All questions" }
+          { "name": "✔️ Poll",                      "color": "972255", "description": "Community polls" },
+          { "name": "❔ Question",                  "color": "FFFFFF", "description": "All questions" }
       ]
 
 # #
@@ -140,14 +152,17 @@ env:
 jobs:
 
     # #
-    #   Job › Autoscan
+    #   Job › PR Scan
+    #
+    #   automatically scan a pull request once it is submitted
     # #
 
-    job-pr-autoscan:
+    job-pr-scan:
-        name: 🎫 Issues › Autoscan
+        name: >-
-      # runs-on: ubuntu-latest
+            🎫 Issues › Autoscan
-        runs-on: apollo-x64
+        runs-on: ubuntu-latest
-        timeout-minutes: 7
+      # runs-on: apollo-x64
+        timeout-minutes: 5
         permissions:
             contents: read
             actions: read
@@ -156,27 +171,135 @@ jobs:
         steps:
 
             # #
-            #   Cleanup › Set Env Variables
+            #   PR › Scan › Checkout
+            # #
+
+            - name: '☑️ Checkout'
+              uses: actions/checkout@v4
+              with:
+                  fetch-depth: 0
+
+            # #
+            #   PR › Scan › Job Information
             # #
 
             - name: >-
-                🕛 Get Timestamp
+                  🔄 Load Job
-              id: task_autocheck_set_timestamp
+              uses: qoomon/actions--context@v4
-              run: |
+              id: 'context'
-                  echo "NOW=$(date +'%m-%d-%Y %H:%M:%S')" >> $GITHUB_ENV
-                  echo "NOW_SHORT=$(date +'%m-%d-%Y')" >> $GITHUB_ENV
-                  echo "NOW_LONG=$(date +'%m-%d-%Y %H:%M')" >> $GITHUB_ENV
-                  echo "NOW_DOCKER_LABEL=$(date +'%Y%m%d')" >> $GITHUB_ENV
 
             # #
+            #   PR › Scan › Start
+            # #
+
+            - name: >-
+                  ✅ Start
+              run: |
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo " Starting Job ${{ steps.context.outputs.job_name }}"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+
+                  YEAR="$(date +'%Y')"
+                  echo "YEAR=${YEAR}" >> $GITHUB_ENV
+
+                  NOW="$(date +'%m-%d-%Y %H:%M:%S')"                                                #  02-25-2025 12:49:48
+                  echo "NOW=${NOW}" >> $GITHUB_ENV
+
+                  NOW_SHORT="$(date +'%m-%d-%Y')"                                                   #  02-25-2025
+                  echo "NOW_SHORT=${NOW_SHORT}" >> $GITHUB_ENV
+
+                  NOW_LONG="$(date +'%m-%d-%Y %H:%M')"                                              #  02-25-2025 12:49
+                  echo "NOW_LONG=${NOW_LONG}" >> $GITHUB_ENV
+
+                  NOW_DOCKER="$(date +'%Y%m%d')"                                                    #  20250225
+                  echo "NOW_DOCKER=${NOW_DOCKER}" >> $GITHUB_ENV
+
+                  NOW_DOCKER_TS="$(date -u +'%FT%T.%3NZ')"                                          #  2025-02-25T12:50:11.569Z
+                  echo "NOW_DOCKER_TS=${NOW_DOCKER_TS}" >> $GITHUB_ENV
+
+                  SHA1="$(git rev-parse HEAD)"                                                      #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1=${SHA1}" >> $GITHUB_ENV
+
+                  SHA1_GH="$(echo ${GITHUB_SHA})"                                                   #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1_GH=${SHA1_GH}" >> $GITHUB_ENV
+
+                  PKG_VER_1DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -d '.' -f1-1)"              #  3.22 > 3
+                  echo "PKG_VER_1DIGIT=${PKG_VER_1DIGIT}" >> $GITHUB_ENV
+
+                  PKG_VER_2DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -f2 -d ":" | cut -c1-3)"    #  3.22 > 3.2
+                  echo "PKG_VER_2DIGIT=${PKG_VER_2DIGIT}" >> $GITHUB_ENV
+
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  sudo apt -qq update
+                  sudo apt -qq install tree
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo " Runner .............. ${{ runner.name }}"
+                  echo " Workflow ............ ${{ github.workflow }} (#${{ github.workflow_ref }})"
+                  echo " Run Number .......... ${{ github.run_number }}"
+                  echo " Ref ................. ${{ github.ref }}"
+                  echo " Ref Name ............ ${{ github.ref_name }}"
+                  echo " Event Name .......... ${{ github.event_name }}"
+                  echo " Repo ................ ${{ github.repository }}"
+                  echo " Repo Owner .......... ${{ github.repository_owner }}"
+                  echo " Run ID .............. https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+                  echo " Triggered By ........ ${{ github.actor }}"
+                  echo " SHA 1 (GITHUB_SHA) .. ${GITHUB_SHA}"
+                  echo " SHA 2 (github.sha) .. ${{ github.sha }}"
+                  echo " SHA 3 (env.SHA1) .... ${SHA1}"
+                  echo " SHA 4 (env.SHA1_GH) . ${SHA1_GH}"
+                  echo " Workspace ........... ${{ github.workspace }}"
+                  echo " PWD ................. ${PWD}"
+                  echo " Job Name ............ ${{ steps.context.outputs.job_name }}"
+                  echo " Job ID .............. ${{ steps.context.outputs.job_id }}"
+                  echo " Job URL ............. ${{ steps.context.outputs.job_url }}"
+                  echo " Run ID .............. ${{ steps.context.outputs.run_id }}"
+                  echo " Run Attempt ......... ${{ steps.context.outputs.run_attempt }}"
+                  echo " Run Number .......... ${{ steps.context.outputs.run_number }}"
+                  echo " Run URL ............. ${{ steps.context.outputs.run_url }}"
+                  echo " Run Env ............. ${{ steps.context.outputs.environment }}"
+                  echo " Run Env URL ......... ${{ steps.context.outputs.environment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Deployment URL .. ${{ steps.context.outputs.deployment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Runner Name ..... ${{ steps.context.outputs.runner_name }}"
+                  echo " Run Runner ID ....... ${{ steps.context.outputs.runner_id }}"
+                  echo " Year ................ ${YEAR}"
+                  echo " Now ................. ${NOW}"
+                  echo " Now (Short) ......... ${NOW_SHORT}"
+                  echo " Now (Long) .......... ${NOW_LONG}"
+                  echo " Now (Docker) ........ ${NOW_DOCKER}"
+                  echo " Now (Docker TS) ..... ${NOW_DOCKER_TS}"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  tree -I node_modules -I .git
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+
+            # #
+            #   PR Scan › Labels › Verify Existing
+            #
+            #   check if repo has all of the needed issue / pr labels; create label if not exists
+            #
             #   action needed if using 'pull_request' and 'issue_comment'
             #   to get the pull request, you would normally use ${{ github.event.number }}
             #   however this isnt available for 'issue_comment'
             # #
 
             - name: >-
-                  🏷️ Verify Existing Labels
+                  🎫 Labels › Verify Existing
-              id: task_autocheck_labels_verify
               uses: actions/github-script@v7
               with:
                   github-token: ${{ secrets.ADMINSERV_TOKEN_CL || github.token }}
@@ -191,7 +314,7 @@ jobs:
                                   owner:        context.repo.owner,
                                   repo:         context.repo.repo,
                                   name:         label.name,
-                                  description:  label.description || '',
+                                  description:  label.description || 'No Description',
                                   color:        label.color
                               });
                           }
@@ -209,13 +332,15 @@ jobs:
                       }
 
             # #
-            #   set issue number
+            #   PR Scan › Assign Pull Request ID to variable
+            #
+            #   get id (number) for pr when submitted
             # #
 
             - name: >-
-                  #️⃣ Issue number › Set
+                  #️⃣ Pull-Request ID › Set
+              id: task_prscan_issue_num_set
               uses: actions/github-script@v7
-              id: task_autocheck_issue_num_set
               with:
                   github-token: ${{ secrets.ADMINSERV_TOKEN_CL || github.token }}
                   script: |
@@ -244,41 +369,40 @@ jobs:
                   result-encoding: string
 
             # #
-            #   print issue number
+            #   PR Scan › Pull-Request ID › Print
+            #
+            #   prints the pr number detected
             # #
 
             - name: >-
-                  #️⃣ Issue number › Print
+                  #️⃣ Pull-Request ID › Print
-              id: task_autocheck_issue_num_get
               run: |
-                  echo '${{ steps.task_autocheck_issue_num_set.outputs.result }}'
+                  echo '${{ steps.task_prscan_issue_num_set.outputs.result }}'
 
             # #
-            #   checkout
+            #   PR Scan › Checkout
             # #
 
             - name: >-
                   ☑️ Checkout
-              id: task_autoscan_checkout
               uses: actions/checkout@v4
               if: |
                   ( github.event_name == 'pull_request_target' ) || ( github.event_name == 'pull_request' ) || ( github.event_name == 'issue_comment' && contains( github.event.comment.html_url, '/pull/' ) && contains( github.event.comment.body, '/rescan' ) )
               with:
                   token: ${{ secrets.ADMINSERV_TOKEN_CL || github.token }}
                   fetch-depth: 0
-                  ref: "refs/pull/${{ steps.task_autocheck_issue_num_set.outputs.result }}/merge"
+                  ref: "refs/pull/${{ steps.task_prscan_issue_num_set.outputs.result }}/merge"
 
             # #
-            #   nodejs
+            #   PR Scan › Setup NodeJS
             # #
 
             - name: >-
                   ⚙️ Setup Node
-              id: task_autocheck_nodejs
               uses: actions/setup-node@v4
 
             # #
-            #     get list of changed files
+            #     PR Scan › Get List of Changed Files
             #
             #     Effortlessly track all changed files and directories relative to a target branch,
             #     the current branch (preceding commit or the last remote commit), multiple branches,
@@ -288,49 +412,47 @@ jobs:
 
             - name: >-
                   📄 Get changed files
-              id: task_autocheck_changed_files_get
+              id: task_prscan_changed_files_get
               uses: tj-actions/changed-files@v46
               with:
                   separator: ","
 
             # #
-            #   list of changed files
+            #   PR Scan › List All Changed Files
             # #
 
             - name: >-
                   📄 List all added files
-              id: task_autocheck_added_files_get
+              id: task_prscan_added_files_get
               run: |
                   for file in ${CHANGED_FILES}; do
                       echo "$file was changed"
                   done
               env:
-                  ADDED_FILES:      ${{ steps.task_autocheck_changed_files_get.outputs.added_files }}
+                  ADDED_FILES:      ${{ steps.task_prscan_changed_files_get.outputs.added_files }}
-                  MODIFIED_FILES:   ${{ steps.task_autocheck_changed_files_get.outputs.modified_files }}
+                  MODIFIED_FILES:   ${{ steps.task_prscan_changed_files_get.outputs.modified_files }}
-                  CHANGED_FILES:    ${{ steps.task_autocheck_changed_files_get.outputs.all_changed_files }}
+                  CHANGED_FILES:    ${{ steps.task_prscan_changed_files_get.outputs.all_changed_files }}
-                  COUNT_ADDED:      ${{ steps.task_autocheck_changed_files_get.outputs.added_files_count }}
+                  COUNT_ADDED:      ${{ steps.task_prscan_changed_files_get.outputs.added_files_count }}
-                  COUNT_MODIFIED:   ${{ steps.task_autocheck_changed_files_get.outputs.modified_files_count }}
+                  COUNT_MODIFIED:   ${{ steps.task_prscan_changed_files_get.outputs.modified_files_count }}
-                  COUNT_DELETED:    ${{ steps.task_autocheck_changed_files_get.outputs.deleted_files_count }}
+                  COUNT_DELETED:    ${{ steps.task_prscan_changed_files_get.outputs.deleted_files_count }}
-                  COUNT_RENAMED:    ${{ steps.task_autocheck_changed_files_get.outputs.renamed_files_count }}
+                  COUNT_RENAMED:    ${{ steps.task_prscan_changed_files_get.outputs.renamed_files_count }}
-                  COUNT_COPIED:     ${{ steps.task_autocheck_changed_files_get.outputs.copied_files_count }}
+                  COUNT_COPIED:     ${{ steps.task_prscan_changed_files_get.outputs.copied_files_count }}
 
             # #
-            #   List directories
+            #   PR Scan › List Directories / File Structure
             # #
 
             - name: >-
                   📂 List Directories
-              id: task_autocheck_dirs_list
               run: |
                   ls
 
             # #
-            #   Run autocheck
+            #   PR Scan › Autocheck
             # #
 
             - name: >-
                   ☑️ Run Autocheck
-              id: task_autocheck_run
               uses: actions/github-script@v7
               with:
                   github-token: ${{ secrets.ADMINSERV_TOKEN_CL }}
@@ -358,8 +480,8 @@ jobs:
                                 "number": 32
                             },
                             "repo": {
-                                "owner": "TheBinaryNinja",
+                                "owner": "Aetherinox",
-                                "repo": "TVApp2"
+                                "repo": "TheRepoName"
                             },
                             "payload": {
                                 "action": "synchronize",
@@ -368,19 +490,19 @@ jobs:
                                 "number": 32,
                                 "organization": {
                                     "avatar_url": "https://avatars.githubusercontent.com/u/200161462?v=4",
-                                    "events_url": "https://api.github.com/orgs/TheBinaryNinja/events",
+                                    "events_url": "https://api.github.com/orgs/Aetherinox/events",
-                                    "hooks_url": "https://api.github.com/orgs/TheBinaryNinja/hooks",
+                                    "hooks_url": "https://api.github.com/orgs/Aetherinox/hooks",
-                                    "issues_url": "https://api.github.com/orgs/TheBinaryNinja/issues",
+                                    "issues_url": "https://api.github.com/orgs/Aetherinox/issues",
-                                    "login": "TheBinaryNinja",
+                                    "login": "Aetherinox",
-                                    "members_url": "https://api.github.com/orgs/TheBinaryNinja/members{/member}",
+                                    "members_url": "https://api.github.com/orgs/Aetherinox/members{/member}",
-                                    "public_members_url": "https://api.github.com/orgs/TheBinaryNinja/public_members{/member}",
+                                    "public_members_url": "https://api.github.com/orgs/Aetherinox/public_members{/member}",
-                                    "repos_url": "https://api.github.com/orgs/TheBinaryNinja/repos",
+                                    "repos_url": "https://api.github.com/orgs/Aetherinox/repos",
-                                    "url": "https://api.github.com/orgs/TheBinaryNinja"
+                                    "url": "https://api.github.com/orgs/Aetherinox"
                                 },
                                 "pull_request": {
                                     "created_at": "2025-03-17T23:32:22Z",
                                     "updated_at": "2025-03-17T23:32:22Z",
-                                    "url": "https://api.github.com/repos/TheBinaryNinja/tvapp2",
+                                    "url": "https://api.github.com/repos/Aetherinox/TheRepoName",
                                     "title": "Test PR Workflow",
                                     "head": {
                                         "ref": "main"
@@ -399,16 +521,16 @@ jobs:
                                           "id": 7821944832,
                                           "name": "AC › Passed",
                                           "node_id": "LA_kwDONW-GkM8AAAAB0jloAA",
-                                          "url": "https://api.github.com/repos/TheBinaryNinja/tvapp2/labels/AC%20%E2%80%BA%20Passed"
+                                          "url": "https://api.github.com/repos/Aetherinox/TheRepoName/labels/AC%20%E2%80%BA%20Passed"
                                       },
                                       {
                                           "color": "8F1784",
                                           "default": false,
                                           "description": "Normal pull request",
                                           "id": 7821944963,
-                                          "name": "Type ◦ Pull Request",
+                                          "name": "Type › Pull Request",
                                           "node_id": "LA_kwDONW-GkM8AAAAB0jlogw",
-                                          "url": "https://api.github.com/repos/TheBinaryNinja/tvapp2/labels/Type%20%E2%97%A6%20Pull%20Request"
+                                          "url": "https://api.github.com/repos/Aetherinox/TheRepoName/labels/Type%20%E2%97%A6%20Pull%20Request"
                                       }
                                   ]
                                 },
@@ -417,7 +539,7 @@ jobs:
                             "sha": "c938f7a21247f69b29cf352d0c6890a63f260d47",
                             "ref": "refs/heads/main",
                             "workflow": "🎫 Issues › Scan",
-                            "action": "task_autocheck_run",
+                            "action": "task_prscan_run",
                             "actor": "renovate[bot]",
                             "job": "job-pr-autoscan",
                             "runNumber": 45,
@@ -454,7 +576,7 @@ jobs:
                           labels.push(name);
                       });
 
-                      const files_List        = `${{ steps.task_autocheck_changed_files_get.outputs.all_changed_files }}` || ''
+                      const files_List        = `${{ steps.task_prscan_changed_files_get.outputs.all_changed_files }}` || ''
                       const files_Array       = files_List.split(',')
                       const branch_ref        = `${ ct.payload.pull_request.head.ref }`
 
@@ -507,11 +629,11 @@ jobs:
                       | Author | [ ` + ct.payload.pull_request.user.login + ` ](https://github.com/` + ct.repo.owner + `/) |
                       | Repo | [ ` + ct.repo.repo + ` ](https://github.com/` + ct.repo.owner + `/` + ct.repo.repo + `) |
                       | Branch | [ ` + ct.payload.pull_request.head.ref + `](https://github.com/` + ct.repo.owner + `/` + ct.repo.repo + `/tree/` + ct.payload.pull_request.head.ref + `) ⇁ [ ` + ct.payload.pull_request.base.ref + `](https://github.com/` + ct.repo.owner + `/` + ct.repo.repo + `/tree/` + ct.payload.pull_request.base.ref + `) |
-                      | Added Files | ${{ steps.task_autocheck_changed_files_get.outputs.added_files_count }} |
+                      | Added Files | ${{ steps.task_prscan_changed_files_get.outputs.added_files_count }} |
-                      | Modified Files | ${{ steps.task_autocheck_changed_files_get.outputs.all_modified_files_count }} |
+                      | Modified Files | ${{ steps.task_prscan_changed_files_get.outputs.all_modified_files_count }} |
-                      | Renamed Files | ${{ steps.task_autocheck_changed_files_get.outputs.renamed_files_count }} |
+                      | Renamed Files | ${{ steps.task_prscan_changed_files_get.outputs.renamed_files_count }} |
-                      | Copied Files | ${{ steps.task_autocheck_changed_files_get.outputs.deleted_files_count }} |
+                      | Copied Files | ${{ steps.task_prscan_changed_files_get.outputs.deleted_files_count }} |
-                      | Deleted Files | ${{ steps.task_autocheck_changed_files_get.outputs.deleted_files_count }} |
+                      | Deleted Files | ${{ steps.task_prscan_changed_files_get.outputs.deleted_files_count }} |
                       `;
 
                       message.push        ( md_table );
@@ -542,7 +664,21 @@ jobs:
                       const type_dependency =
                       [
                           "dependabot/npm_and_yarn",
-                          "renovate/github_actions"
+                          "renovate/github_actions",
+                          "renovate/testing-library",
+                          "renovate/electron",
+                          "renovate/aetherinox/noxenv",
+                          "renovate/playwright",
+                          "renovate/types",
+                          "renovate/@types",
+                          "renovate/eslint",
+                          "renovate/stylistic",
+                          "renovate/jimp",
+                          "renovate/custom-electron-prompt",
+                          "renovate/moment",
+                          "renovate/semver",
+                          "renovate/toasted",
+                          "renovate/uuid"
                       ];
 
                       const type_gitaction =
@@ -551,6 +687,11 @@ jobs:
                           "renovate/github_actions"
                       ];
 
+                      const type_maint =
+                      [
+                          "renovate/lock-file-maintenance"
+                      ];
+
                       const files_skipList =
                       [
                           ".github",
@@ -907,11 +1048,14 @@ jobs:
 
                       const bGitaction    = type_gitaction.some( s => s.includes( branch_ref ) || branch_ref.includes( s ) );
                       const bDependency   = type_dependency.some( s => s.includes( branch_ref ) || branch_ref.includes( s ) );
+                      const bMaintenance  = type_maint.some( s => s.includes( branch_ref ) || branch_ref.includes( s ) );
 
                       if ( actor ==  "${{ env.BOT_NAME_DEPENDABOT }}" && bDependency || actor ==  "${{ env.BOT_NAME_RENOVATE }}" && bDependency )
                           labels.push( "${{ env.LABEL_TYPE_DEPENDENCY }}" );
                       else if ( actor ==  "${{ env.BOT_NAME_DEPENDABOT }}" && bGitaction || actor ==  "${{ env.BOT_NAME_RENOVATE }}" && bGitaction )
                           labels.push( "${{ env.LABEL_TYPE_GITACTION }}" );
+                      else if ( actor ==  "${{ env.BOT_NAME_DEPENDABOT }}" && bMaintenance || actor ==  "${{ env.BOT_NAME_RENOVATE }}" && bMaintenance )
+                          labels.push( "${{ env.LABEL_TYPE_MAINTENANCE }}" );
 
                       if ( ct.payload.pull_request.labels.filter( label => label.name === "${{ env.LABEL_CHECK_CHANGES_REQ }}" ).length > 0 )
                           labels.push( "${{ env.LABEL_CHECK_CHANGES_REQ }}" );
@@ -960,7 +1104,6 @@ jobs:
 
             - name: >-
                 🕛 Get Weekly Commit List
-              id: task_autocheck_set_weekly_commit_list
               run: |
                   echo 'WEEKLY_COMMITS<<EOF' >> $GITHUB_ENV
                   git log --format="[\`%h\`](${{ github.server_url }}/${{ github.repository }}/commit/%H) %s - %an" --since=7.days >> $GITHUB_ENV
@@ -972,16 +1115,15 @@ jobs:
 
             - name: >-
                 🔔 Send Discord Webhook Message (Success)
-              id: task_autocheck_notify_discord_success
               uses: tsickert/discord-webhook@v7.0.0
               if: success()
               with:
-                  username: 'Io'
+                  username: ${{ env.DISCORD_BOT_NAME }}
-                  avatar-url: 'https://i.imgur.com/8BVDkla.jpg'
+                  avatar-url: ${{ env.DISCORD_BOT_AVATAR }}
                   webhook-url: ${{ secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_WORKfLOWS }}
                   embed-title: "⚙️ ${{ github.workflow_ref }}"
                   embed-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-thumbnail-url: 'https://cdn.pixabay.com/photo/2022/01/30/13/33/github-6980894_960_720.png'
+                  embed-thumbnail-url: ${{ env.DISCORD_BOT_EMBED_THUMBNAIL }}
                   embed-description: |
                       ## 🎫 ᲼Issues › Scan ᲼${{ job.status == 'success' && '✅' || '❌' }}
 
@@ -1004,11 +1146,11 @@ jobs:
                       - Status: `${{ github.event.pull_request.state }}`
 
                       ### Scan Results
-                      - Added Files: ${{ steps.task_autocheck_changed_files_get.outputs.added_files_count }}
+                      - Added Files: ${{ steps.task_prscan_added_files_get.outputs.added_files_count }}
-                      - Modified Files: ${{ steps.task_autocheck_changed_files_get.outputs.all_modified_files_count }}
+                      - Modified Files: ${{ steps.task_prscan_added_files_get.outputs.all_modified_files_count }}
-                      - Renamed Files: ${{ steps.task_autocheck_changed_files_get.outputs.renamed_files_count }}
+                      - Renamed Files: ${{ steps.task_prscan_added_files_get.outputs.renamed_files_count }}
-                      - Copied Files: ${{ steps.task_autocheck_changed_files_get.outputs.copied_files_count }}
+                      - Copied Files: ${{ steps.task_prscan_added_files_get.outputs.copied_files_count }}
-                      - Deleted Files: ${{ steps.task_autocheck_changed_files_get.outputs.deleted_files_count }}
+                      - Deleted Files: ${{ steps.task_prscan_added_files_get.outputs.deleted_files_count }}
 
                   embed-color: ${{ job.status == 'success' && '5763719' || '15418782' }}
                   embed-footer-text: "Completed at ${{ env.NOW }} UTC"
@@ -1023,16 +1165,15 @@ jobs:
 
             - name: >-
                 🔔 Send Discord Webhook Message (Failure)
-              id: task_autocheck_notify_discord_failure
               uses: tsickert/discord-webhook@v7.0.0
               if: failure()
               with:
-                  username: 'Io'
+                  username: ${{ env.DISCORD_BOT_NAME }}
-                  avatar-url: 'https://i.imgur.com/8BVDkla.jpg'
+                  avatar-url: ${{ env.DISCORD_BOT_AVATAR }}
                   webhook-url: ${{ secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_WORKfLOWS }}
                   embed-title: "⚙️ ${{ github.workflow_ref }}"
                   embed-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-thumbnail-url: 'https://cdn.pixabay.com/photo/2022/01/30/13/33/github-6980894_960_720.png'
+                  embed-thumbnail-url: ${{ env.DISCORD_BOT_EMBED_THUMBNAIL }}
                   embed-description: |
                       ## 🎫 ᲼Issues › Scan ᲼${{ job.status == 'success' && '✅' || '❌' }}
 
@@ -1055,11 +1196,11 @@ jobs:
                       - Status: `${{ github.event.pull_request.state }}`
 
                       ### Scan Results
-                      - Added Files: ${{ steps.task_autocheck_changed_files_get.outputs.added_files_count }}
+                      - Added Files: ${{ steps.task_prscan_added_files_get.outputs.added_files_count }}
-                      - Modified Files: ${{ steps.task_autocheck_changed_files_get.outputs.all_modified_files_count }}
+                      - Modified Files: ${{ steps.task_prscan_added_files_get.outputs.all_modified_files_count }}
-                      - Renamed Files: ${{ steps.task_autocheck_changed_files_get.outputs.renamed_files_count }}
+                      - Renamed Files: ${{ steps.task_prscan_added_files_get.outputs.renamed_files_count }}
-                      - Copied Files: ${{ steps.task_autocheck_changed_files_get.outputs.copied_files_count }}
+                      - Copied Files: ${{ steps.task_prscan_added_files_get.outputs.copied_files_count }}
-                      - Deleted Files: ${{ steps.task_autocheck_changed_files_get.outputs.deleted_files_count }}
+                      - Deleted Files: ${{ steps.task_prscan_added_files_get.outputs.deleted_files_count }}
 
                   embed-color: ${{ job.status == 'success' && '5763719' || '15418782' }}
                   embed-footer-text: "Completed at ${{ env.NOW }} UTC"

.github/workflows/issues-stale.yml

@@ -3,19 +3,18 @@
 #   @author             Aetherinox
 #   @url                https://github.com/Aetherinox
 #   @usage              creates repository labels if they are not yet installed
-#                           issues marked as stale after 30 days, given tag Status 𐄂 Stale
+#                           issues marked as stale after 30 days, given tag Status › Stale
-#                           inactive issues closed after 180 days, given tag Status 𐄂 Locked
+#                           inactive issues closed after 180 days, given tag Status › Locked
-#                           inactive pr closed after 365 days, given tag Status 𐄂 Locked
+#                           inactive pr closed after 365 days, given tag Status › Locked
-#                           issues marked stale after 30 days, given tag Status 𐄂 Stale
+#                           issues marked stale after 30 days, given tag Status › Stale
-#                           issues marked closed 7 days after being marked stale, given tag Status 𐄂 Autoclosed
+#                           issues marked closed 7 days after being marked stale, given tag Status › Autoclosed
 #
 #   @notes              This Github action must be activated manually.  This workflow script will do the following:
-#
 #                           - Scan issues / pull requests and make sure they have properly assigned labels:
-#                           - `Bug`
+#                               - `Bug`
-#                           - `Feature`
+#                               - `Feature`
-#                           - `Urgent`
+#                               - `Urgent`
-#                           - `Roadmap`
+#                               - `Roadmap`
 #
 #                           - Workflow script will then scan each pr or issue and mark them as `Stale`
 #                               if they haven't had any replies in 30 days.
@@ -28,15 +27,20 @@
 #                       secrets.PYPI_API_TOKEN                                      self Pypi API token (production site) - https://pypi.org/
 #                       secrets.PYPI_API_TEST_TOKEN                                 self Pypi API token (test site) - https://test.pypi.org/
 #                       secrets.SELF_DOCKERHUB_TOKEN                                self Dockerhub token
-#                       secrets.ORG_BINARYNINJA_TOKEN                               org github personal access token (fine-grained)
+#                       secrets.CODECOV_TOKEN                                       codecov upload token for nodejs projects
-#                       secrets.ORG_BINARYNINJA_TOKEN_CL                            org github personal access token (classic)
+#                       secrets.MAXMIND_GELITE_TOKEN                                maxmind API token
-#                       secrets.ORG_BINARYNINJA_DOCKERHUB_TOKEN                     org dockerhub secret
+#                       secrets.CF_ACCOUNT_ID                                       cloudflare account id
-#                       secrets.ORG_BINARYNINJA_GITEA_TOKEN                         org gitea personal access token (classic) with package:write permission
+#                       secrets.CF_ACCOUNT_TOKEN                                    cloudflare account token
-#                       secrets.BINARYSERV_GPG_KEY_ASC                              bot gpg private key (armored) | BEGIN PGP PRIVATE KEY BLOCK
+#                       secrets.ORG_TOKEN                                           org github personal access token (fine-grained)
-#                       secrets.BINARYSERV_GPG_PASSPHRASE                           bot gpg private key passphrase
+#                       secrets.ORG_TOKEN_CL                                        org github personal access token (classic)
-#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_RELEASES         discord webhook to report release notifications from github to discord
+#                       secrets.ORG_DOCKERHUB_TOKEN                                 org dockerhub secret
-#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_WORKFLOWS        discord webhook to report workflow notifications from github to discord
+#                       secrets.ORG_GITEA_TOKEN                                     org gitea personal access token (classic) with package:write permission
-#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_UPDATES          discord webhook to report activity notifications from github to discord
+#                       secrets.BOT_GPG_KEY_ASC                                     bot gpg private key (armored) | BEGIN PGP PRIVATE KEY BLOCK
+#                       secrets.BOT_GPG_KEY_B64                                     bot gpg private key (binary) converted to base64
+#                       secrets.BOT_GPG_PASSPHRASE                                  bot gpg private key passphrase
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_RELEASES                discord webhook to report release notifications from github to discord
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_WORKFLOWS               discord webhook to report workflow notifications from github to discord
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_UPDATES                 discord webhook to report activity notifications from github to discord
 #
 #   @local              these workflows can be tested locally through the use of `act`
 #                           https://github.com/nektos/act
@@ -48,8 +52,8 @@
 #                           act -W .github/workflows/issues-stale.yml -s TOKEN_CL=XXXXXXXXXX --pull=false
 # #
 
-name: "🎫 Issues › Stale"
+name: '🎫 Issues › Stale'
-run-name: "🎫 Issues › Stale"
+run-name: '🎫 Issues › Stale'
 
 # #
 #   triggers
@@ -57,76 +61,84 @@ run-name: "🎫 Issues › Stale"
 
 on:
     workflow_dispatch:
-    schedule:
+  # schedule:
-        - cron: "0 0 * * *"
+  #     - cron: "0 0 * * *"
 
 # #
 #   environment variables
 # #
 
 env:
-    PREFIX_BUG:                     "🐛 Bug"
+    PREFIX_BUG:                 "🐛 Bug"
-    PREFIX_DEPENDENCY:              "Dependency"
+    PREFIX_DEPENDENCY:          "Dependency"
-    PREFIX_DOCS:                    "Docs"
+    PREFIX_DOCS:                "Docs"
-    PREFIX_FEATURE:                 "💡 Feature"
+    PREFIX_FEATURE:             "💡 Feature"
-    PREFIX_GIT:                     "Git Action"
+    PREFIX_GIT:                 "Git Action"
-    PREFIX_PR:                      "PR"
+    PREFIX_PR:                  "PR"
-    PREFIX_ROADMAP:                 "🗺️ Roadmap"
+    PREFIX_ROADMAP:             "🗺️ Roadmap"
-    PREFIX_INTERNAL:                "Internal"
+    PREFIX_INTERNAL:            "Internal"
-    PREFIX_URGENT:                  "⚠ Urgent"
+    PREFIX_URGENT:              "⚠ Urgent"
 
-    LABEL_BUG:                     "Type ◦ Bug"
+    LABEL_BUG:                  "Type › Bug"
-    LABEL_DEPENDENCY:               "Type ◦ Dependency"
+    LABEL_DEPENDENCY:           "Type › Dependency"
-    LABEL_DOCS:                     "Type ◦ Docs"
+    LABEL_DOCS:                 "Type › Docs"
-    LABEL_FEATURE:                  "Type ◦ Feature"
+    LABEL_FEATURE:              "Type › Feature"
-    LABEL_GIT:                      "Type ◦ Git Action"
+    LABEL_GIT:                  "Type › Git Action"
-    LABEL_PR:                       "Type ◦ Pull Request"
+    LABEL_PR:                   "Type › Pull Request"
-    LABEL_ROADMAP:                  "Type ◦ Roadmap"
+    LABEL_ROADMAP:              "Type › Roadmap"
-    LABEL_INTERNAL:                 "Type ◦ Internal"
+    LABEL_INTERNAL:             "Type › Internal"
-    LABEL_URGENT:                   "⚠ Urgent"
+    LABEL_LOCKED:               "Status › Locked"
+    LABEL_STALE:                "Status › Stale"
+    LABEL_AUTOCLOSE:            "Status › Autoclosed"
+    LABEL_ACCEPTED:             "Status › Accepted"
+    LABEL_REVIEW:               "Status › Review"
+    LABEL_PENDING:              "Status › Pending"
+    LABEL_AC_REVIEW:            "AC › Review Required"
+    LABEL_URGENT:               "⚠ Urgent"
 
-    ASSIGN_USER:                    Aetherinox
+    ASSIGN_USER:                Aetherinox
-    BOT_NAME_1:                     EuropaServ
+    BOT_NAME_1:                 EuropaServ
-    BOT_NAME_2:                     BinaryServ
+    BOT_NAME_2:                 BinaryServ
-    BOT_NAME_DEPENDABOT:            dependabot[bot]
+    BOT_NAME_DEPENDABOT:        dependabot[bot]
-    BOT_NAME_RENOVATE:              renovate[bot]
+    BOT_NAME_RENOVATE:          renovate[bot]
 
     LABELS_JSON: |
       [
-          { "name": "AC › Changes Made",           "color": "8F1784", "description": "Requested changes have been made and are pending a re-scan" },
+          { "name": "AC › Changes Made",            "color": "8F1784", "description": "Requested changes have been made and are pending a re-scan" },
-          { "name": "AC › Changes Required",       "color": "8F1784", "description": "Requires changes to be made to the package before being accepted" },
+          { "name": "AC › Changes Required",        "color": "8F1784", "description": "Requires changes to be made to the package before being accepted" },
-          { "name": "AC › Failed",                 "color": "a61f2d", "description": "Autocheck failed to run through a complete cycle, requires investigation" },
+          { "name": "AC › Failed",                  "color": "a61f2d", "description": "Autocheck failed to run through a complete cycle, requires investigation" },
-          { "name": "AC › Needs Rebase",           "color": "8F1784", "description": "Due to the permissions on the requesting repo, this pull request must be rebased by the author" },
+          { "name": "AC › Needs Rebase",            "color": "8F1784", "description": "Due to the permissions on the requesting repo, this pull request must be rebased by the author" },
-          { "name": "AC › Passed",                 "color": "146b4a", "description": "Ready to be reviewed" },
+          { "name": "AC › Passed",                  "color": "146b4a", "description": "Ready to be reviewed" },
-          { "name": "AC › Review Required",        "color": "8F1784", "description": "PR needs to be reviewed by another person, after the requested changes have been made" },
+          { "name": "AC › Review Required",         "color": "8F1784", "description": "PR needs to be reviewed by another person, after the requested changes have been made" },
-          { "name": "AC › Security Warning",       "color": "761620", "description": "Does not conform to developer policies, or includes potentially dangerous code" },
+          { "name": "AC › Security Warning",        "color": "761620", "description": "Does not conform to developer policies, or includes potentially dangerous code" },
-          { "name": "AC › Skipped Scan",           "color": "8F1784", "description": "Author has skipped code scan" },
+          { "name": "AC › Skipped Scan",            "color": "8F1784", "description": "Author has skipped code scan" },
-          { "name": "Status 𐄂 Duplicate",          "color": "75536b", "description": "Issue or pull request already exists" },
+          { "name": "Status › Duplicate",           "color": "75536b", "description": "Issue or pull request already exists" },
-          { "name": "Status 𐄂 Accepted",            "color": "2e7539", "description": "This pull request has been accepted" },
+          { "name": "Status › Accepted",            "color": "2e7539", "description": "This pull request has been accepted" },
-          { "name": "Status 𐄂 Autoclosed",          "color": "3E0915", "description": "Originally stale and was autoclosed for no activity" },
+          { "name": "Status › Autoclosed",          "color": "3E0915", "description": "Originally stale and was autoclosed for no activity" },
-          { "name": "Status 𐄂 Denied",              "color": "ba4058", "description": "Pull request has been denied" },
+          { "name": "Status › Denied",              "color": "ba4058", "description": "Pull request has been denied" },
-          { "name": "Status 𐄂 Locked",              "color": "550F45", "description": "Automatically locked by AdminServ for a prolonged period of inactivity" },
+          { "name": "Status › Locked",              "color": "550F45", "description": "Automatically locked by AdminServ for a prolonged period of inactivity" },
-          { "name": "Status 𐄂 Need Info",           "color": "2E3C4C", "description": "Not enough information to resolve" },
+          { "name": "Status › Need Info",           "color": "2E3C4C", "description": "Not enough information to resolve" },
-          { "name": "Status 𐄂 No Action",           "color": "030406", "description": "Closed without any action being taken" },
+          { "name": "Status › No Action",           "color": "030406", "description": "Closed without any action being taken" },
-          { "name": "Status 𐄂 Pending",             "color": "984b12", "description": "Pending pull request" },
+          { "name": "Status › Pending",             "color": "984b12", "description": "Pending pull request" },
-          { "name": "Status 𐄂 Released",            "color": "1b6626", "description": "Issues or PR has been implemented and is now live" },
+          { "name": "Status › Released",            "color": "1b6626", "description": "Issues or PR has been implemented and is now live" },
-          { "name": "Status 𐄂 Reopened",            "color": "8a6f14", "description": "A previously closed PR which has been re-opened" },
+          { "name": "Status › Reopened",            "color": "8a6f14", "description": "A previously closed PR which has been re-opened" },
-          { "name": "Status 𐄂 Review",              "color": "9e1451", "description": "Currently pending review" },
+          { "name": "Status › Review",              "color": "9e1451", "description": "Currently pending review" },
-          { "name": "Status 𐄂 Stale",               "color": "928282", "description": "Has not had any activity in over 30 days" },
+          { "name": "Status › Stale",               "color": "928282", "description": "Has not had any activity in over 30 days" },
-          { "name": "Type ◦ Bug",                   "color": "9a2c2c", "description": "Something isn't working" },
+          { "name": "Type › Bug",                   "color": "9a2c2c", "description": "Something isn't working" },
-          { "name": "Type ◦ Dependency",            "color": "243759", "description": "Item is associated to dependency" },
+          { "name": "Type › Dependency",            "color": "243759", "description": "Item is associated to dependency" },
-          { "name": "Type ◦ Docs",                  "color": "0e588d", "description": "Improvements or modifications to docs" },
+          { "name": "Type › Lock Maintenance",      "color": "FBCA04", "description": "Sync package-lock.json" },
-          { "name": "Type ◦ Feature",               "color": "3c4e93", "description": "Feature request" },
+          { "name": "Type › Docs",                  "color": "0e588d", "description": "Improvements or modifications to docs" },
-          { "name": "Type ◦ Git Action",            "color": "030406", "description": "GitHub Action / workflow" },
+          { "name": "Type › Feature",               "color": "3c4e93", "description": "Feature request" },
-          { "name": "Type ◦ Pull Request",          "color": "8F1784", "description": "Normal pull request" },
+          { "name": "Type › Git Action",            "color": "030406", "description": "GitHub Action / workflow" },
-          { "name": "Type ◦ Roadmap",               "color": "8F1784", "description": "Feature or bug currently planned for implementation" },
+          { "name": "Type › Pull Request",          "color": "8F1784", "description": "Normal pull request" },
-          { "name": "Type ◦ Internal",              "color": "A51994", "description": "Assigned items are for internal developer use" },
+          { "name": "Type › Roadmap",               "color": "8F1784", "description": "Feature or bug currently planned for implementation" },
-          { "name": "Build ◦ Desktop",              "color": "c7ca4a", "description": "Specific to desktop" },
+          { "name": "Type › Internal",              "color": "A51994", "description": "Assigned items are for internal developer use" },
-          { "name": "Build ◦ Linux",                "color": "c7ca4a", "description": "Specific to Linux" },
+          { "name": "Build › Desktop",              "color": "c7ca4a", "description": "Specific to desktop" },
-          { "name": "Build ◦ MacOS",                "color": "c7ca4a", "description": "Specific to MacOS" },
+          { "name": "Build › Linux",                "color": "c7ca4a", "description": "Specific to Linux" },
-          { "name": "Build ◦ Mobile",               "color": "c7ca4a", "description": "Specific to mobile" },
+          { "name": "Build › MacOS",                "color": "c7ca4a", "description": "Specific to MacOS" },
-          { "name": "Build ◦ Web",                  "color": "c7ca4a", "description": "Specific to web" },
+          { "name": "Build › Mobile",               "color": "c7ca4a", "description": "Specific to mobile" },
-          { "name": "Build ◦ Windows",              "color": "c7ca4a", "description": "Specific to Windows" },
+          { "name": "Build › Web",                  "color": "c7ca4a", "description": "Specific to web" },
+          { "name": "Build › Windows",              "color": "c7ca4a", "description": "Specific to Windows" },
           { "name": "› API",                        "color": "F99B50", "description": "Plugin API, CLI, browser JS API" },
           { "name": "› Auto-type",                  "color": "9141E0", "description": "Auto-type functionality in desktop apps" },
           { "name": "› Browser",                    "color": "9141E0", "description": "Browser plugins and passing data to <=> from app" },
@@ -170,40 +182,143 @@ jobs:
         name: >-
             🎫 Labels › Verify Existing
         runs-on: ubuntu-latest
-        timeout-minutes: 4
+      # runs-on: apollo-x64
+        timeout-minutes: 5
         steps:
 
             # #
-            #   [ Create Labels ] Start
+            #   Labels › Create › Checkout
             # #
 
-            - name: >-
+            - name: '☑️ Checkout'
-                  ✅ Start
-              id: task_label_create_start
-              run: |
-                  echo "Assigning labels and assignees"
-
-            # #
-            #   [ Create Labels ] Checkout
-            # #
-
-            - name: >-
-                  ☑️ Checkout
-              id: task_label_create_checkout
               uses: actions/checkout@v4
               with:
                   fetch-depth: 0
 
             # #
-            #   [ Create Labels ] Verify Existing Labels
+            #   Labels › Create › Job Information
             # #
 
             - name: >-
-                  🏷️ Verify Existing Labels
+                  🔄 Load Job
-              id: task_label_create_verify
+              uses: qoomon/actions--context@v4
+              id: 'context'
+
+            # #
+            #   Labels › Create › Start
+            # #
+
+            - name: >-
+                  ✅ Start
+              run: |
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo " Starting Job ${{ steps.context.outputs.job_name }}"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+
+                  YEAR="$(date +'%Y')"
+                  echo "YEAR=${YEAR}" >> $GITHUB_ENV
+
+                  NOW="$(date +'%m-%d-%Y %H:%M:%S')"                                                #  02-25-2025 12:49:48
+                  echo "NOW=${NOW}" >> $GITHUB_ENV
+
+                  NOW_SHORT="$(date +'%m-%d-%Y')"                                                   #  02-25-2025
+                  echo "NOW_SHORT=${NOW_SHORT}" >> $GITHUB_ENV
+
+                  NOW_LONG="$(date +'%m-%d-%Y %H:%M')"                                              #  02-25-2025 12:49
+                  echo "NOW_LONG=${NOW_LONG}" >> $GITHUB_ENV
+
+                  NOW_DOCKER="$(date +'%Y%m%d')"                                                    #  20250225
+                  echo "NOW_DOCKER=${NOW_DOCKER}" >> $GITHUB_ENV
+
+                  NOW_DOCKER_TS="$(date -u +'%FT%T.%3NZ')"                                          #  2025-02-25T12:50:11.569Z
+                  echo "NOW_DOCKER_TS=${NOW_DOCKER_TS}" >> $GITHUB_ENV
+
+                  SHA1="$(git rev-parse HEAD)"                                                      #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1=${SHA1}" >> $GITHUB_ENV
+
+                  SHA1_GH="$(echo ${GITHUB_SHA})"                                                   #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1_GH=${SHA1_GH}" >> $GITHUB_ENV
+
+                  PKG_VER_1DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -d '.' -f1-1)"              #  3.22 > 3
+                  echo "PKG_VER_1DIGIT=${PKG_VER_1DIGIT}" >> $GITHUB_ENV
+
+                  PKG_VER_2DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -f2 -d ":" | cut -c1-3)"    #  3.22 > 3.2
+                  echo "PKG_VER_2DIGIT=${PKG_VER_2DIGIT}" >> $GITHUB_ENV
+
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  sudo apt -qq update
+                  sudo apt -qq install tree
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo " Runner .............. ${{ runner.name }}"
+                  echo " Workflow ............ ${{ github.workflow }} (#${{ github.workflow_ref }})"
+                  echo " Run Number .......... ${{ github.run_number }}"
+                  echo " Ref ................. ${{ github.ref }}"
+                  echo " Ref Name ............ ${{ github.ref_name }}"
+                  echo " Event Name .......... ${{ github.event_name }}"
+                  echo " Repo ................ ${{ github.repository }}"
+                  echo " Repo Owner .......... ${{ github.repository_owner }}"
+                  echo " Run ID .............. https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+                  echo " Triggered By ........ ${{ github.actor }}"
+                  echo " SHA 1 (GITHUB_SHA) .. ${GITHUB_SHA}"
+                  echo " SHA 2 (github.sha) .. ${{ github.sha }}"
+                  echo " SHA 3 (env.SHA1) .... ${SHA1}"
+                  echo " SHA 4 (env.SHA1_GH) . ${SHA1_GH}"
+                  echo " Workspace ........... ${{ github.workspace }}"
+                  echo " PWD ................. ${PWD}"
+                  echo " Job Name ............ ${{ steps.context.outputs.job_name }}"
+                  echo " Job ID .............. ${{ steps.context.outputs.job_id }}"
+                  echo " Job URL ............. ${{ steps.context.outputs.job_url }}"
+                  echo " Run ID .............. ${{ steps.context.outputs.run_id }}"
+                  echo " Run Attempt ......... ${{ steps.context.outputs.run_attempt }}"
+                  echo " Run Number .......... ${{ steps.context.outputs.run_number }}"
+                  echo " Run URL ............. ${{ steps.context.outputs.run_url }}"
+                  echo " Run Env ............. ${{ steps.context.outputs.environment }}"
+                  echo " Run Env URL ......... ${{ steps.context.outputs.environment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Deployment URL .. ${{ steps.context.outputs.deployment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Runner Name ..... ${{ steps.context.outputs.runner_name }}"
+                  echo " Run Runner ID ....... ${{ steps.context.outputs.runner_id }}"
+                  echo " Year ................ ${YEAR}"
+                  echo " Now ................. ${NOW}"
+                  echo " Now (Short) ......... ${NOW_SHORT}"
+                  echo " Now (Long) .......... ${NOW_LONG}"
+                  echo " Now (Docker) ........ ${NOW_DOCKER}"
+                  echo " Now (Docker TS) ..... ${NOW_DOCKER_TS}"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  tree -I node_modules -I .git
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+
+            # #
+            #   Issues (Stale) › Labels › Create › Verify Existing
+            #
+            #   check if repo has all of the needed issue / pr labels; create label if not exists
+            #
+            #   action needed if using 'pull_request' and 'issue_comment'
+            #   to get the pull request, you would normally use ${{ github.event.number }}
+            #   however this isnt available for 'issue_comment'
+            # #
+
+            - name: >-
+                  🎫 Labels › Verify Existing
               uses: actions/github-script@v7
               with:
-                  github-token: ${{ secrets.ADMINSERV_TOKEN_CL }}
+                  github-token: ${{ secrets.ADMINSERV_TOKEN_CL || github.token }}
                   script: |
                       const labels = JSON.parse( process.env.LABELS_JSON );
                       for ( const label of labels )
@@ -215,7 +330,7 @@ jobs:
                                   owner:        context.repo.owner,
                                   repo:         context.repo.repo,
                                   name:         label.name,
-                                  description:  label.description || '',
+                                  description:  label.description || 'No Description',
                                   color:        label.color
                               });
                           }
@@ -233,7 +348,7 @@ jobs:
                       }
 
     # #
-    #   Job [ Check Labels ]
+    #   Issues (Stale) › Labels › Assign Missing
     #
     #   Runs through all submissions to check for ones that have not been properly labeled
     #       - Bug
@@ -246,30 +361,140 @@ jobs:
         name: >-
             🎫 Labels › Assign Missing
         runs-on: ubuntu-latest
+      # runs-on: apollo-x64
         timeout-minutes: 4
         needs: job-labels-create
         steps:
 
             # #
-            #   [ Check Labels ] Checkout
+            #   Labels › Assign › Checkout
             # #
 
-            - name: "☑️ Prepare"
+            - name: '☑️ Checkout'
-              id: task_issues_nolabel_prepare
               uses: actions/checkout@v4
               with:
                   fetch-depth: 0
 
             # #
-            #   [ Check Labels ] Check
+            #   Labels › Assign › Job Information
-            #   Check if repo has labels currently added to issues
             # #
 
-            - name: 🏷️ Checking Issues
+            - name: >-
-              id: task_issues_nolabel_run
+                  🔄 Load Job
+              uses: qoomon/actions--context@v4
+              id: 'context'
+
+            # #
+            #   Labels › Assign › Start
+            # #
+
+            - name: >-
+                  ✅ Start
+              run: |
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo " Starting Job ${{ steps.context.outputs.job_name }}"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+
+                  YEAR="$(date +'%Y')"
+                  echo "YEAR=${YEAR}" >> $GITHUB_ENV
+
+                  NOW="$(date +'%m-%d-%Y %H:%M:%S')"                                                #  02-25-2025 12:49:48
+                  echo "NOW=${NOW}" >> $GITHUB_ENV
+
+                  NOW_SHORT="$(date +'%m-%d-%Y')"                                                   #  02-25-2025
+                  echo "NOW_SHORT=${NOW_SHORT}" >> $GITHUB_ENV
+
+                  NOW_LONG="$(date +'%m-%d-%Y %H:%M')"                                              #  02-25-2025 12:49
+                  echo "NOW_LONG=${NOW_LONG}" >> $GITHUB_ENV
+
+                  NOW_DOCKER="$(date +'%Y%m%d')"                                                    #  20250225
+                  echo "NOW_DOCKER=${NOW_DOCKER}" >> $GITHUB_ENV
+
+                  NOW_DOCKER_TS="$(date -u +'%FT%T.%3NZ')"                                          #  2025-02-25T12:50:11.569Z
+                  echo "NOW_DOCKER_TS=${NOW_DOCKER_TS}" >> $GITHUB_ENV
+
+                  SHA1="$(git rev-parse HEAD)"                                                      #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1=${SHA1}" >> $GITHUB_ENV
+
+                  SHA1_GH="$(echo ${GITHUB_SHA})"                                                   #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1_GH=${SHA1_GH}" >> $GITHUB_ENV
+
+                  PKG_VER_1DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -d '.' -f1-1)"              #  3.22 > 3
+                  echo "PKG_VER_1DIGIT=${PKG_VER_1DIGIT}" >> $GITHUB_ENV
+
+                  PKG_VER_2DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -f2 -d ":" | cut -c1-3)"    #  3.22 > 3.2
+                  echo "PKG_VER_2DIGIT=${PKG_VER_2DIGIT}" >> $GITHUB_ENV
+
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  sudo apt -qq update
+                  sudo apt -qq install tree
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo " Runner .............. ${{ runner.name }}"
+                  echo " Workflow ............ ${{ github.workflow }} (#${{ github.workflow_ref }})"
+                  echo " Run Number .......... ${{ github.run_number }}"
+                  echo " Ref ................. ${{ github.ref }}"
+                  echo " Ref Name ............ ${{ github.ref_name }}"
+                  echo " Event Name .......... ${{ github.event_name }}"
+                  echo " Repo ................ ${{ github.repository }}"
+                  echo " Repo Owner .......... ${{ github.repository_owner }}"
+                  echo " Run ID .............. https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+                  echo " Triggered By ........ ${{ github.actor }}"
+                  echo " SHA 1 (GITHUB_SHA) .. ${GITHUB_SHA}"
+                  echo " SHA 2 (github.sha) .. ${{ github.sha }}"
+                  echo " SHA 3 (env.SHA1) .... ${SHA1}"
+                  echo " SHA 4 (env.SHA1_GH) . ${SHA1_GH}"
+                  echo " Workspace ........... ${{ github.workspace }}"
+                  echo " PWD ................. ${PWD}"
+                  echo " Job Name ............ ${{ steps.context.outputs.job_name }}"
+                  echo " Job ID .............. ${{ steps.context.outputs.job_id }}"
+                  echo " Job URL ............. ${{ steps.context.outputs.job_url }}"
+                  echo " Run ID .............. ${{ steps.context.outputs.run_id }}"
+                  echo " Run Attempt ......... ${{ steps.context.outputs.run_attempt }}"
+                  echo " Run Number .......... ${{ steps.context.outputs.run_number }}"
+                  echo " Run URL ............. ${{ steps.context.outputs.run_url }}"
+                  echo " Run Env ............. ${{ steps.context.outputs.environment }}"
+                  echo " Run Env URL ......... ${{ steps.context.outputs.environment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Deployment URL .. ${{ steps.context.outputs.deployment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Runner Name ..... ${{ steps.context.outputs.runner_name }}"
+                  echo " Run Runner ID ....... ${{ steps.context.outputs.runner_id }}"
+                  echo " Year ................ ${YEAR}"
+                  echo " Now ................. ${NOW}"
+                  echo " Now (Short) ......... ${NOW_SHORT}"
+                  echo " Now (Long) .......... ${NOW_LONG}"
+                  echo " Now (Docker) ........ ${NOW_DOCKER}"
+                  echo " Now (Docker TS) ..... ${NOW_DOCKER_TS}"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  tree -I node_modules -I .git
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+
+            # #
+            #   Labels › Assign › Check
+            #
+            #   Check if repo has labels to use
+            # #
+
+            - name: >-
+                  🎫 Labels › Check
               uses: actions/github-script@v7
               with:
-                  github-token: ${{ secrets.ADMINSERV_TOKEN_CL }}
+                  github-token: ${{ secrets.ADMINSERV_TOKEN_CL || github.token }}
                   script: |
 
                     /*
@@ -278,19 +503,18 @@ jobs:
 
                     const dateTimeformat = ( date ) =>
                     {
-                        let month           = date.getMonth( ) + 1;
+                        let month               = date.getMonth( ) + 1;
-                        month               = month.toString( ).padStart( 2, '0' );
+                        month                   = month.toString( ).padStart( 2, '0' );
-                        let day             = date.getDate( ).toString( ).padStart( 2, '0' );
+                        let day                 = date.getDate( ).toString( ).padStart( 2, '0' );
-                        let year            = date.getFullYear( ).toString( ).padStart( 2, '0' );
+                        let year                = date.getFullYear( ).toString( ).padStart( 2, '0' );
 
-                        let hours           = date.getHours();
+                        let hours               = date.getHours();
-                        let minutes         = date.getMinutes();
+                        let minutes             = date.getMinutes();
-                        let x               = hours >= 12 ? 'PM' : 'AM';
+                        let x                   = hours >= 12 ? 'PM' : 'AM';
-                        hours               = hours % 12;
+                        hours                   = hours % 12;
-                        hours               = hours ? hours : 12;
+                        hours                   = hours ? hours : 12;
-                        minutes             = minutes.toString( ).padStart( 2, '0' );
+                        minutes                 = minutes.toString( ).padStart( 2, '0' );
-
+                        let mergeTime           = month + '.' + day + '.' + year + ' ' + hours + ':' + minutes + ' ' + x;
-                        let mergeTime   = month + '.' + day + '.' + year + ' ' + hours + ':' + minutes + ' ' + x;
 
                         return mergeTime;
                     }
@@ -315,7 +539,7 @@ jobs:
                         let date_UpdateHuman    = dateTimeformat( date_UpdateDate ) + " UTC";                       // 03.26.2024 4:40 PM UTC
                         const time_UpdateMs     = new Date( issue.updated_at ).getTime( );                          // 1711471241000
 
-                        //if ( curtime < time_UpdateMs + expireAfterMs ) continue;
+                        // if ( curtime < time_UpdateMs + expireAfterMs ) continue;
 
                         /*
                             Anything past this point is stale / to be closed
@@ -336,8 +560,8 @@ jobs:
                         let iss_body            = `${ issue.body }`;
                         const iss_body_lc       = iss_body.toLowerCase( );
 
-                        console.log( `      └── 📁 ` + iss_title );
+                        console.log( `      └── 📁 ` + iss_title + ` #${ issue.number }`);
-                        console.log( `         └── 📄 Issue #${ issue.number } last updated on ${ date_UpdateHuman }` );
+                        console.log( `         └── 📄 last updated on ${ date_UpdateHuman }` );
                         console.log( `         └── 📄 ${add_labels}` );
                         console.log( `\n\n` )
 
@@ -345,8 +569,8 @@ jobs:
                             Keywords
                         */
 
-                        const bug_words           = [ "bug", "broke", "issue", "fail" ];
+                        const bug_words           = [ "bug", "broke", "issue", "fail", "wont work" ];
-                        const feat_words          = [ "feature", "request", "add support" ];
+                        const feat_words          = [ "feature", "request", "add", "addition", "enhance", "create" ];
                         const urgn_words          = [ "urgent", "urgency", "emergency", "important", "critical" ];
                         const road_words          = [ "roadmap", "road map", "planned" ];
 
@@ -365,17 +589,14 @@ jobs:
 
                         /*
                             Label > Bugs
-                        */
 
-                        const bug_bIncWordT             = bug_words.some( s => s.includes( iss_title_lc ) || iss_title_lc.includes( s ) );
-
-                        /*
                             Find regex based phrases
 
                             Regex:
                                 https://regex101.com/r/Z99Gnq/2
                         */
 
+                        const bug_bIncWordT             = bug_words.some( s => s.includes( iss_title_lc ) || iss_title_lc.includes( s ) );
                         const bug_findWordList 	        = /^\b(?:I?\s*have\s*(?:a|an)\s*(?:issue|problem|bug))|(?:will\s*not\s*work)|(?:it\s*is\s*(?:broken|broke|stuck))|(?:found\s*(?:an?|the)\s*(?:bug|issue))|(?:can\s*I\s*fix\s*the\s*(?:bug|issue))|(?:(?:does not|doesn'?t|don'?t|won'?t|can'?t|can\s?not|will\s*not)\s*(?:work|load|function))|(?:it\s*(?:will\s?not|won'?t|can\s?not|can'?t))\s*(?:get|find)\s*the\s*(?:website|site|webpage|page)|(?:the\s*(?:window|frame)\s*is\s*(?:blank|white|empty|missing))\b$/igm;
                         const bug_bFoundMatchTitle      = Boolean( bug_findWordList.test( iss_title ) );
                         const bug_bFoundMatchBody       = Boolean( bug_findWordList.test( iss_body ) );
@@ -403,16 +624,49 @@ jobs:
                             if ( author === `${{ env.BOT_NAME_DEPENDABOT }}` )
                                 core.info( `Skipping: Detected ${ author }` )
 
-                            // Rename title to contain Bug:
+                            if ( author === `${{ env.BOT_NAME_RENOVATE }}` )
+                                core.info( `Skipping: Detected ${ author }` )
+
+                            /*
+                                Rename title to contain Bug:
+                                if bug title or body contains keyword hinting at the issue being about a bug; change the title of the issue
+
+                                @ref            https://jsfiddle.net/aetherinox/wj17x8mp/2/
+                            */
+
                             if ( author !== `${{ env.BOT_NAME_DEPENDABOT }}` && !bug_bFoundPRTitle && !iss_title_lc.startsWith( bug_tag.toLowerCase( ) ) && !iss_title_lc.startsWith( feat_tag.toLowerCase( ) ) && !iss_title_lc.startsWith( urgn_tag.toLowerCase( ) ) && !iss_title_lc.startsWith( road_tag.toLowerCase( ) ) )
                             {
-                                const title             = issue.title;
+
+                                /*
+                                    If a user creates an issue starting with our tag; strip it and add ours with the emoji instead
+                                        original:       Bug: CMD windows opens then closes, can't run the script.
+                                        new:            🐛 Bug: CMD windows opens then closes, can't run the script.
+                                */
+
+                                const removeBeginning1 		  = bug_tag.substring(3); 				        // "Bug:"
+                                let removeBeginning2 		    = bug_tag.substring(0);				          // "🐛 Bug:"
+                                removeBeginning2			      = removeBeginning2.replace(/\s/g, '')	  // "Bug:"
+
+                                if ( iss_title.startsWith(removeBeginning1) )
+                                {
+                                    iss_title = iss_title.slice(removeBeginning1.length);
+                                    iss_title = iss_title.trim();
+                                }
+                                else if ( iss_title.startsWith(removeBeginning2) )
+                                {
+                                    iss_title = iss_title.slice(removeBeginning2.length);
+                                    iss_title = iss_title.trim();
+                                }
+
+                                const title             = iss_title;
                                 let title_new           = title.replace( /^\s?bug\s*(.*?)\b/gi, '' );
-                                title_new         		  = title.replace( /^\s?fail\s*(.*?)\b/gi, '' );
+                                title_new               = title.replace( /^\s?fail\s*(.*?)\b/gi, '' );
-                                title_new         		  = title.replace( /^\s?issue\s*(.*?)\b/gi, '' );
+                                title_new               = title.replace( /^\s?issue\s*(.*?)\b/gi, '' );
                                 iss_title               = `${ bug_tag } ${ title_new }`;
                             }
 
+                            console.log( `New Title: ...................... ${ iss_title }` )
+
                             await github.rest.issues.update(
                             {
                                 owner: context.repo.owner, repo: context.repo.repo, issue_number: issue.number,
@@ -433,7 +687,7 @@ jobs:
                                 https://regex101.com/r/fR1Hm6/1
                         */
 
-                        const feat_findWordList 	      = /^(?:(?:request|include|see)\s*(?:an?|the?)\s*(?:feature|addon|addition|plugin))|(?:(?:add|see|get)\s*support\s*(?:for|with|of))|(?:can\s*we\s*get\s*(?:the|a)\s*(?:ability|feature))|(?:💡 Feature:)$/igm;
+                        const feat_findWordList 	      = /(?:(?:add|enjoy|would|like|can|request|include|see|could|have)\s*?(?:the|liked?|i|we|an?|the|you?)\s*?(?:to|have|an|get|ability|request|add|feature|functionality|addon|addition|plugin|create))|(?:(?:add|see|get)\s*?support\s*?(?:for|with|of))|(?:can\s*we\s*get\s*?(?:the|a)\s*?(?:ability|feature))|(?:💡 Feature:)$/igm;
                         const feat_bFoundMatchTitle     = Boolean( feat_findWordList.test( iss_title ) );
                         const feat_bFoundMatchBody      = Boolean( feat_findWordList.test( iss_body ) );
 
@@ -460,17 +714,49 @@ jobs:
                             if ( author === `${{ env.BOT_NAME_DEPENDABOT }}` )
                                 core.info( `Skipping: Detected ${ author }` )
 
-                            // Rename title to contain Feature:
+                            if ( author === `${{ env.BOT_NAME_RENOVATE }}` )
+                                core.info( `Skipping: Detected ${ author }` )
+
+                            /*
+                                Rename title to contain Feature:
+                                if feature title or body contains keyword hinting at the issue being about a feature; change the title of the issue
+
+                                @ref            https://jsfiddle.net/aetherinox/wj17x8mp/2/
+                            */
                             if ( author !== `${{ env.BOT_NAME_DEPENDABOT }}` && !feat_bFoundPRTitle && !iss_title_lc.startsWith( bug_tag.toLowerCase( ) ) && !iss_title_lc.startsWith( feat_tag.toLowerCase( ) ) && !iss_title_lc.startsWith( urgn_tag.toLowerCase( ) ) && !iss_title_lc.startsWith( road_tag.toLowerCase( ) ) )
                             {
-                                const title             = issue.title;
+
+                                /*
+                                    If a user creates an issue starting with our tag; strip it and add ours with the emoji instead
+                                        original:       Feature: CMD windows opens then closes, can't run the script.
+                                        new:            💡 Feature: CMD windows opens then closes, can't run the script.
+                                */
+
+                                const removeBeginning1 		  = feat_tag.substring(3); 				          // "Feature:"
+                                let removeBeginning2 		    = feat_tag.substring(0);				          // "💡 Feature:"
+                                removeBeginning2			      = removeBeginning2.replace(/\s/g, '')	    // "Feature:"
+
+                                if ( iss_title.startsWith(removeBeginning1) )
+                                {
+                                    iss_title = iss_title.slice(removeBeginning1.length);
+                                    iss_title = iss_title.trim();
+                                }
+                                else if ( iss_title.startsWith(removeBeginning2) )
+                                {
+                                    iss_title = iss_title.slice(removeBeginning2.length);
+                                    iss_title = iss_title.trim();
+                                }
+
+                                const title             = iss_title;
                                 let title_new           = title.replace( /^\s?feature\s*(.*?)\b/gi, '' );
                                 title_new               = title.replace( /^\s?request\s*(.*?)\b/gi, '' );
                                 title_new               = title.replace( /^\s?add(.*?)\s?feature\s*(.*?)\b/gi, '' );
                                 title_new               = title.replace( /^\s?add(.*?)\s?support\s*(.*?)\b/gi, '' );
-                                iss_title               = `${ feat_tag } ${ title_new }`;
+                                iss_title               = `${ feat_tag } ${ title_new }`; // change TAG per category
                             }
 
+                            console.log( `New Title: ...................... ${ iss_title }` )
+
                             await github.rest.issues.update(
                             {
                                 owner: context.repo.owner, repo: context.repo.repo, issue_number: issue.number,
@@ -518,10 +804,40 @@ jobs:
                             if ( author === `${{ env.BOT_NAME_DEPENDABOT }}` )
                                 core.info( `Skipping: Detected ${ author }` )
 
-                            // Rename title to contain Urgent:
+                            if ( author === `${{ env.BOT_NAME_RENOVATE }}` )
+                                core.info( `Skipping: Detected ${ author }` )
+
+                            /*
+                                Rename title to contain Urgent:
+                                if urgent title or body contains keyword hinting at the issue being about urgent; change the title of the issue
+
+                                @ref            https://jsfiddle.net/aetherinox/wj17x8mp/2/
+                            */
                             if ( author !== `${{ env.BOT_NAME_DEPENDABOT }}` && !urgn_bFoundPRTitle && !iss_title_lc.startsWith( bug_tag.toLowerCase( ) ) && !iss_title_lc.startsWith( feat_tag.toLowerCase( ) ) && !iss_title_lc.startsWith( urgn_tag.toLowerCase( ) ) && !iss_title_lc.startsWith( road_tag.toLowerCase( ) ) )
                             {
-                                const title             = issue.title;
+
+                                /*
+                                    If a user creates an issue starting with our tag; strip it and add ours with the emoji instead
+                                        original:       Urgent: CMD windows opens then closes, can't run the script.
+                                        new:            ⚠ Urgent: CMD windows opens then closes, can't run the script.
+                                */
+
+                                const removeBeginning1 		  = urgn_tag.substring(3); 				          // "Urgent:"
+                                let removeBeginning2 		    = urgn_tag.substring(0);				          // "⚠ Urgent:"
+                                removeBeginning2			      = removeBeginning2.replace(/\s/g, '')	    // "Urgent:"
+
+                                if ( iss_title.startsWith(removeBeginning1) )
+                                {
+                                    iss_title = iss_title.slice(removeBeginning1.length);
+                                    iss_title = iss_title.trim();
+                                }
+                                else if ( iss_title.startsWith(removeBeginning2) )
+                                {
+                                    iss_title = iss_title.slice(removeBeginning2.length);
+                                    iss_title = iss_title.trim();
+                                }
+
+                                const title             = iss_title;
                                 let title_new           = title.replace( /^\s?emergency\s*(.*?)\b/gi, '' );
                                 title_new               = title.replace( /^\s?urgent\s*(.*?)\b/gi, '' );
                                 title_new               = title.replace( /^\s?urgency\s*(.*?)\b/gi, '' );
@@ -530,6 +846,8 @@ jobs:
                                 iss_title               = `${ urgn_tag } ${ title_new }`;
                             }
 
+                            console.log( `New Title: ...................... ${ iss_title }` )
+
                             await github.rest.issues.update(
                             {
                                 owner: context.repo.owner, repo: context.repo.repo, issue_number: issue.number,
@@ -552,8 +870,8 @@ jobs:
                         */
 
                         const road_findWordList 	        = /#\s*Summary[\S\s]+#\s*(?:Proposal|Objective)[^\]]+/igm;
-                        const road_bFoundMatchTitle       = Boolean( road_findWordList.test( iss_title ) );
+                        const road_bFoundMatchTitle         = Boolean( road_findWordList.test( iss_title ) );
-                        const road_bFoundMatchBody        = Boolean( road_findWordList.test( iss_body ) );
+                        const road_bFoundMatchBody          = Boolean( road_findWordList.test( iss_body ) );
 
                         /*
                             Do not change a title if the item starts with a PR: #
@@ -562,8 +880,8 @@ jobs:
                                 https://regex101.com/r/JOrqbN/1
                         */
 
-                        const road_findPRTitle            = /^PR\s?#?(?:[0-9]*:)/igm;
+                        const road_findPRTitle              = /^PR\s?#?(?:[0-9]*:)/igm;
-                        const road_bFoundPRTitle          = Boolean( road_findPRTitle.test( iss_title ) );
+                        const road_bFoundPRTitle            = Boolean( road_findPRTitle.test( iss_title ) );
 
                         /*
                             - Check if issue title matches the issue label "Roadmap:"
@@ -578,18 +896,48 @@ jobs:
                             if ( author === `${{ env.BOT_NAME_DEPENDABOT }}` )
                                 core.info( `Skipping: Detected ${ author }` )
 
-                            // Rename title to contain Roadmap:
+                            if ( author === `${{ env.BOT_NAME_RENOVATE }}` )
+                                core.info( `Skipping: Detected ${ author }` )
+
+                            /*
+                                Rename title to contain Roadmap:
+                                if roadmap title or body contains keyword hinting at the issue being about roadmap; change the title of the issue
+
+                                @ref            https://jsfiddle.net/aetherinox/wj17x8mp/2/
+                            */
                             if ( author !== `${{ env.BOT_NAME_DEPENDABOT }}` && !road_bFoundPRTitle && !iss_title_lc.startsWith( bug_tag.toLowerCase( ) ) && !iss_title_lc.startsWith( feat_tag.toLowerCase( ) ) && !iss_title_lc.startsWith( urgn_tag.toLowerCase( ) ) && !iss_title_lc.startsWith( road_tag.toLowerCase( ) ) )
                             {
-                                const title             = issue.title;
+
-                                let title_new           = title.replace( /^\s?emergency\s*(.*?)\b/gi, '' );
+                                /*
-                                title_new               = title.replace( /^\s?urgent\s*(.*?)\b/gi, '' );
+                                    If a user creates an issue starting with our tag; strip it and add ours with the emoji instead
-                                title_new               = title.replace( /^\s?urgency\s*(.*?)\b/gi, '' );
+                                        original:       Roadmap: CMD windows opens then closes, can't run the script.
-                                title_new               = title.replace( /^\s?important\s*(.*?)\b/gi, '' );
+                                        new:            🗺️ Roadmap: CMD windows opens then closes, can't run the script.
-                                title_new               = title.replace( /^\s?critical\s*(.*?)\b/gi, '' );
+                                */
-                                iss_title               = `${ road_tag } ${ title_new }`;
+
+                                const removeBeginning1 		  = road_tag.substring(3); 				          // "Roadmap:"
+                                let removeBeginning2 		    = road_tag.substring(0);				          // "🗺️ Roadmap:"
+                                removeBeginning2			      = removeBeginning2.replace(/\s/g, '')	    // "Roadmap:"
+
+                                if ( iss_title.startsWith(removeBeginning1) )
+                                {
+                                    iss_title = iss_title.slice(removeBeginning1.length);
+                                    iss_title = iss_title.trim();
+                                }
+                                else if ( iss_title.startsWith(removeBeginning2) )
+                                {
+                                    iss_title = iss_title.slice(removeBeginning2.length);
+                                    iss_title = iss_title.trim();
+                                }
+
+                                const title             = iss_title;
+                                let title_new           = title.replace( /^\s?broad(.*?)\s?map\s*(.*?)\b/gi, '' );
+                                title_new               = title.replace( /^\s?planned\s*(.*?)\b/gi, '' );
+                                title_new               = title.replace( /^\s?broadmap\s*(.*?)\b/gi, '' );
+                                iss_title               = `${ road_tag } ${ title_new }`; // change TAG per category
                             }
 
+                            console.log( `New Title: ...................... ${ iss_title }` )
+
                             await github.rest.issues.update(
                             {
                                 owner: context.repo.owner, repo: context.repo.repo, issue_number: issue.number,
@@ -607,14 +955,15 @@ jobs:
                     }
 
     # #
-    #   Job [ Stale Issues ]
+    #   Issues (Stale) › Stale
     # #
 
     job-issues-stale:
         name: >-
-            💤 Check › Stale
+            💤 Scan › Check Stale
         runs-on: ubuntu-latest
-        timeout-minutes: 4
+      # runs-on: apollo-x64
+        timeout-minutes: 5
         needs:
             - job-labels-create
             - job-issues-nolabel
@@ -625,56 +974,57 @@ jobs:
         steps:
 
             # #
-            #   [ Stale Issues ] Check Condition
+            #   Labels › Stale › Check
             # #
 
-          - name: "💤 Stale › Check Condition"
+            - name: >-
-            uses: actions/stale@v9
+                  💤 Stale › Check Condition
-            id: task_issues_stale_run
+              uses: actions/stale@v9
-            with:
+              with:
-                repo-token: ${{ secrets.ADMINSERV_TOKEN_CL }}
+                  repo-token: ${{ secrets.ADMINSERV_TOKEN_CL || github.token }}
-                stale-issue-message: |
+                  stale-issue-message: |
-                    ⚠️ It looks like there hasn't been any recent updates on this issue.  If you created this issue and no longer consider it open, then please login to github and close the issue.
+                      ⚠️ It looks like there hasn't been any recent updates on this issue.  If you created this issue and no longer consider it open, then please login to github and close the issue.
 
-                    If there is no further activity on this issue, it will be automatically closed in the next week.
+                      If there is no further activity on this issue, it will be automatically closed in the next week.
 
-                    ---
+                      ---
 
-                    <sub>I am a bot reaching out to you with an automated response.</sub>
+                      <sub>I am a bot reaching out to you with an automated response.</sub>
-                stale-issue-label: 'Status 𐄂 Stale'
+                  stale-issue-label: '${{ env.LABEL_STALE }}'
-                close-issue-label: 'Status 𐄂 Autoclosed'
+                  close-issue-label: '${{ env.LABEL_AUTOCLOSE }}'
-                exempt-issue-labels: 'Status 𐄂 Accepted,Status 𐄂 Review,Status 𐄂 Pending,Type ◦ Bug,Type ◦ Dependency,Type ◦ Docs,Type ◦ Feature,Type ◦ Git Action,Type ◦ Pull Request,Type ◦ Roadmap'
+                  exempt-issue-labels: '${{ env.LABEL_ACCEPTED }},${{ env.LABEL_REVIEW }},${{ env.LABEL_PENDING }},${{ env.LABEL_BUG }},${{ env.LABEL_DEPENDENCY }},${{ env.LABEL_DOCS }},${{ env.LABEL_FEATURE }},${{ env.LABEL_GIT }},${{ env.LABEL_PR }},${{ env.LABEL_ROADMAP }}'
-                days-before-stale: 60
+                  days-before-stale: 120
-                days-before-close: 7
+                  days-before-close: 7
-                days-before-pr-stale: -1
+                  days-before-pr-stale: -1
-                days-before-pr-close: -1
+                  days-before-pr-close: -1
 
     # #
-    #   Job [ Lock Issues ]
+    #   Issues (Stale) › Lock
     # #
 
     job-issues-lock:
         name: >-
-            🔒 Check › Inactive
+            🔒 Scan › Lock Inactive
         runs-on: ubuntu-latest
-        timeout-minutes: 4
+      # runs-on: apollo-x64
+        timeout-minutes: 5
         needs:
             - job-labels-create
             - job-issues-nolabel
         steps:
 
             # #
-            #   [ Lock Issues ] Look for inactives
+            #   Labels › Inactive › Lock
             # #
 
-            - name: "🔒 Lock › Inactives"
+            - name: >-
+                  🔒 Inactive › Lock
               uses: dessant/lock-threads@v5
-              id: task_issues_lock_run
               with:
-                  github-token: ${{ secrets.ADMINSERV_TOKEN_CL }}
+                  github-token: ${{ secrets.ADMINSERV_TOKEN_CL || github.token }}
-                  exclude-any-issue-labels: 'AC › Review Required,Status 𐄂 Accepted,Status 𐄂 Review,Status 𐄂 Pending,Type ◦ Bug,Type ◦ Dependency,Type ◦ Docs,Type ◦ Feature,Type ◦ Git Action,Type ◦ Roadmap,Type ◦ Internal'
+                  exclude-any-issue-labels: '${{ env.LABEL_AC_REVIEW }},${{ env.LABEL_ACCEPTED }},${{ env.LABEL_REVIEW }},${{ env.LABEL_PENDING }},${{ env.LABEL_BUG }},${{ env.LABEL_DEPENDENCY }},${{ env.LABEL_DOCS }},${{ env.LABEL_FEATURE }},${{ env.LABEL_GIT }},${{ env.LABEL_ROADMAP }},${{ env.LABEL_INTERNAL }}'
-                  add-issue-labels: 'Status 𐄂 Locked'
+                  add-issue-labels: '${{ env.LABEL_LOCKED }}'
-                  issue-inactive-days: '60'
+                  issue-inactive-days: '120'
                   issue-lock-reason: 'resolved'
                   issue-comment: >
                       ⚠️ This **issue** has been automatically locked since there has not been any recent activity after it was closed.
@@ -684,8 +1034,8 @@ jobs:
                       ---
 
                       <sub>I am a bot reaching out to you with an automated response.</sub>
-                  exclude-any-pr-labels: 'AC › Review Required,Status 𐄂 Accepted,Status 𐄂 Review,Status 𐄂 Pending,Type ◦ Bug,Type ◦ Dependency,Type ◦ Docs,Type ◦ Feature,Type ◦ Git Action,Type ◦ Roadmap,Type ◦ Internal'
+                  exclude-any-pr-labels: '${{ env.LABEL_AC_REVIEW }},${{ env.LABEL_ACCEPTED }},${{ env.LABEL_REVIEW }},${{ env.LABEL_PENDING }},${{ env.LABEL_BUG }},${{ env.LABEL_DEPENDENCY }},${{ env.LABEL_DOCS }},${{ env.LABEL_FEATURE }},${{ env.LABEL_GIT }},${{ env.LABEL_ROADMAP }},${{ env.LABEL_INTERNAL }}'
-                  add-pr-labels: 'Status 𐄂 Locked'
+                  add-pr-labels: '${{ env.LABEL_LOCKED }}'
                   pr-inactive-days: '365'
                   pr-lock-reason: 'resolved'
                   pr-comment: >

.github/workflows/labels-clean.yml

@@ -13,15 +13,20 @@
 #                       secrets.PYPI_API_TOKEN                                      self Pypi API token (production site) - https://pypi.org/
 #                       secrets.PYPI_API_TEST_TOKEN                                 self Pypi API token (test site) - https://test.pypi.org/
 #                       secrets.SELF_DOCKERHUB_TOKEN                                self Dockerhub token
-#                       secrets.ORG_BINARYNINJA_TOKEN                               org github personal access token (fine-grained)
+#                       secrets.CODECOV_TOKEN                                       codecov upload token for nodejs projects
-#                       secrets.ORG_BINARYNINJA_TOKEN_CL                            org github personal access token (classic)
+#                       secrets.MAXMIND_GELITE_TOKEN                                maxmind API token
-#                       secrets.ORG_BINARYNINJA_DOCKERHUB_TOKEN                     org dockerhub secret
+#                       secrets.CF_ACCOUNT_ID                                       cloudflare account id
-#                       secrets.ORG_BINARYNINJA_GITEA_TOKEN                         org gitea personal access token (classic) with package:write permission
+#                       secrets.CF_ACCOUNT_TOKEN                                    cloudflare account token
-#                       secrets.BINARYSERV_GPG_KEY_ASC                              bot gpg private key (armored) | BEGIN PGP PRIVATE KEY BLOCK
+#                       secrets.ORG_TOKEN                                           org github personal access token (fine-grained)
-#                       secrets.BINARYSERV_GPG_PASSPHRASE                           bot gpg private key passphrase
+#                       secrets.ORG_TOKEN_CL                                        org github personal access token (classic)
-#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_RELEASES         discord webhook to report release notifications from github to discord
+#                       secrets.ORG_DOCKERHUB_TOKEN                                 org dockerhub secret
-#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_WORKFLOWS        discord webhook to report workflow notifications from github to discord
+#                       secrets.ORG_GITEA_TOKEN                                     org gitea personal access token (classic) with package:write permission
-#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_UPDATES          discord webhook to report activity notifications from github to discord
+#                       secrets.BOT_GPG_KEY_ASC                                     bot gpg private key (armored) | BEGIN PGP PRIVATE KEY BLOCK
+#                       secrets.BOT_GPG_KEY_B64                                     bot gpg private key (binary) converted to base64
+#                       secrets.BOT_GPG_PASSPHRASE                                  bot gpg private key passphrase
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_RELEASES                discord webhook to report release notifications from github to discord
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_WORKFLOWS               discord webhook to report workflow notifications from github to discord
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_UPDATES                 discord webhook to report activity notifications from github to discord
 #
 #   @local              these workflows can be tested locally through the use of `act`
 #                           https://github.com/nektos/act
@@ -33,8 +38,8 @@
 #                           act -W .github/workflows/labels-clean.yml -s TOKEN_CL=XXXXXXXXXX --pull=false
 # #
 
-name: "🎫 Labels › Remove"
+name: '🧹 Labels › Clean'
-run-name: "🎫 Labels › Remove"
+run-name: '🧹 Labels › Clean'
 
 # #
 #   triggers
@@ -65,40 +70,41 @@ env:
           { "name": "invalid",                      "color": "8F1784", "description": "Default github label" },
           { "name": "question",                     "color": "8F1784", "description": "Default github label" },
           { "name": "wontfix",                      "color": "8F1784", "description": "Default github label" },
-          { "name": "AC › Changes Made",           "color": "8F1784", "description": "Requested changes have been made and are pending a re-scan" },
+          { "name": "AC › Changes Made",            "color": "8F1784", "description": "Requested changes have been made and are pending a re-scan" },
-          { "name": "AC › Changes Required",       "color": "8F1784", "description": "Requires changes to be made to the package before being accepted" },
+          { "name": "AC › Changes Required",        "color": "8F1784", "description": "Requires changes to be made to the package before being accepted" },
-          { "name": "AC › Failed",                 "color": "a61f2d", "description": "Autocheck failed to run through a complete cycle, requires investigation" },
+          { "name": "AC › Failed",                  "color": "a61f2d", "description": "Autocheck failed to run through a complete cycle, requires investigation" },
-          { "name": "AC › Needs Rebase",           "color": "8F1784", "description": "Due to the permissions on the requesting repo, this pull request must be rebased by the author" },
+          { "name": "AC › Needs Rebase",            "color": "8F1784", "description": "Due to the permissions on the requesting repo, this pull request must be rebased by the author" },
-          { "name": "AC › Passed",                 "color": "146b4a", "description": "Ready to be reviewed" },
+          { "name": "AC › Passed",                  "color": "146b4a", "description": "Ready to be reviewed" },
-          { "name": "AC › Review Required",        "color": "8F1784", "description": "PR needs to be reviewed by another person, after the requested changes have been made" },
+          { "name": "AC › Review Required",         "color": "8F1784", "description": "PR needs to be reviewed by another person, after the requested changes have been made" },
-          { "name": "AC › Security Warning",       "color": "761620", "description": "Does not conform to developer policies, or includes potentially dangerous code" },
+          { "name": "AC › Security Warning",        "color": "761620", "description": "Does not conform to developer policies, or includes potentially dangerous code" },
-          { "name": "AC › Skipped Scan",           "color": "8F1784", "description": "Author has skipped code scan" },
+          { "name": "AC › Skipped Scan",            "color": "8F1784", "description": "Author has skipped code scan" },
-          { "name": "Status 𐄂 Duplicate",          "color": "75536b", "description": "Issue or pull request already exists" },
+          { "name": "Status › Duplicate",           "color": "75536b", "description": "Issue or pull request already exists" },
-          { "name": "Status 𐄂 Accepted",            "color": "2e7539", "description": "This pull request has been accepted" },
+          { "name": "Status › Accepted",            "color": "2e7539", "description": "This pull request has been accepted" },
-          { "name": "Status 𐄂 Autoclosed",          "color": "3E0915", "description": "Originally stale and was autoclosed for no activity" },
+          { "name": "Status › Autoclosed",          "color": "3E0915", "description": "Originally stale and was autoclosed for no activity" },
-          { "name": "Status 𐄂 Denied",              "color": "ba4058", "description": "Pull request has been denied" },
+          { "name": "Status › Denied",              "color": "ba4058", "description": "Pull request has been denied" },
-          { "name": "Status 𐄂 Locked",              "color": "550F45", "description": "Automatically locked by AdminServ for a prolonged period of inactivity" },
+          { "name": "Status › Locked",              "color": "550F45", "description": "Automatically locked by AdminServ for a prolonged period of inactivity" },
-          { "name": "Status 𐄂 Need Info",           "color": "2E3C4C", "description": "Not enough information to resolve" },
+          { "name": "Status › Need Info",           "color": "2E3C4C", "description": "Not enough information to resolve" },
-          { "name": "Status 𐄂 No Action",           "color": "030406", "description": "Closed without any action being taken" },
+          { "name": "Status › No Action",           "color": "030406", "description": "Closed without any action being taken" },
-          { "name": "Status 𐄂 Pending",             "color": "984b12", "description": "Pending pull request" },
+          { "name": "Status › Pending",             "color": "984b12", "description": "Pending pull request" },
-          { "name": "Status 𐄂 Released",            "color": "1b6626", "description": "Issues or PR has been implemented and is now live" },
+          { "name": "Status › Released",            "color": "1b6626", "description": "Issues or PR has been implemented and is now live" },
-          { "name": "Status 𐄂 Reopened",            "color": "8a6f14", "description": "A previously closed PR which has been re-opened" },
+          { "name": "Status › Reopened",            "color": "8a6f14", "description": "A previously closed PR which has been re-opened" },
-          { "name": "Status 𐄂 Review",              "color": "9e1451", "description": "Currently pending review" },
+          { "name": "Status › Review",              "color": "9e1451", "description": "Currently pending review" },
-          { "name": "Status 𐄂 Stale",               "color": "928282", "description": "Has not had any activity in over 30 days" },
+          { "name": "Status › Stale",               "color": "928282", "description": "Has not had any activity in over 30 days" },
-          { "name": "Type ◦ Bug",                   "color": "9a2c2c", "description": "Something isn't working" },
+          { "name": "Type › Bug",                   "color": "9a2c2c", "description": "Something isn't working" },
-          { "name": "Type ◦ Dependency",            "color": "243759", "description": "Item is associated to dependency" },
+          { "name": "Type › Dependency",            "color": "243759", "description": "Item is associated to dependency" },
-          { "name": "Type ◦ Docs",                  "color": "0e588d", "description": "Improvements or modifications to docs" },
+          { "name": "Type › Lock Maintenance",      "color": "FBCA04", "description": "Sync package-lock.json" },
-          { "name": "Type ◦ Feature",               "color": "3c4e93", "description": "Feature request" },
+          { "name": "Type › Docs",                  "color": "0e588d", "description": "Improvements or modifications to docs" },
-          { "name": "Type ◦ Git Action",            "color": "030406", "description": "GitHub Action / workflow" },
+          { "name": "Type › Feature",               "color": "3c4e93", "description": "Feature request" },
-          { "name": "Type ◦ Pull Request",          "color": "8F1784", "description": "Normal pull request" },
+          { "name": "Type › Git Action",            "color": "030406", "description": "GitHub Action / workflow" },
-          { "name": "Type ◦ Roadmap",               "color": "8F1784", "description": "Feature or bug currently planned for implementation" },
+          { "name": "Type › Pull Request",          "color": "8F1784", "description": "Normal pull request" },
-          { "name": "Type ◦ Internal",              "color": "A51994", "description": "Assigned items are for internal developer use" },
+          { "name": "Type › Roadmap",               "color": "8F1784", "description": "Feature or bug currently planned for implementation" },
-          { "name": "Build ◦ Desktop",              "color": "c7ca4a", "description": "Specific to desktop" },
+          { "name": "Type › Internal",              "color": "A51994", "description": "Assigned items are for internal developer use" },
-          { "name": "Build ◦ Linux",                "color": "c7ca4a", "description": "Specific to Linux" },
+          { "name": "Build › Desktop",              "color": "c7ca4a", "description": "Specific to desktop" },
-          { "name": "Build ◦ MacOS",                "color": "c7ca4a", "description": "Specific to MacOS" },
+          { "name": "Build › Linux",                "color": "c7ca4a", "description": "Specific to Linux" },
-          { "name": "Build ◦ Mobile",               "color": "c7ca4a", "description": "Specific to mobile" },
+          { "name": "Build › MacOS",                "color": "c7ca4a", "description": "Specific to MacOS" },
-          { "name": "Build ◦ Web",                  "color": "c7ca4a", "description": "Specific to web" },
+          { "name": "Build › Mobile",               "color": "c7ca4a", "description": "Specific to mobile" },
-          { "name": "Build ◦ Windows",              "color": "c7ca4a", "description": "Specific to Windows" },
+          { "name": "Build › Web",                  "color": "c7ca4a", "description": "Specific to web" },
+          { "name": "Build › Windows",              "color": "c7ca4a", "description": "Specific to Windows" },
           { "name": "› API",                        "color": "F99B50", "description": "Plugin API, CLI, browser JS API" },
           { "name": "› Auto-type",                  "color": "9141E0", "description": "Auto-type functionality in desktop apps" },
           { "name": "› Browser",                    "color": "9141E0", "description": "Browser plugins and passing data to <=> from app" },
@@ -137,12 +143,12 @@ jobs:
     #   This job removes all existing labels
     # #
 
-    issues-labels-remove:
+    issues-labels-clean:
         name: >-
-            🎫 Labels › Remove
+            🧹 Labels › Clean
-      # runs-on: ubuntu-latest
+        runs-on: ubuntu-latest
-        runs-on: apollo-x64
+      # runs-on: apollo-x64
-        timeout-minutes: 4
+        timeout-minutes: 3
         permissions:
             contents: 'read'
             id-token: 'write'
@@ -150,49 +156,132 @@ jobs:
         steps:
 
             # #
-            #   Labels › Start
+            #   Labels › Clean › Checkout
             # #
 
-            - name: >-
+            - name: '☑️ Checkout'
-                  ✅ Start
-              id: task_label_remove_start
-              run: |
-                  echo "Starting workflow"
-
-            # #
-            #   Labels › Set Env Variables
-            # #
-
-            - name: >-
-                🕛 Get Timestamp
-              id: task_label_set_timestamp
-              run: |
-                  echo "NOW=$(date +'%m-%d-%Y %H:%M:%S')" >> $GITHUB_ENV
-                  echo "NOW_SHORT=$(date +'%m-%d-%Y')" >> $GITHUB_ENV
-                  echo "NOW_LONG=$(date +'%m-%d-%Y %H:%M')" >> $GITHUB_ENV
-                  echo "NOW_DOCKER_LABEL=$(date +'%Y%m%d')" >> $GITHUB_ENV
-
-            # #
-            #   Labels › Checkout
-            # #
-
-            - name: >-
-                  ☑️ Checkout
-              id: task_label_remove_checkout
               uses: actions/checkout@v4
               with:
                   fetch-depth: 0
 
             # #
-            #   Labels › Start
+            #   Labels › Clean › Job Information
+            # #
+
+            - name: >-
+                  🔄 Load Job
+              uses: qoomon/actions--context@v4
+              id: 'context'
+
+            # #
+            #   Labels › Clean › Start
+            # #
+
+            - name: >-
+                  ✅ Start
+              run: |
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo " Starting Job ${{ steps.context.outputs.job_name }}"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+
+                  YEAR="$(date +'%Y')"
+                  echo "YEAR=${YEAR}" >> $GITHUB_ENV
+
+                  NOW="$(date +'%m-%d-%Y %H:%M:%S')"                                                #  02-25-2025 12:49:48
+                  echo "NOW=${NOW}" >> $GITHUB_ENV
+
+                  NOW_SHORT="$(date +'%m-%d-%Y')"                                                   #  02-25-2025
+                  echo "NOW_SHORT=${NOW_SHORT}" >> $GITHUB_ENV
+
+                  NOW_LONG="$(date +'%m-%d-%Y %H:%M')"                                              #  02-25-2025 12:49
+                  echo "NOW_LONG=${NOW_LONG}" >> $GITHUB_ENV
+
+                  NOW_DOCKER="$(date +'%Y%m%d')"                                                    #  20250225
+                  echo "NOW_DOCKER=${NOW_DOCKER}" >> $GITHUB_ENV
+
+                  NOW_DOCKER_TS="$(date -u +'%FT%T.%3NZ')"                                          #  2025-02-25T12:50:11.569Z
+                  echo "NOW_DOCKER_TS=${NOW_DOCKER_TS}" >> $GITHUB_ENV
+
+                  SHA1="$(git rev-parse HEAD)"                                                      #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1=${SHA1}" >> $GITHUB_ENV
+
+                  SHA1_GH="$(echo ${GITHUB_SHA})"                                                   #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1_GH=${SHA1_GH}" >> $GITHUB_ENV
+
+                  PKG_VER_1DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -d '.' -f1-1)"              #  3.22 > 3
+                  echo "PKG_VER_1DIGIT=${PKG_VER_1DIGIT}" >> $GITHUB_ENV
+
+                  PKG_VER_2DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -f2 -d ":" | cut -c1-3)"    #  3.22 > 3.2
+                  echo "PKG_VER_2DIGIT=${PKG_VER_2DIGIT}" >> $GITHUB_ENV
+
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  sudo apt -qq update
+                  sudo apt -qq install tree
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo " Runner .............. ${{ runner.name }}"
+                  echo " Workflow ............ ${{ github.workflow }} (#${{ github.workflow_ref }})"
+                  echo " Run Number .......... ${{ github.run_number }}"
+                  echo " Ref ................. ${{ github.ref }}"
+                  echo " Ref Name ............ ${{ github.ref_name }}"
+                  echo " Event Name .......... ${{ github.event_name }}"
+                  echo " Repo ................ ${{ github.repository }}"
+                  echo " Repo Owner .......... ${{ github.repository_owner }}"
+                  echo " Run ID .............. https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+                  echo " Triggered By ........ ${{ github.actor }}"
+                  echo " SHA 1 (GITHUB_SHA) .. ${GITHUB_SHA}"
+                  echo " SHA 2 (github.sha) .. ${{ github.sha }}"
+                  echo " SHA 3 (env.SHA1) .... ${SHA1}"
+                  echo " SHA 4 (env.SHA1_GH) . ${SHA1_GH}"
+                  echo " Workspace ........... ${{ github.workspace }}"
+                  echo " PWD ................. ${PWD}"
+                  echo " Job Name ............ ${{ steps.context.outputs.job_name }}"
+                  echo " Job ID .............. ${{ steps.context.outputs.job_id }}"
+                  echo " Job URL ............. ${{ steps.context.outputs.job_url }}"
+                  echo " Run ID .............. ${{ steps.context.outputs.run_id }}"
+                  echo " Run Attempt ......... ${{ steps.context.outputs.run_attempt }}"
+                  echo " Run Number .......... ${{ steps.context.outputs.run_number }}"
+                  echo " Run URL ............. ${{ steps.context.outputs.run_url }}"
+                  echo " Run Env ............. ${{ steps.context.outputs.environment }}"
+                  echo " Run Env URL ......... ${{ steps.context.outputs.environment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Deployment URL .. ${{ steps.context.outputs.deployment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Runner Name ..... ${{ steps.context.outputs.runner_name }}"
+                  echo " Run Runner ID ....... ${{ steps.context.outputs.runner_id }}"
+                  echo " Year ................ ${YEAR}"
+                  echo " Now ................. ${NOW}"
+                  echo " Now (Short) ......... ${NOW_SHORT}"
+                  echo " Now (Long) .......... ${NOW_LONG}"
+                  echo " Now (Docker) ........ ${NOW_DOCKER}"
+                  echo " Now (Docker TS) ..... ${NOW_DOCKER_TS}"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  tree -I node_modules -I .git
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+
+            # #
+            #   Labels › Clean › Delete Existing Labels
             # #
 
             - name: >-
                   🏷️ Delete Existing Labels
-              id: task_label_remove_run
               uses: actions/github-script@v7
               with:
-                  github-token: ${{ secrets.ADMINSERV_TOKEN_CL }}
+                  github-token: ${{ secrets.ADMINSERV_TOKEN_CL || github.token }}
                   script: |
                       const targetOwner = context.repo.owner;
                       const targetRepo = context.repo.repo;
@@ -239,83 +328,12 @@ jobs:
                       return result
 
             # #
-            #   Labels › Get Weekly Commits
+            #   Labels › Clean › Get Weekly Commits
             # #
 
             - name: >-
                 🕛 Get Weekly Commit List
-              id: task_label_set_weekly_commit_list
               run: |
                   echo 'WEEKLY_COMMITS<<EOF' >> $GITHUB_ENV
                   git log --format="[\`%h\`](${{ github.server_url }}/${{ github.repository }}/commit/%H) %s - %an" --since=7.days >> $GITHUB_ENV
                   echo 'EOF' >> $GITHUB_ENV
-
-            # #
-            #   Labels › Notify Github › Success
-            # #
-
-            - name: >-
-                🔔 Send Discord Webhook Message (Success)
-              id: task_label_notify_discord_success
-              uses: tsickert/discord-webhook@v7.0.0
-              if: success()
-              with:
-                  username: 'Io'
-                  avatar-url: 'https://i.imgur.com/8BVDkla.jpg'
-                  webhook-url: ${{ secrets.DISCORD_WEBHOOK_CHAN_TVAPP2_WORKFLOWS }}
-                  embed-title: "⚙️ ${{ github.workflow_ref }}"
-                  embed-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-thumbnail-url: 'https://i.imgur.com/zDIzE8T.jpg'
-                  embed-description: |
-                      ## 🎫 ᲼Labels › Clean ᲼${{ job.status == 'success' && '✅' || '❌' }}
-
-                      A **successful** workflow has been ran to wipe all labels from your repository.
-
-                      **${{ steps.task_label_remove_run.outputs.result }}** labels have been removed.
-
-                      - Labels: `${{ steps.task_label_remove_run.outputs.result }} created`
-                      - Workflow: `${{ github.workflow }} (#${{github.run_number}})`
-                      - Runner: `${{ runner.name }}`
-                      - Triggered By: `${{ github.actor }}`
-                      - Status: `${{ job.status == 'success' && '✅ Successful' || '❌ Failed' }}`
-
-                  embed-color: ${{ job.status == 'success' && '5763719' || '15418782' }}
-                  embed-footer-text: "Completed at ${{ env.NOW }} UTC"
-                  embed-timestamp: "${{ env.NOW_LONG }}"
-                  embed-author-name: "${{ github.repository_owner }}"
-                  embed-author-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-author-icon-url: "https://avatars.githubusercontent.com/u/200161462"
-
-            # #
-            #   Labels › Notify Github › Failure
-            # #
-
-            - name: >-
-                🔔 Send Discord Webhook Message (Failure)
-              id: task_label_notify_discord_failure
-              uses: tsickert/discord-webhook@v7.0.0
-              if: failure()
-              with:
-                  username: 'Io'
-                  avatar-url: 'https://i.imgur.com/8BVDkla.jpg'
-                  webhook-url: ${{ secrets.DISCORD_WEBHOOK_CHAN_TVAPP2_WORKFLOWS }}
-                  embed-title: "⚙️ ${{ github.workflow_ref }}"
-                  embed-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-thumbnail-url: 'https://i.imgur.com/zDIzE8T.jpg'
-                  embed-description: |
-                      ## 🎫 ᲼ Labels › Clean ᲼${{ job.status == 'success' && '✅' || '❌' }}
-
-                      A **failed** attempt was made to run this workflow. No new labels have been added to your repository.
-
-                      - Labels: `${{ steps.task_label_remove_run.outputs.result }} created`
-                      - Workflow: `${{ github.workflow }} (#${{github.run_number}})`
-                      - Runner: `${{ runner.name }}`
-                      - Triggered By: `${{ github.actor }}`
-                      - Status: `${{ job.status == 'success' && '✅ Successful' || '❌ Failed' }}`
-
-                  embed-color: ${{ job.status == 'success' && '5763719' || '15418782' }}
-                  embed-footer-text: "Completed at ${{ env.NOW }} UTC"
-                  embed-timestamp: "${{ env.NOW_LONG }}"
-                  embed-author-name: "${{ github.repository_owner }}"
-                  embed-author-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-author-icon-url: "https://avatars.githubusercontent.com/u/200161462"

.github/workflows/labels-create.yml

@@ -4,34 +4,26 @@
 #   @url                https://github.com/Aetherinox
 #   @usage              manually activated workflow to create issue labels
 #
-#   @notes              This Github action must be activated manually.  This workflow script will do the following:
-#
-#                           - Scan issues / pull requests and make sure they have properly assigned labels:
-#                             - `Bug`
-#                             - `Feature`
-#                             - `Urgent`
-#                             - `Roadmap`
-#
-#                         - Workflow script will then scan each pr or issue and mark them as `Stale`
-#                           if they haven't had any replies in 30 days.
-#
-#                         - Workflow will `autoclose` pr or issues which haven't had action in `365 days`.
-#
 #   @secrets            secrets.SELF_TOKEN                                          self github personal access token (fine-grained)
 #                       secrets.SELF_TOKEN_CL                                       self github personal access token (classic)
 #                       secrets.NPM_TOKEN                                           self npmjs access token
 #                       secrets.PYPI_API_TOKEN                                      self Pypi API token (production site) - https://pypi.org/
 #                       secrets.PYPI_API_TEST_TOKEN                                 self Pypi API token (test site) - https://test.pypi.org/
 #                       secrets.SELF_DOCKERHUB_TOKEN                                self Dockerhub token
-#                       secrets.ORG_BINARYNINJA_TOKEN                               org github personal access token (fine-grained)
+#                       secrets.CODECOV_TOKEN                                       codecov upload token for nodejs projects
-#                       secrets.ORG_BINARYNINJA_TOKEN_CL                            org github personal access token (classic)
+#                       secrets.MAXMIND_GELITE_TOKEN                                maxmind API token
-#                       secrets.ORG_BINARYNINJA_DOCKERHUB_TOKEN                     org dockerhub secret
+#                       secrets.CF_ACCOUNT_ID                                       cloudflare account id
-#                       secrets.ORG_BINARYNINJA_GITEA_TOKEN                         org gitea personal access token (classic) with package:write permission
+#                       secrets.CF_ACCOUNT_TOKEN                                    cloudflare account token
-#                       secrets.BINARYSERV_GPG_KEY_ASC                              bot gpg private key (armored) | BEGIN PGP PRIVATE KEY BLOCK
+#                       secrets.ORG_TOKEN                                           org github personal access token (fine-grained)
-#                       secrets.BINARYSERV_GPG_PASSPHRASE                           bot gpg private key passphrase
+#                       secrets.ORG_TOKEN_CL                                        org github personal access token (classic)
-#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_RELEASES         discord webhook to report release notifications from github to discord
+#                       secrets.ORG_DOCKERHUB_TOKEN                                 org dockerhub secret
-#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_WORKFLOWS        discord webhook to report workflow notifications from github to discord
+#                       secrets.ORG_GITEA_TOKEN                                     org gitea personal access token (classic) with package:write permission
-#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_UPDATES          discord webhook to report activity notifications from github to discord
+#                       secrets.BOT_GPG_KEY_ASC                                     bot gpg private key (armored) | BEGIN PGP PRIVATE KEY BLOCK
+#                       secrets.BOT_GPG_KEY_B64                                     bot gpg private key (binary) converted to base64
+#                       secrets.BOT_GPG_PASSPHRASE                                  bot gpg private key passphrase
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_RELEASES                discord webhook to report release notifications from github to discord
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_WORKFLOWS               discord webhook to report workflow notifications from github to discord
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_UPDATES                 discord webhook to report activity notifications from github to discord
 #
 #   @local              these workflows can be tested locally through the use of `act`
 #                           https://github.com/nektos/act
@@ -43,63 +35,122 @@
 #                           act -W .github/workflows/labels-create.yml -s TOKEN_CL=XXXXXXXXXX --pull=false
 # #
 
-name: "🎫 Labels › Create"
+name: '🎫 Labels › Create'
-run-name: "🎫 Labels › Create"
+run-name: '🎫 Labels › Create'
 
 # #
 #   triggers
 # #
 
 on:
+
+    # #
+    #   Trigger > Workflow Dispatch
+    # #
+
     workflow_dispatch:
+        inputs:
+
+            # #
+            #   Discord Bot › Name
+            #
+            #   The discord bot name
+            # #
+
+            DISCORD_BOT_NAME:
+                description:    '🤖 Bot Name'
+                required:       true
+                default:        'Europa'
+                type:           string
+
+            # #
+            #   Discord Bot › Avatar
+            #
+            #   The discord bot avatar to show; let's use some weird picture
+            # #
+
+            DISCORD_BOT_AVATAR:
+                description:    '🤖 Avatar URL'
+                required:       true
+                default:        'https://i.imgur.com/UqwMom1.jpeg'
+                type:           string
+
+            # #
+            #   Discord Bot › Author Icon URL
+            #
+            #   A small picture shown to the top-right of each post
+            # #
+
+            DISCORD_BOT_EMBED_AUTHOR_ICON:
+                description:    '🤖 Embed Author Icon'
+                required:       true
+                default:        'https://avatars.githubusercontent.com/u/200161462'
+                type:           string
+
+            # #
+            #   Discord Bot › Thumbnail URL
+            #
+            #   A small picture shown to the top-right of each post
+            # #
+
+            DISCORD_BOT_EMBED_THUMBNAIL:
+                description:    '🤖 Embed Thumbnail URL'
+                required:       true
+                default:        'https://avatars.githubusercontent.com/u/200161462'
+                type:           string
 
 # #
 #   environment variables
 # #
 
 env:
-    ASSIGN_USER:                    Aetherinox
+    DISCORD_BOT_NAME:                 ${{ github.event.inputs.DISCORD_BOT_NAME || 'Europa' }}
-    BOT_NAME_1:                     EuropaServ
+    DISCORD_BOT_AVATAR:               ${{ github.event.inputs.DISCORD_BOT_AVATAR || 'https://i.imgur.com/UqwMom1.jpeg' }}
-    BOT_NAME_2:                     BinaryServ
+    DISCORD_BOT_EMBED_AUTHOR_ICON:    ${{ github.event.inputs.DISCORD_BOT_EMBED_AUTHOR_ICON || 'https://avatars.githubusercontent.com/u/200161462' }}
-    BOT_NAME_DEPENDABOT:            dependabot[bot]
+    DISCORD_BOT_EMBED_THUMBNAIL:      ${{ github.event.inputs.DISCORD_BOT_EMBED_THUMBNAIL || 'https://avatars.githubusercontent.com/u/200161462' }}
-    BOT_NAME_RENOVATE:              renovate[bot]
+    ASSIGN_USER:                      Aetherinox
+    BOT_NAME_1:                       EuropaServ
+    BOT_NAME_2:                       BinaryServ
+    BOT_NAME_DEPENDABOT:              dependabot[bot]
+    BOT_NAME_RENOVATE:                renovate[bot]
 
     LABELS_JSON: |
       [
-          { "name": "AC › Changes Made",           "color": "8F1784", "description": "Requested changes have been made and are pending a re-scan" },
+          { "name": "AC › Changes Made",            "color": "8F1784", "description": "Requested changes have been made and are pending a re-scan" },
-          { "name": "AC › Changes Required",       "color": "8F1784", "description": "Requires changes to be made to the package before being accepted" },
+          { "name": "AC › Changes Required",        "color": "8F1784", "description": "Requires changes to be made to the package before being accepted" },
-          { "name": "AC › Failed",                 "color": "a61f2d", "description": "Autocheck failed to run through a complete cycle, requires investigation" },
+          { "name": "AC › Failed",                  "color": "a61f2d", "description": "Autocheck failed to run through a complete cycle, requires investigation" },
-          { "name": "AC › Needs Rebase",           "color": "8F1784", "description": "Due to the permissions on the requesting repo, this pull request must be rebased by the author" },
+          { "name": "AC › Needs Rebase",            "color": "8F1784", "description": "Due to the permissions on the requesting repo, this pull request must be rebased by the author" },
-          { "name": "AC › Passed",                 "color": "146b4a", "description": "Ready to be reviewed" },
+          { "name": "AC › Passed",                  "color": "146b4a", "description": "Ready to be reviewed" },
-          { "name": "AC › Review Required",        "color": "8F1784", "description": "PR needs to be reviewed by another person, after the requested changes have been made" },
+          { "name": "AC › Review Required",         "color": "8F1784", "description": "PR needs to be reviewed by another person, after the requested changes have been made" },
-          { "name": "AC › Security Warning",       "color": "761620", "description": "Does not conform to developer policies, or includes potentially dangerous code" },
+          { "name": "AC › Security Warning",        "color": "761620", "description": "Does not conform to developer policies, or includes potentially dangerous code" },
-          { "name": "AC › Skipped Scan",           "color": "8F1784", "description": "Author has skipped code scan" },
+          { "name": "AC › Skipped Scan",            "color": "8F1784", "description": "Author has skipped code scan" },
-          { "name": "Status 𐄂 Duplicate",          "color": "75536b", "description": "Issue or pull request already exists" },
+          { "name": "Status › Duplicate",           "color": "75536b", "description": "Issue or pull request already exists" },
-          { "name": "Status 𐄂 Accepted",            "color": "2e7539", "description": "This pull request has been accepted" },
+          { "name": "Status › Accepted",            "color": "2e7539", "description": "This pull request has been accepted" },
-          { "name": "Status 𐄂 Autoclosed",          "color": "3E0915", "description": "Originally stale and was autoclosed for no activity" },
+          { "name": "Status › Autoclosed",          "color": "3E0915", "description": "Originally stale and was autoclosed for no activity" },
-          { "name": "Status 𐄂 Denied",              "color": "ba4058", "description": "Pull request has been denied" },
+          { "name": "Status › Denied",              "color": "ba4058", "description": "Pull request has been denied" },
-          { "name": "Status 𐄂 Locked",              "color": "550F45", "description": "Automatically locked by AdminServ for a prolonged period of inactivity" },
+          { "name": "Status › Locked",              "color": "550F45", "description": "Automatically locked by AdminServ for a prolonged period of inactivity" },
-          { "name": "Status 𐄂 Need Info",           "color": "2E3C4C", "description": "Not enough information to resolve" },
+          { "name": "Status › Need Info",           "color": "2E3C4C", "description": "Not enough information to resolve" },
-          { "name": "Status 𐄂 No Action",           "color": "030406", "description": "Closed without any action being taken" },
+          { "name": "Status › No Action",           "color": "030406", "description": "Closed without any action being taken" },
-          { "name": "Status 𐄂 Pending",             "color": "984b12", "description": "Pending pull request" },
+          { "name": "Status › Pending",             "color": "984b12", "description": "Pending pull request" },
-          { "name": "Status 𐄂 Released",            "color": "1b6626", "description": "Issues or PR has been implemented and is now live" },
+          { "name": "Status › Released",            "color": "1b6626", "description": "Issues or PR has been implemented and is now live" },
-          { "name": "Status 𐄂 Reopened",            "color": "8a6f14", "description": "A previously closed PR which has been re-opened" },
+          { "name": "Status › Reopened",            "color": "8a6f14", "description": "A previously closed PR which has been re-opened" },
-          { "name": "Status 𐄂 Review",              "color": "9e1451", "description": "Currently pending review" },
+          { "name": "Status › Review",              "color": "9e1451", "description": "Currently pending review" },
-          { "name": "Status 𐄂 Stale",               "color": "928282", "description": "Has not had any activity in over 30 days" },
+          { "name": "Status › Stale",               "color": "928282", "description": "Has not had any activity in over 30 days" },
-          { "name": "Type ◦ Bug",                   "color": "9a2c2c", "description": "Something isn't working" },
+          { "name": "Type › Bug",                   "color": "9a2c2c", "description": "Something isn't working" },
-          { "name": "Type ◦ Dependency",            "color": "243759", "description": "Item is associated to dependency" },
+          { "name": "Type › Dependency",            "color": "243759", "description": "Item is associated to dependency" },
-          { "name": "Type ◦ Docs",                  "color": "0e588d", "description": "Improvements or modifications to docs" },
+          { "name": "Type › Lock Maintenance",      "color": "FBCA04", "description": "Sync package-lock.json" },
-          { "name": "Type ◦ Feature",               "color": "3c4e93", "description": "Feature request" },
+          { "name": "Type › Docs",                  "color": "0e588d", "description": "Improvements or modifications to docs" },
-          { "name": "Type ◦ Git Action",            "color": "030406", "description": "GitHub Action / workflow" },
+          { "name": "Type › Feature",               "color": "3c4e93", "description": "Feature request" },
-          { "name": "Type ◦ Pull Request",          "color": "8F1784", "description": "Normal pull request" },
+          { "name": "Type › Git Action",            "color": "030406", "description": "GitHub Action / workflow" },
-          { "name": "Type ◦ Roadmap",               "color": "8F1784", "description": "Feature or bug currently planned for implementation" },
+          { "name": "Type › Pull Request",          "color": "8F1784", "description": "Normal pull request" },
-          { "name": "Type ◦ Internal",              "color": "A51994", "description": "Assigned items are for internal developer use" },
+          { "name": "Type › Roadmap",               "color": "8F1784", "description": "Feature or bug currently planned for implementation" },
-          { "name": "Build ◦ Desktop",              "color": "c7ca4a", "description": "Specific to desktop" },
+          { "name": "Type › Internal",              "color": "A51994", "description": "Assigned items are for internal developer use" },
-          { "name": "Build ◦ Linux",                "color": "c7ca4a", "description": "Specific to Linux" },
+          { "name": "Build › Desktop",              "color": "c7ca4a", "description": "Specific to desktop" },
-          { "name": "Build ◦ MacOS",                "color": "c7ca4a", "description": "Specific to MacOS" },
+          { "name": "Build › Linux",                "color": "c7ca4a", "description": "Specific to Linux" },
-          { "name": "Build ◦ Mobile",               "color": "c7ca4a", "description": "Specific to mobile" },
+          { "name": "Build › MacOS",                "color": "c7ca4a", "description": "Specific to MacOS" },
-          { "name": "Build ◦ Web",                  "color": "c7ca4a", "description": "Specific to web" },
+          { "name": "Build › Mobile",               "color": "c7ca4a", "description": "Specific to mobile" },
-          { "name": "Build ◦ Windows",              "color": "c7ca4a", "description": "Specific to Windows" },
+          { "name": "Build › Web",                  "color": "c7ca4a", "description": "Specific to web" },
+          { "name": "Build › Windows",              "color": "c7ca4a", "description": "Specific to Windows" },
           { "name": "› API",                        "color": "F99B50", "description": "Plugin API, CLI, browser JS API" },
           { "name": "› Auto-type",                  "color": "9141E0", "description": "Auto-type functionality in desktop apps" },
           { "name": "› Browser",                    "color": "9141E0", "description": "Browser plugins and passing data to <=> from app" },
@@ -143,6 +194,8 @@ jobs:
         name: >-
             🎫 Labels › Create
         runs-on: ubuntu-latest
+      # runs-on: apollo-x64
+        timeout-minutes: 3
         permissions:
             contents: 'read'
             id-token: 'write'
@@ -150,41 +203,125 @@ jobs:
         steps:
 
             # #
-            #   [ Create Labels ] Start
+            #   Labels › Create › Checkout
             # #
 
-            - name: >-
+            - name: '☑️ Checkout'
-                  ✅ Start
-              id: task_label_create_start
-              run: |
-                  echo "Assigning labels and assignees"
-
-            # #
-            #   Create Labels › Set Env Variables
-            # #
-
-            - name: >-
-                🕛 Get Timestamp
-              id: task_label_set_timestamp
-              run: |
-                  echo "NOW=$(date +'%m-%d-%Y %H:%M:%S')" >> $GITHUB_ENV
-                  echo "NOW_SHORT=$(date +'%m-%d-%Y')" >> $GITHUB_ENV
-                  echo "NOW_LONG=$(date +'%m-%d-%Y %H:%M')" >> $GITHUB_ENV
-                  echo "NOW_DOCKER_LABEL=$(date +'%Y%m%d')" >> $GITHUB_ENV
-
-            # #
-            #   [ Create Labels ] Checkout
-            # #
-
-            - name: >-
-                  ☑️ Checkout
-              id: task_label_create_checkout
               uses: actions/checkout@v4
               with:
                   fetch-depth: 0
 
             # #
-            #   [ Create Labels ] Verify Existing Labels
+            #   Labels › Create › Job Information
+            # #
+
+            - name: >-
+                  🔄 Load Job
+              uses: qoomon/actions--context@v4
+              id: 'context'
+
+            # #
+            #   Labels › Create › Start
+            # #
+
+            - name: >-
+                  ✅ Start
+              run: |
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo " Starting Job ${{ steps.context.outputs.job_name }}"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+
+                  YEAR="$(date +'%Y')"
+                  echo "YEAR=${YEAR}" >> $GITHUB_ENV
+
+                  NOW="$(date +'%m-%d-%Y %H:%M:%S')"                                                #  02-25-2025 12:49:48
+                  echo "NOW=${NOW}" >> $GITHUB_ENV
+
+                  NOW_SHORT="$(date +'%m-%d-%Y')"                                                   #  02-25-2025
+                  echo "NOW_SHORT=${NOW_SHORT}" >> $GITHUB_ENV
+
+                  NOW_LONG="$(date +'%m-%d-%Y %H:%M')"                                              #  02-25-2025 12:49
+                  echo "NOW_LONG=${NOW_LONG}" >> $GITHUB_ENV
+
+                  NOW_DOCKER="$(date +'%Y%m%d')"                                                    #  20250225
+                  echo "NOW_DOCKER=${NOW_DOCKER}" >> $GITHUB_ENV
+
+                  NOW_DOCKER_TS="$(date -u +'%FT%T.%3NZ')"                                          #  2025-02-25T12:50:11.569Z
+                  echo "NOW_DOCKER_TS=${NOW_DOCKER_TS}" >> $GITHUB_ENV
+
+                  SHA1="$(git rev-parse HEAD)"                                                      #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1=${SHA1}" >> $GITHUB_ENV
+
+                  SHA1_GH="$(echo ${GITHUB_SHA})"                                                   #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1_GH=${SHA1_GH}" >> $GITHUB_ENV
+
+                  PKG_VER_1DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -d '.' -f1-1)"              #  3.22 > 3
+                  echo "PKG_VER_1DIGIT=${PKG_VER_1DIGIT}" >> $GITHUB_ENV
+
+                  PKG_VER_2DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -f2 -d ":" | cut -c1-3)"    #  3.22 > 3.2
+                  echo "PKG_VER_2DIGIT=${PKG_VER_2DIGIT}" >> $GITHUB_ENV
+
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  sudo apt -qq update
+                  sudo apt -qq install tree
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo " Runner .............. ${{ runner.name }}"
+                  echo " Workflow ............ ${{ github.workflow }} (#${{ github.workflow_ref }})"
+                  echo " Run Number .......... ${{ github.run_number }}"
+                  echo " Ref ................. ${{ github.ref }}"
+                  echo " Ref Name ............ ${{ github.ref_name }}"
+                  echo " Event Name .......... ${{ github.event_name }}"
+                  echo " Repo ................ ${{ github.repository }}"
+                  echo " Repo Owner .......... ${{ github.repository_owner }}"
+                  echo " Run ID .............. https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+                  echo " Triggered By ........ ${{ github.actor }}"
+                  echo " SHA 1 (GITHUB_SHA) .. ${GITHUB_SHA}"
+                  echo " SHA 2 (github.sha) .. ${{ github.sha }}"
+                  echo " SHA 3 (env.SHA1) .... ${SHA1}"
+                  echo " SHA 4 (env.SHA1_GH) . ${SHA1_GH}"
+                  echo " Workspace ........... ${{ github.workspace }}"
+                  echo " PWD ................. ${PWD}"
+                  echo " Job Name ............ ${{ steps.context.outputs.job_name }}"
+                  echo " Job ID .............. ${{ steps.context.outputs.job_id }}"
+                  echo " Job URL ............. ${{ steps.context.outputs.job_url }}"
+                  echo " Run ID .............. ${{ steps.context.outputs.run_id }}"
+                  echo " Run Attempt ......... ${{ steps.context.outputs.run_attempt }}"
+                  echo " Run Number .......... ${{ steps.context.outputs.run_number }}"
+                  echo " Run URL ............. ${{ steps.context.outputs.run_url }}"
+                  echo " Run Env ............. ${{ steps.context.outputs.environment }}"
+                  echo " Run Env URL ......... ${{ steps.context.outputs.environment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Deployment URL .. ${{ steps.context.outputs.deployment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Runner Name ..... ${{ steps.context.outputs.runner_name }}"
+                  echo " Run Runner ID ....... ${{ steps.context.outputs.runner_id }}"
+                  echo " Year ................ ${YEAR}"
+                  echo " Now ................. ${NOW}"
+                  echo " Now (Short) ......... ${NOW_SHORT}"
+                  echo " Now (Long) .......... ${NOW_LONG}"
+                  echo " Now (Docker) ........ ${NOW_DOCKER}"
+                  echo " Now (Docker TS) ..... ${NOW_DOCKER_TS}"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  tree -I node_modules -I .git
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+
+            # #
+            #   Labels › Create › Verify Existing Labels
             # #
 
             - name: >-
@@ -192,7 +329,7 @@ jobs:
               id: task_label_verify_existing
               uses: actions/github-script@v7
               with:
-                  github-token: ${{ secrets.ADMINSERV_TOKEN_CL }}
+                  github-token: ${{ secrets.ADMINSERV_TOKEN_CL || github.token }}
                   script: |
                       const labels = JSON.parse( process.env.LABELS_JSON );
                       let result = Object.keys(labels).length;
@@ -227,7 +364,7 @@ jobs:
                       return result
 
             # #
-            #   Cleanup › Get Weekly Commits
+            #   Labels › Create › Get Weekly Commits
             # #
 
             - name: >-
@@ -243,17 +380,16 @@ jobs:
             # #
 
             - name: >-
-                🔔 Send Discord Webhook Message (Success)
+                  🔔 Send Discord Webhook Message (Success)
-              id: task_label_notify_discord_success
               uses: tsickert/discord-webhook@v7.0.0
               if: success()
               with:
-                  username: 'Io'
+                  username: ${{ env.DISCORD_BOT_NAME }}
-                  avatar-url: 'https://i.imgur.com/8BVDkla.jpg'
+                  avatar-url: ${{ env.DISCORD_BOT_AVATAR }}
-                  webhook-url: ${{ secrets.DISCORD_WEBHOOK_CHAN_TVAPP2_WORKFLOWS }}
+                  webhook-url: ${{ secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_WORKfLOWS }}
                   embed-title: "⚙️ ${{ github.workflow_ref }}"
                   embed-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-thumbnail-url: 'https://i.imgur.com/zDIzE8T.jpg'
+                  embed-thumbnail-url: ${{ env.DISCORD_BOT_EMBED_THUMBNAIL }}
                   embed-description: |
                       ## 🎫 ᲼Labels › Create ᲼${{ job.status == 'success' && '✅' || '❌' }}
 
@@ -272,24 +408,23 @@ jobs:
                   embed-timestamp: "${{ env.NOW_LONG }}"
                   embed-author-name: "${{ github.repository_owner }}"
                   embed-author-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-author-icon-url: "https://avatars.githubusercontent.com/u/200161462"
+                  embed-author-icon-url: ${{ env.DISCORD_BOT_EMBED_AUTHOR_ICON }}
 
             # #
             #   Cleanup › Notify Github › Failure
             # #
 
             - name: >-
-                🔔 Send Discord Webhook Message (Failure)
+                  🔔 Send Discord Webhook Message (Failure)
-              id: task_label_notify_discord_failure
               uses: tsickert/discord-webhook@v7.0.0
               if: failure()
               with:
-                  username: 'Io'
+                  username: ${{ env.DISCORD_BOT_NAME }}
-                  avatar-url: 'https://i.imgur.com/8BVDkla.jpg'
+                  avatar-url: ${{ env.DISCORD_BOT_AVATAR }}
-                  webhook-url: ${{ secrets.DISCORD_WEBHOOK_CHAN_TVAPP2_WORKFLOWS }}
+                  webhook-url: ${{ secrets.DISCORD_WEBHOOK_CHAN_GITHUB_TVAPP2_WORKfLOWS }}
                   embed-title: "⚙️ ${{ github.workflow_ref }}"
                   embed-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-thumbnail-url: 'https://i.imgur.com/zDIzE8T.jpg'
+                  embed-thumbnail-url: ${{ env.DISCORD_BOT_EMBED_THUMBNAIL }}
                   embed-description: |
                       ## 🎫 ᲼Labels › Create ᲼${{ job.status == 'success' && '✅' || '❌' }}
 
@@ -306,5 +441,4 @@ jobs:
                   embed-timestamp: "${{ env.NOW_LONG }}"
                   embed-author-name: "${{ github.repository_owner }}"
                   embed-author-url: "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-                  embed-author-icon-url: "https://avatars.githubusercontent.com/u/200161462"
+                  embed-author-icon-url: ${{ env.DISCORD_BOT_EMBED_AUTHOR_ICON }}
-

.github/workflows/ping-developer.yml

@@ -0,0 +1,323 @@
+# #
+#   @type               github workflow
+#   @author             Aetherinox
+#   @url                https://github.com/Aetherinox
+#   @usage              pings the developer when an issue comment is made
+#
+#   @secrets            secrets.SELF_TOKEN                                          self github personal access token (fine-grained)
+#                       secrets.SELF_TOKEN_CL                                       self github personal access token (classic)
+#                       secrets.NPM_TOKEN                                           self npmjs access token
+#                       secrets.PYPI_API_TOKEN                                      self Pypi API token (production site) - https://pypi.org/
+#                       secrets.PYPI_API_TEST_TOKEN                                 self Pypi API token (test site) - https://test.pypi.org/
+#                       secrets.SELF_DOCKERHUB_TOKEN                                self Dockerhub token
+#                       secrets.CODECOV_TOKEN                                       codecov upload token for nodejs projects
+#                       secrets.MAXMIND_GELITE_TOKEN                                maxmind API token
+#                       secrets.CF_ACCOUNT_ID                                       cloudflare account id
+#                       secrets.CF_ACCOUNT_TOKEN                                    cloudflare account token
+#                       secrets.ORG_TOKEN                                           org github personal access token (fine-grained)
+#                       secrets.ORG_TOKEN_CL                                        org github personal access token (classic)
+#                       secrets.ORG_DOCKERHUB_TOKEN                                 org dockerhub secret
+#                       secrets.ORG_GITEA_TOKEN                                     org gitea personal access token (classic) with package:write permission
+#                       secrets.BOT_GPG_KEY_ASC                                     bot gpg private key (armored) | BEGIN PGP PRIVATE KEY BLOCK
+#                       secrets.BOT_GPG_KEY_B64                                     bot gpg private key (binary) converted to base64
+#                       secrets.BOT_GPG_PASSPHRASE                                  bot gpg private key passphrase
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_RELEASES                discord webhook to report release notifications from github to discord
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_WORKFLOWS               discord webhook to report workflow notifications from github to discord
+#                       secrets.DISCORD_WEBHOOK_CHAN_GITHUB_UPDATES                 discord webhook to report activity notifications from github to discord
+#
+#   @local              these workflows can be tested locally through the use of `act`
+#                           https://github.com/nektos/act
+#                       Extract act to folder
+#                       Add system env var with path to act.exe
+#                       Run the commands:
+#                           git pull https://github.com/username/repo
+#                           act -W .github/workflows/ping-developer.yml -P ubuntu-latest=catthehacker/ubuntu:full-22.04
+#                           act -W .github/workflows/ping-developer.yml -s TOKEN_CL=XXXXXXXXXX --pull=false
+# #
+
+name: '💬 Ping › Developer'
+run-name: '💬 Ping › Developer'
+
+# #
+#   triggers
+# #
+
+on:
+    issue_comment:
+        types: [created]
+
+# #
+#   environment variables
+# #
+
+env:
+    DEPLOYMENT_ENV:             ${{ github.event.inputs.DEPLOYMENT_ENV || 'orion' }}
+    BOT_NAME_1:                 EuropaServ
+    BOT_NAME_2:                 BinaryServ
+    BOT_NAME_DEPENDABOT:        dependabot[bot]
+    BOT_NAME_RENOVATE:          renovate[bot]
+
+# #
+#   jobs
+#
+#   env not available for job.if
+# #
+
+jobs:
+    deploy:
+        name: >-
+            💬 Issue › Accept
+        runs-on: ubuntu-latest
+      # runs-on: apollo-x64
+        timeout-minutes: 5
+        if: |
+            contains(github.event.comment.body, '/ping')
+        steps:
+
+            # #
+            #   Ping › Checkout
+            # #
+
+            - name: '☑️ Checkout'
+              uses: actions/checkout@v4
+              with:
+                  fetch-depth: 0
+
+            # #
+            #   Ping › Job Information
+            # #
+
+            - name: >-
+                  🔄 Load Job
+              uses: qoomon/actions--context@v4
+              id: 'context'
+
+            # #
+            #   Ping › Start
+            # #
+
+            - name: >-
+                  ✅ Start
+              run: |
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo " Starting Job ${{ steps.context.outputs.job_name }}"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+
+                  YEAR="$(date +'%Y')"
+                  echo "YEAR=${YEAR}" >> $GITHUB_ENV
+
+                  NOW="$(date +'%m-%d-%Y %H:%M:%S')"                                                #  02-25-2025 12:49:48
+                  echo "NOW=${NOW}" >> $GITHUB_ENV
+
+                  NOW_SHORT="$(date +'%m-%d-%Y')"                                                   #  02-25-2025
+                  echo "NOW_SHORT=${NOW_SHORT}" >> $GITHUB_ENV
+
+                  NOW_LONG="$(date +'%m-%d-%Y %H:%M')"                                              #  02-25-2025 12:49
+                  echo "NOW_LONG=${NOW_LONG}" >> $GITHUB_ENV
+
+                  NOW_DOCKER="$(date +'%Y%m%d')"                                                    #  20250225
+                  echo "NOW_DOCKER=${NOW_DOCKER}" >> $GITHUB_ENV
+
+                  NOW_DOCKER_TS="$(date -u +'%FT%T.%3NZ')"                                          #  2025-02-25T12:50:11.569Z
+                  echo "NOW_DOCKER_TS=${NOW_DOCKER_TS}" >> $GITHUB_ENV
+
+                  SHA1="$(git rev-parse HEAD)"                                                      #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1=${SHA1}" >> $GITHUB_ENV
+
+                  SHA1_GH="$(echo ${GITHUB_SHA})"                                                   #  71fad013cfce9116ec62779e4a7e627fe4c33627
+                  echo "SHA1_GH=${SHA1_GH}" >> $GITHUB_ENV
+
+                  PKG_VER_1DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -d '.' -f1-1)"              #  3.22 > 3
+                  echo "PKG_VER_1DIGIT=${PKG_VER_1DIGIT}" >> $GITHUB_ENV
+
+                  PKG_VER_2DIGIT="$(echo ${{ env.IMAGE_VERSION }} | cut -f2 -d ":" | cut -c1-3)"    #  3.22 > 3.2
+                  echo "PKG_VER_2DIGIT=${PKG_VER_2DIGIT}" >> $GITHUB_ENV
+
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  sudo apt -qq update
+                  sudo apt -qq install tree
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  echo " Runner .............. ${{ runner.name }}"
+                  echo " Workflow ............ ${{ github.workflow }} (#${{ github.workflow_ref }})"
+                  echo " Run Number .......... ${{ github.run_number }}"
+                  echo " Ref ................. ${{ github.ref }}"
+                  echo " Ref Name ............ ${{ github.ref_name }}"
+                  echo " Event Name .......... ${{ github.event_name }}"
+                  echo " Repo ................ ${{ github.repository }}"
+                  echo " Repo Owner .......... ${{ github.repository_owner }}"
+                  echo " Run ID .............. https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+                  echo " Triggered By ........ ${{ github.actor }}"
+                  echo " SHA 1 (GITHUB_SHA) .. ${GITHUB_SHA}"
+                  echo " SHA 2 (github.sha) .. ${{ github.sha }}"
+                  echo " SHA 3 (env.SHA1) .... ${SHA1}"
+                  echo " SHA 4 (env.SHA1_GH) . ${SHA1_GH}"
+                  echo " Workspace ........... ${{ github.workspace }}"
+                  echo " PWD ................. ${PWD}"
+                  echo " Job Name ............ ${{ steps.context.outputs.job_name }}"
+                  echo " Job ID .............. ${{ steps.context.outputs.job_id }}"
+                  echo " Job URL ............. ${{ steps.context.outputs.job_url }}"
+                  echo " Run ID .............. ${{ steps.context.outputs.run_id }}"
+                  echo " Run Attempt ......... ${{ steps.context.outputs.run_attempt }}"
+                  echo " Run Number .......... ${{ steps.context.outputs.run_number }}"
+                  echo " Run URL ............. ${{ steps.context.outputs.run_url }}"
+                  echo " Run Env ............. ${{ steps.context.outputs.environment }}"
+                  echo " Run Env URL ......... ${{ steps.context.outputs.environment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Deployment URL .. ${{ steps.context.outputs.deployment_url }}"
+                  echo " Run Deployment ...... ${{ steps.context.outputs.deployment_id }}"
+                  echo " Run Runner Name ..... ${{ steps.context.outputs.runner_name }}"
+                  echo " Run Runner ID ....... ${{ steps.context.outputs.runner_id }}"
+                  echo " Year ................ ${YEAR}"
+                  echo " Now ................. ${NOW}"
+                  echo " Now (Short) ......... ${NOW_SHORT}"
+                  echo " Now (Long) .......... ${NOW_LONG}"
+                  echo " Now (Docker) ........ ${NOW_DOCKER}"
+                  echo " Now (Docker TS) ..... ${NOW_DOCKER_TS}"
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+                  tree -I node_modules -I .git
+                  echo "‎"
+                  echo "‎"
+                  echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
+                  echo "‎"
+                  echo "‎"
+
+            # #
+            #   Ping › Developer › Send Mail
+            #   
+            #   Add Label to accepted PR
+            #   
+            #   port 465
+            #       server_port: 465
+            #       secure: true
+            #       ignore_cert: false
+            #   
+            #   port 587
+            #       server_port: 587
+            #       secure: false
+            # #
+
+            - name: >-
+                  📨 Send mail
+              id: task_ping_developer_mail
+              uses: dawidd6/action-send-mail@v5
+              with:
+                  server_address: ${{ secrets.EMAIL_SMTP }}
+                  server_port: 465
+                  secure: true
+                  username: ${{ secrets.EMAIL_FROM }}
+                  password: ${{ secrets.EMAIL_KEY }}
+                  subject: "Github: Ping notification from ${{ github.repository }}"
+                  to: ${{ secrets.EMAIL_TO }}
+                  from: ${{ secrets.EMAIL_FROM }}
+                  html_body: |
+                      <!DOCTYPE html>
+                      <html>
+                      <head>
+                      <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+                      <title>Title</title>
+
+                      <style>
+                      body {
+                      background: url('https://images.unsplash.com/photo-1541422348463-9bc715520974?fm=jpg&q=60&w=3000&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxzZWFyY2h8M3x8ZGFyayUyMG1vdW50YWlufGVufDB8fDB8fHww');
+                      font-size:9pt;
+                      margin:0;
+                      padding:0;
+                      }
+                      .background-overlay {
+                      background-color: #1111119f;
+                      }
+                      .background-header {
+                      background: url('https://process.fs.teachablecdn.com/ADNupMnWyR7kCWRvm76Laz/resize=width:705/https://cdn.filestackcontent.com/MipxnobQRRS5h7raz9aM');
+                      background-size: cover;
+                      background-size: 100%;
+                      background-color:#1b1b1b;
+                      padding:5px;
+                      height:100px;
+                      }
+                      </style>
+                      </head>
+
+                      <body>
+                      <div class="background-overlay">
+                      <center>
+                      <div class="background-header">
+                      <a href="https://github.com/${{ github.repository }}"><img style="height:80px;padding-top:10px;" src="https://cdn0.iconfinder.com/data/icons/shift-logotypes/32/Github-512.png"></a>
+                      </div>
+                      </center>
+
+                      <div style="font-size:9pt;padding: 20px;color:#FFF;">
+                      <h3><span style="font-size:9pt;color:#cc6613;">[Github]</span> <span style="font-size:9pt;color:#FFF;">Dear ${{github.repository_owner}},</span></h3>
+                      <p style="font-size:9pt;color:#FFF;"><br />You have received a ping notification from <a href="https://github.com/${{ github.repository }}">${{ github.repository }}</a> by <a href="https://github.com/${{ github.event.comment.user.login }}">${{ github.event.comment.user.login }}</a>.</p>
+                      <br>
+                      <br>
+                      <center>
+                      <table cellspacing="0" cellpadding="0" width="40%" class="center">
+                      <tbody>
+                      <tr>
+                      <td
+                      style="font-size:9pt;background-color:#8a2138;color:#FFF;padding:6px;padding-left:10px;"><b>Repository</b></td>
+                      <td style="font-size:9pt;padding-left:5px;color:#b3b3b3;background-color:#1b1b1b;padding-left:10px;">${{ github.repository }}</td>
+                      </tr>
+                      <tr>
+                      <td
+                      style="font-size:9pt;background-color:#8a2138;color:#FFF;padding:6px;padding-left:10px;"><b>Date</b></td>
+                      <td style="font-size:9pt;padding-left:5px;color:#b3b3b3;background-color:#0f0f0f;padding-left:10px;">${{ env.NOW }}</td>
+                      </tr>
+                      <tr>
+                      <td
+                      style="font-size:9pt;background-color:#8a2138;color:#FFF;padding:6px;padding-left:10px;"><b>Commenter</b></td>
+                      <td style="font-size:9pt;padding-left:5px;color:#b3b3b3;background-color:#1b1b1b;padding-left:10px;">${{ github.event.comment.user.login }}</td>
+                      </tr>
+                      <tr>
+                      <td
+                      style="font-size:9pt;background-color:#8a2138;color:#FFF;padding:6px;padding-left:10px;"><b>Issue #</b></td>
+                      <td style="font-size:9pt;padding-left:5px;color:#b3b3b3;background-color:#0f0f0f;padding-left:10px;">${{ github.event.issue.number }}</td>
+                      </tr>
+                      <tr>
+                      <td
+                      style="font-size:9pt;background-color:#8a2138;color:#FFF;padding:6px;padding-left:10px;"><b>Action</b></td>
+                      <td style="font-size:9pt;padding-left:5px;color:#b3b3b3;background-color:#1b1b1b;padding-left:10px;">Notification</td>
+                      </tr>
+                      </tbody>
+                      </table>
+                      </center>
+
+                      <br><br>
+
+                      <center>
+                      <div style="font-family:Consolas;">
+
+                      <textarea readonly=true style="font-size:9pt;width:60%;background-color:#363636;color:#FFF;padding:15px;border:1px solid #5a5a5a;" id="w3review" name="w3review" rows="20" cols="100">
+                      ${{ github.event.comment.body }}
+                      </textarea>
+
+                      </div>
+                      </center>
+
+                      <p>&nbsp;</p>
+                      <p style="color:#FFF;"><br /> ~ Github
+                      </p>
+                      </div>
+
+                      <br /><br />
+
+                      <div style="background-color:#1b1b1b;padding:5px;line-height:70px;height:70px;text-align:center;">
+                      <span style="color:#FFF;font-size:8pt;">Copyright &copy; ${{ env.YEAR }}</span>
+                      </div>
+                      </div>
+                      </body>
+                      </html>
+                  ignore_cert: true
+                  convert_markdown: true
+                  priority: normal

.github/workflows/release.yml

@@ -53,8 +53,8 @@ on:
                 type:               string
 
             # #
-            #   ENABLE:   the changelog generated in releases tab will only display single commits.
+            #   true            the changelog generated in releases tab will only display single commits.
-            #   DISABLE:  the changelog shows pull requests completed based on their labels
+            #   false           the changelog shows pull requests completed based on their labels
             # #
 
             CHANGELOG_MODE_COMMIT:
@@ -64,10 +64,10 @@ on:
                 type:               boolean
 
             # #
-            #   ENABLE:   Will show all types of commits, including uncategorized
+            #   true            Will show all types of commits, including uncategorized
-            #   DISABLE:  WIll only show actions that have been categorized using the format
+            #   false           WIll only show actions that have been categorized using the format
-            #                type(scope): description
+            #                       type(scope): description
-            #                type: description
+            #                       type: description
             # #
 
             SHOW_UNCATEGORIZED:
@@ -77,23 +77,23 @@ on:
                 type:               boolean
 
             # #
-            #   ENABLE:     released version will be marked as pre-release
+            #   true            released version will be marked as a development build and will have the v1.x.x-development tag instead of -latest
-            #   DISABLE:    release version will be marked as stable / normal release
+            #   false           release version will be marked with -latest docker tag
             # #
 
-            PRERELEASE:
+            RC_RELEASE:
                 description:        '🧪 Build RC (Pre-release)'
                 required:           true
                 default:            false
                 type:               boolean
 
             # #
-            #   Release Candidate version number
+            #   only needed if env variable `RC_ONLY` = true
-            #   this will be added to the end of your released app in the releases page.
+            #   sets the version number for the release candidate
-            #     e.g: tvapp2-v1.0.0-rc.1
+            #       e.g: noxenv-v1.0.0-rc.1
             # #
 
-            VERSION_RC:
+            RC_VERSION:
                 description:        '🧪 RC (Pre-release) Ver (tvapp2-rc.v1)'
                 required:           false
                 type:               string
@@ -105,15 +105,17 @@ on:
 
 env:
     PROJECT_NAME:                   ${{ github.event.inputs.PROJECT_NAME || 'tvapp2' }}
-    CHANGELOG_MODE_COMMIT:          true
+    CHANGELOG_MODE_COMMIT:          ${{ github.event.inputs.CHANGELOG_MODE_COMMIT || true }}
-    SHOW_UNCATEGORIZED:             false
+    SHOW_UNCATEGORIZED:             ${{ github.event.inputs.SHOW_UNCATEGORIZED || false }}
-    PRERELEASE:                     false
+    RC_RELEASE:                     ${{ github.event.inputs.RC_RELEASE || false }}
-    VERSION_RC:                     '1'
+    RC_VERSION:                     ${{ github.event.inputs.RC_VERSION || '1' }}
     ASSIGN_USER:                    Aetherinox
     BOT_NAME_1:                     EuropaServ
     BOT_NAME_2:                     BinaryServ
     BOT_NAME_DEPENDABOT:            dependabot[bot]
     BOT_NAME_RENOVATE:              renovate[bot]
+    GPG_KEY_BASE64:                 ${{ secrets.ADMINSERV_GPG_KEY_B64 }}
+    GPG_KEY_PASSPHRASE:             ${{ secrets.ADMINSERV_GPG_PASSPHRASE }}
 
 # #
 #   Jobs
@@ -207,6 +209,20 @@ jobs:
             packages: write
         steps:
 
+            # #
+            #   Release › Set Env Variables
+            # #
+
+            - name: >-
+                🕛 Get Timestamp
+              id: task_release_label_set_timestamp
+              run: |
+                  echo "YEAR=$(date +'%Y')" >> $GITHUB_ENV
+                  echo "NOW=$(date +'%m-%d-%Y %H:%M:%S')" >> $GITHUB_ENV
+                  echo "NOW_SHORT=$(date +'%m-%d-%Y')" >> $GITHUB_ENV
+                  echo "NOW_LONG=$(date +'%m-%d-%Y %H:%M')" >> $GITHUB_ENV
+                  echo "NOW_DOCKER_LABEL=$(date +'%Y%m%d')" >> $GITHUB_ENV
+
             # #
             #   Release › Checkout
             # #
@@ -218,24 +234,28 @@ jobs:
                   fetch-depth: 0
 
             # #
-            #   Release › Set Env Variables
+            #   Release › Start
             # #
 
             - name: >-
-                🕛 Get Timestamp
+                ✅ Start
-              id: task_release_label_set_timestamp
+              id: task_release_start
               run: |
-                  echo "NOW=$(date +'%m-%d-%Y %H:%M:%S')" >> $GITHUB_ENV
+                echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
-                  echo "NOW_SHORT=$(date +'%m-%d-%Y')" >> $GITHUB_ENV
+                echo " Starting Documentation Build script"
-                  echo "NOW_LONG=$(date +'%m-%d-%Y %H:%M')" >> $GITHUB_ENV
+                echo " Runner .............. ${{ runner.name }}"
-                  echo "NOW_DOCKER_LABEL=$(date +'%Y%m%d')" >> $GITHUB_ENV
+                echo " Workflow ............ ${{ github.workflow }} (#${{ github.workflow_ref }})"
+                echo " Run Number .......... #${{ github.run_number }}"
+                echo " Run ID .............. https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+                echo " Triggered By ........ ${{ github.actor }}"
+                echo " Time ................ ${{ env.NOW_LONG }}"
+                echo "―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――"
 
             # #
             #   Release › Print Version Debug
             # #
 
             - name: '🪪 Test Next Job Version'
-              id: task_release_debug_print_ver
               run: |
                   echo "VERSION: ${{ env.PACKAGE_VERSION }}"
 
@@ -244,7 +264,6 @@ jobs:
             # #
 
             - name: '🪪 NPM › Install & Lint'
-              id: task_release_npm_install
               working-directory: ./tvapp2
               run: |
                   npm ci
@@ -257,7 +276,6 @@ jobs:
             # #
 
             - name: '🪪 Generate IDs'
-              id: task_release_npm_env_generate
               working-directory: ./tvapp2
               run: |
                   npm run root:generate
@@ -279,7 +297,6 @@ jobs:
             # #
 
             - name: '🪪 .ENV › Read'
-              id: task_dotenv_debug_print
               run: |
                   echo "GUID: ${{ steps.task_release_dotenv_get.outputs.GUID }}"
                   echo "UUID: ${{ steps.task_release_dotenv_get.outputs.UUID }}"
@@ -288,15 +305,17 @@ jobs:
             #   Release › Build › Stable
             # #
 
-            - name: '🔨 Build › Stable ( ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}.zip )'
+            - name: '🔨 Build › Stable › ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}.zip'
-              id: task_release_build_st
+              if: |
-              if: ${{ startsWith( inputs.PRERELEASE, false ) }}
+                  startsWith( inputs.RC_RELEASE, false ) ||
+                  startsWith( env.RC_RELEASE, false )
               run: |
                   echo Building STABLE Package ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}.zip
                   zip -r ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}.zip Dockerfile Dockerfile.aarch64 docker-compose.yml docker-entrypoint.sh root/ tvapp2/package.json README.md LICENSE
 
-                  echo Building STABLE Package ${{ env.PROJECT_NAME }}-v${{ env.PACKAGE_VERSION }}-docker-compose.zip
+                  echo Building STABLE Package ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-docker-compose.zip
-                  zip -r ${{ env.PROJECT_NAME }}-v${{ env.PACKAGE_VERSION }}-docker-compose.zip docker-compose.yml README.md LICENSE
+                  zip -r ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-docker-compose.zip docker-compose.yml README.md LICENSE
+                  ls
               env:
                   NODE_AUTH_TOKEN: ${{ secrets.ADMINSERV_TOKEN_CL }}
 
@@ -304,15 +323,17 @@ jobs:
             #   Release › Build › Release Candidate
             # #
 
-            - name: '🔨 Build › RC ( ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-rc.${{ inputs.VERSION_RC }}.zip )'
+            - name: '🔨 Build › Release Candidate › ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-rc.${{ inputs.RC_VERSION }}.zip'
               id: task_release_build_rc
-              if: ${{ startsWith( inputs.PRERELEASE, true ) }}
+              if: |
+                  startsWith( inputs.RC_RELEASE, true ) ||
+                  startsWith( env.RC_RELEASE, true )
               run: |
-                  echo Building PRE-RELEASE Package ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-rc.${{ inputs.VERSION_RC }}.zip
+                  echo Building PRE-RELEASE Package ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-rc.${{ inputs.RC_VERSION }}.zip
-                  zip -r ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-rc.${{ inputs.VERSION_RC }}.zip Dockerfile Dockerfile.aarch64 docker-compose.yml docker-entrypoint.sh root/ tvapp2/package.json README.md LICENSE
+                  zip -r ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-rc.${{ inputs.RC_VERSION }}.zip Dockerfile Dockerfile.aarch64 docker-compose.yml docker-entrypoint.sh root/ tvapp2/package.json README.md LICENSE
 
-                  echo Building PRE-RELEASE Package ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-rc.${{ inputs.VERSION_RC }}-docker-compose.zip
+                  echo Building PRE-RELEASE Package ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-rc.${{ inputs.RC_VERSION }}-docker-compose.zip
-                  zip -r ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-rc.${{ inputs.VERSION_RC }}-docker-compose.zip docker-compose.yml README.md LICENSE
+                  zip -r ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-rc.${{ inputs.RC_VERSION }}-docker-compose.zip docker-compose.yml README.md LICENSE
               env:
                   NODE_AUTH_TOKEN: ${{ secrets.ADMINSERV_TOKEN_CL }}
 
@@ -341,62 +362,118 @@ jobs:
             # #
 
             - name: '🔖 Tag › Confirm ${{ env.PACKAGE_VERSION }}'
-              id: task_release_tag_get
               run: |
                   echo "Tag already present: ${{ env.TAG_EXISTS }}"
                   echo "Tag already present: ${{ steps.task_release_tag_create.outputs.tag_exists }}"
 
+            # #
+            #   Release › GPG › Import Key (No Passphrase)
+            #
+            #   requires your GPG private key, converted to base64 binary .gpg (not armored .asc)
+            # #
+
+            - name: '🪪 GPG › Import Signing Key › W/o Passphrase'
+              if: env.GPG_KEY_BASE64 != '' && env.GPG_KEY_PASSPHRASE == ''
+              run: |
+                  echo $GPG_KEY_BASE64 | base64 -di | gpg --import
+
+            # #
+            #   Release › GPG › Import Key (With Passphrase)
+            #
+            #   requires your GPG private key, converted to base64 binary .gpg (not armored .asc)
+            # #
+
+            - name: '🪪 GPG › Import Signing Key › w/ Passphrase'
+              if: env.GPG_KEY_BASE64 != '' && env.GPG_KEY_PASSPHRASE != ''
+              run: |
+                  echo "$GPG_KEY_BASE64" | base64 -di > /tmp/signing-key.gpg
+                  echo "$GPG_KEY_PASSPHRASE" | gpg --pinentry-mode loopback --passphrase-fd 0 --import /tmp/signing-key.gpg
+                  (echo "$GPG_KEY_PASSPHRASE"; echo; echo) | gpg --command-fd 0 --pinentry-mode loopback --change-passphrase $(gpg --list-secret-keys --with-colons 2> /dev/null | grep '^sec:' | cut --delimiter ':' --fields 5 | tail -n 1)
+
             # #
             #   Release › Checksum › Stable
             # #
 
             - name: '🆔 Checksum › Stable'
               id: task_release_checksum_st_set
-              if: ${{ startsWith( inputs.PRERELEASE, false ) }}
+              if: |
+                  startsWith( inputs.RC_RELEASE, false ) ||
+                  startsWith( env.RC_RELEASE, false )
               run: |
                   filename_zip="${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}.zip"
-                  sha256="$(shasum --algorithm 256 ${filename_zip} | awk '{ print $1 }')"
+
-                  shasum --algorithm 256 ${filename_zip} > SHA256SUMS.txt
+                  #  get sha1 and sha256 for .zip and .gz files
+                  find . -maxdepth 1 \( -name '*.zip' -o -name '*.gz' \) -printf '%P\n' | xargs -r sha1sum | gpg --digest-algo sha256 --clearsign > sha1sum.txt.asc
+                  find . -maxdepth 1 \( -name '*.zip' -o -name '*.gz' \) -printf '%P\n' | xargs -r sha256sum | gpg --digest-algo sha256 --clearsign > sha256sum.txt.asc
+
+                  #  get sha1sum; assign to variable
+                  sha1sum="$(shasum --algorithm 1 ${filename_zip} | awk '{ print $1 }')"
+                  echo "SHA1SUM=${sha1sum}" >> $GITHUB_ENV
+
+                  #  get sha256sum; assign to variable
+                  sha256sum="$(shasum --algorithm 256 ${filename_zip} | awk '{ print $1 }')"
+                  echo "SHA256SUM=${sha256sum}" >> $GITHUB_ENV
+
+                  #  no longer needed, replaced by find . command
+                  #  shasum --algorithm 256 ${filename_zip} > SHA256SUMS.txt
                   echo "FILE_ZIP=${filename_zip}" >> $GITHUB_ENV
-                  echo "SHA256SUM=${sha256}" >> $GITHUB_ENV
 
                   filename_compose_zip="${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-docker-compose.zip"
-                  sha256_compose="$(shasum --algorithm 256 ${filename_compose_zip} | awk '{ print $1 }')"
+                  sha256sum_compose="$(shasum --algorithm 256 ${filename_compose_zip} | awk '{ print $1 }')"
                   echo "FILE_COMPOSE_ZIP=${filename_compose_zip}" >> $GITHUB_ENV
 
+                  gpg --batch --yes --quiet --armor --detach-sig --sign --output sha256sum.sig sha256sum.txt.asc
+                  gpg --batch --yes --quiet --armor --detach-sig --sign --output sha1sum.sig sha1sum.txt.asc
+
             # #
             #   Release › Checksum › Release Candidate
             # #
 
-            - name: '🆔 Checksum › RC'
+            - name: '🆔 Checksum › Release Candidate'
               id: task_release_checksum_rc_set
-              if: ${{ startsWith( inputs.PRERELEASE, true ) }}
+              if: |
+                  startsWith( inputs.RC_RELEASE, true ) ||
+                  startsWith( env.RC_RELEASE, true )
               run: |
-                  filename_zip="${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-rc.${{ inputs.VERSION_RC }}.zip"
+                  filename_zip="${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-rc.${{ inputs.RC_VERSION }}.zip"
-                  sha256="$(shasum --algorithm 256 ${filename_zip} | awk '{ print $1 }')"
-                  shasum --algorithm 256 ${filename_zip} > SHA256SUMS.txt
-                  echo "FILE_ZIP=${filename_zip}" >> $GITHUB_ENV
-                  echo "SHA256SUM=${sha256}" >> $GITHUB_ENV
 
-                  filename_compose_zip="${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-rc.${{ inputs.VERSION_RC }}-docker-compose.zip"
+                  #  get sha1 and sha256 for .zip and .gz files
+                  find . -maxdepth 1 \( -name '*.zip' -o -name '*.gz' \) -printf '%P\n' | xargs -r sha1sum | gpg --digest-algo sha256 --clearsign > sha1sum.txt.asc
+                  find . -maxdepth 1 \( -name '*.zip' -o -name '*.gz' \) -printf '%P\n' | xargs -r sha256sum | gpg --digest-algo sha256 --clearsign > sha256sum.txt.asc
+
+                  #  get sha1sum; assign to variable
+                  sha1sum="$(shasum --algorithm 1 ${filename_zip} | awk '{ print $1 }')"
+                  echo "SHA1SUM=${sha1sum}" >> $GITHUB_ENV
+
+                  #  get sha256sum; assign to variable
+                  sha256sum="$(shasum --algorithm 256 ${filename_zip} | awk '{ print $1 }')"
+                  echo "SHA256SUM=${sha256sum}" >> $GITHUB_ENV
+
+                  #  no longer needed, replaced by find . command
+                  #  shasum --algorithm 256 ${filename_zip} > SHA256SUMS.txt
+                  echo "FILE_ZIP=${filename_zip}" >> $GITHUB_ENV
+
+                  filename_compose_zip="${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-rc.${{ inputs.RC_VERSION }}-docker-compose.zip"
                   sha256_compose="$(shasum --algorithm 256 ${filename_compose_zip} | awk '{ print $1 }')"
                   echo "FILE_COMPOSE_ZIP=${filename_compose_zip}" >> $GITHUB_ENV
 
+                  gpg --batch --yes --quiet --armor --detach-sig --sign --output sha256sum.sig sha256sum.txt.asc
+                  gpg --batch --yes --quiet --armor --detach-sig --sign --output sha1sum.sig sha1sum.txt.asc
+
             # #
             #   Release › Checksum › Print
             # #
 
             - name: '🆔 Checksum › Print'
-              id: task_release_checksum_st_get
               run: |
-                  echo "${{ env.SHA256SUM }}"
+                  echo SHA1SUM ............... ${{ env.SHA1SUM }}
+                  echo SHA256SUM ............. ${{ env.SHA256SUM }}
 
             # #
             #   Release › Contributor Images
             # #
 
             - name: '🥸 Contributors › Generate'
-              id: task_release_contribs_generate
               uses: jaywcjlove/github-action-contributors@main
               with:
                   filter-author: (renovate\[bot\]|renovate-bot|dependabot\[bot\])
@@ -404,35 +481,16 @@ jobs:
                   avatarSize: 42
 
             # #
-            #   Release › Checksum › Add (Stable)
+            #   Release › Changelog › Generate Tags
-            # #
+            #
-
+            #   generates a changelog from the github api. requires a TAG_LAST in order to figure
-            - name: '📦 Zip › Add Checksum › Stable'
+            #   out the changes made between the two versions.
-              id: task_release_zip_st
+            #
-              if: ${{ startsWith( inputs.PRERELEASE, false ) }}
+            #   outputs:
-              run: |
+            #     ${{ steps.changelog.outputs.changelog }}
-                  echo Zipping STABLE Package .zip ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}.zip
-                  zip -jr ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}.zip SHA256SUMS.txt
-                  ls
-
-            # #
-            #   Release › Checksum › Add (Release Candidate)
-            # #
-
-            - name: '📦 Zip › Add Checksum › RC'
-              id: task_release_zip_rc
-              if: ${{ startsWith( inputs.PRERELEASE, true ) }}
-              run: |
-                  echo Zipping PRE-RELEASE Package .zip ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-rc.${{ inputs.VERSION_RC }}.zip
-                  zip -jr ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-rc.${{ inputs.VERSION_RC }}.zip SHA256SUMS.txt
-                  ls
-
-            # #
-            #   Release › Generate Tags
             # #
 
             - name: '📝 Changelog › Pre Setup (Categorized Commits)'
-              id: task_release_changelog_categorized_sha_set
               run: |
                   echo "TAG_LAST=$(git describe --tags --abbrev=0)" >> $GITHUB_ENV
                   echo "COMMIT_LAST=$(git rev-parse HEAD)" >> $GITHUB_ENV
@@ -543,14 +601,56 @@ jobs:
                   echo "$CHANGELOG_UNCATEGORIZED"
 
             # #
-            #   Release › List Tree
+            #   Release › Verbose › List Tree
             # #
 
-            - name: '⚙️ Debug › Tree Listing'
+            - name: '⚙️ Verbose › Tree Listing'
-              id: task_release_debug_tree
+              id: task_release_verbose_tree
               run: |
                   tree
 
+            # #
+            #   Release › Verbose › Changelog › Print Categorized
+            # #
+
+            - name: '⚙️ Verbose › Changelog › Categorized'
+              id: task_release_changelog_verbose_categorized
+              if: |
+                  startsWith( inputs.SHOW_UNCATEGORIZED, false ) ||
+                  startsWith( env.SHOW_UNCATEGORIZED, false )
+              env:
+                  CHANGELOG_CATEGORIZED: ${{ steps.task_release_changelog_categorized.outputs.changelog }}
+                  CHANGELOG_UNCATEGORIZED: ${{ steps.task_release_changelog_categorized.outputs.changelog }}
+              run: |
+                  echo
+                  echo "---- CHANGELOG [ Categorized ] -----------------------------------------------"
+                  echo
+                  echo "$CHANGELOG_CATEGORIZED"
+                  echo
+                  echo "---- CHANGELOG ---------------------------------------------------------------"
+                  echo
+
+            # #
+            #   Release › Verbose › Changelog › Print Uncategorized
+            # #
+
+            - name: '⚙️ Verbose › Changelog › Uncategorized'
+              id: task_release_changelog_verbose_uncategorized
+              if: |
+                  startsWith( inputs.SHOW_UNCATEGORIZED, true ) ||
+                  startsWith( env.SHOW_UNCATEGORIZED, true )
+              env:
+                  CHANGELOG_CATEGORIZED: ${{ steps.task_release_changelog_categorized.outputs.changelog }}
+                  CHANGELOG_UNCATEGORIZED: ${{ steps.task_release_changelog_categorized.outputs.changelog }}
+              run: |
+                  echo
+                  echo "---- CHANGELOG [ Uncategorized ] ---------------------------------------------"
+                  echo
+                  echo "$CHANGELOG_UNCATEGORIZED"
+                  echo
+                  echo "---- CHANGELOG ---------------------------------------------------------------"
+                  echo
+
             # #
             #   Release › Post Release (Stable)
             #
@@ -563,10 +663,12 @@ jobs:
             - name: '🏳️ Post › Stable'
               id: task_release_bundle_st
               if: |
-                  startsWith( inputs.PRERELEASE, false ) ||
+                  startsWith( inputs.RC_RELEASE, false ) ||
-                  startsWith( env.PRERELEASE, false )
+                  startsWith( env.RC_RELEASE, false )
               uses: softprops/action-gh-release@v2
               env:
+                  CHANGELOG_CATEGORIZED: ${{ steps.task_release_changelog_categorized.outputs.changelog }}
+                  CHANGELOG_UNCATEGORIZED: ${{ steps.task_release_changelog_categorized.outputs.changelog }}
                   GITHUB_TOKEN: ${{ secrets.ADMINSERV_TOKEN_CL }}
               with:
                   token: ${{ secrets.ADMINSERV_TOKEN_CL }}
@@ -576,9 +678,12 @@ jobs:
                   draft: false
                   generate_release_notes: false
                   files: |
-                      ${{ env.PROJECT_NAME }}-v${{ env.PACKAGE_VERSION }}-docker-compose.zip
+                      ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-docker-compose.zip
                       ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}.zip
-                      SHA256SUMS.txt
+                      sha1sum.txt.asc
+                      sha256sum.txt.asc
+                      sha256sum.sig
+                      sha1sum.sig
                   prerelease: false
                   body: |
                       ${{ steps.task_release_changelog_categorized.outputs.changelog }}
@@ -593,14 +698,16 @@ jobs:
             #           ${{ steps.task_release_bundle_st.outputs.id
             # #
 
-            - name: "🏳️ Post › Release Candidate"
+            - name: '🏳️ Post › Release Candidate'
               id: task_release_bundle_rc
               if: |
-                  startsWith( inputs.PRERELEASE, true ) ||
+                  startsWith( inputs.RC_RELEASE, true ) ||
-                  startsWith( env.PRERELEASE, true )
+                  startsWith( env.RC_RELEASE, true )
               uses: softprops/action-gh-release@v2
               env:
-                  GITHUB_TOKEN: ${{ secrets.ADMINSERV_TOKEN }}
+                  CHANGELOG_CATEGORIZED: ${{ steps.task_release_changelog_categorized.outputs.changelog }}
+                  CHANGELOG_UNCATEGORIZED: ${{ steps.task_release_changelog_categorized.outputs.changelog }}
+                  GITHUB_TOKEN: ${{ secrets.ADMINSERV_TOKEN_CL }}
               with:
                   token: ${{ secrets.ADMINSERV_TOKEN }}
                   name: v${{ env.PACKAGE_VERSION }}
@@ -609,9 +716,12 @@ jobs:
                   draft: false
                   generate_release_notes: false
                   files: |
-                      ${{ env.PROJECT_NAME }}-v${{ env.PACKAGE_VERSION }}-rc.${{ inputs.VERSION_RC }}-docker-compose.zip
+                      ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-rc.${{ inputs.RC_VERSION }}-docker-compose.zip
-                      ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-rc.${{ inputs.VERSION_RC }}.zip
+                      ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-rc.${{ inputs.RC_VERSION }}.zip
-                      SHA256SUMS.txt
+                      sha1sum.txt.asc
+                      sha256sum.txt.asc
+                      sha256sum.sig
+                      sha1sum.sig
                   prerelease: false
                   body: |
                       > [!WARNING]
@@ -655,26 +765,44 @@ jobs:
                   echo "---- CHANGELOG ---------------------------------------------------------------"
 
             # #
-            #   Release › Upload Artifacts › Release Files
+            #   Release › Upload Artifacts › Release Files › Stable
             # #
 
             - name: >-
-                📋 Upload Artifacts › ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}.zip
+                📋 Upload Artifacts › Stable › ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}.zip
-              id: task_release_artifact
+              id: task_release_artifact_stable
               uses: actions/upload-artifact@v4
-              if: always()
+              if: |
+                  startsWith( inputs.RC_RELEASE, false ) ||
+                  startsWith( env.RC_RELEASE, false )
               with:
                   name: "${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}"
                   path: ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}.zip
                   retention-days: 30
 
+            # #
+            #   Release › Upload Artifacts › Release Files › Release Candidate
+            # #
+
+            - name: >-
+                📋 Upload Artifacts › RC › ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}.zip
+              id: task_release_artifact_rc
+              uses: actions/upload-artifact@v4
+              if: |
+                  startsWith( inputs.RC_RELEASE, true ) ||
+                  startsWith( env.RC_RELEASE, true )
+              with:
+                  name: "${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-rc.${{ inputs.RC_VERSION }}"
+                  path: ${{ env.PROJECT_NAME }}-${{ env.PACKAGE_VERSION }}-rc.${{ inputs.RC_VERSION }}.zip
+                  retention-days: 30
+
     # #
     #   Job › Complete
     # #
 
     job-complete:
         name: >-
-          🆗 Successful Deployment
+            🆗 Successful Deployment
         runs-on: ubuntu-latest
         needs: [ job-initialize, job-release ]
         env:
@@ -735,7 +863,7 @@ jobs:
                   echo "This is the main release. It contains all required docker files, and the TVApp2 `package.json`" >> $GITHUB_STEP_SUMMARY
                   echo "| File                            | Result                        |" >> $GITHUB_STEP_SUMMARY
                   echo "| ------------------------------- | -----------------------       |" >> $GITHUB_STEP_SUMMARY
-                  echo "| 🏷️ **SHA256**                      | ${{ env.SHA_STABLE }}      |" >> $GITHUB_STEP_SUMMARY
+                  echo "| 🏷️ **SHA256**                   | ${{ env.SHA_STABLE }}         |" >> $GITHUB_STEP_SUMMARY
-                  echo "| 🏷️ **GUID**                        | ${{ env.GUID }}            |" >> $GITHUB_STEP_SUMMARY
+                  echo "| 🏷️ **GUID**                     | ${{ env.GUID }}               |" >> $GITHUB_STEP_SUMMARY
-                  echo "| 🏷️ **UUID**                        | ${{ env.UUID }}            |" >> $GITHUB_STEP_SUMMARY
+                  echo "| 🏷️ **UUID**                     | ${{ env.UUID }}               |" >> $GITHUB_STEP_SUMMARY
 

.gitignore

@@ -3,6 +3,7 @@
 # #
 
 node_modules/
+tvapp2/node_modules/
 jspm_packages/
 
 # #

CONTRIBUTING.md

@@ -169,17 +169,17 @@ Our repositories make use of the following commit tags:
 
 | Type | Description |
 | --- | --- |
-| `feat` | <sup><sub>Introduce new feature</sub></sup> |
+| `feat` | Introduce new feature |
-| `fix` | <sup><sub>Bug fix</sub></sup> |
+| `fix` | Bug fix |
-| `chore` | <sup><sub>Includes technical or preventative maintenance task that is necessary for managing the app or repo, such as updating grunt tasks, but is not tied to any specific feature. Usually done for maintenance purposes.<br/>E.g: Edit .gitignore, .prettierrc, .prettierignore, .gitignore, eslint.config.js file</sub></sup> |
+| `chore` | Includes technical or preventative maintenance task that is necessary for managing the app or repo, such as updating grunt tasks, but is not tied to any specific feature. Usually done for maintenance purposes.<br/>E.g: Edit .gitignore, .prettierrc, .prettierignore, .gitignore, eslint.config.js file |
-| `revert` | <sup><sub>Revert a previous commit</sub></sup> |
+| `revert` | Revert a previous commit |
-| `style` | <sup><sub>Update / reformat style of source code. Does not change the way app is implemented. Changes that do not affect the meaning of the code<br />E.g: white-space, formatting, missing semi-colons, change tabs to spaces, etc)</sub></sup> |
+| `style` | Update / reformat style of source code. Does not change the way app is implemented. Changes that do not affect the meaning of the code<br />E.g: white-space, formatting, missing semi-colons, change tabs to spaces, etc) |
-| `docs` | <sup><sub>Change website or markdown documents. Does not mean changes to the documentation generator script itself, only the documents created from the generator. <br/>E.g: documentation, readme.md or markdown |
+| `docs` | Change website or markdown documents. Does not mean changes to the documentation generator script itself, only the documents created from the generator. <br/>E.g: documentation, readme.md or markdown |
-| `build` | <sup><sub>Changes to the build / compilation / packaging process or auxiliary tools such as doc generation<br />E.g: create new build tasks, update release script, etc.</sub></sup> |
+| `build` | Changes to the build / compilation / packaging process or auxiliary tools such as doc generation<br />E.g: create new build tasks, update release script, etc. |
-| `refactor` | <sup><sub>Change to production code that leads to no behavior difference,<br/>E.g: split files, rename variables, rename package, improve code style, etc.</sub></sup> |
+| `refactor` | Change to production code that leads to no behavior difference,<br/>E.g: split files, rename variables, rename package, improve code style, etc. |
-| `test` | <sup><sub>Add or refactor tests, no production code change. Changes the suite of automated tests for the app.</sub></sup> |
+| `test` | Add or refactor tests, no production code change. Changes the suite of automated tests for the app. |
-| `ci` | <sup><sub>Changes related to Continuous Integration (usually `yml` and other configuration files).</sub></sup> |
+| `ci` | Changes related to Continuous Integration (usually `yml` and other configuration files). |
-| `perf` | <sup><sub>Performance improvement of algorithms or execution time of the app. Does not change an existing feature.</sub></sup> |
+| `perf` | Performance improvement of algorithms or execution time of the app. Does not change an existing feature. |
 
 <br />
 

Dockerfile

@@ -9,14 +9,31 @@
 #                   https://git.binaryninja.net/BinaryNinja/tvapp2
 #                   https://github.com/aetherinox/docker-base-alpine
 #
-#   you can build your own image by running
+#   build your own image by running
-#       amd64       docker build --build-arg VERSION=1.0.0 --build-arg BUILDDATE=20250218 -t tvapp2:latest -t tvapp2:1.0.0 -t tvapp2:1.0.0-amd64 -f Dockerfile .
+#       amd64                   docker build --build-arg VERSION=1.5.0 --build-arg BUILDDATE=20260812 -t tvapp2:latest -t tvapp2:1.5.0 -t tvapp2:1.5.0-amd64 -f Dockerfile .
-#       arm64       docker build --build-arg VERSION=1.0.0 --build-arg BUILDDATE=20250218 -t tvapp2:1.0.0-arm64 -f Dockerfile.aarch64 .
+#       arm64                   docker build --build-arg VERSION=1.5.0 --build-arg BUILDDATE=20260812 -t tvapp2:1.5.0-arm64 -f Dockerfile.aarch64 .
 #
-#   if you prefer to use `docker buildx`
+#   OR; build using `docker buildx`
-#       create      docker buildx create --driver docker-container --name container --bootstrap --use
+#       create                  docker buildx create --driver docker-container --name container --bootstrap --use
-#       amd64       docker buildx build --no-cache --pull --build-arg VERSION=1.0.0 --build-arg BUILDDATE=20250218 -t tvapp2:latest -t tvapp2:1.0.0 --platform=linux/amd64 --output type=docker --output type=docker .
+#       amd64                   docker buildx build --build-arg ARCH=amd64 --build-arg VERSION=1.5.0 --build-arg BUILDDATE=20260812 --build-arg RELEASE=stable --tag ghcr.io/thebinaryninja/tvapp2:1.5.0-amd64 --attest type=provenance,disabled=true --attest type=sbom,disabled=true --file Dockerfile --platform linux/amd64 --output type=docker --allow network.host --network host --no-cache --pull --push .
-#       arm64       docker buildx build --no-cache --pull --build-arg VERSION=1.0.0 --build-arg BUILDDATE=20250218 -t tvapp2:latest -t tvapp2:1.0.0 --platform=linux/arm64 --output type=docker --output type=docker .
+#       arm64                   docker buildx build --build-arg ARCH=arm64 --build-arg VERSION=1.5.0 --build-arg BUILDDATE=20260812 --build-arg RELEASE=stable --tag ghcr.io/thebinaryninja/tvapp2:1.5.0-arm64 --attest type=provenance,disabled=true --attest type=sbom,disabled=true --file Dockerfile --platform linux/arm64 --output type=docker --allow network.host --network host --no-cache --pull --push .
+#
+#   OR; build single amd64 image
+#       create                  docker buildx create --driver docker-container --name container --bootstrap --use
+#       amd64                   docker buildx build --build-arg ARCH=amd64 --build-arg VERSION=1.5.0 --build-arg BUILDDATE=20260812 --build-arg RELEASE=stable --tag ghcr.io/thebinaryninja/tvapp2:1.5.0 --tag ghcr.io/thebinaryninja/tvapp2:1.5 --tag ghcr.io/thebinaryninja/tvapp2:1 --tag ghcr.io/thebinaryninja/tvapp2:latest --attest type=provenance,disabled=true --attest type=sbom,disabled=true --file Dockerfile --platform linux/amd64 --output type=docker --allow network.host --network host --no-cache --push .
+#
+#   OR; build official image (publish)
+#       create                  docker buildx create --driver docker-container --name container --bootstrap --use
+#       amd64-stable            docker buildx build --build-arg ARCH=amd64 --build-arg VERSION=1.5.0 --build-arg BUILDDATE=20260812 --build-arg RELEASE=stable --tag ghcr.io/thebinaryninja/tvapp2:1.5.0-amd64 --attest type=provenance,disabled=true --attest type=sbom,disabled=true --file Dockerfile --platform linux/amd64 --output type=docker --allow network.host --network host --no-cache --pull --push .
+#       arm64-stable            docker buildx build --build-arg ARCH=arm64 --build-arg VERSION=1.5.0 --build-arg BUILDDATE=20260812 --build-arg RELEASE=stable --tag ghcr.io/thebinaryninja/tvapp2:1.5.0-arm64 --attest type=provenance,disabled=true --attest type=sbom,disabled=true --file Dockerfile --platform linux/arm64 --output type=docker --allow network.host --network host --no-cache --pull --push .
+#       amd64-dev               docker buildx build --build-arg ARCH=amd64 --build-arg VERSION=1.5.0 --build-arg BUILDDATE=20260812 --build-arg RELEASE=development --tag ghcr.io/thebinaryninja/tvapp2:development-amd64 --attest type=provenance,disabled=true --attest type=sbom,disabled=true --file Dockerfile --platform linux/amd64 --output type=docker --allow network.host --network host --no-cache --pull --push .
+#       arm64-dev               docker buildx build --build-arg ARCH=arm64 --build-arg VERSION=1.5.0 --build-arg BUILDDATE=20260812 --build-arg RELEASE=development --tag ghcr.io/thebinaryninja/tvapp2:development-arm64 --attest type=provenance,disabled=true --attest type=sbom,disabled=true --file Dockerfile --platform linux/arm64 --output type=docker --allow network.host --network host --no-cache --pull --push .
+#       amd64-stable-hash       docker buildx imagetools inspect ghcr.io/thebinaryninja/tvapp2:1.5.0-amd64
+#       arm64-stable-hash       docker buildx imagetools inspect ghcr.io/thebinaryninja/tvapp2:1.5.0-arm64
+#       amd64-dev-hash          docker buildx imagetools inspect ghcr.io/thebinaryninja/tvapp2:development-amd64
+#       arm64-dev-hash          docker buildx imagetools inspect ghcr.io/thebinaryninja/tvapp2:development-arm64
+#       merge-stable            docker buildx imagetools create --tag ghcr.io/thebinaryninja/tvapp2:1.5.0 --tag ghcr.io/thebinaryninja/tvapp2:1.5 --tag ghcr.io/thebinaryninja/tvapp2:1 --tag ghcr.io/thebinaryninja/tvapp2:latest sha256:0abe1b1c119959b3b1ccc23c56a7ee2c4c908c6aaef290d4ab2993859d807a3b sha256:e68b9de8669eac64d4e4d2a8343c56705e05e9a907cf0b542343f9b536d9c473
+#       merge-dev               docker buildx imagetools create --tag ghcr.io/thebinaryninja/tvapp2:development sha256:8f36385a28c8f6eb7394d903c9a7a2765b06f94266b32628389ee9e3e3d7e69d sha256:c719ccb034946e3f0625003f25026d001768794e38a1ba8aafc9146291d548c5
 # #
 
 # #
@@ -28,16 +45,20 @@
 # #
 
 ARG ARCH=amd64
-FROM --platform=linux/${ARCH} ghcr.io/aetherinox/alpine-base:3.21
+ARG ALPINE_VERSION=3.22
+FROM --platform=linux/${ARCH} ghcr.io/aetherinox/alpine-base:${ALPINE_VERSION}
 
 # #
 #   Set Args
 # #
 
 ARG ARCH=amd64
+ARG ALPINE_VERSION=3.22
 ARG BUILDDATE
 ARG VERSION
 ARG RELEASE
+ARG GIT_SHA1=0000000000000000000000000000000000000000
+ARG REGISTRY=local
 
 # #
 #   Set Labels
@@ -54,34 +75,43 @@ LABEL org.opencontainers.image.repo.3="https://github.com/aetherinox/docker-base
 LABEL org.opencontainers.image.documentation="https://thebinaryninja.github.io/tvapp2"
 LABEL org.opencontainers.image.url="https://github.com/thebinaryninja/tvapp2/pkgs/container/tvapp2"
 LABEL org.opencontainers.image.licenses="MIT"
-LABEL org.opencontainers.image.architecture="${ARCH}"
+LABEL org.opencontainers.image.architecture="${ARCH:-amd64}"
 LABEL org.opencontainers.image.ref.name="main"
-LABEL org.opencontainers.image.registry="local"
+LABEL org.opencontainers.image.registry="${REGISTRY:-local}"
-LABEL org.opencontainers.image.release="${RELEASE}"
+LABEL org.opencontainers.image.release="${RELEASE:-stable}"
 LABEL org.tvapp2.image.maintainers="Aetherinox, iFlip721, Optx"
-LABEL org.tvapp2.image.build-version="Version:- ${VERSION} Date:- ${BUILDDATE}"
+LABEL org.tvapp2.image.build-version="Version:- ${VERSION} Date:- ${BUILDDATE:-3.21}"
+LABEL org.tvapp2.image.build-version-alpine="${ALPINE_VERSION:-3.21}"
+LABEL org.tvapp2.image.build-architecture="${ARCH:-amd64}"
+LABEL org.tvapp2.image.build-release="${RELEASE:-stable}"
+LABEL org.tvapp2.image.build-sha1="${GIT_SHA1:-0000000000000000000000000000000000000000}"
 
 # #
 #   Set Env Var
 # #
 
-ENV NODE_VERSION=22.8.0
+ENV NODE_VERSION=22.16.0
 ENV YARN_VERSION=1.22.22
-ENV RELEASE="${RELEASE}"
+ENV NPM_VERSION=10.9.2
+ENV RELEASE="${RELEASE:-stable}"
 ENV DIR_BUILD=/usr/src/app
 ENV DIR_RUN=/usr/bin/app
 ENV URL_REPO="https://git.binaryninja.net/binaryninja/"
 ENV WEB_IP="0.0.0.0"
 ENV WEB_PORT=4124
+ENV HDHR_PORT=6077
 ENV WEB_ENCODING="deflate, br"
+ENV WEB_PROXY_HEADER="x-forwarded-for"
 ENV STREAM_QUALITY="hd"
 ENV FILE_URL="urls.txt"
 ENV FILE_M3U="playlist.m3u8"
 ENV FILE_EPG="xmltv.xml"
 ENV FILE_TAR="xmltv.xml.gz"
 ENV HEALTH_TIMER=600000
+ENV TASK_CRON_SYNC="0 0 */3 * *"
 ENV LOG_LEVEL=4
 ENV TZ="Etc/UTC"
+ENV GIT_SHA1=${GIT_SHA1:-0000000000000000000000000000000000000000}
 
 # #
 #   Install
@@ -90,8 +120,10 @@ ENV TZ="Etc/UTC"
 RUN \
     apk add --no-cache \
         wget \
+        curl \
         bash \
         nano \
+        git \
         npm \
         openssl
 

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 BinaryNinja
+Copyright (c) 2025-2026 BinaryNinja
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -7,7 +7,7 @@
 
 <div align="center">
 
-<img src="docs/img/screenshots/01.png" height="320">
+<img src="docs/img/screenshots/01.gif" height="450">
 
 <br />
 <br />
@@ -70,6 +70,10 @@
   - [Environment Variables](#environment-variables-1)
   - [Mountable Volumes](#mountable-volumes-1)
   - [Docker health check](#docker-health-check)
+  - [Logging](#logging)
+    - [Trace (7)](#trace-7)
+    - [Verbose (6)](#verbose-6)
+    - [Debug (5)](#debug-5)
 - [Traefik Integration](#traefik-integration)
   - [Labels](#labels)
   - [Dynamic.yml](#dynamicyml)
@@ -82,10 +86,11 @@
   - [Labels](#labels-1)
   - [Dynamic.yml](#dynamicyml-1)
 - [Troubleshooting](#troubleshooting)
-    - [Run Error: `Error serving playlist: ENOENT: no such file or directory, open /usr/src/app/xmltv.1.xml`](#run-error-error-serving-playlist-enoent-no-such-file-or-directory-open-usrsrcappxmltv1xml)
+  - [Run Error: `Warning: Step size 60 higher than possible maximum of 59`](#run-error-warning-step-size-60-higher-than-possible-maximum-of-59)
-    - [Build Error: `s6-rc-compile: fatal: invalid /etc/s6-overlay/s6-rc.d/certsync/type: must be oneshot, longrun, or bundle`](#build-error-s6-rc-compile-fatal-invalid-etcs6-overlays6-rcdcertsynctype-must-be-oneshot-longrun-or-bundle)
+  - [Run Error: `Error serving playlist: ENOENT: no such file or directory, open /usr/src/app/xmltv.1.xml`](#run-error-error-serving-playlist-enoent-no-such-file-or-directory-open-usrsrcappxmltv1xml)
-    - [Build Error: `unable to exec /etc/s6-overlay/s6-rc.d/init-envfile/run: Permission denied`](#build-error-unable-to-exec-etcs6-overlays6-rcdinit-envfilerun-permission-denied)
+  - [Build Error: `s6-rc-compile: fatal: invalid /etc/s6-overlay/s6-rc.d/certsync/type: must be oneshot, longrun, or bundle`](#build-error-s6-rc-compile-fatal-invalid-etcs6-overlays6-rcdcertsynctype-must-be-oneshot-longrun-or-bundle)
-    - [Build Error: `[ERR] [27] Jellyfin.LiveTv.Guide.GuideManager: Error getting programs for channel XXXXXXXXXXXXXXX (Source 2) System.Xml.XmlException: '', hexadecimal value 0x1F, is an invalid character. Line 1, position 1.`](#build-error-err-27-jellyfinlivetvguideguidemanager-error-getting-programs-for-channel-xxxxxxxxxxxxxxx-source-2-systemxmlxmlexception--hexadecimal-value-0x1f-is-an-invalid-character-line-1-position-1)
+  - [Build Error: `unable to exec /etc/s6-overlay/s6-rc.d/init-envfile/run: Permission denied`](#build-error-unable-to-exec-etcs6-overlays6-rcdinit-envfilerun-permission-denied)
+  - [Build Error: `[ERR] [27] Jellyfin.LiveTv.Guide.GuideManager: Error getting programs for channel XXXXXXXXXXXXXXX (Source 2) System.Xml.XmlException: '', hexadecimal value 0x1F, is an invalid character. Line 1, position 1.`](#build-error-err-27-jellyfinlivetvguideguidemanager-error-getting-programs-for-channel-xxxxxxxxxxxxxxx-source-2-systemxmlxmlexception--hexadecimal-value-0x1f-is-an-invalid-character-line-1-position-1)
 - [Extra Notes](#extra-notes)
   - [Accessing Container Shell](#accessing-container-shell)
     - [ash](#ash)
@@ -150,21 +155,47 @@ For the [environment variables](#environment-variables), you may specify these i
 
 #### Environment Variables
 
+The following is a list of environment variables you can declare within your `docker-compose.yml` or docker run command:
+
+<br />
+
+> [!CAUTION]  
+> Do **not** add `"` quotation marks to environment variables.
+>
+> ✔️ Correct
+> ```yml
+> environment:
+>    - TASK_CRON_SYNC=*/60 * * * *
+> ```
+>
+> ❌ Incorrect
+> ```yml
+> environment:
+>    - TASK_CRON_SYNC="*/60 * * * *"
+> ```
+
+<br />
+
 | Env Var | Default | Description |
 | --- | --- | --- |
 | `TZ` | `Etc/UTC` | Timezone for error / log reporting |
 | `WEB_IP` | `0.0.0.0` | IP to use for webserver |
 | `WEB_PORT` | `4124` | Port to use for webserver |
-| `WEB_ENCODING` | `deflate, br` | Defines the HTTP `Accept-Encoding` request and response header. This value specifies what content encoding the sender can understand<br /><br />Gzip compression can be enabled by specifying `'gzip, deflate, br'` |
+| `WEB_FOLDER` | `www` | Internal container folder to keep TVApp2 web files in. <br /><br /> <sup>⚠️ This should not be used unless you know what you're doing</sup> |
+| `WEB_ENCODING` | `deflate, br` | Defines the HTTP `Accept-Encoding` request and response header. This value specifies what content encoding the sender can understand<br /><br />Gzip compression can be enabled by specifying `'gzip, deflate, br'`, however, [it may break Jellyfin users](#build-error-err-27-jellyfinlivetvguideguidemanager-error-getting-programs-for-channel-xxxxxxxxxxxxxxx-source-2-systemxmlxmlexception--hexadecimal-value-0x1f-is-an-invalid-character-line-1-position-1). |
+| `WEB_PROXY_HEADER` | `x-forwarded-for` | Defines the header to look for when finding a client's IP address. Used to get a client's IP when behind a reverse proxy or Cloudflare |
+| `HDHR_PORT` | `6077` | HDHomeRun server default listening port |
 | `URL_REPO` | `https://git.binaryninja.net/BinaryNinja/` | Determines where the data files will be downloaded from. Do not change this or you will be unable to get M3U and EPG data. |
 | `FILE_URL` | `urls.txt` | Filename for `urls.txt` cache file |
 | `FILE_M3U` | `playlist.m3u8` | Filename for M3U playlist file |
 | `FILE_EPG` | `xmltv.xml` | Filename for XML guide data file |
 | `FILE_GZP` | `xmltv.xml.gz` | Filename for XML compressed as gzip .gz |
 | `STREAM_QUALITY` | `hd` | Stream quality<br />Can be either `hd` or `sd` |
+| `TASK_CRON_SYNC` | `0 0 */3 * *` | Defines how often to refresh the M3U and XML IPTV data |
+| `HEALTH_TIMER` | `600000` | How often (in milliseconds) to run a health check |
 | `DIR_BUILD` | `/usr/src/app` | Path inside container where TVApp2 will be built. <br /><br /> <sup>⚠️ This should not be used unless you know what you're doing</sup> |
 | `DIR_RUN` | `/usr/bin/app` | Path inside container where TVApp2 will be placed after it is built <br /><br /> <sup>⚠️ This should not be used unless you know what you're doing</sup> |
-| `LOG_LEVEL` | `4` | Level of logging to display in console<br/>`6` Trace <sup><sub>& below</sub></sup><br />`5` Debug <sup><sub>& below</sub></sup><br />`4` Info <sup><sub>& below</sub></sup><br />`3` Notice <sup><sub>& below</sub></sup><br />`2` Warn <sup><sub>& below</sub></sup><br />`1` Error <sup><sub>only</sub></sup> |
+| `LOG_LEVEL` | `4` | Level of logging to display in console<br/>`7` Trace <sup><sub>& below</sub></sup><br />`6` Verbose <sup><sub>& below</sub></sup><br />`5` Debug <sup><sub>& below</sub></sup><br />`4` Info <sup><sub>& below</sub></sup><br />`3` Notice <sup><sub>& below</sub></sup><br />`2` Warn <sup><sub>& below</sub></sup><br />`1` Error <sup><sub>only</sub></sup> |
 
 <br />
 <br />
@@ -313,7 +344,7 @@ subgraph GRAPH_TVAPP ["Build tvapp2:latest"]
      Dockerfile.aarch64**`"]
     obj_step12["`&gt; docker build &bsol;
     --build-arg VERSION=1.0.0 &bsol;
-    --build-arg BUILDDATE=20250225 &bsol;
+    --build-arg BUILDDATE=20260812 &bsol;
     -t tvapp:latest &bsol;
     -t tvapp:1.0.0-amd64 &bsol;
     -f Dockerfile . &bsol;`"]
@@ -335,7 +366,7 @@ direction TB
      Dockerfile.aarch64**`"]
     obj_step22["`&gt; docker build &bsol;
     --build-arg VERSION=3.20 &bsol;
-    --build-arg BUILDDATE=20250225 &bsol;
+    --build-arg BUILDDATE=20260812 &bsol;
     -t docker-alpine-base:latest &bsol;
     -t docker-alpine-base:3.20-amd64 &bsol;
     -f Dockerfile . &bsol;`"]
@@ -360,7 +391,7 @@ This repository offers two types of docker image; `stable` and `development`. Yo
 
 | Build                     | Tags                                                                          |
 | ------------------------- | ----------------------------------------------------------------------------- |
-| `Stable`                  | `🔖 tvapp2:latest` <br /> `🔖 tvapp2:1.2.0` <br /> `🔖 tvapp2:1.2` <br /> `🔖 tvapp2:1`   |
+| `Stable`                  | `🔖 tvapp2:latest` <br /> `🔖 tvapp2:1.5.4` <br /> `🔖 tvapp2:1.5` <br /> `🔖 tvapp2:1`   |
 | `Development`             | `🔖 tvapp2:development`                                                          |
 
 <br />
@@ -374,7 +405,7 @@ Prior to building the  docker image, you **must** ensure the sections below are
 
 <br />
 
- If the listed tasks above are not performed, your docker container will throw the following errors when started:
+If the listed tasks above are not performed, your docker container will throw the following errors when started:
 
 - `Failed to open apk database: Permission denied`
 - `s6-rc: warning: unable to start service init-adduser: command exited 127`
@@ -382,39 +413,87 @@ Prior to building the  docker image, you **must** ensure the sections below are
 - `/etc/s6-overlay/s6-rc.d/init-adduser/run: line 34: aetherxown: command not found`
 - `/etc/s6-overlay/s6-rc.d/init-adduser/run: /usr/bin/aetherxown: cannot execute: required file not found`
 
+<br />
 <br />
 
 #### LF over CRLF
 
 You cannot utilize Windows' `Carriage Return Line Feed`. All files must be converted to Unix' `Line Feed`.  This can be done with **[Visual Studio Code](https://code.visualstudio.com/)**. OR; you can run the Linux terminal command `🗔 dos2unix` to convert these files.
 
-If you cloned the files from the official repository [🔆 gitea:binaryninja/tvapp2](https://git.binaryninja.net/binaryninja/tvapp2) and have not edited them, then you should not need to do this step.
+For the branches **[docker/alpine-base](https://github.com/Aetherinox/docker-base-alpine/tree/docker/alpine-base)** and your main app image, you can use the following recursive commands:
 
 <br />
 
 > [!CAUTION]
 > Be careful using the command to change **ALL** files. You should **NOT** change the files in your `📁 .git` folder, otherwise you will corrupt your git indexes.
 >
-> If you accidentally run `🗔 dos2unix` on your `📁 .git` folder, do NOT push anything to git. Pull a new copy from the repo.
+> If you accidentally run `🗔 dos2unix` on your `📁 .git` folder, do NOT push anything to git. Pull a new copy from the repo or reset your local files back to the remote:
+> 
+> ```shell
+> git reset --hard origin/main
+> ```
 
 <br />
 
 ```shell
 # Change ALL files
-find ./ -type f | grep -Ev '.git|*.jpg|*.jpeg|*.png' | xargs dos2unix --
+find ./ -type f | grep -Ev 'docs|node_modules|.git|*.jpg|*.jpeg|*.png' | xargs dos2unix --
 
 # Change run / binaries
-find ./ -type f -name 'run' | xargs dos2unix --
+find ./ -type f -name 'run' -print | xargs dos2unix --
 ```
 
 <br />
 
-#### Set `+x / 0755` Permissions
+For the branch **[docker/core](https://github.com/Aetherinox/docker-base-alpine/tree/docker/core)**, you can use the following commands:
-
-The files contained within this repo **MUST** have `chmod 755` /  `+x` executable permissions.
 
 ```shell
-find ./ -name 'run' -exec sudo chmod +x {} \;
+dos2unix docker-images.v3
+dos2unix aetherxown.v1
+dos2unix package-install.v1
+dos2unix with-contenv.v1
+```
+
+<br />
+
+If you do not have dos2unix; you may use `sed:
+
+```shell
+sed -i 's/\r$//' /etc/s6-overlay/s6-rc.d/ci-service-check/file
+```
+
+<br />
+
+You may pre-check if a file is using Windows CRLF or Linux LF by running the command `file <filename>` on the file:
+
+```shell
+$ file ./root//etc/s6-overlay/s6-rc.d/ci-service-check/type
+./root//etc/s6-overlay/s6-rc.d/ci-service-check/type: ASCII text
+```
+
+<br />
+
+You will get one of three messages listed below:
+
+1. ASCII text, with CRLF, LF line terminators
+2. ASCII text, with CRLF line terminators
+3. ASCII text
+
+<br />
+
+If you get messages `1` or `2`, then you need to run `dos2unix` on the file; otherwise when you bring the container up, you will get errors.
+
+<br />
+<br />
+
+#### Set `+x / 0755` Permissions
+
+The files contained within this repo **MUST** have `chmod 755` /  `+x` executable permissions. If you are using our Github workflow sample **[deploy-docker-github.yml](https://github.com/Aetherinox/docker-base-alpine/blob/workflows/samples/deploy-docker-github.yml)**, this is done automatically. If you are building the images manually; you need to do this. Ensure those files have the correct permissions prior to building the Alpine base docker image.
+
+If you are building the **[docker/alpine-base](https://github.com/Aetherinox/docker-base-alpine/tree/docker/alpine-base)** or your main application images, you must ensure the files in those branches have the proper permissions. All of the executable files are named `run`:
+
+```shell
+find ./ -name 'run' -print -exec sudo chmod +x {} \;
 ```
 
 <br />
@@ -432,22 +511,38 @@ sudo chmod +x ./root/etc/s6-overlay/s6-rc.d/init-adduser/run \
   ./root/etc/s6-overlay/s6-rc.d/init-permissions/run \
   ./root/etc/s6-overlay/s6-rc.d/init-samples/run \
   ./root/etc/s6-overlay/s6-rc.d/init-version-checks/run \
-  ./root/etc/s6-overlay/s6-rc.d/svc-cron/run
+  ./root/etc/s6-overlay/s6-rc.d/svc-cron/run \
+  ./root/etc/s6-overlay/s6-rc.d/svc-php-fpm/run \
+  ./root/etc/s6-overlay/s6-rc.d/svc-nginx/run \
+  ./root/etc/s6-overlay/s6-rc.d/init-php/run \
+  ./root/etc/s6-overlay/s6-rc.d/init-nginx/run
 ```
 
 <br />
 
+For the branch **[docker/core](https://github.com/Aetherinox/docker-base-alpine/tree/docker/core)**, there are a few files to change. The ending version number may change, but the commands to change the permissions are as follows:
+
+```shell
+sudo chmod +x docker-images.v3 \
+  chmod +x aetherxown.v1 \
+  chmod +x package-install.v1 \
+  chmod +x with-contenv.v1
+```
+
+<br />
+<br />
+
 ### Build Images
 
 After completing the steps above; we will now build the [🔆 gitea:binaryninja/tvapp2](https://git.binaryninja.net/binaryninja/tvapp2) image.
 
 <br />
 
-Before you build the TVApp2 image; open the `📄 Dockerfile` and ensure you are pulling the correct Alpine base image. This instruction is located near the top of the `📄 Dockerfile`:
+Open the `📄 Dockerfile` and ensure you are pulling the correct Alpine base image. This code is located near the top of the `📄 Dockerfile`:
 
 ```dockerfile
 ARG ARCH=amd64
-FROM --platform=linux/${ARCH} ghcr.io/aetherinox/alpine-base:3.21
+FROM --platform=linux/${ARCH} ghcr.io/aetherinox/alpine-base:3.22
 ```
 
 <br />
@@ -476,7 +571,7 @@ All of the needed Docker files already exist in the repository. To get started,
 mkdir tvapp2 && cd tvapp2
 
 # to clone from our gitea website
-git clone https://git.binaryninja.net/binarynina/tvapp2.git ./
+git clone https://git.binaryninja.net/binaryninja/tvapp2.git ./
 
 # to clone from our github website
 git clone https://github.com/thebinaryninja/tvapp2.git ./
@@ -539,7 +634,7 @@ Waiting for authentication in the browser…
 
 <br />
 
-Once you are finished in your browser, you can return to your Linux terminal, and it should bring you back to where you can type a command. You can now verify again if you are signed in:
+Once finished in your browser, return to your Linux terminal, and it should bring you back to where you can type a command. You can now verify again if you are signed in:
 
 ```shell
 docker info | grep Username
@@ -567,17 +662,20 @@ Creates the TVApp2 `amd64` docker image:
 # Build tvapp2 amd64
 docker buildx build \
   --build-arg ARCH=amd64 \
-  --build-arg VERSION=1.2.0 \
+  --build-arg VERSION=1.5.4 \
-  --build-arg BUILDDATE=20250407 \
+  --build-arg BUILDDATE=20260812 \
-  --tag ghcr.io/thebinaryninja/tvapp2:1.2.0 \
+  --build-arg RELEASE=stable \
-  --tag ghcr.io/thebinaryninja/tvapp2:1.2 \
+  --build-arg ALPINE_VERSION=3.22 \
-  --tag ghcr.io/thebinaryninja/tvapp2:2 \
+  --tag ghcr.io/thebinaryninja/tvapp2:1.5.4 \
+  --tag ghcr.io/thebinaryninja/tvapp2:1.5 \
+  --tag ghcr.io/thebinaryninja/tvapp2:1 \
   --tag ghcr.io/thebinaryninja/tvapp2:latest \
   --attest type=provenance,disabled=true \
   --attest type=sbom,disabled=true \
+  --output type=docker \
+  --builder default \
   --file Dockerfile \
   --platform linux/amd64 \
-  --output type=docker \
   --allow network.host \
   --network host \
   --no-cache \
@@ -595,17 +693,20 @@ Creates the TVApp2 `arm64` docker image:
 # Build tvapp2 arm64
 docker buildx build \
   --build-arg ARCH=arm64 \
-  --build-arg VERSION=1.2.0 \
+  --build-arg VERSION=1.5.4 \
-  --build-arg BUILDDATE=20250407 \
+  --build-arg BUILDDATE=20260812 \
-  --tag ghcr.io/thebinaryninja/tvapp2:1.2.0 \
+  --build-arg RELEASE=stable \
-  --tag ghcr.io/thebinaryninja/tvapp2:1.2 \
+  --build-arg ALPINE_VERSION=3.22 \
+  --tag ghcr.io/thebinaryninja/tvapp2:1.5.4 \
+  --tag ghcr.io/thebinaryninja/tvapp2:1.5 \
   --tag ghcr.io/thebinaryninja/tvapp2:1 \
   --tag ghcr.io/thebinaryninja/tvapp2:latest \
   --attest type=provenance,disabled=true \
   --attest type=sbom,disabled=true \
+  --output type=docker \
+  --builder default \
   --file Dockerfile \
   --platform linux/arm64 \
-  --output type=docker \
   --allow network.host \
   --network host \
   --no-cache \
@@ -638,7 +739,7 @@ All of the needed Docker files already exist in the repository. To get started,
 mkdir tvapp2 && cd tvapp2
 
 # to clone from our gitea website
-git clone https://git.binaryninja.net/binarynina/tvapp2.git ./
+git clone https://git.binaryninja.net/binaryninja/tvapp2.git ./
 
 # to clone from our github website
 git clone https://github.com/thebinaryninja/tvapp2.git ./
@@ -717,7 +818,7 @@ You should see your name:
 
 <br />
 
-Next, in order to build the `amd64` and `arm64` images on the same machine; you must install **QEMU** using:
+Next, in order to build the `amd64` and `arm64` images on the same machine; you must install **QEMU** which is an emulator. Open your terminal and run the following command:
 
 ```shell
 docker run --privileged --rm tonistiigi/binfmt --install all
@@ -725,10 +826,20 @@ docker run --privileged --rm tonistiigi/binfmt --install all
 
 <br />
 
+If you are building these docker images using Github workflow, you will also need to use `QEMU` with the following action:
+
+```yml
+            - name: '⚙️ Set up QEMU'
+              id: task_release_gh_qemu
+              uses: docker/setup-qemu-action@v3
+```
+
+<br />
+
 Once the emulator is installed; we will now build two images. When building these two images; we will ensure the `--tag` value is different for each one, by adding the architecture to the end. This ensures we don't overwrite one image with the newer one. We need to have two seperate docker images with two different tags.
 
-- `--tag ghcr.io/thebinaryninja/tvapp2:1.2.0-amd64`
+- `--tag ghcr.io/thebinaryninja/tvapp2:1.5.4-amd64`
-- `--tag ghcr.io/thebinaryninja/tvapp2:1.2.0-arm64`
+- `--tag ghcr.io/thebinaryninja/tvapp2:1.5.4-arm64`
 
 <br />
 
@@ -739,14 +850,14 @@ Once the emulator is installed; we will now build two images. When building thes
 > 
 > | Registry | Tag |
 > | --- | --- |
-> | Dockerhub | `--tag thebinaryninja/tvapp2:1.2.0-amd64`<br>`--tag thebinaryninja/tvapp2:1.2.0-arm64` |
+> | Dockerhub | `--tag thebinaryninja/tvapp2:1.5.4-amd64`<br>`--tag thebinaryninja/tvapp2:1.5.4-arm64` |
-> | Github (GHCR) | `--tag ghcr.io/thebinaryninja/tvapp2:1.2.0-amd64`<br>`--tag ghcr.io/thebinaryninja/tvapp2:1.2.0-arm64` |
+> | Github (GHCR) | `--tag ghcr.io/thebinaryninja/tvapp2:1.5.4-amd64`<br>`--tag ghcr.io/thebinaryninja/tvapp2:1.5.4-arm64` |
-> | Registry v2 | `--tag registry.domain.lan/thebinaryninja/tvapp2:1.2.0-amd64`<br>`--tag registry.domain.lan/thebinaryninja/tvapp2:1.2.0-arm64` |
+> | Registry v2 | `--tag registry.domain.lan/thebinaryninja/tvapp2:1.5.4-amd64`<br>`--tag registry.domain.lan/thebinaryninja/tvapp2:1.5.4-arm64` |
-> | Gitea | `--tag git.binaryninja.net/binaryninja/tvapp2:1.2.0-amd64`<br>`--tag git.binaryninja.net/binaryninja/tvapp2:1.2.0-arm64` |
+> | Gitea | `--tag git.binaryninja.net/binaryninja/tvapp2:1.5.4-amd64`<br>`--tag git.binaryninja.net/binaryninja/tvapp2:1.5.4-arm64` |
 
 <br />
 
-After we built these two images and push them to a registry online, we will merge them into a single docker image which contains both arcitectures.
+After we build these two images and push them to a registry online; merge them into a single docker image which contains both arcitectures.
 
 <br />
 
@@ -763,14 +874,17 @@ Creates the TVApp2 **Stable** release `amd64` docker image:
 # Build Tvapp2 amd64 - (stable release)
 docker buildx build \
   --build-arg ARCH=amd64 \
-  --build-arg VERSION=1.2.0 \
+  --build-arg VERSION=1.5.4 \
-  --build-arg BUILDDATE=20250407 \
+  --build-arg BUILDDATE=20260812 \
-  --tag ghcr.io/thebinaryninja/tvapp2:1.2.0-amd64 \
+  --build-arg RELEASE=stable \
+  --build-arg ALPINE_VERSION=3.22 \
+  --tag ghcr.io/thebinaryninja/tvapp2:1.5.4-amd64 \
   --attest type=provenance,disabled=true \
   --attest type=sbom,disabled=true \
+  --output type=docker \
+  --builder default \
   --file Dockerfile \
   --platform linux/amd64 \
-  --output type=docker \
   --allow network.host \
   --network host \
   --no-cache \
@@ -789,14 +903,17 @@ Creates the TVApp2 **Stable** release `arm64` docker image:
 # Build Tvapp2 arm64 - (stable release)
 docker buildx build \
   --build-arg ARCH=arm64 \
-  --build-arg VERSION=1.2.0 \
+  --build-arg VERSION=1.5.4 \
-  --build-arg BUILDDATE=20250407 \
+  --build-arg BUILDDATE=20260812 \
-  --tag ghcr.io/thebinaryninja/tvapp2:1.2.0-arm64 \
+  --build-arg RELEASE=stable \
+  --build-arg ALPINE_VERSION=3.22 \
+  --tag ghcr.io/thebinaryninja/tvapp2:1.5.4-arm64 \
   --attest type=provenance,disabled=true \
   --attest type=sbom,disabled=true \
+  --output type=docker \
+  --builder default \
   --file Dockerfile \
   --platform linux/arm64 \
-  --output type=docker \
   --allow network.host \
   --network host \
   --no-cache \
@@ -815,14 +932,17 @@ Creates the TVApp2 **Development** release `amd64` docker image:
 # Build Tvapp2 amd64 - (development release)
 docker buildx build \
   --build-arg ARCH=amd64 \
-  --build-arg VERSION=1.2.0 \
+  --build-arg VERSION=1.5.4 \
-  --build-arg BUILDDATE=20250407 \
+  --build-arg BUILDDATE=20260812 \
+  --build-arg RELEASE=development \
+  --build-arg ALPINE_VERSION=3.22 \
   --tag ghcr.io/thebinaryninja/tvapp2:development-amd64 \
   --attest type=provenance,disabled=true \
   --attest type=sbom,disabled=true \
+  --output type=docker \
+  --builder default \
   --file Dockerfile \
   --platform linux/amd64 \
-  --output type=docker \
   --allow network.host \
   --network host \
   --no-cache \
@@ -841,14 +961,17 @@ Creates the TVApp2 **Development** release `arm64` docker image:
 # Build Tvapp2 arm64 - (development release)
 docker buildx build \
   --build-arg ARCH=arm64 \
-  --build-arg VERSION=1.2.0 \
+  --build-arg VERSION=1.5.4 \
-  --build-arg BUILDDATE=20250407 \
+  --build-arg BUILDDATE=20260812 \
+  --build-arg RELEASE=development \
+  --build-arg ALPINE_VERSION=3.22 \
   --tag ghcr.io/thebinaryninja/tvapp2:development-arm64 \
   --attest type=provenance,disabled=true \
   --attest type=sbom,disabled=true \
+  --output type=docker \
+  --builder default \
   --file Dockerfile \
   --platform linux/arm64 \
-  --output type=docker \
   --allow network.host \
   --network host \
   --no-cache \
@@ -861,14 +984,14 @@ docker buildx build \
 
 After completing the `docker buildx` commands above; you should now have a few new images. Each image should have its own separate docker tags which do not conflict. If you decided to not build the **development** releases below; that is fine.
 
-- `--tag ghcr.io/thebinaryninja/tvapp2:1.2.0-amd64`
+- `--tag ghcr.io/thebinaryninja/tvapp2:1.5.4-amd64`
-- `--tag ghcr.io/thebinaryninja/tvapp2:1.2.0-arm64`
+- `--tag ghcr.io/thebinaryninja/tvapp2:1.5.4-arm64`
 - `--tag ghcr.io/thebinaryninja/tvapp2:development-amd64`
 - `--tag ghcr.io/thebinaryninja/tvapp2:development-arm64`
 
 <br />
 
-Next, we need to take these two images, and merge them into one so that both architectures are available without having to push separate images. You need to obtain the SHA256 hash digest for the `amd64` and `arm64` images. You can go to the registry where you uploaded the images and then copy them. Or you can run the following commands:
+Next, we need to take these two images, and merge them into one so that both architectures are available without having to push separate images. You need to obtain the SHA256 hash digest for the `amd64` and `arm64` images. You can go to the registry where you uploaded the images and then copy them. Or you can run the commands specified below depending on which release type you want:
 
 <br />
 <br />
@@ -888,19 +1011,20 @@ You can also get the hash digests by running the commands:
 <br />
 
 ```shell
-$ docker buildx imagetools inspect ghcr.io/thebinaryninja/tvapp2:1.2.0-amd64
+$ docker buildx imagetools inspect ghcr.io/thebinaryninja/tvapp2:1.5.4-amd64
 
-Name:      ghcr.io/thebinaryninja/tvapp2:1.2.0-amd64
+Name:      ghcr.io/thebinaryninja/tvapp2:1.5.4-amd64
 MediaType: application/vnd.docker.distribution.manifest.v2+json
 Digest:    sha256:0abe1b1c119959b3b1ccc23c56a7ee2c4c908c6aaef290d4ab2993859d807a3b
 
-$ docker buildx imagetools inspect ghcr.io/thebinaryninja/tvapp2:1.2.0-arm64
+$ docker buildx imagetools inspect ghcr.io/thebinaryninja/tvapp2:1.5.4-arm64
 
-Name:      ghcr.io/thebinaryninja/tvapp2:1.2.0-arm64
+Name:      ghcr.io/thebinaryninja/tvapp2:1.5.4-arm64
 MediaType: application/vnd.docker.distribution.manifest.v2+json
 Digest:    sha256:e68b9de8669eac64d4e4d2a8343c56705e05e9a907cf0b542343f9b536d9c473
 ```
 
+<br />
 <br />
 
 **Development Release**
@@ -942,14 +1066,14 @@ Digest:    sha256:c719ccb034946e3f0625003f25026d001768794e38a1ba8aafc9146291d548
 > ```shell
 > $ docker images --all --no-trunc | grep thebinaryninja
 > 
-> ghcr.io/thebinaryninja/tvapp2   1.2.0-arm64       sha256:48520ca15fed6483d2d5b79993126c311f833002345b0e12b8eceb5bf9def966   42 minutes ago   46MB
+> ghcr.io/thebinaryninja/tvapp2   1.5.4-arm64       sha256:48520ca15fed6483d2d5b79993126c311f833002345b0e12b8eceb5bf9def966   42 minutes ago   46MB
 > 
-> ghcr.io/thebinaryninja/tvapp2   1.2.0-amd64       sha256:54a9b7d390199532d5667fae67120d77e2f459bd6108b27ce94e0cfec8f3c41f   43 minutes ago   45MB
+> ghcr.io/thebinaryninja/tvapp2   1.5.4-amd64       sha256:54a9b7d390199532d5667fae67120d77e2f459bd6108b27ce94e0cfec8f3c41f   43 minutes ago   45MB
 > ```
 >
 > To get the correct sha256 digest, use:
-> - `docker buildx imagetools inspect ghcr.io/thebinaryninja/tvapp2:1.2.0-amd64`
+> - `docker buildx imagetools inspect ghcr.io/thebinaryninja/tvapp2:1.5.4-amd64`
-> - `docker buildx imagetools inspect ghcr.io/thebinaryninja/tvapp2:1.2.0-arm64`
+> - `docker buildx imagetools inspect ghcr.io/thebinaryninja/tvapp2:1.5.4-arm64`
 > - `docker buildx imagetools inspect ghcr.io/thebinaryninja/tvapp2:development-amd64`
 > - `docker buildx imagetools inspect ghcr.io/thebinaryninja/tvapp2:development-arm64`
 > 
@@ -969,8 +1093,8 @@ For the **stable** releases, use:
 # #
 
 docker buildx imagetools create \
-  --tag ghcr.io/thebinaryninja/tvapp2:1.2.0 \
+  --tag ghcr.io/thebinaryninja/tvapp2:1.5.4 \
-  --tag ghcr.io/thebinaryninja/tvapp2:1.2 \
+  --tag ghcr.io/thebinaryninja/tvapp2:1.5 \
   --tag ghcr.io/thebinaryninja/tvapp2:1 \
   --tag ghcr.io/thebinaryninja/tvapp2:latest \
   sha256:0abe1b1c119959b3b1ccc23c56a7ee2c4c908c6aaef290d4ab2993859d807a3b \
@@ -978,9 +1102,9 @@ docker buildx imagetools create \
 
 [+] Building 0.2s (4/4) FINISHED                                                                                                                                                                                                      
  => [internal] pushing ghcr.io/thebinaryninja/tvapp2:latest   0.2s
- => [internal] pushing ghcr.io/thebinaryninja/tvapp2:1.2      0.2s
  => [internal] pushing ghcr.io/thebinaryninja/tvapp2:1        0.2s
- => [internal] pushing ghcr.io/thebinaryninja/tvapp2:1.2.0    0.2s
+ => [internal] pushing ghcr.io/thebinaryninja/tvapp2:1.5      0.2s
+ => [internal] pushing ghcr.io/thebinaryninja/tvapp2:1.5.4    0.2s
 ```
 
 <br />
@@ -1026,8 +1150,8 @@ In this example, we take the existing two files we created earlier, and merge th
 ```shell
 # Example 1 (using tag)
 docker manifest create ghcr.io/thebinaryninja/tvapp2:latest \
-    --amend ghcr.io/thebinaryninja/tvapp2:1.2.0-amd64 \
+    --amend ghcr.io/thebinaryninja/tvapp2:1.5.4-amd64 \
-    --amend ghcr.io/thebinaryninja/tvapp2:1.2.0-arm64
+    --amend ghcr.io/thebinaryninja/tvapp2:1.5.4-arm64
 
 # Example 2 (using sha256 hash)
 docker manifest create ghcr.io/thebinaryninja/tvapp2:latest \
@@ -1068,7 +1192,7 @@ To build the project, `🗔 cd` into the project folder and run the build comman
 
 ```shell
 cd /home/docker/tvapp2/
-npm run docker:build:amd64 --VERSION=1.2.0 --BUILDDATE=20250407
+npm run docker:build:amd64 --VERSION=1.5.4 --BUILDDATE=20260812
 ```
 
 <br />
@@ -1093,7 +1217,7 @@ The run command above has several variables you must specify:
 | Variable | Description |
 | --- | --- |
 | `--VERSION=1.X.X` | The version to assign to the docker image |
-| `--BUILDDATE=20250407` | The date to assign to the docker image. <br /> Date format: `YYYYMMDD` |
+| `--BUILDDATE=20260812` | The date to assign to the docker image. <br /> Date format: `YYYYMMDD` |
 | `--ARCH=amd64` | Architecture for image<br /> <sub><sup>Options:</sup></sub> `amd64`, `arm64` |
 
 <br />
@@ -1192,16 +1316,21 @@ This docker container contains the following env variables:
 | `TZ` | `Etc/UTC` | Timezone for error / log reporting |
 | `WEB_IP` | `0.0.0.0` | IP to use for webserver |
 | `WEB_PORT` | `4124` | Port to use for webserver |
-| `WEB_ENCODING` | `deflate, br` | Defines the HTTP `Accept-Encoding` request and response header. This value specifies what content encoding the sender can understand<br /><br />Gzip compression can be enabled by specifying `'gzip, deflate, br'` |
+| `WEB_FOLDER` | `www` | Internal container folder to keep TVApp2 web files in. <br /><br /> <sup>⚠️ This should not be used unless you know what you're doing</sup> |
+| `WEB_ENCODING` | `deflate, br` | Defines the HTTP `Accept-Encoding` request and response header. This value specifies what content encoding the sender can understand<br /><br />Gzip compression can be enabled by specifying `'gzip, deflate, br'`, however, [it may break Jellyfin users](#build-error-err-27-jellyfinlivetvguideguidemanager-error-getting-programs-for-channel-xxxxxxxxxxxxxxx-source-2-systemxmlxmlexception--hexadecimal-value-0x1f-is-an-invalid-character-line-1-position-1). |
+| `WEB_PROXY_HEADER` | `x-forwarded-for` | Defines the header to look for when finding a client's IP address. Used to get a client's IP when behind a reverse proxy or Cloudflare |
+| `HDHR_PORT` | `6077` | HDHomeRun server default listening port |
 | `URL_REPO` | `https://git.binaryninja.net/BinaryNinja/` | Determines where the data files will be downloaded from. Do not change this or you will be unable to get M3U and EPG data. |
 | `FILE_URL` | `urls.txt` | Filename for `urls.txt` cache file |
 | `FILE_M3U` | `playlist.m3u8` | Filename for M3U playlist file |
 | `FILE_EPG` | `xmltv.xml` | Filename for XML guide data file |
 | `FILE_GZP` | `xmltv.xml.gz` | Filename for XML compressed as gzip .gz |
 | `STREAM_QUALITY` | `hd` | Stream quality<br />Can be either `hd` or `sd` |
+| `TASK_CRON_SYNC` | `0 0 */3 * *` | Defines how often to refresh the M3U and XML IPTV data |
+| `HEALTH_TIMER` | `600000` | How often (in milliseconds) to run a health check |
 | `DIR_BUILD` | `/usr/src/app` | Path inside container where TVApp2 will be built. <br /><br /> <sup>⚠️ This should not be used unless you know what you're doing</sup> |
 | `DIR_RUN` | `/usr/bin/app` | Path inside container where TVApp2 will be placed after it is built <br /><br /> <sup>⚠️ This should not be used unless you know what you're doing</sup> |
-| `LOG_LEVEL` | `4` | Level of logging to display in console<br/>`6` Trace <sup><sub>& below</sub></sup><br />`5` Debug <sup><sub>& below</sub></sup><br />`4` Info <sup><sub>& below</sub></sup><br />`3` Notice <sup><sub>& below</sub></sup><br />`2` Warn <sup><sub>& below</sub></sup><br />`1` Error <sup><sub>only</sub></sup> |
+| `LOG_LEVEL` | `4` | Level of logging to display in console<br/>`7` Trace <sup><sub>& below</sub></sup><br />`6` Verbose <sup><sub>& below</sub></sup><br />`5` Debug <sup><sub>& below</sub></sup><br />`4` Info <sup><sub>& below</sub></sup><br />`3` Notice <sup><sub>& below</sub></sup><br />`2` Warn <sup><sub>& below</sub></sup><br />`1` Error <sup><sub>only</sub></sup> |
 
 <br />
 <br />
@@ -1262,6 +1391,92 @@ health check:
 
 <br />
 
+### Logging
+
+This docker container includes numerous log levels you can switch between in order to see exactly what the docker container is doing during operations.
+
+Out-of-box, the default value is set to `4`:
+
+```yml
+        environment:
+            - TZ=Etc/UTC
+            - LOG_LEVEL=4
+```
+
+<br />
+
+The default level of `info (4)` will give you all messages related to running your container. It should be enough for everyday users. This log level includes:
+
+- All informative messages
+- All errors
+- All warnings
+- All notices
+
+<br />
+
+However, this container supports three levels with high verbosity:
+- **Trace**: 7
+- **Verbose**: 6
+- **Debug**: 5
+
+<br />
+
+#### Trace (7)
+
+This **LOG_LEVEL** will output anything that you can see with **debug** `LOG_LEVEL=5`; but with the addition that each log output to your console will show a complete traceback of how the log was triggered.
+
+<br />
+
+> [!NOTE]
+> Users should be cautioned that using `LOG_LEVEL=7` will generate a large amount of logs to your console, especially when you initiate watching an IPTV channel.
+
+<br />
+
+```shell
+Trace:  tvapp2  → .gzp [requests] ⚙️ <msg> Requesting to create compressed gzip from uncompressed XML data <src> /usr/bin/app/www/xmltv.xml <dest> /usr/bin/app/www/xmltv.xml.gz
+    at Log.debug (file:///usr/bin/app/index.js:182:21)
+    at getGzip (file:///usr/bin/app/index.js:658:13)
+    at initialize (file:///usr/bin/app/index.js:1840:15)
+    at process.processTicksAndRejections (node:internal/process/task_queues:105:5)
+    at async file:///usr/bin/app/index.js:2288:5
+```
+
+<br />
+
+#### Verbose (6)
+
+This **LOG_LEVEL** will output anything that you can see with **debug** `LOG_LEVEL=5`; as well as even deeper logs; such as every environment variable your TVApp2 container has assigned. You should not need to use this log level unless you are troubleshooting an issue or if instructed to do so by the developers.
+
+```shell
+tvapp2  → .env [assigner] 📣 <name> npm_config_user_agent <value> npm/10.9.1 node/v22.13.1 linux x64 workspaces/false
+tvapp2  → .env [assigner] 📣 <name> HOSTNAME <value> tvapp2
+tvapp2  → .env [assigner] 📣 <name> SHLVL <value> 4
+tvapp2  → .env [assigner] 📣 <name> HOME <value> /root
+tvapp2  → .env [assigner] 📣 <name> OLDPWD <value> /run/s6/legacy-services/tvapp2
+```
+
+<br />
+
+#### Debug (5)
+
+This **LOG_LEVEL** will output many of the steps that this container takes to create new XML guide and M3U playlist files. It will also output the environment variables you have set associated with the docker image itself.
+
+<br />
+
+```shell
+tvapp2  → .net [assigner] ⚙️ <name> IP_CONTAINER <value> 172.18.0.7
+tvapp2  → .net [assigner] ⚙️ <name> IP_GATEWAY <value> 172.18.0.1
+tvapp2  → .env [assigner] ⚙️ <name> RELEASE <value> stable
+tvapp2  → .env [assigner] ⚙️ <name> WEB_IP <value> 0.0.0.0
+tvapp2  → .env [assigner] ⚙️ <name> WEB_PORT <value> 4124
+tvapp2  → .env [assigner] ⚙️ <name> WEB_FOLDER <value> www
+tvapp2  → file [requests] ⚙️ <msg> Requesting to download external file <src> https://git.binaryninja.net/binaryninja//XMLTV-EPG/raw/branch/main/xmltv.1.xml <dest> /usr/bin/app/www/xmltv.xml
+```
+
+<br />
+
+
+
 ---
 
 <br />
@@ -1644,7 +1859,7 @@ Sign into the Authentik admin panel, go to the left-side navigation, select **Ap
 
 <br />
 
-<p align="center"><img style="width: 40%;text-align: center;" src="docs/img/authentik/01.png"><br><small><sup><b>Authentik:</b> Select <code>Applications</code> › <code>Providers</code></sup></small></p>
+<p align="center"><img style="width: 80%;text-align: center;" src="docs/img/authentik/01.png"><br><small><sup><b>Authentik:</b> Select <code>Applications</code> › <code>Providers</code></sup></small></p>
 
 <br />
 
@@ -1680,7 +1895,7 @@ Once finished, click **Create**. Then on the left-side menu, select **Applicatio
 
 <br />
 
-<p align="center"><img style="width: 40%;text-align: center;" src="docs/img/authentik/05.png"><br><small><sup><b>Authentik:</b> Select <code>Applications</code> › <code>Applications</code></sup></small></p>
+<p align="center"><img style="width: 80%;text-align: center;" src="docs/img/authentik/05.png"><br><small><sup><b>Authentik:</b> Select <code>Applications</code> › <code>Applications</code></sup></small></p>
 
 <br />
 
@@ -1706,7 +1921,7 @@ Save, and then on the left-side menu, select **Applications** -> **Outposts**:
 
 <br />
 
-<p align="center"><img style="width: 40%;text-align: center;" src="docs/img/authentik/07.png"><br><small><sup><b>Authentik:</b> Select <code>Applications</code> › <code>Outposts</code></sup></small></p>
+<p align="center"><img style="width: 80%;text-align: center;" src="docs/img/authentik/07.png"><br><small><sup><b>Authentik:</b> Select <code>Applications</code> › <code>Outposts</code></sup></small></p>
 
 <br />
 
@@ -1821,7 +2036,28 @@ If you have issues building your TVApp2 docker image, please refer to the follow
 <br />
 <br />
 
-#### Run Error: `Error serving playlist: ENOENT: no such file or directory, open /usr/src/app/xmltv.1.xml`
+### Run Error: `Warning: Step size 60 higher than possible maximum of 59`
+
+This error means that you have placed an incorrect value for a cron job. This error can show if you've set:
+
+```shell
+        environment:
+            TASK_CRON_SYNC: "*/60 * * * *"
+```
+
+<br />
+
+To correctly set the value, change your cron to:
+
+```shell
+        environment:
+            TASK_CRON_SYNC: "0 */1 * * *"
+```
+
+<br />
+<br />
+
+### Run Error: `Error serving playlist: ENOENT: no such file or directory, open /usr/src/app/xmltv.1.xml`
 
 This error occurs at run-time when attempting to spin up your TVApp2 docker container. If you receive this error, restart your TVApp2 docker container. Ensure that your docker container also has access to your docker network so that it can connect to our repository and fetch the data files it needs to generate your playlist.
 
@@ -1832,7 +2068,7 @@ If the error continues after doing the above; delete the existing image, and re-
 <br />
 <br />
 
-#### Build Error: `s6-rc-compile: fatal: invalid /etc/s6-overlay/s6-rc.d/certsync/type: must be oneshot, longrun, or bundle`
+### Build Error: `s6-rc-compile: fatal: invalid /etc/s6-overlay/s6-rc.d/certsync/type: must be oneshot, longrun, or bundle`
 
 This error means that you are attempting to combine files which are utilizing CRLF over LF; which is **CR** = Carriage Return and **LF** = Line Feed
 
@@ -1862,6 +2098,8 @@ cd /path/to/tvapp2
 find ./ -type f | grep -Ev '.git|*.jpg|*.jpeg|*.png' | sudo xargs dos2unix --
 ```
 
+<br />
+
 > [!WARNING]
 > Do not run `🗔 dos2unix` on your `📁 .git` folder or you will corrupt your git indexes and will be unable to push commits.
 >
@@ -1870,7 +2108,7 @@ find ./ -type f | grep -Ev '.git|*.jpg|*.jpeg|*.png' | sudo xargs dos2unix --
 <br />
 <br />
 
-#### Build Error: `unable to exec /etc/s6-overlay/s6-rc.d/init-envfile/run: Permission denied`
+### Build Error: `unable to exec /etc/s6-overlay/s6-rc.d/init-envfile/run: Permission denied`
 
 There are multiple errors you can receive when attempting to run your TVApp2 docker image. You may receive any of the following errors:
 
@@ -1885,10 +2123,9 @@ There are multiple errors you can receive when attempting to run your TVApp2 doc
 If you receive any of the above errors; this means that you have not set your `run` files to have execute permissions `+x`. Run the following command in the root directory of your TVApp2 project folder:
 
 ```shell
-find ./ -name 'run' -exec sudo chmod +x {} \;
+find ./ -name 'run' -print -exec sudo chmod +x {} \;
 ```
 
-<br />
 <br />
 
 After you have set these permissions, re-build your docker image using `docker build` or `docker buildx`. Then spin the container up.
@@ -1896,7 +2133,7 @@ After you have set these permissions, re-build your docker image using `docker b
 <br />
 <br />
 
-#### Build Error: `[ERR] [27] Jellyfin.LiveTv.Guide.GuideManager: Error getting programs for channel XXXXXXXXXXXXXXX (Source 2) System.Xml.XmlException: '', hexadecimal value 0x1F, is an invalid character. Line 1, position 1.`
+### Build Error: `[ERR] [27] Jellyfin.LiveTv.Guide.GuideManager: Error getting programs for channel XXXXXXXXXXXXXXX (Source 2) System.Xml.XmlException: '', hexadecimal value 0x1F, is an invalid character. Line 1, position 1.`
 
 This error may be seen if you are attempting to import our EPG guide data directly into Jellyfin. The cause of this is due to you having **GZIP Compression** enabled in your header request and response. See the example below; which is in your TVApp2 `📄 docker-compose.yml` file:
 

docker-compose.yml

@@ -45,6 +45,6 @@ services:
                 soft: -1
                 hard: -1
         healthcheck:
-            test: [ "CMD", "curl", "--fail", "http://127.0.0.1:4124" ]
+            test: [ "CMD", "curl", "--fail", "http://127.0.0.1:4124/api/health?silent=true" ]
             interval: 30s
             retries: 5

docs/docs/about/changelog.md

@@ -28,6 +28,60 @@ This section outlines all releases of TVApp2, including the version of the relea
 
 <br />
 
+### <!-- md:version stable- -->  1.4.0 <small>Apr 10, 2025</small> { id="1.4.0" }
+
+- `feat`: add new environment variable `HEALTH_TIMER` _(See feature below)_
+- `feat`: new health check icon in top right; triggers every `10 minutes` and reports back to the web interface as a toast notification
+    - health check shows timer until next health check is performed.
+- `feat`: added bootstramp toast notifications and modals
+- `feat`: new modal dialog when when user triggers a re-sync of the m3u and epg data
+- `feat`: footer of web interface how discloses which build is being ran; `stable` or `development`
+- `refactor`: console logging system overhauled with new syntax for how logs are displayed
+- `refactor`: additional logs added for `LOG_LEVEL=5` or higher
+
+<br />
+
+---
+
+<br />
+
+### <!-- md:version stable- -->  1.3.0 <small>Apr 9, 2025</small> { id="1.3.0" }
+
+- `feat`: new button to upper-right side of header which allows you to **force re-sync** your m3u and xml data.
+- `feat`: new api endpoint `/api/resync`; utilized to resync M3U and EPG data
+- `feat`: new api endpoint `/api/health`; utilized in your `docker-compose.yml` health check
+- `feat`: new env variable `WEB_ENCODING`; allows you to customize the HTTP `Accept-Encoding` request and response header
+- `feat`: new env variable `IP_GATEWAY`; stores assigned container gateway ip
+- `feat`: new env variable `IP_CONTAINER`; stores assigned container ip
+- `refactor`: env variables re-named
+    - `FILE_TAR` → `FILE_GZP`
+- `refactor`: errors and success messages now use api endpoint; lists timestamp, error code, etc.
+- `build`: bump bootstrap from `v4` to `v5`
+- `fix`: bug in Jellyfin which caused EPG data syncing to error out for hosts which cannot support gzip compression
+    - Error:  _[ERR] [27] Jellyfin.LiveTv.Guide.GuideManager: Error getting programs for channel XXXXXXXXXXXXXXX (Source 2) System.Xml.XmlException: '', hexadecimal value 0x1F, is an invalid character. Line 1, position 1._
+
+<br />
+
+---
+
+<br />
+
+### <!-- md:version stable- -->  1.2.0 <small>Apr 5, 2025</small> { id="1.2.0" }
+
+- `feat`: add support for additional mime types and default file type
+- `style`: rename env variable `FILE_PLAYLIST` to `FILE_M3U`
+- `build`: add new env vars to `Dockerfile`
+    - `FILE_TAR`
+    - `FILE_URL`
+- `refactor`: m3u and epg files now stored in `www` folder
+- `fix`: html template links pointing to old repo
+
+<br />
+
+---
+
+<br />
+
 ### <!-- md:version stable- --> 1.1.0 <small>Mar 25, 2025</small> { id="1.1.0" }
 
 - `feat`: new interface & theme for web ui
@@ -66,6 +120,10 @@ This section outlines all releases of TVApp2, including the version of the relea
 
 <br />
 
+---
+
+<br />
+
 ### <!-- md:version stable- --> 1.0.0 <small>Feb 24, 2025</small> { id="1.0.0" }
 
 - Initial release

docs/docs/about/what_is_tvapp.md

@@ -42,10 +42,21 @@ All channels contain multiple sources so that you have a reliable streaming expe
 
 <br />
 
-## Associated Links
+## Image Sources
 
-Check out the following websites for additional resources for the TVApp2 docker image below.
+This project contains several repositories which all share the same code; use them as backups:
 
+- [🔀 dockerhub:thebinaryninja/tvapp2](https://hub.docker.com/r/thebinaryninja/tvapp2)
+- [🔀 github:thebinaryninja/tvapp2](https://github.com/thebinaryninja/tvapp2)
+- [🔀 gitea:git.binaryninja.net/binaryninja/tvapp2](https://git.binaryninja.net/binaryninja/tvapp2)
+
+<br />
+
+| Pull URL | Registry | Arch | Version |
+| --- | --- | --- | --- |
+| `ghcr.io/thebinaryninja/tvapp2:latest`<br />`ghcr.io/thebinaryninja/tvapp2:development` | Github | amd64<br/>arm64 | [![Github][github-docker-version-img]][github-docker-version-uri] |
+| `thebinaryninja/tvapp2:latest`<br />`thebinaryninja/tvapp2:development` | Dockerhub | amd64<br/>arm64 | [![Dockerhub][dockerhub-docker-version-img]][dockerhub-docker-version-uri] |
+| `git.binaryninja.net/binaryninja/tvapp2:latest`<br />`git.binaryninja.net/binaryninja/tvapp2:development` | Gitea | amd64<br/>arm64 | [![Gitea][gitea-docker-version-img]][gitea-docker-version-uri] |
 
 <br />
 
@@ -64,6 +75,13 @@ The following is a small list of the features available with the TVApp2 containe
 - Channel playlists can be downloaded as a `.m38u` or a compressed `.gzip` archive.
     - Compressed gzip compatible with 3rd party apps like Cabernet and Jellyfin.
 - Tracking statistics which show the last update time, size, and a description for each file's purpose.
+- API endpoints:
+    - **Resync All Files**
+        - http://127.0.0.1:4124/api/resync
+        - http://127.0.0.1:4124/api/restart
+    - **Health check**
+        - http://127.0.0.1:4124/api/health
+        - http://127.0.0.1:4124/api/status
 - Direct access to download each of the generated files, including multiple easy-to-remember URLs for each file type.
     - **M3U Playlist**:
         - http://127.0.0.1:4124/playlist

docs/docs/config/env.md

@@ -175,6 +175,63 @@ services:
 
 <br />
 
+## WEB_ENCODING
+<!-- md:control env -->
+<!-- md:version stable-1.3.0 -->
+<!-- md:default `deflate, br` -->
+
+The `WEB_ENCODING` environment variable allows you to customize the HTTP `Accept-Encoding` request and response header. This value specifies what content encoding the sender can understand when sending these requests.
+
+Most users will not need to modify this value unless you are running Jellyfin and receive the following error when attempting to sync EPG data between Jellyfin and the TVApp2 container:
+
+!!! warning "Jellyfin  Error"
+
+    ```
+    [ERR] [27] Jellyfin.LiveTv.Guide.GuideManager: Error getting programs for channel 
+    XXXXXXXXXXXXXXX (Source 2) System.Xml.XmlException: '', hexadecimal value 0x1F, 
+    is an invalid character. Line 1, position 1.
+    ```
+
+If you receive the above error and you have already customized this environment variable to include `gzip`, you must remove it from your accepted encoders string to fix the error.
+
+=== "Old"
+
+    ``` { .yaml .copy .select title="docker-compose.yml" linenums="1" hl_lines="13" }
+    services:
+        tvapp2:
+            container_name: tvapp2
+            image: ghcr.io/thebinaryninja/tvapp2:latest
+            restart: unless-stopped
+            volumes:
+                - /etc/timezone:/etc/timezone:ro
+                - /etc/localtime:/etc/localtime:ro
+                - /var/run/docker.sock:/var/run/docker.sock
+                - ./config:/config
+                - ./app:/usr/bin/app
+            environment:
+                - WEB_ENCODING: 'gzip, deflate, br'
+    ```
+
+=== "New"
+
+    ``` { .yaml .copy .select title="docker-compose.yml" linenums="1" hl_lines="13" }
+    services:
+        tvapp2:
+            container_name: tvapp2
+            image: ghcr.io/thebinaryninja/tvapp2:latest
+            restart: unless-stopped
+            volumes:
+                - /etc/timezone:/etc/timezone:ro
+                - /etc/localtime:/etc/localtime:ro
+                - /var/run/docker.sock:/var/run/docker.sock
+                - ./config:/config
+                - ./app:/usr/bin/app
+            environment:
+                - WEB_ENCODING: 'deflate, br'
+    ```
+
+<br />
+
 ## URL_REPO
 <!-- md:control env -->
 <!-- md:version stable-1.0.0 -->
@@ -202,19 +259,19 @@ services:
 ```
 
 1.  :warning: It is highly recommended that you do not change this value
-    otherwise you will not be able to download the latest M3U playlists and EPG 
+    otherwise you will not be able to download the latest M3U playlists
-    guide data.
+    and EPG guide data.
 
 <br />
 
-## DIR_BUILD
+## FILE_URL
 <!-- md:control env -->
-<!-- md:version stable-1.0.0 -->
+<!-- md:version stable-1.2.0 -->
-<!-- md:default `/usr/src/app` -->
+<!-- md:default `urls.txt` -->
-<!-- md:flag dangerous -->
 
-The `DIR_BUILD` environment variable specifies what local folder will be utilized
+The `FILE_URL` environment variable allows you to specify what the name of the downloaded `urls.txt` cache file. This file is downloaded when you first spin up the TVApp2 container.
-by the TVApp2 docker container when the container builds the app.
+
+There should be no need to utilize this environment variable unless you have a specific reason.
 
 ``` { .yaml .copy .select title="docker-compose.yml" linenums="1" hl_lines="13" }
 services:
@@ -229,85 +286,22 @@ services:
             - ./config:/config
             - ./app:/usr/bin/app
         environment:
-            - DIR_BUILD=/usr/src/app # (1)
+            - FILE_URL=urls.txt # (1)
 ```
 
-1.  :warning: You should not change this unless you are an advanced user.
+1.  :warning: There is really no reason to modify this environment variable
+    unless you have a specific purpose.
 
 <br />
 
-## DIR_RUN
+## FILE_M3U
-<!-- md:control env -->
-<!-- md:version stable-1.0.0 -->
-<!-- md:default `/usr/src/app` -->
-<!-- md:flag dangerous -->
-
-The `DIR_RUN` environment variable specifies what local folder will be utilized
-by the TVApp2 docker container when the container has built the app and placed it
-into a production folder.
-
-``` { .yaml .copy .select title="docker-compose.yml" linenums="1" hl_lines="13" }
-services:
-    tvapp2:
-        container_name: tvapp2
-        image: ghcr.io/thebinaryninja/tvapp2:latest
-        restart: unless-stopped
-        volumes:
-            - /etc/timezone:/etc/timezone:ro
-            - /etc/localtime:/etc/localtime:ro
-            - /var/run/docker.sock:/var/run/docker.sock
-            - ./config:/config
-            - ./app:/usr/bin/app
-        environment:
-            - DIR_RUN=/usr/bin/app # (1)
-```
-
-1.  :warning: You should not change this unless you are an advanced user.
-
-<br />
-
-## STREAM_QUALITY
-<!-- md:control env -->
-<!-- md:version stable-1.1.0 -->
-<!-- md:default `hd` -->
-
-The `STREAM_QUALITY` environment variable specifies the default stream quality that will 
-be used when you initiate a new channel to view.
-
-Available Options:
-
-  * `hd` High Definition
-  * `sd` Standard Definition
-
-``` { .yaml .copy .select title="docker-compose.yml" linenums="1" hl_lines="13" }
-services:
-    tvapp2:
-        container_name: tvapp2
-        image: ghcr.io/thebinaryninja/tvapp2:latest
-        restart: unless-stopped
-        volumes:
-            - /etc/timezone:/etc/timezone:ro
-            - /etc/localtime:/etc/localtime:ro
-            - /var/run/docker.sock:/var/run/docker.sock
-            - ./config:/config
-            - ./app:/usr/bin/app
-        environment:
-            - STREAM_QUALITY=hd # (1)
-```
-
-1.  :information: This environment variable has the following options:
-    - hd
-    - sd
-
-<br />
-
-## FILE_PLAYLIST
 <!-- md:control env -->
 <!-- md:version stable-1.1.0 -->
 <!-- md:default `playlist.m3u8` -->
 
-The `FILE_PLAYLIST` environment variable specifies the filename that will be utilized when
+The `FILE_M3U` environment variable allows you to specify what the name of the downloaded `playlist.m3u8` file will be. This file is downloaded when you first spin up the TVApp2 container, and contains a list of what channels you can pick from.
-your .m3u playlist file is generated.
+
+There should be no need to utilize this environment variable unless you have a specific reason.
 
 ``` { .yaml .copy .select title="docker-compose.yml" linenums="1" hl_lines="13" }
 services:
@@ -322,11 +316,12 @@ services:
             - ./config:/config
             - ./app:/usr/bin/app
         environment:
-            - FILE_PLAYLIST=playlist.m3u8 # (1)
+            - FILE_M3U=playlist.m3u8 # (1)
 ```
 
-1.  :information: Changing this file only changes the filename locally; it does
+1.  :warning: There is really no reason to modify this environment variable
-    not affect the server-side fetching mechanism.
+    unless you have a specific purpose.
+
 
 <br />
 
@@ -389,6 +384,100 @@ services:
 
 <br />
 
+## STREAM_QUALITY
+<!-- md:control env -->
+<!-- md:version stable-1.1.0 -->
+<!-- md:default `hd` -->
+
+The `STREAM_QUALITY` environment variable specifies the default stream quality that will 
+be used when you initiate a new channel to view.
+
+Available Options:
+
+  * `hd` High Definition
+  * `sd` Standard Definition
+
+``` { .yaml .copy .select title="docker-compose.yml" linenums="1" hl_lines="13" }
+services:
+    tvapp2:
+        container_name: tvapp2
+        image: ghcr.io/thebinaryninja/tvapp2:latest
+        restart: unless-stopped
+        volumes:
+            - /etc/timezone:/etc/timezone:ro
+            - /etc/localtime:/etc/localtime:ro
+            - /var/run/docker.sock:/var/run/docker.sock
+            - ./config:/config
+            - ./app:/usr/bin/app
+        environment:
+            - STREAM_QUALITY=hd # (1)
+```
+
+1.  :information: This environment variable has the following options:
+    - hd
+    - sd
+
+<br />
+
+## DIR_BUILD
+<!-- md:control env -->
+<!-- md:version stable-1.0.0 -->
+<!-- md:default `/usr/src/app` -->
+<!-- md:flag dangerous -->
+
+The `DIR_BUILD` environment variable specifies what local folder will be utilized
+by the TVApp2 docker container when the container builds the app.
+
+``` { .yaml .copy .select title="docker-compose.yml" linenums="1" hl_lines="13" }
+services:
+    tvapp2:
+        container_name: tvapp2
+        image: ghcr.io/thebinaryninja/tvapp2:latest
+        restart: unless-stopped
+        volumes:
+            - /etc/timezone:/etc/timezone:ro
+            - /etc/localtime:/etc/localtime:ro
+            - /var/run/docker.sock:/var/run/docker.sock
+            - ./config:/config
+            - ./app:/usr/bin/app
+        environment:
+            - DIR_BUILD=/usr/src/app # (1)
+```
+
+1.  :warning: You should not change this unless you are an advanced user.
+
+<br />
+
+## DIR_RUN
+<!-- md:control env -->
+<!-- md:version stable-1.0.0 -->
+<!-- md:default `/usr/src/app` -->
+<!-- md:flag dangerous -->
+
+The `DIR_RUN` environment variable specifies what local folder will be utilized
+by the TVApp2 docker container when the container has built the app and placed it
+into a production folder.
+
+``` { .yaml .copy .select title="docker-compose.yml" linenums="1" hl_lines="13" }
+services:
+    tvapp2:
+        container_name: tvapp2
+        image: ghcr.io/thebinaryninja/tvapp2:latest
+        restart: unless-stopped
+        volumes:
+            - /etc/timezone:/etc/timezone:ro
+            - /etc/localtime:/etc/localtime:ro
+            - /var/run/docker.sock:/var/run/docker.sock
+            - ./config:/config
+            - ./app:/usr/bin/app
+        environment:
+            - DIR_RUN=/usr/bin/app # (1)
+```
+
+1.  :warning: You should not change this unless you are an advanced user.
+
+<br />
+
 ## LOG_LEVEL
 <!-- md:control env -->
 <!-- md:version stable-1.1.0 -->
@@ -417,13 +506,16 @@ when being output to your console.
 
     1.  :information: The default log level is `4` (info).
 
-=== "Logging Options"
+=== "Log Levels"
 
     | Log Level       | Name        | Description                                                                     |
     | --------------- | ----------- | ------------------------------------------------------------------------------- |
-    | `6`             | Trace       | Displays all possible logs in console, along with anything below this line.     |
+    | `6`             | :material-checkbox-blank-circle:{ style="color: var(--md-loglevel-trace-color) " } Trace       | Displays all possible logs in console, along with anything below this line.     |
-    | `5`             | Debug       | Displays debug / developer logs, along with anything below this line.           |
+    | `5`             | :material-checkbox-blank-circle:{ style="color: var(--md-loglevel-debug-color) " } Debug       | Displays debug / developer logs, along with anything below this line.           |
-    | `4`             | Info        | Displays informative logs, along with anything below this line.                 |
+    | `4`             | :material-checkbox-blank-circle:{ style="color: var(--md-loglevel-info-color) " } Info        | Displays informative logs, along with anything below this line.                 |
-    | `3`             | Notice      | Displays important notices, along with anything below this line.                |
+    | `3`             | :material-checkbox-blank-circle:{ style="color: var(--md-loglevel-notice-color) " } Notice      | Displays important notices, along with anything below this line.                |
-    | `2`             | Warm        | Displays warnings, along with anything below this line.                         |
+    | `2`             | :material-checkbox-blank-circle:{ style="color: var(--md-loglevel-warn-color) " } Warn        | Displays warnings, along with anything below this line.                         |
-    | `1`             | Error       | Displays only errors, none of the log levels above this line will be shown      |
+    | `1`             | :material-checkbox-blank-circle:{ style="color: var(--md-loglevel-error-color) " } Error       | Displays only errors, none of the log levels above this line will be shown      |
+
+<br />
+<br />

docs/docs/config/volumes.md

@@ -13,108 +13,97 @@ The TVApp2 docker image provides a few different paths that you can mount to you
 <br />
 
 ## 📁 /usr/bin/app
-<!-- md:control env -->
-<!-- md:version stable-1.0.0 -->
-<!-- md:default `Etc/UTC` -->
 
-The `TZ` environment variable specifies the timezone that your docker container will
+<!-- md:control volume -->
-utilize. This is useful for syncing your local time with console outputs such as
+<!-- md:version stable-1.0.0 -->
-our logging system.
+
+The mountable volume `/usr/bin/app` is where TVApp2 files will be placed once the app has been built when your docker container spins up. The files in this folder include:
+
+| File | Description |
+| --- | --- |
+| `📁 node_modules` | List of all NodeJS packages utilized by TVApp2 |
+| `📁 www` | Main storage folder for TVApp2. Contains website files and M3U / EPG synced files |
+| `📄 package.json` | NodeJS package file |
+| `📄 playlist.m3u8` | Generated playlist containing channels |
+| `📄 urls.txt` | List containing cached URLs utilized by TVApp2 |
+| `📄 xmltv.xml` | EPG guide data in uncompressed XML format |
+| `📄 xmltv.xml.gz` | EPG guide data in compressed GZ archive |
+| `📄 index.js` | Main source code file for TVApp2 |
+
+<br />
 
 === "Example"
 
-    ``` { .yaml .copy .select title="docker-compose.yml" linenums="1" hl_lines="13" }
+    ``` { .yaml .copy .select title="docker-compose.yml" linenums="1" hl_lines="7" }
     services:
         tvapp2:
             container_name: tvapp2
             image: ghcr.io/thebinaryninja/tvapp2:latest
             restart: unless-stopped
             volumes:
-                - /etc/timezone:/etc/timezone:ro
+                - ./app:/usr/bin/app # (1)
-                - /etc/localtime:/etc/localtime:ro
-                - /var/run/docker.sock:/var/run/docker.sock
-                - ./config:/config
-                - ./app:/usr/bin/app
-            environment:
-                - TZ=Etc/UTC # (1)
     ```
 
     1.  :information: Changing this env variable will change the time for anything
         related to the TVApp2 docker container.
 
-=== "Timezones"
+<br />
 
-    ``` yaml
+This folder path can be changed by specifying a new path with the environment variable `DIR_RUN`
-      Etc/UTC
+
-      Africa/Cairo
+=== "Example"
-      Africa/Johannesburg
+
-      Africa/Lagos
+    ``` { .yaml .copy .select title="docker-compose.yml" linenums="1" hl_lines="7" }
-      America/Argentina/Buenos_Aires
+    services:
-      America/Bogota
+        tvapp2:
-      America/Caracas
+            container_name: tvapp2
-      America/Chicago
+            image: ghcr.io/thebinaryninja/tvapp2:latest
-      America/El_Salvador
+            restart: unless-stopped
-      America/Juneau
+            volumes:
-      America/Lima
+                - ./app:/usr/bin/app # (1) (2)
-      America/Los_Angeles
-      America/Mexico_City
-      America/New_York
-      America/Phoenix
-      America/Santiago
-      America/Sao_Paulo
-      America/Toronto
-      America/Vancouver
-      Asia/Almaty
-      Asia/Ashkhabad
-      Asia/Bahrain
-      Asia/Bangkok
-      Asia/Chongqing
-      Asia/Dubai
-      Asia/Ho_Chi_Minh
-      Asia/Hong_Kong
-      Asia/Jakarta
-      Asia/Jerusalem
-      Asia/Kathmandu
-      Asia/Kolkata
-      Asia/Kuwait
-      Asia/Muscat
-      Asia/Qatar
-      Asia/Riyadh
-      Asia/Seoul
-      Asia/Shanghai
-      Asia/Singapore
-      Asia/Taipei
-      Asia/Tehran
-      Asia/Tokyo
-      Atlantic/Reykjavik
-      Australia/ACT
-      Australia/Adelaide
-      Australia/Brisbane
-      Australia/Sydney
-      Europe/Athens
-      Europe/Belgrade
-      Europe/Berlin
-      Europe/Copenhagen
-      Europe/Helsinki
-      Europe/Istanbul
-      Europe/London
-      Europe/Luxembourg
-      Europe/Madrid
-      Europe/Moscow
-      Europe/Paris
-      Europe/Riga
-      Europe/Rome
-      Europe/Stockholm
-      Europe/Tallinn
-      Europe/Vilnius
-      Europe/Warsaw
-      Europe/Zurich
-      Pacific/Auckland
-      Pacific/Chatham
-      Pacific/Fakaofo
-      Pacific/Honolulu
-      Pacific/Norfolk
-      US/Mountain
     ```
 
+    1.  :information: Changing this env variable will change the folder within the docker container which stores the fully built TVApp2 files.
+
+    2.  This should not be used unless you know what you're doing
+
+<br />
+
+---
+
+<br />
+
+## 📁 /config
+
+<!-- md:control volume -->
+<!-- md:version stable-1.0.0 -->
+
+The mountable volume `/config` defines where the TVApp2 application will store SSL certificates related to the TVApp2 web interface being ran using https instead of http. The files in this folder include:
+
+| File | Description |
+| --- | --- |
+| `📁 keys` | Folder which stores the SSL cert and keys |
+| `📄 keys/cert.crt` | SSL public certificate |
+| `📄 keys/key.crt` | SSL private key |
+
+<br />
+
+
+=== "Example"
+
+    ``` { .yaml .copy .select title="docker-compose.yml" linenums="1" hl_lines="7" }
+    services:
+        tvapp2:
+            container_name: tvapp2
+            image: ghcr.io/thebinaryninja/tvapp2:latest
+            restart: unless-stopped
+            volumes:
+                - ./config:/config # (1) (2)
+    ```
+
+    1.  :information: Changing this env variable will change the folder within the docker container which stores the fully built TVApp2 files.
+
+    2.  This should not be used unless you know what you're doing
+
+<br />
 <br />

docs/docs/install/docker-run.md

@@ -0,0 +1,125 @@
+---
+title: "Install: docker-run"
+tags:
+  - install
+---
+
+# docker run
+
+Our documentation provides two ways that you may start up a TVApp2 docker container:
+
+<div class="grid cards" markdown>
+
+-   :material-circle: &nbsp; [docker run](docker-run.md)
+
+    ---
+
+    Spin up the TVApp2 container using the `docker run` command. 
+    This is useful for quick launches, but is not time efficient
+    if you plan to use this container long-term.
+
+    This requires a longer command that must be used each time
+    you wish to bring the container up.
+
+-   :material-circle: &nbsp; [docker compose](docker-compose.md)
+
+    ---
+
+    Spin up the TVApp2 container by creating a `📄 docker-compose.yml`
+    file which will store all of your options such as env variables,
+    mounted volumes, and labels.
+
+    To bring the container up, `cd` into the folder with the 
+    `📄 docker-compose.yml` file, and run the
+    command `docker compose up -d`.
+
+</div>
+
+<br />
+
+The `🗔 docker run` command allows you to start up a docker container by providing a set of [options](#command-options) which define how the container should operate, including the environment variables, mounted volumes, assigned IP address, etc.
+
+<br />
+
+---
+
+<br />
+
+## Start TVApp2
+
+Pulling the image if needed and starting the container. To spin up a TVApp2 container using this method; run a command similar to the below example. See the section [Options](#options) below for a list of what you can specify.
+
+=== "Terminal"
+
+    ```shell
+    docker run -d \
+    --restart=unless-stopped \ # (1)!
+    --name tvapp2 \ # (2)!
+    -p 4124:4124 \ # (3)!
+    -e "TZ=Etc/UTC" \ # (4)!
+    -v ${PWD}/app:/usr/bin/app \ # (5)!
+    ghcr.io/thebinaryninja/tvapp2:latest # (6)!
+    ```
+
+    1.  Specifies what happens if the container becomes unresponsive or goes down.
+    2.  Name to assign the container; otherwise, a random id will be given.
+    3.  Port that will be used for the container
+    4.  Environment variable which specifies the timezone to use for the container.
+    5.  Mount the container volume `/usr/bin/app` to your host machine in the subfolder `./app`
+    6.  Specifies what docker image to spin up.
+
+<br />
+
+To confirm that the container has been brought up, run the command `docker ps | grep tvapp2`. If you have the app [Portainer](https://portainer.io/), you can sign into your admin interface and view your TVApp2 container details, instead of using a command-line.
+
+```
+e95236c42b43     binaryninja/tvapp2:1.4.0     "/init"     3 seconds ago     Up 3 seconds     4124/tcp     tvapp2
+```
+
+<br />
+
+---
+
+<br />
+
+## Options
+
+Review the list of docker run options below. These allow you to define how a docker container will start up.
+
+???- note "Official Docker Documentation"
+    To view a full list of the available docker parameters, view the official docker documentation at:
+
+    - https://docs.docker.com/reference/cli/docker/container/run/
+
+| Parameter / Flag | Description |
+| --- | --- |
+| `-d, --detach` | Run container in background and print container ID |
+| `-e, --env` | Set environment variable |
+| `--env-file` | Read in a file of environment variables |
+| `--expose` | Expose a port or a range of ports |
+| `--health-cmd` | Command to run to check health |
+| `--health-interval` | Time between running the check<br/>`ms|s|m|h` (default 0s) |
+| `--health-retries` | Consecutive failures needed to report unhealthy |
+| `--health-start-interval` | Time between running the check during the start period<br/>`ms|s|m|h` (default 0s) |
+| `--health-start-period` | Start period for the container to initialize before starting health-retries countdown<br/>`ms|s|m|h` (default 0s) |
+| `--health-timeout` | Maximum time to allow one check to run<br/>`ms|s|m|h` (default 0s) |
+| `-h, --hostname` | Container host name |
+| `--ip` | IPv4 address (e.g., 172.30.100.104) |
+| `--ip6` | IPv6 address (e.g., 2001:db8::33) |
+| `-l, --label` | Set meta data on a container |
+| `--mount` | Attach a filesystem mount to the container |
+| `--name` | Assign a name to the container |
+| `--network` | Connect a container to a network |
+| `--privileged` | Give extended privileges to this container |
+| `-p, --publish` | Publish a container's port(s) to the host |
+| `--pull` | Pull image before running<br/>`always`, `missing`, `never` |
+| `--restart` | Restart policy to apply when a container exits <br/> `on-failure[:max-retries]`, `always`, `unless-stopped` |
+| `-u, --user` | Username or UID <br/>`<name|uid>[:<group|gid>]` |
+| `-v, --volume` | Bind mount a volume |
+| `-w, --workdir` | 	Working directory inside the container |
+
+<br />
+
+
+<br />
+<br />

docs/docs/install/index.md

@@ -0,0 +1,47 @@
+---
+title: Install
+tags:
+  - install
+---
+
+# Installing TVApp2
+
+To install TVApp2 using docker; you will need to use either the `🗔 docker run` command, or create a `📄 docker-compose.yml` file which contains information about how to pull the latest image and spin the container up. We have provided instructions for both.
+
+<br />
+
+{==
+
+Select your desired option to bring up the TVApp2 container with:
+
+==}
+
+<div class="grid cards" markdown>
+
+-   :material-circle: &nbsp; [docker run](docker-run.md)
+
+    ---
+
+    Spin up the TVApp2 container using the `docker run` command. 
+    This is useful for quick launches, but is not time efficient
+    if you plan to use this container long-term.
+
+    This requires a longer command that must be used each time
+    you wish to bring the container up.
+
+-   :material-circle: &nbsp; [docker compose](docker-compose.md)
+
+    ---
+
+    Spin up the TVApp2 container by creating a `📄 docker-compose.yml`
+    file which will store all of your options such as env variables,
+    mounted volumes, and labels.
+
+    To bring the container up, `cd` into the folder with the 
+    `📄 docker-compose.yml` file, and run the
+    command `docker compose up -d`.
+
+</div>
+
+<br />
+<br />

docs/docs/stylesheets/extra.css

@@ -179,6 +179,11 @@
     }
 }
 
+[dir="ltr"] .md-typeset table th[role="columnheader"]::after
+{
+    margin-left: 5px;
+}
+
 /*
     Theme > Main
 */
@@ -191,6 +196,13 @@
     --md-tooltip-width:                 400px;
     --glow-color:                       hsl(186 100% 69%);
 
+    --md-loglevel-error-color:          #f06090;
+    --md-loglevel-warn-color:           #e6695b;
+    --md-loglevel-notice-color:         #e2d55e;
+    --md-loglevel-info-color:           #6791e0;
+    --md-loglevel-debug-color:          #c973d9;
+    --md-loglevel-trace-color:          hsla(225deg,15%,90%,0.56);
+
     --md-default-fg-color:              hsla(var(--md-hue),15%,90%,0.82);
     --md-default-fg-color--light:       hsla(var(--md-hue),15%,90%,0.56);
     --md-default-fg-color--lighter:     hsla(var(--md-hue),15%,90%,0.32);
@@ -411,7 +423,28 @@
 
     .md-typeset .tabbed-labels
     {
-        background-color: #0d0d0d;
+        background-color: #0b0b0b;
+        border-top-left-radius: 4px;
+        border-left: 1px solid #242735;
+        border-top: 1px solid #242735;
+        border-right: 1px solid #242735;
+        border-top-right-radius: 4px;
+    }
+
+    .tabbed-labels::before
+    {
+        background: hsla(343.1, 87.9%, 51.6%, 0.82);
+        bottom: 0;
+        content: "";
+        display: block;
+        height: 2px;
+        left: 0;
+        position: absolute;
+        transform: translateX(var(--md-indicator-x));
+        transition: width 225ms,background-color .25s,transform .25s;
+        transition-timing-function: ease, ease, ease;
+        transition-timing-function: cubic-bezier(.4,0,.2,1);
+        width: var(--md-indicator-width);
     }
 
     /*
@@ -561,6 +594,25 @@ h4:has(.twemoji) .twemoji
     --md-typeset-bg-color: #111;
 }
 
+@keyframes health
+{
+    0%, 40%, 80%, 100% {
+        transform: scale(1);
+        color: #FFF;
+        fill: #FFF !important;
+    }
+    20%, 60% {
+        transform: scale(1.15);
+        color: #FF6593;
+        fill: #FF6593 !important;
+    }
+}
+
+.heart
+{
+    animation: health 1000ms infinite;
+}
+
 .md-typeset .mdx-badge--heart {
     --md-badge-icon-color: #e92063;
     --md-badge-icon-hover-color: #FFFFFF;

docs/docs/usage/healthcheck.md

@@ -0,0 +1,164 @@
+---
+title: Healthcheck
+tags:
+  - usage
+---
+
+# Healthcheck
+
+This docker container includes the ability to run health checks between the container api and outside services such as Portainer, or any other app that has the ability to query the endpoint `api/health`.
+
+<br />
+
+---
+
+<br />
+
+## API
+<!-- md:version stable-1.4.0 -->
+
+This container includes the ability to run health checks utilizing the built-in API. You can directly access the health check and view a json formatted result with the url `https://tvapp2.domain.lan/api/health`
+
+=== "Example"
+
+    ``` { .yaml .copy .select title="/api/health" linenums="1" }
+    {
+        "ip": "172.18.2.1",
+        "gateway": "172.18.0.1",
+        "uptime": 5903.549082501,
+        "message": "healthy",
+        "status": "healthy",
+        "ref": "/api/health",
+        "method": "GET",
+        "code": 200,
+        "timestamp": 1744386346242
+    }
+    ```
+
+<br />
+
+Numerous aliases have been added; you can use any of the following URLs to access the same health check results as they go to the same endpoint:
+
+- https://tvapp2.domain.lan/api/health
+- https://tvapp2.domain.lan/api/status
+
+<br />
+
+---
+
+<br />
+
+## Portainer
+<!-- md:version stable-1.3.0 -->
+
+To run a health check between TVApp2 and Portainer, apply the following lines of code to your TVApp2 `docker-compose.yml`. Two examples have been provided, you can use either one; `wget` or `curl`:
+
+=== "Using CURL"
+
+    ``` { .yaml .copy .select title="docker-compose.yml" linenums="1" hl_lines="14-18" }
+    services:
+        tvapp2:
+            container_name: tvapp2
+            image: ghcr.io/thebinaryninja/tvapp2:latest
+            restart: unless-stopped
+            volumes:
+                - /etc/timezone:/etc/timezone:ro
+                - /etc/localtime:/etc/localtime:ro
+                - /var/run/docker.sock:/var/run/docker.sock
+                - ./config:/config
+                - ./app:/usr/bin/app
+            environment:
+                - TZ=Etc/UTC
+            health check:
+                test: "curl --fail --silent http://127.0.0.1:4124/api/health | grep -i healthy || exit 1"
+                interval: 15s
+                timeout: 10s
+                retries: 3
+    ```
+
+=== "Using WGET"
+
+    ``` { .yaml .copy .select title="docker-compose.yml" linenums="1" hl_lines="14-18" }
+    services:
+        tvapp2:
+            container_name: tvapp2
+            image: ghcr.io/thebinaryninja/tvapp2:latest
+            restart: unless-stopped
+            volumes:
+                - /etc/timezone:/etc/timezone:ro
+                - /etc/localtime:/etc/localtime:ro
+                - /var/run/docker.sock:/var/run/docker.sock
+                - ./config:/config
+                - ./app:/usr/bin/app
+            environment:
+                - TZ=Etc/UTC
+            health check:
+                test: "wget -qO- http://127.0.0.1:4124/api/health | grep -i healthy || exit 1"
+                interval: 15s
+                timeout: 10s
+                retries: 3
+    ```
+
+<br />
+
+---
+
+<br />
+
+## Web Interface
+<!-- md:version stable-1.4.0 -->
+
+The TVApp2 web interface is equip with its own health check which is ran every `10 minutes` by default. Users will notice a health indicator in the top right of the header navigation bar which is represented by the :octicons-heart-fill-24:{ .heart } icon.
+
+When the health check is ran every 10 minutes; a toast notification will appear in the lower-right side of the page:
+
+<figure markdown="span">
+    ![Image settings](../../assets/images/health-toast.gif){ width="80%" }
+    <figcaption>Health check toast notification</figcaption>
+</figure>
+
+<br />
+
+### Health Check Duration
+<!-- md:control env -->
+<!-- md:version stable-1.4.0 -->
+<!-- md:default `600000` -->
+
+By default, a health check between the TVApp2 container and the web interface is done every `10 minutes`, but you can change this duration to something less or more. Be aware that if you set the time too low, you will constantly be spammed with toast notifications. 
+
+To change the health check delay, add the environment variable `HEALTH_TIMER` to your TVApp2 `docker-compose.yml`. Duration is in milliseconds.
+
+<br />
+
+=== "Example"
+
+    ``` { .yaml .copy .select title="docker-compose.yml" linenums="1" hl_lines="13" }
+    services:
+        tvapp2:
+            container_name: tvapp2
+            image: ghcr.io/thebinaryninja/tvapp2:latest
+            restart: unless-stopped
+            volumes:
+                - /etc/timezone:/etc/timezone:ro
+                - /etc/localtime:/etc/localtime:ro
+                - /var/run/docker.sock:/var/run/docker.sock
+                - ./config:/config
+                - ./app:/usr/bin/app
+            environment:
+                - HEALTH_TIMER=600000 # (1)
+    ```
+
+    1.  :information: Defines how often to perform health checks between the container and the web interface. Time is in milliseconds. <br /><br />Default value is `600000` (10 minutes)
+
+=== "Time Chart"
+
+    | HEALTH_TIMER Value | Delay Between Checks |
+    | --- | --- |
+    | `HEALTH_TIMER=300000` | 5 minutes |
+    | `HEALTH_TIMER=600000` | 10 minutes |
+    | `HEALTH_TIMER=1200000` | 20 minutes |
+    | `HEALTH_TIMER=1800000` | 30 minutes |
+    | `HEALTH_TIMER=3600000` | 1 hour |
+
+<br />
+<br />

docs/material/overrides/.icons/aetherx/axd/volume.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Pro 6.7.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2024 Fonticons, Inc. --><defs><style>.fa-secondary{opacity:.4}</style></defs><path class="fa-secondary" d="M0 96C0 60.7 28.7 32 64 32l384 0c35.3 0 64 28.7 64 64l0 224c0 5.5-.7 10.8-2 16c-3.6-13.8-11.6-25.8-22.5-34.4c-5.4-4.3-11.6-7.7-18.2-10c-3.3-1.2-6.8-2.1-10.3-2.7c-1.8-.3-3.6-.5-5.4-.7c-.9-.1-1.8-.1-2.8-.2s-1.8-.1-2.8-.1L64 288c-29.8 0-54.9 20.4-62 48c-1.3-5.1-2-10.5-2-16L0 96zM352 384a32 32 0 1 1 -64 0 32 32 0 1 1 64 0z"/><path class="fa-primary" d="M0 352c0-35.3 28.7-64 64-64l384 0c35.3 0 64 28.7 64 64l0 64c0 35.3-28.7 64-64 64L64 480c-35.3 0-64-28.7-64-64l0-64zm352 32a32 32 0 1 0 -64 0 32 32 0 1 0 64 0zm64 32a32 32 0 1 0 0-64 32 32 0 1 0 0 64z"/></svg>

docs/material/overrides/hooks/shortcodes.py

@@ -164,6 +164,7 @@ def badgeControl( args: str, page: Page, files: Files ):
     elif type == "button":      return newControlButton( page, files )
     elif type == "slider":      return newControlSlider( page, files )
     elif type == "env":         return newControlEnvVar( page, files )
+    elif type == "volume":      return newControlVolume( page, files )
     elif type == "color":       return newControlColor( args, page, files )
     else: return newControlDefault( page, files )
 
@@ -935,7 +936,7 @@ def newControlColor( text: str, page: Page, files: Files ):
 #   Icon : Control : Env Variable
 #
 #       use the following tag in your md file:
-#           <!-- md:control slider -->
+#           <!-- md:control env -->
 # #
 
 def newControlEnvVar( page: Page, files: Files ):
@@ -948,3 +949,21 @@ def newControlEnvVar( page: Page, files: Files ):
         icon = f"[:{icon}:]({href} 'Type: Environment Variable')",
         type = "env"
     )
+
+# #
+#   Icon : Control : Volume
+#
+#       use the following tag in your md file:
+#           <!-- md:control volume -->
+# #
+
+def newControlVolume( page: Page, files: Files ):
+    icon = "aetherx-axd-volume"
+    href = _resolve_path( f"{PAGE_CONVENTIONS}#control", page, files )
+
+    print(clr.MAGENTA + 'VERBOSE - ' + clr.WHITE + ' Running ' + clr.YELLOW + inspect.stack()[0][3] + clr.WHITE + ' for page ' + clr.GREY + str(href) + clr.WHITE )
+
+    return badgeCreate(
+        icon = f"[:{icon}:]({href} 'Type: Mountable Volume')",
+        type = "volume"
+    )

docs/mkdocs.yml

@@ -29,6 +29,7 @@ site_url: 'https://thebinaryninja.github.io/tvapp2/'
 # #
 
 markdown_extensions:
+    - pymdownx.critic
     - markdown.extensions.extra
     - toc:
           permalink: true
@@ -238,9 +239,15 @@ nav:
           - Wiki:
                 - Conventions: 'about/conventions.md'
                 - Tags: 'about/tags.md'
+    - Install:
+          - Getting Started: 'install/index.md'
+          - docker run: 'install/docker-run.md'
+          - docker compose: 'install/docker-compose.md'
     - Config:
           - Environment Variables: 'config/env.md'
           - Volumes: 'config/volumes.md'
+    - Usage:
+          - Healthcheck: 'usage/healthcheck.md'
     - Changelog: 'about/changelog.md'
     - Discord: 'https://discord.gg/gTze6hRe'
 

examples/traefik/docker-compose-traefik.yml

@@ -25,7 +25,7 @@
 services:
 
     # #
-    #   Service › TVApp2 › Traefik Labels
+    #   Service › TVApp2
     # #
 
     tvapp2:
@@ -40,7 +40,6 @@ services:
         volumes:
             - /etc/timezone:/etc/timezone:ro
             - /etc/localtime:/etc/localtime:ro
-            - /var/run/docker.sock:/var/run/docker.sock
             - ./config:/config
             - ./app:/usr/bin/app
         ulimits:
@@ -56,7 +55,7 @@ services:
           - traefik.enable=true
 
           # #
-          #   Scope > http
+          #   Routers › Web Interface › http
           # #
 
           - traefik.http.routers.tvapp2-http.rule=Host(`tvapp2.localhost`) || Host(`tvapp2.domain.lan`) || Host(`www.tvapp2.domain.lan`) || Host(`${SERVICE_IP}`)
@@ -66,7 +65,7 @@ services:
           - traefik.http.routers.tvapp2-http.middlewares=https-redirect@file
 
           # #
-          #   Scope > https
+          #   Routers › Web Interface › https
           #
           #   remove the authentik@file line if you do not wish to use Authentik or middleware
           #       - traefik.http.routers.tvapp2-https.middlewares=authentik@file
@@ -83,8 +82,26 @@ services:
           - traefik.http.routers.tvapp2-https.middlewares=authentik@file
 
           # #
-          #   Load Balancer
+          #   Routers › HDHomeRun
           # #
 
-          - traefik.http.services.tvapp2.loadbalancer.server.port=http
+          - traefik.http.routers.hdhr-https.rule=Host(`hdhr.domain.lan`)
-          - traefik.http.services.tvapp2.loadbalancer.server.scheme=4124
+          - traefik.http.routers.hdhr-https.service=hdhr
+          - traefik.http.routers.hdhr-https.entrypoints=https
+          - traefik.http.routers.hdhr-https.priority=1
+          - traefik.http.routers.hdhr-https.tls=true
+          - traefik.http.routers.hdhr-https.tls.certresolver=cloudflare
+
+          # #
+          #   Services › Main Web Interface
+          # #
+
+          - traefik.http.services.tvapp2.loadbalancer.server.port=4124
+          - traefik.http.services.tvapp2.loadbalancer.server.scheme=http
+
+          # #
+          #   Services › HDHomeRun Server (optional)
+          # #
+
+          - traefik.http.services.hdhr.loadbalancer.server.port=6077
+          - traefik.http.services.hdhr.loadbalancer.server.scheme=http

examples/traefik/dynamic.yml

@@ -295,24 +295,24 @@ http:
                           - "*.domain.lan"
 
         # #
-        #   @container          TVApp2
+        #   @container          TVApp2 › Main
-        #   @desc               utomatic M3U playlist and XML guide updater for TheTvApp, TVPass, and MoveOnJoy utilized within your IPTV client.
+        #   @desc               automatic M3U playlist and XML guide updater for TheTvApp, TVPass, and MoveOnJoy utilized within your IPTV client.
         #   @url                https://github.com/TheBinaryNinja/tvapp2
         #
-        #   remove / comment out the authentik line if you do not plan to use authentik:
+        #                       remove / comment out the authentik line if you do not plan to use authentik:
-        #       - authentik@file
+        #                           - authentik@file
         # #
 
-        tvapp2-http:
+        tvapp2-server-http:
-            service: "tvapp2"
+            service: "tvapp2-server"
             rule: "Host(`tvapp2.localhost`) || Host(`tvapp2.domain.lan`)"
             entryPoints:
                 - http
             middlewares:
                 - https-redirect@file
 
-        tvapp2-https:
+        tvapp2-server-https:
-            service: "tvapp2"
+            service: "tvapp2-server"
             rule: "Host(`tvapp2.localhost`) || Host(`tvapp2.domain.lan`)"
             entryPoints:
                 - https
@@ -325,6 +325,37 @@ http:
                     - main: "domain.lan"
                       sans:
                           - "*.domain.lan"
+        # #
+        #   @container          TVApp2 › HDHomeRun
+        #   @desc               automatic M3U playlist and XML guide updater for TheTvApp, TVPass, and MoveOnJoy utilized within your IPTV client.
+        #   @url                https://github.com/TheBinaryNinja/tvapp2
+        #
+        #                       remove / comment out the authentik line if you do not plan to use authentik:
+        #                           - authentik@file
+        # #
+
+        tvapp2-hdhr-http:
+            service: "tvapp2-hdhr"
+            rule: "Host(`hdhr.localhost`) || Host(`hdhr.domain.lan`)"
+            entryPoints:
+                - http
+            middlewares:
+                - https-redirect@file
+
+        tvapp2-hdhr-https:
+            service: "tvapp2-hdhr"
+            rule: "Host(`hdhr.localhost`) || Host(`hdhr.domain.lan`)"
+            entryPoints:
+                - https
+            middlewares:
+                - redirect-www@file
+                - authentik@file
+            tls:
+                certResolver: cloudflare
+                domains:
+                    - main: "domain.lan"
+                      sans:
+                          - "*.domain.lan"
 
     # #
     #   http › Services
@@ -351,7 +382,12 @@ http:
                 servers:
                     - url: "http://plex:32400"
 
-        tvapp2:
+        tvapp2-server:
+            loadBalancer:
+                servers:
+                    - url: "http://tvapp2:4124"
+
+        tvapp2-hdhr:
             loadBalancer:
                 servers:
                     - url: "http://tvapp2:4124"

root/custom-cont-init.d/plugins

@@ -9,10 +9,80 @@
 #   @repo.3         https://github.com/aetherinox/docker-base-alpine
 # #
 
+# #
+#   define > colors
+#
+#   Use the color table at:
+#       - https://gist.github.com/fnky/458719343aabd01cfb17a3a4f7296797
+# #
+
+declare -A c=(
+    [end]=$'\e[0m'
+    [white]=$'\e[97m'
+    [bold]=$'\e[1m'
+    [dim]=$'\e[2m'
+    [underline]=$'\e[4m'
+    [strike]=$'\e[9m'
+    [blink]=$'\e[5m'
+    [inverted]=$'\e[7m'
+    [hidden]=$'\e[8m'
+    [black]=$'\e[0;30m'
+    [redl]=$'\e[0;91m'
+    [redd]=$'\e[0;31m'
+    [magental]=$'\e[0;95m'
+    [magentad]=$'\e[0;35mm'
+    [bluel]=$'\e[0;94m'
+    [blued]=$'\e[0;34m'
+    [cyanl]=$'\e[0;96m'
+    [cyand]=$'\e[0;36m'
+    [greenl]=$'\e[0;92m'
+    [greend]=$'\e[0;32m'
+    [yellowl]=$'\e[0;93m'
+    [yellowd]=$'\e[0;33m'
+    [greyl]=$'\e[0;37m'
+    [greyd]=$'\e[0;90m'
+    [navy]=$'\e[38;5;62m'
+    [olive]=$'\e[38;5;144m'
+    [peach]=$'\e[38;5;210m'
+)
+
+# #
+#   unicode for emojis
+#       https://apps.timwhitlock.info/emoji/tables/unicode
+# #
+
+declare -A icon=(
+    ["symbolic link"]=$'\xF0\x9F\x94\x97' # 🔗
+    ["regular file"]=$'\xF0\x9F\x93\x84' # 📄
+    ["directory"]=$'\xF0\x9F\x93\x81' # 📁
+    ["regular empty file"]=$'\xe2\xad\x95' # ⭕
+    ["log"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["1"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["2"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["3"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["4"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["5"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["pem"]=$'\xF0\x9F\x94\x92' # 🔑
+    ["pub"]=$'\xF0\x9F\x94\x91' # 🔒
+    ["pfx"]=$'\xF0\x9F\x94\x92' # 🔑
+    ["p12"]=$'\xF0\x9F\x94\x92' # 🔑
+    ["key"]=$'\xF0\x9F\x94\x91' # 🔒
+    ["crt"]=$'\xF0\x9F\xAA\xAA ' # 🪪
+    ["gz"]=$'\xF0\x9F\x93\xA6' # 📦
+    ["zip"]=$'\xF0\x9F\x93\xA6' # 📦
+    ["gzip"]=$'\xF0\x9F\x93\xA6' # 📦
+    ["deb"]=$'\xF0\x9F\x93\xA6' # 📦
+    ["sh"]=$'\xF0\x9F\x97\x94' # 🗔
+)
+
+# #
+#   define > general
+# #
+
 PLUGINS_PATH="/config/www/plugins"
 
 # #
 #   Plugins > Start
 # #
 
-echo -e " Loader       : Checking tvapp2-plugins"
+printf '%-29s %-65s\n' "  ${c[bluel]}Loader${c[end]}" "${c[end]}Checking tvapp2-plugins${c[end]}"

root/etc/s6-overlay/s6-rc.d/ci-service-check/up

@@ -1 +1 @@
-echo -e " Core         : Completed loading container"
+echo -e " Completed loading container"

root/etc/s6-overlay/s6-rc.d/init-adduser/run

@@ -1,35 +1,173 @@
 #!/usr/bin/with-contenv bash
 # shellcheck shell=bash
 
+# #
+#   defaults
+# #
+
 PUID=${PUID:-911}
 PGID=${PGID:-911}
+DIR_BUILD=${DIR_BUILD:-/usr/src/app}
+DIR_RUN=${DIR_RUN:-/usr/bin/app}
+bHasError=false
+
+# #
+#   define > colors
+#
+#   Use the color table at:
+#       - https://gist.github.com/fnky/458719343aabd01cfb17a3a4f7296797
+# #
+
+declare -A c=(
+    [end]=$'\e[0m'
+    [white]=$'\e[97m'
+    [bold]=$'\e[1m'
+    [dim]=$'\e[2m'
+    [underline]=$'\e[4m'
+    [strike]=$'\e[9m'
+    [blink]=$'\e[5m'
+    [inverted]=$'\e[7m'
+    [hidden]=$'\e[8m'
+    [black]=$'\e[0;30m'
+    [redl]=$'\e[0;91m'
+    [redd]=$'\e[0;31m'
+    [magental]=$'\e[0;95m'
+    [magentad]=$'\e[0;35mm'
+    [bluel]=$'\e[0;94m'
+    [blued]=$'\e[0;34m'
+    [cyanl]=$'\e[0;96m'
+    [cyand]=$'\e[0;36m'
+    [greenl]=$'\e[0;92m'
+    [greend]=$'\e[0;32m'
+    [yellowl]=$'\e[0;93m'
+    [yellowd]=$'\e[0;33m'
+    [greyl]=$'\e[0;37m'
+    [greyd]=$'\e[0;90m'
+    [navy]=$'\e[38;5;62m'
+    [olive]=$'\e[38;5;144m'
+    [peach]=$'\e[38;5;210m'
+)
+
+# #
+#   unicode for emojis
+#       https://apps.timwhitlock.info/emoji/tables/unicode
+# #
+
+declare -A icon=(
+    ["symbolic link"]=$'\xF0\x9F\x94\x97' # 🔗
+    ["regular file"]=$'\xF0\x9F\x93\x84' # 📄
+    ["directory"]=$'\xF0\x9F\x93\x81' # 📁
+    ["regular empty file"]=$'\xe2\xad\x95' # ⭕
+    ["log"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["1"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["2"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["3"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["4"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["5"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["pem"]=$'\xF0\x9F\x94\x92' # 🔑
+    ["pub"]=$'\xF0\x9F\x94\x91' # 🔒
+    ["pfx"]=$'\xF0\x9F\x94\x92' # 🔑
+    ["p12"]=$'\xF0\x9F\x94\x92' # 🔑
+    ["key"]=$'\xF0\x9F\x94\x91' # 🔒
+    ["crt"]=$'\xF0\x9F\xAA\xAA ' # 🪪
+    ["gz"]=$'\xF0\x9F\x93\xA6' # 📦
+    ["zip"]=$'\xF0\x9F\x93\xA6' # 📦
+    ["gzip"]=$'\xF0\x9F\x93\xA6' # 📦
+    ["deb"]=$'\xF0\x9F\x93\xA6' # 📦
+    ["sh"]=$'\xF0\x9F\x97\x94' # 🗔
+)
+
+# #
+#   distro info
+# #
+
+sys_os_name="Unknown"
+sys_os_ver="1.0.0"
+
+if [ -e /etc/alpine-release ]; then
+    sys_os_name="Alpine"
+    sys_os_ver="$(cat /etc/alpine-release)"
+fi
+
+# #
+#   get container ips
+# #
 
 IP_GATEWAY=$(/sbin/ip route|awk '/default/ { print $3 }')
 IP_CONTAINER=$(ifconfig | grep -Eo 'inet (addr:)?([0-9]*\.){3}[0-9]*' | grep -Eo '([0-9]*\.){3}[0-9]*' | grep -v '127.0.0.1')
 
+# #
+#   usermod
+#       -o, --non-unique              allow using duplicate (non-unique) UID
+#       -g, --gid GROUP               force use GROUP as new primary group
+#       -G, --groups GROUPS           new list of supplementary GROUPS
+#       -u, --uid UID                 new UID for the user account
+#       -U, --unlock                  unlock the user account
+#
+#   groupmod
+#       -g, --gid GID                 change the group ID to GID
+#       -o, --non-unique              allow to use a duplicate (non-unique) GID
+# #
+
 if [[ -z ${TVAPP_READ_ONLY_FS} ]] && [[ -z ${TVAPP_NON_ROOT_USER} ]]; then
     groupmod -o -g "$PGID" dockerx
     usermod -o -u "$PUID" dockerx
 fi
 
-if { [[ -z ${TVAPP_READ_ONLY_FS} ]] && [[ -z ${TVAPP_NON_ROOT_USER} ]]; } || [[ ! ${TVAPP_FIRST_PARTY} = "true" ]]; then
+# #
-    cat /etc/s6-overlay/s6-rc.d/init-adduser/branding
+#   s6 > branding
-else
+# #
-    cat /run/branding
+
-fi
+printf '%-1s\n' " ${c[greyd]}──────────────────────────────────────────────────────────────────────────────────────────${c[end]}"
+printf '%-1s\n' " ${c[greyd]}                                 TVApp2 Docker Image${c[end]}"
+printf '%-1s\n' " ${c[greyd]}──────────────────────────────────────────────────────────────────────────────────────────${c[end]}"
+
+printf '%-2s\n' " ${c[greyd]}The TvApp2 image allows you to fetch M3U playlist and EPG data for numerous IPTV ${c[end]}"
+printf '%-2s\n' " ${c[greyd]}services online. ${c[end]}"
+echo -e
+printf '%-2s\n' " ${c[greyd]}Once the files are fetched by the image, you can visit the self-hosted webpage, copy ${c[end]}"
+printf '%-2s\n' " ${c[greyd]}the links to the M3U and EPG files; and add them to your favorite IPTV app such as ${c[end]}"
+printf '%-2s\n' " ${c[greyd]}Jellyfin, Plex, or Emby. ${c[end]}"
+echo -e
+printf '%-2s\n' " ${c[greyd]}For more information about this project; visit the links below. This app is served on ${c[end]}"
+printf '%-2s\n' " ${c[greyd]}multiple repositories as backup. Use any of the repo links below: ${c[end]}"
+echo -e
+printf '%-6s %-35s %-65s\n' "" " ${c[greenl]}TVApp2 Repo 1${c[end]}" "${c[end]}https://github.com/TheBinaryNinja/tvapp2 ${c[end]}"
+printf '%-6s %-35s %-65s\n' "" " ${c[greenl]}TVApp2 Repo 2${c[end]}" "${c[end]}https://git.binaryninja.net/BinaryNinja/tvapp2 ${c[end]}"
+printf '%-6s %-35s %-65s\n' "" " ${c[greenl]}Base Alpine Image${c[end]}" "${c[end]}https://github.com/Aetherinox/docker-base-alpine ${c[end]}"
+echo -e
+
+printf '%-2s\n' " ${c[greyd]}If you are making this container available on a public-facing domain, please consider ${c[end]}"
+printf '%-2s\n' " ${c[greyd]}using Traefik and Authentik to protect this container from outside access. Your M3U ${c[end]}"
+printf '%-2s\n' " ${c[greyd]}and EPG files will be available for the public to download and use. ${c[end]}"
+
+# if { [[ -z ${TVAPP_READ_ONLY_FS} ]] && [[ -z ${TVAPP_NON_ROOT_USER} ]]; } || [[ ! ${TVAPP_FIRST_PARTY} = "true" ]]; then
+#     cat /etc/s6-overlay/s6-rc.d/init-adduser/branding
+# else
+#     cat /run/branding
+# fi
+
+# #
+#   branding > non-root user
+# #
 
 if [[ -z ${TVAPP_NON_ROOT_USER} ]]; then
-echo ""
+echo -e
-echo "        User:Group              $(id -u dockerx):$(id -g dockerx)"
+printf '%-6s %-35s %-65s\n' "" " ${c[greenl]}Distro${c[end]}" "${c[end]}${sys_os_name} ${sys_os_ver}${c[end]}"
+printf '%-6s %-35s %-65s\n' "" " ${c[greenl]}User:Group${c[end]}" "${c[end]}$(id -u dockerx):$(id -g dockerx)${c[end]}"
 else
-echo "        User:Group              $(stat /run -c %u):$(stat /run -c %g)"
+printf '%-6s %-35s %-65s\n' "" " ${c[greenl]}User:Group${c[end]}" "${c[end]}$(stat /run -c %u):$(stat /run -c %g)${c[end]}"
 fi
-echo "        Port(s)                 $(echo $WEB_PORT)"
+printf '%-6s %-35s %-65s\n' "" " ${c[greenl]}Port(s)${c[end]}" "${c[end]}$(echo $WEB_PORT)${c[end]}"
-echo "        Gateway                 $(echo $IP_GATEWAY)"
+printf '%-6s %-35s %-65s\n' "" " ${c[greenl]}Gateway${c[end]}" "${c[end]}$(echo $IP_GATEWAY)${c[end]}"
-echo "        Web Server              $(echo $IP_CONTAINER:$WEB_PORT)"
+printf '%-6s %-35s %-65s\n' "" " ${c[greenl]}Web Server${c[end]}" "${c[end]}$(echo $IP_CONTAINER:$WEB_PORT)${c[end]}"
-echo "        App Folder              $(echo $DIR_RUN)"
+printf '%-6s %-35s %-65s\n' "" " ${c[greenl]}App Folder${c[end]}" "${c[end]}$(echo $DIR_RUN)${c[end]}"
-echo ""
+echo -e
-echo '──────────────────────────────────────────────────────────────────────────────────────────'
+printf '%-1s\n' " ${c[greyd]}──────────────────────────────────────────────────────────────────────────────────────────${c[end]}"
+
+# #
+#   set permissions
+# #
 
 if [[ -z ${TVAPP_READ_ONLY_FS} ]] && [[ -z ${TVAPP_NON_ROOT_USER} ]]; then
     aetherxown dockerx:dockerx /app

root/etc/s6-overlay/s6-rc.d/init-custom-files/run

@@ -1,22 +1,88 @@
 #!/usr/bin/with-contenv bash
 # shellcheck shell=bash
 
+# #
+#   define > colors
+#
+#   Use the color table at:
+#       - https://gist.github.com/fnky/458719343aabd01cfb17a3a4f7296797
+# #
+
+declare -A c=(
+    [end]=$'\e[0m'
+    [white]=$'\e[97m'
+    [bold]=$'\e[1m'
+    [dim]=$'\e[2m'
+    [underline]=$'\e[4m'
+    [strike]=$'\e[9m'
+    [blink]=$'\e[5m'
+    [inverted]=$'\e[7m'
+    [hidden]=$'\e[8m'
+    [black]=$'\e[0;30m'
+    [redl]=$'\e[0;91m'
+    [redd]=$'\e[0;31m'
+    [magental]=$'\e[0;95m'
+    [magentad]=$'\e[0;35mm'
+    [bluel]=$'\e[0;94m'
+    [blued]=$'\e[0;34m'
+    [cyanl]=$'\e[0;96m'
+    [cyand]=$'\e[0;36m'
+    [greenl]=$'\e[0;92m'
+    [greend]=$'\e[0;32m'
+    [yellowl]=$'\e[0;93m'
+    [yellowd]=$'\e[0;33m'
+    [greyl]=$'\e[0;37m'
+    [greyd]=$'\e[0;90m'
+    [navy]=$'\e[38;5;62m'
+    [olive]=$'\e[38;5;144m'
+    [peach]=$'\e[38;5;210m'
+)
+
+# #
+#   unicode for emojis
+#       https://apps.timwhitlock.info/emoji/tables/unicode
+# #
+
+declare -A icon=(
+    ["symbolic link"]=$'\xF0\x9F\x94\x97' # 🔗
+    ["regular file"]=$'\xF0\x9F\x93\x84' # 📄
+    ["directory"]=$'\xF0\x9F\x93\x81' # 📁
+    ["regular empty file"]=$'\xe2\xad\x95' # ⭕
+    ["log"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["1"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["2"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["3"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["4"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["5"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["pem"]=$'\xF0\x9F\x94\x92' # 🔑
+    ["pub"]=$'\xF0\x9F\x94\x91' # 🔒
+    ["pfx"]=$'\xF0\x9F\x94\x92' # 🔑
+    ["p12"]=$'\xF0\x9F\x94\x92' # 🔑
+    ["key"]=$'\xF0\x9F\x94\x91' # 🔒
+    ["crt"]=$'\xF0\x9F\xAA\xAA ' # 🪪
+    ["gz"]=$'\xF0\x9F\x93\xA6' # 📦
+    ["zip"]=$'\xF0\x9F\x93\xA6' # 📦
+    ["gzip"]=$'\xF0\x9F\x93\xA6' # 📦
+    ["deb"]=$'\xF0\x9F\x93\xA6' # 📦
+    ["sh"]=$'\xF0\x9F\x97\x94' # 🗔
+)
+
 # Directories
 SCRIPTS_DIR="/custom-cont-init.d"
 
 # Make sure custom init directory exists and has files in it
 if [[ -e "${SCRIPTS_DIR}" ]] && [[ -n "$(/bin/ls -A ${SCRIPTS_DIR} 2>/dev/null)" ]]; then
-    echo -e " Loader       : Plugins found, loading them ..."
+    printf '%-29s %-65s\n' "  ${c[bluel]}Loader${c[end]}" "${c[end]}Loading any found plugins${c[end]}"
     for SCRIPT in "${SCRIPTS_DIR}"/*; do
         NAME="$(basename "${SCRIPT}")"
         if [[ -f "${SCRIPT}" ]]; then
-            echo -e " Loader       : Executing ..."
+            printf '%-29s %-65s\n' "  ${c[bluel]}Loader${c[end]}" "${c[end]}Executing${c[end]}"
             /bin/bash "${SCRIPT}"
-            echo -e " Loader       : ${NAME}: Ran Successfully with code [$?]"
+            printf '%-29s %-65s\n' "  ${c[bluel]}Loader${c[end]}" "${c[end]}Successfully ran with code ${c[bluel]}[$?]${c[end]}"
         elif [[ ! -f "${SCRIPT}" ]]; then
-            echo -e " Loader       : ${NAME}: Not a valid file"
+            printf '%-29s %-65s\n' "  ${c[bluel]}Loader${c[end]}" "${c[end]}${c[bluel]}${NAME}${c[end]} is not a valid file${c[end]}"
         fi
     done
 else
-    echo -e " Loader       : No Plugins found, skipping..."
+    printf '%-29s %-65s\n' "  ${c[bluel]}Loader${c[end]}" "${c[end]}No plugins found; skipping${c[end]}"
 fi

root/etc/services.d/tvapp2/run

@@ -1,14 +1,118 @@
-#!/usr/bin/with-contenv sh
+#!/usr/bin/with-contenv bash
+# shellcheck shell=bash
 
 # #
-#   Store env variables in s6
+#   defaults
+# #
+
+PUID=${PUID:-911}
+PGID=${PGID:-911}
+DIR_BUILD=${DIR_BUILD:-/usr/src/app}
+DIR_RUN=${DIR_RUN:-/usr/bin/app}
+bHasError=false
+
+# #
+#   define > colors
+#
+#   Use the color table at:
+#       - https://gist.github.com/fnky/458719343aabd01cfb17a3a4f7296797
+# #
+
+declare -A c=(
+    [end]=$'\e[0m'
+    [white]=$'\e[97m'
+    [bold]=$'\e[1m'
+    [dim]=$'\e[2m'
+    [underline]=$'\e[4m'
+    [strike]=$'\e[9m'
+    [blink]=$'\e[5m'
+    [inverted]=$'\e[7m'
+    [hidden]=$'\e[8m'
+    [black]=$'\e[0;30m'
+    [redl]=$'\e[0;91m'
+    [redd]=$'\e[0;31m'
+    [magental]=$'\e[0;95m'
+    [magentad]=$'\e[0;35mm'
+    [bluel]=$'\e[0;94m'
+    [blued]=$'\e[0;34m'
+    [cyanl]=$'\e[0;96m'
+    [cyand]=$'\e[0;36m'
+    [greenl]=$'\e[0;92m'
+    [greend]=$'\e[0;32m'
+    [yellowl]=$'\e[0;93m'
+    [yellowd]=$'\e[0;33m'
+    [greyl]=$'\e[0;37m'
+    [greyd]=$'\e[0;90m'
+    [navy]=$'\e[38;5;62m'
+    [olive]=$'\e[38;5;144m'
+    [peach]=$'\e[38;5;210m'
+)
+
+# #
+#   unicode for emojis
+#       https://apps.timwhitlock.info/emoji/tables/unicode
+# #
+
+declare -A icon=(
+    ["symbolic link"]=$'\xF0\x9F\x94\x97' # 🔗
+    ["regular file"]=$'\xF0\x9F\x93\x84' # 📄
+    ["directory"]=$'\xF0\x9F\x93\x81' # 📁
+    ["regular empty file"]=$'\xe2\xad\x95' # ⭕
+    ["log"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["1"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["2"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["3"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["4"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["5"]=$'\xF0\x9F\x93\x9C' # 📜
+    ["pem"]=$'\xF0\x9F\x94\x92' # 🔑
+    ["pub"]=$'\xF0\x9F\x94\x91' # 🔒
+    ["pfx"]=$'\xF0\x9F\x94\x92' # 🔑
+    ["p12"]=$'\xF0\x9F\x94\x92' # 🔑
+    ["key"]=$'\xF0\x9F\x94\x91' # 🔒
+    ["crt"]=$'\xF0\x9F\xAA\xAA ' # 🪪
+    ["gz"]=$'\xF0\x9F\x93\xA6' # 📦
+    ["zip"]=$'\xF0\x9F\x93\xA6' # 📦
+    ["gzip"]=$'\xF0\x9F\x93\xA6' # 📦
+    ["deb"]=$'\xF0\x9F\x93\xA6' # 📦
+    ["sh"]=$'\xF0\x9F\x97\x94' # 🗔
+)
+
+# #
+#   distro info
+# #
+
+sys_os_name="Unknown"
+sys_os_ver="1.0.0"
+
+if [ -e /etc/alpine-release ]; then
+    sys_os_name="Alpine"
+    sys_os_ver="$(cat /etc/alpine-release)"
+fi
+
+# #
+#   s6 > store env variables
+# #
+
+printf '%-29s %-65s\n' "  ${c[bluel]}STATUS${c[end]}" "${c[end]}Fetching docker container and gateway addresses${c[end]}"
+
+# #
+#   get container ips
 # #
 
 ip_gateway=$(/sbin/ip route|awk '/default/ { print $3 }')
 ip_container=$(ifconfig | grep -Eo 'inet (addr:)?([0-9]*\.){3}[0-9]*' | grep -Eo '([0-9]*\.){3}[0-9]*' | grep -v '127.0.0.1')
 
-printf "$ip_gateway" > /var/run/s6/container_environment/IP_GATEWAY
+if [ -d "/var/run/s6/container_environment/" ]; then
-printf "$ip_container" > /var/run/s6/container_environment/IP_CONTAINER
+    printf "$ip_gateway" > /var/run/s6/container_environment/IP_GATEWAY
+    printf "$ip_container" > /var/run/s6/container_environment/IP_CONTAINER
+else
+    printf '%-29s %-65s\n' "  ${c[redl]}ERROR${c[end]}" "${c[end]}Cannot generate s6-overlay env files; folder ${c[redl]}/var/run/s6/container_environment/${c[end]} does not exist${c[end]}"
+    bHasError=true
+fi
+
+# #
+#   s6 > export env vars
+# #
 
 export IP_GATEWAY=$ip_gateway
 export IP_GATEWAY=$ip_container
@@ -17,8 +121,75 @@ export IP_GATEWAY=$ip_container
 #   install and startup for tvapp2
 # #
 
-cp -r ${DIR_BUILD}/* ${DIR_RUN}
+printf '%-29s %-65s\n' "  ${c[bluel]}STATUS${c[end]}" "${c[end]}Copying ${c[bluel]}${DIR_BUILD}${c[end]} to ${c[bluel]}${DIR_RUN}${c[end]}"
-rm -rf ${DIR_BUILD}/*
+if [ -z "${DIR_BUILD}" ]; then
-cd ${DIR_RUN}
+    printf '%-29s %-65s\n' "  ${c[redl]}ERROR${c[end]}" "${c[end]}Cannot copy; env var ${c[redl]}\${DIR_BUILD}${c[end]} missing${c[end]}"
-npm install --omit=dev
+    bHasError=true
-npm start
+else
+    if [ -d "${DIR_BUILD}/" ]; then
+        cp -r ${DIR_BUILD}/* ${DIR_RUN}
+    else
+        printf '%-29s %-65s\n' "  ${c[redl]}ERROR${c[end]}" "${c[end]}Cannot copy folder ${c[redl]}${DIR_BUILD}${c[end]} to ${c[redl]}${DIR_RUN}${c[end]}; build folder ${c[redl]}${DIR_BUILD}${c[end]} does not exist${c[end]}"
+        bHasError=true
+    fi
+fi
+
+# #
+#   remove build directory
+# #
+
+printf '%-29s %-65s\n' "  ${c[bluel]}STATUS${c[end]}" "${c[end]}Remove ${c[bluel]}${DIR_BUILD}/${c[end]}"
+if [ -z "${DIR_BUILD}" ]; then
+    printf '%-29s %-65s\n' "  ${c[redl]}ERROR${c[end]}" "${c[end]}Cannot remove; env var ${c[redl]}\${DIR_BUILD}${c[end]} missing${c[end]}"
+else
+    if [ -d "${DIR_BUILD}" ]; then
+        rm -rf "${DIR_BUILD}/"
+    else
+        printf '%-29s %-65s\n' "  ${c[redl]}ERROR${c[end]}" "${c[end]}Cannot remove; build folder ${c[redl]}${DIR_BUILD}${c[end]} does not exist. Restart the container to re-initialize build folder.${c[end]}"
+    fi
+fi
+
+# #
+#   cd to BUILD_RUN directory
+# #
+
+printf '%-29s %-65s\n' "  ${c[bluel]}STATUS${c[end]}" "${c[end]}Changing to run directory ${c[bluel]}${DIR_RUN}/${c[end]}"
+if [ -z "${DIR_RUN}" ]; then
+    printf '%-29s %-65s\n' "  ${c[redl]}ERROR${c[end]}" "${c[end]}Cannot cd; env var ${c[redl]}\${DIR_RUN}${c[end]} missing${c[end]}"
+    bHasError=true
+else
+    if [ -d "${DIR_RUN}" ]; then
+        cd ${DIR_RUN}
+    else
+        printf '%-29s %-65s\n' "  ${c[redl]}ERROR${c[end]}" "${c[end]}Cannot cd; run folder ${c[redl]}${DIR_RUN}${c[end]} does not exist${c[end]}"
+        bHasError=true
+    fi
+fi
+
+# #
+#   install tvapp2 via npm
+# #
+
+printf '%-29s %-65s\n' "  ${c[bluel]}STATUS${c[end]}" "${c[end]}Running command ${c[bluel]}npm install --omit=dev${c[end]}"
+if ! command -v npm; then
+    printf '%-29s %-65s\n' "  ${c[redl]}ERROR${c[end]}" "${c[end]}Cannot install TVApp2 with npm because package ${c[redl]}npm${c[end]} not installed${c[end]}"
+    bHasError=true
+else
+    npm install --omit=dev
+
+    printf '%-29s %-65s\n' "  ${c[bluel]}STATUS${c[end]}" "${c[end]}Running command ${c[bluel]}npm start${c[end]}"
+    npm start
+fi
+
+# #
+#   finished run script
+# #
+
+printf '%-29s %-65s\n' "  ${c[greenl]}OK${c[end]}" "${c[end]}Finished initializing script${c[end]}"
+if [ "$bHasError" = true ] ; then
+    printf '%-29s %-65s\n' "" ""
+    printf '%-29s %-65s\n' "  ${c[redl]}ERROR${c[end]}" "${c[end]}Fatal errors were detected${c[end]}"
+    printf '%-29s %-65s\n' "  ${c[redl]}${c[end]}" "${c[end]}The run script detected that certain steps failed. This app may not${c[end]}"
+    printf '%-29s %-65s\n' "  ${c[redl]}${c[end]}" "${c[end]}work properly. Try restarting the container.${c[end]}"
+    printf '%-29s %-65s\n' "" ""
+fi

tvapp2/classes/CLib.js

@@ -0,0 +1,169 @@
+/*
+    Compress / Uncompress String with base64
+
+    these functions use a unique character table. moving the letters around will cause strings to not
+    be in the correct order once uncompressed.
+
+    @usage          new CLib().compress( 'https://daddylive.mp/' )
+                    new CLib().uncompress( 'burS7u6FvUHhZfrhkfJoYz8CswTD=' )
+                    new CLib().translate( '=', plugin.defTrans, plugin.tvaTrans )
+
+                    a custom character set can be specified with two additional parameters. however, anything prior
+                    that was encoded will not be decoded by the new character set.
+
+                    const strCompress = new CLib().compress( 'test.com' );
+                    const strUncompress = new CLib().uncompress( strCompress );
+
+                    new CLib().compress( 'test.com', 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/', 'rXzxP9ZdvehYlstwiTuV1c07j45Abo2Ama6k3gqpyf8n+/NMSEIUHBQRJDLFCGKO' )
+                    new CLib().uncompress( 'oZcUozDkAQH=', 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/', 'rXzxP9ZdvehYlstwiTuV1c07j45Abo2Ama6k3gqpyf8n+/NMSEIUHBQRJDLFCGKO' )
+*/
+
+import chalk from 'chalk';
+import Log from './Log.js';
+
+/*
+    Class > CLib
+*/
+
+class CLib
+{
+    constructor()
+    {
+        this.defTrans = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+        this.tvaTrans = 'TVAPp29uqXiv6g5adr1j8nfwZ0bs7Ykm3xl4hczAtoey+/CDKJULSEMBQRFGIHNO';
+    }
+
+    compress( data, defTrans, tvaTrans )
+    {
+        if ( typeof data === 'string' )
+            data = Buffer.from( data, 'utf8' );
+
+        const transDef = defTrans || this.defTrans;
+        const transTva = tvaTrans || this.tvaTrans;
+
+        try
+        {
+            const dataCompress = this.translate( data.toString( 'base64' ), transDef, transTva );
+
+            Log.ok( `clib`, chalk.yellow( `[compress]` ), chalk.white( `⚙️` ),
+                chalk.blueBright( `<msg>` ), chalk.gray( `Compress string` ),
+                chalk.blueBright( `<strRaw>` ), chalk.gray( `${ data }` ),
+                chalk.blueBright( `<strCompress>` ), chalk.gray( `${ dataCompress }` ) );
+
+            return dataCompress;
+        }
+        catch ( err )
+        {
+            Log.error( `clib`, chalk.redBright( `[compress]` ), chalk.white( `❌` ),
+                chalk.redBright( `<msg>` ), chalk.gray( `Could not compress string; bad string ${ data }` ),
+                chalk.redBright( `<error>` ), chalk.gray( `${ err.message }` ),
+                chalk.redBright( `<strCompress>` ), chalk.gray( `${ data }` ) );
+
+            return null;
+        }
+    }
+
+    uncompress( data, defTrans, tvaTrans )
+    {
+        if ( Buffer.isBuffer( data ) )
+            data = data.toString();
+
+        const transDef = defTrans || this.defTrans;
+        const transTva = tvaTrans || this.tvaTrans;
+
+        try
+        {
+            const dataTranslated = this.translate( data, transTva, transDef );
+            const dataUncompress = Buffer.from( dataTranslated, 'base64' ).toString( 'utf8' );
+
+            Log.ok( `clib`, chalk.yellow( `[decompss]` ), chalk.white( `⚙️` ),
+                chalk.blueBright( `<msg>` ), chalk.gray( `Uncompress string` ),
+                chalk.blueBright( `<strCompress>` ), chalk.gray( `${ data }` ),
+                chalk.blueBright( `<strRaw>` ), chalk.gray( `${ dataUncompress }` ) );
+
+            return dataUncompress;
+        }
+        catch ( err )
+        {
+            Log.error( `clib`, chalk.redBright( `[decompss]` ), chalk.white( `❌` ),
+                chalk.redBright( `<msg>` ), chalk.gray( `Could not uncompress string; bad string ${ data }` ),
+                chalk.redBright( `<error>` ), chalk.gray( `${ err.message }` ),
+                chalk.redBright( `<strCompress>` ), chalk.gray( `${ data }` ) );
+
+            return null;
+        }
+    }
+
+    /*
+        Translate
+
+        compresses or decompresses encoded strings for the functions:
+            - compress
+            - uncompress
+    */
+
+    translate( str, fromChars, toChars )
+    {
+        let res = '';
+        for ( let i = 0;i < str.length;i++ )
+        {
+            const char = str[i];
+            const index = fromChars.indexOf( char );
+            if ( index !== -1 )
+                res += toChars[index];
+            else
+            res += char;
+        }
+
+        return res;
+    }
+
+    /*
+        Encode: String > Hex > Base64
+
+        encodes a human-readable string into a hex value, and then to base64
+
+        @usage                  const clib = new CLib()
+                                const encoded = clib.encodeToHexBase64('hello');                // Njg2NTZjNmM2Zg==
+                                const decoded = clib.decodeFromHexBase64(`${ encoded }`);       // hello
+    */
+
+    encodeToHexBase64( str )
+    {
+        const hex = [...str].map( ( char ) =>
+        {
+            const code = char.charCodeAt( 0 ).toString( 16 );
+            return code.padStart( 2, '0' );
+        }).join( '' );
+
+        const base64 = btoa( hex );
+        return base64;
+    }
+
+    /*
+        Decode: Base64 > Hex > String
+
+        decodes a base64 value to hex, and then back into a human readable string
+
+        @usage                  const clib = new CLib()
+                                const encoded = clib.encodeToHexBase64('hello');                // Njg2NTZjNmM2Zg==
+                                const decoded = clib.decodeFromHexBase64(`${ encoded }`);       // hello
+    */
+
+    decodeFromHexBase64( base64Str )
+    {
+        const hex = atob( base64Str );
+        const chars = hex.match( /.{1,2}/g ); // every 2 hex chars = 1 byte
+
+        return chars.map( ( byte ) => String.fromCharCode( parseInt( byte, 16 ) ) ).join( '' );
+    }
+}
+
+/*
+    export class
+
+    @usage          import CLib from './classes/CLib.js';
+*/
+
+// eslint-disable-next-line no-restricted-syntax
+export default CLib;

tvapp2/classes/Log.js

@@ -0,0 +1,121 @@
+/*
+    Define > Logs
+
+    When assigning text colors, terminals and the windows command prompt can display any color; however apps
+    such as Portainer console cannot. If you use 16 million colors and are viewing console in Portainer, colors will
+    not be the same as the rgb value. It's best to just stick to Chalk's default colors.
+
+    Various levels of logs with the following usage:
+        Log.verbose(`This is verbose`)
+        Log.debug(`This is debug`)
+        Log.info(`This is info`)
+        Log.ok(`This is ok`)
+        Log.notice(`This is notice`)
+        Log.warn(`This is warn`)
+        Log.error(
+            `Error fetching sports data with error:`,
+            chalk.white(`→`),
+            chalk.grey(`This is the error message`)
+        );
+
+        Level               Type
+    -----------------------------------
+        6                   Trace
+        5                   Debug
+        4                   Info
+        3                   Notice
+        2                   Warn
+        1                   Error
+*/
+
+import fs from 'fs';
+import chalk from 'chalk';
+
+/*
+    chalk.level
+
+    @ref        https://npmjs.com/package/chalk
+                - 0    All colors disabled
+                - 1    Basic color support (16 colors)
+                - 2    256 color support
+                - 3    Truecolor support (16 million colors)
+
+    When assigning text colors, terminals and the windows command prompt can display any color; however apps
+    such as Portainer console cannot. If you use 16 million colors and are viewing console in Portainer, colors will
+    not be the same as the rgb value. It's best to just stick to Chalk's default colors.
+*/
+
+chalk.level = 3;
+
+/*
+    Define
+*/
+
+const LOG_LEVEL = process.env.LOG_LEVEL || 4;
+const { name } = JSON.parse( fs.readFileSync( './package.json' ) );
+
+/*
+    Class > Log
+*/
+
+class Log
+{
+    static now()
+    {
+        const now = new Date();
+        return chalk.gray( `[${ now.toLocaleTimeString() }]` );
+    }
+
+    static verbose( ...msg )
+    {
+        if ( LOG_LEVEL >= 6 )
+            console.debug( chalk.white.bgBlack.blackBright.bold( ` ${ name } ` ), chalk.white( `⚙️` ), this.now(), chalk.gray( msg.join( ' ' ) ) );
+    }
+
+    static debug( ...msg )
+    {
+        if ( LOG_LEVEL >= 7 )
+            console.trace( chalk.white.bgMagenta.bold( ` ${ name } ` ), chalk.white( `⚙️` ), this.now(), chalk.magentaBright( msg.join( ' ' ) ) );
+        else if ( LOG_LEVEL >= 5 )
+            console.debug( chalk.white.bgGray.bold( ` ${ name } ` ), chalk.white( `⚙️` ), this.now(), chalk.gray( msg.join( ' ' ) ) );
+    }
+
+    static info( ...msg )
+    {
+        if ( LOG_LEVEL >= 4 )
+            console.info( chalk.white.bgBlueBright.bold( ` ${ name } ` ), chalk.white( `ℹ️` ), this.now(), chalk.blueBright( msg.join( ' ' ) ) );
+    }
+
+    static ok( ...msg )
+    {
+        if ( LOG_LEVEL >= 4 )
+            console.log( chalk.white.bgGreen.bold( ` ${ name } ` ), chalk.white( `✅` ), this.now(), chalk.greenBright( msg.join( ' ' ) ) );
+    }
+
+    static notice( ...msg )
+    {
+        if ( LOG_LEVEL >= 3 )
+            console.log( chalk.white.bgYellow.bold( ` ${ name } ` ), chalk.white( `📌` ), this.now(), chalk.yellowBright( msg.join( ' ' ) ) );
+    }
+
+    static warn( ...msg )
+    {
+        if ( LOG_LEVEL >= 2 )
+            console.warn( chalk.white.bgYellow.bold( ` ${ name } ` ), chalk.white( `⚠️` ), this.now(), chalk.yellowBright( msg.join( ' ' ) ) );
+    }
+
+    static error( ...msg )
+    {
+        if ( LOG_LEVEL >= 1 )
+            console.error( chalk.white.bgRedBright.bold( ` ${ name } ` ), chalk.white( `❌` ), this.now(), chalk.redBright( msg.join( ' ' ) ) );
+    }
+}
+
+/*
+    export class
+
+    @usage          import Log from './classes/Log.js';
+*/
+
+// eslint-disable-next-line no-restricted-syntax
+export default Log;

tvapp2/classes/Semaphore.js

@@ -0,0 +1,47 @@
+/*
+    Semaphore > Declare
+
+    allows multiple threads to work with the same shared resources
+*/
+
+class Semaphore
+{
+    constructor( max )
+    {
+        this.max = max;
+        this.queue = [];
+        this.active = 0;
+    }
+
+    async acquire()
+    {
+        if ( this.active < this.max )
+        {
+            this.active++;
+            return;
+        }
+
+        return new Promise( ( resolve ) => this.queue.push( resolve ) );
+    }
+
+    release()
+    {
+        this.active--;
+        if ( this.queue.length > 0 )
+        {
+            const resolve = this.queue.shift();
+            this.active++;
+            resolve();
+        }
+    }
+}
+
+/*
+    export class
+
+    @usage          import Log from './classes/Log.js';
+*/
+
+// eslint-disable-next-line no-restricted-syntax
+export default Semaphore;
+

tvapp2/classes/Storage.js

@@ -0,0 +1,520 @@
+/*
+    Class › Storage
+
+    The storage classes allows you to save specific settings into a json file. These settings are better off being stored in
+    a local file, instead of using up the resources being saved in a database.
+
+    Class supports multiple storage files, but by default, it will save settings in `www/config.json`.
+
+    Settings include Tuner / HDHomeRun device information, etc.
+
+    @usage
+        const storage = new Storage( envWebFolder, FILE_CFG );
+*/
+
+import chalk from 'chalk';
+import path from 'path';
+import nconf from 'nconf';
+import fs from 'fs';
+import Log from './Log.js';
+import Utils from './Utils.js';
+import { fileURLToPath } from 'url';
+
+/*
+    CJS › ESM
+*/
+
+const __filename = fileURLToPath( import.meta.url );    // get resolved path to file
+const __dirname = path.dirname( __filename );           // get name of directory
+
+/*
+    Class › Storage
+
+    constructor     ( str:folder, str:file )
+    Initialize      ( bool:bForceNew )
+    Setup           ( bool:bForceNew )
+    Get             ( str:key )
+    Set             ( str:key, any:value )
+    Save            ( )
+    GetConfig       ( )
+    isJsonString    ( json:str )
+    isJsonEmpty     ( obj:json )
+*/
+
+class Storage
+{
+    /*
+        Constructor › Storage
+
+        Initializes a Storage instance for managing the config.json file.
+        Determines the full path to the config file based on folder and file arguments,
+        or uses the default static fileConfig if none are provided.
+
+        Handles Node.js packaged apps (process.pkg) by adjusting paths accordingly.
+
+        @args
+            folder  (str)   Optional folder where config.json will be stored. Defaults to 'www'.
+            file    (str)   Optional config file name. Defaults to static Storage.fileConfig.
+
+        @usage
+            const storage = new Storage(envWebFolder, FILE_CFG);
+    */
+
+    static fileConfig = path.resolve( process.cwd( ), 'www', 'config.json' );
+
+    constructor( folder, file )
+    {
+        this.folderWeb = folder || 'www';
+        this.fileConfig = file ? path.resolve( folder, file ) : Storage.fileConfig;
+
+        if ( process.pkg )
+            this.fileConfig = path.join( path.dirname( process.execPath ), this.folderWeb, this.fileConfig );
+        else
+            this.fileConfig = path.resolve( process.cwd( ), this.folderWeb, this.fileConfig );
+    }
+
+    /*
+        Initialize › Activate Config Setup with Logging
+
+        Activates the Storage.Setup( ) function while providing detailed logging.
+        Ensures the user's config.json file exists, is valid, and is initialized
+        with default values if missing or corrupt.
+
+        Steps:
+            - Logs the start of initialization.
+            - Calls Setup( ) with optional force flag to recreate config.
+            - Catches and logs any errors during setup.
+
+        @args
+            bForceNew  (bool)   Optional. If true, forces the config file to be removed
+                                and regenerated from defaults.
+
+        @returns
+            (Promise)  Resolves when initialization completes, or logs an error if setup fails.
+
+        @usage
+            const storage = new Storage(envWebFolder, FILE_CFG);
+            await storage.Initialize(false);
+    */
+
+    async Initialize( bForceNew )
+    {
+        Log.verbose( `func`, chalk.yellow( `[executed]` ), chalk.white( `📣` ), chalk.blueBright( `<name>` ), chalk.gray( `${ Utils.getFuncName( ) }` ) );
+
+        const bForce = bForceNew || false;
+
+        try
+        {
+            Log.info( `conf`, chalk.yellow( `[initiate]` ), chalk.white( `ℹ️` ),
+                chalk.blueBright( `<msg>` ), chalk.gray( `Initializing config file` ),
+                chalk.blueBright( `<file>` ), chalk.gray( `${ this.fileConfig }` ) );
+
+            await new Storage( ).Setup( bForce );
+        }
+        catch ( err )
+        {
+            console.log( 'Error writing Metadata.json:' + err.message );
+        }
+    }
+
+    /*
+        Initialize › Setup User Config File
+
+        Sets up a user's config.json file, ensuring it exists and is valid JSON.
+        If the file is missing, empty, or invalid, it will be created or replaced.
+        Typically, you should call this via Storage( ).Initialize( ) rather than Setup( ) directly.
+
+        Steps:
+            - Creates parent directory if it doesn't exist.
+            - Removes existing config if bForceNew is true.
+            - Validates existing JSON; backs up invalid files.
+            - Creates default config if missing.
+            - Wires up nconf with argv, env, file, and default values.
+
+        @args
+            bForceNew  (bool)   Optional flag to force recreate the config file, wiping all existing data.
+
+        @returns
+            (Promise)  Resolves true when initialization completes successfully.
+
+        @usage
+            const storage = new Storage(envWebFolder, FILE_CFG);
+            await storage.Initialize(false);
+    */
+
+    async Setup( bForceNew )
+    {
+        Log.verbose( `func`, chalk.yellow( `[executed]` ), chalk.white( `📣` ), chalk.blueBright( `<name>` ), chalk.gray( `${ Utils.getFuncName( ) }` ) );
+
+        return new Promise( ( resolve, reject ) =>
+        {
+            try
+            {
+                Log.info( `conf`, chalk.yellow( `[generate]` ), chalk.white( `ℹ️` ),
+                    chalk.blueBright( `<msg>` ), chalk.gray( `Initializing storage setup` ),
+                    chalk.blueBright( `<force>` ), chalk.gray( `${ bForceNew }` ),
+                    chalk.blueBright( `<file>` ), chalk.gray( `${ this.fileConfig }` ) );
+
+                /*
+                    ensure parent directory exists
+                */
+                const dirPath = path.dirname( this.fileConfig );
+
+                if ( !fs.existsSync( dirPath ) )
+                {
+                    fs.mkdirSync( dirPath, { recursive: true });
+                }
+
+                /*
+                    if force flag is true, remove existing config file (force)
+                */
+
+                if ( bForceNew === true && fs.existsSync( this.fileConfig ) )
+                {
+                    Log.ok( `conf`, chalk.yellow( `[generate]` ), chalk.white( `✅` ),
+                        chalk.greenBright( `<msg>` ), chalk.gray( `Remove original config; force new` ),
+                        chalk.greenBright( `<file>` ), chalk.gray( `${ this.fileConfig }` ) );
+
+                    try
+                    {
+                        fs.unlinkSync( this.fileConfig );
+                    }
+                    catch ( e )
+                    {
+                        Log.error( `conf`, chalk.redBright( `[generate]` ), chalk.white( `❌` ),
+                            chalk.redBright( `<msg>` ), chalk.gray( `Failed to unlink existing config` ),
+                            chalk.redBright( `<error>` ), chalk.gray( `${ e.message }` ),
+                            chalk.redBright( `<file>` ), chalk.gray( `${ this.fileConfig }` ) );
+                    }
+                }
+
+                /*
+                    if config exists, validate JSON; if invalid, move to backup and recreate
+                */
+
+                if ( fs.existsSync( this.fileConfig ) )
+                {
+                    let raw = null;
+                    let parsed = null;
+
+                    try
+                    {
+                        raw = fs.readFileSync( this.fileConfig, { encoding: 'utf8' });
+
+                        if ( typeof raw !== 'string' || raw.trim( ).length === 0 )
+                        {
+                            throw new Error( 'Empty config file' );
+                        }
+
+                        parsed = JSON.parse( raw );
+                    }
+                    catch ( e )
+                    {
+                        const backupPath = `${ this.fileConfig }.corrupt.${ Date.now( ) }`;
+
+                        try
+                        {
+                            fs.renameSync( this.fileConfig, backupPath );
+                            Log.error( `conf`, chalk.redBright( `[generate]` ), chalk.white( `❌` ),
+                                chalk.redBright( `<msg>` ), chalk.gray( `Config file invalid; moved to backup` ),
+                                chalk.redBright( `<backup>` ), chalk.gray( `${ backupPath }` ),
+                                chalk.redBright( `<file>` ), chalk.gray( `${ this.fileConfig }` ) );
+                        }
+                        catch ( renameErr )
+                        {
+                            Log.error( `conf`, chalk.redBright( `[generate]` ), chalk.white( `❌` ),
+                                chalk.redBright( `<msg>` ), chalk.gray( `Unable to backup invalid config file` ),
+                                chalk.redBright( `<error>` ), chalk.gray( `${ renameErr.message }` ),
+                                chalk.redBright( `<file>` ), chalk.gray( `${ this.fileConfig }` ) );
+                            if ( this.rejected )
+                            {
+                                reject( renameErr );
+                                return;
+                            }
+                        }
+                    }
+                }
+
+                /*
+                    if config does not exist (or was just moved because it was corrupt), create it atomically
+                */
+
+                if ( !fs.existsSync( this.fileConfig ) )
+                {
+                    const defaults =
+                    {
+                        deviceId: 'FFFFFFFF'
+                    };
+
+                    const tempPath = `${ this.fileConfig }.tmp`;
+
+                    try
+                    {
+                        fs.writeFileSync( tempPath, JSON.stringify( defaults, null, 4 ), { encoding: 'utf8' });
+                        fs.renameSync( tempPath, this.fileConfig );
+
+                        Log.ok( `conf`, chalk.yellow( `[generate]` ), chalk.white( `✅` ),
+                            chalk.greenBright( `<msg>` ), chalk.gray( `Created new config file with defaults` ),
+                            chalk.greenBright( `<file>` ), chalk.gray( `${ this.fileConfig }` ) );
+                    }
+                    catch ( writeErr )
+                    {
+                        Log.error( `conf`, chalk.redBright( `[generate]` ), chalk.white( `❌` ),
+                            chalk.redBright( `<msg>` ), chalk.gray( `Failed to create config file` ),
+                            chalk.redBright( `<error>` ), chalk.gray( `${ writeErr.message }` ),
+                            chalk.redBright( `<file>` ), chalk.gray( `${ this.fileConfig }` ) );
+
+                        if ( this.rejected )
+                        {
+                            reject( writeErr );
+                            return;
+                        }
+                    }
+                }
+
+                /*
+                    now that file exists and is valid JSON, wire up nconf
+                */
+
+                nconf.argv( ).env({ parseValues: true }).file({ file: this.fileConfig }).defaults(
+                {
+                    deviceId: 'FFFFFFFF'
+                });
+            }
+            catch ( err )
+            {
+                Log.error( `conf`, chalk.redBright( `[generate]` ), chalk.white( `❌` ),
+                    chalk.redBright( `<msg>` ), chalk.gray( `Could not generate and write to new config file` ),
+                    chalk.redBright( `<error>` ), chalk.gray( `${ err.message }` ),
+                    chalk.redBright( `<file>` ), chalk.gray( `${ this.fileConfig }` ) );
+
+                if ( this.rejected )
+                {
+                    reject( err );
+                    return;
+                }
+            }
+
+            resolve( true );
+        });
+    }
+
+    /*
+        Get › Retrieve Configuration Value
+
+        Fetches a stored value from the application's persistent configuration
+        using the provided key via the nconf module.
+
+        This function is static, so it can be called without creating a Storage instance.
+
+        @args
+            key (str)            The configuration key to retrieve.
+
+        @returns
+            (any)                The value associated with the key, or undefined if the key does not exist.
+
+        @usage
+            const deviceId = Storage.Get('deviceId');
+    */
+
+    static Get( key )
+    {
+        Log.verbose( `func`, chalk.yellow( `[executed]` ), chalk.white( `📣` ), chalk.blueBright( `<name>` ), chalk.gray( `${ Utils.getFuncName( ) }` ) );
+
+        return nconf.get( key );
+    }
+
+    /*
+        Set › Store Configuration Value
+
+        Stores a value in the application's persistent configuration using
+        the provided key via the nconf module. Automatically saves the
+        updated configuration to disk by calling Storage.Save( ).
+
+        This function is static, so it can be called without creating a Storage instance.
+
+        @args
+            key   (str)         The configuration key to set.
+            value (any)         The value to store under the specified key.
+
+        @returns
+            (void)              No return value.
+
+        @usage
+            Storage.Set('deviceId', '105B35EF');
+    */
+
+    static Set( key, value )
+    {
+        Log.verbose( `func`, chalk.yellow( `[executed]` ), chalk.white( `📣` ),
+            chalk.blueBright( `<name>` ), chalk.gray( `${ Utils.getFuncName( ) }` ) );
+    
+        nconf.set( key, value );
+        Storage.Save( );
+    }
+
+    /*
+        Save › Persist Configuration to Disk
+
+        Saves the current configuration stored in nconf to disk.
+        After saving, the method reads back the file to verify it is valid JSON 
+        and logs detailed status messages about success or errors.
+
+        @purpose
+            - Calls nconf.save() to write the current configuration.
+            - Reads back the saved file.
+            - Parses the file as JSON to confirm validity.
+            - Logs success or detailed error messages for failures.
+
+        @args
+            none
+
+        @returns
+            (void)              Logs success or error; does not return a value.
+
+        @usage
+            Storage.Save();
+    */
+
+    static Save( )
+    {
+        const filePath = this.fileConfig;
+    
+        Log.verbose( `func`, chalk.yellow( `[executed]` ), chalk.white( `📣` ),
+            chalk.blueBright( `<name>` ), chalk.gray( `${ Utils.getFuncName( ) }` ) );
+    
+        nconf.save( ( err ) =>
+        {
+            if ( err )
+            {
+                Log.error( `conf`, chalk.redBright( `[snapshot]` ), chalk.white( `❌` ),
+                    chalk.redBright( `<msg>` ), chalk.gray( `Could not save config` ),
+                    chalk.redBright( `<error>` ), chalk.gray( `${ err }` ),
+                    chalk.redBright( `<file>` ), chalk.gray( `${ filePath }` ) );
+                return;
+            }
+    
+            fs.readFile( filePath, ( err, data ) =>
+            {
+                if ( err )
+                {
+                    Log.error( `conf`, chalk.redBright( `[snapshot]` ), chalk.white( `❌` ),
+                        chalk.redBright( `<msg>` ), chalk.gray( `Unable to read config file` ),
+                        chalk.redBright( `<error>` ), chalk.gray( `${ err }` ),
+                        chalk.redBright( `<file>` ), chalk.gray( `${ filePath }` ) );
+                    return;
+                }
+    
+                try
+                {
+                    const parsed = JSON.parse( data.toString( ) );
+    
+                    Log.ok( `conf`, chalk.yellow( `[snapshot]` ), chalk.white( `✅` ),
+                        chalk.greenBright( `<msg>` ), chalk.gray( `Save to config file successful` ),
+                        chalk.greenBright( `<file>` ), chalk.gray( `${ filePath }` ) );
+    
+                    Log.debug( `conf`, chalk.yellow( `[snapshot]` ), chalk.white( `⚙️` ),
+                        chalk.blueBright( `<msg>` ), chalk.gray( `Read values from saved config file` ),
+                        chalk.blueBright( `<file>` ), chalk.gray( `${ filePath }` ),
+                        chalk.blueBright( `<values>` ), chalk.gray( `${ JSON.stringify( parsed ) }` ) );
+                }
+                catch ( parseErr )
+                {
+                    Log.error( `conf`, chalk.redBright( `[snapshot]` ), chalk.white( `❌` ),
+                        chalk.redBright( `<msg>` ), chalk.gray( `Config file is not valid JSON` ),
+                        chalk.redBright( `<error>` ), chalk.gray( `${ parseErr.message }` ),
+                        chalk.redBright( `<file>` ), chalk.gray( `${ filePath }` ) );
+                }
+            });
+        });
+    }
+
+    /*
+        GetConfig › Return Full Path to Config File
+
+        Returns the full path to the currently used config.json file for this Storage instance.
+        This is useful when you need to know the exact file location without reading its contents.
+
+        @args
+            none
+
+        @returns
+            (str)               Absolute path to the config.json file.
+
+        @usage
+            const storage_config = Storage.GetConfig();
+    */
+
+    static GetConfig( )
+    {
+        Log.verbose( `func`, chalk.yellow( `[executed]` ), chalk.white( `📣` ), chalk.blueBright( `<name>` ), chalk.gray( `${ Utils.getFuncName( ) }` ) );
+
+        return this.fileConfig;
+    }
+
+    /*
+        isJsonString › Check if Input is Valid JSON
+
+        Determines whether a given string is valid JSON by attempting
+        to parse it. Returns true if parsing succeeds, false if it throws
+        an error.
+
+        @args
+            json (str)          The string to test for valid JSON.
+
+        @returns
+            (bool)              True if input is valid JSON, false otherwise.
+
+        @usage
+            const valid = Storage.isJsonString('{"key":"value"}');  // returns true
+    */
+
+    static isJsonString( json )
+    {
+        Log.verbose( `func`, chalk.yellow( `[executed]` ), chalk.white( `📣` ), chalk.blueBright( `<name>` ), chalk.gray( `${ Utils.getFuncName( ) }` ) );
+
+        try
+        {
+            JSON.parse( json );
+        }
+        catch ( e )
+        {
+            return false;
+        }
+
+        return true;
+    }
+
+    /*
+        helper › json object empty
+    */
+
+    static isJsonEmpty( json )
+    {
+        Log.verbose( `func`, chalk.yellow( `[executed]` ), chalk.white( `📣` ), chalk.blueBright( `<name>` ), chalk.gray( `${ Utils.getFuncName( ) }` ) );
+
+        if ( Object.keys( json ).length === 0 )
+            return true;
+
+        if ( JSON.stringify( json ) === '\"{}\"' )
+            return true;
+
+        for ( const key in json )
+        {
+            if ( ! Object.prototype.hasOwnProperty.call( json, key ) )
+                return true;
+        }
+
+        return false;
+    }
+}
+
+/*
+    export class
+
+    @import
+        import Storage from './classes/Storage.js';
+*/
+
+// eslint-disable-next-line no-restricted-syntax
+export default Storage;

tvapp2/classes/Tuner.js

@@ -0,0 +1,455 @@
+/*
+    Class › Tuner
+
+    Handles HDHomeRun device management and deviceId lifecycle.
+
+    @purpose
+        - Generate / format HDHomeRun device IDs.
+        - Validate device IDs against HDHomeRun rules (length, hex chars, checksum).
+        - Persist device IDs using Storage class.
+        - Automatically generate new device ID if missing, invalid, or uninitialized (FFFFFFFF).
+        - Initialize tuner instances with validated device IDs.
+
+    @usage
+        await new Tuner( Storage.Get( 'deviceId' ) ).Initialize( );
+        const tuner = new Tuner( );
+        await tuner.Initialize( );
+        const validId = await tuner.VerifyDeviceId( );
+
+    @notes
+        - Device IDs are persisted via the Storage class (config.json).
+        - User's device id must be valid before HDHomeRun will initialize.
+*/
+
+
+import chalk from 'chalk';
+import Storage from './Storage.js';
+import Utils from './Utils.js';
+import Log from './Log.js';
+
+/*
+    Class › Tuner
+
+    constructor         ( str:deviceId )
+    Initialize          ( )
+    Start               ( )
+    _GenerateDeviceId   ( int:len )
+    GenerateDeviceId    ( )
+    GetDeviceId         ( )
+    FormatDeviceId      ( str:deviceid )
+    IsDeviceIdValid     ( )
+    VerifyDeviceId      ( )
+*/
+
+class Tuner
+{
+    constructor( deviceId )
+    {
+        Log.verbose( `func`, chalk.yellow( `[executed]` ), chalk.white( `📣` ), chalk.blueBright( `<name>` ), chalk.gray( `${ Utils.getConstructorName( ) }` ) );
+
+        this.Name = `HDHomeRun`;
+        this.FriendlyName = `TVApp2`;
+        this.ModelNumber = `HDHR5-4US`;
+        this.FirmwareName = `hdhomerun5_atsc`;
+        this.FirmwareVersion = `0.9.15.00-RC04`;
+        this.SlotsConnected = 0;
+        this.SlotsMax = 10;
+        this.DeviceId = deviceId || Storage.Get( 'deviceId' );
+    }
+
+    /*
+        Initialize › Setup and Start Tuner
+
+        Initializes the tuner by calling the Start( ) method.
+        Catches and logs any errors encountered during startup.
+
+        @args
+            none
+
+        @returns
+            (void)              Logs status; does not return a value.
+
+        @usage
+            await tuner.Initialize( );
+    */
+
+    async Initialize( )
+    {
+        Log.verbose( `func`, chalk.yellow( `[executed]` ), chalk.white( `📣` ), chalk.blueBright( `<name>` ), chalk.gray( `${ Utils.getFuncName( ) }` ) );
+
+        try
+        {
+            await this.Start( );
+        }
+        catch ( err )
+        {
+            Log.error( `hdhr`, chalk.redBright( `[initiate]` ), chalk.white( `❌` ),
+                chalk.redBright( `<msg>` ), chalk.gray( `Failure initializing tuner` ),
+                chalk.redBright( `<error>` ), chalk.gray( `${ err.message }` ) );
+        }
+    }
+
+    /*
+        Start › Initialize and Verify Device ID
+
+        Starts the tuner by verifying the current deviceId.
+        If the deviceId is missing or invalid, it will be regenerated and validated.
+        Logs the status of the deviceId once verification completes.
+
+        @args
+            none
+
+        @returns
+            (bool)              true if deviceId is valid after verification, false otherwise.
+
+        @usage
+            await tuner.Start( );
+    */
+
+    async Start( )
+    {
+        Log.verbose( `func`, chalk.yellow( `[executed]` ), chalk.white( `📣` ), chalk.blueBright( `<name>` ), chalk.gray( `${ Utils.getFuncName( ) }` ) );
+
+        const verifiedId = await new Tuner( ).VerifyDeviceId( this.DeviceId );
+
+        if ( await this.IsDeviceIdValid( verifiedId ) )
+        {
+            Log.ok( `conf`, chalk.yellow( `[validate]` ), chalk.white( `✅` ),
+                chalk.greenBright( `<msg>` ), chalk.gray( `User has valid deviceId` ),
+                chalk.greenBright( `<deviceId>` ), chalk.gray( `${ verifiedId }` ) );
+        }
+    }
+
+    /*
+        _GenerateDeviceId › Generate Raw Random Hexadecimal String
+
+        Generates a raw random hexadecimal string using Node.js crypto module.
+        This is typically used as the random portion of a deviceId.
+
+        @args
+            len (int)           Optional number of bytes to generate. Defaults to 4 bytes.
+
+        @returns
+            (str)               Uppercase hexadecimal string, length = len * 2 characters.
+
+        @usage
+            const randomHex = Tuner._GenerateDeviceId( 4 );  // 8-character hex string
+    */
+
+    static _GenerateDeviceId( len )
+    {
+        Log.verbose( `func`, chalk.yellow( `[executed]` ), chalk.white( `📣` ), chalk.blueBright( `<name>` ), chalk.gray( `${ Utils.getFuncName( ) }` ) );
+
+        return crypto.randomBytes( len || 4 ).toString( 'hex' ).toUpperCase( );
+    }
+
+    /*
+        GenerateDeviceId › Generate New HDHomeRun Device ID
+
+        Generates a new, properly formatted HDHomeRun deviceId.
+
+        Steps:
+            - Generates 4 random hexadecimal characters.
+            - Prepends '105' and appends '0' to form base deviceId.
+            - Passes baseId to Tuner.FormatDeviceId( ) to ensure correct checksum and 8-character format.
+
+        @args
+            None
+
+        @returns
+            (str)               A valid, 8-character HDHomeRun deviceId in uppercase hexadecimal.
+
+        @usage
+            const newDeviceId = Tuner.GenerateDeviceId( );
+    */
+
+    static GenerateDeviceId( )
+    {
+        Log.verbose( `func`, chalk.yellow( `[executed]` ), chalk.white( `📣` ), chalk.blueBright( `<name>` ), chalk.gray( `${ Utils.getFuncName( ) }` ) );
+
+        const chars = '0123456789ABCDEF';
+        let randomHex = '';
+
+        // generate 4 random hexadecimal chars
+        for ( let i = 0;i < 4;i++ )
+        {
+            randomHex += chars[Math.floor( Math.random( ) * chars.length )];
+        }
+
+        const baseId =  '105' + randomHex + '0';
+        return this.FormatDeviceId( baseId );
+    }
+
+    /*
+        GetDeviceId › Retrieve Stored HDHomeRun Device ID
+
+        Fetches the current deviceId from persistent storage (via Storage.Get).
+
+        @args
+            None
+
+        @returns
+            (str)               The current deviceId stored in configuration.
+
+        @usage
+            const deviceId = await tuner.GetDeviceId( );
+    */
+
+    GetDeviceId( )
+    {
+        Log.verbose( `func`, chalk.yellow( `[executed]` ), chalk.white( `📣` ), chalk.blueBright( `<name>` ), chalk.gray( `${ Utils.getFuncName( ) }` ) );
+
+        return Storage.Get( 'deviceId' );
+    }
+
+    /*
+        FormatDeviceId › Validate and Format HDHomeRun Device ID
+
+        Fetches the provided deviceId (or instance default) and ensures it is valid
+        according to HDHomeRun rules, then returns a properly formatted ID.
+
+        Steps:
+            - Input must be exactly 8 hexadecimal characters.
+            - All characters must be 0-9 or A-F/a-f.
+            - Computes checksum using HDHomeRun-specific lookup table.
+            - Generates a new deviceId integer with checksum applied.
+            - Converts back to 8-character uppercase hexadecimal string.
+
+        Logs detailed errors if the input deviceId is invalid.
+
+        @args
+            deviceid (str)      Optional deviceId to format. Defaults to instance deviceId.
+
+        @returns
+            (str|int)           Formatted 8-character hex deviceId, or 0 if input invalid.
+
+        @usage
+            const formattedId = Tuner.FormatDeviceId( someDeviceId );
+    */
+
+    static FormatDeviceId( deviceid )
+    {
+        Log.verbose( `func`, chalk.yellow( `[executed]` ), chalk.white( `📣` ), chalk.blueBright( `<name>` ), chalk.gray( `${ Utils.getFuncName( ) }` ) );
+
+        const deviceId = deviceid || this.DeviceId;
+
+        /*
+            Validate input length
+        */
+
+        if ( !deviceId || deviceId.length !== 8 )
+        {
+            Log.error( `hdhr`, chalk.redBright( `[validate]` ), chalk.white( `❌` ),
+                chalk.redBright( `<msg>` ), chalk.gray( `HDHomeRun deviceId must be 8 hexadecimals` ),
+                chalk.redBright( `<deviceId>` ), chalk.gray( `${ deviceId }` ) );
+
+            return 0;
+        }
+
+        /*
+            All chars should be valid hexadecimal
+        */
+
+        const hexPattern = /^[0-9A-Fa-f]+$/;
+        if ( !hexPattern.test( deviceId ) )
+        {
+            Log.error( `hdhr`, chalk.redBright( `[validate]` ), chalk.white( `❌` ),
+                chalk.redBright( `<msg>` ), chalk.gray( `HDHomeRun deviceId must contain all hex (0-9, A-F, a-f)` ),
+                chalk.redBright( `<deviceId>` ), chalk.gray( `${ deviceId }` ) );
+
+            return 0;
+        }
+
+        /*
+            Hex string to integer
+        */
+
+        const deviceIdInt = parseInt( deviceId, 16 );
+
+        /*
+            Checksum lookup table
+        */
+
+        const checksumLookup =
+        [
+            0xA, 0x5, 0xF, 0x6, 0x7, 0xC, 0x1, 0xB, 0x9, 0x2, 0x8, 0xD, 0x4, 0x3, 0xE, 0x0
+        ];
+
+        /*
+            Calc checksum
+        */
+
+        let checksum = 0;
+        checksum ^= checksumLookup[( deviceIdInt >> 28 ) & 0x0F];
+        checksum ^= ( deviceIdInt >> 24 ) & 0x0F;
+        checksum ^= checksumLookup[( deviceIdInt >> 20 ) & 0x0F];
+        checksum ^= ( deviceIdInt >> 16 ) & 0x0F;
+        checksum ^= checksumLookup[( deviceIdInt >> 12 ) & 0x0F];
+        checksum ^= ( deviceIdInt >> 8 ) & 0x0F;
+        checksum ^= checksumLookup[( deviceIdInt >> 4 ) & 0x0F];
+
+        /*
+            Calc new device ID
+        */
+
+        const newDevId = ( deviceIdInt & 0xFFFFFFF0 ) + checksum;
+
+        /*
+            Convert back to hex string; ensure we get 8 characters with leading zeros; convert to uppercase
+        */
+
+        return newDevId.toString( 16 ).toUpperCase( ).padStart( 8, '0' );
+    }
+
+    /*
+        IsDeviceIdValid › Validate HDHomeRun Device ID
+
+        Checks if the current deviceId on this instance is valid according to HDHomeRun rules.
+
+        Validation steps:
+            - Must be exactly 8 characters long.
+            - All characters must be hexadecimal (0-9, A-F, a-f).
+            - Computes checksum using HDHomeRun-specific lookup table; must equal 0.
+
+        Logs detailed errors if the deviceId fails any validation step.
+
+        @returns
+            (bool)              true if deviceId is valid, false otherwise.
+
+        @usage
+            const isValid = await tuner.IsDeviceIdValid( );
+    */
+
+    async IsDeviceIdValid( )
+    {
+        Log.verbose( `func`, chalk.yellow( `[executed]` ), chalk.white( `📣` ), chalk.blueBright( `<name>` ), chalk.gray( `${ Utils.getFuncName( ) }` ) );
+
+        /*
+            Define Hexadecimal charset (0-9, A-F, a-f)
+        */
+
+        const hexDigits = new Set( '0123456789ABCDEFabcdef' );
+        const deviceId = this.DeviceId;
+
+        /*
+            Check if device ID is exactly 8 characters
+        */
+
+        if ( !deviceId || deviceId.length !== 8 )
+        {
+            Log.error( `hdhr`, chalk.redBright( `[validate]` ), chalk.white( `❌` ),
+                chalk.redBright( `<msg>` ), chalk.gray( `HDHomeRun deviceId must be 8 hexadecimals` ),
+                chalk.redBright( `<deviceId>` ), chalk.gray( `${ deviceId }` ) );
+
+            return false;
+        }
+
+        /*
+            Check if all characters are hexadecimal
+        */
+
+        if ( !Array.from( deviceId ).every( ( c ) => hexDigits.has( c ) ) )
+        {
+            Log.error( `hdhr`, chalk.redBright( `[validate]` ), chalk.white( `❌` ),
+                chalk.redBright( `<msg>` ), chalk.gray( `HDHomeRun deviceId must contain all hex (0-A)` ),
+                chalk.redBright( `<deviceId>` ), chalk.gray( `${ deviceId }` ) );
+
+            return false;
+        }
+
+        /*
+            Convert hex string to integer (equivalent to int.from_bytes with big endian)
+        */
+
+        const deviceIdInt = parseInt( deviceId, 16 );
+
+        /*
+            Checksum lookup table
+        */
+
+        const checksumLookup =
+        [
+            0xA, 0x5, 0xF, 0x6, 0x7, 0xC, 0x1, 0xB, 0x9, 0x2, 0x8, 0xD, 0x4, 0x3, 0xE, 0x0
+        ];
+
+        /*
+            Calc checksum
+        */
+
+        let checksum = 0;
+        checksum ^= checksumLookup[( deviceIdInt >>> 28 ) & 0x0F];
+        checksum ^= ( deviceIdInt >>> 24 ) & 0x0F;
+        checksum ^= checksumLookup[( deviceIdInt >>> 20 ) & 0x0F];
+        checksum ^= ( deviceIdInt >>> 16 ) & 0x0F;
+        checksum ^= checksumLookup[( deviceIdInt >>> 12 ) & 0x0F];
+        checksum ^= ( deviceIdInt >>> 8 ) & 0x0F;
+        checksum ^= checksumLookup[( deviceIdInt >>> 4 ) & 0x0F];
+        checksum ^= ( deviceIdInt >>> 0 ) & 0x0F;
+
+        return checksum === 0;
+    }
+
+    /*
+        VerifyDeviceId › Validate / Generate Device ID
+
+        Checks if the current deviceId on this instance is valid. 
+
+        If missing, uninitialized ('FFFFFFFF'), or fails validation:
+            a new deviceId is generated via the static Tuner.GenerateDeviceId( ) method. 
+
+        New deviceId is saved to persistent storage via Storage.Set( ) and 
+        updated on the instance.
+        
+        Function also recursively verifies until a valid deviceId is established.
+
+        @returns
+            (str)               A valid deviceId for this tuner instance.
+
+        @usage
+            const validId = await tuner.VerifyDeviceId( );
+    */
+
+    async VerifyDeviceId( )
+    {
+        Log.verbose( `func`, chalk.yellow( `[executed]` ), chalk.white( `📣` ), chalk.blueBright( `<name>` ), chalk.gray( `${ Utils.getFuncName( ) }` ) );
+    
+        const deviceId = this.DeviceId;
+    
+        if ( !deviceId || deviceId === 'FFFFFFFF' || !await this.IsDeviceIdValid( ) )
+        {
+            const deviceIdNew = Tuner.GenerateDeviceId( );   // static generates a properly formatted ID
+            if ( deviceId === 'FFFFFFFF' )
+            {
+                Log.info( `conf`, chalk.yellow( `[generate]` ), chalk.white( `📣` ),
+                    chalk.yellow( `<msg>` ), chalk.gray( `Generating HDHomeRun deviceId for the first time` ),
+                    chalk.yellow( `<deviceId>` ), chalk.gray( `${ deviceIdNew }` ) );
+            }
+            else
+            {
+                Log.error( `conf`, chalk.redBright( `[generate]` ), chalk.white( `❌` ),
+                    chalk.redBright( `<msg>` ), chalk.gray( `Invalid deviceId; generating new` ),
+                    chalk.redBright( `<oldDeviceId>` ), chalk.gray( `${ deviceId }` ),
+                    chalk.redBright( `<deviceIdNew>` ), chalk.gray( `${ deviceIdNew }` ) );
+            }
+    
+            Storage.Set( 'deviceId', deviceIdNew );        // save to JSON via nconf
+            this.DeviceId = deviceIdNew;                   // update the instance so validation works
+    
+            // verify recursively until valid
+            const verifiedId = await this.VerifyDeviceId( );
+            return verifiedId;
+        }
+    
+        return deviceId;
+    }
+}
+
+/*
+    export class
+
+    @image
+        import Tuner from './classes/Tuner.js';
+*/
+
+// eslint-disable-next-line no-restricted-syntax
+export default Tuner;

tvapp2/classes/Utils.js

@@ -0,0 +1,47 @@
+class Utils
+{
+    /*
+        Returns the name of the function that this function was called from.
+        used for Log.verbose
+    */
+
+    static getFuncName()
+    {
+        return ( new Error() ).stack.match( /at (\S+)/g )[1].slice( 3 );
+    }
+
+    /*
+        Returns the name of the constructor that this function was called from.
+        used for Log.verbose
+    */
+
+    static getConstructorName()
+    {
+        return ( new Error() ).stack.match( /new\s+(\w+)/g )[0];
+    }
+
+    /*
+        helper > str2bool
+    */
+
+    static str2bool( str )
+    {
+        if ( typeof str === 'string' )
+        {
+            const lower = str.toLowerCase();
+            if ([
+                '1', 'true', 'yes', 'y', 't'
+                ].includes( lower ) )
+                str = true;
+            if ([
+                '0', 'false', 'no', 'n', 'f'
+                ].includes( lower ) )
+                str = false;
+            return str;
+        }
+        else return Boolean( str );
+    }
+}
+
+// eslint-disable-next-line no-restricted-syntax
+export default Utils;

tvapp2/eslint.config.mjs

@@ -23,7 +23,7 @@ import { FlatCompat } from '@eslint/eslintrc';
 import pluginImport from 'eslint-plugin-import';
 import pluginNode from 'eslint-plugin-n'
 import pluginChaiFriendly from 'eslint-plugin-chai-friendly';
-import pluginStylisticJs from '@stylistic/eslint-plugin-js'
+import pluginStylistic from '@stylistic/eslint-plugin'
 
 /*
     Globals
@@ -75,7 +75,7 @@ export default
         plugins: {
             'n': pluginNode,
             'import': pluginImport,
-            '@stylistic/js': pluginStylisticJs,
+            '@stylistic': pluginStylistic,
             'chai-friendly': pluginChaiFriendly
         },
         linterOptions: {
@@ -145,7 +145,7 @@ export default
             'import/no-webpack-loader-syntax': 'off',
             'import/no-relative-parent-imports': 'error',
             'import/first': 'error',
-            'import/no-default-export': 'error',
+            'import/no-default-export': 'off',
             'node/no-callback-literal': 0,
 
             /*
@@ -191,68 +191,68 @@ export default
             'n/prefer-promises/dns': 'off',
             'n/prefer-promises/fs': 'off',
             'n/process-exit-as-throw': 'error',
-            '@stylistic/js/object-property-newline': 'off',
+            '@stylistic/object-property-newline': 'off',
-            '@stylistic/js/no-multi-spaces': [ 0, { ignoreEOLComments: true } ],
+            '@stylistic/no-multi-spaces': [ 0, { ignoreEOLComments: true } ],
-            '@stylistic/js/arrow-spacing': [ 'error', { before: true, after: true } ],
+            '@stylistic/arrow-spacing': [ 'error', { before: true, after: true } ],
-            '@stylistic/js/semi-spacing': ['error', {
+            '@stylistic/semi-spacing': ['error', {
                 before: false,
                 after: false,
             }],
-            "@stylistic/js/space-before-function-paren": ["error", {
+            "@stylistic/space-before-function-paren": ["error", {
                 anonymous: "always",
                 asyncArrow: "never",
                 named: "never"
             }],
-            '@stylistic/js/padded-blocks': ['error', {
+            '@stylistic/padded-blocks': ['error', {
                 blocks: 'never',
                 switches: 'never',
                 classes: 'never',
             }],
-            '@stylistic/js/arrow-parens': [ 'error', 'always' ],
+            '@stylistic/arrow-parens': [ 'error', 'always' ],
-            '@stylistic/js/block-spacing': [ 'error', 'always' ],
+            '@stylistic/block-spacing': [ 'error', 'always' ],
-            '@stylistic/js/comma-dangle': [ 'error', 'never' ],
+            '@stylistic/comma-dangle': [ 'error', 'never' ],
-            '@stylistic/js/comma-spacing': [ 'error', { before: false, after: true }],
+            '@stylistic/comma-spacing': [ 'error', { before: false, after: true }],
-            '@stylistic/js/computed-property-spacing': ['error', 'never'],
+            '@stylistic/computed-property-spacing': ['error', 'never'],
-            '@stylistic/js/no-mixed-operators': ['off'],
+            '@stylistic/no-mixed-operators': ['off'],
-            '@stylistic/js/eol-last': ['error', 'always'],
+            '@stylistic/eol-last': ['error', 'always'],
-            '@stylistic/js/jsx-quotes': ['error', 'prefer-single'],
+            '@stylistic/jsx-quotes': ['error', 'prefer-single'],
-            '@stylistic/js/linebreak-style': ['error', 'unix'],
+            '@stylistic/linebreak-style': ['error', 'unix'],
-            '@stylistic/js/no-mixed-spaces-and-tabs': ['error'],
+            '@stylistic/no-mixed-spaces-and-tabs': ['error'],
-            '@stylistic/js/no-tabs': ['error'],
+            '@stylistic/no-tabs': ['error'],
-            '@stylistic/js/no-trailing-spaces': ['error', { skipBlankLines: true, ignoreComments: true }],
+            '@stylistic/no-trailing-spaces': ['error', { skipBlankLines: true, ignoreComments: true }],
-            '@stylistic/js/no-whitespace-before-property': ['error'],
+            '@stylistic/no-whitespace-before-property': ['error'],
-            '@stylistic/js/object-curly-spacing': ['error', 'always'],
+            '@stylistic/object-curly-spacing': ['error', 'always'],
-            '@stylistic/js/quote-props': ['error', 'as-needed'],
+            '@stylistic/quote-props': ['error', 'as-needed'],
-            '@stylistic/js/quotes': ['error', 'single', { allowTemplateLiterals: true }],
+            '@stylistic/quotes': ['error', 'single', { allowTemplateLiterals: 'always' }],
-            '@stylistic/js/semi': ['error', 'always'],
+            '@stylistic/semi': ['error', 'always'],
-            '@stylistic/js/space-infix-ops': ['error'],
+            '@stylistic/space-infix-ops': ['error'],
-            '@stylistic/js/template-curly-spacing': ['error', 'always'],
+            '@stylistic/template-curly-spacing': ['error', 'always'],
-            '@stylistic/js/template-tag-spacing': ['error', 'always'],
+            '@stylistic/template-tag-spacing': ['error', 'always'],
-            '@stylistic/js/space-in-parens': [ 'error', 'always',
+            '@stylistic/space-in-parens': [ 'error', 'always',
             {
                 exceptions: ["{}", "[]"]
             }],
-            '@stylistic/js/spaced-comment': [ 'error', 'always',
+            '@stylistic/spaced-comment': [ 'error', 'always',
             {
                 markers: ['/']
             }],
-            '@stylistic/js/array-bracket-newline': [ 'warn',
+            '@stylistic/array-bracket-newline': [ 'warn',
             {
                 multiline: true,
                 minItems: 5,
             }],
-            '@stylistic/js/brace-style': [ 'error', 'allman',
+            '@stylistic/brace-style': [ 'error', 'allman',
             {
                 allowSingleLine: true,
             }],
-            '@stylistic/js/array-bracket-spacing': [ 'error', 'always',
+            '@stylistic/array-bracket-spacing': [ 'error', 'always',
             {
                 arraysInArrays: false,
                 objectsInArrays: false,
                 singleValue: false,
             }],
-            '@stylistic/js/wrap-iife': [2, 'inside', { functionPrototypeMethods: true }],
+            '@stylistic/wrap-iife': [2, 'inside', { functionPrototypeMethods: true }],
-            '@stylistic/js/keyword-spacing': [ 'error',
+            '@stylistic/keyword-spacing': [ 'error',
             {
                 before: true,
                 after: true,

tvapp2/node_modules/.bin/playwright

@@ -1,16 +0,0 @@
-#!/bin/sh
-basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
-
-case `uname` in
-    *CYGWIN*|*MINGW*|*MSYS*)
-        if command -v cygpath > /dev/null 2>&1; then
-            basedir=`cygpath -w "$basedir"`
-        fi
-    ;;
-esac
-
-if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../playwright/cli.js" "$@"
-else 
-  exec node  "$basedir/../playwright/cli.js" "$@"
-fi

tvapp2/node_modules/.bin/playwright-core

@@ -1,16 +0,0 @@
-#!/bin/sh
-basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
-
-case `uname` in
-    *CYGWIN*|*MINGW*|*MSYS*)
-        if command -v cygpath > /dev/null 2>&1; then
-            basedir=`cygpath -w "$basedir"`
-        fi
-    ;;
-esac
-
-if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../playwright-core/cli.js" "$@"
-else 
-  exec node  "$basedir/../playwright-core/cli.js" "$@"
-fi

tvapp2/node_modules/.bin/playwright-core.cmd

@@ -1,17 +0,0 @@
-@ECHO off
-GOTO start
-:find_dp0
-SET dp0=%~dp0
-EXIT /b
-:start
-SETLOCAL
-CALL :find_dp0
-
-IF EXIST "%dp0%\node.exe" (
-  SET "_prog=%dp0%\node.exe"
-) ELSE (
-  SET "_prog=node"
-  SET PATHEXT=%PATHEXT:;.JS;=;%
-)
-
-endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%"  "%dp0%\..\playwright-core\cli.js" %*

tvapp2/node_modules/.bin/playwright-core.ps1

@@ -1,28 +0,0 @@
-#!/usr/bin/env pwsh
-$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
-
-$exe=""
-if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
-  # Fix case when both the Windows and Linux builds of Node
-  # are installed in the same directory
-  $exe=".exe"
-}
-$ret=0
-if (Test-Path "$basedir/node$exe") {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "$basedir/node$exe"  "$basedir/../playwright-core/cli.js" $args
-  } else {
-    & "$basedir/node$exe"  "$basedir/../playwright-core/cli.js" $args
-  }
-  $ret=$LASTEXITCODE
-} else {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "node$exe"  "$basedir/../playwright-core/cli.js" $args
-  } else {
-    & "node$exe"  "$basedir/../playwright-core/cli.js" $args
-  }
-  $ret=$LASTEXITCODE
-}
-exit $ret

tvapp2/node_modules/.bin/playwright.cmd

@@ -1,17 +0,0 @@
-@ECHO off
-GOTO start
-:find_dp0
-SET dp0=%~dp0
-EXIT /b
-:start
-SETLOCAL
-CALL :find_dp0
-
-IF EXIST "%dp0%\node.exe" (
-  SET "_prog=%dp0%\node.exe"
-) ELSE (
-  SET "_prog=node"
-  SET PATHEXT=%PATHEXT:;.JS;=;%
-)
-
-endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%"  "%dp0%\..\playwright\cli.js" %*

tvapp2/node_modules/.bin/playwright.ps1

@@ -1,28 +0,0 @@
-#!/usr/bin/env pwsh
-$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
-
-$exe=""
-if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
-  # Fix case when both the Windows and Linux builds of Node
-  # are installed in the same directory
-  $exe=".exe"
-}
-$ret=0
-if (Test-Path "$basedir/node$exe") {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "$basedir/node$exe"  "$basedir/../playwright/cli.js" $args
-  } else {
-    & "$basedir/node$exe"  "$basedir/../playwright/cli.js" $args
-  }
-  $ret=$LASTEXITCODE
-} else {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "node$exe"  "$basedir/../playwright/cli.js" $args
-  } else {
-    & "node$exe"  "$basedir/../playwright/cli.js" $args
-  }
-  $ret=$LASTEXITCODE
-}
-exit $ret

tvapp2/node_modules/lodash.clonedeep/LICENSE

@@ -1,47 +0,0 @@
-Copyright jQuery Foundation and other contributors <https://jquery.org/>
-
-Based on Underscore.js, copyright Jeremy Ashkenas,
-DocumentCloud and Investigative Reporters & Editors <http://underscorejs.org/>
-
-This software consists of voluntary contributions made by many
-individuals. For exact contribution history, see the revision history
-available at https://github.com/lodash/lodash
-
-The following license applies to all parts of this software except as
-documented below:
-
-====
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
-====
-
-Copyright and related rights for sample code are waived via CC0. Sample
-code is defined as all source code displayed within the prose of the
-documentation.
-
-CC0: http://creativecommons.org/publicdomain/zero/1.0/
-
-====
-
-Files located in the node_modules and vendor directories are externally
-maintained libraries used by this software which have their own
-licenses; we recommend you read them, as their terms may differ from the
-terms above.

tvapp2/node_modules/lodash.clonedeep/README.md

@@ -1,18 +0,0 @@
-# lodash.clonedeep v4.5.0
-
-The [lodash](https://lodash.com/) method `_.cloneDeep` exported as a [Node.js](https://nodejs.org/) module.
-
-## Installation
-
-Using npm:
-```bash
-$ {sudo -H} npm i -g npm
-$ npm i --save lodash.clonedeep
-```
-
-In Node.js:
-```js
-var cloneDeep = require('lodash.clonedeep');
-```
-
-See the [documentation](https://lodash.com/docs#cloneDeep) or [package source](https://github.com/lodash/lodash/blob/4.5.0-npm-packages/lodash.clonedeep) for more details.

tvapp2/node_modules/lodash.clonedeep/package.json

@@ -1,17 +0,0 @@
-{
-  "name": "lodash.clonedeep",
-  "version": "4.5.0",
-  "description": "The lodash method `_.cloneDeep` exported as a module.",
-  "homepage": "https://lodash.com/",
-  "icon": "https://lodash.com/icon.svg",
-  "license": "MIT",
-  "keywords": "lodash-modularized, clonedeep",
-  "author": "John-David Dalton <john.david.dalton@gmail.com> (http://allyoucanleet.com/)",
-  "contributors": [
-    "John-David Dalton <john.david.dalton@gmail.com> (http://allyoucanleet.com/)",
-    "Blaine Bublitz <blaine.bublitz@gmail.com> (https://github.com/phated)",
-    "Mathias Bynens <mathias@qiwi.be> (https://mathiasbynens.be/)"
-  ],
-  "repository": "lodash/lodash",
-  "scripts": { "test": "echo \"See https://travis-ci.org/lodash/lodash-cli for testing details.\"" }
-}

tvapp2/node_modules/playwright-core/LICENSE

@@ -1,202 +0,0 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Portions Copyright (c) Microsoft Corporation.
-   Portions Copyright 2017 Google Inc.
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.

tvapp2/node_modules/playwright-core/NOTICE

@@ -1,5 +0,0 @@
-Playwright
-Copyright (c) Microsoft Corporation
-
-This software contains code derived from the Puppeteer project (https://github.com/puppeteer/puppeteer),
-available under the Apache 2.0 license (https://github.com/puppeteer/puppeteer/blob/master/LICENSE).

tvapp2/node_modules/playwright-core/README.md

@@ -1,3 +0,0 @@
-# playwright-core
-
-This package contains the no-browser flavor of [Playwright](http://github.com/microsoft/playwright).

tvapp2/node_modules/playwright-core/bin/install_media_pack.ps1

@@ -1,5 +0,0 @@
-$osInfo = Get-WmiObject -Class Win32_OperatingSystem
-# check if running on Windows Server
-if ($osInfo.ProductType -eq 3) {
-  Install-WindowsFeature Server-Media-Foundation
-}

tvapp2/node_modules/playwright-core/bin/reinstall_chrome_beta_linux.sh

@@ -1,42 +0,0 @@
-#!/usr/bin/env bash
-set -e
-set -x
-
-if [[ $(arch) == "aarch64" ]]; then
-  echo "ERROR: not supported on Linux Arm64"
-  exit 1
-fi
-
-if [ -z "$PLAYWRIGHT_HOST_PLATFORM_OVERRIDE" ]; then
-  if [[ ! -f "/etc/os-release" ]]; then
-    echo "ERROR: cannot install on unknown linux distribution (/etc/os-release is missing)"
-    exit 1
-  fi
-
-  ID=$(bash -c 'source /etc/os-release && echo $ID')
-  if [[ "${ID}" != "ubuntu" && "${ID}" != "debian" ]]; then
-    echo "ERROR: cannot install on $ID distribution - only Ubuntu and Debian are supported"
-    exit 1
-  fi
-fi
-
-# 1. make sure to remove old beta if any.
-if dpkg --get-selections | grep -q "^google-chrome-beta[[:space:]]*install$" >/dev/null; then
-  apt-get remove -y google-chrome-beta
-fi
-
-# 2. Update apt lists (needed to install curl and chrome dependencies)
-apt-get update
-
-# 3. Install curl to download chrome
-if ! command -v curl >/dev/null; then
-  apt-get install -y curl
-fi
-
-# 4. download chrome beta from dl.google.com and install it.
-cd /tmp
-curl -O https://dl.google.com/linux/direct/google-chrome-beta_current_amd64.deb
-apt-get install -y ./google-chrome-beta_current_amd64.deb
-rm -rf ./google-chrome-beta_current_amd64.deb
-cd -
-google-chrome-beta --version

tvapp2/node_modules/playwright-core/bin/reinstall_chrome_beta_mac.sh

@@ -1,13 +0,0 @@
-#!/usr/bin/env bash
-set -e
-set -x
-
-rm -rf "/Applications/Google Chrome Beta.app"
-cd /tmp
-curl -o ./googlechromebeta.dmg -k https://dl.google.com/chrome/mac/universal/beta/googlechromebeta.dmg
-hdiutil attach -nobrowse -quiet -noautofsck -noautoopen -mountpoint /Volumes/googlechromebeta.dmg ./googlechromebeta.dmg
-cp -pR "/Volumes/googlechromebeta.dmg/Google Chrome Beta.app" /Applications
-hdiutil detach /Volumes/googlechromebeta.dmg
-rm -rf /tmp/googlechromebeta.dmg
-
-/Applications/Google\ Chrome\ Beta.app/Contents/MacOS/Google\ Chrome\ Beta --version

tvapp2/node_modules/playwright-core/bin/reinstall_chrome_beta_win.ps1

@@ -1,24 +0,0 @@
-$ErrorActionPreference = 'Stop'
-
-$url = 'https://dl.google.com/tag/s/dl/chrome/install/beta/googlechromebetastandaloneenterprise64.msi'
-
-Write-Host "Downloading Google Chrome Beta"
-$wc = New-Object net.webclient
-$msiInstaller = "$env:temp\google-chrome-beta.msi"
-$wc.Downloadfile($url, $msiInstaller)
-
-Write-Host "Installing Google Chrome Beta"
-$arguments = "/i `"$msiInstaller`" /quiet"
-Start-Process msiexec.exe -ArgumentList $arguments -Wait
-Remove-Item $msiInstaller
-
-$suffix = "\\Google\\Chrome Beta\\Application\\chrome.exe"
-if (Test-Path "${env:ProgramFiles(x86)}$suffix") {
-    (Get-Item "${env:ProgramFiles(x86)}$suffix").VersionInfo
-} elseif (Test-Path "${env:ProgramFiles}$suffix") {
-    (Get-Item "${env:ProgramFiles}$suffix").VersionInfo
-} else {
-    Write-Host "ERROR: Failed to install Google Chrome Beta."
-    Write-Host "ERROR: This could be due to insufficient privileges, in which case re-running as Administrator may help."
-    exit 1
-}

tvapp2/node_modules/playwright-core/bin/reinstall_chrome_stable_linux.sh

@@ -1,42 +0,0 @@
-#!/usr/bin/env bash
-set -e
-set -x
-
-if [[ $(arch) == "aarch64" ]]; then
-  echo "ERROR: not supported on Linux Arm64"
-  exit 1
-fi
-
-if [ -z "$PLAYWRIGHT_HOST_PLATFORM_OVERRIDE" ]; then
-  if [[ ! -f "/etc/os-release" ]]; then
-    echo "ERROR: cannot install on unknown linux distribution (/etc/os-release is missing)"
-    exit 1
-  fi
-
-  ID=$(bash -c 'source /etc/os-release && echo $ID')
-  if [[ "${ID}" != "ubuntu" && "${ID}" != "debian" ]]; then
-    echo "ERROR: cannot install on $ID distribution - only Ubuntu and Debian are supported"
-    exit 1
-  fi
-fi
-
-# 1. make sure to remove old stable if any.
-if dpkg --get-selections | grep -q "^google-chrome[[:space:]]*install$" >/dev/null; then
-  apt-get remove -y google-chrome
-fi
-
-# 2. Update apt lists (needed to install curl and chrome dependencies)
-apt-get update
-
-# 3. Install curl to download chrome
-if ! command -v curl >/dev/null; then
-  apt-get install -y curl
-fi
-
-# 4. download chrome stable from dl.google.com and install it.
-cd /tmp
-curl -O https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
-apt-get install -y ./google-chrome-stable_current_amd64.deb
-rm -rf ./google-chrome-stable_current_amd64.deb
-cd -
-google-chrome --version

tvapp2/node_modules/playwright-core/bin/reinstall_chrome_stable_mac.sh

@@ -1,12 +0,0 @@
-#!/usr/bin/env bash
-set -e
-set -x
-
-rm -rf "/Applications/Google Chrome.app"
-cd /tmp
-curl -o ./googlechrome.dmg -k https://dl.google.com/chrome/mac/universal/stable/GGRO/googlechrome.dmg
-hdiutil attach -nobrowse -quiet -noautofsck -noautoopen -mountpoint /Volumes/googlechrome.dmg ./googlechrome.dmg
-cp -pR "/Volumes/googlechrome.dmg/Google Chrome.app" /Applications
-hdiutil detach /Volumes/googlechrome.dmg
-rm -rf /tmp/googlechrome.dmg
-/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --version

tvapp2/node_modules/playwright-core/bin/reinstall_chrome_stable_win.ps1

@@ -1,24 +0,0 @@
-$ErrorActionPreference = 'Stop'
-$url = 'https://dl.google.com/tag/s/dl/chrome/install/googlechromestandaloneenterprise64.msi'
-
-$wc = New-Object net.webclient
-$msiInstaller = "$env:temp\google-chrome.msi"
-Write-Host "Downloading Google Chrome"
-$wc.Downloadfile($url, $msiInstaller)
-
-Write-Host "Installing Google Chrome"
-$arguments = "/i `"$msiInstaller`" /quiet"
-Start-Process msiexec.exe -ArgumentList $arguments -Wait
-Remove-Item $msiInstaller
-
-
-$suffix = "\\Google\\Chrome\\Application\\chrome.exe"
-if (Test-Path "${env:ProgramFiles(x86)}$suffix") {
-    (Get-Item "${env:ProgramFiles(x86)}$suffix").VersionInfo
-} elseif (Test-Path "${env:ProgramFiles}$suffix") {
-    (Get-Item "${env:ProgramFiles}$suffix").VersionInfo
-} else {
-    Write-Host "ERROR: Failed to install Google Chrome."
-    Write-Host "ERROR: This could be due to insufficient privileges, in which case re-running as Administrator may help."
-    exit 1
-}

tvapp2/node_modules/playwright-core/bin/reinstall_msedge_beta_linux.sh

@@ -1,48 +0,0 @@
-#!/usr/bin/env bash
-
-set -e
-set -x
-
-if [[ $(arch) == "aarch64" ]]; then
-  echo "ERROR: not supported on Linux Arm64"
-  exit 1
-fi
-
-if [ -z "$PLAYWRIGHT_HOST_PLATFORM_OVERRIDE" ]; then
-  if [[ ! -f "/etc/os-release" ]]; then
-    echo "ERROR: cannot install on unknown linux distribution (/etc/os-release is missing)"
-    exit 1
-  fi
-
-  ID=$(bash -c 'source /etc/os-release && echo $ID')
-  if [[ "${ID}" != "ubuntu" && "${ID}" != "debian" ]]; then
-    echo "ERROR: cannot install on $ID distribution - only Ubuntu and Debian are supported"
-    exit 1
-  fi
-fi
-
-# 1. make sure to remove old beta if any.
-if dpkg --get-selections | grep -q "^microsoft-edge-beta[[:space:]]*install$" >/dev/null; then
-  apt-get remove -y microsoft-edge-beta
-fi
-
-# 2. Install curl to download Microsoft gpg key
-if ! command -v curl >/dev/null; then
-  apt-get update
-  apt-get install -y curl
-fi
-
-# GnuPG is not preinstalled in slim images
-if ! command -v gpg >/dev/null; then
-  apt-get update
-  apt-get install -y gpg
-fi
-
-# 3. Add the GPG key, the apt repo, update the apt cache, and install the package
-curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > /tmp/microsoft.gpg
-install -o root -g root -m 644 /tmp/microsoft.gpg /etc/apt/trusted.gpg.d/
-sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/edge stable main" > /etc/apt/sources.list.d/microsoft-edge-dev.list'
-rm /tmp/microsoft.gpg
-apt-get update && apt-get install -y microsoft-edge-beta
-
-microsoft-edge-beta --version

tvapp2/node_modules/playwright-core/bin/reinstall_msedge_beta_mac.sh

@@ -1,11 +0,0 @@
-#!/usr/bin/env bash
-set -e
-set -x
-
-cd /tmp
-curl -o ./msedge_beta.pkg -k "$1"
-# Note: there's no way to uninstall previously installed MSEdge.
-# However, running PKG again seems to update installation.
-sudo installer -pkg /tmp/msedge_beta.pkg -target /
-rm -rf /tmp/msedge_beta.pkg
-/Applications/Microsoft\ Edge\ Beta.app/Contents/MacOS/Microsoft\ Edge\ Beta --version

tvapp2/node_modules/playwright-core/bin/reinstall_msedge_beta_win.ps1

@@ -1,23 +0,0 @@
-$ErrorActionPreference = 'Stop'
-$url = $args[0]
-
-Write-Host "Downloading Microsoft Edge Beta"
-$wc = New-Object net.webclient
-$msiInstaller = "$env:temp\microsoft-edge-beta.msi"
-$wc.Downloadfile($url, $msiInstaller)
-
-Write-Host "Installing Microsoft Edge Beta"
-$arguments = "/i `"$msiInstaller`" /quiet"
-Start-Process msiexec.exe -ArgumentList $arguments -Wait
-Remove-Item $msiInstaller
-
-$suffix = "\\Microsoft\\Edge Beta\\Application\\msedge.exe"
-if (Test-Path "${env:ProgramFiles(x86)}$suffix") {
-    (Get-Item "${env:ProgramFiles(x86)}$suffix").VersionInfo
-} elseif (Test-Path "${env:ProgramFiles}$suffix") {
-    (Get-Item "${env:ProgramFiles}$suffix").VersionInfo
-} else {
-    Write-Host "ERROR: Failed to install Microsoft Edge Beta."
-    Write-Host "ERROR: This could be due to insufficient privileges, in which case re-running as Administrator may help."
-    exit 1
-}

tvapp2/node_modules/playwright-core/bin/reinstall_msedge_dev_linux.sh

@@ -1,48 +0,0 @@
-#!/usr/bin/env bash
-
-set -e
-set -x
-
-if [[ $(arch) == "aarch64" ]]; then
-  echo "ERROR: not supported on Linux Arm64"
-  exit 1
-fi
-
-if [ -z "$PLAYWRIGHT_HOST_PLATFORM_OVERRIDE" ]; then
-  if [[ ! -f "/etc/os-release" ]]; then
-    echo "ERROR: cannot install on unknown linux distribution (/etc/os-release is missing)"
-    exit 1
-  fi
-
-  ID=$(bash -c 'source /etc/os-release && echo $ID')
-  if [[ "${ID}" != "ubuntu" && "${ID}" != "debian" ]]; then
-    echo "ERROR: cannot install on $ID distribution - only Ubuntu and Debian are supported"
-    exit 1
-  fi
-fi
-
-# 1. make sure to remove old dev if any.
-if dpkg --get-selections | grep -q "^microsoft-edge-dev[[:space:]]*install$" >/dev/null; then
-  apt-get remove -y microsoft-edge-dev
-fi
-
-# 2. Install curl to download Microsoft gpg key
-if ! command -v curl >/dev/null; then
-  apt-get update
-  apt-get install -y curl
-fi
-
-# GnuPG is not preinstalled in slim images
-if ! command -v gpg >/dev/null; then
-  apt-get update
-  apt-get install -y gpg
-fi
-
-# 3. Add the GPG key, the apt repo, update the apt cache, and install the package
-curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > /tmp/microsoft.gpg
-install -o root -g root -m 644 /tmp/microsoft.gpg /etc/apt/trusted.gpg.d/
-sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/edge stable main" > /etc/apt/sources.list.d/microsoft-edge-dev.list'
-rm /tmp/microsoft.gpg
-apt-get update && apt-get install -y microsoft-edge-dev
-
-microsoft-edge-dev --version

tvapp2/node_modules/playwright-core/bin/reinstall_msedge_dev_mac.sh

@@ -1,11 +0,0 @@
-#!/usr/bin/env bash
-set -e
-set -x
-
-cd /tmp
-curl -o ./msedge_dev.pkg -k "$1"
-# Note: there's no way to uninstall previously installed MSEdge.
-# However, running PKG again seems to update installation.
-sudo installer -pkg /tmp/msedge_dev.pkg -target /
-rm -rf /tmp/msedge_dev.pkg
-/Applications/Microsoft\ Edge\ Dev.app/Contents/MacOS/Microsoft\ Edge\ Dev --version

tvapp2/node_modules/playwright-core/bin/reinstall_msedge_dev_win.ps1

@@ -1,23 +0,0 @@
-$ErrorActionPreference = 'Stop'
-$url = $args[0]
-
-Write-Host "Downloading Microsoft Edge Dev"
-$wc = New-Object net.webclient
-$msiInstaller = "$env:temp\microsoft-edge-dev.msi"
-$wc.Downloadfile($url, $msiInstaller)
-
-Write-Host "Installing Microsoft Edge Dev"
-$arguments = "/i `"$msiInstaller`" /quiet"
-Start-Process msiexec.exe -ArgumentList $arguments -Wait
-Remove-Item $msiInstaller
-
-$suffix = "\\Microsoft\\Edge Dev\\Application\\msedge.exe"
-if (Test-Path "${env:ProgramFiles(x86)}$suffix") {
-    (Get-Item "${env:ProgramFiles(x86)}$suffix").VersionInfo
-} elseif (Test-Path "${env:ProgramFiles}$suffix") {
-    (Get-Item "${env:ProgramFiles}$suffix").VersionInfo
-} else {
-    Write-Host "ERROR: Failed to install Microsoft Edge Dev."
-    Write-Host "ERROR: This could be due to insufficient privileges, in which case re-running as Administrator may help."
-    exit 1
-}

tvapp2/node_modules/playwright-core/bin/reinstall_msedge_stable_linux.sh

@@ -1,48 +0,0 @@
-#!/usr/bin/env bash
-
-set -e
-set -x
-
-if [[ $(arch) == "aarch64" ]]; then
-  echo "ERROR: not supported on Linux Arm64"
-  exit 1
-fi
-
-if [ -z "$PLAYWRIGHT_HOST_PLATFORM_OVERRIDE" ]; then
-  if [[ ! -f "/etc/os-release" ]]; then
-    echo "ERROR: cannot install on unknown linux distribution (/etc/os-release is missing)"
-    exit 1
-  fi
-
-  ID=$(bash -c 'source /etc/os-release && echo $ID')
-  if [[ "${ID}" != "ubuntu" && "${ID}" != "debian" ]]; then
-    echo "ERROR: cannot install on $ID distribution - only Ubuntu and Debian are supported"
-    exit 1
-  fi
-fi
-
-# 1. make sure to remove old stable if any.
-if dpkg --get-selections | grep -q "^microsoft-edge-stable[[:space:]]*install$" >/dev/null; then
-  apt-get remove -y microsoft-edge-stable
-fi
-
-# 2. Install curl to download Microsoft gpg key
-if ! command -v curl >/dev/null; then
-  apt-get update
-  apt-get install -y curl
-fi
-
-# GnuPG is not preinstalled in slim images
-if ! command -v gpg >/dev/null; then
-  apt-get update
-  apt-get install -y gpg
-fi
-
-# 3. Add the GPG key, the apt repo, update the apt cache, and install the package
-curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > /tmp/microsoft.gpg
-install -o root -g root -m 644 /tmp/microsoft.gpg /etc/apt/trusted.gpg.d/
-sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/edge stable main" > /etc/apt/sources.list.d/microsoft-edge-stable.list'
-rm /tmp/microsoft.gpg
-apt-get update && apt-get install -y microsoft-edge-stable
-
-microsoft-edge-stable --version

tvapp2/node_modules/playwright-core/bin/reinstall_msedge_stable_mac.sh

@@ -1,11 +0,0 @@
-#!/usr/bin/env bash
-set -e
-set -x
-
-cd /tmp
-curl -o ./msedge_stable.pkg -k "$1"
-# Note: there's no way to uninstall previously installed MSEdge.
-# However, running PKG again seems to update installation.
-sudo installer -pkg /tmp/msedge_stable.pkg -target /
-rm -rf /tmp/msedge_stable.pkg
-/Applications/Microsoft\ Edge.app/Contents/MacOS/Microsoft\ Edge --version

tvapp2/node_modules/playwright-core/bin/reinstall_msedge_stable_win.ps1

@@ -1,24 +0,0 @@
-$ErrorActionPreference = 'Stop'
-
-$url = $args[0]
-
-Write-Host "Downloading Microsoft Edge"
-$wc = New-Object net.webclient
-$msiInstaller = "$env:temp\microsoft-edge-stable.msi"
-$wc.Downloadfile($url, $msiInstaller)
-
-Write-Host "Installing Microsoft Edge"
-$arguments = "/i `"$msiInstaller`" /quiet"
-Start-Process msiexec.exe -ArgumentList $arguments -Wait
-Remove-Item $msiInstaller
-
-$suffix = "\\Microsoft\\Edge\\Application\\msedge.exe"
-if (Test-Path "${env:ProgramFiles(x86)}$suffix") {
-    (Get-Item "${env:ProgramFiles(x86)}$suffix").VersionInfo
-} elseif (Test-Path "${env:ProgramFiles}$suffix") {
-    (Get-Item "${env:ProgramFiles}$suffix").VersionInfo
-} else {
-    Write-Host "ERROR: Failed to install Microsoft Edge."
-    Write-Host "ERROR: This could be due to insufficient privileges, in which case re-running as Administrator may help."
-    exit 1
-}

tvapp2/node_modules/playwright-core/browsers.json

@@ -1,78 +0,0 @@
-{
-  "comment": "Do not edit this file, use utils/roll_browser.js",
-  "browsers": [
-    {
-      "name": "chromium",
-      "revision": "1161",
-      "installByDefault": true,
-      "browserVersion": "134.0.6998.35"
-    },
-    {
-      "name": "chromium-headless-shell",
-      "revision": "1161",
-      "installByDefault": true,
-      "browserVersion": "134.0.6998.35"
-    },
-    {
-      "name": "chromium-tip-of-tree",
-      "revision": "1304",
-      "installByDefault": false,
-      "browserVersion": "135.0.7021.0"
-    },
-    {
-      "name": "chromium-tip-of-tree-headless-shell",
-      "revision": "1304",
-      "installByDefault": false,
-      "browserVersion": "135.0.7021.0"
-    },
-    {
-      "name": "firefox",
-      "revision": "1475",
-      "installByDefault": true,
-      "browserVersion": "135.0"
-    },
-    {
-      "name": "firefox-beta",
-      "revision": "1471",
-      "installByDefault": false,
-      "browserVersion": "136.0b4"
-    },
-    {
-      "name": "webkit",
-      "revision": "2140",
-      "installByDefault": true,
-      "revisionOverrides": {
-        "debian11-x64": "2105",
-        "debian11-arm64": "2105",
-        "mac10.14": "1446",
-        "mac10.15": "1616",
-        "mac11": "1816",
-        "mac11-arm64": "1816",
-        "mac12": "2009",
-        "mac12-arm64": "2009",
-        "ubuntu20.04-x64": "2092",
-        "ubuntu20.04-arm64": "2092"
-      },
-      "browserVersion": "18.4"
-    },
-    {
-      "name": "ffmpeg",
-      "revision": "1011",
-      "installByDefault": true,
-      "revisionOverrides": {
-        "mac12": "1010",
-        "mac12-arm64": "1010"
-      }
-    },
-    {
-      "name": "winldd",
-      "revision": "1007",
-      "installByDefault": false
-    },
-    {
-      "name": "android",
-      "revision": "1001",
-      "installByDefault": false
-    }
-  ]
-}

tvapp2/node_modules/playwright-core/cli.js

@@ -1,18 +0,0 @@
-#!/usr/bin/env node
-/**
- * Copyright (c) Microsoft Corporation.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-const { program } = require('./lib/cli/programWithTestStub');
-program.parse(process.argv);

tvapp2/node_modules/playwright-core/index.d.ts

@@ -1,17 +0,0 @@
-/**
- * Copyright (c) Microsoft Corporation.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-export * from './types/types';

tvapp2/node_modules/playwright-core/index.js

@@ -1,32 +0,0 @@
-/**
- * Copyright (c) Microsoft Corporation.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-const minimumMajorNodeVersion = 14;
-const currentNodeVersion = process.versions.node;
-const semver = currentNodeVersion.split('.');
-const [major] = [+semver[0]];
-
-if (major < minimumMajorNodeVersion) {
-  console.error(
-      'You are running Node.js ' +
-      currentNodeVersion +
-      '.\n' +
-      `Playwright requires Node.js ${minimumMajorNodeVersion} or higher. \n` +
-      'Please update your version of Node.js.'
-  );
-  process.exit(1);
-}
-
-module.exports = require('./lib/inprocess');

tvapp2/node_modules/playwright-core/index.mjs

@@ -1,28 +0,0 @@
-/**
- * Copyright (c) Microsoft Corporation.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import playwright from './index.js';
-
-export const chromium = playwright.chromium;
-export const firefox = playwright.firefox;
-export const webkit = playwright.webkit;
-export const selectors = playwright.selectors;
-export const devices = playwright.devices;
-export const errors = playwright.errors;
-export const request = playwright.request;
-export const _electron = playwright._electron;
-export const _android = playwright._android;
-export default playwright;

tvapp2/node_modules/playwright-core/lib/androidServerImpl.js

@@ -1,69 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.AndroidServerLauncherImpl = void 0;
-var _playwrightServer = require("./remote/playwrightServer");
-var _playwright = require("./server/playwright");
-var _crypto = require("./server/utils/crypto");
-var _utilsBundle = require("./utilsBundle");
-/**
- * Copyright (c) Microsoft Corporation.
- *
- * Licensed under the Apache License, Version 2.0 (the 'License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-class AndroidServerLauncherImpl {
-  async launchServer(options = {}) {
-    const playwright = (0, _playwright.createPlaywright)({
-      sdkLanguage: 'javascript',
-      isServer: true
-    });
-    // 1. Pre-connect to the device
-    let devices = await playwright.android.devices({
-      host: options.adbHost,
-      port: options.adbPort,
-      omitDriverInstall: options.omitDriverInstall
-    });
-    if (devices.length === 0) throw new Error('No devices found');
-    if (options.deviceSerialNumber) {
-      devices = devices.filter(d => d.serial === options.deviceSerialNumber);
-      if (devices.length === 0) throw new Error(`No device with serial number '${options.deviceSerialNumber}' was found`);
-    }
-    if (devices.length > 1) throw new Error(`More than one device found. Please specify deviceSerialNumber`);
-    const device = devices[0];
-    const path = options.wsPath ? options.wsPath.startsWith('/') ? options.wsPath : `/${options.wsPath}` : `/${(0, _crypto.createGuid)()}`;
-
-    // 2. Start the server
-    const server = new _playwrightServer.PlaywrightServer({
-      mode: 'launchServer',
-      path,
-      maxConnections: 1,
-      preLaunchedAndroidDevice: device
-    });
-    const wsEndpoint = await server.listen(options.port, options.host);
-
-    // 3. Return the BrowserServer interface
-    const browserServer = new _utilsBundle.ws.EventEmitter();
-    browserServer.wsEndpoint = () => wsEndpoint;
-    browserServer.close = () => device.close();
-    browserServer.kill = () => device.close();
-    device.on('close', () => {
-      server.close();
-      browserServer.emit('close');
-    });
-    return browserServer;
-  }
-}
-exports.AndroidServerLauncherImpl = AndroidServerLauncherImpl;

tvapp2/node_modules/playwright-core/lib/browserServerImpl.js

@@ -1,101 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.BrowserServerLauncherImpl = void 0;
-var _socksProxy = require("./server/utils/socksProxy");
-var _playwrightServer = require("./remote/playwrightServer");
-var _helper = require("./server/helper");
-var _instrumentation = require("./server/instrumentation");
-var _playwright = require("./server/playwright");
-var _crypto = require("./server/utils/crypto");
-var _stackTrace = require("./utils/isomorphic/stackTrace");
-var _utilsBundle = require("./utilsBundle");
-/**
- * Copyright (c) Microsoft Corporation.
- *
- * Licensed under the Apache License, Version 2.0 (the 'License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-class BrowserServerLauncherImpl {
-  constructor(browserName) {
-    this._browserName = void 0;
-    this._browserName = browserName;
-  }
-  async launchServer(options = {}) {
-    const playwright = (0, _playwright.createPlaywright)({
-      sdkLanguage: 'javascript',
-      isServer: true
-    });
-    // TODO: enable socks proxy once ipv6 is supported.
-    const socksProxy = false ? new _socksProxy.SocksProxy() : undefined;
-    playwright.options.socksProxyPort = await (socksProxy === null || socksProxy === void 0 ? void 0 : socksProxy.listen(0));
-
-    // 1. Pre-launch the browser
-    const metadata = (0, _instrumentation.serverSideCallMetadata)();
-    const browser = await playwright[this._browserName].launch(metadata, {
-      ...options,
-      ignoreDefaultArgs: Array.isArray(options.ignoreDefaultArgs) ? options.ignoreDefaultArgs : undefined,
-      ignoreAllDefaultArgs: !!options.ignoreDefaultArgs && !Array.isArray(options.ignoreDefaultArgs),
-      env: options.env ? envObjectToArray(options.env) : undefined
-    }, toProtocolLogger(options.logger)).catch(e => {
-      const log = _helper.helper.formatBrowserLogs(metadata.log);
-      (0, _stackTrace.rewriteErrorMessage)(e, `${e.message} Failed to launch browser.${log}`);
-      throw e;
-    });
-    const path = options.wsPath ? options.wsPath.startsWith('/') ? options.wsPath : `/${options.wsPath}` : `/${(0, _crypto.createGuid)()}`;
-
-    // 2. Start the server
-    const server = new _playwrightServer.PlaywrightServer({
-      mode: 'launchServer',
-      path,
-      maxConnections: Infinity,
-      preLaunchedBrowser: browser,
-      preLaunchedSocksProxy: socksProxy
-    });
-    const wsEndpoint = await server.listen(options.port, options.host);
-
-    // 3. Return the BrowserServer interface
-    const browserServer = new _utilsBundle.ws.EventEmitter();
-    browserServer.process = () => browser.options.browserProcess.process;
-    browserServer.wsEndpoint = () => wsEndpoint;
-    browserServer.close = () => browser.options.browserProcess.close();
-    browserServer[Symbol.asyncDispose] = browserServer.close;
-    browserServer.kill = () => browser.options.browserProcess.kill();
-    browserServer._disconnectForTest = () => server.close();
-    browserServer._userDataDirForTest = browser._userDataDirForTest;
-    browser.options.browserProcess.onclose = (exitCode, signal) => {
-      socksProxy === null || socksProxy === void 0 || socksProxy.close().catch(() => {});
-      server.close();
-      browserServer.emit('close', exitCode, signal);
-    };
-    return browserServer;
-  }
-}
-exports.BrowserServerLauncherImpl = BrowserServerLauncherImpl;
-function toProtocolLogger(logger) {
-  return logger ? (direction, message) => {
-    if (logger.isEnabled('protocol', 'verbose')) logger.log('protocol', 'verbose', (direction === 'send' ? 'SEND ► ' : '◀ RECV ') + JSON.stringify(message), [], {});
-  } : undefined;
-}
-function envObjectToArray(env) {
-  const result = [];
-  for (const name in env) {
-    if (!Object.is(env[name], undefined)) result.push({
-      name,
-      value: String(env[name])
-    });
-  }
-  return result;
-}

tvapp2/node_modules/playwright-core/lib/cli/driver.js

@@ -1,95 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.launchBrowserServer = launchBrowserServer;
-exports.printApiJson = printApiJson;
-exports.runDriver = runDriver;
-exports.runServer = runServer;
-var _fs = _interopRequireDefault(require("fs"));
-var playwright = _interopRequireWildcard(require("../.."));
-var _pipeTransport = require("../server/utils/pipeTransport");
-var _playwrightServer = require("../remote/playwrightServer");
-var _server = require("../server");
-var _processLauncher = require("../server/utils/processLauncher");
-function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
-function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-/**
- * Copyright (c) Microsoft Corporation.
- *
- * Licensed under the Apache License, Version 2.0 (the 'License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-/* eslint-disable no-console */
-
-function printApiJson() {
-  // Note: this file is generated by build-playwright-driver.sh
-  console.log(JSON.stringify(require('../../api.json')));
-}
-function runDriver() {
-  const dispatcherConnection = new _server.DispatcherConnection();
-  new _server.RootDispatcher(dispatcherConnection, async (rootScope, {
-    sdkLanguage
-  }) => {
-    const playwright = (0, _server.createPlaywright)({
-      sdkLanguage
-    });
-    return new _server.PlaywrightDispatcher(rootScope, playwright);
-  });
-  const transport = new _pipeTransport.PipeTransport(process.stdout, process.stdin);
-  transport.onmessage = message => dispatcherConnection.dispatch(JSON.parse(message));
-  // Certain Language Binding JSON parsers (e.g. .NET) do not like strings with lone surrogates.
-  const isJavaScriptLanguageBinding = !process.env.PW_LANG_NAME || process.env.PW_LANG_NAME === 'javascript';
-  const replacer = !isJavaScriptLanguageBinding && String.prototype.toWellFormed ? (key, value) => {
-    if (typeof value === 'string') return value.toWellFormed();
-    return value;
-  } : undefined;
-  dispatcherConnection.onmessage = message => transport.send(JSON.stringify(message, replacer));
-  transport.onclose = () => {
-    // Drop any messages during shutdown on the floor.
-    dispatcherConnection.onmessage = () => {};
-    (0, _processLauncher.gracefullyProcessExitDoNotHang)(0);
-  };
-  // Ignore the SIGINT signal in the driver process so the parent can gracefully close the connection.
-  // We still will destruct everything (close browsers and exit) when the transport pipe closes.
-  process.on('SIGINT', () => {
-    // Keep the process running.
-  });
-}
-async function runServer(options) {
-  const {
-    port,
-    host,
-    path = '/',
-    maxConnections = Infinity,
-    extension
-  } = options;
-  const server = new _playwrightServer.PlaywrightServer({
-    mode: extension ? 'extension' : 'default',
-    path,
-    maxConnections
-  });
-  const wsEndpoint = await server.listen(port, host);
-  process.on('exit', () => server.close().catch(console.error));
-  console.log('Listening on ' + wsEndpoint);
-  process.stdin.on('close', () => (0, _processLauncher.gracefullyProcessExitDoNotHang)(0));
-}
-async function launchBrowserServer(browserName, configFile) {
-  let options = {};
-  if (configFile) options = JSON.parse(_fs.default.readFileSync(configFile).toString());
-  const browserType = playwright[browserName];
-  const server = await browserType.launchServer(options);
-  console.log(server.wsEndpoint());
-}

tvapp2/node_modules/playwright-core/lib/cli/program.js

@@ -1,583 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-Object.defineProperty(exports, "program", {
-  enumerable: true,
-  get: function () {
-    return _utilsBundle.program;
-  }
-});
-var _fs = _interopRequireDefault(require("fs"));
-var _os = _interopRequireDefault(require("os"));
-var _path = _interopRequireDefault(require("path"));
-var playwright = _interopRequireWildcard(require("../.."));
-var _driver = require("./driver");
-var _server = require("../server");
-var _utils = require("../utils");
-var _traceViewer = require("../server/trace/viewer/traceViewer");
-var _ascii = require("../server/utils/ascii");
-var _utilsBundle = require("../utilsBundle");
-function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
-function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-/**
- * Copyright (c) Microsoft Corporation.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-/* eslint-disable no-console */
-
-const packageJSON = require('../../package.json');
-_utilsBundle.program.version('Version ' + (process.env.PW_CLI_DISPLAY_VERSION || packageJSON.version)).name(buildBasePlaywrightCLICommand(process.env.PW_LANG_NAME));
-_utilsBundle.program.command('mark-docker-image [dockerImageNameTemplate]', {
-  hidden: true
-}).description('mark docker image').allowUnknownOption(true).action(function (dockerImageNameTemplate) {
-  (0, _utils.assert)(dockerImageNameTemplate, 'dockerImageNameTemplate is required');
-  (0, _server.writeDockerVersion)(dockerImageNameTemplate).catch(logErrorAndExit);
-});
-commandWithOpenOptions('open [url]', 'open page in browser specified via -b, --browser', []).action(function (url, options) {
-  open(options, url, codegenId()).catch(logErrorAndExit);
-}).addHelpText('afterAll', `
-Examples:
-
-  $ open
-  $ open -b webkit https://example.com`);
-commandWithOpenOptions('codegen [url]', 'open page and generate code for user actions', [['-o, --output <file name>', 'saves the generated script to a file'], ['--target <language>', `language to generate, one of javascript, playwright-test, python, python-async, python-pytest, csharp, csharp-mstest, csharp-nunit, java, java-junit`, codegenId()], ['--test-id-attribute <attributeName>', 'use the specified attribute to generate data test ID selectors']]).action(function (url, options) {
-  codegen(options, url).catch(logErrorAndExit);
-}).addHelpText('afterAll', `
-Examples:
-
-  $ codegen
-  $ codegen --target=python
-  $ codegen -b webkit https://example.com`);
-function suggestedBrowsersToInstall() {
-  return _server.registry.executables().filter(e => e.installType !== 'none' && e.type !== 'tool').map(e => e.name).join(', ');
-}
-function defaultBrowsersToInstall(options) {
-  let executables = _server.registry.defaultExecutables();
-  if (options.noShell) executables = executables.filter(e => e.name !== 'chromium-headless-shell');
-  if (options.onlyShell) executables = executables.filter(e => e.name !== 'chromium');
-  return executables;
-}
-function checkBrowsersToInstall(args, options) {
-  if (options.noShell && options.onlyShell) throw new Error(`Only one of --no-shell and --only-shell can be specified`);
-  const faultyArguments = [];
-  const executables = [];
-  const handleArgument = arg => {
-    const executable = _server.registry.findExecutable(arg);
-    if (!executable || executable.installType === 'none') faultyArguments.push(arg);else executables.push(executable);
-    if ((executable === null || executable === void 0 ? void 0 : executable.browserName) === 'chromium') executables.push(_server.registry.findExecutable('ffmpeg'));
-  };
-  for (const arg of args) {
-    if (arg === 'chromium') {
-      if (!options.onlyShell) handleArgument('chromium');
-      if (!options.noShell) handleArgument('chromium-headless-shell');
-    } else {
-      handleArgument(arg);
-    }
-  }
-  if (process.platform === 'win32') executables.push(_server.registry.findExecutable('winldd'));
-  if (faultyArguments.length) throw new Error(`Invalid installation targets: ${faultyArguments.map(name => `'${name}'`).join(', ')}. Expecting one of: ${suggestedBrowsersToInstall()}`);
-  return executables;
-}
-_utilsBundle.program.command('install [browser...]').description('ensure browsers necessary for this version of Playwright are installed').option('--with-deps', 'install system dependencies for browsers').option('--dry-run', 'do not execute installation, only print information').option('--force', 'force reinstall of stable browser channels').option('--only-shell', 'only install headless shell when installing chromium').option('--no-shell', 'do not install chromium headless shell').action(async function (args, options) {
-  // For '--no-shell' option, commander sets `shell: false` instead.
-  if (options.shell === false) options.noShell = true;
-  if ((0, _utils.isLikelyNpxGlobal)()) {
-    console.error((0, _ascii.wrapInASCIIBox)([`WARNING: It looks like you are running 'npx playwright install' without first`, `installing your project's dependencies.`, ``, `To avoid unexpected behavior, please install your dependencies first, and`, `then run Playwright's install command:`, ``, `    npm install`, `    npx playwright install`, ``, `If your project does not yet depend on Playwright, first install the`, `applicable npm package (most commonly @playwright/test), and`, `then run Playwright's install command to download the browsers:`, ``, `    npm install @playwright/test`, `    npx playwright install`, ``].join('\n'), 1));
-  }
-  try {
-    const hasNoArguments = !args.length;
-    const executables = hasNoArguments ? defaultBrowsersToInstall(options) : checkBrowsersToInstall(args, options);
-    if (options.withDeps) await _server.registry.installDeps(executables, !!options.dryRun);
-    if (options.dryRun) {
-      for (const executable of executables) {
-        var _executable$directory, _executable$downloadU;
-        const version = executable.browserVersion ? `version ` + executable.browserVersion : '';
-        console.log(`browser: ${executable.name}${version ? ' ' + version : ''}`);
-        console.log(`  Install location:    ${(_executable$directory = executable.directory) !== null && _executable$directory !== void 0 ? _executable$directory : '<system>'}`);
-        if ((_executable$downloadU = executable.downloadURLs) !== null && _executable$downloadU !== void 0 && _executable$downloadU.length) {
-          const [url, ...fallbacks] = executable.downloadURLs;
-          console.log(`  Download url:        ${url}`);
-          for (let i = 0; i < fallbacks.length; ++i) console.log(`  Download fallback ${i + 1}: ${fallbacks[i]}`);
-        }
-        console.log(``);
-      }
-    } else {
-      const forceReinstall = hasNoArguments ? false : !!options.force;
-      await _server.registry.install(executables, forceReinstall);
-      await _server.registry.validateHostRequirementsForExecutablesIfNeeded(executables, process.env.PW_LANG_NAME || 'javascript').catch(e => {
-        e.name = 'Playwright Host validation warning';
-        console.error(e);
-      });
-    }
-  } catch (e) {
-    console.log(`Failed to install browsers\n${e}`);
-    (0, _utils.gracefullyProcessExitDoNotHang)(1);
-  }
-}).addHelpText('afterAll', `
-
-Examples:
-  - $ install
-    Install default browsers.
-
-  - $ install chrome firefox
-    Install custom browsers, supports ${suggestedBrowsersToInstall()}.`);
-_utilsBundle.program.command('uninstall').description('Removes browsers used by this installation of Playwright from the system (chromium, firefox, webkit, ffmpeg). This does not include branded channels.').option('--all', 'Removes all browsers used by any Playwright installation from the system.').action(async options => {
-  delete process.env.PLAYWRIGHT_SKIP_BROWSER_GC;
-  await _server.registry.uninstall(!!options.all).then(({
-    numberOfBrowsersLeft
-  }) => {
-    if (!options.all && numberOfBrowsersLeft > 0) {
-      console.log('Successfully uninstalled Playwright browsers for the current Playwright installation.');
-      console.log(`There are still ${numberOfBrowsersLeft} browsers left, used by other Playwright installations.\nTo uninstall Playwright browsers for all installations, re-run with --all flag.`);
-    }
-  }).catch(logErrorAndExit);
-});
-_utilsBundle.program.command('install-deps [browser...]').description('install dependencies necessary to run browsers (will ask for sudo permissions)').option('--dry-run', 'Do not execute installation commands, only print them').action(async function (args, options) {
-  try {
-    if (!args.length) await _server.registry.installDeps(defaultBrowsersToInstall({}), !!options.dryRun);else await _server.registry.installDeps(checkBrowsersToInstall(args, {}), !!options.dryRun);
-  } catch (e) {
-    console.log(`Failed to install browser dependencies\n${e}`);
-    (0, _utils.gracefullyProcessExitDoNotHang)(1);
-  }
-}).addHelpText('afterAll', `
-Examples:
-  - $ install-deps
-    Install dependencies for default browsers.
-
-  - $ install-deps chrome firefox
-    Install dependencies for specific browsers, supports ${suggestedBrowsersToInstall()}.`);
-const browsers = [{
-  alias: 'cr',
-  name: 'Chromium',
-  type: 'chromium'
-}, {
-  alias: 'ff',
-  name: 'Firefox',
-  type: 'firefox'
-}, {
-  alias: 'wk',
-  name: 'WebKit',
-  type: 'webkit'
-}];
-for (const {
-  alias,
-  name,
-  type
-} of browsers) {
-  commandWithOpenOptions(`${alias} [url]`, `open page in ${name}`, []).action(function (url, options) {
-    open({
-      ...options,
-      browser: type
-    }, url, options.target).catch(logErrorAndExit);
-  }).addHelpText('afterAll', `
-Examples:
-
-  $ ${alias} https://example.com`);
-}
-commandWithOpenOptions('screenshot <url> <filename>', 'capture a page screenshot', [['--wait-for-selector <selector>', 'wait for selector before taking a screenshot'], ['--wait-for-timeout <timeout>', 'wait for timeout in milliseconds before taking a screenshot'], ['--full-page', 'whether to take a full page screenshot (entire scrollable area)']]).action(function (url, filename, command) {
-  screenshot(command, command, url, filename).catch(logErrorAndExit);
-}).addHelpText('afterAll', `
-Examples:
-
-  $ screenshot -b webkit https://example.com example.png`);
-commandWithOpenOptions('pdf <url> <filename>', 'save page as pdf', [['--wait-for-selector <selector>', 'wait for given selector before saving as pdf'], ['--wait-for-timeout <timeout>', 'wait for given timeout in milliseconds before saving as pdf']]).action(function (url, filename, options) {
-  pdf(options, options, url, filename).catch(logErrorAndExit);
-}).addHelpText('afterAll', `
-Examples:
-
-  $ pdf https://example.com example.pdf`);
-_utilsBundle.program.command('run-driver', {
-  hidden: true
-}).action(function (options) {
-  (0, _driver.runDriver)();
-});
-_utilsBundle.program.command('run-server').option('--port <port>', 'Server port').option('--host <host>', 'Server host').option('--path <path>', 'Endpoint Path', '/').option('--max-clients <maxClients>', 'Maximum clients').option('--mode <mode>', 'Server mode, either "default" or "extension"').action(function (options) {
-  (0, _driver.runServer)({
-    port: options.port ? +options.port : undefined,
-    host: options.host,
-    path: options.path,
-    maxConnections: options.maxClients ? +options.maxClients : Infinity,
-    extension: options.mode === 'extension' || !!process.env.PW_EXTENSION_MODE
-  }).catch(logErrorAndExit);
-});
-_utilsBundle.program.command('print-api-json', {
-  hidden: true
-}).action(function (options) {
-  (0, _driver.printApiJson)();
-});
-_utilsBundle.program.command('launch-server', {
-  hidden: true
-}).requiredOption('--browser <browserName>', 'Browser name, one of "chromium", "firefox" or "webkit"').option('--config <path-to-config-file>', 'JSON file with launchServer options').action(function (options) {
-  (0, _driver.launchBrowserServer)(options.browser, options.config);
-});
-_utilsBundle.program.command('show-trace [trace...]').option('-b, --browser <browserType>', 'browser to use, one of cr, chromium, ff, firefox, wk, webkit', 'chromium').option('-h, --host <host>', 'Host to serve trace on; specifying this option opens trace in a browser tab').option('-p, --port <port>', 'Port to serve trace on, 0 for any free port; specifying this option opens trace in a browser tab').option('--stdin', 'Accept trace URLs over stdin to update the viewer').description('show trace viewer').action(function (traces, options) {
-  if (options.browser === 'cr') options.browser = 'chromium';
-  if (options.browser === 'ff') options.browser = 'firefox';
-  if (options.browser === 'wk') options.browser = 'webkit';
-  const openOptions = {
-    host: options.host,
-    port: +options.port,
-    isServer: !!options.stdin
-  };
-  if (options.port !== undefined || options.host !== undefined) (0, _traceViewer.runTraceInBrowser)(traces, openOptions).catch(logErrorAndExit);else (0, _traceViewer.runTraceViewerApp)(traces, options.browser, openOptions, true).catch(logErrorAndExit);
-}).addHelpText('afterAll', `
-Examples:
-
-  $ show-trace https://example.com/trace.zip`);
-async function launchContext(options, extraOptions) {
-  validateOptions(options);
-  const browserType = lookupBrowserType(options);
-  const launchOptions = extraOptions;
-  if (options.channel) launchOptions.channel = options.channel;
-  launchOptions.handleSIGINT = false;
-  const contextOptions =
-  // Copy the device descriptor since we have to compare and modify the options.
-  options.device ? {
-    ...playwright.devices[options.device]
-  } : {};
-
-  // In headful mode, use host device scale factor for things to look nice.
-  // In headless, keep things the way it works in Playwright by default.
-  // Assume high-dpi on MacOS. TODO: this is not perfect.
-  if (!extraOptions.headless) contextOptions.deviceScaleFactor = _os.default.platform() === 'darwin' ? 2 : 1;
-
-  // Work around the WebKit GTK scrolling issue.
-  if (browserType.name() === 'webkit' && process.platform === 'linux') {
-    delete contextOptions.hasTouch;
-    delete contextOptions.isMobile;
-  }
-  if (contextOptions.isMobile && browserType.name() === 'firefox') contextOptions.isMobile = undefined;
-  if (options.blockServiceWorkers) contextOptions.serviceWorkers = 'block';
-
-  // Proxy
-
-  if (options.proxyServer) {
-    launchOptions.proxy = {
-      server: options.proxyServer
-    };
-    if (options.proxyBypass) launchOptions.proxy.bypass = options.proxyBypass;
-  }
-  const browser = await browserType.launch(launchOptions);
-  if (process.env.PWTEST_CLI_IS_UNDER_TEST) {
-    process._didSetSourcesForTest = text => {
-      process.stdout.write('\n-------------8<-------------\n');
-      process.stdout.write(text);
-      process.stdout.write('\n-------------8<-------------\n');
-      const autoExitCondition = process.env.PWTEST_CLI_AUTO_EXIT_WHEN;
-      if (autoExitCondition && text.includes(autoExitCondition)) closeBrowser();
-    };
-    // Make sure we exit abnormally when browser crashes.
-    const logs = [];
-    require('playwright-core/lib/utilsBundle').debug.log = (...args) => {
-      const line = require('util').format(...args) + '\n';
-      logs.push(line);
-      process.stderr.write(line);
-    };
-    browser.on('disconnected', () => {
-      const hasCrashLine = logs.some(line => line.includes('process did exit:') && !line.includes('process did exit: exitCode=0, signal=null'));
-      if (hasCrashLine) {
-        process.stderr.write('Detected browser crash.\n');
-        (0, _utils.gracefullyProcessExitDoNotHang)(1);
-      }
-    });
-  }
-
-  // Viewport size
-  if (options.viewportSize) {
-    try {
-      const [width, height] = options.viewportSize.split(',').map(n => +n);
-      if (isNaN(width) || isNaN(height)) throw new Error('bad values');
-      contextOptions.viewport = {
-        width,
-        height
-      };
-    } catch (e) {
-      throw new Error('Invalid viewport size format: use "width,height", for example --viewport-size="800,600"');
-    }
-  }
-
-  // Geolocation
-
-  if (options.geolocation) {
-    try {
-      const [latitude, longitude] = options.geolocation.split(',').map(n => parseFloat(n.trim()));
-      contextOptions.geolocation = {
-        latitude,
-        longitude
-      };
-    } catch (e) {
-      throw new Error('Invalid geolocation format, should be "lat,long". For example --geolocation="37.819722,-122.478611"');
-    }
-    contextOptions.permissions = ['geolocation'];
-  }
-
-  // User agent
-
-  if (options.userAgent) contextOptions.userAgent = options.userAgent;
-
-  // Lang
-
-  if (options.lang) contextOptions.locale = options.lang;
-
-  // Color scheme
-
-  if (options.colorScheme) contextOptions.colorScheme = options.colorScheme;
-
-  // Timezone
-
-  if (options.timezone) contextOptions.timezoneId = options.timezone;
-
-  // Storage
-
-  if (options.loadStorage) contextOptions.storageState = options.loadStorage;
-  if (options.ignoreHttpsErrors) contextOptions.ignoreHTTPSErrors = true;
-
-  // HAR
-
-  if (options.saveHar) {
-    contextOptions.recordHar = {
-      path: _path.default.resolve(process.cwd(), options.saveHar),
-      mode: 'minimal'
-    };
-    if (options.saveHarGlob) contextOptions.recordHar.urlFilter = options.saveHarGlob;
-    contextOptions.serviceWorkers = 'block';
-  }
-
-  // Close app when the last window closes.
-
-  const context = await browser.newContext(contextOptions);
-  let closingBrowser = false;
-  async function closeBrowser() {
-    // We can come here multiple times. For example, saving storage creates
-    // a temporary page and we call closeBrowser again when that page closes.
-    if (closingBrowser) return;
-    closingBrowser = true;
-    if (options.saveStorage) await context.storageState({
-      path: options.saveStorage
-    }).catch(e => null);
-    if (options.saveHar) await context.close();
-    await browser.close();
-  }
-  context.on('page', page => {
-    page.on('dialog', () => {}); // Prevent dialogs from being automatically dismissed.
-    page.on('close', () => {
-      const hasPage = browser.contexts().some(context => context.pages().length > 0);
-      if (hasPage) return;
-      // Avoid the error when the last page is closed because the browser has been closed.
-      closeBrowser().catch(() => {});
-    });
-  });
-  process.on('SIGINT', async () => {
-    await closeBrowser();
-    (0, _utils.gracefullyProcessExitDoNotHang)(130);
-  });
-  const timeout = options.timeout ? parseInt(options.timeout, 10) : 0;
-  context.setDefaultTimeout(timeout);
-  context.setDefaultNavigationTimeout(timeout);
-
-  // Omit options that we add automatically for presentation purpose.
-  delete launchOptions.headless;
-  delete launchOptions.executablePath;
-  delete launchOptions.handleSIGINT;
-  delete contextOptions.deviceScaleFactor;
-  return {
-    browser,
-    browserName: browserType.name(),
-    context,
-    contextOptions,
-    launchOptions
-  };
-}
-async function openPage(context, url) {
-  const page = await context.newPage();
-  if (url) {
-    if (_fs.default.existsSync(url)) url = 'file://' + _path.default.resolve(url);else if (!url.startsWith('http') && !url.startsWith('file://') && !url.startsWith('about:') && !url.startsWith('data:')) url = 'http://' + url;
-    await page.goto(url).catch(error => {
-      if (process.env.PWTEST_CLI_AUTO_EXIT_WHEN) {
-        // Tests with PWTEST_CLI_AUTO_EXIT_WHEN might close page too fast, resulting
-        // in a stray navigation aborted error. We should ignore it.
-      } else {
-        throw error;
-      }
-    });
-  }
-  return page;
-}
-async function open(options, url, language) {
-  const {
-    context,
-    launchOptions,
-    contextOptions
-  } = await launchContext(options, {
-    headless: !!process.env.PWTEST_CLI_HEADLESS,
-    executablePath: process.env.PWTEST_CLI_EXECUTABLE_PATH
-  });
-  await context._enableRecorder({
-    language,
-    launchOptions,
-    contextOptions,
-    device: options.device,
-    saveStorage: options.saveStorage,
-    handleSIGINT: false
-  });
-  await openPage(context, url);
-}
-async function codegen(options, url) {
-  const {
-    target: language,
-    output: outputFile,
-    testIdAttribute: testIdAttributeName
-  } = options;
-  const tracesDir = _path.default.join(_os.default.tmpdir(), `playwright-recorder-trace-${Date.now()}`);
-  const {
-    context,
-    launchOptions,
-    contextOptions
-  } = await launchContext(options, {
-    headless: !!process.env.PWTEST_CLI_HEADLESS,
-    executablePath: process.env.PWTEST_CLI_EXECUTABLE_PATH,
-    tracesDir
-  });
-  _utilsBundle.dotenv.config({
-    path: 'playwright.env'
-  });
-  await context._enableRecorder({
-    language,
-    launchOptions,
-    contextOptions,
-    device: options.device,
-    saveStorage: options.saveStorage,
-    mode: 'recording',
-    testIdAttributeName,
-    outputFile: outputFile ? _path.default.resolve(outputFile) : undefined,
-    handleSIGINT: false
-  });
-  await openPage(context, url);
-}
-async function waitForPage(page, captureOptions) {
-  if (captureOptions.waitForSelector) {
-    console.log(`Waiting for selector ${captureOptions.waitForSelector}...`);
-    await page.waitForSelector(captureOptions.waitForSelector);
-  }
-  if (captureOptions.waitForTimeout) {
-    console.log(`Waiting for timeout ${captureOptions.waitForTimeout}...`);
-    await page.waitForTimeout(parseInt(captureOptions.waitForTimeout, 10));
-  }
-}
-async function screenshot(options, captureOptions, url, path) {
-  const {
-    context
-  } = await launchContext(options, {
-    headless: true
-  });
-  console.log('Navigating to ' + url);
-  const page = await openPage(context, url);
-  await waitForPage(page, captureOptions);
-  console.log('Capturing screenshot into ' + path);
-  await page.screenshot({
-    path,
-    fullPage: !!captureOptions.fullPage
-  });
-  // launchContext takes care of closing the browser.
-  await page.close();
-}
-async function pdf(options, captureOptions, url, path) {
-  if (options.browser !== 'chromium') throw new Error('PDF creation is only working with Chromium');
-  const {
-    context
-  } = await launchContext({
-    ...options,
-    browser: 'chromium'
-  }, {
-    headless: true
-  });
-  console.log('Navigating to ' + url);
-  const page = await openPage(context, url);
-  await waitForPage(page, captureOptions);
-  console.log('Saving as pdf into ' + path);
-  await page.pdf({
-    path
-  });
-  // launchContext takes care of closing the browser.
-  await page.close();
-}
-function lookupBrowserType(options) {
-  let name = options.browser;
-  if (options.device) {
-    const device = playwright.devices[options.device];
-    name = device.defaultBrowserType;
-  }
-  let browserType;
-  switch (name) {
-    case 'chromium':
-      browserType = playwright.chromium;
-      break;
-    case 'webkit':
-      browserType = playwright.webkit;
-      break;
-    case 'firefox':
-      browserType = playwright.firefox;
-      break;
-    case 'cr':
-      browserType = playwright.chromium;
-      break;
-    case 'wk':
-      browserType = playwright.webkit;
-      break;
-    case 'ff':
-      browserType = playwright.firefox;
-      break;
-  }
-  if (browserType) return browserType;
-  _utilsBundle.program.help();
-}
-function validateOptions(options) {
-  if (options.device && !(options.device in playwright.devices)) {
-    const lines = [`Device descriptor not found: '${options.device}', available devices are:`];
-    for (const name in playwright.devices) lines.push(`  "${name}"`);
-    throw new Error(lines.join('\n'));
-  }
-  if (options.colorScheme && !['light', 'dark'].includes(options.colorScheme)) throw new Error('Invalid color scheme, should be one of "light", "dark"');
-}
-function logErrorAndExit(e) {
-  if (process.env.PWDEBUGIMPL) console.error(e);else console.error(e.name + ': ' + e.message);
-  (0, _utils.gracefullyProcessExitDoNotHang)(1);
-}
-function codegenId() {
-  return process.env.PW_LANG_NAME || 'playwright-test';
-}
-function commandWithOpenOptions(command, description, options) {
-  let result = _utilsBundle.program.command(command).description(description);
-  for (const option of options) result = result.option(option[0], ...option.slice(1));
-  return result.option('-b, --browser <browserType>', 'browser to use, one of cr, chromium, ff, firefox, wk, webkit', 'chromium').option('--block-service-workers', 'block service workers').option('--channel <channel>', 'Chromium distribution channel, "chrome", "chrome-beta", "msedge-dev", etc').option('--color-scheme <scheme>', 'emulate preferred color scheme, "light" or "dark"').option('--device <deviceName>', 'emulate device, for example  "iPhone 11"').option('--geolocation <coordinates>', 'specify geolocation coordinates, for example "37.819722,-122.478611"').option('--ignore-https-errors', 'ignore https errors').option('--load-storage <filename>', 'load context storage state from the file, previously saved with --save-storage').option('--lang <language>', 'specify language / locale, for example "en-GB"').option('--proxy-server <proxy>', 'specify proxy server, for example "http://myproxy:3128" or "socks5://myproxy:8080"').option('--proxy-bypass <bypass>', 'comma-separated domains to bypass proxy, for example ".com,chromium.org,.domain.com"').option('--save-har <filename>', 'save HAR file with all network activity at the end').option('--save-har-glob <glob pattern>', 'filter entries in the HAR by matching url against this glob pattern').option('--save-storage <filename>', 'save context storage state at the end, for later use with --load-storage').option('--timezone <time zone>', 'time zone to emulate, for example "Europe/Rome"').option('--timeout <timeout>', 'timeout for Playwright actions in milliseconds, no timeout by default').option('--user-agent <ua string>', 'specify user agent string').option('--viewport-size <size>', 'specify browser viewport size in pixels, for example "1280, 720"');
-}
-function buildBasePlaywrightCLICommand(cliTargetLang) {
-  switch (cliTargetLang) {
-    case 'python':
-      return `playwright`;
-    case 'java':
-      return `mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="...options.."`;
-    case 'csharp':
-      return `pwsh bin/Debug/netX/playwright.ps1`;
-    default:
-      {
-        const packageManagerCommand = (0, _utils.getPackageManagerExecCommand)();
-        return `${packageManagerCommand} playwright`;
-      }
-  }
-}

tvapp2/node_modules/playwright-core/lib/cli/programWithTestStub.js

@@ -1,68 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-Object.defineProperty(exports, "program", {
-  enumerable: true,
-  get: function () {
-    return _program.program;
-  }
-});
-var _processLauncher = require("../server/utils/processLauncher");
-var _utils = require("../utils");
-var _program = require("./program");
-/**
- * Copyright (c) Microsoft Corporation.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-/* eslint-disable no-console */
-
-function printPlaywrightTestError(command) {
-  const packages = [];
-  for (const pkg of ['playwright', 'playwright-chromium', 'playwright-firefox', 'playwright-webkit']) {
-    try {
-      require.resolve(pkg);
-      packages.push(pkg);
-    } catch (e) {}
-  }
-  if (!packages.length) packages.push('playwright');
-  const packageManager = (0, _utils.getPackageManager)();
-  if (packageManager === 'yarn') {
-    console.error(`Please install @playwright/test package before running "yarn playwright ${command}"`);
-    console.error(`  yarn remove ${packages.join(' ')}`);
-    console.error('  yarn add -D @playwright/test');
-  } else if (packageManager === 'pnpm') {
-    console.error(`Please install @playwright/test package before running "pnpm exec playwright ${command}"`);
-    console.error(`  pnpm remove ${packages.join(' ')}`);
-    console.error('  pnpm add -D @playwright/test');
-  } else {
-    console.error(`Please install @playwright/test package before running "npx playwright ${command}"`);
-    console.error(`  npm uninstall ${packages.join(' ')}`);
-    console.error('  npm install -D @playwright/test');
-  }
-}
-const kExternalPlaywrightTestCommands = [['test', 'Run tests with Playwright Test.'], ['show-report', 'Show Playwright Test HTML report.'], ['merge-reports', 'Merge Playwright Test Blob reports']];
-function addExternalPlaywrightTestCommands() {
-  for (const [command, description] of kExternalPlaywrightTestCommands) {
-    const playwrightTest = _program.program.command(command).allowUnknownOption(true);
-    playwrightTest.description(`${description} Available in @playwright/test package.`);
-    playwrightTest.action(async () => {
-      printPlaywrightTestError(command);
-      (0, _processLauncher.gracefullyProcessExitDoNotHang)(1);
-    });
-  }
-}
-if (!process.env.PW_LANG_NAME) addExternalPlaywrightTestCommands();

tvapp2/node_modules/playwright-core/lib/client/accessibility.js

@@ -1,50 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.Accessibility = void 0;
-/**
- * Copyright 2017 Google Inc. All rights reserved.
- * Modifications copyright (c) Microsoft Corporation.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-function axNodeFromProtocol(axNode) {
-  const result = {
-    ...axNode,
-    value: axNode.valueNumber !== undefined ? axNode.valueNumber : axNode.valueString,
-    checked: axNode.checked === 'checked' ? true : axNode.checked === 'unchecked' ? false : axNode.checked,
-    pressed: axNode.pressed === 'pressed' ? true : axNode.pressed === 'released' ? false : axNode.pressed,
-    children: axNode.children ? axNode.children.map(axNodeFromProtocol) : undefined
-  };
-  delete result.valueNumber;
-  delete result.valueString;
-  return result;
-}
-class Accessibility {
-  constructor(channel) {
-    this._channel = void 0;
-    this._channel = channel;
-  }
-  async snapshot(options = {}) {
-    const root = options.root ? options.root._elementChannel : undefined;
-    const result = await this._channel.accessibilitySnapshot({
-      interestingOnly: options.interestingOnly,
-      root
-    });
-    return result.rootAXNode ? axNodeFromProtocol(result.rootAXNode) : null;
-  }
-}
-exports.Accessibility = Accessibility;

tvapp2/node_modules/playwright-core/lib/client/android.js

@@ -1,452 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.AndroidWebView = exports.AndroidSocket = exports.AndroidInput = exports.AndroidDevice = exports.Android = void 0;
-var _eventEmitter = require("./eventEmitter");
-var _browserContext = require("./browserContext");
-var _channelOwner = require("./channelOwner");
-var _errors = require("./errors");
-var _events = require("./events");
-var _waiter = require("./waiter");
-var _timeoutSettings = require("./timeoutSettings");
-var _rtti = require("../utils/isomorphic/rtti");
-var _time = require("../utils/isomorphic/time");
-var _timeoutRunner = require("../utils/isomorphic/timeoutRunner");
-var _webSocket = require("./webSocket");
-/**
- * Copyright (c) Microsoft Corporation.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-class Android extends _channelOwner.ChannelOwner {
-  static from(android) {
-    return android._object;
-  }
-  constructor(parent, type, guid, initializer) {
-    super(parent, type, guid, initializer);
-    this._timeoutSettings = void 0;
-    this._serverLauncher = void 0;
-    this._timeoutSettings = new _timeoutSettings.TimeoutSettings(this._platform);
-  }
-  setDefaultTimeout(timeout) {
-    this._timeoutSettings.setDefaultTimeout(timeout);
-    this._wrapApiCall(async () => {
-      await this._channel.setDefaultTimeoutNoReply({
-        timeout
-      });
-    }, true).catch(() => {});
-  }
-  async devices(options = {}) {
-    const {
-      devices
-    } = await this._channel.devices(options);
-    return devices.map(d => AndroidDevice.from(d));
-  }
-  async launchServer(options = {}) {
-    if (!this._serverLauncher) throw new Error('Launching server is not supported');
-    return await this._serverLauncher.launchServer(options);
-  }
-  async connect(wsEndpoint, options = {}) {
-    return await this._wrapApiCall(async () => {
-      const deadline = options.timeout ? (0, _time.monotonicTime)() + options.timeout : 0;
-      const headers = {
-        'x-playwright-browser': 'android',
-        ...options.headers
-      };
-      const connectParams = {
-        wsEndpoint,
-        headers,
-        slowMo: options.slowMo,
-        timeout: options.timeout
-      };
-      const connection = await (0, _webSocket.connectOverWebSocket)(this._connection, connectParams);
-      let device;
-      connection.on('close', () => {
-        var _device;
-        (_device = device) === null || _device === void 0 || _device._didClose();
-      });
-      const result = await (0, _timeoutRunner.raceAgainstDeadline)(async () => {
-        const playwright = await connection.initializePlaywright();
-        if (!playwright._initializer.preConnectedAndroidDevice) {
-          connection.close();
-          throw new Error('Malformed endpoint. Did you use Android.launchServer method?');
-        }
-        device = AndroidDevice.from(playwright._initializer.preConnectedAndroidDevice);
-        device._shouldCloseConnectionOnClose = true;
-        device.on(_events.Events.AndroidDevice.Close, () => connection.close());
-        return device;
-      }, deadline);
-      if (!result.timedOut) {
-        return result.result;
-      } else {
-        connection.close();
-        throw new Error(`Timeout ${options.timeout}ms exceeded`);
-      }
-    });
-  }
-}
-exports.Android = Android;
-class AndroidDevice extends _channelOwner.ChannelOwner {
-  static from(androidDevice) {
-    return androidDevice._object;
-  }
-  constructor(parent, type, guid, initializer) {
-    super(parent, type, guid, initializer);
-    this._timeoutSettings = void 0;
-    this._webViews = new Map();
-    this._shouldCloseConnectionOnClose = false;
-    this.input = void 0;
-    this.input = new AndroidInput(this);
-    this._timeoutSettings = new _timeoutSettings.TimeoutSettings(this._platform, parent._timeoutSettings);
-    this._channel.on('webViewAdded', ({
-      webView
-    }) => this._onWebViewAdded(webView));
-    this._channel.on('webViewRemoved', ({
-      socketName
-    }) => this._onWebViewRemoved(socketName));
-    this._channel.on('close', () => this._didClose());
-  }
-  _onWebViewAdded(webView) {
-    const view = new AndroidWebView(this, webView);
-    this._webViews.set(webView.socketName, view);
-    this.emit(_events.Events.AndroidDevice.WebView, view);
-  }
-  _onWebViewRemoved(socketName) {
-    const view = this._webViews.get(socketName);
-    this._webViews.delete(socketName);
-    if (view) view.emit(_events.Events.AndroidWebView.Close);
-  }
-  setDefaultTimeout(timeout) {
-    this._timeoutSettings.setDefaultTimeout(timeout);
-    this._wrapApiCall(async () => {
-      await this._channel.setDefaultTimeoutNoReply({
-        timeout
-      });
-    }, true).catch(() => {});
-  }
-  serial() {
-    return this._initializer.serial;
-  }
-  model() {
-    return this._initializer.model;
-  }
-  webViews() {
-    return [...this._webViews.values()];
-  }
-  async webView(selector, options) {
-    const predicate = v => {
-      if (selector.pkg) return v.pkg() === selector.pkg;
-      if (selector.socketName) return v._socketName() === selector.socketName;
-      return false;
-    };
-    const webView = [...this._webViews.values()].find(predicate);
-    if (webView) return webView;
-    return await this.waitForEvent('webview', {
-      ...options,
-      predicate
-    });
-  }
-  async wait(selector, options) {
-    await this._channel.wait({
-      selector: toSelectorChannel(selector),
-      ...options
-    });
-  }
-  async fill(selector, text, options) {
-    await this._channel.fill({
-      selector: toSelectorChannel(selector),
-      text,
-      ...options
-    });
-  }
-  async press(selector, key, options) {
-    await this.tap(selector, options);
-    await this.input.press(key);
-  }
-  async tap(selector, options) {
-    await this._channel.tap({
-      selector: toSelectorChannel(selector),
-      ...options
-    });
-  }
-  async drag(selector, dest, options) {
-    await this._channel.drag({
-      selector: toSelectorChannel(selector),
-      dest,
-      ...options
-    });
-  }
-  async fling(selector, direction, options) {
-    await this._channel.fling({
-      selector: toSelectorChannel(selector),
-      direction,
-      ...options
-    });
-  }
-  async longTap(selector, options) {
-    await this._channel.longTap({
-      selector: toSelectorChannel(selector),
-      ...options
-    });
-  }
-  async pinchClose(selector, percent, options) {
-    await this._channel.pinchClose({
-      selector: toSelectorChannel(selector),
-      percent,
-      ...options
-    });
-  }
-  async pinchOpen(selector, percent, options) {
-    await this._channel.pinchOpen({
-      selector: toSelectorChannel(selector),
-      percent,
-      ...options
-    });
-  }
-  async scroll(selector, direction, percent, options) {
-    await this._channel.scroll({
-      selector: toSelectorChannel(selector),
-      direction,
-      percent,
-      ...options
-    });
-  }
-  async swipe(selector, direction, percent, options) {
-    await this._channel.swipe({
-      selector: toSelectorChannel(selector),
-      direction,
-      percent,
-      ...options
-    });
-  }
-  async info(selector) {
-    return (await this._channel.info({
-      selector: toSelectorChannel(selector)
-    })).info;
-  }
-  async screenshot(options = {}) {
-    const {
-      binary
-    } = await this._channel.screenshot();
-    if (options.path) await this._platform.fs().promises.writeFile(options.path, binary);
-    return binary;
-  }
-  async [Symbol.asyncDispose]() {
-    await this.close();
-  }
-  async close() {
-    try {
-      if (this._shouldCloseConnectionOnClose) this._connection.close();else await this._channel.close();
-    } catch (e) {
-      if ((0, _errors.isTargetClosedError)(e)) return;
-      throw e;
-    }
-  }
-  _didClose() {
-    this.emit(_events.Events.AndroidDevice.Close, this);
-  }
-  async shell(command) {
-    const {
-      result
-    } = await this._channel.shell({
-      command
-    });
-    return result;
-  }
-  async open(command) {
-    return AndroidSocket.from((await this._channel.open({
-      command
-    })).socket);
-  }
-  async installApk(file, options) {
-    await this._channel.installApk({
-      file: await loadFile(this._platform, file),
-      args: options && options.args
-    });
-  }
-  async push(file, path, options) {
-    await this._channel.push({
-      file: await loadFile(this._platform, file),
-      path,
-      mode: options ? options.mode : undefined
-    });
-  }
-  async launchBrowser(options = {}) {
-    const contextOptions = await (0, _browserContext.prepareBrowserContextParams)(this._platform, options);
-    const result = await this._channel.launchBrowser(contextOptions);
-    const context = _browserContext.BrowserContext.from(result.context);
-    context._setOptions(contextOptions, {});
-    return context;
-  }
-  async waitForEvent(event, optionsOrPredicate = {}) {
-    return await this._wrapApiCall(async () => {
-      const timeout = this._timeoutSettings.timeout(typeof optionsOrPredicate === 'function' ? {} : optionsOrPredicate);
-      const predicate = typeof optionsOrPredicate === 'function' ? optionsOrPredicate : optionsOrPredicate.predicate;
-      const waiter = _waiter.Waiter.createForEvent(this, event);
-      waiter.rejectOnTimeout(timeout, `Timeout ${timeout}ms exceeded while waiting for event "${event}"`);
-      if (event !== _events.Events.AndroidDevice.Close) waiter.rejectOnEvent(this, _events.Events.AndroidDevice.Close, () => new _errors.TargetClosedError());
-      const result = await waiter.waitForEvent(this, event, predicate);
-      waiter.dispose();
-      return result;
-    });
-  }
-}
-exports.AndroidDevice = AndroidDevice;
-class AndroidSocket extends _channelOwner.ChannelOwner {
-  static from(androidDevice) {
-    return androidDevice._object;
-  }
-  constructor(parent, type, guid, initializer) {
-    super(parent, type, guid, initializer);
-    this._channel.on('data', ({
-      data
-    }) => this.emit(_events.Events.AndroidSocket.Data, data));
-    this._channel.on('close', () => this.emit(_events.Events.AndroidSocket.Close));
-  }
-  async write(data) {
-    await this._channel.write({
-      data
-    });
-  }
-  async close() {
-    await this._channel.close();
-  }
-  async [Symbol.asyncDispose]() {
-    await this.close();
-  }
-}
-exports.AndroidSocket = AndroidSocket;
-async function loadFile(platform, file) {
-  if ((0, _rtti.isString)(file)) return await platform.fs().promises.readFile(file);
-  return file;
-}
-class AndroidInput {
-  constructor(device) {
-    this._device = void 0;
-    this._device = device;
-  }
-  async type(text) {
-    await this._device._channel.inputType({
-      text
-    });
-  }
-  async press(key) {
-    await this._device._channel.inputPress({
-      key
-    });
-  }
-  async tap(point) {
-    await this._device._channel.inputTap({
-      point
-    });
-  }
-  async swipe(from, segments, steps) {
-    await this._device._channel.inputSwipe({
-      segments,
-      steps
-    });
-  }
-  async drag(from, to, steps) {
-    await this._device._channel.inputDrag({
-      from,
-      to,
-      steps
-    });
-  }
-}
-exports.AndroidInput = AndroidInput;
-function toSelectorChannel(selector) {
-  const {
-    checkable,
-    checked,
-    clazz,
-    clickable,
-    depth,
-    desc,
-    enabled,
-    focusable,
-    focused,
-    hasChild,
-    hasDescendant,
-    longClickable,
-    pkg,
-    res,
-    scrollable,
-    selected,
-    text
-  } = selector;
-  const toRegex = value => {
-    if (value === undefined) return undefined;
-    if ((0, _rtti.isRegExp)(value)) return value.source;
-    return '^' + value.replace(/[|\\{}()[\]^$+*?.]/g, '\\$&').replace(/-/g, '\\x2d') + '$';
-  };
-  return {
-    checkable,
-    checked,
-    clazz: toRegex(clazz),
-    pkg: toRegex(pkg),
-    desc: toRegex(desc),
-    res: toRegex(res),
-    text: toRegex(text),
-    clickable,
-    depth,
-    enabled,
-    focusable,
-    focused,
-    hasChild: hasChild ? {
-      selector: toSelectorChannel(hasChild.selector)
-    } : undefined,
-    hasDescendant: hasDescendant ? {
-      selector: toSelectorChannel(hasDescendant.selector),
-      maxDepth: hasDescendant.maxDepth
-    } : undefined,
-    longClickable,
-    scrollable,
-    selected
-  };
-}
-class AndroidWebView extends _eventEmitter.EventEmitter {
-  constructor(device, data) {
-    super(device._platform);
-    this._device = void 0;
-    this._data = void 0;
-    this._pagePromise = void 0;
-    this._device = device;
-    this._data = data;
-  }
-  pid() {
-    return this._data.pid;
-  }
-  pkg() {
-    return this._data.pkg;
-  }
-  _socketName() {
-    return this._data.socketName;
-  }
-  async page() {
-    if (!this._pagePromise) this._pagePromise = this._fetchPage();
-    return await this._pagePromise;
-  }
-  async _fetchPage() {
-    const {
-      context
-    } = await this._device._channel.connectToWebView({
-      socketName: this._data.socketName
-    });
-    return _browserContext.BrowserContext.from(context).pages()[0];
-  }
-}
-exports.AndroidWebView = AndroidWebView;

tvapp2/node_modules/playwright-core/lib/client/api.js

@@ -1,285 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-Object.defineProperty(exports, "APIRequest", {
-  enumerable: true,
-  get: function () {
-    return _fetch.APIRequest;
-  }
-});
-Object.defineProperty(exports, "APIRequestContext", {
-  enumerable: true,
-  get: function () {
-    return _fetch.APIRequestContext;
-  }
-});
-Object.defineProperty(exports, "APIResponse", {
-  enumerable: true,
-  get: function () {
-    return _fetch.APIResponse;
-  }
-});
-Object.defineProperty(exports, "Accessibility", {
-  enumerable: true,
-  get: function () {
-    return _accessibility.Accessibility;
-  }
-});
-Object.defineProperty(exports, "Android", {
-  enumerable: true,
-  get: function () {
-    return _android.Android;
-  }
-});
-Object.defineProperty(exports, "AndroidDevice", {
-  enumerable: true,
-  get: function () {
-    return _android.AndroidDevice;
-  }
-});
-Object.defineProperty(exports, "AndroidInput", {
-  enumerable: true,
-  get: function () {
-    return _android.AndroidInput;
-  }
-});
-Object.defineProperty(exports, "AndroidSocket", {
-  enumerable: true,
-  get: function () {
-    return _android.AndroidSocket;
-  }
-});
-Object.defineProperty(exports, "AndroidWebView", {
-  enumerable: true,
-  get: function () {
-    return _android.AndroidWebView;
-  }
-});
-Object.defineProperty(exports, "Browser", {
-  enumerable: true,
-  get: function () {
-    return _browser.Browser;
-  }
-});
-Object.defineProperty(exports, "BrowserContext", {
-  enumerable: true,
-  get: function () {
-    return _browserContext.BrowserContext;
-  }
-});
-Object.defineProperty(exports, "BrowserType", {
-  enumerable: true,
-  get: function () {
-    return _browserType.BrowserType;
-  }
-});
-Object.defineProperty(exports, "CDPSession", {
-  enumerable: true,
-  get: function () {
-    return _cdpSession.CDPSession;
-  }
-});
-Object.defineProperty(exports, "Clock", {
-  enumerable: true,
-  get: function () {
-    return _clock.Clock;
-  }
-});
-Object.defineProperty(exports, "ConsoleMessage", {
-  enumerable: true,
-  get: function () {
-    return _consoleMessage.ConsoleMessage;
-  }
-});
-Object.defineProperty(exports, "Coverage", {
-  enumerable: true,
-  get: function () {
-    return _coverage.Coverage;
-  }
-});
-Object.defineProperty(exports, "Dialog", {
-  enumerable: true,
-  get: function () {
-    return _dialog.Dialog;
-  }
-});
-Object.defineProperty(exports, "Download", {
-  enumerable: true,
-  get: function () {
-    return _download.Download;
-  }
-});
-Object.defineProperty(exports, "Electron", {
-  enumerable: true,
-  get: function () {
-    return _electron.Electron;
-  }
-});
-Object.defineProperty(exports, "ElectronApplication", {
-  enumerable: true,
-  get: function () {
-    return _electron.ElectronApplication;
-  }
-});
-Object.defineProperty(exports, "ElementHandle", {
-  enumerable: true,
-  get: function () {
-    return _elementHandle.ElementHandle;
-  }
-});
-Object.defineProperty(exports, "FileChooser", {
-  enumerable: true,
-  get: function () {
-    return _fileChooser.FileChooser;
-  }
-});
-Object.defineProperty(exports, "Frame", {
-  enumerable: true,
-  get: function () {
-    return _frame.Frame;
-  }
-});
-Object.defineProperty(exports, "FrameLocator", {
-  enumerable: true,
-  get: function () {
-    return _locator.FrameLocator;
-  }
-});
-Object.defineProperty(exports, "JSHandle", {
-  enumerable: true,
-  get: function () {
-    return _jsHandle.JSHandle;
-  }
-});
-Object.defineProperty(exports, "Keyboard", {
-  enumerable: true,
-  get: function () {
-    return _input.Keyboard;
-  }
-});
-Object.defineProperty(exports, "Locator", {
-  enumerable: true,
-  get: function () {
-    return _locator.Locator;
-  }
-});
-Object.defineProperty(exports, "Mouse", {
-  enumerable: true,
-  get: function () {
-    return _input.Mouse;
-  }
-});
-Object.defineProperty(exports, "Page", {
-  enumerable: true,
-  get: function () {
-    return _page.Page;
-  }
-});
-Object.defineProperty(exports, "Playwright", {
-  enumerable: true,
-  get: function () {
-    return _playwright.Playwright;
-  }
-});
-Object.defineProperty(exports, "Request", {
-  enumerable: true,
-  get: function () {
-    return _network.Request;
-  }
-});
-Object.defineProperty(exports, "Response", {
-  enumerable: true,
-  get: function () {
-    return _network.Response;
-  }
-});
-Object.defineProperty(exports, "Route", {
-  enumerable: true,
-  get: function () {
-    return _network.Route;
-  }
-});
-Object.defineProperty(exports, "Selectors", {
-  enumerable: true,
-  get: function () {
-    return _selectors.Selectors;
-  }
-});
-Object.defineProperty(exports, "TimeoutError", {
-  enumerable: true,
-  get: function () {
-    return _errors.TimeoutError;
-  }
-});
-Object.defineProperty(exports, "Touchscreen", {
-  enumerable: true,
-  get: function () {
-    return _input.Touchscreen;
-  }
-});
-Object.defineProperty(exports, "Tracing", {
-  enumerable: true,
-  get: function () {
-    return _tracing.Tracing;
-  }
-});
-Object.defineProperty(exports, "Video", {
-  enumerable: true,
-  get: function () {
-    return _video.Video;
-  }
-});
-Object.defineProperty(exports, "WebError", {
-  enumerable: true,
-  get: function () {
-    return _webError.WebError;
-  }
-});
-Object.defineProperty(exports, "WebSocket", {
-  enumerable: true,
-  get: function () {
-    return _network.WebSocket;
-  }
-});
-Object.defineProperty(exports, "WebSocketRoute", {
-  enumerable: true,
-  get: function () {
-    return _network.WebSocketRoute;
-  }
-});
-Object.defineProperty(exports, "Worker", {
-  enumerable: true,
-  get: function () {
-    return _worker.Worker;
-  }
-});
-var _accessibility = require("./accessibility");
-var _android = require("./android");
-var _browser = require("./browser");
-var _browserContext = require("./browserContext");
-var _browserType = require("./browserType");
-var _clock = require("./clock");
-var _consoleMessage = require("./consoleMessage");
-var _coverage = require("./coverage");
-var _dialog = require("./dialog");
-var _download = require("./download");
-var _electron = require("./electron");
-var _locator = require("./locator");
-var _elementHandle = require("./elementHandle");
-var _fileChooser = require("./fileChooser");
-var _errors = require("./errors");
-var _frame = require("./frame");
-var _input = require("./input");
-var _jsHandle = require("./jsHandle");
-var _network = require("./network");
-var _fetch = require("./fetch");
-var _page = require("./page");
-var _selectors = require("./selectors");
-var _tracing = require("./tracing");
-var _video = require("./video");
-var _worker = require("./worker");
-var _cdpSession = require("./cdpSession");
-var _playwright = require("./playwright");
-var _webError = require("./webError");

tvapp2/node_modules/playwright-core/lib/client/artifact.js

@@ -1,76 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.Artifact = void 0;
-var _channelOwner = require("./channelOwner");
-var _stream = require("./stream");
-var _fileUtils = require("./fileUtils");
-/**
- * Copyright (c) Microsoft Corporation.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-class Artifact extends _channelOwner.ChannelOwner {
-  static from(channel) {
-    return channel._object;
-  }
-  async pathAfterFinished() {
-    if (this._connection.isRemote()) throw new Error(`Path is not available when connecting remotely. Use saveAs() to save a local copy.`);
-    return (await this._channel.pathAfterFinished()).value;
-  }
-  async saveAs(path) {
-    if (!this._connection.isRemote()) {
-      await this._channel.saveAs({
-        path
-      });
-      return;
-    }
-    const result = await this._channel.saveAsStream();
-    const stream = _stream.Stream.from(result.stream);
-    await (0, _fileUtils.mkdirIfNeeded)(this._platform, path);
-    await new Promise((resolve, reject) => {
-      stream.stream().pipe(this._platform.fs().createWriteStream(path)).on('finish', resolve).on('error', reject);
-    });
-  }
-  async failure() {
-    return (await this._channel.failure()).error || null;
-  }
-  async createReadStream() {
-    const result = await this._channel.stream();
-    const stream = _stream.Stream.from(result.stream);
-    return stream.stream();
-  }
-  async readIntoBuffer() {
-    const stream = await this.createReadStream();
-    return await new Promise((resolve, reject) => {
-      const chunks = [];
-      stream.on('data', chunk => {
-        chunks.push(chunk);
-      });
-      stream.on('end', () => {
-        resolve(Buffer.concat(chunks));
-      });
-      stream.on('error', reject);
-    });
-  }
-  async cancel() {
-    return await this._channel.cancel();
-  }
-  async delete() {
-    return await this._channel.delete();
-  }
-}
-exports.Artifact = Artifact;

tvapp2/node_modules/playwright-core/lib/client/browser.js

@@ -1,140 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.Browser = void 0;
-var _artifact = require("./artifact");
-var _browserContext = require("./browserContext");
-var _cdpSession = require("./cdpSession");
-var _channelOwner = require("./channelOwner");
-var _errors = require("./errors");
-var _events = require("./events");
-var _fileUtils = require("./fileUtils");
-/**
- * Copyright (c) Microsoft Corporation.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-class Browser extends _channelOwner.ChannelOwner {
-  static from(browser) {
-    return browser._object;
-  }
-  constructor(parent, type, guid, initializer) {
-    super(parent, type, guid, initializer);
-    this._contexts = new Set();
-    this._isConnected = true;
-    this._closedPromise = void 0;
-    this._shouldCloseConnectionOnClose = false;
-    this._browserType = void 0;
-    this._options = {};
-    this._name = void 0;
-    this._path = void 0;
-    this._closeReason = void 0;
-    this._name = initializer.name;
-    this._channel.on('close', () => this._didClose());
-    this._closedPromise = new Promise(f => this.once(_events.Events.Browser.Disconnected, f));
-  }
-  browserType() {
-    return this._browserType;
-  }
-  async newContext(options = {}) {
-    return await this._innerNewContext(options, false);
-  }
-  async _newContextForReuse(options = {}) {
-    return await this._wrapApiCall(async () => {
-      for (const context of this._contexts) {
-        await this._browserType._willCloseContext(context);
-        for (const page of context.pages()) page._onClose();
-        context._onClose();
-      }
-      return await this._innerNewContext(options, true);
-    }, true);
-  }
-  async _stopPendingOperations(reason) {
-    return await this._wrapApiCall(async () => {
-      await this._channel.stopPendingOperations({
-        reason
-      });
-    }, true);
-  }
-  async _innerNewContext(options = {}, forReuse) {
-    options = {
-      ...this._browserType._playwright._defaultContextOptions,
-      ...options
-    };
-    const contextOptions = await (0, _browserContext.prepareBrowserContextParams)(this._platform, options);
-    const response = forReuse ? await this._channel.newContextForReuse(contextOptions) : await this._channel.newContext(contextOptions);
-    const context = _browserContext.BrowserContext.from(response.context);
-    await this._browserType._didCreateContext(context, contextOptions, this._options, options.logger || this._logger);
-    return context;
-  }
-  contexts() {
-    return [...this._contexts];
-  }
-  version() {
-    return this._initializer.version;
-  }
-  async newPage(options = {}) {
-    return await this._wrapApiCall(async () => {
-      const context = await this.newContext(options);
-      const page = await context.newPage();
-      page._ownedContext = context;
-      context._ownerPage = page;
-      return page;
-    });
-  }
-  isConnected() {
-    return this._isConnected;
-  }
-  async newBrowserCDPSession() {
-    return _cdpSession.CDPSession.from((await this._channel.newBrowserCDPSession()).session);
-  }
-  async startTracing(page, options = {}) {
-    this._path = options.path;
-    await this._channel.startTracing({
-      ...options,
-      page: page ? page._channel : undefined
-    });
-  }
-  async stopTracing() {
-    const artifact = _artifact.Artifact.from((await this._channel.stopTracing()).artifact);
-    const buffer = await artifact.readIntoBuffer();
-    await artifact.delete();
-    if (this._path) {
-      await (0, _fileUtils.mkdirIfNeeded)(this._platform, this._path);
-      await this._platform.fs().promises.writeFile(this._path, buffer);
-      this._path = undefined;
-    }
-    return buffer;
-  }
-  async [Symbol.asyncDispose]() {
-    await this.close();
-  }
-  async close(options = {}) {
-    this._closeReason = options.reason;
-    try {
-      if (this._shouldCloseConnectionOnClose) this._connection.close();else await this._channel.close(options);
-      await this._closedPromise;
-    } catch (e) {
-      if ((0, _errors.isTargetClosedError)(e)) return;
-      throw e;
-    }
-  }
-  _didClose() {
-    this._isConnected = false;
-    this.emit(_events.Events.Browser.Disconnected, this);
-  }
-}
-exports.Browser = Browser;

tvapp2/node_modules/playwright-core/lib/client/browserContext.js

@@ -1,566 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.BrowserContext = void 0;
-exports.prepareBrowserContextParams = prepareBrowserContextParams;
-exports.toClientCertificatesProtocol = toClientCertificatesProtocol;
-var _artifact = require("./artifact");
-var _browser = require("./browser");
-var _cdpSession = require("./cdpSession");
-var _channelOwner = require("./channelOwner");
-var _clientHelper = require("./clientHelper");
-var _clock = require("./clock");
-var _consoleMessage = require("./consoleMessage");
-var _dialog = require("./dialog");
-var _errors = require("./errors");
-var _events = require("./events");
-var _fetch = require("./fetch");
-var _frame = require("./frame");
-var _harRouter = require("./harRouter");
-var network = _interopRequireWildcard(require("./network"));
-var _page = require("./page");
-var _tracing = require("./tracing");
-var _waiter = require("./waiter");
-var _webError = require("./webError");
-var _worker = require("./worker");
-var _timeoutSettings = require("./timeoutSettings");
-var _fileUtils = require("./fileUtils");
-var _headers = require("../utils/isomorphic/headers");
-var _urlMatch = require("../utils/isomorphic/urlMatch");
-var _rtti = require("../utils/isomorphic/rtti");
-var _stackTrace = require("../utils/isomorphic/stackTrace");
-function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
-function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
-/**
- * Copyright 2017 Google Inc. All rights reserved.
- * Modifications copyright (c) Microsoft Corporation.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-class BrowserContext extends _channelOwner.ChannelOwner {
-  static from(context) {
-    return context._object;
-  }
-  static fromNullable(context) {
-    return context ? BrowserContext.from(context) : null;
-  }
-  constructor(parent, type, guid, initializer) {
-    var _this$_browser, _this$_browser2;
-    super(parent, type, guid, initializer);
-    this._pages = new Set();
-    this._routes = [];
-    this._webSocketRoutes = [];
-    this._browser = null;
-    this._browserType = void 0;
-    this._bindings = new Map();
-    this._timeoutSettings = void 0;
-    this._ownerPage = void 0;
-    this._closedPromise = void 0;
-    this._options = {};
-    this.request = void 0;
-    this.tracing = void 0;
-    this.clock = void 0;
-    this._backgroundPages = new Set();
-    this._serviceWorkers = new Set();
-    this._isChromium = void 0;
-    this._harRecorders = new Map();
-    this._closeWasCalled = false;
-    this._closeReason = void 0;
-    this._harRouters = [];
-    this._timeoutSettings = new _timeoutSettings.TimeoutSettings(this._platform);
-    if (parent instanceof _browser.Browser) this._browser = parent;
-    (_this$_browser = this._browser) === null || _this$_browser === void 0 || _this$_browser._contexts.add(this);
-    this._isChromium = ((_this$_browser2 = this._browser) === null || _this$_browser2 === void 0 ? void 0 : _this$_browser2._name) === 'chromium';
-    this.tracing = _tracing.Tracing.from(initializer.tracing);
-    this.request = _fetch.APIRequestContext.from(initializer.requestContext);
-    this.clock = new _clock.Clock(this);
-    this._channel.on('bindingCall', ({
-      binding
-    }) => this._onBinding(_page.BindingCall.from(binding)));
-    this._channel.on('close', () => this._onClose());
-    this._channel.on('page', ({
-      page
-    }) => this._onPage(_page.Page.from(page)));
-    this._channel.on('route', ({
-      route
-    }) => this._onRoute(network.Route.from(route)));
-    this._channel.on('webSocketRoute', ({
-      webSocketRoute
-    }) => this._onWebSocketRoute(network.WebSocketRoute.from(webSocketRoute)));
-    this._channel.on('backgroundPage', ({
-      page
-    }) => {
-      const backgroundPage = _page.Page.from(page);
-      this._backgroundPages.add(backgroundPage);
-      this.emit(_events.Events.BrowserContext.BackgroundPage, backgroundPage);
-    });
-    this._channel.on('serviceWorker', ({
-      worker
-    }) => {
-      const serviceWorker = _worker.Worker.from(worker);
-      serviceWorker._context = this;
-      this._serviceWorkers.add(serviceWorker);
-      this.emit(_events.Events.BrowserContext.ServiceWorker, serviceWorker);
-    });
-    this._channel.on('console', event => {
-      const consoleMessage = new _consoleMessage.ConsoleMessage(this._platform, event);
-      this.emit(_events.Events.BrowserContext.Console, consoleMessage);
-      const page = consoleMessage.page();
-      if (page) page.emit(_events.Events.Page.Console, consoleMessage);
-    });
-    this._channel.on('pageError', ({
-      error,
-      page
-    }) => {
-      const pageObject = _page.Page.from(page);
-      const parsedError = (0, _errors.parseError)(error);
-      this.emit(_events.Events.BrowserContext.WebError, new _webError.WebError(pageObject, parsedError));
-      if (pageObject) pageObject.emit(_events.Events.Page.PageError, parsedError);
-    });
-    this._channel.on('dialog', ({
-      dialog
-    }) => {
-      const dialogObject = _dialog.Dialog.from(dialog);
-      let hasListeners = this.emit(_events.Events.BrowserContext.Dialog, dialogObject);
-      const page = dialogObject.page();
-      if (page) hasListeners = page.emit(_events.Events.Page.Dialog, dialogObject) || hasListeners;
-      if (!hasListeners) {
-        // Although we do similar handling on the server side, we still need this logic
-        // on the client side due to a possible race condition between two async calls:
-        // a) removing "dialog" listener subscription (client->server)
-        // b) actual "dialog" event (server->client)
-        if (dialogObject.type() === 'beforeunload') dialog.accept({}).catch(() => {});else dialog.dismiss().catch(() => {});
-      }
-    });
-    this._channel.on('request', ({
-      request,
-      page
-    }) => this._onRequest(network.Request.from(request), _page.Page.fromNullable(page)));
-    this._channel.on('requestFailed', ({
-      request,
-      failureText,
-      responseEndTiming,
-      page
-    }) => this._onRequestFailed(network.Request.from(request), responseEndTiming, failureText, _page.Page.fromNullable(page)));
-    this._channel.on('requestFinished', params => this._onRequestFinished(params));
-    this._channel.on('response', ({
-      response,
-      page
-    }) => this._onResponse(network.Response.from(response), _page.Page.fromNullable(page)));
-    this._closedPromise = new Promise(f => this.once(_events.Events.BrowserContext.Close, f));
-    this._setEventToSubscriptionMapping(new Map([[_events.Events.BrowserContext.Console, 'console'], [_events.Events.BrowserContext.Dialog, 'dialog'], [_events.Events.BrowserContext.Request, 'request'], [_events.Events.BrowserContext.Response, 'response'], [_events.Events.BrowserContext.RequestFinished, 'requestFinished'], [_events.Events.BrowserContext.RequestFailed, 'requestFailed']]));
-  }
-  _setOptions(contextOptions, browserOptions) {
-    this._options = contextOptions;
-    if (this._options.recordHar) this._harRecorders.set('', {
-      path: this._options.recordHar.path,
-      content: this._options.recordHar.content
-    });
-    this.tracing._tracesDir = browserOptions.tracesDir;
-  }
-  _onPage(page) {
-    this._pages.add(page);
-    this.emit(_events.Events.BrowserContext.Page, page);
-    if (page._opener && !page._opener.isClosed()) page._opener.emit(_events.Events.Page.Popup, page);
-  }
-  _onRequest(request, page) {
-    this.emit(_events.Events.BrowserContext.Request, request);
-    if (page) page.emit(_events.Events.Page.Request, request);
-  }
-  _onResponse(response, page) {
-    this.emit(_events.Events.BrowserContext.Response, response);
-    if (page) page.emit(_events.Events.Page.Response, response);
-  }
-  _onRequestFailed(request, responseEndTiming, failureText, page) {
-    request._failureText = failureText || null;
-    request._setResponseEndTiming(responseEndTiming);
-    this.emit(_events.Events.BrowserContext.RequestFailed, request);
-    if (page) page.emit(_events.Events.Page.RequestFailed, request);
-  }
-  _onRequestFinished(params) {
-    const {
-      responseEndTiming
-    } = params;
-    const request = network.Request.from(params.request);
-    const response = network.Response.fromNullable(params.response);
-    const page = _page.Page.fromNullable(params.page);
-    request._setResponseEndTiming(responseEndTiming);
-    this.emit(_events.Events.BrowserContext.RequestFinished, request);
-    if (page) page.emit(_events.Events.Page.RequestFinished, request);
-    if (response) response._finishedPromise.resolve(null);
-  }
-  async _onRoute(route) {
-    route._context = this;
-    const page = route.request()._safePage();
-    const routeHandlers = this._routes.slice();
-    for (const routeHandler of routeHandlers) {
-      // If the page or the context was closed we stall all requests right away.
-      if (page !== null && page !== void 0 && page._closeWasCalled || this._closeWasCalled) return;
-      if (!routeHandler.matches(route.request().url())) continue;
-      const index = this._routes.indexOf(routeHandler);
-      if (index === -1) continue;
-      if (routeHandler.willExpire()) this._routes.splice(index, 1);
-      const handled = await routeHandler.handle(route);
-      if (!this._routes.length) this._wrapApiCall(() => this._updateInterceptionPatterns(), true).catch(() => {});
-      if (handled) return;
-    }
-    // If the page is closed or unrouteAll() was called without waiting and interception disabled,
-    // the method will throw an error - silence it.
-    await route._innerContinue(true /* isFallback */).catch(() => {});
-  }
-  async _onWebSocketRoute(webSocketRoute) {
-    const routeHandler = this._webSocketRoutes.find(route => route.matches(webSocketRoute.url()));
-    if (routeHandler) await routeHandler.handle(webSocketRoute);else webSocketRoute.connectToServer();
-  }
-  async _onBinding(bindingCall) {
-    const func = this._bindings.get(bindingCall._initializer.name);
-    if (!func) return;
-    await bindingCall.call(func);
-  }
-  setDefaultNavigationTimeout(timeout) {
-    this._timeoutSettings.setDefaultNavigationTimeout(timeout);
-    this._wrapApiCall(async () => {
-      await this._channel.setDefaultNavigationTimeoutNoReply({
-        timeout
-      });
-    }, true).catch(() => {});
-  }
-  setDefaultTimeout(timeout) {
-    this._timeoutSettings.setDefaultTimeout(timeout);
-    this._wrapApiCall(async () => {
-      await this._channel.setDefaultTimeoutNoReply({
-        timeout
-      });
-    }, true).catch(() => {});
-  }
-  browser() {
-    return this._browser;
-  }
-  pages() {
-    return [...this._pages];
-  }
-  async newPage() {
-    if (this._ownerPage) throw new Error('Please use browser.newContext()');
-    return _page.Page.from((await this._channel.newPage()).page);
-  }
-  async cookies(urls) {
-    if (!urls) urls = [];
-    if (urls && typeof urls === 'string') urls = [urls];
-    return (await this._channel.cookies({
-      urls: urls
-    })).cookies;
-  }
-  async addCookies(cookies) {
-    await this._channel.addCookies({
-      cookies
-    });
-  }
-  async clearCookies(options = {}) {
-    await this._channel.clearCookies({
-      name: (0, _rtti.isString)(options.name) ? options.name : undefined,
-      nameRegexSource: (0, _rtti.isRegExp)(options.name) ? options.name.source : undefined,
-      nameRegexFlags: (0, _rtti.isRegExp)(options.name) ? options.name.flags : undefined,
-      domain: (0, _rtti.isString)(options.domain) ? options.domain : undefined,
-      domainRegexSource: (0, _rtti.isRegExp)(options.domain) ? options.domain.source : undefined,
-      domainRegexFlags: (0, _rtti.isRegExp)(options.domain) ? options.domain.flags : undefined,
-      path: (0, _rtti.isString)(options.path) ? options.path : undefined,
-      pathRegexSource: (0, _rtti.isRegExp)(options.path) ? options.path.source : undefined,
-      pathRegexFlags: (0, _rtti.isRegExp)(options.path) ? options.path.flags : undefined
-    });
-  }
-  async grantPermissions(permissions, options) {
-    await this._channel.grantPermissions({
-      permissions,
-      ...options
-    });
-  }
-  async clearPermissions() {
-    await this._channel.clearPermissions();
-  }
-  async setGeolocation(geolocation) {
-    await this._channel.setGeolocation({
-      geolocation: geolocation || undefined
-    });
-  }
-  async setExtraHTTPHeaders(headers) {
-    network.validateHeaders(headers);
-    await this._channel.setExtraHTTPHeaders({
-      headers: (0, _headers.headersObjectToArray)(headers)
-    });
-  }
-  async setOffline(offline) {
-    await this._channel.setOffline({
-      offline
-    });
-  }
-  async setHTTPCredentials(httpCredentials) {
-    await this._channel.setHTTPCredentials({
-      httpCredentials: httpCredentials || undefined
-    });
-  }
-  async addInitScript(script, arg) {
-    const source = await (0, _clientHelper.evaluationScript)(this._platform, script, arg);
-    await this._channel.addInitScript({
-      source
-    });
-  }
-  async exposeBinding(name, callback, options = {}) {
-    await this._channel.exposeBinding({
-      name,
-      needsHandle: options.handle
-    });
-    this._bindings.set(name, callback);
-  }
-  async exposeFunction(name, callback) {
-    await this._channel.exposeBinding({
-      name
-    });
-    const binding = (source, ...args) => callback(...args);
-    this._bindings.set(name, binding);
-  }
-  async route(url, handler, options = {}) {
-    this._routes.unshift(new network.RouteHandler(this._platform, this._options.baseURL, url, handler, options.times));
-    await this._updateInterceptionPatterns();
-  }
-  async routeWebSocket(url, handler) {
-    this._webSocketRoutes.unshift(new network.WebSocketRouteHandler(this._options.baseURL, url, handler));
-    await this._updateWebSocketInterceptionPatterns();
-  }
-  async _recordIntoHAR(har, page, options = {}) {
-    var _options$updateConten, _options$updateMode, _options$updateConten2;
-    const {
-      harId
-    } = await this._channel.harStart({
-      page: page === null || page === void 0 ? void 0 : page._channel,
-      options: prepareRecordHarOptions({
-        path: har,
-        content: (_options$updateConten = options.updateContent) !== null && _options$updateConten !== void 0 ? _options$updateConten : 'attach',
-        mode: (_options$updateMode = options.updateMode) !== null && _options$updateMode !== void 0 ? _options$updateMode : 'minimal',
-        urlFilter: options.url
-      })
-    });
-    this._harRecorders.set(harId, {
-      path: har,
-      content: (_options$updateConten2 = options.updateContent) !== null && _options$updateConten2 !== void 0 ? _options$updateConten2 : 'attach'
-    });
-  }
-  async routeFromHAR(har, options = {}) {
-    const localUtils = this._connection.localUtils();
-    if (!localUtils) throw new Error('Route from har is not supported in thin clients');
-    if (options.update) {
-      await this._recordIntoHAR(har, null, options);
-      return;
-    }
-    const harRouter = await _harRouter.HarRouter.create(localUtils, har, options.notFound || 'abort', {
-      urlMatch: options.url
-    });
-    this._harRouters.push(harRouter);
-    await harRouter.addContextRoute(this);
-  }
-  _disposeHarRouters() {
-    this._harRouters.forEach(router => router.dispose());
-    this._harRouters = [];
-  }
-  async unrouteAll(options) {
-    await this._unrouteInternal(this._routes, [], options === null || options === void 0 ? void 0 : options.behavior);
-    this._disposeHarRouters();
-  }
-  async unroute(url, handler) {
-    const removed = [];
-    const remaining = [];
-    for (const route of this._routes) {
-      if ((0, _urlMatch.urlMatchesEqual)(route.url, url) && (!handler || route.handler === handler)) removed.push(route);else remaining.push(route);
-    }
-    await this._unrouteInternal(removed, remaining, 'default');
-  }
-  async _unrouteInternal(removed, remaining, behavior) {
-    this._routes = remaining;
-    await this._updateInterceptionPatterns();
-    if (!behavior || behavior === 'default') return;
-    const promises = removed.map(routeHandler => routeHandler.stop(behavior));
-    await Promise.all(promises);
-  }
-  async _updateInterceptionPatterns() {
-    const patterns = network.RouteHandler.prepareInterceptionPatterns(this._routes);
-    await this._channel.setNetworkInterceptionPatterns({
-      patterns
-    });
-  }
-  async _updateWebSocketInterceptionPatterns() {
-    const patterns = network.WebSocketRouteHandler.prepareInterceptionPatterns(this._webSocketRoutes);
-    await this._channel.setWebSocketInterceptionPatterns({
-      patterns
-    });
-  }
-  _effectiveCloseReason() {
-    var _this$_browser3;
-    return this._closeReason || ((_this$_browser3 = this._browser) === null || _this$_browser3 === void 0 ? void 0 : _this$_browser3._closeReason);
-  }
-  async waitForEvent(event, optionsOrPredicate = {}) {
-    return await this._wrapApiCall(async () => {
-      const timeout = this._timeoutSettings.timeout(typeof optionsOrPredicate === 'function' ? {} : optionsOrPredicate);
-      const predicate = typeof optionsOrPredicate === 'function' ? optionsOrPredicate : optionsOrPredicate.predicate;
-      const waiter = _waiter.Waiter.createForEvent(this, event);
-      waiter.rejectOnTimeout(timeout, `Timeout ${timeout}ms exceeded while waiting for event "${event}"`);
-      if (event !== _events.Events.BrowserContext.Close) waiter.rejectOnEvent(this, _events.Events.BrowserContext.Close, () => new _errors.TargetClosedError(this._effectiveCloseReason()));
-      const result = await waiter.waitForEvent(this, event, predicate);
-      waiter.dispose();
-      return result;
-    });
-  }
-  async storageState(options = {}) {
-    const state = await this._channel.storageState({
-      indexedDB: options.indexedDB
-    });
-    if (options.path) {
-      await (0, _fileUtils.mkdirIfNeeded)(this._platform, options.path);
-      await this._platform.fs().promises.writeFile(options.path, JSON.stringify(state, undefined, 2), 'utf8');
-    }
-    return state;
-  }
-  backgroundPages() {
-    return [...this._backgroundPages];
-  }
-  serviceWorkers() {
-    return [...this._serviceWorkers];
-  }
-  async newCDPSession(page) {
-    // channelOwner.ts's validation messages don't handle the pseudo-union type, so we're explicit here
-    if (!(page instanceof _page.Page) && !(page instanceof _frame.Frame)) throw new Error('page: expected Page or Frame');
-    const result = await this._channel.newCDPSession(page instanceof _page.Page ? {
-      page: page._channel
-    } : {
-      frame: page._channel
-    });
-    return _cdpSession.CDPSession.from(result.session);
-  }
-  _onClose() {
-    var _this$_browserType;
-    if (this._browser) this._browser._contexts.delete(this);
-    (_this$_browserType = this._browserType) === null || _this$_browserType === void 0 || (_this$_browserType = _this$_browserType._contexts) === null || _this$_browserType === void 0 || _this$_browserType.delete(this);
-    this._disposeHarRouters();
-    this.tracing._resetStackCounter();
-    this.emit(_events.Events.BrowserContext.Close, this);
-  }
-  async [Symbol.asyncDispose]() {
-    await this.close();
-  }
-  async close(options = {}) {
-    if (this._closeWasCalled) return;
-    this._closeReason = options.reason;
-    this._closeWasCalled = true;
-    await this._wrapApiCall(async () => {
-      await this.request.dispose(options);
-    }, true);
-    await this._wrapApiCall(async () => {
-      var _this$_browserType2;
-      await ((_this$_browserType2 = this._browserType) === null || _this$_browserType2 === void 0 ? void 0 : _this$_browserType2._willCloseContext(this));
-      for (const [harId, harParams] of this._harRecorders) {
-        const har = await this._channel.harExport({
-          harId
-        });
-        const artifact = _artifact.Artifact.from(har.artifact);
-        // Server side will compress artifact if content is attach or if file is .zip.
-        const isCompressed = harParams.content === 'attach' || harParams.path.endsWith('.zip');
-        const needCompressed = harParams.path.endsWith('.zip');
-        if (isCompressed && !needCompressed) {
-          const localUtils = this._connection.localUtils();
-          if (!localUtils) throw new Error('Uncompressed har is not supported in thin clients');
-          await artifact.saveAs(harParams.path + '.tmp');
-          await localUtils.harUnzip({
-            zipFile: harParams.path + '.tmp',
-            harFile: harParams.path
-          });
-        } else {
-          await artifact.saveAs(harParams.path);
-        }
-        await artifact.delete();
-      }
-    }, true);
-    await this._channel.close(options);
-    await this._closedPromise;
-  }
-  async _enableRecorder(params) {
-    await this._channel.enableRecorder(params);
-  }
-}
-exports.BrowserContext = BrowserContext;
-async function prepareStorageState(platform, options) {
-  if (typeof options.storageState !== 'string') return options.storageState;
-  try {
-    return JSON.parse(await platform.fs().promises.readFile(options.storageState, 'utf8'));
-  } catch (e) {
-    (0, _stackTrace.rewriteErrorMessage)(e, `Error reading storage state from ${options.storageState}:\n` + e.message);
-    throw e;
-  }
-}
-function prepareRecordHarOptions(options) {
-  if (!options) return;
-  return {
-    path: options.path,
-    content: options.content || (options.omitContent ? 'omit' : undefined),
-    urlGlob: (0, _rtti.isString)(options.urlFilter) ? options.urlFilter : undefined,
-    urlRegexSource: (0, _rtti.isRegExp)(options.urlFilter) ? options.urlFilter.source : undefined,
-    urlRegexFlags: (0, _rtti.isRegExp)(options.urlFilter) ? options.urlFilter.flags : undefined,
-    mode: options.mode
-  };
-}
-async function prepareBrowserContextParams(platform, options) {
-  if (options.videoSize && !options.videosPath) throw new Error(`"videoSize" option requires "videosPath" to be specified`);
-  if (options.extraHTTPHeaders) network.validateHeaders(options.extraHTTPHeaders);
-  const contextParams = {
-    ...options,
-    viewport: options.viewport === null ? undefined : options.viewport,
-    noDefaultViewport: options.viewport === null,
-    extraHTTPHeaders: options.extraHTTPHeaders ? (0, _headers.headersObjectToArray)(options.extraHTTPHeaders) : undefined,
-    storageState: await prepareStorageState(platform, options),
-    serviceWorkers: options.serviceWorkers,
-    recordHar: prepareRecordHarOptions(options.recordHar),
-    colorScheme: options.colorScheme === null ? 'no-override' : options.colorScheme,
-    reducedMotion: options.reducedMotion === null ? 'no-override' : options.reducedMotion,
-    forcedColors: options.forcedColors === null ? 'no-override' : options.forcedColors,
-    contrast: options.contrast === null ? 'no-override' : options.contrast,
-    acceptDownloads: toAcceptDownloadsProtocol(options.acceptDownloads),
-    clientCertificates: await toClientCertificatesProtocol(platform, options.clientCertificates)
-  };
-  if (!contextParams.recordVideo && options.videosPath) {
-    contextParams.recordVideo = {
-      dir: options.videosPath,
-      size: options.videoSize
-    };
-  }
-  if (contextParams.recordVideo && contextParams.recordVideo.dir) contextParams.recordVideo.dir = platform.path().resolve(contextParams.recordVideo.dir);
-  return contextParams;
-}
-function toAcceptDownloadsProtocol(acceptDownloads) {
-  if (acceptDownloads === undefined) return undefined;
-  if (acceptDownloads) return 'accept';
-  return 'deny';
-}
-async function toClientCertificatesProtocol(platform, certs) {
-  if (!certs) return undefined;
-  const bufferizeContent = async (value, path) => {
-    if (value) return value;
-    if (path) return await platform.fs().promises.readFile(path);
-  };
-  return await Promise.all(certs.map(async cert => ({
-    origin: cert.origin,
-    cert: await bufferizeContent(cert.cert, cert.certPath),
-    key: await bufferizeContent(cert.key, cert.keyPath),
-    pfx: await bufferizeContent(cert.pfx, cert.pfxPath),
-    passphrase: cert.passphrase
-  })));
-}

tvapp2/node_modules/playwright-core/lib/client/browserType.js

@@ -1,207 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.BrowserType = void 0;
-var _browser3 = require("./browser");
-var _browserContext = require("./browserContext");
-var _channelOwner = require("./channelOwner");
-var _clientHelper = require("./clientHelper");
-var _events = require("./events");
-var _assert = require("../utils/isomorphic/assert");
-var _headers = require("../utils/isomorphic/headers");
-var _time = require("../utils/isomorphic/time");
-var _timeoutRunner = require("../utils/isomorphic/timeoutRunner");
-var _webSocket = require("./webSocket");
-/**
- * Copyright (c) Microsoft Corporation.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-// This is here just for api generation and checking.
-
-class BrowserType extends _channelOwner.ChannelOwner {
-  constructor(...args) {
-    super(...args);
-    this._serverLauncher = void 0;
-    this._contexts = new Set();
-    this._playwright = void 0;
-  }
-  static from(browserType) {
-    return browserType._object;
-  }
-  executablePath() {
-    if (!this._initializer.executablePath) throw new Error('Browser is not supported on current platform');
-    return this._initializer.executablePath;
-  }
-  name() {
-    return this._initializer.name;
-  }
-  async launch(options = {}) {
-    var _this$_playwright$_de;
-    (0, _assert.assert)(!options.userDataDir, 'userDataDir option is not supported in `browserType.launch`. Use `browserType.launchPersistentContext` instead');
-    (0, _assert.assert)(!options.port, 'Cannot specify a port without launching as a server.');
-    const logger = options.logger || ((_this$_playwright$_de = this._playwright._defaultLaunchOptions) === null || _this$_playwright$_de === void 0 ? void 0 : _this$_playwright$_de.logger);
-    options = {
-      ...this._playwright._defaultLaunchOptions,
-      ...options
-    };
-    const launchOptions = {
-      ...options,
-      ignoreDefaultArgs: Array.isArray(options.ignoreDefaultArgs) ? options.ignoreDefaultArgs : undefined,
-      ignoreAllDefaultArgs: !!options.ignoreDefaultArgs && !Array.isArray(options.ignoreDefaultArgs),
-      env: options.env ? (0, _clientHelper.envObjectToArray)(options.env) : undefined
-    };
-    return await this._wrapApiCall(async () => {
-      const browser = _browser3.Browser.from((await this._channel.launch(launchOptions)).browser);
-      this._didLaunchBrowser(browser, options, logger);
-      return browser;
-    });
-  }
-  async launchServer(options = {}) {
-    if (!this._serverLauncher) throw new Error('Launching server is not supported');
-    options = {
-      ...this._playwright._defaultLaunchOptions,
-      ...options
-    };
-    return await this._serverLauncher.launchServer(options);
-  }
-  async launchPersistentContext(userDataDir, options = {}) {
-    var _this$_playwright$_de2;
-    const logger = options.logger || ((_this$_playwright$_de2 = this._playwright._defaultLaunchOptions) === null || _this$_playwright$_de2 === void 0 ? void 0 : _this$_playwright$_de2.logger);
-    (0, _assert.assert)(!options.port, 'Cannot specify a port without launching as a server.');
-    options = {
-      ...this._playwright._defaultLaunchOptions,
-      ...this._playwright._defaultContextOptions,
-      ...options
-    };
-    const contextParams = await (0, _browserContext.prepareBrowserContextParams)(this._platform, options);
-    const persistentParams = {
-      ...contextParams,
-      ignoreDefaultArgs: Array.isArray(options.ignoreDefaultArgs) ? options.ignoreDefaultArgs : undefined,
-      ignoreAllDefaultArgs: !!options.ignoreDefaultArgs && !Array.isArray(options.ignoreDefaultArgs),
-      env: options.env ? (0, _clientHelper.envObjectToArray)(options.env) : undefined,
-      channel: options.channel,
-      userDataDir: this._platform.path().isAbsolute(userDataDir) || !userDataDir ? userDataDir : this._platform.path().resolve(userDataDir)
-    };
-    return await this._wrapApiCall(async () => {
-      const result = await this._channel.launchPersistentContext(persistentParams);
-      const context = _browserContext.BrowserContext.from(result.context);
-      await this._didCreateContext(context, contextParams, options, logger);
-      return context;
-    });
-  }
-  async connect(optionsOrWsEndpoint, options) {
-    if (typeof optionsOrWsEndpoint === 'string') return await this._connect({
-      ...options,
-      wsEndpoint: optionsOrWsEndpoint
-    });
-    (0, _assert.assert)(optionsOrWsEndpoint.wsEndpoint, 'options.wsEndpoint is required');
-    return await this._connect(optionsOrWsEndpoint);
-  }
-  async _connect(params) {
-    const logger = params.logger;
-    return await this._wrapApiCall(async () => {
-      var _params$exposeNetwork;
-      const deadline = params.timeout ? (0, _time.monotonicTime)() + params.timeout : 0;
-      const headers = {
-        'x-playwright-browser': this.name(),
-        ...params.headers
-      };
-      const connectParams = {
-        wsEndpoint: params.wsEndpoint,
-        headers,
-        exposeNetwork: (_params$exposeNetwork = params.exposeNetwork) !== null && _params$exposeNetwork !== void 0 ? _params$exposeNetwork : params._exposeNetwork,
-        slowMo: params.slowMo,
-        timeout: params.timeout
-      };
-      if (params.__testHookRedirectPortForwarding) connectParams.socksProxyRedirectPortForTest = params.__testHookRedirectPortForwarding;
-      const connection = await (0, _webSocket.connectOverWebSocket)(this._connection, connectParams);
-      let browser;
-      connection.on('close', () => {
-        // Emulate all pages, contexts and the browser closing upon disconnect.
-        for (const context of ((_browser = browser) === null || _browser === void 0 ? void 0 : _browser.contexts()) || []) {
-          var _browser;
-          for (const page of context.pages()) page._onClose();
-          context._onClose();
-        }
-        setTimeout(() => {
-          var _browser2;
-          return (_browser2 = browser) === null || _browser2 === void 0 ? void 0 : _browser2._didClose();
-        }, 0);
-      });
-      const result = await (0, _timeoutRunner.raceAgainstDeadline)(async () => {
-        // For tests.
-        if (params.__testHookBeforeCreateBrowser) await params.__testHookBeforeCreateBrowser();
-        const playwright = await connection.initializePlaywright();
-        if (!playwright._initializer.preLaunchedBrowser) {
-          connection.close();
-          throw new Error('Malformed endpoint. Did you use BrowserType.launchServer method?');
-        }
-        playwright._setSelectors(this._playwright.selectors);
-        browser = _browser3.Browser.from(playwright._initializer.preLaunchedBrowser);
-        this._didLaunchBrowser(browser, {}, logger);
-        browser._shouldCloseConnectionOnClose = true;
-        browser.on(_events.Events.Browser.Disconnected, () => connection.close());
-        return browser;
-      }, deadline);
-      if (!result.timedOut) {
-        return result.result;
-      } else {
-        connection.close();
-        throw new Error(`Timeout ${params.timeout}ms exceeded`);
-      }
-    });
-  }
-  async connectOverCDP(endpointURLOrOptions, options) {
-    if (typeof endpointURLOrOptions === 'string') return await this._connectOverCDP(endpointURLOrOptions, options);
-    const endpointURL = 'endpointURL' in endpointURLOrOptions ? endpointURLOrOptions.endpointURL : endpointURLOrOptions.wsEndpoint;
-    (0, _assert.assert)(endpointURL, 'Cannot connect over CDP without wsEndpoint.');
-    return await this.connectOverCDP(endpointURL, endpointURLOrOptions);
-  }
-  async _connectOverCDP(endpointURL, params = {}) {
-    if (this.name() !== 'chromium') throw new Error('Connecting over CDP is only supported in Chromium.');
-    const headers = params.headers ? (0, _headers.headersObjectToArray)(params.headers) : undefined;
-    const result = await this._channel.connectOverCDP({
-      endpointURL,
-      headers,
-      slowMo: params.slowMo,
-      timeout: params.timeout
-    });
-    const browser = _browser3.Browser.from(result.browser);
-    this._didLaunchBrowser(browser, {}, params.logger);
-    if (result.defaultContext) await this._didCreateContext(_browserContext.BrowserContext.from(result.defaultContext), {}, {}, params.logger);
-    return browser;
-  }
-  _didLaunchBrowser(browser, browserOptions, logger) {
-    browser._browserType = this;
-    browser._options = browserOptions;
-    browser._logger = logger;
-  }
-  async _didCreateContext(context, contextOptions, browserOptions, logger) {
-    context._logger = logger;
-    context._browserType = this;
-    this._contexts.add(context);
-    context._setOptions(contextOptions, browserOptions);
-    if (this._playwright._defaultContextTimeout !== undefined) context.setDefaultTimeout(this._playwright._defaultContextTimeout);
-    if (this._playwright._defaultContextNavigationTimeout !== undefined) context.setDefaultNavigationTimeout(this._playwright._defaultContextNavigationTimeout);
-    await this._instrumentation.runAfterCreateBrowserContext(context);
-  }
-  async _willCloseContext(context) {
-    this._contexts.delete(context);
-    await this._instrumentation.runBeforeCloseBrowserContext(context);
-  }
-}
-exports.BrowserType = BrowserType;

tvapp2/node_modules/playwright-core/lib/client/cdpSession.js

@@ -1,53 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.CDPSession = void 0;
-var _channelOwner = require("./channelOwner");
-/**
- * Copyright (c) Microsoft Corporation.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-class CDPSession extends _channelOwner.ChannelOwner {
-  static from(cdpSession) {
-    return cdpSession._object;
-  }
-  constructor(parent, type, guid, initializer) {
-    super(parent, type, guid, initializer);
-    this._channel.on('event', ({
-      method,
-      params
-    }) => {
-      this.emit(method, params);
-    });
-    this.on = super.on;
-    this.addListener = super.addListener;
-    this.off = super.removeListener;
-    this.removeListener = super.removeListener;
-    this.once = super.once;
-  }
-  async send(method, params) {
-    const result = await this._channel.send({
-      method,
-      params
-    });
-    return result.result;
-  }
-  async detach() {
-    return await this._channel.detach();
-  }
-}
-exports.CDPSession = CDPSession;