feat: add v2/git and v2/status api

Author: CasLubbers

package-lock.json

@@ -0,0 +1,42 @@
+import Debug from 'debug'
+import { Response } from 'express'
+import { BadRequestError } from 'src/error'
+import { lockApi } from 'src/middleware/session'
+import { OpenApiRequestExt } from 'src/otomi-models'
+
+const debug = Debug('otomi:api:v2:git')
+
+/**
+ * PUT /v2/git
+ * Migrate the values repository to a new git remote.
+ * Flow:
+ *   1. Validate connectivity to new remote (400 on failure)
+ *   2. Write + commit git config locally, push to new remote first (so new remote has correct config),
+ *      then push to current remote (so operator picks up the switch)
+ *   3. Lock API
+ */
+export const migrateGit = async (req: OpenApiRequestExt, res: Response): Promise<void> => {
+  debug('migrateGit')
+  const { repoUrl, username, password, email, branch } = req.body as {
+    repoUrl: string
+    username?: string
+    password: string
+    email: string
+    branch: string
+  }
+
+  // Validate new remote connectivity; returns true if remote already has content
+  let remoteHasContent: boolean
+  try {
+    remoteHasContent = await req.otomi.git.testRemoteConnection(repoUrl, password, username)
+  } catch (e: any) {
+    throw new BadRequestError(`Cannot connect to new git remote: ${e.message}`)
+  }
+
+  // Write config + commit locally → push to new remote (if empty) → push to current remote
+  await req.otomi.migrateGitSettings({ repoUrl, username, password, email, branch, remoteHasContent })
+
+  await lockApi()
+
+  res.sendStatus(200)
+}

src/api/v2/git.ts

@@ -0,0 +1,14 @@
+import Debug from 'debug'
+import { Response } from 'express'
+import { OpenApiRequestExt } from 'src/otomi-models'
+
+const debug = Debug('otomi:api:v2:status')
+
+/**
+ * GET /v2/status
+ * Returns the current API status including the locked state.
+ */
+export const getApiStatus = (req: OpenApiRequestExt, res: Response): void => {
+  debug('getApiStatus')
+  res.json(req.otomi.getApiStatus())
+}

src/api/v2/status.ts

@@ -70,6 +70,13 @@ export class BadRequestError extends OtomiError {
     this.code = 400
   }
 }
+export class ApiLockedError extends OtomiError {
+  public constructor(err?: string) {
+    super('Api is locked. A git migration has completed. No further changes are accepted.', err)
+    this.code = 503
+  }
+}
+
 export class HttpError extends OtomiError {
   protected static messages: Record<number, string> = {
     400: 'Bad Request',