@aster110/cc2wechat 1.0.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,6 @@
+{
+  "id": "wechat-channel",
+  "name": "WeChat Channel",
+  "version": "1.0.0",
+  "description": "WeChat channel for Claude Code via iLink Bot API"
+}

package/.mcp.json

@@ -0,0 +1,6 @@
+{
+  "wechat-channel": {
+    "command": "node",
+    "args": ["dist/server.js"]
+  }
+}

package/EXPERIENCE.md

@@ -0,0 +1,148 @@
+# wechat-cc-channel 踩坑经验
+
+> 2026-03-22 首次开发 + 联调
+
+## 一、微信 iLink Bot API 踩坑
+
+### 1. API 发现过程
+
+微信官方给 OpenClaw 做了 `@tencent-weixin/openclaw-weixin` 插件，源码里暴露了完整的 iLink Bot API：
+
+- **Base URL**: `https://ilinkai.weixin.qq.com`
+- **CDN URL**: `https://novac2c.cdn.weixin.qq.com/c2c`
+- **协议**: HTTP JSON，长轮询
+
+这套 API 跟 OpenClaw 无关，是微信自己的 Bot 平台，可以独立使用。
+
+### 2. QR 登录流程
+
+```
+GET /ilink/bot/get_bot_qrcode?bot_type=3
+  → 返回 { qrcode: "xxx", qrcode_img_content: "https://..." }
+
+GET /ilink/bot/get_qrcode_status?qrcode=xxx
+  → 轮询，返回 { status: "wait"|"scaned"|"confirmed"|"expired" }
+  → confirmed 时返回 bot_token + ilink_bot_id
+```
+
+**坑 1**: `bot_type=3` 是关键参数，不传或传错值会失败。这个值是从 openclaw 插件源码里找到的（`DEFAULT_ILINK_BOT_TYPE = "3"`）。
+
+**坑 2**: 二维码有效期很短（约 2 分钟），需要自动刷新。openclaw 最多刷新 3 次。
+
+**坑 3**: `qrcode_img_content` 返回的是一个图片 URL，不是 base64。终端渲染用 qrcode-terminal 对这个 URL 生成二维码。
+
+### 3. 消息收发
+
+**getUpdates 长轮询**:
+- `POST /ilink/bot/getupdates`
+- `get_updates_buf` 是同步游标，首次传空字符串
+- 服务端建议的 `longpolling_timeout_ms` 通常是 35000ms
+- 客户端超时不算错误，重试即可
+
+**坑 4**: 必须带 `base_info: { channel_version: "1.0.0" }`，否则可能被拒绝。
+
+**坑 5**: Headers 很讲究：
+```
+Content-Type: application/json
+AuthorizationType: ilink_bot_token  // 固定值，不是 Bearer
+Authorization: Bearer <token>
+X-WECHAT-UIN: <random base64 uint32>  // 每次请求随机生成
+```
+
+**坑 6**: `context_token` 极其重要！每条消息带一个 context_token，回复时必须回传。不传就报错。
+
+### 4. sendMessage
+
+- `POST /ilink/bot/sendmessage`
+- Body: `{ msg: { to_user_id, context_token, item_list: [{ type: 1, text_item: { text } }] } }`
+- 微信有 4000 字符限制，需要分片
+
+### 5. Session 过期
+
+- `errcode = -14` 表示会话过期
+- 暂停 5 分钟后重试（openclaw 的策略）
+- 不需要重新扫码，用保存的 token 重新 getUpdates 即可
+
+## 二、MCP Server 踩坑
+
+### 6. stderr 不显示给用户
+
+MCP server 是 CC 的子进程，`process.stderr` 输出被 CC 内部捕获为日志，**用户终端看不到**。
+
+所以 login 二维码不能输出到 stderr，必须通过 tool 返回值或开网页展示。
+
+**解决方案**: 启动临时 HTTP server（localhost:18891），弹浏览器显示二维码页面。
+
+### 7. MCP tool 超时
+
+login tool 需要等用户扫码（最长 8 分钟），这会阻塞 tool call。CC 会显示 "running..."，用户可能以为卡了。
+
+**解决方案**: 页面侧定时轮询 `/status`，给用户实时反馈。
+
+### 8. Channel capability
+
+声明 `capabilities.experimental['claude/channel']: {}` 让 CC 识别为 channel。但这是 research preview 功能，可能需要特殊启动参数。
+
+实测：用户级 MCP 配置（`claude mcp add -s user`）也能加载 tools，但 channel notification push 是否被识别需要进一步测试。
+
+## 三、测试结果
+
+| 功能 | 状态 | 备注 |
+|------|------|------|
+| QR 扫码登录 | ✅ 通过 | bot_type=3，终端二维码可扫 |
+| 凭证持久化 | ✅ 通过 | ~/.claude/channels/wechat-channel/accounts.json |
+| 收文字消息 | ✅ 通过 | getUpdates 长轮询正常 |
+| 发文字消息 | ✅ 通过 | 中英文都 OK |
+| 发长消息 | ✅ 通过 | 510 字正常，分片逻辑备用 |
+| getConfig | ✅ 通过 | typing_ticket 获取正常 |
+| sendTyping | ✅ 通过 | 输入状态指示正常 |
+| 收图片消息 | ⏳ 待测 | item.type=2，需要 CDN 解密 |
+| 收语音消息 | ⏳ 待测 | item.type=3，voice_item.text 有 ASR 结果 |
+| 发图片消息 | ✅ 通过 | CDN 上传 + AES-128-ECB 加密，完整流程验证 |
+| 网页二维码 | ✅ HTTP server 正常 | localhost:18891 |
+| MCP tool 调用 | ⚠️ 部分 | login tool 阻塞问题已修（改为网页） |
+| Channel push | ⏳ 待测 | notifications/claude/channel 需要开新 CC 测 |
+
+## 四、架构决策
+
+| 决策 | 选择 | 理由 |
+|------|------|------|
+| 接入方式 | CC Channel (MCP) | 原生集成，不需要额外网关 |
+| 微信协议 | iLink Bot API | 微信官方，OpenClaw 已验证 |
+| 登录方式 | 网页二维码 | 终端二维码 MCP 下不可见 |
+| 凭证存储 | ~/.claude/channels/ | 跟 CC 生态一致 |
+| 不用 OpenClaw | 独立实现 | 减少依赖，代码量小（~1000行） |
+
+## 五、图片发送踩坑
+
+### 坑 7：直接传 image URL 不行
+
+sendMessage 的 `image_item.url` 字段虽然存在，但直接传远程 URL 微信显示"无法加载图片"。**必须走 CDN 上传流程**。
+
+### 坑 8：图片发送完整流程
+
+```
+1. 读取本地文件 → 算 rawsize + MD5
+2. 生成随机 AES-128 key (16 bytes)
+3. 算 ciphertext size: Math.ceil((rawsize + 1) / 16) * 16
+4. POST /ilink/bot/getuploadurl → 拿到 upload_param
+5. AES-128-ECB 加密文件内容（PKCS7 padding）
+6. POST CDN upload URL (application/octet-stream) → 拿到 x-encrypted-param header
+7. POST /ilink/bot/sendmessage → image_item.media.encrypt_query_param = downloadParam
+```
+
+关键参数：
+- `media_type: 1` = IMAGE
+- `no_need_thumb: true`（不传缩略图简化流程）
+- `aes_key` 在 getUploadUrl 和 image_item 里格式不同：
+  - getUploadUrl: hex string
+  - image_item.media.aes_key: base64(hex string)
+- CDN Base URL: `https://novac2c.cdn.weixin.qq.com/c2c`
+
+## 六、待解决
+
+1. **CDN 媒体上传/下载**：图片/文件需要 AES-128-ECB 加密，openclaw 插件有完整实现可参考
+2. **Channel notification 实测**：需要用 `--dangerously-load-development-channels` 启动 CC 测试
+3. **多账号支持**：当前只支持一个账号
+4. **重连机制**：token 失效后是否需要重新扫码？
+5. **npm 包发布**：package name、README、license

package/README.md

@@ -0,0 +1,66 @@
+# wechat-cc-channel
+
+WeChat channel plugin for Claude Code. Bridges WeChat messages (via iLink Bot API) into your local Claude Code session.
+
+## Architecture
+
+```
+WeChat user sends message
+    |
+    v
+iLink Bot API (ilinkai.weixin.qq.com)
+    |  long-poll /ilink/bot/getupdates
+    v
+wechat-cc-channel (MCP server, stdio)
+    |  server.notification('notifications/claude/channel')
+    v
+Claude Code session processes the message
+    |  Claude calls the reply tool
+    v
+MCP server -> /ilink/bot/sendmessage -> WeChat user
+```
+
+## Quick Start
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run with Claude Code (development mode)
+claude --dangerously-load-development-channels server:wechat-channel
+```
+
+## First-time Setup
+
+1. Start Claude Code with the channel loaded
+2. Claude will see "No saved account" — ask it to run the `login` tool
+3. Scan the QR code with WeChat
+4. Done! Messages will flow in automatically
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `login` | Scan QR code to connect WeChat account |
+| `reply` | Reply to a WeChat message (auto-strips markdown, auto-chunks long text) |
+
+## Storage
+
+Credentials stored in `~/.claude/channels/wechat-channel/`:
+- `accounts.json` — saved account tokens
+- `sync-buf-{accountId}.txt` — long-poll cursor (resume position)
+
+## Key Details
+
+- Messages longer than 3900 chars are automatically chunked
+- Markdown is stripped to plain text for WeChat
+- Typing indicators are sent while processing
+- Session expiry (errcode -14) triggers automatic pause and retry
+- All logs go to stderr (won't interfere with MCP stdio)
+
+## License
+
+MIT

package/dist/auth.d.ts

@@ -0,0 +1,15 @@
+export interface LoginResult {
+    token: string;
+    accountId: string;
+    baseUrl?: string;
+}
+/**
+ * Full QR login flow: fetch QR code, display in terminal, poll until confirmed.
+ * Writes to stderr so it doesn't interfere with stdio MCP transport.
+ */
+export declare function loginWithQR(baseUrl?: string): Promise<LoginResult>;
+/**
+ * Web-based QR login: opens a local browser page with the QR code.
+ * Solves the MCP stderr capture issue where terminal QR codes are invisible.
+ */
+export declare function loginWithQRWeb(baseUrl?: string): Promise<LoginResult>;

package/dist/auth.js

@@ -0,0 +1,230 @@
+import http from 'node:http';
+import { exec } from 'node:child_process';
+import { getQRCode, pollQRStatus } from './wechat-api.js';
+const MAX_QR_REFRESH = 3;
+const LOGIN_TIMEOUT_MS = 5 * 60_000;
+const QR_WEB_PORT = 18891;
+/**
+ * Full QR login flow: fetch QR code, display in terminal, poll until confirmed.
+ * Writes to stderr so it doesn't interfere with stdio MCP transport.
+ */
+export async function loginWithQR(baseUrl) {
+    let qrRefreshCount = 0;
+    while (qrRefreshCount < MAX_QR_REFRESH) {
+        qrRefreshCount++;
+        const qrResp = await getQRCode(baseUrl);
+        // Display QR code in terminal via stderr
+        process.stderr.write('\n--- Scan this QR code with WeChat ---\n');
+        try {
+            const qrterm = await import('qrcode-terminal');
+            // qrcode-terminal writes to stdout by default; we redirect
+            qrterm.default.generate(qrResp.qrcode_img_content, { small: true }, (qr) => {
+                process.stderr.write(qr + '\n');
+            });
+        }
+        catch {
+            process.stderr.write(`QR URL: ${qrResp.qrcode_img_content}\n`);
+        }
+        process.stderr.write('Waiting for scan...\n');
+        const deadline = Date.now() + LOGIN_TIMEOUT_MS;
+        let scannedLogged = false;
+        while (Date.now() < deadline) {
+            const status = await pollQRStatus(qrResp.qrcode, baseUrl);
+            switch (status.status) {
+                case 'wait':
+                    break;
+                case 'scaned':
+                    if (!scannedLogged) {
+                        process.stderr.write('Scanned! Confirm on your phone...\n');
+                        scannedLogged = true;
+                    }
+                    break;
+                case 'expired':
+                    process.stderr.write(`QR expired (${qrRefreshCount}/${MAX_QR_REFRESH}), refreshing...\n`);
+                    break;
+                case 'confirmed':
+                    if (!status.ilink_bot_id || !status.bot_token) {
+                        throw new Error('Login confirmed but missing bot_token or ilink_bot_id');
+                    }
+                    process.stderr.write('Login successful!\n');
+                    return {
+                        token: status.bot_token,
+                        accountId: status.ilink_bot_id,
+                        baseUrl: status.baseurl,
+                    };
+            }
+            if (status.status === 'expired')
+                break; // break inner loop to refresh QR
+            await new Promise((r) => setTimeout(r, 1000));
+        }
+    }
+    throw new Error('Login failed: QR code expired too many times');
+}
+// ---------------------------------------------------------------------------
+// Web-based QR login (opens browser, avoids stderr QR display issue in MCP)
+// ---------------------------------------------------------------------------
+function buildQRPage(qrUrl) {
+    return `<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <title>WeChat Login - Claude Code</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body { background: #1a1a2e; color: #e0e0e0; display: flex; align-items: center; justify-content: center; height: 100vh; font-family: system-ui, -apple-system, sans-serif; }
+    .container { text-align: center; }
+    h2 { font-size: 1.6rem; margin-bottom: 8px; }
+    .subtitle { color: #888; margin-bottom: 24px; }
+    #qr-container { margin: 0 auto 20px; }
+    #qr-img { width: 300px; height: 300px; border-radius: 12px; background: white; padding: 16px; }
+    #status { color: #888; font-size: 1.1rem; transition: color 0.3s; }
+    .success-box { background: #1e3a1e; border: 1px solid #5cb85c; border-radius: 12px; padding: 32px; margin-top: 16px; }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <h2>WeChat × Claude Code</h2>
+    <p class="subtitle">Scan with WeChat to connect</p>
+    <div id="qr-container">
+      <img id="qr-img" src="${qrUrl}" onerror="this.alt='QR failed to load: ${qrUrl}'" />
+    </div>
+    <p id="status">Waiting for scan...</p>
+  </div>
+  <script>
+    const poll = setInterval(async () => {
+      try {
+        const res = await fetch('/status');
+        const data = await res.json();
+        const el = document.getElementById('status');
+        if (data.status === 'scanned') {
+          el.textContent = 'Scanned! Confirm on your phone...';
+          el.style.color = '#f0ad4e';
+        } else if (data.status === 'success') {
+          el.textContent = 'Connected!';
+          el.style.color = '#5cb85c';
+          document.getElementById('qr-container').style.display = 'none';
+          clearInterval(poll);
+          setTimeout(() => window.close(), 3000);
+        } else if (data.status === 'expired') {
+          el.textContent = 'QR expired, refreshing...';
+          el.style.color = '#d9534f';
+          try {
+            const r2 = await fetch('/qr-refresh');
+            const d2 = await r2.json();
+            if (d2.url) {
+              document.getElementById('qr-img').src = d2.url;
+              el.textContent = 'QR refreshed, scan again...';
+              el.style.color = '#888';
+            }
+          } catch {}
+        } else if (data.status === 'failed') {
+          el.textContent = 'Login failed: ' + (data.message || 'unknown error');
+          el.style.color = '#d9534f';
+          clearInterval(poll);
+        }
+      } catch {}
+    }, 2000);
+  </script>
+</body>
+</html>`;
+}
+function openBrowser(url) {
+    const cmd = process.platform === 'darwin' ? 'open' : 'xdg-open';
+    exec(`${cmd} ${url}`, () => { });
+}
+/**
+ * Web-based QR login: opens a local browser page with the QR code.
+ * Solves the MCP stderr capture issue where terminal QR codes are invisible.
+ */
+export async function loginWithQRWeb(baseUrl) {
+    let currentStatus = 'waiting';
+    let currentQrUrl = '';
+    let failMessage = '';
+    let qrRefreshCount = 0;
+    let currentQrCode = ''; // the qrcode token for polling
+    // Fetch initial QR code
+    const qrResp = await getQRCode(baseUrl);
+    currentQrUrl = qrResp.qrcode_img_content;
+    currentQrCode = qrResp.qrcode;
+    qrRefreshCount = 1;
+    // Start HTTP server
+    const httpServer = http.createServer((req, res) => {
+        if (req.url === '/' || req.url === '') {
+            res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+            res.end(buildQRPage(currentQrUrl));
+            return;
+        }
+        if (req.url === '/status') {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ status: currentStatus, message: failMessage }));
+            return;
+        }
+        if (req.url === '/qr-refresh') {
+            // The refresh is triggered by the polling loop setting status to 'expired',
+            // but the actual new QR is fetched there too. Just return current URL.
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ url: currentQrUrl }));
+            return;
+        }
+        res.writeHead(404);
+        res.end('Not found');
+    });
+    await new Promise((resolve, reject) => {
+        httpServer.on('error', reject);
+        httpServer.listen(QR_WEB_PORT, () => resolve());
+    });
+    process.stderr.write(`[wechat-channel] QR login page at http://localhost:${QR_WEB_PORT}\n`);
+    openBrowser(`http://localhost:${QR_WEB_PORT}`);
+    // Poll for QR scan
+    try {
+        while (qrRefreshCount <= MAX_QR_REFRESH) {
+            const deadline = Date.now() + LOGIN_TIMEOUT_MS;
+            while (Date.now() < deadline) {
+                const status = await pollQRStatus(currentQrCode, baseUrl);
+                switch (status.status) {
+                    case 'wait':
+                        currentStatus = 'waiting';
+                        break;
+                    case 'scaned':
+                        currentStatus = 'scanned';
+                        break;
+                    case 'expired':
+                        currentStatus = 'expired';
+                        break;
+                    case 'confirmed':
+                        if (!status.ilink_bot_id || !status.bot_token) {
+                            throw new Error('Login confirmed but missing bot_token or ilink_bot_id');
+                        }
+                        currentStatus = 'success';
+                        // Give the browser a moment to show success
+                        await new Promise((r) => setTimeout(r, 500));
+                        return {
+                            token: status.bot_token,
+                            accountId: status.ilink_bot_id,
+                            baseUrl: status.baseurl,
+                        };
+                }
+                if (status.status === 'expired')
+                    break;
+                await new Promise((r) => setTimeout(r, 1000));
+            }
+            // Refresh QR
+            qrRefreshCount++;
+            if (qrRefreshCount <= MAX_QR_REFRESH) {
+                process.stderr.write(`[wechat-channel] QR expired (${qrRefreshCount - 1}/${MAX_QR_REFRESH}), refreshing...\n`);
+                const newQr = await getQRCode(baseUrl);
+                currentQrUrl = newQr.qrcode_img_content;
+                currentQrCode = newQr.qrcode;
+                currentStatus = 'waiting';
+            }
+        }
+        currentStatus = 'failed';
+        failMessage = 'QR code expired too many times';
+        throw new Error('Login failed: QR code expired too many times');
+    }
+    finally {
+        // Shut down HTTP server
+        httpServer.close();
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+import { execSync } from 'node:child_process';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { loginWithQRWeb } from './auth.js';
+import { saveAccount, getActiveAccount } from './store.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const serverPath = path.join(__dirname, 'server.js');
+const command = process.argv[2];
+function printUsage() {
+    console.log(`
+  🦞 wechat-claude — WeChat channel for Claude Code
+
+  Usage:
+    npx @aster110/wechat-claude install    Setup: register MCP + scan QR login
+    npx @aster110/wechat-claude login      Re-login (scan QR code)
+    npx @aster110/wechat-claude status     Check connection status
+    npx @aster110/wechat-claude help       Show this help
+`);
+}
+async function install() {
+    console.log('\n  🦞 wechat-claude installer\n');
+    // Step 1: Register MCP server
+    console.log('  [1/3] Registering MCP server...');
+    try {
+        execSync(`claude mcp add -s user wechat-channel node ${serverPath}`, { stdio: 'pipe' });
+        console.log('  ✅ MCP server registered (user-level)\n');
+    }
+    catch {
+        // May already exist, try remove + add
+        try {
+            execSync(`claude mcp remove -s user wechat-channel`, { stdio: 'pipe' });
+            execSync(`claude mcp add -s user wechat-channel node ${serverPath}`, { stdio: 'pipe' });
+            console.log('  ✅ MCP server updated (user-level)\n');
+        }
+        catch (err) {
+            console.error('  ⚠️  Failed to register MCP server. You may need to add it manually:');
+            console.log(`  claude mcp add -s user wechat-channel node ${serverPath}\n`);
+        }
+    }
+    // Step 2: QR Login
+    console.log('  [2/3] WeChat QR login...');
+    const existing = getActiveAccount();
+    if (existing) {
+        console.log(`  ℹ️  Found existing account: ${existing.accountId}`);
+        console.log('  Skipping login. Run "npx @aster110/wechat-claude login" to re-login.\n');
+    }
+    else {
+        try {
+            const result = await loginWithQRWeb();
+            saveAccount({
+                accountId: result.accountId.replace(/@/g, '-').replace(/\./g, '-'),
+                token: result.token,
+                baseUrl: result.baseUrl,
+                savedAt: new Date().toISOString(),
+            });
+            console.log(`  ✅ Login successful! Account: ${result.accountId}\n`);
+        }
+        catch (err) {
+            console.error(`  ❌ Login failed: ${err}`);
+            console.log('  Run "npx @aster110/wechat-claude login" to retry.\n');
+        }
+    }
+    // Step 3: Print next steps
+    console.log('  [3/3] Setup complete!\n');
+    console.log('  Next steps:');
+    console.log('  1. Start Claude Code with WeChat channel:');
+    console.log('     claude --dangerously-load-development-channels server:wechat-channel\n');
+    console.log('  2. Send a message to your WeChat — Claude Code will auto-reply!\n');
+}
+async function login() {
+    console.log('\n  🦞 WeChat QR Login\n');
+    try {
+        const result = await loginWithQRWeb();
+        saveAccount({
+            accountId: result.accountId.replace(/@/g, '-').replace(/\./g, '-'),
+            token: result.token,
+            baseUrl: result.baseUrl,
+            savedAt: new Date().toISOString(),
+        });
+        console.log(`\n  ✅ Login successful! Account: ${result.accountId}\n`);
+    }
+    catch (err) {
+        console.error(`\n  ❌ Login failed: ${err}\n`);
+        process.exit(1);
+    }
+}
+function status() {
+    const account = getActiveAccount();
+    if (account) {
+        console.log(`\n  🦞 WeChat Channel Status\n`);
+        console.log(`  Account: ${account.accountId}`);
+        console.log(`  Token: ${account.token.slice(0, 10)}...`);
+        console.log(`  Base URL: ${account.baseUrl || 'https://ilinkai.weixin.qq.com'}`);
+        console.log(`  Saved: ${account.savedAt}\n`);
+    }
+    else {
+        console.log('\n  ⚠️  Not logged in. Run: npx @aster110/wechat-claude install\n');
+    }
+}
+switch (command) {
+    case 'install':
+    case 'setup':
+        install().catch(console.error);
+        break;
+    case 'login':
+        login().catch(console.error);
+        break;
+    case 'status':
+        status();
+        break;
+    case 'help':
+    case '--help':
+    case '-h':
+    case undefined:
+        printUsage();
+        break;
+    default:
+        console.error(`  Unknown command: ${command}`);
+        printUsage();
+        process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};