Client parity follow-ups: API-client unification, TODOs, tests, CI, versions

.github/workflows/clients.yaml

@@ -0,0 +1,63 @@
+name: Clients (CLI + VSCode)
+
+# Compile/test gate for the TypeScript packages under cli/. This exists so a broken
+# build (like the extension being uncompilable for months) is caught on every PR.
+
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - 'cli/**'
+      - '.github/workflows/clients.yaml'
+  pull_request:
+    branches: [ main ]
+    paths:
+      - 'cli/**'
+      - '.github/workflows/clients.yaml'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  shared:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+      - name: Build @flapi/shared
+        working-directory: cli/shared
+        run: |
+          npm ci
+          npm run build
+
+  cli:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+      - name: Build & test flapii CLI
+        working-directory: cli
+        run: |
+          npm ci
+          npm run build
+          npm test
+
+  vscode-extension:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+      - name: Build, typecheck & test the VSCode extension
+        working-directory: cli/vscode-extension
+        run: |
+          npm ci
+          npm run typecheck
+          npm run build
+          npm test

cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flapii",
-  "version": "0.1.0",
+  "version": "26.6.13",
   "description": "CLI client for flapi ConfigService",
   "license": "MIT",
   "type": "module",

cli/shared/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flapi/shared",
-  "version": "0.1.0",
+  "version": "26.6.13",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

cli/shared/src/apiClient.ts

@@ -1,6 +1,7 @@
 import axios from 'axios';
 import type { AxiosInstance, AxiosRequestConfig, InternalAxiosRequestConfig } from 'axios';
 import { pathToSlug, slugToPath } from './lib/url';
+import type { ValidationResult, ReloadResult } from './lib/types';
 
 /**
  * Configuration options for FlapiApiClient
@@ -188,8 +189,14 @@ export class FlapiApiClient {
   /**
    * Update authentication token
    */
-  setToken(token: string) {
-    this.client.defaults.headers.common['Authorization'] = `Bearer ${token}`;
+  setToken(token: string | undefined) {
+    if (token) {
+      this.client.defaults.headers.common['Authorization'] = `Bearer ${token}`;
+      this.client.defaults.headers.common['X-Config-Token'] = token;
+    } else {
+      delete this.client.defaults.headers.common['Authorization'];
+      delete this.client.defaults.headers.common['X-Config-Token'];
+    }
     if (this.debug) {
       console.log('[FlapiAPI] Token updated');
     }
@@ -347,6 +354,41 @@ export class FlapiApiClient {
     const response = await this.client.get('/api/v1/_config/endpoints');
     return response.data;
   }
+
+  /**
+   * Validate raw endpoint YAML for an already-encoded endpoint slug.
+   * A 400 (invalid config) is returned as a normalized result rather than thrown.
+   */
+  async validateEndpointConfig(slug: string, yamlContent: string): Promise<ValidationResult> {
+    const response = await this.client.post(
+      `/api/v1/_config/endpoints/${encodeURIComponent(slug)}/validate`,
+      yamlContent,
+      {
+        headers: { 'Content-Type': 'application/x-yaml' },
+        validateStatus: (status) => status < 500,
+      },
+    );
+    const result = response.data ?? {};
+    return {
+      valid: result.valid ?? false,
+      errors: result.errors ?? [],
+      warnings: result.warnings ?? [],
+    };
+  }
+
+  /**
+   * Reload an endpoint configuration from disk by already-encoded slug.
+   */
+  async reloadEndpointConfig(slug: string): Promise<ReloadResult> {
+    const response = await this.client.post(
+      `/api/v1/_config/endpoints/${encodeURIComponent(slug)}/reload`,
+    );
+    const result = response.data ?? {};
+    return {
+      success: result.success ?? false,
+      message: result.message ?? '',
+    };
+  }
 }
 
 /**