@fossa-app/bridge 0.1.0

package/.build.ps1

@@ -0,0 +1,307 @@
+<#
+.Synopsis
+    Build script
+
+.Description
+    TASKS AND REQUIREMENTS
+    Initialize and Clean repository
+    Restore packages, workflows, tools
+    Format code
+    Build projects and the solution
+    Run Tests
+    Pack
+    Publish
+#>
+
+[System.Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSReviewUnusedParameter', '', Justification = 'Parameter is used actually.')]
+param(
+    # Build Version
+    [Parameter()]
+    [string]
+    $Version,
+    # Build Instance
+    [Parameter()]
+    [string]
+    $Instance
+)
+
+Set-StrictMode -Version Latest
+
+# Synopsis: Initialize folders and variables
+Task Init {
+    $trashFolder = Join-Path -Path . -ChildPath '.trash'
+    $trashFolder = Join-Path -Path $trashFolder -ChildPath $Instance
+    New-Item -Path $trashFolder -ItemType Directory | Out-Null
+    $trashFolder = Resolve-Path -Path $trashFolder
+
+    $buildArtifactsFolder = Join-Path -Path $trashFolder -ChildPath 'artifacts'
+    New-Item -Path $buildArtifactsFolder -ItemType Directory | Out-Null
+
+    $distArtifactsFolder = Join-Path -Path $buildArtifactsFolder -ChildPath 'dist'
+    New-Item -Path $distArtifactsFolder -ItemType Directory | Out-Null
+
+    $fableOutputArtifactsFolder = Join-Path -Path $buildArtifactsFolder -ChildPath 'fable_output'
+    New-Item -Path $fableOutputArtifactsFolder -ItemType Directory | Out-Null
+
+    $state = [PSCustomObject]@{
+        NextVersion                = $null
+        TrashFolder                = $trashFolder
+        BuildArtifactsFolder       = $buildArtifactsFolder
+        DistArtifactsFolder        = $distArtifactsFolder
+        FableOutputArtifactsFolder = $fableOutputArtifactsFolder
+        NuGetPackagePath           = $null
+        NPMPackagePath             = $null
+    }
+
+    $state | Export-Clixml -Path ".\.trash\$Instance\state.clixml"
+    Write-Output $state
+}
+
+# Synopsis: Clean previous build leftovers
+Task Clean Init, {
+    Get-ChildItem -Directory
+    | Where-Object { -not $_.Name.StartsWith('.') }
+    | ForEach-Object { Get-ChildItem -Path $_ -Recurse -Directory }
+    | Where-Object { ( $_.Name -eq 'bin') -or ( $_.Name -eq 'obj') }
+    | ForEach-Object { Remove-Item -Path $_ -Recurse -Force }
+}
+
+# Synopsis: Ensure Central Package Versions compliance
+Task EnsureCentralPackageVersions Clean, {
+
+    $projectFiles = Get-ChildItem -Path . `
+        -Recurse `
+        -Include *.csproj, *.fsproj, *.vbproj `
+        -File
+
+    $violations = @()
+
+    foreach ($projectFile in $projectFiles) {
+        try {
+            [xml]$xml = Get-Content $projectFile.FullName -Raw
+        }
+        catch {
+            throw "Failed to parse XML: $($projectFile.FullName)"
+        }
+
+        $ns = New-Object System.Xml.XmlNamespaceManager($xml.NameTable)
+        $ns.AddNamespace('msb', $xml.DocumentElement.NamespaceURI)
+
+        $nodes = $xml.SelectNodes('//*[@VersionOverride]', $ns)
+
+        foreach ($node in $nodes) {
+            $violations += [PSCustomObject]@{
+                File  = $projectFile.FullName
+                Node  = $node.Name
+                Value = $node.GetAttribute('VersionOverride')
+            }
+        }
+    }
+
+    if ($violations.Count -gt 0) {
+        throw "VersionOverride attributes are not allowed. File: $($violations[0].File) Node: <$($violations[0].Node)>"
+    }
+}
+
+# Synopsis: Restore workloads
+Task RestoreWorkloads Clean, {
+    Exec { dotnet workload restore }
+}
+
+# Synopsis: Restore tools
+Task RestoreTools Clean, {
+    Exec { dotnet tool restore }
+}
+
+# Synopsis: Restore NuGet packages
+Task RestoreNuGetPackages Clean, EnsureCentralPackageVersions, {
+    $solution = Resolve-Path -Path 'Fossa.Bridge.slnx'
+    Exec { dotnet restore $solution }
+}
+
+# Synopsis: Restore NPM packages
+Task RestoreNPMPackages Clean, {
+    Exec { npm ci }
+}
+
+# Synopsis: Restore
+Task Restore RestoreWorkloads, RestoreTools, RestoreNuGetPackages, RestoreNPMPackages
+
+# Synopsis: Scan with DevSkim for security issues
+Task DevSkim Restore, {
+    $state = Import-Clixml -Path ".\.trash\$Instance\state.clixml"
+    $trashFolder = $state.TrashFolder
+    $sarifFile = Join-Path -Path $trashFolder -ChildPath 'DevSkim.sarif'
+    Exec { dotnet tool run devskim analyze --source-code . --output-file $sarifFile }
+    Exec { dotnet tool run devskim fix --source-code . --sarif-result $sarifFile --all }
+}
+
+# Synopsis: Format XML Files
+Task FormatXmlFiles Clean, {
+    Get-ChildItem -Include *.xml, *.config, *.props, *.targets, *.nuspec, *.resx, *.ruleset, *.vsixmanifest, *.vsct, *.xlf, *.csproj, *.fsproj, *.vbproj, *.slnx -Recurse -File
+    | Where-Object { -not (git check-ignore $PSItem) }
+    | ForEach-Object {
+        Write-Output "Formatting XML File: $PSItem"
+        $content = Get-Content -Path $PSItem -Raw
+        $xml = [xml]$content
+        $xml.Save($PSItem)
+    }
+}
+
+# Synopsis: Format Fantomas
+Task FormatFantomas Restore, {
+    $solution = Resolve-Path -Path 'Fossa.Bridge.slnx'
+    Exec { dotnet fantomas . }
+}
+
+# Synopsis: Format
+Task Format Restore, FormatXmlFiles, FormatFantomas
+
+# Synopsis: Estimate Next Version
+Task EstimateVersion Restore, {
+    $state = Import-Clixml -Path ".\.trash\$Instance\state.clixml"
+    if ($Version) {
+        $state.NextVersion = [System.Management.Automation.SemanticVersion]$Version
+    }
+    else {
+        $gitversion = Exec { dotnet tool run dotnet-gitversion } | ConvertFrom-Json
+        $state.NextVersion = [System.Management.Automation.SemanticVersion]::Parse($gitversion.SemVer)
+    }
+
+    $state | Export-Clixml -Path ".\.trash\$Instance\state.clixml"
+    Write-Output "Next version estimated to be $($state.NextVersion)"
+    Write-Output $state
+}
+
+# Synopsis: Build Project
+Task BuildProject EstimateVersion, {
+    $state = Import-Clixml -Path ".\.trash\$Instance\state.clixml"
+    $project = Resolve-Path -Path 'src/Fossa.Bridge/Fossa.Bridge.fsproj'
+    $nextVersion = $state.NextVersion
+
+    Exec { dotnet build $project /v:m --configuration Release /p:version=$nextVersion }
+}
+
+# Synopsis: Build
+Task Build Format, BuildProject, {
+    $solution = Resolve-Path -Path 'Fossa.Bridge.slnx'
+    Exec { dotnet build $solution --configuration Release }
+}
+
+# Synopsis: Unit Test
+Task UnitTest Build, {
+    $project = Resolve-Path -Path 'tests/Fossa.Bridge.Tests/Fossa.Bridge.Tests.fsproj'
+    Exec { dotnet run --project $project --configuration Release }
+}
+
+# Synopsis: Functional Test
+Task FunctionalTest Build, {
+}
+
+# Synopsis: Integration Test
+Task IntegrationTest Build, {
+    if (-not $env:CI) {
+    }
+}
+
+# Synopsis: Test
+Task Test UnitTest, FunctionalTest, IntegrationTest
+
+# Synopsis: Pack NuGet package
+Task PackNuGet Build, Test, {
+    $state = Import-Clixml -Path ".\.trash\$Instance\state.clixml"
+    $buildArtifactsFolder = $state.BuildArtifactsFolder
+    $nextVersion = $state.NextVersion
+    $projectPath = Resolve-Path -Path 'src/Fossa.Bridge/Fossa.Bridge.fsproj'
+
+    Exec { dotnet pack $projectPath /v:m /p:Configuration=Release /p:version=$nextVersion --output $buildArtifactsFolder }
+
+    $nugetPackage = Get-ChildItem -Path $buildArtifactsFolder -Filter '*.nupkg' | Select-Object -First 1
+
+    $state.NuGetPackagePath = $nugetPackage.FullName
+
+    $state | Export-Clixml -Path ".\.trash\$Instance\state.clixml"
+    Write-Output $state
+}
+
+# Synopsis: Pack NPM package
+Task PackNPM Build, Test, {
+    $state = Import-Clixml -Path ".\.trash\$Instance\state.clixml"
+    $buildArtifactsFolder = $state.BuildArtifactsFolder
+    $distArtifactsFolder = $state.DistArtifactsFolder
+    $fableOutputArtifactsFolder = $state.FableOutputArtifactsFolder
+    $nextVersion = $state.NextVersion
+    $projectPath = Resolve-Path -Path 'src/Fossa.Bridge/Fossa.Bridge.fsproj'
+
+    Exec { dotnet fable $projectPath --outDir $fableOutputArtifactsFolder --language typescript }
+    Exec { npm version $nextVersion --no-git-tag-version --allow-same-version }
+    Exec { npm install }
+
+    $baseTsConfig = (Resolve-Path .\tsconfig.json).Path.Replace('\', '/')
+    $tempTsConfigPath = Join-Path -Path $buildArtifactsFolder -ChildPath 'tsconfig.build.json'
+    $fablePattern = "$($fableOutputArtifactsFolder.Replace('\', '/'))/**/*"
+    $distPath = $distArtifactsFolder.Replace('\', '/')
+    $fablePath = $fableOutputArtifactsFolder.Replace('\', '/')
+    $tempTsConfig = @"
+{
+  `"extends`": `"$baseTsConfig`",
+  `"compilerOptions`": {
+    `"outDir`": `"$distPath`",
+    `"rootDir`": `"$fablePath`"
+  },
+  `"include`": [
+    `"$fablePattern`"
+  ]
+}
+"@
+    Set-Content -Path $tempTsConfigPath -Value $tempTsConfig
+
+    Exec { npm run build -- --project $tempTsConfigPath }
+    Exec { npm pack --pack-destination $buildArtifactsFolder }
+
+    $npmPackage = Get-ChildItem -Path $buildArtifactsFolder -Filter '*.tgz' | Select-Object -First 1
+
+    $state.NPMPackagePath = $npmPackage.FullName
+
+    $state | Export-Clixml -Path ".\.trash\$Instance\state.clixml"
+    Write-Output $state
+}
+
+# Synopsis: Pack
+Task Pack PackNuGet, PackNPM
+
+# Synopsis: Publish NuGet package
+Task PublishNuGet PackNuGet, {
+    $state = Import-Clixml -Path ".\.trash\$Instance\state.clixml"
+    $nugetPackagePath = $state.NuGetPackagePath
+
+    if ($null -eq $env:NUGET_API_KEY) {
+        Import-Module -Name Microsoft.PowerShell.SecretManagement
+        $apiKey = Get-Secret -Name 'Fossa-Bridge-NuGet-API-Key' -AsPlainText
+    }
+    else {
+        $apiKey = $env:NUGET_API_KEY
+    }
+
+    Exec { dotnet nuget push $nugetPackagePath --source https://api.nuget.org/v3/index.json --api-key $apiKey }
+}
+
+# Synopsis: Publish NPM package
+Task PublishNPM PackNPM, {
+    $state = Import-Clixml -Path ".\.trash\$Instance\state.clixml"
+    $npmPackagePath = $state.NPMPackagePath
+
+    if ($null -eq $env:NPM_TOKEN) {
+        Import-Module -Name Microsoft.PowerShell.SecretManagement
+        $token = Get-Secret -Name 'Fossa-Bridge-NPM-Token' -AsPlainText
+    }
+    else {
+        $token = $env:NPM_TOKEN
+    }
+
+    Exec { npm config set //registry.npmjs.org/:_authToken $token }
+    Exec { npm publish $npmPackagePath --access public }
+}
+
+# Synopsis: Publish
+Task Publish PublishNuGet, PublishNPM

package/.github/dependabot.yml

@@ -0,0 +1,38 @@
+version: 2
+updates:
+  - package-ecosystem: nuget
+    directory: "/"
+    labels:
+      - "dependencies"
+      - "maintenance"
+    schedule:
+      interval: daily
+    open-pull-requests-limit: 10
+    reviewers:
+      - tiksn
+    assignees:
+      - tiksn
+  - package-ecosystem: npm
+    directory: '/'
+    labels:
+      - 'dependencies'
+      - 'maintenance'
+    schedule:
+      interval: monthly
+    open-pull-requests-limit: 10
+    reviewers:
+      - tiksn
+    assignees:
+      - tiksn
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    labels:
+      - "dependencies"
+      - "maintenance"
+    open-pull-requests-limit: 10
+    schedule:
+      interval: "daily"
+    reviewers:
+      - "tiksn"
+    assignees:
+      - "tiksn"

package/.github/release-drafter.yml

@@ -0,0 +1,52 @@
+# release-drafter automatically creates a draft release for you each time you complete a PR in the main branch.
+# It uses GitHub labels to categorize changes (See categories) and draft the release.
+# release-drafter also generates a version for your release based on GitHub labels. You can add a label of 'major',
+# 'minor' or 'patch' to determine which number in the version to increment.
+# You may need to add these labels yourself.
+# See https://github.com/release-drafter/release-drafter
+name-template: "$RESOLVED_VERSION"
+tag-template: "$RESOLVED_VERSION"
+change-template: "- $TITLE by @$AUTHOR (#$NUMBER)"
+no-changes-template: "- No changes"
+categories:
+  - title: "📚 Documentation"
+    labels:
+      - "documentation"
+  - title: "🚀 New Features"
+    labels:
+      - "enhancement"
+  - title: "🐛 Bug Fixes"
+    labels:
+      - "bug"
+  - title: "🧰 Maintenance"
+    labels:
+      - "maintenance"
+version-resolver:
+  major:
+    labels:
+      - "major"
+  minor:
+    labels:
+      - "minor"
+  patch:
+    labels:
+      - "patch"
+  default: patch
+template: |
+  $CHANGES
+
+  ## 👨🏼‍💻 Contributors
+
+  $CONTRIBUTORS
+autolabeler:
+  - label: "documentation"
+    files:
+      - "**/*.md"
+  - label: "enhancement"
+    files:
+      - "Source/**/*"
+  - label: "maintenance"
+    files:
+      - ".github/**/*"
+      - "Images/**/*"
+      - "Tests/**/*"

package/.github/workflows/cicd.yml

@@ -0,0 +1,106 @@
+name: CICD
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+  release:
+    types:
+      - published
+  workflow_dispatch:
+
+permissions: read-all
+
+env:
+  DOTNET_NOLOGO: true
+  DOTNET_SKIP_FIRST_TIME_EXPERIENCE: true
+  DOTNET_CLI_TELEMETRY_OPTOUT: true
+
+jobs:
+  ci:
+    name: CI
+    runs-on: ubuntu-latest
+    steps:
+      - name: "Checkout"
+        uses: actions/checkout@v6
+        with:
+          lfs: true
+          fetch-depth: 0
+      - name: Set up Docker with containerd
+        uses: docker/setup-docker-action@v4
+        with:
+          daemon-config: |
+            {
+              "features": {
+                "containerd-snapshotter": true
+              }
+            }
+      - name: "Install .NET Core SDK"
+        uses: actions/setup-dotnet@v5.1.0
+      - name: "Install InvokeBuild Module"
+        shell: pwsh
+        run: Install-Module -Name InvokeBuild -Force
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+      - name: "Restore"
+        shell: pwsh
+        run: .\restore.ps1 -Instance ${{github.run_id}}
+      - name: "Format"
+        shell: pwsh
+        run: .\format.ps1 -Instance ${{github.run_id}}
+      - name: "Version"
+        shell: pwsh
+        run: .\version.ps1 -Instance ${{github.run_id}}
+      - name: "Build"
+        shell: pwsh
+        run: .\build.ps1 -Instance ${{github.run_id}}
+      - name: "Test"
+        shell: pwsh
+        run: .\test.ps1 -Instance ${{github.run_id}}
+      - name: "Pack"
+        shell: pwsh
+        run: .\pack.ps1 -Instance ${{github.run_id}}
+      - name: "Publish Artefacts"
+        uses: actions/upload-artifact@v6.0.0
+        with:
+          name: .trash
+          path: ".trash"
+          include-hidden-files: true
+
+  cd:
+    name: CD
+    needs: ci
+    if: github.event_name == 'release'
+    environment:
+      name: "DockerHub"
+      url: https://hub.docker.com/r/tiksn/fossa-api
+    runs-on: ubuntu-latest
+    steps:
+      - name: "Checkout"
+        uses: actions/checkout@v6
+        with:
+          lfs: true
+          fetch-depth: 0
+      - name: "Download Artefact"
+        uses: actions/download-artifact@v7.0.0
+        with:
+          name: ".trash"
+          path: "./.trash"
+      - name: Set up Docker with containerd
+        uses: docker/setup-docker-action@v4
+        with:
+          daemon-config: |
+            {
+              "features": {
+                "containerd-snapshotter": true
+              }
+            }
+      - name: "Install InvokeBuild Module"
+        shell: pwsh
+        run: Install-Module -Name InvokeBuild -Force
+      - name: "Publish"
+        env:
+          DOCKER_ACCESS_TOKEN: ${{secrets.DOCKER_ACCESS_TOKEN}}
+        shell: pwsh
+        run: .\publish.ps1 -Instance ${{github.run_id}}

package/.github/workflows/lint.yml

@@ -0,0 +1,34 @@
+name: Lint
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+permissions: read-all
+
+env:
+  DOTNET_NOLOGO: true
+  DOTNET_SKIP_FIRST_TIME_EXPERIENCE: true
+  DOTNET_CLI_TELEMETRY_OPTOUT: true
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+
+    permissions:
+      statuses: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Super-linter
+        uses: super-linter/super-linter@v8.5.0
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          VALIDATE_JSCPD: false

package/.github/workflows/release-drafter.yml

@@ -0,0 +1,27 @@
+name: Release Drafter
+
+on:
+  push:
+    branches:
+      - main
+  pull_request_target:
+    types:
+      - edited
+      - opened
+      - reopened
+      - synchronize
+  workflow_dispatch:
+
+permissions: read-all
+
+jobs:
+  update_release_draft:
+    permissions:
+      contents: write
+      pull-requests: write
+    runs-on: ubuntu-latest
+    steps:
+      - name: "Draft Release"
+        uses: release-drafter/release-drafter@v6.2.0
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/Fossa.Bridge.slnx

@@ -0,0 +1,8 @@
+<Solution>
+  <Folder Name="/src/">
+    <Project Path="src/Fossa.Bridge/Fossa.Bridge.fsproj" />
+  </Folder>
+  <Folder Name="/tests/">
+    <Project Path="tests/Fossa.Bridge.Tests/Fossa.Bridge.Tests.fsproj" />
+  </Folder>
+</Solution>

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 fossa-app
+
+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.

package/README.md

@@ -0,0 +1,5 @@
+# FossaApp Bridge
+[![Developed by Tigran (TIKSN) Torosyan](https://img.shields.io/badge/Developed%20by-%20Tigran%20%28TIKSN%29%20Torosyan-orange.svg)](https://tiksn.com/)
+[![StandWithUkraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraine.svg)](https://github.com/vshymanskyy/StandWithUkraine/blob/main/docs/README.md)
+
+The FossaApp Bridge provides shared froentend and backend functionality.

package/build.ps1

@@ -0,0 +1,11 @@
+[CmdletBinding()]
+param (
+    [Parameter()]
+    [string]
+    $Version,
+    [Parameter()]
+    [string]
+    $Instance
+)
+
+.\trigger.ps1 -Task Build -Instance $Instance -Version $Version

package/dotnet-tools.json

@@ -0,0 +1,27 @@
+{
+  "version": 1,
+  "isRoot": true,
+  "tools": {
+    "fable": {
+      "version": "4.29.0",
+      "commands": [
+        "fable"
+      ],
+      "rollForward": false
+    },
+    "fantomas": {
+      "version": "7.0.5",
+      "commands": [
+        "fantomas"
+      ],
+      "rollForward": false
+    },
+    "gitversion.tool": {
+      "version": "6.6.0",
+      "commands": [
+        "dotnet-gitversion"
+      ],
+      "rollForward": false
+    }
+  }
+}

package/format.ps1

@@ -0,0 +1,11 @@
+[CmdletBinding()]
+param (
+    [Parameter()]
+    [string]
+    $Version,
+    [Parameter()]
+    [string]
+    $Instance
+)
+
+.\trigger.ps1 -Task Format -Instance $Instance -Version $Version

package/gig.ps1

@@ -0,0 +1,16 @@
+#For PowerShell v3
+Function gig {
+    param(
+        [Parameter(Mandatory = $true)]
+        [string[]]$list
+    )
+    $params = ($list | ForEach-Object { [uri]::EscapeDataString($_) }) -join ','
+    Invoke-WebRequest -Uri "https://www.toptal.com/developers/gitignore/api/$params"
+    | Select-Object -ExpandProperty content | Out-File -FilePath $(Join-Path -Path $pwd -ChildPath '.gitignore') -Encoding ascii
+}
+
+gig -list visualstudio, visualstudiocode, rider, fsharp, powershell, macos, intellij+all
+
+Add-Content -Path .\.gitignore -Value '# Repository Specific' -Encoding ascii
+Add-Content -Path .\.gitignore -Value '.trash' -Encoding ascii
+Add-Content -Path .\.gitignore -Value '.idea/' -Encoding ascii

package/global.json

@@ -0,0 +1,6 @@
+{
+  "sdk": {
+    "version": "10.0.100",
+    "rollForward": "latestMajor"
+  }
+}