feat: pull --watch

.github/workflows/test.yml

@@ -24,6 +24,25 @@ jobs:
       - name: Run eslint
         run: npm run eslint
 
+  test-types:
+    name: Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 18
+      - name: Cache dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.npm
+          key: cache-node-modules-${{ runner.os }}-${{ hashFiles('**/package-lock.json') }}
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run type check
+        run: npm run test:types
+
   test-unit:
     strategy:
       matrix:
@@ -70,11 +89,24 @@ jobs:
         run: npm ci
       - name: Build CLI
         run: npm run build
-
       - name: Start Tolgee Container
         run: npm run tolgee:start
+        env:
+          RUNNER_DEBUG: 1
       - name: Run Tests
         run: npm run test:e2e
+      - name: Capture Docker Logs
+        run: |
+          mkdir -p docker-logs
+          docker logs tolgee_cli_e2e > docker-logs/tolgee-container.log 2>&1 || echo "Failed to capture Docker logs"
+        if: always()
+      - name: Upload Docker Logs
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: docker-logs-node-${{ matrix.node }}
+          path: docker-logs/
+          retention-days: 7
       - name: Stop Tolgee Container
         run: npm run tolgee:stop
         if: always()

HACKING.md

@@ -32,6 +32,21 @@ E2E test instance:
 - `tolgee:start`: Start the E2E testing instance. Will be available on port 22222.
 - `tolgee:stop`: Stop the E2E testing instance.
 
+### Using an alternative backend for testing
+
+By default, E2E tests will start a Docker container with Tolgee backend on port 22222. If you want to use an alternative backend (e.g., a development server running elsewhere), you can set the `TOLGEE_TEST_BACKEND_URL` environment variable:
+
+```bash
+# Use an alternative backend instead of Docker
+export TOLGEE_TEST_BACKEND_URL=http://localhost:8080
+npm run test:e2e
+
+# Or run with the environment variable inline
+TOLGEE_TEST_BACKEND_URL=http://localhost:8080 npm run test:e2e
+```
+
+When this environment variable is set, the Docker backend will not be started, and tests will use the specified URL instead.
+
 ## Code & internals overview
 
 ### Command parsing

package.json

@@ -30,6 +30,7 @@
   "author": "Jan Cizmar",
   "license": "MIT",
   "dependencies": {
+    "@stomp/stompjs": "^7.1.1",
     "ajv": "^8.17.1",
     "ansi-colors": "^4.1.3",
     "base32-decode": "^1.0.0",
@@ -38,10 +39,12 @@
     "json5": "^2.2.3",
     "jsonschema": "^1.5.0",
     "openapi-fetch": "0.13.1",
+    "sockjs-client": "^1.6.1",
     "tinyglobby": "^0.2.12",
     "unescape-js": "^1.1.4",
     "vscode-oniguruma": "^2.0.1",
     "vscode-textmate": "^9.1.0",
+    "ws": "^8.18.3",
     "yauzl": "^3.2.0"
   },
   "devDependencies": {
@@ -53,6 +56,7 @@
     "@types/eslint__js": "^8.42.3",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.10.1",
+    "@types/sockjs-client": "^1.5.4",
     "@types/yauzl": "^2.10.3",
     "cross-env": "^7.0.3",
     "eslint": "^9.16.0",

src/client/ExportClient.ts

@@ -5,7 +5,9 @@ import { ApiClient } from './ApiClient.js';
 export type ExportRequest = Omit<
   BodyOf<'/v2/projects/{projectId}/export', 'post'>,
   'zip'
->;
+> & {
+  ifNoneMatch?: string;
+};
 
 type SingleExportRequest = Omit<ExportRequest, 'languages'> & {
   languages: [string];
@@ -18,10 +20,16 @@ type ExportClientProps = {
 export const createExportClient = ({ apiClient }: ExportClientProps) => {
   return {
     async export(req: ExportRequest) {
-      const body = { ...req, zip: true };
+      const { ifNoneMatch, ...exportReq } = req;
+      const body = { ...exportReq, zip: true };
+      const headers: Record<string, string> = {};
+      if (ifNoneMatch) {
+        headers['If-None-Match'] = ifNoneMatch;
+      }
       const loadable = await apiClient.POST('/v2/projects/{projectId}/export', {
         params: { path: { projectId: apiClient.getProjectId() } },
         body: body,
+        headers,
         parseAs: 'blob',
       });
       return { ...loadable, data: loadable.data as unknown as Blob };