chore: add automated user-service TypeScript types generation script

package.json

@@ -71,8 +71,10 @@
     "generate:api-types-manual": "npm exec -- openapi-typescript ./external_types/DatabaseCatalogAPI.yaml -o src/app/services/feeds/types.ts && eslint src/app/services/feeds/types.ts --fix",
     "generate:gbfs-validator-types:output": "npm exec -- openapi-typescript ./external_types/GbfsValidator.yaml -o $npm_config_output_file && eslint $npm_config_output_file --fix",
     "generate:gbfs-validator-types": "npm exec -- openapi-typescript ./external_types/GbfsValidator.yaml -o src/app/services/feeds/gbfs-validator-types.ts && eslint src/app/services/feeds/gbfs-validator-types.ts --fix",
-    "generate:user-api-types:output": "npm exec -- openapi-typescript ./external_types/UserServiceAPI.yaml -o $npm_config_output_file && eslint $npm_config_output_file --fix",
-    "generate:user-api-types": "npm exec -- openapi-typescript ./external_types/UserServiceAPI.yaml -o src/app/services/user-service-api-types.ts && eslint src/app/services/user-service-api-types.ts --fix",
+    "generate:user-api-types:output": "node scripts/generate-user-api-types.mjs",
+    "generate:user-api-types": "node scripts/generate-user-api-types.mjs src/app/services/user-service-api-types.ts",
+    "generate:user-api-types-manual:output": "npm exec -- openapi-typescript ./external_types/UserServiceAPI.yaml -o $npm_config_output_file && eslint $npm_config_output_file --fix",
+    "generate:user-api-types-manual": "npm exec -- openapi-typescript ./external_types/UserServiceAPI.yaml -o src/app/services/user-service-api-types.ts && eslint src/app/services/user-service-api-types.ts --fix",
     "new-worktree": "bash scripts/new-worktree.sh",
     "remove-worktree": "bash scripts/remove-worktree.sh"
   },

scripts/generate-user-api-types.mjs

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+/**
+ * Fetches the latest UserServiceAPI.yaml from MobilityData/mobility-feed-api
+ * GitHub release assets (or falls back to docs/UserServiceAPI.yaml),
+ * then runs openapi-typescript.
+ *
+ * Usage: node scripts/generate-user-api-types.mjs [output-path]
+ * Default output-path: src/app/services/user-service-api-types.ts
+ */
+
+import { execSync } from 'child_process';
+import { writeFileSync, unlinkSync } from 'fs';
+import { get as httpsGet } from 'https';
+import { tmpdir } from 'os';
+import { join } from 'path';
+
+function httpsGetWithRedirects(url) {
+  return new Promise((resolve, reject) => {
+    function request(requestUrl) {
+      httpsGet(requestUrl, { headers: { 'User-Agent': 'Node.js' } }, (res) => {
+        if ([301, 302, 307, 308].includes(res.statusCode)) {
+          return request(res.headers.location);
+        }
+        let data = '';
+        res.on('data', (chunk) => (data += chunk));
+        res.on('end', () => resolve({ statusCode: res.statusCode, body: data }));
+        res.on('error', reject);
+      }).on('error', reject);
+    }
+    request(url);
+  });
+}
+
+// Resolve output path from CLI arg or default
+const outputPath = process.argv[2] ?? 'src/app/services/user-service-api-types.ts';
+
+// 1. Fetch latest release tag
+console.log('Fetching latest release from MobilityData/mobility-feed-api...');
+const releaseRes = await httpsGetWithRedirects(
+  'https://api.github.com/repos/MobilityData/mobility-feed-api/releases/latest',
+);
+const { tag_name: tag } = JSON.parse(releaseRes.body);
+console.log(`Latest release: ${tag}`);
+
+// 2. Download the YAML asset (release download or fallback to repo docs) into a temp file
+let yamlUrl = `https://github.com/MobilityData/mobility-feed-api/releases/download/${tag}/UserServiceAPI.yaml`;
+console.log(`Checking release asset: ${yamlUrl}...`);
+let yamlRes = await httpsGetWithRedirects(yamlUrl);
+
+if (yamlRes.statusCode !== 200) {
+  yamlUrl = `https://raw.githubusercontent.com/MobilityData/mobility-feed-api/${tag}/docs/UserServiceAPI.yaml`;
+  console.log(`Release asset not found, fetching from repository docs: ${yamlUrl}...`);
+  yamlRes = await httpsGetWithRedirects(yamlUrl);
+}
+
+if (yamlRes.statusCode !== 200) {
+  yamlUrl = `https://raw.githubusercontent.com/MobilityData/mobility-feed-api/main/docs/UserServiceAPI.yaml`;
+  console.log(`Tag docs not found, fetching from main branch: ${yamlUrl}...`);
+  yamlRes = await httpsGetWithRedirects(yamlUrl);
+}
+
+if (yamlRes.statusCode !== 200) {
+  throw new Error(`Download failed: HTTP ${yamlRes.statusCode} for UserServiceAPI.yaml`);
+}
+
+const tmpSpec = join(tmpdir(), `UserServiceAPI-${tag}.yaml`);
+writeFileSync(tmpSpec, yamlRes.body, 'utf8');
+
+// 3. Generate TypeScript types, then clean up
+try {
+  execSync(`npm exec -- openapi-typescript "${tmpSpec}" -o "${outputPath}"`, { stdio: 'inherit' });
+  execSync(`npx eslint "${outputPath}" --fix`, { stdio: 'inherit' });
+} finally {
+  unlinkSync(tmpSpec);
+}