Merge branch 'main' into hb-files

.github/dependabot.yml

@@ -0,0 +1,11 @@
+---
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: npm
+    directory: "/javascript"
+    schedule:
+      interval: "weekly"

.github/workflows/build.yml

@@ -12,12 +12,12 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
 
       # todo - run the npm install with a dockerfile setup instead of pure
       # install but not important to do right now since install isnt too long
 
-    - uses: actions/setup-node@v2
+    - uses: actions/setup-node@v4
       with:
         node-version: 21
 

.github/workflows/docs.yml

@@ -0,0 +1,72 @@
+# Auto generate docs as a new commit for the docs repo
+name: npm run docs
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+
+    # todo - run the npm install with a dockerfile setup instead of pure
+    # install but not important to do right now since install isnt too long
+
+    - uses: actions/setup-node@v3
+      with:
+        node-version: 21
+
+    - name: Install Dependencies
+      run: |
+        npm install
+
+    - name: 👷 Write the html docs
+      run: |
+        npm run docs
+
+    - name: Get Docs content
+      id: get-docs
+      run: |
+        mkdir -p ../doc
+        cp -rf ./docs/* ../doc/
+
+    - name: see if info is there
+      run: |
+        echo "ll .."
+        ls -al ..
+        echo "ll ."
+        ls -al .
+
+    - name: Checkout docs Repository
+      uses: actions/checkout@v3
+      with:
+        repository: Volumetrics-io/docs
+        ref: main
+        token: ${{ secrets.MRJS_AND_DOCS_REPO_PAT }}
+
+    - name: Update Docs
+      run: |
+        rm -rf auto && mkdir auto
+        mv -f ../doc/* ./auto/
+
+    - name: Commit only if there are changes
+      run: |
+        if [[ -n $(git diff --exit-code) ]]; then
+          echo "Changes detected. Committing and pushing."
+          git config user.name 'github-actions[bot]'
+          git config user.email 'github-actions[bot]@users.noreply.github.com'
+          git add auto/*
+          git commit -m "👷 MR.js - Auto Generated Docs 👷" 
+          git push --quiet --set-upstream origin HEAD
+        else
+          echo "No changes detected. Exiting without committing."
+        fi
+      env:
+          PAT_TOKEN: ${{ secrets.MRJS_AND_DOCS_REPO_PAT }}

.github/workflows/test.yml

@@ -13,12 +13,12 @@ jobs:
     runs-on: ubuntu-latest
     # needs: build # todo
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
 
       # todo - run the npm install with a dockerfile setup instead of pure
       # install but not important to do right now since install isnt too long
 
-    - uses: actions/setup-node@v2
+    - uses: actions/setup-node@v4
       with:
         node-version: 18
 

.gitignore

@@ -2,6 +2,9 @@
 # todo - dont want merge conflicts in dist, but do want when publish, to resolve.
 # dist/*
 
+# Docs - ignore auto html docs in this repo, they'll be exported to the docs repo
+docs/*
+
 # Logs
 logs
 *.log