feat(api): add server manifest

.changeset/gentle-meals-compare.md

···
+---
+'@churros/api': minor
+---
+
+add Query.version to get the current api version, and serve a server manifest at .well-known/churros.app/server.json

packages/api/src/modules/global/resolvers/query.version.ts

···
+import { CURRENT_VERSION, builder } from '#lib';
+
+builder.queryField('version', (t) =>
+  t.string({
+    description: "Version actuelle de l'API",
+    resolve() {
+      return CURRENT_VERSION;
+    },
+  }),
+);

packages/api/src/server/express.ts

···
     console.error('Failed to initialize GraphQL server', error);
   }
   import('./log.js');
+  import('./wellknown.js');
   import('./booking-pdf.js');
   import('./handover-pdf.js');
   import('./storage.js');

packages/api/src/server/wellknown.ts

···
+import { CURRENT_VERSION, ENV } from '#lib';
+import { api } from './express.js';
+
+console.info(`Serving server manifest on /.well-known/churros.app/server.json`);
+api.get('/.well-known/churros.app/server.json', async (_req, res) => {
+  res.json({
+    version: CURRENT_VERSION,
+    urls: {
+      api: ENV.PUBLIC_API_URL,
+      auth: ENV.PUBLIC_API_AUTH_URL,
+    },
+    oauth: {
+      enabled: ENV.PUBLIC_OAUTH_ENABLED === '1',
+      authorizeUrl: ENV.PUBLIC_OAUTH_AUTHORIZE_URL,
+      tokenUrl: ENV.PUBLIC_OAUTH_TOKEN_URL,
+      clientId: ENV.PUBLIC_OAUTH_CLIENT_ID,
+      userInfoUrl: ENV.PUBLIC_OAUTH_USER_INFO_URL,
+      scopes: ENV.PUBLIC_OAUTH_SCOPES?.join(' '),
+    },
+    emails: {
+      contact: ENV.PUBLIC_CONTACT_EMAIL,
+      support: ENV.PUBLIC_SUPPORT_EMAIL,
+    },
+  });
+});

packages/app/schema.graphql

···
   """
   userCandidatesCount: Int!
   userServices: [Service!]! @deprecated(reason: "Use `services(mine: true)` instead")
+  """
+  Version actuelle de l'API
+  """
+  version: String!
 }
 
 type QueryAllFormsConnection {

server-manifest.example.json

···
+{
+  "version": "5.0.1",
+  "urls": {
+    "api": "https://churros.inpt.fr/graphql",
+    "auth": "https://churros.inpt.fr/auth"
+  },
+  "oauth": {
+    "enabled": true,
+    "clientId": "y87JANYpibsGhWJorAgYO9AOPU9PtecC7WsZwDNo",
+    "authorizeUrl": "https://auth.inpt.fr/application/o/authorize/",
+    "tokenUrl": "https://auth.inpt.fr/application/o/token/",
+    "logoutUrl": "https://auth.inpt.fr/application/o/churros/end-session/",
+    "userInfoUrl": "https://auth.inpt.fr/application/o/userinfo/",
+    "scopes": "openid profile email"
+  },
+  "emails": {
+    "contact": "[e-mail]",
+    "support": "[e-mail]"
+  }
+}

server-manifest.schema.json

···
+{
+  "type": "object",
+  "properties": {
+    "version": {
+      "type": "string",
+      "pattern": "^(dev|(\\d+\\.\\d+\\.\\d+))$"
+    },
+    "urls": {
+      "type": "object",
+      "properties": {
+        "auth": {
+          "type": "string",
+          "format": "uri"
+        },
+        "api": {
+          "type": "string",
+          "format": "uri"
+        }
+      },
+      "required": ["auth", "api"],
+      "additionalProperties": false
+    },
+    "oauth": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        },
+        "logoutUrl": {
+          "type": "string",
+          "format": "uri"
+        },
+        "authorizeUrl": {
+          "type": "string",
+          "format": "uri"
+        },
+        "clientId": {
+          "type": "string"
+        },
+        "tokenUrl": {
+          "type": "string",
+          "format": "uri"
+        },
+        "userInfoUrl": {
+          "type": "string",
+          "format": "uri"
+        },
+        "scopes": {
+          "type": "string"
+        }
+      },
+      "required": ["enabled", "scopes"],
+      "additionalProperties": false
+    },
+    "emails": {
+      "type": "object",
+      "properties": {
+        "support": {
+          "type": "string",
+          "format": "email"
+        },
+        "contact": {
+          "type": "string",
+          "format": "email"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "required": ["version", "urls", "oauth", "emails"],
+  "additionalProperties": false,
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}