merging master into experiimental

.devin/wiki.json

@@ -0,0 +1,9 @@
+{
+  "repo_notes": [
+    {
+      "content": "Use api.oasisweb4.one (not .com) as the canonical base URL for the hosted OASIS API in all examples, code snippets, and documentation. Base URL: https://api.oasisweb4.one, API prefix: https://api.oasisweb4.one/api, Swagger: https://api.oasisweb4.one/swagger/index.html.\n\nIn the Getting Started / Developer Guides section, document both paths clearly:\n1. Using the remote API: Users can call the hosted API at https://api.oasisweb4.one without cloning or running the repo. Include: register (POST /api/avatar/register), verify-email, authenticate (POST /api/avatar/authenticate), then use the JWT in Authorization header for other endpoints. No .NET SDK or local setup required.\n2. Running locally: Clone, restore, build, and run the WebAPI project for local development.",
+      "author": "OASIS docs"
+    }
+  ],
+  "pages": []
+}

.github/workflows/ci-cd.yml

@@ -137,6 +137,31 @@ jobs:
         dotnet test "STAR ODK/NextGenSoftware.OASIS.STAR.WebAPI.IntegrationTests/NextGenSoftware.OASIS.STAR.WebAPI.IntegrationTests.csproj" --no-build --verbosity normal
         dotnet test "STAR ODK/NextGenSoftware.OASIS.STAR.WebUI.IntegrationTests/NextGenSoftware.OASIS.STAR.WebUI.IntegrationTests.csproj" --no-build --verbosity normal
 
+  # STARAPIClient Unit + Integration + Harness
+  test-starapi-client:
+    name: Test STARAPIClient
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Setup .NET
+      uses: actions/setup-dotnet@v4
+      with:
+        dotnet-version: ${{ env.DOTNET_VERSION }}
+
+    - name: Run STARAPIClient test suite
+      shell: pwsh
+      run: |
+        & "OASIS Omniverse/STARAPIClient/run_star_api_test_suite.ps1" -Configuration Release -KillStaleTestHosts $true
+
+    - name: Upload STARAPIClient test artifacts
+      uses: actions/upload-artifact@v4
+      if: always()
+      with:
+        name: starapiclient-test-results
+        path: OASIS Omniverse/STARAPIClient/TestResults/
+        retention-days: 30
+
   # Unity Tests (if Unity is available)
   unity-tests:
     name: Unity Tests
@@ -160,7 +185,7 @@ jobs:
   build-and-package:
     name: Build and Package
     runs-on: ubuntu-latest
-    needs: [test-oasis-architecture, test-onode, test-star-odk, integration-tests]
+    needs: [test-oasis-architecture, test-onode, test-star-odk, integration-tests, test-starapi-client]
     if: github.ref == 'refs/heads/main' || github.ref == 'refs/heads/master'
 
     steps:

.github/workflows/master_oasisapionode.yml

@@ -0,0 +1,65 @@
+# Docs for the Azure Web Apps Deploy action: https://github.com/Azure/webapps-deploy
+# More GitHub Actions for Azure: https://github.com/Azure/actions
+
+name: Build and deploy ASP.Net Core app to Azure Web App - OASISAPIONODE
+
+on:
+  push:
+    branches:
+      - master
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: windows-latest
+    permissions:
+      contents: read #This is required for actions/checkout
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up .NET Core
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '10.x'
+
+      - name: Build with dotnet
+        run: dotnet build --configuration Release
+
+      - name: dotnet publish
+        run: dotnet publish -c Release -o "${{env.DOTNET_ROOT}}/myapp"
+
+      - name: Upload artifact for deployment job
+        uses: actions/upload-artifact@v4
+        with:
+          name: .net-app
+          path: ${{env.DOTNET_ROOT}}/myapp
+
+  deploy:
+    runs-on: windows-latest
+    needs: build
+    permissions:
+      id-token: write #This is required for requesting the JWT
+      contents: read #This is required for actions/checkout
+
+    steps:
+      - name: Download artifact from build job
+        uses: actions/download-artifact@v4
+        with:
+          name: .net-app
+
+      - name: Login to Azure
+        uses: azure/login@v2
+        with:
+          client-id: ${{ secrets.AZUREAPPSERVICE_CLIENTID_6E57E8EB6CA44C78B5CE4C7C568A0523 }}
+          tenant-id: ${{ secrets.AZUREAPPSERVICE_TENANTID_BE062CE2CBC344DFA6587A6106793B05 }}
+          subscription-id: ${{ secrets.AZUREAPPSERVICE_SUBSCRIPTIONID_AD923DCFBB8745FE900FC743D8F58F66 }}
+
+      - name: Deploy to Azure Web App
+        id: deploy-to-webapp
+        uses: azure/webapps-deploy@v3
+        with:
+          app-name: 'OASISAPIONODE'
+          slot-name: 'Production'
+          package: .
+

.github/workflows/publish-nuget.yml

@@ -0,0 +1,42 @@
+name: Publish NuGet Packages
+
+on:
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: windows-latest
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '10.x'
+
+      - name: Pack all packages
+        shell: pwsh
+        run: .\publish-nuget.ps1 -SkipPush
+
+      - name: Get NuGet token via Trusted Publishing
+        id: get-token
+        shell: pwsh
+        run: |
+          $response = Invoke-RestMethod `
+            -Uri "$env:ACTIONS_ID_TOKEN_REQUEST_URL&audience=api.nuget.org" `
+            -Headers @{ Authorization = "Bearer $env:ACTIONS_ID_TOKEN_REQUEST_TOKEN" }
+          echo "NUGET_TOKEN=$($response.value)" >> $env:GITHUB_OUTPUT
+
+      - name: Push all packages to NuGet.org
+        shell: pwsh
+        run: |
+          Get-ChildItem -Path .\nupkgs\*.nupkg | ForEach-Object {
+            Write-Host "Pushing $($_.Name)..."
+            dotnet nuget push $_.FullName `
+              --source https://api.nuget.org/v3/index.json `
+              --api-key ${{ steps.get-token.outputs.NUGET_TOKEN }} `
+              --skip-duplicate
+          }