@ait-co/devtools 0.1.52 → 0.1.54-beta.0

package/README.en.md

@@ -6,7 +6,7 @@
 
 ![@ait-co/devtools — SDK mock + DevTools panel for Apps In Toss mini-apps](./assets/og/image.png)
 
-A mock library for the `@apps-in-toss/web-framework` SDK. Imports of `@apps-in-toss/web-bridge` and `@apps-in-toss/web-analytics` are also mocked.
+A mock library for the `@apps-in-toss/web-framework` SDK. Imports of `@apps-in-toss/webview-bridge` are also mocked. (2.x packages `@apps-in-toss/web-bridge` and `@apps-in-toss/web-analytics` are supported for back-compat.)
 
 Lets you develop and test Apps in Toss mini-apps in a **regular browser** — without the Toss app. All SDK features are simulated so you can move fast.
 
@@ -115,13 +115,9 @@ npm install -D @ait-co/devtools
 pnpm add -D @ait-co/devtools
 ```
 
-> **Supported SDK version**: `@apps-in-toss/web-framework >=2.5.0 <2.6.0` (peer, required).
+> **Supported SDK version**: `@apps-in-toss/web-framework 3.0.0-beta.9d42c0b` (beta, peer optional).
 >
-> devtools is only verified against SDK versions within that range. Installing an out-of-range SDK version
-> will cause the package manager to emit a peer warning at install time. Additionally, calling an API that
-> devtools has not yet mocked will throw a runtime error — this is intentional to prevent the
-> "works in devtools but fails with the real SDK" type of production incident. For missing APIs,
-> please [file an issue](https://github.com/apps-in-toss-community/devtools/issues).
+> devtools currently tracks the web-framework **3.0.0-beta** pre-release. Since beta versions are not resolved by `^3.0.0`, install using an exact pin: `@apps-in-toss/web-framework@3.0.0-beta.9d42c0b`. The peer range and pin will be updated when stable 3.0.0 GA ships. Calling an API that devtools has not yet mocked will throw a runtime error — please [file an issue](https://github.com/apps-in-toss-community/devtools/issues) for missing APIs.
 
 ## Reference consumer
 
@@ -158,17 +154,16 @@ config.plugins.push(aitDevtools.webpack());
 
 Turbopack does not support a plugin system, so use `resolveAlias` instead.
 
-- You also need to alias `@apps-in-toss/web-bridge` and `@apps-in-toss/web-analytics`.
+- You also need to alias `@apps-in-toss/webview-bridge`. (If you're on 2.x, alias `@apps-in-toss/web-bridge` and `@apps-in-toss/web-analytics` instead.)
 - Turbopack is generally only used with `next dev`, so no extra production guard is needed.
 
 ```js
-// next.config.js (Next.js 15+)
+// next.config.js (Next.js 15+, web-framework 3.0+)
 module.exports = {
   turbo: {
     resolveAlias: {
       '@apps-in-toss/web-framework': '@ait-co/devtools/mock',
-      '@apps-in-toss/web-bridge': '@ait-co/devtools/mock',
-      '@apps-in-toss/web-analytics': '@ait-co/devtools/mock',
+      '@apps-in-toss/webview-bridge': '@ait-co/devtools/mock',
     },
   },
 };
@@ -177,14 +172,13 @@ module.exports = {
 For Next.js 14 and below, use `experimental.turbo`:
 
 ```js
-// next.config.js (Next.js 14 and below)
+// next.config.js (Next.js 14 and below, web-framework 3.0+)
 module.exports = {
   experimental: {
     turbo: {
       resolveAlias: {
         '@apps-in-toss/web-framework': '@ait-co/devtools/mock',
-        '@apps-in-toss/web-bridge': '@ait-co/devtools/mock',
-        '@apps-in-toss/web-analytics': '@ait-co/devtools/mock',
+        '@apps-in-toss/webview-bridge': '@ait-co/devtools/mock',
       },
     },
   },
@@ -220,28 +214,26 @@ module.exports = {
 You can also configure the bundler's `resolve.alias` directly:
 
 ```ts
-// vite.config.ts
+// vite.config.ts (web-framework 3.0+)
 import { defineConfig } from 'vite';
 
 export default defineConfig({
   resolve: {
     alias: {
       '@apps-in-toss/web-framework': '@ait-co/devtools/mock',
-      '@apps-in-toss/web-bridge': '@ait-co/devtools/mock',
-      '@apps-in-toss/web-analytics': '@ait-co/devtools/mock',
+      '@apps-in-toss/webview-bridge': '@ait-co/devtools/mock',
     },
   },
 });
 ```
 
 ```js
-// webpack.config.js (Webpack requires absolute paths)
+// webpack.config.js (Webpack requires absolute paths, web-framework 3.0+)
 module.exports = {
   resolve: {
     alias: {
       '@apps-in-toss/web-framework': require.resolve('@ait-co/devtools/mock'),
-      '@apps-in-toss/web-bridge': require.resolve('@ait-co/devtools/mock'),
-      '@apps-in-toss/web-analytics': require.resolve('@ait-co/devtools/mock'),
+      '@apps-in-toss/webview-bridge': require.resolve('@ait-co/devtools/mock'),
     },
   },
 };

package/README.md

@@ -6,7 +6,7 @@
 
 ![@ait-co/devtools — SDK mock + DevTools panel for Apps In Toss mini-apps](./assets/og/image.png)
 
-`@apps-in-toss/web-framework` SDK의 mock 라이브러리입니다. `@apps-in-toss/web-bridge`, `@apps-in-toss/web-analytics` import도 함께 mock됩니다.
+`@apps-in-toss/web-framework` SDK의 mock 라이브러리입니다. `@apps-in-toss/webview-bridge` import도 함께 mock됩니다. (2.x의 `@apps-in-toss/web-bridge`, `@apps-in-toss/web-analytics`도 back-compat으로 지원.)
 
 앱인토스(Apps in Toss) 미니앱을 **일반 브라우저**에서 개발하고 테스트할 수 있게 해줍니다. 토스 앱 없이도 SDK의 모든 기능을 시뮬레이션하여 빠른 개발 사이클을 지원합니다.
 
@@ -115,13 +115,9 @@ npm install -D @ait-co/devtools
 pnpm add -D @ait-co/devtools
 ```
 
-> **지원 SDK 버전**: `@apps-in-toss/web-framework >=2.5.0 <2.6.0` (peer, required).
+> **지원 SDK 버전**: `@apps-in-toss/web-framework 3.0.0-beta.9d42c0b` (beta, peer optional).
 >
-> devtools는 위 범위의 SDK 버전에서만 동작이 검증됩니다. 범위 밖 SDK를 설치하면
-> 패키지 매니저가 install-time에 peer 경고를 표시합니다. 또한 devtools가 아직 mock하지
-> 않은 API를 호출하면 런타임에 에러가 발생합니다 — "devtools에서는 잘 되는데 실제 SDK에서는
-> 안 되는" 상황을 방지하기 위한 의도적 동작입니다. 누락된 API는
-> [이슈](https://github.com/apps-in-toss-community/devtools/issues)로 알려주세요.
+> 현재 devtools는 web-framework **3.0.0-beta** 프리릴리즈를 추적합니다. beta 버전은 `^3.0.0`으로 resolve되지 않으므로 설치 시 exact pin(`@apps-in-toss/web-framework@3.0.0-beta.9d42c0b`)을 사용하세요. stable 3.0.0 GA 출시 후 peer range와 pin이 업데이트됩니다. devtools가 아직 mock하지 않은 API를 호출하면 런타임에 에러가 발생합니다 — 누락된 API는 [이슈](https://github.com/apps-in-toss-community/devtools/issues)로 알려주세요.
 
 ## Reference consumer
 
@@ -158,17 +154,16 @@ config.plugins.push(aitDevtools.webpack());
 
 Turbopack은 플러그인 시스템을 지원하지 않으므로 `resolveAlias`를 사용합니다.
 
-- `@apps-in-toss/web-bridge`, `@apps-in-toss/web-analytics`도 함께 alias해야 합니다.
+- `@apps-in-toss/webview-bridge`도 함께 alias해야 합니다. (2.x를 사용 중이라면 `@apps-in-toss/web-bridge`, `@apps-in-toss/web-analytics`도 추가.)
 - Turbopack은 일반적으로 `next dev`에서만 사용되므로 별도의 production 가드가 필요하지 않습니다.
 
 ```js
-// next.config.js (Next.js 15+)
+// next.config.js (Next.js 15+, web-framework 3.0+)
 module.exports = {
   turbo: {
     resolveAlias: {
       '@apps-in-toss/web-framework': '@ait-co/devtools/mock',
-      '@apps-in-toss/web-bridge': '@ait-co/devtools/mock',
-      '@apps-in-toss/web-analytics': '@ait-co/devtools/mock',
+      '@apps-in-toss/webview-bridge': '@ait-co/devtools/mock',
     },
   },
 };
@@ -177,14 +172,13 @@ module.exports = {
 Next.js 14 이하에서는 `experimental.turbo`를 사용합니다:
 
 ```js
-// next.config.js (Next.js 14 이하)
+// next.config.js (Next.js 14 이하, web-framework 3.0+)
 module.exports = {
   experimental: {
     turbo: {
       resolveAlias: {
         '@apps-in-toss/web-framework': '@ait-co/devtools/mock',
-        '@apps-in-toss/web-bridge': '@ait-co/devtools/mock',
-        '@apps-in-toss/web-analytics': '@ait-co/devtools/mock',
+        '@apps-in-toss/webview-bridge': '@ait-co/devtools/mock',
       },
     },
   },
@@ -220,28 +214,26 @@ module.exports = {
 번들러의 `resolve.alias` 설정으로 직접 지정할 수도 있습니다:
 
 ```ts
-// vite.config.ts
+// vite.config.ts (web-framework 3.0+)
 import { defineConfig } from 'vite';
 
 export default defineConfig({
   resolve: {
     alias: {
       '@apps-in-toss/web-framework': '@ait-co/devtools/mock',
-      '@apps-in-toss/web-bridge': '@ait-co/devtools/mock',
-      '@apps-in-toss/web-analytics': '@ait-co/devtools/mock',
+      '@apps-in-toss/webview-bridge': '@ait-co/devtools/mock',
     },
   },
 });
 ```
 
 ```js
-// webpack.config.js (Webpack은 절대 경로 필요)
+// webpack.config.js (Webpack은 절대 경로 필요, web-framework 3.0+)
 module.exports = {
   resolve: {
     alias: {
       '@apps-in-toss/web-framework': require.resolve('@ait-co/devtools/mock'),
-      '@apps-in-toss/web-bridge': require.resolve('@ait-co/devtools/mock'),
-      '@apps-in-toss/web-analytics': require.resolve('@ait-co/devtools/mock'),
+      '@apps-in-toss/webview-bridge': require.resolve('@ait-co/devtools/mock'),
     },
   },
 };

package/dist/mcp/cli.js

@@ -3092,19 +3092,26 @@ var InMemoryDiagnosticsCollector = class {
 	}
 };
 /**
-* Reads the `@modelcontextprotocol/sdk` package version from the installed
-* package's `package.json`. Returns `null` on any error (missing file, JSON
-* parse failure, etc.) — diagnostics must never throw.
-*
-* Node-only — uses dynamic `import()` so it does not pollute the browser
-* module graph.
+* Returns the `@modelcontextprotocol/sdk` version baked in at build time via
+* the `__MCP_SDK_VERSION__` define (see `tsdown.config.ts`). Returns `null`
+* when the define is absent (unbundled test runs) and the runtime fallback
+* below also fails — diagnostics must never throw.
+*
+* The old implementation resolved `@modelcontextprotocol/sdk/package.json` at
+* runtime, but that subpath is NOT in the SDK's `exports` map, so the resolve
+* threw `ERR_PACKAGE_PATH_NOT_EXPORTED` and this always returned `null` in a
+* real bundle (issue #361). The build-time define sidesteps the exports gate.
+*
+* Kept `async` for call-site compatibility (`Promise.all` at the caller); the
+* body is synchronous apart from the best-effort fallback.
 */
 async function readMcpSdkVersion() {
 	try {
 		const { createRequire } = await import("node:module");
-		const pkgPath = createRequire(import.meta.url).resolve("@modelcontextprotocol/sdk/package.json");
+		const entry = createRequire(import.meta.url).resolve("@modelcontextprotocol/sdk");
+		const root = entry.slice(0, entry.indexOf("@modelcontextprotocol/sdk") + 25);
 		const { readFileSync } = await import("node:fs");
-		const raw = readFileSync(pkgPath, "utf8");
+		const raw = readFileSync(`${root}/package.json`, "utf8");
 		const parsed = JSON.parse(raw);
 		return typeof parsed.version === "string" ? parsed.version : null;
 	} catch {
@@ -3117,12 +3124,7 @@ async function readMcpSdkVersion() {
 * some test environments that skip the build step).
 */
 function readDevtoolsVersion() {
-	try {
-		const v = globalThis.__VERSION__;
-		return typeof v === "string" && v.length > 0 ? v : null;
-	} catch {
-		return null;
-	}
+	return "0.1.54-beta.0";
 }
 /**
 * Derives the next recommended action from a completed diagnostics snapshot.
@@ -3604,7 +3606,7 @@ function createDebugServer(deps) {
 	const collector = collectorDep ?? new InMemoryDiagnosticsCollector();
 	const server = new Server({
 		name: "ait-debug",
-		version: "0.1.52"
+		version: "0.1.54-beta.0"
 	}, { capabilities: { tools: { listChanged: true } } });
 	server.setRequestHandler(ListToolsRequestSchema, () => {
 		const conn = router.active;
@@ -4991,7 +4993,7 @@ function createDevServer(deps = {}) {
 	const aitSource = deps.aitSource ?? new HttpAitSource({ stateEndpoint });
 	const server = new Server({
 		name: "ait-devtools",
-		version: "0.1.52"
+		version: "0.1.54-beta.0"
 	}, { capabilities: { tools: {} } });
 	server.setRequestHandler(ListToolsRequestSchema, () => ({ tools: DEV_TOOL_DEFINITIONS.map((tool) => ({ ...tool })) }));
 	server.setRequestHandler(CallToolRequestSchema, async (request) => {