@sleep2agi/commhub-server 0.5.0-preview.8 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -18,7 +18,7 @@ PORT=9200 COMMHUB_AUTH_TOKEN=your-secret bunx @sleep2agi/commhub-server
18
18
  - REST: `http://0.0.0.0:9200/api/*` (Dashboard / 监控)
19
19
  - Health: `http://0.0.0.0:9200/health`
20
20
 
21
- ## MCP 工具 (17 个)
21
+ ## MCP 工具 (18 个)
22
22
 
23
23
  ### Agent 端 (从 Agent 调用)
24
24
  | 工具 | 说明 |
@@ -43,22 +43,50 @@ PORT=9200 COMMHUB_AUTH_TOKEN=your-secret bunx @sleep2agi/commhub-server
43
43
  | `get_session_status` | 单 session 详情 |
44
44
  | `broadcast` | 群发消息 |
45
45
 
46
- ## REST API
46
+ ## REST API (33 端点)
47
47
 
48
48
  | 端点 | 方法 | 说明 |
49
49
  |------|------|------|
50
50
  | `/health` | GET | 健康检查 (无需 auth) |
51
+ | `/mcp` | POST | MCP Streamable HTTP |
52
+ | **认证** | | |
53
+ | `/api/auth/register` | POST | 注册 → utok_ + ntok_ |
54
+ | `/api/auth/login` | POST | 登录 → utok_ |
55
+ | `/api/auth/me` | GET | 当前用户信息 |
56
+ | `/api/auth/me` | PUT | 修改资料 |
57
+ | `/api/auth/password` | POST | 修改密码 |
58
+ | `/api/auth/tokens` | GET | Token 列表 |
59
+ | `/api/auth/tokens` | POST | 创建 Token |
60
+ | `/api/auth/tokens/:id` | DELETE | 撤销 Token |
61
+ | `/api/auth/node-token` | POST | 创建节点网络 Token (ntok_) |
62
+ | **网络** | | |
63
+ | `/api/networks` | GET | 我的网络列表(成员网络) |
64
+ | `/api/networks` | POST | 创建网络 |
65
+ | `/api/networks/:id` | GET | 网络详情 + 统计 |
66
+ | `/api/networks/:id` | PUT | 重命名网络 |
67
+ | `/api/networks/:id` | DELETE | 删除网络 |
68
+ | `/api/networks/:id/members` | GET | 成员列表 |
69
+ | `/api/networks/:id/members` | POST | 添加成员 |
70
+ | `/api/networks/:id/members/:uid` | PUT | 修改成员角色 |
71
+ | `/api/networks/:id/members/:uid` | DELETE | 移除成员 |
72
+ | `/api/networks/:id/invite` | POST | 生成邀请码 |
73
+ | `/api/networks/join` | POST | 用邀请码加入 |
74
+ | **数据** | | |
51
75
  | `/api/status` | GET | 所有 session |
52
- | `/api/tasks` | GET | 任务列表 (支持 status/from_name/to_name/task_id/limit 过滤) |
53
- | `/api/nodes` | GET | 节点持久化信息 |
54
- | `/api/task_events` | GET | 任务审计日志 |
76
+ | `/api/tasks` | GET | 任务列表 |
77
+ | `/api/nodes` | GET | 节点信息 |
78
+ | `/api/stats` | GET | 统计汇总 |
55
79
  | `/api/messages` | GET | 消息列表 |
56
80
  | `/api/completions` | GET | 完成记录 |
57
- | `/mcp` | POST | MCP Streamable HTTP |
81
+ | `/api/task_events` | GET | 任务审计日志 |
82
+ | `/api/audit-log` | GET | 操作审计日志 |
83
+ | `/api/users` | GET | 用户列表 (admin) |
84
+ | `/api/license` | GET | License 状态 |
85
+ | `/api/license/activate` | POST | 激活授权码 |
58
86
 
59
- ## 数据库 (6 表)
87
+ ## 数据表 (13 表)
60
88
 
61
- SQLite WAL 模式, 自动创建在 `~/.commhub/commhub.db`
89
+ 自动创建,SQLite
62
90
 
63
91
  | 表 | 说明 |
64
92
  |---|------|
@@ -68,6 +96,13 @@ SQLite WAL 模式, 自动创建在 `~/.commhub/commhub.db`
68
96
  | `nodes` | 持久化节点身份 (11 列, 独立于 session) |
69
97
  | `completions` | 完成记录 (7 列) |
70
98
  | `task_events` | 审计日志 (7 列, 每次状态变化记录) |
99
+ | `users` | 用户 (username/password_hash/role/plan) |
100
+ | `networks` | 网络 (name/owner/visibility/max_members) |
101
+ | `api_tokens` | API Token (utok_/ntok_/atok_ + scope + network) |
102
+ | `audit_log` | 操作审计 (user/action/target/ip) |
103
+ | `licenses` | License (type/expires/limits) |
104
+ | `network_members` | 网络成员 (user ↔ network + role) |
105
+ | `network_invites` | 邀请码 (code/role/max_uses/expires) |
71
106
 
72
107
  任务状态机:
73
108
  ```
@@ -78,6 +113,22 @@ delivered → expired (5min patrol)
78
113
  delivered/acked/running → reassign → delivered (新agent)
79
114
  ```
80
115
 
116
+ ## 数据库 (SQLite + PostgreSQL)
117
+
118
+ 默认使用 SQLite(零配置),设置 `DATABASE_URL` 即切换到 PostgreSQL:
119
+
120
+ ```bash
121
+ # SQLite (默认,零配置)
122
+ bunx @sleep2agi/commhub-server
123
+
124
+ # PostgreSQL
125
+ DATABASE_URL=postgres://user:pass@localhost:5432/commhub bunx @sleep2agi/commhub-server
126
+ ```
127
+
128
+ PostgreSQL 模式需要 `pg` 包:`bun add pg`
129
+
130
+ 所有 SQL 自动翻译(datetime→NOW, 参数占位符→$N 等),代码零修改。
131
+
81
132
  ## 环境变量
82
133
 
83
134
  | 变量 | 默认 | 说明 |
@@ -85,13 +136,25 @@ delivered/acked/running → reassign → delivered (新agent)
85
136
  | `PORT` | 9200 | 监听端口 |
86
137
  | `HOST` | 0.0.0.0 | 监听地址 |
87
138
  | `COMMHUB_AUTH_TOKEN` | (无) | Bearer token 鉴权 |
88
- | `COMMHUB_DB` | ~/.commhub/commhub.db | 数据库路径 |
139
+ | `COMMHUB_DB` | ~/.commhub/commhub.db | SQLite 数据库路径 |
140
+ | `DATABASE_URL` | (无) | PostgreSQL 连接串 (设置后使用 PG) |
89
141
 
90
142
  ## 鉴权
91
143
 
92
- 设置 `COMMHUB_AUTH_TOKEN` 后, 所有端点需要 Bearer token:
93
- - Header: `Authorization: Bearer <token>`
94
- - Query: `?token=<token>`
144
+ 两种认证方式:
145
+ 1. **V3 用户系统** (推荐): `POST /api/auth/register` → 获取 `atok_xxx` token
146
+ 2. **全局 token** (传统): `COMMHUB_AUTH_TOKEN` 环境变量
147
+
148
+ Header: `Authorization: Bearer <token>` 或 Query: `?token=<token>`
149
+
150
+ ## V3 功能
151
+
152
+ - **用户系统**: 注册/登录/Token 认证
153
+ - **多网络**: 每个用户可创建多个独立网络
154
+ - **网络隔离**: 不同网络的数据完全隔离
155
+ - **试用授权**: 14 天免费试用, 到期需授权码
156
+ - **审计日志**: 所有操作记录
157
+ - **限流**: 注册 30/min, 登录 10/min (per IP)
95
158
  - `/health` 不需要 auth
96
159
 
97
160
  ## License
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@sleep2agi/commhub-server",
3
- "version": "0.5.0-preview.8",
4
- "description": "CommHub MCP Server AI Agent communication hub with SSE push, MCP protocol, and REST API",
3
+ "version": "0.5.0",
4
+ "description": "CommHub Server \u2014 AI Agent communication hub with MCP protocol, multi-network isolation, user auth, and 18 MCP tools.",
5
5
  "type": "module",
6
6
  "main": "src/index.ts",
7
7
  "bin": {
@@ -21,16 +21,18 @@
21
21
  "agent",
22
22
  "ai",
23
23
  "sse",
24
- "claude",
24
+ "server",
25
25
  "orchestration",
26
- "communication",
27
- "hub"
26
+ "multi-network",
27
+ "auth",
28
+ "license"
28
29
  ],
29
30
  "author": "sleep2agi",
30
31
  "license": "MIT",
32
+ "homepage": "https://anet.vansin.me",
31
33
  "repository": {
32
34
  "type": "git",
33
- "url": "https://github.com/sleep2agi/agent-comm-hub",
35
+ "url": "https://github.com/sleep2agi/agent-network",
34
36
  "directory": "server"
35
37
  },
36
38
  "engines": {
@@ -39,4 +41,4 @@
39
41
  "dependencies": {
40
42
  "@modelcontextprotocol/sdk": "^1.12.0"
41
43
  }
42
- }
44
+ }
package/src/auth.ts ADDED
@@ -0,0 +1,339 @@
1
+ /**
2
+ * V3 Auth module — user registration, login, token management
3
+ */
4
+ import { db, generateId, hashPassword, hashToken, generateToken, generateUserToken, generateNetworkToken, uuidv4 } from "./db.js";
5
+
6
+ export interface AuthUser {
7
+ user_id: string;
8
+ username: string;
9
+ display_name: string | null;
10
+ email: string | null;
11
+ role: string;
12
+ }
13
+
14
+ export interface AuthResult {
15
+ ok: boolean;
16
+ error?: string;
17
+ user?: AuthUser;
18
+ token?: string; // user token (utok_)
19
+ network_token?: string; // network token (ntok_) for default network
20
+ network_id?: string;
21
+ }
22
+
23
+ export function register(username: string, password: string, email?: string, displayName?: string): AuthResult {
24
+ if (!username || username.length < 2) return { ok: false, error: "username must be at least 2 characters" };
25
+ if (username.length > 50) return { ok: false, error: "username too long (max 50)" };
26
+ if (!password || password.length < 6) return { ok: false, error: "password must be at least 6 characters" };
27
+ if (!/^[a-zA-Z0-9_\-\u4e00-\u9fff]+$/.test(username)) return { ok: false, error: "username contains invalid characters" };
28
+
29
+ const existing = db.get<any>("SELECT user_id FROM users WHERE username = ?1", username);
30
+ if (existing) return { ok: false, error: "username already taken" };
31
+
32
+ // First user → auto admin
33
+ const userCount = db.get<{ cnt: number }>("SELECT COUNT(*) as cnt FROM users");
34
+ const isFirstUser = !userCount || userCount.cnt === 0;
35
+
36
+ const userId = generateId("u");
37
+ const pwHash = hashPassword(password);
38
+
39
+ db.run(
40
+ "INSERT INTO users (user_id, username, password_hash, email, display_name, role) VALUES (?1, ?2, ?3, ?4, ?5, ?6)",
41
+ [userId, username, pwHash, email || null, displayName || username, isFirstUser ? "admin" : "user"]
42
+ );
43
+
44
+ // Auto-create default network + add as owner member
45
+ const networkId = generateId("net");
46
+ db.run(
47
+ "INSERT INTO networks (network_id, network_name, owner_id, description) VALUES (?1, ?2, ?3, ?4)",
48
+ [networkId, "default", userId, "Auto-created default network"]
49
+ );
50
+ db.run(
51
+ "INSERT INTO network_members (network_id, user_id, role) VALUES (?1, ?2, 'owner')",
52
+ [networkId, userId]
53
+ );
54
+
55
+ // User token (utok_) — not bound to network, for CLI/Dashboard login
56
+ const userToken = generateUserToken();
57
+ const userTokenId = generateId("tok");
58
+ db.run(
59
+ "INSERT INTO api_tokens (token_id, token_hash, user_id, network_id, name, scope) VALUES (?1, ?2, ?3, ?4, ?5, ?6)",
60
+ [userTokenId, hashToken(userToken), userId, null, "user-login", "user"]
61
+ );
62
+
63
+ // Network token (ntok_) — bound to default network, for agent-node
64
+ const networkToken = generateNetworkToken();
65
+ const networkTokenId = generateId("tok");
66
+ db.run(
67
+ "INSERT INTO api_tokens (token_id, token_hash, user_id, network_id, name, scope) VALUES (?1, ?2, ?3, ?4, ?5, ?6)",
68
+ [networkTokenId, hashToken(networkToken), userId, networkId, "default-network", "network"]
69
+ );
70
+
71
+ return {
72
+ ok: true,
73
+ user: { user_id: userId, username, display_name: displayName || username, email: email || null, role: isFirstUser ? "admin" : "user" },
74
+ token: userToken,
75
+ network_token: networkToken,
76
+ network_id: networkId,
77
+ };
78
+ }
79
+
80
+ export function login(username: string, password: string): AuthResult {
81
+ const user = db.get<any>(
82
+ "SELECT user_id, username, password_hash, display_name, email, role FROM users WHERE username = ?1",
83
+ username);
84
+
85
+ if (!user) return { ok: false, error: "invalid username or password" };
86
+ if (user.password_hash !== hashPassword(password)) return { ok: false, error: "invalid username or password" };
87
+
88
+ // Issue a NEW user token — do NOT rotate/invalidate existing ones. Each
89
+ // login (cli, dashboard, second machine) gets its own row so they don't
90
+ // kick each other out of session. Tokens can be revoked via /api/auth/tokens.
91
+ const userToken = generateUserToken();
92
+ const tokenId = generateId("tok");
93
+ db.run(
94
+ "INSERT INTO api_tokens (token_id, token_hash, user_id, network_id, name, scope) VALUES (?1, ?2, ?3, ?4, ?5, ?6)",
95
+ [tokenId, hashToken(userToken), user.user_id, null, "user-login", "user"]
96
+ );
97
+
98
+ // Find default network
99
+ const defaultNet = db.get<any>(
100
+ "SELECT network_id FROM network_members WHERE user_id = ?1 ORDER BY role = 'owner' DESC LIMIT 1",
101
+ user.user_id);
102
+ const networkId = defaultNet?.network_id || null;
103
+
104
+ // Backward compat: also try old atok_ tokens
105
+ const token = userToken;
106
+
107
+ return {
108
+ ok: true,
109
+ user: { user_id: user.user_id, username: user.username, display_name: user.display_name, email: user.email, role: user.role },
110
+ token,
111
+ network_id: networkId,
112
+ };
113
+ }
114
+
115
+ /** Create a network-scoped token (ntok_) for a specific node */
116
+ export function createNetworkTokenForNode(userId: string, networkId: string, nodeName: string): { ok: boolean; token?: string; error?: string } {
117
+ // Verify user is a member of this network with write access
118
+ const role = getUserNetworkRole(userId, networkId);
119
+ if (!role || role === "viewer") return { ok: false, error: "no write access to this network" };
120
+ const token = generateNetworkToken();
121
+ const tokenId = generateId("tok");
122
+ db.run(
123
+ "INSERT INTO api_tokens (token_id, token_hash, user_id, network_id, name, scope) VALUES (?1, ?2, ?3, ?4, ?5, ?6)",
124
+ [tokenId, hashToken(token), userId, networkId, `node:${nodeName}`, "network"]
125
+ );
126
+ return { ok: true, token };
127
+ }
128
+
129
+ export function resolveToken(token: string): { user: AuthUser; networkId: string | null; tokenName: string | null } | null {
130
+ const tHash = hashToken(token);
131
+ const row = db.get<any>(
132
+ `SELECT t.user_id, t.network_id, t.scope, t.name AS token_name,
133
+ u.username, u.display_name, u.email, u.role
134
+ FROM api_tokens t JOIN users u ON t.user_id = u.user_id
135
+ WHERE t.token_hash = ?1 AND (t.expires_at IS NULL OR t.expires_at > datetime('now'))`,
136
+ tHash);
137
+
138
+ if (!row) return null;
139
+
140
+ // Update last_used
141
+ db.run("UPDATE api_tokens SET last_used_at = datetime('now') WHERE token_hash = ?1", [tHash]);
142
+
143
+ return {
144
+ user: { user_id: row.user_id, username: row.username, display_name: row.display_name, email: row.email, role: row.role },
145
+ networkId: row.network_id,
146
+ // tokenName carries the binding identity. For node-scoped ntok_, it's
147
+ // 'node:<alias>'; we strip the prefix and use it as the default
148
+ // from_session for any MCP send_task / send_message / etc, so peer
149
+ // agents see who actually called them (not 'hub').
150
+ tokenName: row.token_name || null,
151
+ };
152
+ }
153
+
154
+ export function getUserNetworks(userId: string) {
155
+ return db.all<any>(
156
+ "SELECT * FROM networks WHERE owner_id = ?1 ORDER BY created_at",
157
+ userId);
158
+ }
159
+
160
+ // Quota limits by plan
161
+ const QUOTAS: Record<string, { max_networks_owned: number; max_networks_joined: number }> = {
162
+ free: { max_networks_owned: 2, max_networks_joined: 3 },
163
+ pro: { max_networks_owned: 10, max_networks_joined: 20 },
164
+ admin: { max_networks_owned: Infinity, max_networks_joined: Infinity },
165
+ };
166
+
167
+ export function createNetwork(userId: string, name: string, description?: string) {
168
+ // Quota check
169
+ const user = db.get<any>("SELECT plan, role FROM users WHERE user_id = ?1", userId);
170
+ const plan = user?.role === "admin" ? "admin" : (user?.plan || "free");
171
+ const quota = QUOTAS[plan] || QUOTAS.free;
172
+ const ownedCount = db.get<{ cnt: number }>("SELECT COUNT(*) as cnt FROM networks WHERE owner_id = ?1", userId);
173
+ if ((ownedCount?.cnt || 0) >= quota.max_networks_owned) {
174
+ return { ok: false, error: `quota exceeded: max ${quota.max_networks_owned} networks for ${plan} plan` };
175
+ }
176
+
177
+ const existing = db.get<any>(
178
+ "SELECT network_id FROM networks WHERE owner_id = ?1 AND network_name = ?2",
179
+ userId, name);
180
+ if (existing) return { ok: false, error: "network name already exists" };
181
+
182
+ const networkId = generateId("net");
183
+ db.run(
184
+ "INSERT INTO networks (network_id, network_name, owner_id, description) VALUES (?1, ?2, ?3, ?4)",
185
+ [networkId, name, userId, description || null]
186
+ );
187
+ db.run(
188
+ "INSERT INTO network_members (network_id, user_id, role) VALUES (?1, ?2, 'owner')",
189
+ [networkId, userId]
190
+ );
191
+ return { ok: true, network_id: networkId, network_name: name };
192
+ }
193
+
194
+ export function listTokens(userId: string) {
195
+ return db.all<any>(
196
+ "SELECT token_id, name, scope, network_id, last_used_at, created_at FROM api_tokens WHERE user_id = ?1 ORDER BY created_at DESC",
197
+ userId);
198
+ }
199
+
200
+ export function renameNetwork(userId: string, networkId: string, newName: string): { ok: boolean; error?: string } {
201
+ const net = db.get<any>("SELECT * FROM networks WHERE network_id = ?1", networkId);
202
+ if (!net) return { ok: false, error: "network not found" };
203
+ if (net.owner_id !== userId) return { ok: false, error: "not your network" };
204
+ const dup = db.get<any>("SELECT network_id FROM networks WHERE owner_id = ?1 AND network_name = ?2", userId, newName);
205
+ if (dup) return { ok: false, error: "name already taken" };
206
+ db.run("UPDATE networks SET network_name = ?1, updated_at = datetime('now') WHERE network_id = ?2", [newName, networkId]);
207
+ return { ok: true };
208
+ }
209
+
210
+ export function deleteNetwork(userId: string, networkId: string): { ok: boolean; error?: string } {
211
+ const net = db.get<any>("SELECT * FROM networks WHERE network_id = ?1", networkId);
212
+ if (!net) return { ok: false, error: "network not found" };
213
+ if (net.owner_id !== userId) return { ok: false, error: "not your network" };
214
+ // Check if any sessions/tasks still reference this network
215
+ const sessions = db.get<{ cnt: number }>("SELECT COUNT(*) as cnt FROM sessions WHERE network_id = ?1", networkId);
216
+ if (sessions && sessions.cnt > 0) return { ok: false, error: `network has ${sessions.cnt} active session(s) — stop them first` };
217
+ db.run("DELETE FROM networks WHERE network_id = ?1 AND owner_id = ?2", [networkId, userId]);
218
+ return { ok: true };
219
+ }
220
+
221
+ export function createToken(userId: string, name: string, networkId?: string): { ok: boolean; token?: string; token_id?: string; error?: string } {
222
+ // Security: verify user is a member of the target network
223
+ if (networkId) {
224
+ const role = getUserNetworkRole(userId, networkId);
225
+ if (!role) return { ok: false, error: "not a member of this network" };
226
+ if (role === "viewer") return { ok: false, error: "viewer cannot create full-access network tokens" };
227
+ }
228
+ const token = generateToken();
229
+ const tokenId = generateId("tok");
230
+ db.run(
231
+ "INSERT INTO api_tokens (token_id, token_hash, user_id, network_id, name, scope) VALUES (?1, ?2, ?3, ?4, ?5, ?6)",
232
+ [tokenId, hashToken(token), userId, networkId || null, name, "full"]
233
+ );
234
+ return { ok: true, token, token_id: tokenId };
235
+ }
236
+
237
+ export function revokeToken(userId: string, tokenId: string): { ok: boolean; error?: string } {
238
+ const result = db.run("DELETE FROM api_tokens WHERE token_id = ?1 AND user_id = ?2", [tokenId, userId]);
239
+ return result.changes > 0 ? { ok: true } : { ok: false, error: "token not found" };
240
+ }
241
+
242
+ export function changePassword(userId: string, oldPassword: string, newPassword: string): { ok: boolean; error?: string } {
243
+ if (!newPassword || newPassword.length < 6) return { ok: false, error: "new password must be at least 6 characters" };
244
+ const user = db.get<any>("SELECT password_hash FROM users WHERE user_id = ?1", userId);
245
+ if (!user) return { ok: false, error: "user not found" };
246
+ if (user.password_hash !== hashPassword(oldPassword)) return { ok: false, error: "incorrect current password" };
247
+ db.run("UPDATE users SET password_hash = ?1, updated_at = datetime('now') WHERE user_id = ?2", [hashPassword(newPassword), userId]);
248
+ return { ok: true };
249
+ }
250
+
251
+ // ══════════════════════════════════════
252
+ // V3.13: Network Members
253
+ // ══════════════════════════════════════
254
+
255
+ export function getNetworkMembers(networkId: string) {
256
+ return db.all<any>(
257
+ `SELECT nm.user_id, nm.role, nm.joined_at, nm.invited_by, u.username, u.display_name
258
+ FROM network_members nm JOIN users u ON nm.user_id = u.user_id
259
+ WHERE nm.network_id = ?1 ORDER BY nm.joined_at`,
260
+ networkId);
261
+ }
262
+
263
+ export function getUserNetworkRole(userId: string, networkId: string): string | null {
264
+ const row = db.get<any>("SELECT role FROM network_members WHERE network_id = ?1 AND user_id = ?2", networkId, userId);
265
+ return row?.role || null;
266
+ }
267
+
268
+ export function addNetworkMember(networkId: string, userId: string, role: string, invitedBy?: string): { ok: boolean; error?: string } {
269
+ const existing = db.get<any>("SELECT 1 FROM network_members WHERE network_id = ?1 AND user_id = ?2", networkId, userId);
270
+ if (existing) return { ok: false, error: "user already a member" };
271
+ db.run("INSERT INTO network_members (network_id, user_id, role, invited_by) VALUES (?1, ?2, ?3, ?4)",
272
+ [networkId, userId, role, invitedBy || null]);
273
+ return { ok: true };
274
+ }
275
+
276
+ export function updateMemberRole(networkId: string, userId: string, newRole: string): { ok: boolean; error?: string } {
277
+ if (newRole === "owner") return { ok: false, error: "cannot assign owner role" };
278
+ const result = db.run("UPDATE network_members SET role = ?1 WHERE network_id = ?2 AND user_id = ?3 AND role != 'owner'",
279
+ [newRole, networkId, userId]);
280
+ return result.changes > 0 ? { ok: true } : { ok: false, error: "member not found or is owner" };
281
+ }
282
+
283
+ export function removeNetworkMember(networkId: string, userId: string): { ok: boolean; error?: string } {
284
+ const member = db.get<any>("SELECT role FROM network_members WHERE network_id = ?1 AND user_id = ?2", networkId, userId);
285
+ if (!member) return { ok: false, error: "not a member" };
286
+ if (member.role === "owner") return { ok: false, error: "cannot remove owner" };
287
+ db.run("DELETE FROM network_members WHERE network_id = ?1 AND user_id = ?2", [networkId, userId]);
288
+ return { ok: true };
289
+ }
290
+
291
+ // ══════════════════════════════════════
292
+ // V3.13: Invite Codes
293
+ // ══════════════════════════════════════
294
+
295
+ export function createInvite(networkId: string, createdBy: string, role: string = "member", maxUses: number = 1, expiresInDays?: number): { ok: boolean; invite_code?: string; error?: string } {
296
+ if (!["admin", "member", "viewer"].includes(role)) return { ok: false, error: "invalid role" };
297
+ const code = `inv_${crypto.randomUUID().replace(/-/g, "").slice(0, 12)}`;
298
+ const expiresAt = expiresInDays ? `datetime('now', '+${expiresInDays} days')` : null;
299
+ if (expiresAt) {
300
+ db.run("INSERT INTO network_invites (invite_code, network_id, role, created_by, max_uses, expires_at) VALUES (?1, ?2, ?3, ?4, ?5, datetime('now', ?6))",
301
+ [code, networkId, role, createdBy, maxUses, `+${expiresInDays} days`]);
302
+ } else {
303
+ db.run("INSERT INTO network_invites (invite_code, network_id, role, created_by, max_uses) VALUES (?1, ?2, ?3, ?4, ?5)",
304
+ [code, networkId, role, createdBy, maxUses]);
305
+ }
306
+ return { ok: true, invite_code: code };
307
+ }
308
+
309
+ export function joinByInvite(inviteCode: string, userId: string): { ok: boolean; network_id?: string; role?: string; error?: string } {
310
+ const invite = db.get<any>("SELECT * FROM network_invites WHERE invite_code = ?1", inviteCode);
311
+ if (!invite) return { ok: false, error: "invalid invite code" };
312
+ if (invite.max_uses > 0 && invite.used_count >= invite.max_uses) return { ok: false, error: "invite code fully used" };
313
+ if (invite.expires_at) {
314
+ const now = new Date().toISOString().replace("T", " ").slice(0, 19);
315
+ if (invite.expires_at < now) return { ok: false, error: "invite code expired" };
316
+ }
317
+ // Check not already member
318
+ const existing = db.get<any>("SELECT 1 FROM network_members WHERE network_id = ?1 AND user_id = ?2", invite.network_id, userId);
319
+ if (existing) return { ok: false, error: "already a member of this network" };
320
+ // Add member + increment used count
321
+ db.run("INSERT INTO network_members (network_id, user_id, role, invited_by) VALUES (?1, ?2, ?3, ?4)",
322
+ [invite.network_id, userId, invite.role, invite.created_by]);
323
+ db.run("UPDATE network_invites SET used_count = used_count + 1 WHERE invite_code = ?1", [inviteCode]);
324
+ // Auto-create a token for this network
325
+ const token = generateToken();
326
+ const tokenId = generateId("tok");
327
+ db.run("INSERT INTO api_tokens (token_id, token_hash, user_id, network_id, name, scope) VALUES (?1, ?2, ?3, ?4, ?5, ?6)",
328
+ [tokenId, hashToken(token), userId, invite.network_id, "auto-join", "full"]);
329
+ return { ok: true, network_id: invite.network_id, role: invite.role };
330
+ }
331
+
332
+ /** Get all networks a user is a member of (replaces owner-only query) */
333
+ export function getUserAllNetworks(userId: string) {
334
+ return db.all<any>(
335
+ `SELECT n.*, nm.role as member_role
336
+ FROM networks n JOIN network_members nm ON n.network_id = nm.network_id
337
+ WHERE nm.user_id = ?1 ORDER BY nm.role = 'owner' DESC, n.created_at`,
338
+ userId);
339
+ }