chore(infra) - Add openapi-ts:local script for local API development (#1025)

* Add openapi-ts:local script for local API development

This adds a new npm script `openapi-ts:local` that allows developers to generate TypeScript client code from a local OpenAPI gateway instance.

Changes:
- Add openapi-ts.config.local.ts for local gateway configuration
- Add scripts/cleanup-local-openapi.ts to remove /api/eor prefix from generated URLs
- Add npm script: openapi-ts:local
- Update openapi-ts.config.ts with clarifying comments about production vs local usage

Usage:
- Production: npm run openapi-ts (existing)
- Local development: npm run openapi-ts:local (new)

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix script

---------

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: gabrielseco

openapi-ts.config.local.ts

@@ -0,0 +1,8 @@
+import { defineConfig, defaultPlugins } from '@hey-api/openapi-ts';
+
+export default defineConfig({
+  // Local gateway with new endpoints
+  input: 'http://localhost:4000/api/eor/openapi',
+  output: 'src/client',
+  plugins: defaultPlugins,
+});

openapi-ts.config.ts

@@ -1,6 +1,8 @@
 import { defineConfig, defaultPlugins } from '@hey-api/openapi-ts';
 
 export default defineConfig({
+  // Production gateway - use npm run openapi-ts for production generation
+  // For local gateway with new endpoints, use npm run openapi-ts:local instead
   input: 'https://gateway.remote.com/v1/docs/openapi.json',
   output: 'src/client',
   plugins: defaultPlugins,

package.json

@@ -18,6 +18,7 @@
     "lint:workflows:fix": "zizmor --fix .github/workflows/",
     "format": "oxfmt",
     "openapi-ts": "openapi-ts && npm run format",
+    "openapi-ts:local": "openapi-ts -f openapi-ts.config.local.ts && tsx scripts/cleanup-local-openapi.ts && npm run format",
     "test": "vitest",
     "test:coverage": "vitest --coverage",
     "coverage:extract": "tsx scripts/extract-coverage.ts",

scripts/cleanup-local-openapi.ts

@@ -0,0 +1,47 @@
+import { readFileSync, writeFileSync } from 'fs';
+import { resolve } from 'path';
+
+/**
+ * Removes /api/eor prefix from generated OpenAPI client files
+ * This is needed when generating from local OpenAPI spec that includes the prefix
+ */
+function cleanupApiEorPrefix() {
+  const files = [
+    resolve(process.cwd(), 'src/client/sdk.gen.ts'),
+    resolve(process.cwd(), 'src/client/types.gen.ts'),
+  ];
+
+  let totalReplacements = 0;
+
+  for (const filePath of files) {
+    try {
+      let content = readFileSync(filePath, 'utf-8');
+      const originalContent = content;
+
+      // Replace /api/eor/ prefix with / (handles v1/, v2/, auth/, and any other paths)
+      content = content.replace(/url: '\/api\/eor\//g, "url: '/");
+
+      if (content !== originalContent) {
+        writeFileSync(filePath, content, 'utf-8');
+        const fileName = filePath.split('/').pop();
+        const replacements = (originalContent.match(/\/api\/eor\//g) || [])
+          .length;
+        console.log(`✓ Cleaned ${replacements} URLs in ${fileName}`);
+        totalReplacements += replacements;
+      }
+    } catch (error) {
+      console.error(`Error processing ${filePath}:`, error);
+      process.exit(1);
+    }
+  }
+
+  if (totalReplacements > 0) {
+    console.log(
+      `\n✓ Successfully removed /api/eor prefix from ${totalReplacements} URLs`,
+    );
+  } else {
+    console.log('\n✓ No /api/eor prefixes found');
+  }
+}
+
+cleanupApiEorPrefix();