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.
package/lib/db/db.js ADDED
@@ -0,0 +1,401 @@
1
+ /**
2
+ * 保险箱数据库:只保存密文与 KDF 参数,不保存口令、DEK 或明文。
3
+ * 0.2.0 起拆表:vault_header(单行、参与同步)+ vault_device(本机)+ 使用记录。
4
+ * 表结构见 docs/specs/46-连接器与凭据保险箱方案.md 7.3。
5
+ */
6
+ export const VAULT_HEADER = "vault_header";
7
+ export const VAULT_DEVICE = "vault_device";
8
+ export const VAULT_GROUP = "vault_group";
9
+ export const VAULT_SECRET = "vault_secret";
10
+ export const VAULT_SET = "vault_set";
11
+ export const VAULT_GROUP_SET = "vault_group_set";
12
+ export const VAULT_SET_SECRET = "vault_set_secret";
13
+ export const VAULT_BINDING = "vault_binding";
14
+ export const VAULT_SUBJECT_TYPE = "vault_subject_type";
15
+ export const VAULT_SECRET_USAGE = "vault_secret_usage";
16
+ export const VAULT_META_LEGACY = "vault_meta_legacy";
17
+
18
+ /** 0.3.0 起:集合层(set)与两张多对多关联表;schema_version 3。 */
19
+ export const SCHEMA_VERSION = 3;
20
+
21
+ export const VAULT_DDL = [
22
+ "CREATE TABLE IF NOT EXISTS vault_header (" +
23
+ "id INTEGER PRIMARY KEY CHECK (id = 1)," +
24
+ "schema_version INTEGER NOT NULL DEFAULT 3," +
25
+ "salt TEXT NOT NULL," +
26
+ "kdf TEXT NOT NULL," +
27
+ "wrapped_dek TEXT NOT NULL," +
28
+ "passphrase_rev INTEGER NOT NULL DEFAULT 1," +
29
+ "created_at INTEGER NOT NULL," +
30
+ "updated_at INTEGER NOT NULL," +
31
+ "rev INTEGER NOT NULL DEFAULT 1" +
32
+ ");",
33
+ "CREATE TABLE IF NOT EXISTS vault_device (" +
34
+ "id TEXT PRIMARY KEY," +
35
+ "wrapped_dek_device TEXT," +
36
+ "unlock_mode TEXT NOT NULL DEFAULT 'A'," +
37
+ "auto_unlock INTEGER NOT NULL DEFAULT 0," +
38
+ "reveal_policy TEXT NOT NULL DEFAULT 'session'," +
39
+ "idle_timeout_sec INTEGER NOT NULL DEFAULT 900," +
40
+ "last_unlock_at INTEGER," +
41
+ "passphrase_rev_seen INTEGER NOT NULL DEFAULT 0," +
42
+ "created_at INTEGER NOT NULL," +
43
+ "updated_at INTEGER NOT NULL," +
44
+ "rev INTEGER NOT NULL DEFAULT 1" +
45
+ ");",
46
+ "CREATE TABLE IF NOT EXISTS vault_group (" +
47
+ "id TEXT PRIMARY KEY," +
48
+ "name TEXT NOT NULL," +
49
+ "description TEXT NOT NULL DEFAULT ''," +
50
+ "color TEXT," +
51
+ "created_at INTEGER NOT NULL," +
52
+ "updated_at INTEGER NOT NULL," +
53
+ "deleted_at INTEGER," +
54
+ "rev INTEGER NOT NULL DEFAULT 1" +
55
+ ");",
56
+ "CREATE UNIQUE INDEX IF NOT EXISTS uk_vault_group_name ON vault_group(name) WHERE deleted_at IS NULL;",
57
+ "CREATE TABLE IF NOT EXISTS vault_secret (" +
58
+ "id TEXT PRIMARY KEY," +
59
+ "name TEXT NOT NULL," +
60
+ "kind TEXT NOT NULL," +
61
+ "meta TEXT NOT NULL DEFAULT '{}'," +
62
+ "ciphertext TEXT NOT NULL," +
63
+ "created_at INTEGER NOT NULL," +
64
+ "updated_at INTEGER NOT NULL," +
65
+ "deleted_at INTEGER," +
66
+ "rev INTEGER NOT NULL DEFAULT 1" +
67
+ ");",
68
+ "CREATE UNIQUE INDEX IF NOT EXISTS uk_vault_secret_name ON vault_secret(name) WHERE deleted_at IS NULL;",
69
+ "CREATE INDEX IF NOT EXISTS idx_vault_secret_kind ON vault_secret(deleted_at, kind);",
70
+ "CREATE TABLE IF NOT EXISTS vault_set (" +
71
+ "id TEXT PRIMARY KEY," +
72
+ "name TEXT NOT NULL," +
73
+ "description TEXT NOT NULL DEFAULT ''," +
74
+ "color TEXT," +
75
+ "created_at INTEGER NOT NULL," +
76
+ "updated_at INTEGER NOT NULL," +
77
+ "deleted_at INTEGER," +
78
+ "rev INTEGER NOT NULL DEFAULT 1" +
79
+ ");",
80
+ "CREATE UNIQUE INDEX IF NOT EXISTS uk_vault_set_name ON vault_set(name) WHERE deleted_at IS NULL;",
81
+ "CREATE TABLE IF NOT EXISTS vault_group_set (" +
82
+ "id TEXT PRIMARY KEY," +
83
+ "group_id TEXT NOT NULL," +
84
+ "set_id TEXT NOT NULL," +
85
+ "created_at INTEGER NOT NULL," +
86
+ "updated_at INTEGER NOT NULL," +
87
+ "deleted_at INTEGER," +
88
+ "rev INTEGER NOT NULL DEFAULT 1" +
89
+ ");",
90
+ "CREATE UNIQUE INDEX IF NOT EXISTS uk_vault_group_set ON vault_group_set(group_id, set_id) WHERE deleted_at IS NULL;",
91
+ "CREATE INDEX IF NOT EXISTS idx_vault_group_set_group ON vault_group_set(group_id);",
92
+ "CREATE INDEX IF NOT EXISTS idx_vault_group_set_set ON vault_group_set(set_id);",
93
+ "CREATE TABLE IF NOT EXISTS vault_set_secret (" +
94
+ "id TEXT PRIMARY KEY," +
95
+ "set_id TEXT NOT NULL," +
96
+ "secret_id TEXT NOT NULL," +
97
+ "created_at INTEGER NOT NULL," +
98
+ "updated_at INTEGER NOT NULL," +
99
+ "deleted_at INTEGER," +
100
+ "rev INTEGER NOT NULL DEFAULT 1" +
101
+ ");",
102
+ "CREATE UNIQUE INDEX IF NOT EXISTS uk_vault_set_secret ON vault_set_secret(set_id, secret_id) WHERE deleted_at IS NULL;",
103
+ "CREATE INDEX IF NOT EXISTS idx_vault_set_secret_set ON vault_set_secret(set_id);",
104
+ "CREATE INDEX IF NOT EXISTS idx_vault_set_secret_secret ON vault_set_secret(secret_id);",
105
+ "CREATE TABLE IF NOT EXISTS vault_binding (" +
106
+ "id TEXT PRIMARY KEY," +
107
+ "subject_type TEXT NOT NULL," +
108
+ "subject_id TEXT NOT NULL," +
109
+ "group_id TEXT NOT NULL," +
110
+ "created_at INTEGER NOT NULL," +
111
+ "updated_at INTEGER NOT NULL," +
112
+ "deleted_at INTEGER," +
113
+ "rev INTEGER NOT NULL DEFAULT 1" +
114
+ ");",
115
+ "CREATE UNIQUE INDEX IF NOT EXISTS uk_vault_binding ON vault_binding(subject_type, subject_id, group_id) WHERE deleted_at IS NULL;",
116
+ "CREATE INDEX IF NOT EXISTS idx_vault_binding_subject ON vault_binding(subject_type, subject_id);",
117
+ "CREATE INDEX IF NOT EXISTS idx_vault_binding_group ON vault_binding(group_id);",
118
+ "CREATE TABLE IF NOT EXISTS vault_subject_type (" +
119
+ "id TEXT PRIMARY KEY," +
120
+ "type TEXT NOT NULL," +
121
+ "title TEXT NOT NULL," +
122
+ "description TEXT NOT NULL DEFAULT ''," +
123
+ "updated_at INTEGER NOT NULL," +
124
+ "rev INTEGER NOT NULL DEFAULT 1" +
125
+ ");",
126
+ "CREATE UNIQUE INDEX IF NOT EXISTS uk_vault_subject_type ON vault_subject_type(type);",
127
+ "CREATE TABLE IF NOT EXISTS vault_secret_usage (" +
128
+ "secret_id TEXT PRIMARY KEY," +
129
+ "last_used_at INTEGER NOT NULL" +
130
+ ");",
131
+ ];
132
+
133
+ let clock = null;
134
+ let last = 0;
135
+
136
+ export function bindClock(fn) {
137
+ clock = typeof fn === "function" ? fn : null;
138
+ }
139
+
140
+ export function now() {
141
+ if (clock) return clock();
142
+ const t = Date.now();
143
+ last = t > last ? t : last + 1;
144
+ return last;
145
+ }
146
+
147
+ export function newId(prefix = "sec") {
148
+ let tail = "";
149
+ for (let i = 0; i < 10; i += 1) tail += Math.floor(Math.random() * 36).toString(36);
150
+ return prefix + "_" + now().toString(36) + "_" + tail;
151
+ }
152
+
153
+ export function hasColumn(db, table, column) {
154
+ return tableExists(db, table) && columnNames(db, table).includes(String(column));
155
+ }
156
+
157
+ export function tableExists(db, table) {
158
+ return Boolean(db.prepare("SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = ?").get(String(table)));
159
+ }
160
+
161
+ export function columnNames(db, table) {
162
+ return db.prepare("PRAGMA table_info(" + String(table) + ")").all().map((row) => row.name);
163
+ }
164
+
165
+ export function ensureSchema(db) {
166
+ for (const sql of VAULT_DDL) db.exec(sql);
167
+ migrateV1(db);
168
+ }
169
+
170
+ /**
171
+ * 0.1.0 → 0.2.0:vault_meta(KV) 拆成单行 vault_header + 本机 vault_device,
172
+ * last_used_at 搬到 vault_secret_usage。幂等;不改密文本体,解锁前也能跑。
173
+ */
174
+ export function migrateV1(db) {
175
+ if (!tableExists(db, "vault_meta")) return;
176
+ if (headerGet(db)) return;
177
+ const rows = db.prepare("SELECT key, value FROM vault_meta").all();
178
+ if (!rows.length) return;
179
+ const meta = {};
180
+ for (const row of rows) meta[row.key] = String(row.value);
181
+ if (!meta.schema_version || !meta.salt || !meta.wrapped_dek) return;
182
+
183
+ tx(db, () => {
184
+ ensureGroupColumn(db);
185
+ const ts = Number(meta.created_at) || now();
186
+ db.prepare(
187
+ "INSERT INTO vault_header(id, schema_version, salt, kdf, wrapped_dek, passphrase_rev, created_at, updated_at, rev) " +
188
+ "VALUES(1, 2, ?, ?, ?, 1, ?, ?, 1)",
189
+ ).run(meta.salt, meta.kdf || "{}", meta.wrapped_dek, ts, now());
190
+ db.prepare(
191
+ "INSERT INTO vault_device(id, wrapped_dek_device, unlock_mode, auto_unlock, reveal_policy, idle_timeout_sec, " +
192
+ "last_unlock_at, passphrase_rev_seen, created_at, updated_at, rev) VALUES('local', ?, ?, ?, ?, ?, ?, 1, ?, ?, 1)",
193
+ ).run(
194
+ meta.wrapped_dek_device || null,
195
+ meta.unlock_mode || "A",
196
+ meta.auto_unlock === "1" ? 1 : 0,
197
+ meta.reveal_policy || "session",
198
+ Number(meta.idle_timeout_sec) || 900,
199
+ Number(meta.last_unlock_at) || null,
200
+ ts,
201
+ now(),
202
+ );
203
+ db.exec(
204
+ "INSERT INTO vault_secret_usage(secret_id, last_used_at) " +
205
+ "SELECT id, last_used_at FROM vault_secret WHERE last_used_at IS NOT NULL",
206
+ );
207
+ db.exec("ALTER TABLE vault_meta RENAME TO " + VAULT_META_LEGACY);
208
+ });
209
+ }
210
+
211
+ function ensureGroupColumn(db) {
212
+ if (!tableExists(db, "vault_secret")) return;
213
+ if (!columnNames(db, "vault_secret").includes("group_id")) {
214
+ db.exec("ALTER TABLE vault_secret ADD COLUMN group_id TEXT");
215
+ }
216
+ }
217
+
218
+ export function headerGet(db) {
219
+ return db.prepare("SELECT * FROM vault_header WHERE id = 1").get() || null;
220
+ }
221
+
222
+ export function headerSet(db, patch = {}) {
223
+ const cur = headerGet(db) || {};
224
+ const next = {
225
+ schema_version: patch.schema_version ?? cur.schema_version ?? SCHEMA_VERSION,
226
+ salt: patch.salt ?? cur.salt,
227
+ kdf: patch.kdf ?? cur.kdf,
228
+ wrapped_dek: patch.wrapped_dek ?? cur.wrapped_dek,
229
+ passphrase_rev: patch.passphrase_rev ?? cur.passphrase_rev ?? 1,
230
+ created_at: cur.created_at ?? patch.created_at ?? now(),
231
+ updated_at: now(),
232
+ rev: Number(cur.rev || 0) + 1,
233
+ };
234
+ db.prepare(
235
+ "INSERT INTO vault_header(id, schema_version, salt, kdf, wrapped_dek, passphrase_rev, created_at, updated_at, rev) " +
236
+ "VALUES(1, ?, ?, ?, ?, ?, ?, ?, ?) " +
237
+ "ON CONFLICT(id) DO UPDATE SET schema_version = excluded.schema_version, salt = excluded.salt, " +
238
+ "kdf = excluded.kdf, wrapped_dek = excluded.wrapped_dek, passphrase_rev = excluded.passphrase_rev, " +
239
+ "updated_at = excluded.updated_at, rev = excluded.rev",
240
+ ).run(
241
+ next.schema_version,
242
+ next.salt,
243
+ next.kdf,
244
+ next.wrapped_dek,
245
+ next.passphrase_rev,
246
+ next.created_at,
247
+ next.updated_at,
248
+ next.rev,
249
+ );
250
+ return next;
251
+ }
252
+
253
+ export function deviceGet(db) {
254
+ return db.prepare("SELECT * FROM vault_device WHERE id = 'local'").get() || null;
255
+ }
256
+
257
+ export function deviceSet(db, patch = {}) {
258
+ const cur = deviceGet(db) || {};
259
+ const next = {
260
+ wrapped_dek_device: patch.wrapped_dek_device !== undefined ? patch.wrapped_dek_device : cur.wrapped_dek_device ?? null,
261
+ unlock_mode: patch.unlock_mode ?? cur.unlock_mode ?? "A",
262
+ auto_unlock: patch.auto_unlock !== undefined ? Number(patch.auto_unlock ? 1 : 0) : Number(cur.auto_unlock || 0),
263
+ reveal_policy: patch.reveal_policy ?? cur.reveal_policy ?? "session",
264
+ idle_timeout_sec: patch.idle_timeout_sec ?? cur.idle_timeout_sec ?? 900,
265
+ last_unlock_at: patch.last_unlock_at !== undefined ? patch.last_unlock_at : cur.last_unlock_at ?? null,
266
+ passphrase_rev_seen: patch.passphrase_rev_seen ?? cur.passphrase_rev_seen ?? 0,
267
+ created_at: cur.created_at ?? patch.created_at ?? now(),
268
+ updated_at: now(),
269
+ rev: Number(cur.rev || 0) + 1,
270
+ };
271
+ db.prepare(
272
+ "INSERT INTO vault_device(id, wrapped_dek_device, unlock_mode, auto_unlock, reveal_policy, idle_timeout_sec, " +
273
+ "last_unlock_at, passphrase_rev_seen, created_at, updated_at, rev) " +
274
+ "VALUES('local', ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) " +
275
+ "ON CONFLICT(id) DO UPDATE SET wrapped_dek_device = excluded.wrapped_dek_device, " +
276
+ "unlock_mode = excluded.unlock_mode, auto_unlock = excluded.auto_unlock, " +
277
+ "reveal_policy = excluded.reveal_policy, idle_timeout_sec = excluded.idle_timeout_sec, " +
278
+ "last_unlock_at = excluded.last_unlock_at, passphrase_rev_seen = excluded.passphrase_rev_seen, " +
279
+ "updated_at = excluded.updated_at, rev = excluded.rev",
280
+ ).run(
281
+ next.wrapped_dek_device,
282
+ next.unlock_mode,
283
+ next.auto_unlock,
284
+ next.reveal_policy,
285
+ next.idle_timeout_sec,
286
+ next.last_unlock_at,
287
+ next.passphrase_rev_seen,
288
+ next.created_at,
289
+ next.updated_at,
290
+ next.rev,
291
+ );
292
+ return next;
293
+ }
294
+
295
+ export function touchUsage(db, secretId) {
296
+ db.prepare(
297
+ "INSERT INTO vault_secret_usage(secret_id, last_used_at) VALUES(?, ?) " +
298
+ "ON CONFLICT(secret_id) DO UPDATE SET last_used_at = excluded.last_used_at",
299
+ ).run(String(secretId), now());
300
+ }
301
+
302
+ export function usageMap(db) {
303
+ const out = {};
304
+ for (const row of db.prepare("SELECT secret_id, last_used_at FROM vault_secret_usage").all()) {
305
+ out[row.secret_id] = row.last_used_at;
306
+ }
307
+ return out;
308
+ }
309
+
310
+ export function tx(db, fn) {
311
+ db.exec("BEGIN IMMEDIATE");
312
+ try {
313
+ const value = fn();
314
+ db.exec("COMMIT");
315
+ return value;
316
+ } catch (error) {
317
+ try {
318
+ db.exec("ROLLBACK");
319
+ } catch {
320
+ /* ignore */
321
+ }
322
+ throw error;
323
+ }
324
+ }
325
+
326
+ export function secretRow(row, usage = {}) {
327
+ if (!row) return null;
328
+ return {
329
+ id: row.id,
330
+ name: row.name,
331
+ kind: row.kind,
332
+ meta: row.meta || "{}",
333
+ createdAt: row.created_at,
334
+ updatedAt: row.updated_at,
335
+ lastUsedAt: usage[row.id] || null,
336
+ rev: row.rev,
337
+ };
338
+ }
339
+
340
+ export function setRow(row) {
341
+ if (!row) return null;
342
+ return {
343
+ id: row.id,
344
+ name: row.name,
345
+ description: row.description || "",
346
+ color: row.color || null,
347
+ createdAt: row.created_at,
348
+ updatedAt: row.updated_at,
349
+ rev: row.rev,
350
+ };
351
+ }
352
+
353
+ export function groupSetRow(row) {
354
+ if (!row) return null;
355
+ return {
356
+ id: row.id,
357
+ groupId: row.group_id,
358
+ setId: row.set_id,
359
+ createdAt: row.created_at,
360
+ updatedAt: row.updated_at,
361
+ rev: row.rev,
362
+ };
363
+ }
364
+
365
+ export function setSecretRow(row) {
366
+ if (!row) return null;
367
+ return {
368
+ id: row.id,
369
+ setId: row.set_id,
370
+ secretId: row.secret_id,
371
+ createdAt: row.created_at,
372
+ updatedAt: row.updated_at,
373
+ rev: row.rev,
374
+ };
375
+ }
376
+
377
+ export function groupRow(row) {
378
+ if (!row) return null;
379
+ return {
380
+ id: row.id,
381
+ name: row.name,
382
+ description: row.description || "",
383
+ color: row.color || null,
384
+ createdAt: row.created_at,
385
+ updatedAt: row.updated_at,
386
+ rev: row.rev,
387
+ };
388
+ }
389
+
390
+ export function bindingRow(row) {
391
+ if (!row) return null;
392
+ return {
393
+ id: row.id,
394
+ subjectType: row.subject_type,
395
+ subjectId: row.subject_id,
396
+ groupId: row.group_id,
397
+ createdAt: row.created_at,
398
+ updatedAt: row.updated_at,
399
+ rev: row.rev,
400
+ };
401
+ }
@@ -0,0 +1,271 @@
1
+ /**
2
+ * 集合与后台写入 action:分组 ⊃ 集合 ⊃ 凭据三层里属于集合的部分。
3
+ * 与 actions.js 分文件只为把单个文件保持在 600 行以内;契约不拆。
4
+ */
5
+ export function registerSetActions({ api, sets, groups, vault, only, KINDS }) {
6
+ api.action("vault.setList", {
7
+ description: "只读:凭据集合列表,带凭据数与挂靠分组;可按名称/描述搜索、按分组过滤。",
8
+ input: {
9
+ type: "object",
10
+ properties: {
11
+ q: { type: "string", description: "按集合名或描述模糊搜索" },
12
+ groupId: { type: "string", description: "只看某个分组下的集合" },
13
+ },
14
+ additionalProperties: false,
15
+ },
16
+ execute: (args, ctx) => {
17
+ only(ctx, ["ui", "agent", "plugin"], "vault.setList");
18
+ return sets.listSets(args);
19
+ },
20
+ });
21
+
22
+ api.action("vault.setGet", {
23
+ description: "只读:单个集合及其凭据清单(id/名称/类型/更新时间),不含明文。",
24
+ input: {
25
+ type: "object",
26
+ properties: { id: { type: "string" } },
27
+ required: ["id"],
28
+ additionalProperties: false,
29
+ },
30
+ execute: (args, ctx) => {
31
+ only(ctx, ["ui", "agent", "plugin"], "vault.setGet");
32
+ return sets.getSet(args);
33
+ },
34
+ });
35
+
36
+ api.action("vault.setCreate", {
37
+ description: "新建凭据集合;名称全局唯一。",
38
+ input: {
39
+ type: "object",
40
+ properties: {
41
+ name: { type: "string", description: "集合名,1–100 字,全局唯一" },
42
+ description: { type: "string", description: "用途说明" },
43
+ color: { type: "string", description: "主题色 token 名或色值,可空" },
44
+ },
45
+ required: ["name"],
46
+ additionalProperties: false,
47
+ },
48
+ execute: (args, ctx) => {
49
+ only(ctx, ["ui"], "vault.setCreate");
50
+ return sets.createSet(args);
51
+ },
52
+ });
53
+
54
+ api.action("vault.setUpdate", {
55
+ description: "改集合的名称/描述/颜色;改名不影响已有凭据(归属不进 AAD)。",
56
+ input: {
57
+ type: "object",
58
+ properties: {
59
+ id: { type: "string" },
60
+ name: { type: "string" },
61
+ description: { type: "string" },
62
+ color: { type: "string" },
63
+ },
64
+ required: ["id"],
65
+ additionalProperties: false,
66
+ },
67
+ execute: (args, ctx) => {
68
+ only(ctx, ["ui"], "vault.setUpdate");
69
+ return sets.updateSet(args);
70
+ },
71
+ });
72
+
73
+ api.action("vault.setDelete", {
74
+ description: "软删集合:只解除与分组、凭据的关联,凭据本身保留。",
75
+ input: {
76
+ type: "object",
77
+ properties: { id: { type: "string" } },
78
+ required: ["id"],
79
+ additionalProperties: false,
80
+ },
81
+ execute: (args, ctx) => {
82
+ only(ctx, ["ui"], "vault.setDelete");
83
+ return sets.deleteSet(args.id);
84
+ },
85
+ });
86
+
87
+ function pluginBoundOrThrow(args, ctx, action) {
88
+ only(ctx, ["ui", "plugin"], action);
89
+ if ((ctx && ctx.origin) === "plugin") assertSetInBoundGroups(args, args.setId);
90
+ }
91
+
92
+ api.action("vault.setAttachSecret", {
93
+ description: "把一条凭据加进集合(幂等);plugin 只能操作自己已绑定组下的集合。",
94
+ input: {
95
+ type: "object",
96
+ properties: {
97
+ setId: { type: "string" },
98
+ secretId: { type: "string" },
99
+ subjectType: { type: "string", description: "plugin 调用时必填" },
100
+ subjectId: { type: "string", description: "plugin 调用时必填" },
101
+ },
102
+ required: ["setId", "secretId"],
103
+ additionalProperties: false,
104
+ },
105
+ execute: (args, ctx) => {
106
+ pluginBoundOrThrow(args, ctx, "vault.setAttachSecret");
107
+ const row = api.db
108
+ .prepare("SELECT 1 FROM vault_secret WHERE id = ? AND deleted_at IS NULL")
109
+ .get(String(args.secretId || ""));
110
+ if (!row) throw new Error("凭据不存在:" + args.secretId);
111
+ const res = sets.linkSecret(args.setId, args.secretId);
112
+ return { ok: true, setId: String(args.setId), secretId: String(args.secretId), existing: res.existing };
113
+ },
114
+ });
115
+
116
+ api.action("vault.setDetachSecret", {
117
+ description: "把一条凭据移出集合(幂等),凭据本身保留。",
118
+ input: {
119
+ type: "object",
120
+ properties: {
121
+ setId: { type: "string" },
122
+ secretId: { type: "string" },
123
+ subjectType: { type: "string", description: "plugin 调用时必填" },
124
+ subjectId: { type: "string", description: "plugin 调用时必填" },
125
+ },
126
+ required: ["setId", "secretId"],
127
+ additionalProperties: false,
128
+ },
129
+ execute: (args, ctx) => {
130
+ pluginBoundOrThrow(args, ctx, "vault.setDetachSecret");
131
+ return sets.unlinkSecret(args.setId, args.secretId);
132
+ },
133
+ });
134
+
135
+ api.action("vault.groupAttachSet", {
136
+ description: "把一个集合挂到分组下(幂等),组内凭据可见性随集合扩展。",
137
+ input: {
138
+ type: "object",
139
+ properties: { groupId: { type: "string" }, setId: { type: "string" } },
140
+ required: ["groupId", "setId"],
141
+ additionalProperties: false,
142
+ },
143
+ execute: (args, ctx) => {
144
+ only(ctx, ["ui"], "vault.groupAttachSet");
145
+ return sets.linkGroupSet(args.groupId, args.setId);
146
+ },
147
+ });
148
+
149
+ api.action("vault.groupDetachSet", {
150
+ description: "把集合从分组下摘掉(幂等);其它分组仍在用则不影响。",
151
+ input: {
152
+ type: "object",
153
+ properties: { groupId: { type: "string" }, setId: { type: "string" } },
154
+ required: ["groupId", "setId"],
155
+ additionalProperties: false,
156
+ },
157
+ execute: (args, ctx) => {
158
+ only(ctx, ["ui"], "vault.groupDetachSet");
159
+ return sets.unlinkGroupSet(args.groupId, args.setId);
160
+ },
161
+ });
162
+
163
+ function boundGroups(args) {
164
+ const subjectType = String(args.subjectType || "");
165
+ const subjectId = String(args.subjectId || "");
166
+ if (!subjectType || !subjectId) throw new Error("subjectType 与 subjectId 必填");
167
+ const result = groups.bindingsOf({ subjectType, subjectId });
168
+ if (!result.items.length) throw new Error("该对象未绑定任何凭据组,无法写入");
169
+ return result.items;
170
+ }
171
+
172
+ /** 插件只能碰自己 subject 已绑定组挂着的集合。 */
173
+ function assertSetInBoundGroups(args, setId) {
174
+ const items = boundGroups(args);
175
+ const visible = new Set();
176
+ for (const item of items) {
177
+ for (const set of sets.setsOfGroup(item.groupId)) visible.add(set.id);
178
+ }
179
+ if (!visible.has(String(setId))) throw new Error("该集合不属于此对象已绑定的凭据组");
180
+ return items;
181
+ }
182
+
183
+ /** 在 subject 已绑定组内按名称找集合;找不到就建并把集合挂到唯一的绑定组上。 */
184
+ function ensureSetForSubject(args) {
185
+ const setName = String(args.setName || "").trim();
186
+ if (!setName) throw new Error("setName 必填");
187
+ const items = boundGroups(args);
188
+ if (args.groupId && !items.some((item) => item.groupId === String(args.groupId))) {
189
+ throw new Error("该凭据组未绑定到此对象");
190
+ }
191
+ for (const item of items) {
192
+ const existing = sets.setsOfGroup(item.groupId).find((set) => set.name === setName);
193
+ if (existing) return existing;
194
+ }
195
+ const groupId = args.groupId ? String(args.groupId) : items.length === 1 ? items[0].groupId : "";
196
+ if (!groupId) throw new Error("对象绑定了多个凭据组,需指定 groupId");
197
+ if (!items.some((item) => item.groupId === groupId)) throw new Error("该凭据组未绑定到此对象");
198
+ const created = sets.ensureSet(setName);
199
+ sets.linkGroupSet(groupId, created.id);
200
+ return created;
201
+ }
202
+
203
+ api.action("vault.pluginSecretUpsert", {
204
+ description:
205
+ "后台插件写:在自己 subject 已绑定的凭据组内按 setName 幂等建/取集合,再全局按 name 幂等写一条凭据并加入集合;不返回明文。",
206
+ input: {
207
+ type: "object",
208
+ properties: {
209
+ subjectType: { type: "string", description: "业务对象类型,如 site" },
210
+ subjectId: { type: "string", description: "业务对象 id" },
211
+ setName: { type: "string", description: "集合名(业务侧账号 id),组内幂等" },
212
+ groupId: { type: "string", description: "绑定多个组时指定挂靠组,可省略" },
213
+ name: { type: "string", description: "凭据名(全局唯一),如 <accountId> · 密码" },
214
+ kind: { type: "string", enum: KINDS },
215
+ secret: { type: "string", description: "明文,落库前加密" },
216
+ meta: { type: "object", description: "非敏感元数据,禁止 password/token 等键名" },
217
+ },
218
+ required: ["subjectType", "subjectId", "setName", "name", "secret"],
219
+ additionalProperties: false,
220
+ },
221
+ execute: (args, ctx) => {
222
+ only(ctx, ["plugin"], "vault.pluginSecretUpsert");
223
+ const set = ensureSetForSubject(args);
224
+ return vault.writeSecretToSet({ ...args, setId: set.id });
225
+ },
226
+ });
227
+
228
+ api.action("vault.pluginSecretDelete", {
229
+ description: "后台插件写:把自己 subject 的某条凭据从指定集合摘出;不再属于任何集合时软删。",
230
+ input: {
231
+ type: "object",
232
+ properties: {
233
+ subjectType: { type: "string" },
234
+ subjectId: { type: "string" },
235
+ setName: { type: "string", description: "集合名(业务侧账号 id)" },
236
+ name: { type: "string" },
237
+ },
238
+ required: ["subjectType", "subjectId", "setName", "name"],
239
+ additionalProperties: false,
240
+ },
241
+ execute: (args, ctx) => {
242
+ only(ctx, ["plugin"], "vault.pluginSecretDelete");
243
+ const set = ensureSetForSubject(args);
244
+ return vault.detachSecretFromSet({ setId: set.id, name: args.name });
245
+ },
246
+ });
247
+
248
+ api.action("vault.pluginSetGet", {
249
+ description: "后台插件读:取业务侧的集合(按 setName 在自己已绑定的组内查找),不存在返回空。",
250
+ input: {
251
+ type: "object",
252
+ properties: {
253
+ subjectType: { type: "string" },
254
+ subjectId: { type: "string" },
255
+ setName: { type: "string" },
256
+ },
257
+ required: ["subjectType", "subjectId", "setName"],
258
+ additionalProperties: false,
259
+ },
260
+ execute: (args, ctx) => {
261
+ only(ctx, ["plugin"], "vault.pluginSetGet");
262
+ const setName = String(args.setName || "").trim();
263
+ if (!setName) throw new Error("setName 必填");
264
+ for (const item of boundGroups(args)) {
265
+ const found = sets.setsOfGroup(item.groupId).find((set) => set.name === setName);
266
+ if (found) return { set: found, groupId: item.groupId };
267
+ }
268
+ return { set: null };
269
+ },
270
+ });
271
+ }