enpilink 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Alpic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,289 @@
+<div align="center">
+
+# enpilink
+
+**The open, account-free full-stack framework for [MCP Apps](https://github.com/modelcontextprotocol/ext-apps) — and the ChatGPT Apps SDK.**
+
+Build type-safe MCP servers whose tools render interactive **React views** inside
+Claude, ChatGPT, VS Code, Goose, and any other MCP-Apps-compatible host.
+
+<p>
+  <a href="https://github.com/enpitech/enpilink/blob/main/LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-8E2DE2.svg"></a>
+  <a href="https://github.com/modelcontextprotocol/ext-apps"><img alt="MCP Apps" src="https://img.shields.io/badge/MCP_Apps-compatible-4A00E0.svg"></a>
+  <img alt="Account-free" src="https://img.shields.io/badge/account-not_required-22c55e.svg">
+  <img alt="Tunnel: srv.us" src="https://img.shields.io/badge/tunnel-srv.us_(no_signup)-0ea5e9.svg">
+  <img alt="Interaction types" src="https://img.shields.io/badge/mcp--ui-tool_·_prompt_·_notify_·_intent-8E2DE2.svg">
+  <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-strict-3178c6.svg?logo=typescript&logoColor=white">
+  <img alt="Node" src="https://img.shields.io/badge/node-%3E%3D22-339933.svg?logo=node.js&logoColor=white">
+  <a href="https://github.com/enpitech/enpilink/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/enpitech/enpilink/actions/workflows/ci.yml/badge.svg"></a>
+  <a href="https://github.com/enpitech/enpilink/pulls"><img alt="PRs welcome" src="https://img.shields.io/badge/PRs-welcome-FF941F.svg"></a>
+</p>
+
+<sub>a fork of <a href="https://github.com/alpic-ai/skybridge"><code>alpic-ai/skybridge</code></a> · powered by</sub>
+
+<a href="https://enpitech.dev"><img src="docs/images/enpitech-logo.svg" alt="Enpitech" width="150"></a>
+
+</div>
+
+---
+
+## Account-free by design
+
+Local dev, public tunneling, and deploy all work with **no account, no token, and
+no vendor lock-in**:
+
+- **Account-free tunneling** via [srv.us](https://srv.us) — open and SSH-based, no
+  signup. `enpilink dev --tunnel` gives you a public `/mcp` URL in seconds and
+  auto-generates an SSH key at `~/.enpilink/id_ed25519` the first time.
+- **No telemetry** — zero analytics, no network calls, no embedded keys.
+- **Deploy anywhere** — `enpilink build` produces a standard Node server
+  (`node dist/__entry.js`); self-host on any platform or container.
+- **All five mcp-ui interaction types** — `tool`, `prompt`, `link`, `intent`, and `notify`.
+
+## MCP Apps compliance
+
+enpilink is a compliant **MCP Apps** framework, built on the official
+[`@modelcontextprotocol/ext-apps`](https://github.com/modelcontextprotocol/ext-apps)
+extension (stable spec `2026-01-26`). It serves view resources for both runtimes
+so the same view runs in either host:
+
+- `ui://views/ext-apps/*` — MCP Apps (Claude, Goose, VS Code, …)
+- `ui://views/apps-sdk/*` — ChatGPT Apps SDK
+
+## The mcp-ui interaction types
+
+An **interaction type** is one of the structured messages a view sends *back* to
+its host. The [mcp-ui](https://mcpui.dev) standard defines **five**, and enpilink
+supports all five (views send them through hooks, never raw `postMessage`):
+
+| Type | Hook | Behavior |
+|---|---|---|
+| `tool` | `useCallTool` | real on both runtimes |
+| `prompt` | `useSendFollowUpMessage` | real on both runtimes |
+| `link` | `useOpenExternal` | real on both runtimes |
+| `intent` | `useIntent` | no spec equivalent on either runtime; best-effort extension, may no-op on hosts that don't route it |
+| `notify` | `useNotify` | real MCP `notifications/message` on MCP Apps; best-effort extension on the ChatGPT Apps SDK |
+
+> These five are the standard's **view→host actions**. They're a subset of the
+> full hook API below (the rest of the hooks *read* host context or *control*
+> your own view). New to all this? See [`PRESENTATION.md`](PRESENTATION.md) for a
+> plain-language, diagram-led tour.
+
+`notify` and `intent` are guarded and additive: they never throw and degrade to
+a no-op (or a log line) on hosts without support. See
+[`docs/guides/interaction-types.mdx`](docs/guides/interaction-types.mdx) for the
+full per-runtime matrix.
+
+## All view hooks
+
+Everything a view can do from inside the iframe — import from `enpilink/web`.
+Hooks never touch raw `postMessage`; the bridge picks the right runtime call.
+
+| Hook | What it does | Runtime |
+|---|---|---|
+| **Interaction** | | |
+| `useCallTool` | Call a server tool from the view; returns `{ callTool, callToolAsync, data, status, error }` with pending/success/error state. | both |
+| `useSendFollowUpMessage` | Send a text message to the model as a user follow-up turn (`prompt`). | both |
+| `useNotify` | Surface a notification/status to the host: `notify({ message, level?, title?, data? })`. | both — real `notifications/message` on MCP Apps, best-effort on Apps SDK |
+| `useIntent` | Express a high-level intent for the host to route: `sendIntent({ name, params? })`. | both — best-effort extension, may no-op |
+| **Navigation / links** | | |
+| `useOpenExternal` | Open a URL outside the iframe via the host (use instead of `window.open`). | both |
+| `useSetOpenInAppUrl` | Override the URL the host's fullscreen "Open in app" affordance points to. | Apps SDK only (throws on MCP Apps) |
+| `useRequestClose` | Ask the host to dismiss/close the view. | both |
+| **Layout / display** | | |
+| `useDisplayMode` | Read and request the display mode — `inline` / `pip` / `fullscreen`. | both |
+| `useRequestModal` | Open the view in a host modal overlay; returns `{ isOpen, params, open }`. | both |
+| `useRequestSize` | Ask the host to resize the iframe to fit your content. | both |
+| `useLayout` | Read the visual environment — max height, safe-area insets, theme. | both |
+| **Context / data** | | |
+| `useToolInfo` | Read the typed `input` / `output` / metadata of the tool call that rendered this view. | both |
+| `useViewState` | `[state, setState]` persisted on the host across remounts of the view. | both |
+| `useUser` | Session-stable user/environment info (device type, hover/touch capability). | both |
+| **Files** | | |
+| `useFiles` | Host file operations — `upload`, `getDownloadUrl`, `selectFiles` (native picker). | Apps SDK only (throws on MCP Apps) |
+| `useDownload` | Download an MCP `EmbeddedResource` / `ResourceLink`'s contents via the host. | both |
+| **Advanced** | | |
+| `useRegisterViewTool` | Let the view expose its own tool to the host/model (app-provided tool). | MCP Apps only (no-op on Apps SDK) |
+
+> "both" = works on MCP Apps (Claude, Goose, VS Code…) and the ChatGPT Apps SDK.
+> Apps-SDK-only hooks throw on MCP Apps; MCP-Apps-only hooks no-op on the Apps SDK.
+
+---
+
+## Observability & Admin
+
+enpilink ships an **opt-in** observability + admin layer — **off by default**,
+with zero overhead and zero network when disabled (still no telemetry to us).
+
+- **Observability** — set `ENPILINK_ANALYTICS=1` to record per-tool-call volume,
+  latency (p50/p95/p99), and error rate, viewable in the Console **Dashboard**
+  with a **live log stream**. Try it with demo data:
+  `enpilink dev --mock` (deterministic, in-memory, no real traffic). See
+  [`docs/guides/observability.mdx`](docs/guides/observability.mdx).
+- **Configuration** — a typed config layer with **env > file > DB** precedence, a
+  **Configuration** admin tab for runtime settings, **env-only masked secrets**,
+  and a change **audit log**. See
+  [`docs/guides/configuration.mdx`](docs/guides/configuration.mdx).
+- **Admin (production)** — expose the Dashboard + Configuration in prod with
+  `enpilink start --admin` + `ENPILINK_ADMIN_TOKEN` (refuses to start without a
+  token). Two-tier auth keeps `/mcp` and the SPA shell public while gating the
+  data APIs behind a static bearer token; for SSO, front it with a reverse proxy
+  (Cloudflare Access / oauth2-proxy / Tailscale) or self-hosted OIDC. See
+  [`docs/guides/admin.mdx`](docs/guides/admin.mdx).
+- **Storage** — pluggable adapters: `memory` (dev), `sqlite` (prod default,
+  `ENPILINK_DB_PATH`), `postgres` (`ENPILINK_DB_URL`/`DATABASE_URL`/`PG*`), plus
+  `registerStorageAdapter` for custom backends, and optional **OpenTelemetry**
+  metrics export (`ENPILINK_OTEL=1` + `OTEL_EXPORTER_OTLP_ENDPOINT`). See
+  [`docs/guides/storage.mdx`](docs/guides/storage.mdx).
+
+---
+
+## Documentation
+
+**New here?** Read [`PRESENTATION.md`](PRESENTATION.md) first — a plain-language,
+diagram-led tour of the whole platform (what it solves, the standards, the
+technology, and how interaction types relate to hooks). No prior knowledge needed.
+
+There's **no hosted docs site yet** — the full docs run locally with
+[Mintlify](https://mintlify.com):
+
+```bash
+pnpm install
+pnpm docs:dev          # serves the docs at http://localhost:3000
+```
+
+What's inside [`docs/`](docs):
+
+- **API reference** ([`docs/api-reference/`](docs/api-reference)) — a page per
+  hook and core API (`useCallTool`, `useNotify`, `useViewState`, `registerTool`,
+  …), each with the signature, **a runnable example**, and runtime support. This
+  is the "what can I actually do with this hook" reference.
+- **Guides** ([`docs/guides/`](docs/guides)) — task-oriented: communicating with
+  the model, managing state, host-environment context, fetching data, the
+  interaction types, and the observability / configuration / admin / storage
+  layer.
+- **Concepts & fundamentals** — MCP Apps vs the Apps SDK, write-once-run-everywhere,
+  type safety, and data flow.
+- **Quickstart** — create a new app, add to an existing server, deploy, migrate.
+
+> Tip: you can also read any page directly as Markdown in [`docs/`](docs) on
+> GitHub — e.g. [`docs/api-reference/use-notify.mdx`](docs/api-reference/use-notify.mdx).
+
+---
+
+## Quickstart
+
+### Prerequisites
+
+- **Node.js ≥ 22**
+- `ssh` (ships with macOS/Linux) — only needed for `--tunnel`
+
+### Run the built-in kitchen-sink demo
+
+The fastest way to see everything is the bundled **kitchen-sink** showcase
+(a fictional store, *Northwind*): 9 tools, 9 views, all 4 interaction types,
+every host hook, deterministic mock data.
+
+```bash
+git clone https://github.com/enpitech/enpilink
+cd enpilink && pnpm install && pnpm run build
+
+cd examples/kitchen-sink
+pnpm dev          # Console + HMR at http://localhost:3000/
+pnpm dev:tunnel   # opens an account-free srv.us tunnel and prints a public /mcp URL
+```
+
+Then connect it to Claude:
+
+1. Copy the printed `https://<hash>.srv.us/mcp` URL.
+2. In Claude → **Settings → Connectors → Add custom connector**, paste that URL.
+3. Paste the contents of
+   [`examples/kitchen-sink/specs/SYSTEM_PROMPT.md`](examples/kitchen-sink/specs/SYSTEM_PROMPT.md)
+   into your Claude **project instructions** (MCP can't set a host system prompt,
+   so this tells the assistant which tools to call).
+
+### Scaffold a new app
+
+```bash
+npm create enpilink@latest my-app
+```
+
+> **POC distribution caveat.** `enpilink` and `@enpilink/console` are not yet
+> published to npm, so a freshly scaffolded app's `npm install` will fail on the
+> `workspace:*` ranges in the templates. For real distribution, publish both
+> packages to npm and run `node scripts/bump.js <version>` to rewrite the
+> templates' `workspace:*` ranges to `^<version>`. Until then, scaffold inside
+> this monorepo (the templates resolve via the workspace) or use local
+> `pnpm pack` tarballs. See [Status](#status) below.
+
+The account-free tunnel under the hood is just one SSH command:
+
+```bash
+ssh srv.us -R 1:localhost:<port>
+```
+
+enpilink wraps this with auto key-gen (`~/.enpilink/id_ed25519`), URL parsing,
+and auto-reconnect.
+
+---
+
+## CLI
+
+```bash
+enpilink dev [--tunnel] [-p <port>] [--open] [--mock]   # dev server + Console + HMR (alias: enpi)
+enpilink build                                           # compile server + views → dist/
+enpilink start [--admin]                                 # run the production build (node dist/__entry.js)
+enpilink create [dir]                                    # scaffold a new app (passthrough to create-enpilink)
+```
+
+### Production gotcha
+
+The production entry reads the **`__PORT`** environment variable (NOT `PORT`),
+defaulting to `3000`:
+
+```bash
+__PORT=8080 node dist/__entry.js
+```
+
+`enpilink start` sets `__PORT` for you. `enpilink build` also rewrites server
+`@/…` path aliases automatically, so you do **not** need `tsc-alias` in your own
+build scripts.
+
+---
+
+## Repo layout
+
+```
+enpilink/
+├── packages/
+│   ├── core/             → npm "enpilink": server framework + React hooks + Vite plugin + CLI (oclif + Ink)
+│   ├── console/          → "@enpilink/console": dashboard / config / playground / docs web UI
+│   └── create-enpilink/  → "create-enpilink": scaffolder (templates: blank, demo)
+├── examples/
+│   ├── kitchen-sink/     → the all-features showcase ("Northwind"); basis of the demo template
+│   └── manifest-ui/      → minimal single-view smoke-test example
+├── docs/                 → Mintlify documentation
+├── skills/               → agent skill for building enpilink apps
+└── scripts/              → version bump / overrides helpers
+```
+
+## Status
+
+This is a POC fork. Today:
+
+- ✅ Local dev, Console, HMR, build, and self-host all work account-free.
+- ✅ The account-free **srv.us** tunnel is live-verified end-to-end (the printed
+  `/mcp` URL round-trips over a real public tunnel and survives reconnects).
+- ⏳ **Real npm distribution** requires publishing `enpilink` + `@enpilink/console`
+  to npm, then running `node scripts/bump.js <version>`. Until then,
+  `npm create enpilink` is workspace-linked (works inside this repo / via local
+  tarballs, not from a bare `npm install`).
+
+## Attribution & license
+
+enpilink is released under the [MIT License](LICENSE). It is forked from
+[`alpic-ai/skybridge`](https://github.com/alpic-ai/skybridge) (MIT); the original
+copyright is retained in `LICENSE`, and the fork's changes are summarized in
+[`NOTICE`](NOTICE).
+
+Built and maintained by the [Enpitech](https://enpitech.dev) team.

package/bin/run.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { execute } from "@oclif/core";
+
+await execute({ dir: import.meta.url });

package/dist/cli/build-helpers.d.ts

@@ -0,0 +1,8 @@
+export declare const ENTRY_WRAPPER_CONTENT = "import { __setBuildManifest } from \"enpilink/server\";\nimport manifest from \"./vite-manifest.js\";\n\n__setBuildManifest(manifest);\n\nconst userMod = await import(\"./server.js\");\nexport default userMod.default;\n";
+export declare function emitEntryWrapper(distDir: string): void;
+export declare function emitManifestModule(manifestPath: string, outPath: string): void;
+export declare function rewriteServerAliases(root: string): Promise<void>;
+export declare const VERCEL_FUNCTION_NAME = "mcp";
+export declare const VERCEL_CONFIG: unknown;
+export declare const VERCEL_VC_CONFIG: unknown;
+export declare function emitVercelBuildOutput(root: string): Promise<void>;

package/dist/cli/build-helpers.js

@@ -0,0 +1,105 @@
+import { cpSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync, } from "node:fs";
+import path from "node:path";
+// Primes the manifest in enpilink's module scope, then dynamically imports
+// `./server.js` so user code runs *after* the side channel is set. The
+// dynamic import is load-bearing: a static `export { default } from ...` is
+// hoisted with the rest of the static graph and would evaluate `server.js`
+// before `__setBuildManifest` runs.
+export const ENTRY_WRAPPER_CONTENT = `import { __setBuildManifest } from "enpilink/server";
+import manifest from "./vite-manifest.js";
+
+__setBuildManifest(manifest);
+
+const userMod = await import("./server.js");
+export default userMod.default;
+`;
+export function emitEntryWrapper(distDir) {
+    writeFileSync(path.join(distDir, "__entry.js"), ENTRY_WRAPPER_CONTENT);
+}
+export function emitManifestModule(manifestPath, outPath) {
+    const manifest = readFileSync(manifestPath, "utf-8");
+    writeFileSync(outPath, `export default ${manifest};\n`);
+}
+// Rewrites TypeScript path aliases (e.g. `@/data` → `./data`) in the emitted
+// server JS under `dist/`. `tsc` itself does NOT rewrite path aliases in the
+// output, so a server that imports via `@/…` would throw ERR_MODULE_NOT_FOUND
+// at `node dist/__entry.js`. We run tsc-alias programmatically against the
+// project's tsconfig so `enpilink build` produces a runnable server regardless
+// of whether the user uses path aliases — no `tsc-alias` in their own scripts.
+//
+// Safe to run unconditionally: tsc-alias uses TypeScript's own config parser
+// and is a no-op when the project declares no `paths`. We only require a
+// tsconfig.json to exist (it always does for an enpilink app).
+export async function rewriteServerAliases(root) {
+    const configFile = path.join(root, "tsconfig.json");
+    if (!existsSync(configFile)) {
+        return;
+    }
+    const { replaceTscAliasPaths } = await import("tsc-alias");
+    await replaceTscAliasPaths({
+        configFile,
+        // The server's compiled JS lives in `dist/` (tsc `outDir`); rewrite aliases
+        // to relative imports there.
+        outDir: path.join(root, "dist"),
+    });
+}
+export const VERCEL_FUNCTION_NAME = "mcp";
+export const VERCEL_CONFIG = {
+    version: 3,
+    routes: [
+        {
+            src: "/assets/(.*)",
+            headers: { "Access-Control-Allow-Origin": "*" },
+            continue: true,
+        },
+        { handle: "filesystem" },
+        { src: "/(.*)", dest: `/${VERCEL_FUNCTION_NAME}` },
+    ],
+};
+export const VERCEL_VC_CONFIG = {
+    runtime: "nodejs22.x",
+    handler: "index.js",
+    launcherType: "Nodejs",
+    shouldAddHelpers: true,
+};
+// Emit a Build Output API tree under `.vercel/output/`. Bundling the server
+// with esbuild produces a self-contained function bundle, so we don't ship
+// `node_modules` and don't touch tracked paths like `api/` or `public/`.
+//
+// Entry is `dist/__entry.js` — the wrapper that primes the Vite manifest via
+// `__setBuildManifest` before importing user code. Bundling `dist/server.js`
+// directly would skip that priming and 500 on view resource reads when the
+// function falls back to `readFileSync('dist/assets/.vite/manifest.json')`
+// (Vercel functions don't ship `dist/`).
+export async function emitVercelBuildOutput(root) {
+    const outputDir = path.join(root, ".vercel", "output");
+    const funcDir = path.join(outputDir, "functions", `${VERCEL_FUNCTION_NAME}.func`);
+    const staticAssetsDir = path.join(outputDir, "static", "assets");
+    rmSync(outputDir, { recursive: true, force: true });
+    mkdirSync(funcDir, { recursive: true });
+    const { build } = await import("esbuild");
+    await build({
+        entryPoints: [path.join(root, "dist", "__entry.js")],
+        bundle: true,
+        platform: "node",
+        target: "node22",
+        format: "esm",
+        outfile: path.join(funcDir, "index.js"),
+        // Lets esbuild DCE dev-only branches that pull in vite/devtools.
+        define: { "process.env.NODE_ENV": '"production"' },
+        // Dev-only deps reachable from re-exports; safe to leave unresolved since
+        // the code paths that touch them are eliminated by the NODE_ENV define.
+        external: ["vite", "@enpilink/console"],
+        banner: {
+            // ESM bundles miss CJS interop globals that some deps reach for.
+            js: "import{createRequire}from'node:module';const require=createRequire(import.meta.url);",
+        },
+    });
+    writeFileSync(path.join(funcDir, ".vc-config.json"), `${JSON.stringify(VERCEL_VC_CONFIG, null, 2)}\n`);
+    writeFileSync(path.join(funcDir, "package.json"), `${JSON.stringify({ type: "module" }, null, 2)}\n`);
+    cpSync(path.join(root, "dist", "assets"), staticAssetsDir, {
+        recursive: true,
+    });
+    writeFileSync(path.join(outputDir, "config.json"), `${JSON.stringify(VERCEL_CONFIG, null, 2)}\n`);
+}
+//# sourceMappingURL=build-helpers.js.map

package/dist/cli/build-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-helpers.js","sourceRoot":"","sources":["../../src/cli/build-helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  cpSync,\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  rmSync,\n  writeFileSync,\n} from \"node:fs\";\nimport path from \"node:path\";\n\n// Primes the manifest in enpilink's module scope, then dynamically imports\n// `./server.js` so user code runs *after* the side channel is set. The\n// dynamic import is load-bearing: a static `export { default } from ...` is\n// hoisted with the rest of the static graph and would evaluate `server.js`\n// before `__setBuildManifest` runs.\nexport const ENTRY_WRAPPER_CONTENT = `import { __setBuildManifest } from \"enpilink/server\";\nimport manifest from \"./vite-manifest.js\";\n\n__setBuildManifest(manifest);\n\nconst userMod = await import(\"./server.js\");\nexport default userMod.default;\n`;\n\nexport function emitEntryWrapper(distDir: string): void {\n  writeFileSync(path.join(distDir, \"__entry.js\"), ENTRY_WRAPPER_CONTENT);\n}\n\nexport function emitManifestModule(\n  manifestPath: string,\n  outPath: string,\n): void {\n  const manifest = readFileSync(manifestPath, \"utf-8\");\n  writeFileSync(outPath, `export default ${manifest};\\n`);\n}\n\n// Rewrites TypeScript path aliases (e.g. `@/data` → `./data`) in the emitted\n// server JS under `dist/`. `tsc` itself does NOT rewrite path aliases in the\n// output, so a server that imports via `@/…` would throw ERR_MODULE_NOT_FOUND\n// at `node dist/__entry.js`. We run tsc-alias programmatically against the\n// project's tsconfig so `enpilink build` produces a runnable server regardless\n// of whether the user uses path aliases — no `tsc-alias` in their own scripts.\n//\n// Safe to run unconditionally: tsc-alias uses TypeScript's own config parser\n// and is a no-op when the project declares no `paths`. We only require a\n// tsconfig.json to exist (it always does for an enpilink app).\nexport async function rewriteServerAliases(root: string): Promise<void> {\n  const configFile = path.join(root, \"tsconfig.json\");\n  if (!existsSync(configFile)) {\n    return;\n  }\n  const { replaceTscAliasPaths } = await import(\"tsc-alias\");\n  await replaceTscAliasPaths({\n    configFile,\n    // The server's compiled JS lives in `dist/` (tsc `outDir`); rewrite aliases\n    // to relative imports there.\n    outDir: path.join(root, \"dist\"),\n  });\n}\n\nexport const VERCEL_FUNCTION_NAME = \"mcp\";\n\nexport const VERCEL_CONFIG: unknown = {\n  version: 3,\n  routes: [\n    {\n      src: \"/assets/(.*)\",\n      headers: { \"Access-Control-Allow-Origin\": \"*\" },\n      continue: true,\n    },\n    { handle: \"filesystem\" },\n    { src: \"/(.*)\", dest: `/${VERCEL_FUNCTION_NAME}` },\n  ],\n};\n\nexport const VERCEL_VC_CONFIG: unknown = {\n  runtime: \"nodejs22.x\",\n  handler: \"index.js\",\n  launcherType: \"Nodejs\",\n  shouldAddHelpers: true,\n};\n\n// Emit a Build Output API tree under `.vercel/output/`. Bundling the server\n// with esbuild produces a self-contained function bundle, so we don't ship\n// `node_modules` and don't touch tracked paths like `api/` or `public/`.\n//\n// Entry is `dist/__entry.js` — the wrapper that primes the Vite manifest via\n// `__setBuildManifest` before importing user code. Bundling `dist/server.js`\n// directly would skip that priming and 500 on view resource reads when the\n// function falls back to `readFileSync('dist/assets/.vite/manifest.json')`\n// (Vercel functions don't ship `dist/`).\nexport async function emitVercelBuildOutput(root: string): Promise<void> {\n  const outputDir = path.join(root, \".vercel\", \"output\");\n  const funcDir = path.join(\n    outputDir,\n    \"functions\",\n    `${VERCEL_FUNCTION_NAME}.func`,\n  );\n  const staticAssetsDir = path.join(outputDir, \"static\", \"assets\");\n\n  rmSync(outputDir, { recursive: true, force: true });\n  mkdirSync(funcDir, { recursive: true });\n\n  const { build } = await import(\"esbuild\");\n  await build({\n    entryPoints: [path.join(root, \"dist\", \"__entry.js\")],\n    bundle: true,\n    platform: \"node\",\n    target: \"node22\",\n    format: \"esm\",\n    outfile: path.join(funcDir, \"index.js\"),\n    // Lets esbuild DCE dev-only branches that pull in vite/devtools.\n    define: { \"process.env.NODE_ENV\": '\"production\"' },\n    // Dev-only deps reachable from re-exports; safe to leave unresolved since\n    // the code paths that touch them are eliminated by the NODE_ENV define.\n    external: [\"vite\", \"@enpilink/console\"],\n    banner: {\n      // ESM bundles miss CJS interop globals that some deps reach for.\n      js: \"import{createRequire}from'node:module';const require=createRequire(import.meta.url);\",\n    },\n  });\n\n  writeFileSync(\n    path.join(funcDir, \".vc-config.json\"),\n    `${JSON.stringify(VERCEL_VC_CONFIG, null, 2)}\\n`,\n  );\n  writeFileSync(\n    path.join(funcDir, \"package.json\"),\n    `${JSON.stringify({ type: \"module\" }, null, 2)}\\n`,\n  );\n\n  cpSync(path.join(root, \"dist\", \"assets\"), staticAssetsDir, {\n    recursive: true,\n  });\n\n  writeFileSync(\n    path.join(outputDir, \"config.json\"),\n    `${JSON.stringify(VERCEL_CONFIG, null, 2)}\\n`,\n  );\n}\n"]}

package/dist/cli/build-helpers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/build-helpers.test.js

@@ -0,0 +1,100 @@
+// @vitest-environment node
+// esbuild's invariant check on TextEncoder/Uint8Array trips jsdom's polyfill.
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, writeFileSync, } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { describe, expect, it } from "vitest";
+import { ENTRY_WRAPPER_CONTENT, emitEntryWrapper, emitManifestModule, emitVercelBuildOutput, rewriteServerAliases, VERCEL_CONFIG, VERCEL_VC_CONFIG, } from "./build-helpers.js";
+function mkTmp(prefix = "enpilink-build-helpers-") {
+    return mkdtempSync(path.join(tmpdir(), prefix));
+}
+describe("emitEntryWrapper", () => {
+    it("writes dist/__entry.js that primes the manifest before importing user code", () => {
+        const dir = mkTmp();
+        emitEntryWrapper(dir);
+        const out = readFileSync(path.join(dir, "__entry.js"), "utf-8");
+        expect(out).toBe(ENTRY_WRAPPER_CONTENT);
+        expect(out).toContain('import { __setBuildManifest } from "enpilink/server"');
+        expect(out).toContain('import manifest from "./vite-manifest.js"');
+        expect(out).toContain("__setBuildManifest(manifest)");
+        // Dynamic import is load-bearing: `server.js` must evaluate after the
+        // setter runs, so a static re-export wouldn't work.
+        expect(out).toContain('await import("./server.js")');
+        expect(out).toContain("export default userMod.default");
+    });
+});
+describe("emitManifestModule", () => {
+    it("inlines the JSON manifest as an ESM default export", () => {
+        const dir = mkTmp();
+        const inPath = path.join(dir, "manifest.json");
+        const outPath = path.join(dir, "vite-manifest.js");
+        const manifest = { "src/views/foo.tsx": { file: "assets/foo-abc.js" } };
+        writeFileSync(inPath, JSON.stringify(manifest));
+        emitManifestModule(inPath, outPath);
+        const out = readFileSync(outPath, "utf-8");
+        expect(out.startsWith("export default ")).toBe(true);
+        const literal = out
+            .slice("export default ".length)
+            .trim()
+            .replace(/;$/, "");
+        expect(JSON.parse(literal)).toEqual(manifest);
+    });
+});
+describe("rewriteServerAliases", () => {
+    it("rewrites `@/` path aliases to relative imports in dist server JS", async () => {
+        const root = mkTmp();
+        mkdirSync(path.join(root, "src", "data"), { recursive: true });
+        mkdirSync(path.join(root, "dist", "data"), { recursive: true });
+        writeFileSync(path.join(root, "tsconfig.json"), JSON.stringify({
+            compilerOptions: {
+                outDir: "./dist",
+                rootDir: "./src",
+                paths: { "@/*": ["./src/*"] },
+            },
+            include: ["src"],
+        }));
+        // tsc-alias resolves aliases against the *output* tree, so the target must
+        // exist in dist/ (it normally does — tsc emits it).
+        writeFileSync(path.join(root, "dist", "data", "index.js"), "export {};\n");
+        writeFileSync(path.join(root, "dist", "server.js"), 'import { TODAY } from "@/data/index.js";\nexport default TODAY;\n');
+        await rewriteServerAliases(root);
+        const out = readFileSync(path.join(root, "dist", "server.js"), "utf-8");
+        expect(out).not.toContain("@/data");
+        expect(out).toContain("./data/index.js");
+    });
+    it("is a no-op when the project declares no `paths`", async () => {
+        const root = mkTmp();
+        mkdirSync(path.join(root, "dist"), { recursive: true });
+        writeFileSync(path.join(root, "tsconfig.json"), JSON.stringify({ compilerOptions: { outDir: "./dist" } }));
+        const original = 'import { x } from "./local.js";\n';
+        writeFileSync(path.join(root, "dist", "server.js"), original);
+        await expect(rewriteServerAliases(root)).resolves.toBeUndefined();
+        expect(readFileSync(path.join(root, "dist", "server.js"), "utf-8")).toBe(original);
+    });
+    it("does nothing when there is no tsconfig.json", async () => {
+        const root = mkTmp();
+        await expect(rewriteServerAliases(root)).resolves.toBeUndefined();
+    });
+});
+describe("emitVercelBuildOutput", () => {
+    it("emits a Build Output API tree with bundled function and static assets", async () => {
+        const root = mkTmp();
+        mkdirSync(path.join(root, "dist", "assets"), { recursive: true });
+        writeFileSync(path.join(root, "dist", "server.js"), "export default function handler(_req, res) { res.end('ok'); }\n");
+        // Minimal `dist/__entry.js` (the real wrapper imports `enpilink/server`,
+        // which isn't resolvable in this test's tmp dir — the function-bundling
+        // contract we care about here is just "bundle whatever `__entry.js`
+        // imports into a single function file").
+        writeFileSync(path.join(root, "dist", "__entry.js"), "const userMod = await import('./server.js');\nexport default userMod.default;\n");
+        writeFileSync(path.join(root, "dist", "assets", "view-abc.js"), "/* bundled view */\n");
+        await emitVercelBuildOutput(root);
+        const outputDir = path.join(root, ".vercel", "output");
+        const funcDir = path.join(outputDir, "functions", "mcp.func");
+        expect(existsSync(path.join(funcDir, "index.js"))).toBe(true);
+        expect(JSON.parse(readFileSync(path.join(funcDir, ".vc-config.json"), "utf-8"))).toEqual(VERCEL_VC_CONFIG);
+        expect(JSON.parse(readFileSync(path.join(funcDir, "package.json"), "utf-8"))).toEqual({ type: "module" });
+        expect(JSON.parse(readFileSync(path.join(outputDir, "config.json"), "utf-8"))).toEqual(VERCEL_CONFIG);
+        expect(readFileSync(path.join(outputDir, "static", "assets", "view-abc.js"), "utf-8")).toContain("bundled view");
+    });
+});
+//# sourceMappingURL=build-helpers.test.js.map

package/dist/cli/build-helpers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-helpers.test.js","sourceRoot":"","sources":["../../src/cli/build-helpers.test.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,8EAA8E;AAC9E,OAAO,EACL,UAAU,EACV,SAAS,EACT,WAAW,EACX,YAAY,EACZ,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,SAAS,KAAK,CAAC,MAAM,GAAG,yBAAyB;IAC/C,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,4EAA4E,EAAE,GAAG,EAAE;QACpF,MAAM,GAAG,GAAG,KAAK,EAAE,CAAC;QACpB,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACtB,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;QAChE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CACnB,sDAAsD,CACvD,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,2CAA2C,CAAC,CAAC;QACnE,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAC;QACtD,sEAAsE;QACtE,oDAAoD;QACpD,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;QACrD,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,GAAG,GAAG,KAAK,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,EAAE,mBAAmB,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,CAAC;QACxE,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChD,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,GAAG;aAChB,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC;aAC/B,IAAI,EAAE;aACN,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC;QACrB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,aAAa,CACX,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,EAChC,IAAI,CAAC,SAAS,CAAC;YACb,eAAe,EAAE;gBACf,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE;aAC9B;YACD,OAAO,EAAE,CAAC,KAAK,CAAC;SACjB,CAAC,CACH,CAAC;QACF,2EAA2E;QAC3E,oDAAoD;QACpD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,cAAc,CAAC,CAAC;QAC3E,aAAa,CACX,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EACpC,mEAAmE,CACpE,CAAC;QAEF,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAEjC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;QACxE,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC;QACrB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,aAAa,CACX,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,EAChC,IAAI,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,CAC1D,CAAC;QACF,MAAM,QAAQ,GAAG,mCAAmC,CAAC;QACrD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;QAE9D,MAAM,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QAClE,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CACtE,QAAQ,CACT,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC;QACrB,MAAM,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACrF,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC;QACrB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,aAAa,CACX,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EACpC,iEAAiE,CAClE,CAAC;QACF,yEAAyE;QACzE,wEAAwE;QACxE,oEAAoE;QACpE,yCAAyC;QACzC,aAAa,CACX,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EACrC,iFAAiF,CAClF,CAAC;QACF,aAAa,CACX,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,EAChD,sBAAsB,CACvB,CAAC;QAEF,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAElC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACvD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QAE9D,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,CACJ,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAC,CACzE,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC5B,MAAM,CACJ,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CACtE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC9B,MAAM,CACJ,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,OAAO,CAAC,CAAC,CACvE,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACzB,MAAM,CACJ,YAAY,CACV,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,EACvD,OAAO,CACR,CACF,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["// @vitest-environment node\n// esbuild's invariant check on TextEncoder/Uint8Array trips jsdom's polyfill.\nimport {\n  existsSync,\n  mkdirSync,\n  mkdtempSync,\n  readFileSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport path from \"node:path\";\nimport { describe, expect, it } from \"vitest\";\nimport {\n  ENTRY_WRAPPER_CONTENT,\n  emitEntryWrapper,\n  emitManifestModule,\n  emitVercelBuildOutput,\n  rewriteServerAliases,\n  VERCEL_CONFIG,\n  VERCEL_VC_CONFIG,\n} from \"./build-helpers.js\";\n\nfunction mkTmp(prefix = \"enpilink-build-helpers-\") {\n  return mkdtempSync(path.join(tmpdir(), prefix));\n}\n\ndescribe(\"emitEntryWrapper\", () => {\n  it(\"writes dist/__entry.js that primes the manifest before importing user code\", () => {\n    const dir = mkTmp();\n    emitEntryWrapper(dir);\n    const out = readFileSync(path.join(dir, \"__entry.js\"), \"utf-8\");\n    expect(out).toBe(ENTRY_WRAPPER_CONTENT);\n    expect(out).toContain(\n      'import { __setBuildManifest } from \"enpilink/server\"',\n    );\n    expect(out).toContain('import manifest from \"./vite-manifest.js\"');\n    expect(out).toContain(\"__setBuildManifest(manifest)\");\n    // Dynamic import is load-bearing: `server.js` must evaluate after the\n    // setter runs, so a static re-export wouldn't work.\n    expect(out).toContain('await import(\"./server.js\")');\n    expect(out).toContain(\"export default userMod.default\");\n  });\n});\n\ndescribe(\"emitManifestModule\", () => {\n  it(\"inlines the JSON manifest as an ESM default export\", () => {\n    const dir = mkTmp();\n    const inPath = path.join(dir, \"manifest.json\");\n    const outPath = path.join(dir, \"vite-manifest.js\");\n    const manifest = { \"src/views/foo.tsx\": { file: \"assets/foo-abc.js\" } };\n    writeFileSync(inPath, JSON.stringify(manifest));\n    emitManifestModule(inPath, outPath);\n    const out = readFileSync(outPath, \"utf-8\");\n    expect(out.startsWith(\"export default \")).toBe(true);\n    const literal = out\n      .slice(\"export default \".length)\n      .trim()\n      .replace(/;$/, \"\");\n    expect(JSON.parse(literal)).toEqual(manifest);\n  });\n});\n\ndescribe(\"rewriteServerAliases\", () => {\n  it(\"rewrites `@/` path aliases to relative imports in dist server JS\", async () => {\n    const root = mkTmp();\n    mkdirSync(path.join(root, \"src\", \"data\"), { recursive: true });\n    mkdirSync(path.join(root, \"dist\", \"data\"), { recursive: true });\n    writeFileSync(\n      path.join(root, \"tsconfig.json\"),\n      JSON.stringify({\n        compilerOptions: {\n          outDir: \"./dist\",\n          rootDir: \"./src\",\n          paths: { \"@/*\": [\"./src/*\"] },\n        },\n        include: [\"src\"],\n      }),\n    );\n    // tsc-alias resolves aliases against the *output* tree, so the target must\n    // exist in dist/ (it normally does — tsc emits it).\n    writeFileSync(path.join(root, \"dist\", \"data\", \"index.js\"), \"export {};\\n\");\n    writeFileSync(\n      path.join(root, \"dist\", \"server.js\"),\n      'import { TODAY } from \"@/data/index.js\";\\nexport default TODAY;\\n',\n    );\n\n    await rewriteServerAliases(root);\n\n    const out = readFileSync(path.join(root, \"dist\", \"server.js\"), \"utf-8\");\n    expect(out).not.toContain(\"@/data\");\n    expect(out).toContain(\"./data/index.js\");\n  });\n\n  it(\"is a no-op when the project declares no `paths`\", async () => {\n    const root = mkTmp();\n    mkdirSync(path.join(root, \"dist\"), { recursive: true });\n    writeFileSync(\n      path.join(root, \"tsconfig.json\"),\n      JSON.stringify({ compilerOptions: { outDir: \"./dist\" } }),\n    );\n    const original = 'import { x } from \"./local.js\";\\n';\n    writeFileSync(path.join(root, \"dist\", \"server.js\"), original);\n\n    await expect(rewriteServerAliases(root)).resolves.toBeUndefined();\n    expect(readFileSync(path.join(root, \"dist\", \"server.js\"), \"utf-8\")).toBe(\n      original,\n    );\n  });\n\n  it(\"does nothing when there is no tsconfig.json\", async () => {\n    const root = mkTmp();\n    await expect(rewriteServerAliases(root)).resolves.toBeUndefined();\n  });\n});\n\ndescribe(\"emitVercelBuildOutput\", () => {\n  it(\"emits a Build Output API tree with bundled function and static assets\", async () => {\n    const root = mkTmp();\n    mkdirSync(path.join(root, \"dist\", \"assets\"), { recursive: true });\n    writeFileSync(\n      path.join(root, \"dist\", \"server.js\"),\n      \"export default function handler(_req, res) { res.end('ok'); }\\n\",\n    );\n    // Minimal `dist/__entry.js` (the real wrapper imports `enpilink/server`,\n    // which isn't resolvable in this test's tmp dir — the function-bundling\n    // contract we care about here is just \"bundle whatever `__entry.js`\n    // imports into a single function file\").\n    writeFileSync(\n      path.join(root, \"dist\", \"__entry.js\"),\n      \"const userMod = await import('./server.js');\\nexport default userMod.default;\\n\",\n    );\n    writeFileSync(\n      path.join(root, \"dist\", \"assets\", \"view-abc.js\"),\n      \"/* bundled view */\\n\",\n    );\n\n    await emitVercelBuildOutput(root);\n\n    const outputDir = path.join(root, \".vercel\", \"output\");\n    const funcDir = path.join(outputDir, \"functions\", \"mcp.func\");\n\n    expect(existsSync(path.join(funcDir, \"index.js\"))).toBe(true);\n    expect(\n      JSON.parse(readFileSync(path.join(funcDir, \".vc-config.json\"), \"utf-8\")),\n    ).toEqual(VERCEL_VC_CONFIG);\n    expect(\n      JSON.parse(readFileSync(path.join(funcDir, \"package.json\"), \"utf-8\")),\n    ).toEqual({ type: \"module\" });\n    expect(\n      JSON.parse(readFileSync(path.join(outputDir, \"config.json\"), \"utf-8\")),\n    ).toEqual(VERCEL_CONFIG);\n    expect(\n      readFileSync(\n        path.join(outputDir, \"static\", \"assets\", \"view-abc.js\"),\n        \"utf-8\",\n      ),\n    ).toContain(\"bundled view\");\n  });\n});\n"]}

package/dist/cli/detect-port.d.ts

@@ -0,0 +1,18 @@
+export declare function resolvePort(flagPort?: number): Promise<{
+    port: number;
+    fallback: boolean;
+    envWarning?: undefined;
+} | {
+    port: number;
+    fallback: boolean;
+    envWarning: string;
+}>;
+/**
+ * Returns the first available port at or after `startPort`, incrementing
+ * by one until a free port is found or `MAX_PORT_INCREMENT` is reached.
+ *
+ * @param host - Bind address for the check. Pass `"localhost"` for
+ *   services that bind to 127.0.0.1 (e.g. Vite HMR). Omit for
+ *   services that bind to all interfaces (e.g. the HTTP server).
+ */
+export declare function detectAvailablePort(startPort: number, host?: string): Promise<number>;