root: move API client generation to docker-compose (#17434)

Signed-off-by: Marc 'risson' Schmitt <marc.schmitt@risson.space>

scripts/api/docker-compose.yml

@@ -0,0 +1,15 @@
+---
+services:
+  diff:
+    image: docker.io/openapitools/openapi-diff:2.1.3
+    restart: never
+    network_mode: none
+    volumes:
+      - ../../:/local
+
+  gen:
+    image: docker.io/openapitools/openapi-generator-cli:v7.16.0
+    restart: never
+    network_mode: none
+    volumes:
+      - ../../:/local

scripts/api/ts-config.yaml

@@ -0,0 +1,12 @@
+templateDir: /local/scripts/api/ts-templates/
+additionalProperties:
+  typescriptThreePlus: true
+  supportsES6: true
+  npmName: "@goauthentik/api"
+  fileContentDataType: Blob
+  enumUnknownDefaultCase: true
+  useObjectParameters: true
+files:
+  README.mustache:
+    templateType: SupportingFiles
+    destinationFilename: README.md

scripts/api/ts-templates/README.mustache

@@ -0,0 +1,38 @@
+## @goauthentik/api
+
+This package provides a generated API Client for [authentik](https://goauthentik.io?utm_source=npm-api-package).
+
+### Building
+
+See https://docs.goauthentik.io/docs/developer-docs/api/making-schema-changes#building-the-web-client
+
+### Consuming
+
+```
+npm install @goauthentik/api --save
+```
+
+Create a configuration:
+
+```typescript
+import { Configuration } from "@goauthentik/api";
+
+export const DEFAULT_CONFIG = new Configuration({
+    // Configure where the API is located
+    // Can be a full host, ensure CORS is configured
+    basePath: "",
+    // Required for POST/PUT/DELETE requests
+    // getCookie function must return the cookie's contents
+    headers: {
+        "X-authentik-CSRF": getCookie("authentik_csrf"),
+    },
+});
+```
+
+Then use the API:
+
+```typescript
+import { CoreApi } from "@goauthentik/api";
+
+const user = await new CoreApi(DEFAULT_CONFIG).coreUsersMeRetrieve();
+```

scripts/api/ts-templates/tsconfig.esm.mustache

@@ -0,0 +1,7 @@
+{
+    "$schema": "https://json.schemastore.org/tsconfig",
+    "extends": "./tsconfig.json",
+    "compilerOptions": {
+        "outDir": "dist/esm",
+    },
+}

scripts/api/ts-templates/tsconfig.mustache

@@ -0,0 +1,23 @@
+{
+    "$schema": "https://json.schemastore.org/tsconfig",
+    "compilerOptions": {
+        "composite": true,
+        "isolatedModules": true,
+        "incremental": true,
+        "baseUrl": ".",
+        "rootDir": "src",
+        "strict": true,
+        "newLine": "lf",
+        "target": "ESNext",
+        "module": "NodeNext",
+        "moduleResolution": "NodeNext",
+        "outDir": "dist",
+        "skipDefaultLibCheck": true,
+        "skipLibCheck": true,
+        "sourceMap": true,
+        "declaration": true,
+        "declarationMap": true,
+        "lib": ["DOM", "DOM.Iterable", "ESNext"],
+    },
+    "exclude": ["node_modules", "./out/**/*", "./dist/**/*"],
+}