Initial commit of typespec

Author: pschaeflein

.github/workflows/build.yml

@@ -0,0 +1,26 @@
+name: 'Build'
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+    paths-ignore:
+      - 'docs/openapi.json'
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  build:
+    runs-on: windows-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Compile TypeSpec
+        run: tsp compile src/main.tsp --emit @typespec/openapi3
+      - name: Fix OpenAPI
+        run: ./fixOpenApi.ps1
+        shell: pwsh
+      - name: Update docs
+        uses: test-room-7/action-update-file@v2.0.0

.gitignore

@@ -0,0 +1,9 @@
+# MacOS
+.DS_Store
+
+# Default TypeSpec output
+tsp-output/
+dist/
+
+# Dependency directories
+node_modules/

.vscode/tasks.json

@@ -0,0 +1,46 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "Build SharePointAPI client",
+      "detail": "Generate OpenAPI, run Kiota and compile the client",
+      "type": "shell",
+      "command": "./build-client.ps1",
+      "presentation": {
+        "echo": true,
+        "reveal": "always",
+        "focus": false,
+        "panel": "shared",
+        "showReuseMessage": true,
+        "clear": false
+      },
+      "problemMatcher": []
+    },
+    {
+      "type": "typespec",
+      "path": "d:/Repos/pschaeflein/graph-community-metadata/src/main.tsp",
+      "args": "--watch",
+      "problemMatcher": {
+        "owner": "tsp",
+        "fileLocation": "absolute",
+        "source": "typespec",
+        "pattern": {
+          "regexp": "^..\\/(.*.tsp):(\\d+):(\\d+) - (warning|error) (.*)$",
+          "file": 1,
+          "line": 2,
+          "column": 3,
+          "severity": 4,
+          "message": 5
+        },
+        "background": {
+          "activeOnStart": true,
+        }
+      },
+      "runOptions": {
+        "runOn": "folderOpen"
+      },
+      "isBackground": true,
+      "label": "tsp: watch - main.tsp"
+    }
+  ]
+}

fixOpenApi.ps1

@@ -0,0 +1,21 @@
+$openApiFile = "./dist/@typespec/openapi3/openapi.json"
+$docsApiFile = "./docs/openapi.json"
+# read output from typespec
+$json = Get-Content -Raw -Path $openApiFile | ConvertFrom-Json
+# update the info object
+$info = $json.info
+$xLogo = @{
+  url = "https://pschaeflein.github.io/graph-community-metadata/graph-community-spclient.png"
+  backgroundColor = "#FFFFFF"
+  altText = "Graph.Community SDK for Microsoft SharePoint REST API"
+}
+if (Get-Member -InputObject $info -Name "x-logo" -MemberType Properties) {}
+else { Add-Member -InputObject $info -MemberType NoteProperty -Name "x-logo" -Value $xLogo }
+# update the discriminator mapping
+$mapping = $json.components.schemas.Principal.discriminator.mapping
+if (Get-Member -InputObject $mapping -Name "#SP.Group" -MemberType Properties) {}
+else { Add-Member -InputObject $mapping -MemberType NoteProperty -Name "#SP.Group" -Value "#/components/schemas/Group" }
+if (Get-Member -InputObject $mapping -Name "#SP.User" -MemberType Properties) {}
+else { Add-Member -InputObject $mapping -MemberType NoteProperty -Name "#SP.User" -Value "#/components/schemas/User" }
+#write docs file
+$json | ConvertTo-Json -Depth 100 | Set-Content -Path $docsApiFile