@fossa-app/bridge 0.1.0 → 0.1.4

package/.github/dependabot.yml

@@ -1,38 +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"
+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

@@ -1,52 +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/**/*"
+# 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

@@ -1,106 +1,87 @@
-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}}
+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: "Install .NET Core SDK"
+        uses: actions/setup-dotnet@v5.1.0
+      - name: "Install InvokeBuild Module"
+        shell: pwsh
+        run: Install-Module -Name InvokeBuild -Force
+      - 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@v7.0.0
+        with:
+          name: .trash
+          path: ".trash"
+          include-hidden-files: true
+
+  cd:
+    name: CD
+    needs: ci
+    if: github.event_name == 'release'
+    environment:
+      name: "Release"
+      url: "https://github.com/${{ github.repository }}/releases/tag/${{ github.ref_name }}"
+    runs-on: ubuntu-latest
+    steps:
+      - name: "Checkout"
+        uses: actions/checkout@v6
+        with:
+          lfs: true
+          fetch-depth: 0
+      - name: "Download Artefact"
+        uses: actions/download-artifact@v8.0.0
+        with:
+          name: ".trash"
+          path: "./.trash"
+      - name: "Install InvokeBuild Module"
+        shell: pwsh
+        run: Install-Module -Name InvokeBuild -Force
+      - name: "Publish"
+        env:
+          NUGET_API_KEY: ${{secrets.NUGET_API_KEY}}
+          NPM_TOKEN: ${{secrets.NPM_TOKEN}}
+        shell: pwsh
+        run: .\publish.ps1 -Instance ${{github.run_id}}

package/.github/workflows/lint.yml

@@ -1,34 +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
+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

@@ -1,27 +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 }}
+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

@@ -1,8 +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>
+  <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

@@ -1,21 +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.
+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

@@ -1,5 +1,42 @@
-# 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.
+# FossaApp Bridge
+[![NuGet Version](https://img.shields.io/nuget/v/Fossa.Bridge.svg?color=blue)](https://www.nuget.org/packages/Fossa.Bridge/)
+[![npm Version](https://img.shields.io/npm/v/%40fossa-app%2Fbridge?color=blue)](https://www.npmjs.com/package/@fossa-app/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 frontend and backend functionality.
+
+## Project Purpose
+The Fossa.Bridge project is a shared F# library designed to encapsulate logic, validation, and domain models that are common to both the .NET backend and the TypeScript/JavaScript frontend. By using [Fable](https://fable.io/), the F# code is transpiled into JavaScript/TypeScript for the frontend environment while simultaneously being compiled into a standard .NET library for the backend. This ensures a single source of truth for core business logic, API models, and data validation rules, reducing duplication and preventing synchronization issues between the client and server.
+
+## Package Usage
+
+### For .NET Backends (C# / F#)
+Install the NuGet package:
+
+```bash
+dotnet add package Fossa.Bridge
+```
+
+### For JavaScript / TypeScript Frontends
+Install the NPM package:
+
+```bash
+npm install @fossa-app/bridge
+```
+or using Yarn:
+```bash
+yarn add @fossa-app/bridge
+```
+
+## Features
+- Shared API domain models.
+- Common validation and helper logic.
+- Consistent behavior across client and server.
+
+## Building and Packaging
+To build both NPM and NuGet packages locally, run the included PowerShell script:
+
+```bash
+.\pack.ps1
+```

package/build.ps1

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