fix(minting-service): move handler sources out of api/ for Vercel deploy

The Nx esbuild build (PR #133) produced a correct Build Output API v3
layout under `.vercel/output/functions/api/*.func/`, but Vercel's
default Node builder still auto-detects `api/*.ts` at the project root
and runs `@vercel/node` on top of our output. That failed with
`api/health.ts: Emit skipped` because @vercel/node's tsc doesn't
resolve the workspace tsconfig paths.

Rename `apps/minting-service/api/` → `apps/minting-service/handlers/`
so Vercel's auto-detection finds nothing and falls back to the Build
Output API our buildCommand already produces. The deployed URL path
(`/api/health`, `/api/stripe-webhook`) is unchanged — esbuild still
emits to `.vercel/output/functions/api/<name>.func/`.

Co-Authored-By: Claude Opus 4 <noreply@anthropic.com>

Author: blove

apps/minting-service/api/health.ts apps/minting-service/handlers/health.tsapps/minting-service/api/health.ts renamed to apps/minting-service/handlers/health.ts

@@ -2,13 +2,16 @@
 /**
  * Builds the minting-service API functions using Vercel Build Output API v3.
  *
- * - Bundles each `api/*.ts` into a self-contained CommonJS module via esbuild,
- *   inlining workspace deps (@cacheplane/*) and npm deps alike so no install
- *   step is required inside each function directory.
+ * - Bundles each `handlers/*.ts` into a self-contained CommonJS module via
+ *   esbuild, inlining workspace deps (@cacheplane/*) and npm deps alike so no
+ *   install step is required inside each function directory.
  * - Writes to `.vercel/output/functions/api/<name>.func/` with the companion
  *   `.vc-config.json` Vercel's Node runtime expects.
  * - Writes `.vercel/output/config.json` at the top level so Vercel picks up
- *   the Build Output API layout instead of scanning `api/` for TS sources.
+ *   the Build Output API layout instead of scanning the rootDirectory for TS
+ *   sources. The sources live outside `api/` on purpose — Vercel otherwise
+ *   auto-runs @vercel/node on top of our build, which doesn't resolve the
+ *   workspace tsconfig paths and fails the deploy.
  *
  * Run via `nx build minting-service`, which sets `cwd` to this app.
  */
@@ -18,15 +21,15 @@ import { basename, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const appRoot = resolve(fileURLToPath(import.meta.url), '..', '..');
-const apiDir = join(appRoot, 'api');
+const handlersDir = join(appRoot, 'handlers');
 const outputRoot = join(appRoot, '.vercel', 'output');
 const functionsRoot = join(outputRoot, 'functions', 'api');
 
 async function listEntries() {
-  const files = await readdir(apiDir);
+  const files = await readdir(handlersDir);
   return files
     .filter((f) => f.endsWith('.ts') && !f.endsWith('.spec.ts') && !f.endsWith('.d.ts'))
-    .map((f) => join(apiDir, f));
+    .map((f) => join(handlersDir, f));
 }
 
 async function buildEntry(entry) {
@@ -74,7 +77,7 @@ async function main() {
 
   const entries = await listEntries();
   if (entries.length === 0) {
-    throw new Error(`no api entries found in ${apiDir}`);
+    throw new Error(`no handler entries found in ${handlersDir}`);
   }
 
   await Promise.all(entries.map(buildEntry));

…ps/minting-service/api/stripe-webhook.ts …nting-service/handlers/stripe-webhook.tsapps/minting-service/api/stripe-webhook.ts renamed to apps/minting-service/handlers/stripe-webhook.ts apps/minting-service/api/stripe-webhook.ts renamed to apps/minting-service/handlers/stripe-webhook.ts

@@ -10,6 +10,6 @@
     "declarationMap": false,
     "emitDeclarationOnly": false
   },
-  "include": ["src/**/*.ts", "api/**/*.ts", "scripts/**/*.ts"],
-  "exclude": ["src/**/*.spec.ts", "api/**/*.spec.ts", "scripts/**/*.spec.ts"]
+  "include": ["src/**/*.ts", "handlers/**/*.ts", "scripts/**/*.ts"],
+  "exclude": ["src/**/*.spec.ts", "handlers/**/*.spec.ts", "scripts/**/*.spec.ts"]
 }

apps/minting-service/scripts/build.mjs

@@ -4,5 +4,5 @@
     "outDir": "../../dist/out-tsc",
     "types": ["vitest/globals", "node"]
   },
-  "include": ["src/**/*.spec.ts", "api/**/*.spec.ts", "src/**/*.ts", "api/**/*.ts"]
+  "include": ["src/**/*.spec.ts", "handlers/**/*.spec.ts", "src/**/*.ts", "handlers/**/*.ts"]
 }

apps/minting-service/tsconfig.app.json

@@ -6,7 +6,7 @@ export default defineConfig({
   test: {
     environment: 'node',
     globals: true,
-    include: ['src/**/*.spec.ts', 'api/**/*.spec.ts', 'scripts/**/*.spec.ts'],
+    include: ['src/**/*.spec.ts', 'handlers/**/*.spec.ts', 'scripts/**/*.spec.ts'],
     passWithNoTests: true,
   },
 });