RELTEC-12611: add api

.github/dependabot.yaml

@@ -0,0 +1,20 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "daily"
+    labels:
+      - "dependencies"
+    reviewers:
+      - "Interhyp/technical-excellence"
+    commit-message:
+      prefix: "fix"
+      include: "scope"
+    pull-request-branch-name:
+      separator: "-"

.github/pull_request_template.md

@@ -0,0 +1,15 @@
+# Description
+
+Please include a summary of the changes and the related issue. Please also include relevant motivation and context. List any dependencies that are required for this change.
+
+Fixes # (issue)
+
+# Checklist
+
+- [ ] I have read the [CONTRIBUTING.md](/CONTRIBUTING-template.md)
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no lint errors
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] New and existing tests pass locally with my changes
+- [ ] Only MIT licensed or MIT license compatible dependencies are used (e.g.: Apache2 or BSD)
+- [ ] The code contains no credentials, personalized data or company secrets

.github/workflows/api.yaml

@@ -0,0 +1,60 @@
+name: API
+
+on:
+  push:
+    paths-ignore:
+      - '**.md'
+
+jobs:
+  generate:
+    name: 🛠️ Generate
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - uses: actions/setup-node@v4
+      with:
+        node-version: '20.x'
+        cache: 'npm'
+    - run: npm ci
+    - run: npm run api
+    - name: Check for API spec changes
+      run: |
+        if [[ $(git status --porcelain) ]]; then
+          echo "API spec is outdated. Please run 'npm run api' locally and commit the changes."
+          exit 1
+        fi
+
+  release:
+    name: 🚀 Release
+    if: github.ref == 'refs/heads/main'
+    needs: generate
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: docker/login-action@v2
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - id: semantic-release
+        uses: go-semantic-release/action@v1
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          prerelease: false
+          allow-initial-development-versions: true # remove to trigger an initial 1.0.0 release
+          changelog-generator-opt: "emojis=true"
+          hooks: goreleaser
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - id: repository-id
+        uses: ASzc/change-string-case-action@v6
+        with:
+          string: ${{ github.repository }}
+      - if: steps.semantic-release.outputs.version != ''
+        run: |
+          TARGET=ghcr.io/${{ steps.repository-id.outputs.lowercase }}:${{ steps.semantic-release.outputs.version }}
+          SOURCE=${{ needs.build.outputs.image }}
+
+          docker pull $SOURCE
+          docker tag $SOURCE $TARGET
+          docker push $TARGET

.github/workflows/semantic-commit-message-check.yaml

@@ -0,0 +1,20 @@
+name: 'Semantic Commit Message Checker'
+on:
+  push:
+    branches-ignore:
+      - main
+
+jobs:
+  check-commit-message:
+    name: Check Commit Message
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check valid types
+        uses: gsactions/commit-message-checker@v1
+        with:
+          pattern: '^(((fix|feat|docs|style|perf|refactor|test|build|chore|ci|revert)\([\w_-]+\)))!{0,1}: .*'
+          error: 'Your commit message should match one of these types (build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test) in header.'
+          excludeDescription: 'true'
+          excludeTitle: 'true'
+          checkAllCommitMessages: 'true'
+          accessToken: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -0,0 +1,53 @@
+# If you prefer the allow list template instead of the deny list, see community template:
+# https://github.com/github/gitignore/blob/main/community/Golang/Go.AllowList.gitignore
+#
+# Binaries for programs and plugins
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+
+# Test binary, built with `go test -c`
+*.test
+
+# Output of the go coverage tool, specifically when used with LiteIDE
+*.out
+
+# Dependency directories (remove the comment below to include it)
+# vendor/
+
+# Go workspace file
+go.work
+go.work.sum
+
+# env file
+.env
+
+# IntelliJ project files
+*.iml
+*.iws
+*.ipr
+.idea/
+
+# Eclipse project file
+.settings/
+.classpath
+.project
+
+# NetBeans specific
+nbproject/private/
+build/
+nbbuild/
+dist/
+nbdist/
+nbactions.xml
+nb-configuration.xml
+
+# OS
+.DS_Store
+
+# NodeJS
+node_modules
+
+.vscode

.openapi-generator-ignore

@@ -0,0 +1,28 @@
+# OpenAPI Generator Ignore
+# Generated by openapi-generator https://github.com/openapitools/openapi-generator
+
+# Use this file to prevent files from being overwritten by the generator.
+# The patterns follow closely to .gitignore or .dockerignore.
+
+# As an example, the C# client generator defines ApiClient.cs.
+# You can make changes and tell OpenAPI Generator to ignore just this file by uncommenting the following line:
+#ApiClient.cs
+
+# You can match any string of characters against a directory, file or extension with a single asterisk (*):
+#foo/*/qux
+# The above matches foo/bar/qux and foo/baz/qux, but not foo/bar/baz/qux
+
+# You can recursively match patterns against a directory, file or extension with a double asterisk (**):
+#foo/**/qux
+# This matches foo/bar/qux, foo/baz/qux, and foo/bar/baz/qux
+
+# You can also negate patterns with an exclamation (!).
+# For example, you can ignore all files in a docs folder with the file extension .md:
+#docs/*.md
+# Then explicitly reverse the ignore rule for a single file:
+#!docs/README.md
+
+test/**
+.gitignore
+.travis.yml
+git_push.sh

.openapi-generator/FILES

@@ -0,0 +1,94 @@
+README.md
+api/openapi.yaml
+api_management.go
+api_rest_api_v1_owners.go
+api_rest_api_v1_repositories.go
+api_rest_api_v1_services.go
+api_webhooks.go
+client.go
+configuration.go
+docs/Binary.md
+docs/ConditionReferenceDto.md
+docs/DeletionDto.md
+docs/ErrorDto.md
+docs/ExcludeMergeCheckUserDto.md
+docs/HealthComponent.md
+docs/Link.md
+docs/ManagementAPI.md
+docs/MergeStrategy.md
+docs/Notification.md
+docs/NotificationPayload.md
+docs/OwnerCreateDto.md
+docs/OwnerDto.md
+docs/OwnerListDto.md
+docs/OwnerPatchDto.md
+docs/PostPromote.md
+docs/ProtectedRef.md
+docs/PullRequests.md
+docs/Quicklink.md
+docs/RefProtections.md
+docs/RefProtectionsBranches.md
+docs/RefProtectionsTags.md
+docs/RepositoryConfigurationAccessKeyDto.md
+docs/RepositoryConfigurationDefaultTaskDto.md
+docs/RepositoryConfigurationDto.md
+docs/RepositoryConfigurationDtoMergeConfig.md
+docs/RepositoryConfigurationPatchDto.md
+docs/RepositoryConfigurationWebhookDto.md
+docs/RepositoryConfigurationWebhooksDto.md
+docs/RepositoryCreateDto.md
+docs/RepositoryDto.md
+docs/RepositoryListDto.md
+docs/RepositoryPatchDto.md
+docs/RestApiV1OwnersAPI.md
+docs/RestApiV1RepositoriesAPI.md
+docs/RestApiV1ServicesAPI.md
+docs/ServiceCreateDto.md
+docs/ServiceDto.md
+docs/ServiceListDto.md
+docs/ServicePatchDto.md
+docs/ServicePromotersDto.md
+docs/ServiceSpecDto.md
+docs/WebhooksAPI.md
+go.mod
+go.sum
+model_binary.go
+model_condition_reference_dto.go
+model_deletion_dto.go
+model_error_dto.go
+model_exclude_merge_check_user_dto.go
+model_health_component.go
+model_link.go
+model_merge_strategy.go
+model_notification.go
+model_notification_payload.go
+model_owner_create_dto.go
+model_owner_dto.go
+model_owner_list_dto.go
+model_owner_patch_dto.go
+model_post_promote.go
+model_protected_ref.go
+model_pull_requests.go
+model_quicklink.go
+model_ref_protections.go
+model_ref_protections_branches.go
+model_ref_protections_tags.go
+model_repository_configuration_access_key_dto.go
+model_repository_configuration_default_task_dto.go
+model_repository_configuration_dto.go
+model_repository_configuration_dto_merge_config.go
+model_repository_configuration_patch_dto.go
+model_repository_configuration_webhook_dto.go
+model_repository_configuration_webhooks_dto.go
+model_repository_create_dto.go
+model_repository_dto.go
+model_repository_list_dto.go
+model_repository_patch_dto.go
+model_service_create_dto.go
+model_service_dto.go
+model_service_list_dto.go
+model_service_patch_dto.go
+model_service_promoters_dto.go
+model_service_spec_dto.go
+response.go
+utils.go

.openapi-generator/VERSION

@@ -0,0 +1 @@
+7.12.0

.releaserc

@@ -0,0 +1,24 @@
+{
+  "branches": ["main"],
+  "plugins": [
+    "@semantic-release/commit-analyzer",
+    [
+      "@semantic-release/release-notes-generator",
+      {
+        "preset": "conventionalcommits",
+        "presetConfig": {
+          "issueUrlFormat ": "https://atlas.interhyp.de/jira/browse/{{id}}"
+        }
+      }
+    ],
+    "@semantic-release/changelog",
+    [
+      "@semantic-release/git",
+      {
+        "assets": [
+          "CHANGELOG.md"
+        ]
+      }
+    ]
+  ]
+}

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Interhyp AG
+
+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.