dsh-workbench-vault 0.0.0-stage → 0.3.7

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.
@@ -0,0 +1,301 @@
1
+ /**
2
+ * 凭据分组与业务对象关联:vault 持有引用,业务插件用自身标识注册绑定。
3
+ * 不碰密文;subject_id 由调用方负责,vault 不校验业务对象是否存在。
4
+ */
5
+ import { bindingRow, groupRow, newId, now, tx } from "../db/db.js";
6
+ import { createSets } from "./sets.js";
7
+
8
+ function parseJson(value, fallback) {
9
+ try {
10
+ return value ? JSON.parse(value) : fallback;
11
+ } catch {
12
+ return fallback;
13
+ }
14
+ }
15
+
16
+ function assertGroupName(name) {
17
+ const value = String(name || "").trim();
18
+ if (!value || value.length > 60) throw new Error("组名必填,最多 60 字");
19
+ return value;
20
+ }
21
+
22
+ function assertSubjectType(type) {
23
+ const value = String(type || "").trim();
24
+ if (!/^[a-z][a-z0-9_-]{1,39}$/.test(value)) throw new Error("subjectType 必须是 2–40 位小写标识");
25
+ return value;
26
+ }
27
+
28
+ function assertSubjectId(id) {
29
+ const value = String(id || "").trim();
30
+ if (!value || value.length > 120) throw new Error("subjectId 必填,最多 120 字");
31
+ return value;
32
+ }
33
+
34
+ export function createGroups({ db }) {
35
+ const sets = createSets({ db });
36
+ function groupOrThrow(id) {
37
+ const row = db.prepare("SELECT * FROM vault_group WHERE id = ? AND deleted_at IS NULL").get(String(id || ""));
38
+ if (!row) throw new Error("分组不存在:" + id);
39
+ return row;
40
+ }
41
+
42
+ function groupList(args = {}) {
43
+ const q = String(args.q || "").trim();
44
+ const where = ["deleted_at IS NULL"];
45
+ const params = [];
46
+ if (q) {
47
+ where.push("(name LIKE ? OR description LIKE ?)");
48
+ params.push("%" + q + "%", "%" + q + "%");
49
+ }
50
+ const rows = db
51
+ .prepare("SELECT * FROM vault_group WHERE " + where.join(" AND ") + " ORDER BY name COLLATE NOCASE")
52
+ .all(...params);
53
+ const items = rows.map((row) => {
54
+ const secretCount = Number(
55
+ db
56
+ .prepare(
57
+ "SELECT COUNT(DISTINCT k.id) AS n FROM vault_secret k " +
58
+ "JOIN vault_set_secret ss ON ss.secret_id = k.id AND ss.deleted_at IS NULL " +
59
+ "JOIN vault_group_set gs ON gs.set_id = ss.set_id AND gs.deleted_at IS NULL " +
60
+ "WHERE gs.group_id = ? AND k.deleted_at IS NULL",
61
+ )
62
+ .get(row.id)?.n || 0,
63
+ );
64
+ const setCount = sets.setsOfGroup(row.id).length;
65
+ const bindingCount = Number(
66
+ db.prepare("SELECT COUNT(*) AS n FROM vault_binding WHERE group_id = ? AND deleted_at IS NULL").get(row.id)?.n || 0,
67
+ );
68
+ return { ...groupRow(row), secretCount, setCount, bindingCount };
69
+ });
70
+ return { items };
71
+ }
72
+
73
+ function groupCreate(args = {}) {
74
+ const name = assertGroupName(args.name);
75
+ const description = String(args.description || "").slice(0, 200);
76
+ const color = args.color ? String(args.color).slice(0, 20) : null;
77
+ const id = newId("grp");
78
+ const ts = now();
79
+ try {
80
+ db.prepare(
81
+ "INSERT INTO vault_group(id, name, description, color, created_at, updated_at, rev) VALUES(?, ?, ?, ?, ?, ?, 1)",
82
+ ).run(id, name, description, color, ts, ts);
83
+ } catch (error) {
84
+ const msg = String(error && error.message);
85
+ if (msg.includes("UNIQUE")) throw new Error("已有同名分组:" + name);
86
+ throw error;
87
+ }
88
+ return { id, ok: true };
89
+ }
90
+
91
+ function groupUpdate(args = {}) {
92
+ const row = groupOrThrow(args.id);
93
+ const name = args.name == null ? row.name : assertGroupName(args.name);
94
+ const description = args.description == null ? row.description : String(args.description).slice(0, 200);
95
+ const color = args.color === undefined ? row.color : args.color ? String(args.color).slice(0, 20) : null;
96
+ try {
97
+ db.prepare(
98
+ "UPDATE vault_group SET name = ?, description = ?, color = ?, updated_at = ?, rev = rev + 1 WHERE id = ?",
99
+ ).run(name, description, color, now(), row.id);
100
+ } catch (error) {
101
+ const msg = String(error && error.message);
102
+ if (msg.includes("UNIQUE")) throw new Error("已有同名分组:" + name);
103
+ throw error;
104
+ }
105
+ return { ok: true };
106
+ }
107
+
108
+ function groupDelete(args = {}) {
109
+ const row = groupOrThrow(args.id);
110
+ const ts = now();
111
+ let moveTo = null;
112
+ if (args.moveTo != null && args.moveTo !== "") {
113
+ const target = groupOrThrow(args.moveTo);
114
+ if (target.id === row.id) throw new Error("不能移动到被删除的分组自身");
115
+ moveTo = target.id;
116
+ }
117
+ tx(db, () => {
118
+ sets.relinkGroup(row.id, moveTo);
119
+ db.prepare(
120
+ "UPDATE vault_binding SET deleted_at = ?, updated_at = ?, rev = rev + 1 WHERE group_id = ? AND deleted_at IS NULL",
121
+ ).run(ts, ts, row.id);
122
+ db.prepare("UPDATE vault_group SET deleted_at = ?, updated_at = ?, rev = rev + 1 WHERE id = ?").run(ts, ts, row.id);
123
+ });
124
+ return { ok: true };
125
+ }
126
+
127
+ function subjectRegister(args = {}) {
128
+ const type = assertSubjectType(args.type);
129
+ const title = String(args.title || "").trim().slice(0, 80);
130
+ if (!title) throw new Error("title 必填");
131
+ const description = String(args.description || "").slice(0, 200);
132
+ const ts = now();
133
+ const existing = db.prepare("SELECT id FROM vault_subject_type WHERE type = ?").get(type);
134
+ if (existing) {
135
+ db.prepare(
136
+ "UPDATE vault_subject_type SET title = ?, description = ?, updated_at = ?, rev = rev + 1 WHERE id = ?",
137
+ ).run(title, description, ts, existing.id);
138
+ } else {
139
+ db.prepare(
140
+ "INSERT INTO vault_subject_type(id, type, title, description, updated_at, rev) VALUES(?, ?, ?, ?, ?, 1)",
141
+ ).run(newId("sub"), type, title, description, ts);
142
+ }
143
+ return { ok: true };
144
+ }
145
+
146
+ function bind(args = {}) {
147
+ const subjectType = assertSubjectType(args.subjectType);
148
+ const subjectId = assertSubjectId(args.subjectId);
149
+ const groupId = String(args.groupId || "");
150
+ groupOrThrow(groupId);
151
+ const existing = db
152
+ .prepare(
153
+ "SELECT * FROM vault_binding WHERE subject_type = ? AND subject_id = ? AND group_id = ? AND deleted_at IS NULL",
154
+ )
155
+ .get(subjectType, subjectId, groupId);
156
+ if (existing) return { id: existing.id, ok: true, existing: true };
157
+ const ts = now();
158
+ const id = newId("bnd");
159
+ try {
160
+ db.prepare(
161
+ "INSERT INTO vault_binding(id, subject_type, subject_id, group_id, created_at, updated_at, rev) " +
162
+ "VALUES(?, ?, ?, ?, ?, ?, 1)",
163
+ ).run(id, subjectType, subjectId, groupId, ts, ts);
164
+ } catch (error) {
165
+ const msg = String(error && error.message);
166
+ if (msg.includes("UNIQUE")) {
167
+ const row = db
168
+ .prepare("SELECT * FROM vault_binding WHERE subject_type = ? AND subject_id = ? AND group_id = ?")
169
+ .get(subjectType, subjectId, groupId);
170
+ if (row) {
171
+ db.prepare(
172
+ "UPDATE vault_binding SET deleted_at = NULL, updated_at = ?, rev = rev + 1 WHERE id = ?",
173
+ ).run(ts, row.id);
174
+ return { id: row.id, ok: true, existing: true };
175
+ }
176
+ }
177
+ throw error;
178
+ }
179
+ return { id, ok: true };
180
+ }
181
+
182
+ function unbind(args = {}) {
183
+ const subjectType = assertSubjectType(args.subjectType);
184
+ const subjectId = assertSubjectId(args.subjectId);
185
+ const groupId = args.groupId == null ? "" : String(args.groupId);
186
+ const ts = now();
187
+ const where = ["subject_type = ?", "subject_id = ?", "deleted_at IS NULL"];
188
+ const params = [subjectType, subjectId];
189
+ if (groupId) {
190
+ where.push("group_id = ?");
191
+ params.push(groupId);
192
+ }
193
+ const info = db
194
+ .prepare("UPDATE vault_binding SET deleted_at = ?, updated_at = ?, rev = rev + 1 WHERE " + where.join(" AND "))
195
+ .run(ts, ts, ...params);
196
+ return { ok: true, removed: Number(info.changes || 0) };
197
+ }
198
+
199
+ function bindingsOf(args = {}) {
200
+ const subjectType = assertSubjectType(args.subjectType);
201
+ const subjectId = assertSubjectId(args.subjectId);
202
+ const rows = db
203
+ .prepare(
204
+ "SELECT b.*, g.name AS group_name, g.color AS group_color FROM vault_binding b " +
205
+ "LEFT JOIN vault_group g ON g.id = b.group_id " +
206
+ "WHERE b.subject_type = ? AND b.subject_id = ? AND b.deleted_at IS NULL ORDER BY g.name COLLATE NOCASE",
207
+ )
208
+ .all(subjectType, subjectId);
209
+ return {
210
+ items: rows.map((row) => ({
211
+ ...bindingRow(row),
212
+ groupName: row.group_name || "",
213
+ groupColor: row.group_color || null,
214
+ secretCount: Number(
215
+ db
216
+ .prepare(
217
+ "SELECT COUNT(DISTINCT k.id) AS n FROM vault_secret k " +
218
+ "JOIN vault_set_secret ss ON ss.secret_id = k.id AND ss.deleted_at IS NULL " +
219
+ "JOIN vault_group_set gs ON gs.set_id = ss.set_id AND gs.deleted_at IS NULL " +
220
+ "WHERE gs.group_id = ? AND k.deleted_at IS NULL",
221
+ )
222
+ .get(row.group_id)?.n || 0,
223
+ ),
224
+ })),
225
+ };
226
+ }
227
+
228
+ function subjectsOf(args = {}) {
229
+ const groupId = String(args.groupId || "");
230
+ groupOrThrow(groupId);
231
+ const limit = Math.max(1, Math.min(200, Number(args.limit) || 100));
232
+ const offset = Math.max(0, Number(args.offset) || 0);
233
+ const rows = db
234
+ .prepare(
235
+ "SELECT b.subject_type, b.subject_id, t.title FROM vault_binding b " +
236
+ "LEFT JOIN vault_subject_type t ON t.type = b.subject_type " +
237
+ "WHERE b.group_id = ? AND b.deleted_at IS NULL ORDER BY b.updated_at DESC LIMIT ? OFFSET ?",
238
+ )
239
+ .all(groupId, limit, offset);
240
+ return {
241
+ items: rows.map((row) => ({
242
+ subjectType: row.subject_type,
243
+ subjectId: row.subject_id,
244
+ title: row.title || "",
245
+ })),
246
+ limit,
247
+ offset,
248
+ };
249
+ }
250
+
251
+ function bindingPurge(args = {}) {
252
+ const subjectType = assertSubjectType(args.subjectType);
253
+ const subjectId = args.subjectId == null ? "" : String(args.subjectId);
254
+ const where = ["subject_type = ?"];
255
+ const params = [subjectType];
256
+ if (subjectId) {
257
+ where.push("subject_id = ?");
258
+ params.push(subjectId);
259
+ }
260
+ const info = db.prepare("DELETE FROM vault_binding WHERE " + where.join(" AND ")).run(...params);
261
+ return { ok: true, removed: Number(info.changes || 0) };
262
+ }
263
+
264
+ function subjectSecrets(args = {}) {
265
+ const subjectType = assertSubjectType(args.subjectType);
266
+ const subjectId = assertSubjectId(args.subjectId);
267
+ const rows = db
268
+ .prepare(
269
+ "SELECT DISTINCT s.*, ss.set_id AS set_id FROM vault_secret s " +
270
+ "JOIN vault_set_secret ss ON ss.secret_id = s.id AND ss.deleted_at IS NULL " +
271
+ "JOIN vault_group_set gs ON gs.set_id = ss.set_id AND gs.deleted_at IS NULL " +
272
+ "JOIN vault_binding b ON b.group_id = gs.group_id " +
273
+ "WHERE b.subject_type = ? AND b.subject_id = ? AND b.deleted_at IS NULL AND s.deleted_at IS NULL " +
274
+ "AND gs.group_id = b.group_id ORDER BY s.name COLLATE NOCASE",
275
+ )
276
+ .all(subjectType, subjectId);
277
+ return {
278
+ items: rows.map((row) => ({
279
+ id: row.id,
280
+ name: row.name,
281
+ kind: row.kind,
282
+ setId: row.set_id || null,
283
+ meta: parseJson(row.meta, {}),
284
+ })),
285
+ };
286
+ }
287
+
288
+ return {
289
+ groupList,
290
+ groupCreate,
291
+ groupUpdate,
292
+ groupDelete,
293
+ subjectRegister,
294
+ bind,
295
+ unbind,
296
+ bindingsOf,
297
+ subjectsOf,
298
+ bindingPurge,
299
+ subjectSecrets,
300
+ };
301
+ }
@@ -0,0 +1,128 @@
1
+ /**
2
+ * 0.2.x → 0.3.0 数据迁移:把「分组直属凭据」收进集合,并把站点专属 kind 收口。
3
+ * 只有解锁拿到 DEK 后才能重加密,因此入口是 unlock() 成功之后。
4
+ * 整批一个事务:任一步失败回滚,schema_version 保持 2,下次解锁重试。
5
+ */
6
+ import { hasColumn, headerGet, headerSet, now, tx } from "../db/db.js";
7
+ import { open, seal, secretAad } from "../infra/crypto.js";
8
+ import { createSets } from "./sets.js";
9
+
10
+ const SITE_NAME = /^site\.[^.]+\.([^.]+)\.([^.]+)$/;
11
+ const FIELD_KIND = { password: "password", phone: "phone", identity: "id_card" };
12
+ const FIELD_LABEL = { password: "密码", phone: "手机号", identity: "身份证号" };
13
+
14
+ function uniqueSecretName(db, base) {
15
+ let name = base;
16
+ let n = 2;
17
+ while (db.prepare("SELECT 1 FROM vault_secret WHERE name = ? AND deleted_at IS NULL").get(name)) {
18
+ name = base + " #" + n;
19
+ n += 1;
20
+ }
21
+ return name;
22
+ }
23
+
24
+ export function migrateToV3({ db, dek, log = () => {} }) {
25
+ const head = headerGet(db);
26
+ if (!head) return { migrated: false, reason: "uninitialized" };
27
+ if (Number(head.schema_version || 0) >= 3) return { migrated: false, reason: "current" };
28
+ if (!dek) return { migrated: false, reason: "locked" };
29
+
30
+ const sets = createSets({ db });
31
+ const hasGroupColumn = hasColumn(db, "vault_secret", "group_id");
32
+ const stats = { groups: 0, sets: 0, linked: 0, converted: 0, orphaned: 0 };
33
+
34
+ tx(db, () => {
35
+ const defaultSets = new Map();
36
+
37
+ function defaultSetOf(groupId) {
38
+ if (!groupId) return null;
39
+ if (!defaultSets.has(groupId)) {
40
+ const row = sets.ensureDefaultSet(groupId);
41
+ defaultSets.set(groupId, row.id);
42
+ stats.sets += 1;
43
+ stats.groups += 1;
44
+ }
45
+ return defaultSets.get(groupId);
46
+ }
47
+
48
+ // 1) 旧分组仍持有的直属凭据 → 「<组名> · 默认」集合
49
+ if (hasGroupColumn) {
50
+ const groupIds = db
51
+ .prepare("SELECT DISTINCT group_id FROM vault_secret WHERE group_id IS NOT NULL AND deleted_at IS NULL")
52
+ .all()
53
+ .map((row) => row.group_id);
54
+ for (const groupId of groupIds) {
55
+ const setId = defaultSetOf(groupId);
56
+ if (!setId) continue;
57
+ const rows = db
58
+ .prepare("SELECT id FROM vault_secret WHERE group_id = ? AND deleted_at IS NULL")
59
+ .all(groupId);
60
+ for (const row of rows) {
61
+ const res = sets.linkSecret(setId, row.id);
62
+ if (!res.existing) stats.linked += 1;
63
+ }
64
+ }
65
+
66
+ // 2) 站点专属 kind 收口:解析长名、重加密、并入 accountId 集合
67
+ const siteRows = db
68
+ .prepare("SELECT * FROM vault_secret WHERE kind = 'site-account' AND deleted_at IS NULL")
69
+ .all();
70
+ let orphanSetId = null;
71
+ for (const row of siteRows) {
72
+ const groupId = row.group_id || null;
73
+ const match = SITE_NAME.exec(String(row.name || ""));
74
+ let setId = groupId ? defaultSetOf(groupId) : null;
75
+ let kind = "other";
76
+ let nextName = null;
77
+ let plain = null;
78
+ try {
79
+ plain = open(dek, row.ciphertext, secretAad(row.id, row.name, "site-account"));
80
+ } catch (error) {
81
+ log("迁移失败:无法解密 site-account " + row.id, String(error && error.message));
82
+ stats.orphaned += 1;
83
+ if (!setId) {
84
+ if (!orphanSetId) {
85
+ orphanSetId = sets.ensureSet("迁移收件箱").id;
86
+ stats.sets += 1;
87
+ }
88
+ setId = orphanSetId;
89
+ }
90
+ db.prepare(
91
+ "UPDATE vault_secret SET kind = 'other', updated_at = ?, rev = rev + 1 WHERE id = ?",
92
+ ).run(now(), row.id);
93
+ if (setId) sets.linkSecret(setId, row.id);
94
+ continue;
95
+ }
96
+
97
+ if (match) {
98
+ const accountId = match[1];
99
+ const field = match[2];
100
+ kind = FIELD_KIND[field] || "other";
101
+ const base = accountId + " · " + (FIELD_LABEL[field] || "其它");
102
+ nextName = uniqueSecretName(db, base);
103
+ const accountSet = sets.ensureSet(accountId);
104
+ stats.sets += 1;
105
+ if (groupId) sets.linkGroupSet(groupId, accountSet.id);
106
+ setId = accountSet.id;
107
+ } else {
108
+ log("迁移提示:site-account 名称无法解析,归入默认集合", String(row.name));
109
+ nextName = uniqueSecretName(db, String(row.name || row.id).replace(/^site\./, "站点 · "));
110
+ }
111
+
112
+ const ciphertext = seal(dek, plain, secretAad(row.id, nextName, kind));
113
+ db.prepare(
114
+ "UPDATE vault_secret SET name = ?, kind = ?, ciphertext = ?, updated_at = ?, rev = rev + 1 WHERE id = ?",
115
+ ).run(nextName, kind, ciphertext, now(), row.id);
116
+ stats.converted += 1;
117
+ if (setId) sets.linkSecret(setId, row.id);
118
+ }
119
+ }
120
+
121
+ // 3) 收口:去掉凭据上的单列归属
122
+ if (hasGroupColumn) db.exec("ALTER TABLE vault_secret DROP COLUMN group_id");
123
+ headerSet(db, { schema_version: 3 });
124
+ });
125
+
126
+ log("保险箱已迁移到 schema 3", JSON.stringify(stats));
127
+ return { migrated: true, ...stats };
128
+ }
@@ -0,0 +1,33 @@
1
+ /**
2
+ * 凭据输入的通用校验:类型、名称、非敏感元数据。
3
+ * 抽出来是为了让 vault.js 保持在 600 行预算内,也是 schema 与实现同口径的单一来源。
4
+ */
5
+ export const KINDS = ["password", "phone", "id_card", "token", "app_password", "api_key", "other"];
6
+ export const KIND_SET = new Set(KINDS);
7
+
8
+ const META_BAD = /(pass(word|wd)?|pwd|token|secret|api[_-]?key|private[_-]?key|credential)/i;
9
+
10
+ export function assertSecretName(name) {
11
+ const value = String(name || "").trim();
12
+ if (!value || value.length > 100) throw new Error("名称必填,最多 100 字");
13
+ return value;
14
+ }
15
+
16
+ export function assertKind(kind) {
17
+ const value = String(kind || "other");
18
+ if (!KIND_SET.has(value)) throw new Error("kind 必须是 " + KINDS.join("/"));
19
+ return value;
20
+ }
21
+
22
+ export function assertMeta(meta) {
23
+ if (meta == null) return "{}";
24
+ if (typeof meta !== "object" || Array.isArray(meta)) throw new Error("meta 必须是对象");
25
+ for (const [key, value] of Object.entries(meta)) {
26
+ if (META_BAD.test(key) && value !== "" && value != null) {
27
+ throw new Error("meta 不能保存密码/token 等敏感值:" + key);
28
+ }
29
+ }
30
+ const text = JSON.stringify(meta);
31
+ if (text.length > 4000) throw new Error("meta 最多 4000 字节");
32
+ return text;
33
+ }