@sfmc-bds/db-server 0.1.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.
Files changed (146) hide show
  1. package/README.md +21 -0
  2. package/dist/db-tables.d.ts +13 -0
  3. package/dist/db-tables.d.ts.map +1 -0
  4. package/dist/db-tables.js +35 -0
  5. package/dist/db-tables.js.map +1 -0
  6. package/dist/domain/bridge.d.ts +48 -0
  7. package/dist/domain/bridge.d.ts.map +1 -0
  8. package/dist/domain/bridge.js +82 -0
  9. package/dist/domain/bridge.js.map +1 -0
  10. package/dist/domain/economy.d.ts +120 -0
  11. package/dist/domain/economy.d.ts.map +1 -0
  12. package/dist/domain/economy.js +321 -0
  13. package/dist/domain/economy.js.map +1 -0
  14. package/dist/domain/schema.d.ts +26 -0
  15. package/dist/domain/schema.d.ts.map +1 -0
  16. package/dist/domain/schema.js +462 -0
  17. package/dist/domain/schema.js.map +1 -0
  18. package/dist/domain/transaction.d.ts +67 -0
  19. package/dist/domain/transaction.d.ts.map +1 -0
  20. package/dist/domain/transaction.js +85 -0
  21. package/dist/domain/transaction.js.map +1 -0
  22. package/dist/env.d.ts +22 -0
  23. package/dist/env.d.ts.map +1 -0
  24. package/dist/env.js +94 -0
  25. package/dist/env.js.map +1 -0
  26. package/dist/index.d.ts +33 -0
  27. package/dist/index.d.ts.map +1 -0
  28. package/dist/index.js +313 -0
  29. package/dist/index.js.map +1 -0
  30. package/dist/lib/http.d.ts +18 -0
  31. package/dist/lib/http.d.ts.map +1 -0
  32. package/dist/lib/http.js +43 -0
  33. package/dist/lib/http.js.map +1 -0
  34. package/dist/lib/idempotency-store.d.ts +28 -0
  35. package/dist/lib/idempotency-store.d.ts.map +1 -0
  36. package/dist/lib/idempotency-store.js +49 -0
  37. package/dist/lib/idempotency-store.js.map +1 -0
  38. package/dist/lib/idempotency.d.ts +9 -0
  39. package/dist/lib/idempotency.d.ts.map +1 -0
  40. package/dist/lib/idempotency.js +14 -0
  41. package/dist/lib/idempotency.js.map +1 -0
  42. package/dist/lib/identifiers.d.ts +3 -0
  43. package/dist/lib/identifiers.d.ts.map +1 -0
  44. package/dist/lib/identifiers.js +18 -0
  45. package/dist/lib/identifiers.js.map +1 -0
  46. package/dist/lib/log.d.ts +11 -0
  47. package/dist/lib/log.d.ts.map +1 -0
  48. package/dist/lib/log.js +15 -0
  49. package/dist/lib/log.js.map +1 -0
  50. package/dist/lib/module-state.d.ts +15 -0
  51. package/dist/lib/module-state.d.ts.map +1 -0
  52. package/dist/lib/module-state.js +27 -0
  53. package/dist/lib/module-state.js.map +1 -0
  54. package/dist/lib/runtime.d.ts +21 -0
  55. package/dist/lib/runtime.d.ts.map +1 -0
  56. package/dist/lib/runtime.js +34 -0
  57. package/dist/lib/runtime.js.map +1 -0
  58. package/dist/lib/sql-helpers.d.ts +31 -0
  59. package/dist/lib/sql-helpers.d.ts.map +1 -0
  60. package/dist/lib/sql-helpers.js +30 -0
  61. package/dist/lib/sql-helpers.js.map +1 -0
  62. package/dist/lib/sqlite.d.ts +20 -0
  63. package/dist/lib/sqlite.d.ts.map +1 -0
  64. package/dist/lib/sqlite.js +59 -0
  65. package/dist/lib/sqlite.js.map +1 -0
  66. package/dist/manifest-loader.d.ts +69 -0
  67. package/dist/manifest-loader.d.ts.map +1 -0
  68. package/dist/manifest-loader.js +212 -0
  69. package/dist/manifest-loader.js.map +1 -0
  70. package/dist/manifest.d.ts +76 -0
  71. package/dist/manifest.d.ts.map +1 -0
  72. package/dist/manifest.js +128 -0
  73. package/dist/manifest.js.map +1 -0
  74. package/dist/module-auth.d.ts +58 -0
  75. package/dist/module-auth.d.ts.map +1 -0
  76. package/dist/module-auth.js +118 -0
  77. package/dist/module-auth.js.map +1 -0
  78. package/dist/permission-gate.d.ts +53 -0
  79. package/dist/permission-gate.d.ts.map +1 -0
  80. package/dist/permission-gate.js +94 -0
  81. package/dist/permission-gate.js.map +1 -0
  82. package/dist/routes/_shared.d.ts +68 -0
  83. package/dist/routes/_shared.d.ts.map +1 -0
  84. package/dist/routes/_shared.js +27 -0
  85. package/dist/routes/_shared.js.map +1 -0
  86. package/dist/routes/config.d.ts +27 -0
  87. package/dist/routes/config.d.ts.map +1 -0
  88. package/dist/routes/config.js +236 -0
  89. package/dist/routes/config.js.map +1 -0
  90. package/dist/routes/db-routes.d.ts +38 -0
  91. package/dist/routes/db-routes.d.ts.map +1 -0
  92. package/dist/routes/db-routes.js +186 -0
  93. package/dist/routes/db-routes.js.map +1 -0
  94. package/dist/routes/health.d.ts +10 -0
  95. package/dist/routes/health.d.ts.map +1 -0
  96. package/dist/routes/health.js +23 -0
  97. package/dist/routes/health.js.map +1 -0
  98. package/dist/routes/messages.d.ts +23 -0
  99. package/dist/routes/messages.d.ts.map +1 -0
  100. package/dist/routes/messages.js +72 -0
  101. package/dist/routes/messages.js.map +1 -0
  102. package/dist/routes/module-config-routes.d.ts +31 -0
  103. package/dist/routes/module-config-routes.d.ts.map +1 -0
  104. package/dist/routes/module-config-routes.js +128 -0
  105. package/dist/routes/module-config-routes.js.map +1 -0
  106. package/dist/routes/modules.d.ts +34 -0
  107. package/dist/routes/modules.d.ts.map +1 -0
  108. package/dist/routes/modules.js +92 -0
  109. package/dist/routes/modules.js.map +1 -0
  110. package/dist/routes/service-routes.d.ts +26 -0
  111. package/dist/routes/service-routes.d.ts.map +1 -0
  112. package/dist/routes/service-routes.js +68 -0
  113. package/dist/routes/service-routes.js.map +1 -0
  114. package/dist/runtime.test.d.ts +2 -0
  115. package/dist/runtime.test.d.ts.map +1 -0
  116. package/dist/runtime.test.js +66 -0
  117. package/dist/runtime.test.js.map +1 -0
  118. package/dist/schema-registry.d.ts +63 -0
  119. package/dist/schema-registry.d.ts.map +1 -0
  120. package/dist/schema-registry.js +178 -0
  121. package/dist/schema-registry.js.map +1 -0
  122. package/dist/server.d.ts +27 -0
  123. package/dist/server.d.ts.map +1 -0
  124. package/dist/server.js +82 -0
  125. package/dist/server.js.map +1 -0
  126. package/dist/service-registry.d.ts +46 -0
  127. package/dist/service-registry.d.ts.map +1 -0
  128. package/dist/service-registry.js +73 -0
  129. package/dist/service-registry.js.map +1 -0
  130. package/dist/services/builtin-handlers.d.ts +22 -0
  131. package/dist/services/builtin-handlers.d.ts.map +1 -0
  132. package/dist/services/builtin-handlers.js +23 -0
  133. package/dist/services/builtin-handlers.js.map +1 -0
  134. package/dist/services/economy-handlers.d.ts +14 -0
  135. package/dist/services/economy-handlers.d.ts.map +1 -0
  136. package/dist/services/economy-handlers.js +144 -0
  137. package/dist/services/economy-handlers.js.map +1 -0
  138. package/dist/tx-runner.d.ts +144 -0
  139. package/dist/tx-runner.d.ts.map +1 -0
  140. package/dist/tx-runner.js +273 -0
  141. package/dist/tx-runner.js.map +1 -0
  142. package/dist/where.d.ts +48 -0
  143. package/dist/where.d.ts.map +1 -0
  144. package/dist/where.js +107 -0
  145. package/dist/where.js.map +1 -0
  146. package/package.json +52 -0
@@ -0,0 +1,273 @@
1
+ /**
2
+ * tx-runner.ts — 事务 RPC 处理器
3
+ *
4
+ * 协议:
5
+ * POST /api/sfmc/db/tx
6
+ * body = { moduleId, steps: TxStep[] }
7
+ * reply: { ok: true } | { ok: false, step: <index>, error, code }
8
+ *
9
+ * 流程:
10
+ * 1. 校验 moduleId in enabled + permission "db:write:*"
11
+ * 2. BEGIN IMMEDIATE
12
+ * 3. 顺序跑 steps — 任一抛错 → ROLLBACK + reply { ok:false, step:<i>, ... }
13
+ * 4. 全过 → COMMIT + reply { ok:true }
14
+ *
15
+ * step.op:
16
+ * - query { table, opts? }
17
+ * - get { table, id }
18
+ * - insert { table, row }
19
+ * - update { table, id, patch }
20
+ * - delete { table, id, hard }
21
+ * - audit { table, rowId, action, data? } → 平台 sfmc__audit 表
22
+ * - service { name, input } → 派发;失败抛错回退整事务
23
+ *
24
+ * 事务内 service call:不持有 db handle 给 handler(避免并发写) —
25
+ * 实现:handler 是"同步纯函数",返回 result 写回 step 的输出。
26
+ * 若 handler 自己也想写 db,应通过其它接口在事务外做(避免嵌套)。
27
+ */
28
+ import { randomUUID } from "node:crypto";
29
+ import { compile } from "./where.js";
30
+ import { log } from "./lib/log.js";
31
+ import { DispatchError } from "./service-registry.js";
32
+ import { PermissionDeniedError, Perm, assertModulePermission, } from "./permission-gate.js";
33
+ const IDENT = /^[A-Za-z_][A-Za-z0-9_]*$/;
34
+ function identOk(t) {
35
+ if (!IDENT.test(t))
36
+ throw new Error(`[tx] invalid table name "${t}"`);
37
+ }
38
+ export class TxRunner {
39
+ deps;
40
+ constructor(deps) {
41
+ this.deps = deps;
42
+ }
43
+ async run(req) {
44
+ const { moduleId, steps } = req;
45
+ const manifest = this.deps.enabled.get(moduleId);
46
+ if (!manifest)
47
+ return { ok: false, step: -1, error: "模块未 enabled", code: "forbidden" };
48
+ // 注意:不在此处做「整体 db:write:*」断言。
49
+ // 通配 `db:write:*` 无法通过 permission-gate 的 validPermissionKey 校验(模块声明它会启动失败),
50
+ // 因此该断言会让所有事务(含只读事务)恒被拒。真正的读写权限由每个 step 的
51
+ // requireTableRead / requireTableWrite 按具体表精确 gate。
52
+ const traceId = randomUUID().slice(0, 8);
53
+ const results = [];
54
+ try {
55
+ this.deps.db.exec("BEGIN IMMEDIATE");
56
+ }
57
+ catch (e) {
58
+ return { ok: false, step: -1, error: `BEGIN 失败: ${e.message}`, code: "internal" };
59
+ }
60
+ for (let i = 0; i < steps.length; i++) {
61
+ const step = steps[i];
62
+ try {
63
+ const r = await this.runOne(moduleId, manifest, step);
64
+ results.push(r);
65
+ }
66
+ catch (err) {
67
+ this.rollback();
68
+ const code = err instanceof PermissionDeniedError
69
+ ? "permission_denied"
70
+ : err instanceof DispatchError &&
71
+ (err.code === "no_such_service" ||
72
+ err.code === "not_in_requires" ||
73
+ err.code === "forbidden" ||
74
+ err.code === "domain_error")
75
+ ? err.code
76
+ : err.code === "no_such_service"
77
+ ? "no_such_service"
78
+ : err.code === "not_in_requires"
79
+ ? "not_in_requires"
80
+ : err.code === "no_such_table"
81
+ ? "no_such_table"
82
+ : "internal";
83
+ log.warn(`[tx ${traceId}] step=${i} failed: ${err.message}`);
84
+ return { ok: false, step: i, error: err.message, code };
85
+ }
86
+ }
87
+ try {
88
+ this.deps.db.exec("COMMIT");
89
+ }
90
+ catch (e) {
91
+ this.rollback();
92
+ return { ok: false, step: -1, error: `COMMIT 失败: ${e.message}`, code: "internal" };
93
+ }
94
+ log.info(`[tx ${traceId}] module=${moduleId} ${steps.length} steps OK`);
95
+ return { ok: true, results };
96
+ }
97
+ rollback() {
98
+ try {
99
+ this.deps.db.exec("ROLLBACK");
100
+ }
101
+ catch {
102
+ // best-effort; fall through
103
+ }
104
+ }
105
+ /** 单 step 由对应权限检查 + SQL 路径执行 */
106
+ async runOne(moduleId, manifest, step) {
107
+ switch (step.op) {
108
+ case "query":
109
+ return this.doQuery(moduleId, manifest, step);
110
+ case "get":
111
+ return this.doGet(moduleId, manifest, step);
112
+ case "insert":
113
+ return this.doInsert(moduleId, manifest, step);
114
+ case "update":
115
+ return this.doUpdate(moduleId, manifest, step);
116
+ case "delete":
117
+ return this.doDelete(moduleId, manifest, step);
118
+ case "audit":
119
+ return this.doAudit(moduleId, manifest, step);
120
+ case "service":
121
+ return this.doService(moduleId, manifest, step);
122
+ }
123
+ }
124
+ requireTableRead(mod, table) {
125
+ identOk(table);
126
+ this.assertTableRegistered(table);
127
+ assertModulePermission(mod.id, mod.permissions, Perm.dbRead(table));
128
+ }
129
+ requireTableWrite(mod, table) {
130
+ identOk(table);
131
+ this.assertTableRegistered(table);
132
+ assertModulePermission(mod.id, mod.permissions, Perm.dbWrite(table));
133
+ }
134
+ assertTableRegistered(table) {
135
+ if (table.startsWith("sfmc_"))
136
+ return; // 平台表 — 始终可读写(平台层)
137
+ if (!this.deps.schema.isRegistered(table)) {
138
+ const err = new Error(`表 "${table}" 未注册到 schema-registry`);
139
+ err.code = "no_such_table";
140
+ throw err;
141
+ }
142
+ }
143
+ doQuery(_mid, mod, step) {
144
+ this.requireTableRead(mod, step.table);
145
+ const where = compile(step.opts?.where);
146
+ const orderBy = step.opts?.orderBy;
147
+ const limit = typeof step.opts?.limit === "number" ? step.opts?.limit : undefined;
148
+ const offset = typeof step.opts?.offset === "number" ? step.opts?.offset : undefined;
149
+ const whereClause = where.sql;
150
+ const params = [...where.values];
151
+ let extra = "";
152
+ if (orderBy) {
153
+ if (!IDENT.test(orderBy.col))
154
+ throw new Error(`[tx] orderBy bad column "${orderBy.col}"`);
155
+ const dir = orderBy.dir === "desc" ? "DESC" : "ASC";
156
+ extra += ` ORDER BY "${orderBy.col}" ${dir}`;
157
+ }
158
+ if (typeof limit === "number") {
159
+ extra += " LIMIT " + Math.max(0, Math.floor(limit));
160
+ }
161
+ if (typeof offset === "number") {
162
+ extra += " OFFSET " + Math.max(0, Math.floor(offset));
163
+ }
164
+ const sql = `SELECT * FROM "${step.table}" WHERE ${whereClause}${extra}`;
165
+ const rows = this.deps.db.prepare(sql).all(...params);
166
+ return { op: "query", rows };
167
+ }
168
+ /** 解析主键 WHERE。单列直接等值;联合主键支持 `a|b|c`(与 data-backup 约定一致)。 */
169
+ pkWhere(table, id) {
170
+ const cols = this.deps.db.prepare(`PRAGMA table_info("${table}")`).all();
171
+ const pkCols = cols
172
+ .filter((c) => c.pk > 0)
173
+ .sort((a, b) => a.pk - b.pk)
174
+ .map((c) => c.name);
175
+ if (pkCols.length === 0) {
176
+ throw new Error(`[tx] ${table} 没有 primary key`);
177
+ }
178
+ if (pkCols.length === 1) {
179
+ return { clause: `"${pkCols[0]}" = ?`, values: [id] };
180
+ }
181
+ const parts = String(id).split("|");
182
+ if (parts.length === pkCols.length) {
183
+ return {
184
+ clause: pkCols.map((c) => `"${c}" = ?`).join(" AND "),
185
+ values: parts,
186
+ };
187
+ }
188
+ // 联合主键但只传了首列(频道 id 等):按第一主键列匹配
189
+ return { clause: `"${pkCols[0]}" = ?`, values: [id] };
190
+ }
191
+ doGet(_mid, mod, step) {
192
+ this.requireTableRead(mod, step.table);
193
+ const where = this.pkWhere(step.table, step.id);
194
+ const row = this.deps.db
195
+ .prepare(`SELECT * FROM "${step.table}" WHERE ${where.clause}`)
196
+ .get(...where.values);
197
+ return { op: "get", row: row ?? null };
198
+ }
199
+ doInsert(_mid, mod, step) {
200
+ this.requireTableWrite(mod, step.table);
201
+ const cols = Object.keys(step.row);
202
+ if (cols.length === 0)
203
+ throw new Error("[tx] insert row 必须至少一个字段");
204
+ for (const c of cols) {
205
+ if (!IDENT.test(c))
206
+ throw new Error(`[tx] invalid column name "${c}"`);
207
+ }
208
+ const placeholders = cols.map(() => "?").join(",");
209
+ const quoted = cols.map((c) => `"${c}"`).join(",");
210
+ const values = cols.map((c) => step.row[c]);
211
+ const sql = `INSERT INTO "${step.table}" (${quoted}) VALUES (${placeholders})`;
212
+ try {
213
+ this.deps.db.prepare(sql).run(...values);
214
+ }
215
+ catch (e) {
216
+ throw new Error(`INSERT ${step.table} 失败: ${e.message}`);
217
+ }
218
+ return { op: "insert", row: { ...step.row } };
219
+ }
220
+ doUpdate(_mid, mod, step) {
221
+ this.requireTableWrite(mod, step.table);
222
+ const cols = Object.keys(step.patch);
223
+ if (cols.length === 0)
224
+ throw new Error("[tx] update patch 不能为空");
225
+ for (const c of cols) {
226
+ if (!IDENT.test(c))
227
+ throw new Error(`[tx] invalid column name "${c}"`);
228
+ }
229
+ const where = this.pkWhere(step.table, step.id);
230
+ const sets = cols.map((c) => `"${c}" = ?`).join(",");
231
+ const params = [...cols.map((c) => step.patch[c]), ...where.values];
232
+ const sql = `UPDATE "${step.table}" SET ${sets} WHERE ${where.clause}`;
233
+ const result = this.deps.db.prepare(sql).run(...params);
234
+ if (result.changes === 0) {
235
+ throw new Error(`UPDATE ${step.table} id=${step.id} 影响 0 行(找不到 / 已删?)`);
236
+ }
237
+ return { op: "update", row: { ...step.patch, id: step.id } };
238
+ }
239
+ doDelete(_mid, mod, step) {
240
+ this.requireTableWrite(mod, step.table);
241
+ const where = this.pkWhere(step.table, step.id);
242
+ if (step.hard) {
243
+ const sql = `DELETE FROM "${step.table}" WHERE ${where.clause}`;
244
+ const r = this.deps.db.prepare(sql).run(...where.values);
245
+ return { op: "delete", changes: Number(r.changes) };
246
+ }
247
+ const cols = this.deps.db.prepare(`PRAGMA table_info("${step.table}")`).all();
248
+ const hasDeletedAt = cols.find((c) => c.name === "_deleted_at");
249
+ if (!hasDeletedAt) {
250
+ throw new Error(`[tx] ${step.table} 没启用 softDelete,删不掉;请 hard=true 或 schema 设 softDelete=true`);
251
+ }
252
+ const sql = `UPDATE "${step.table}" SET "_deleted_at" = ?, "_version" = COALESCE("_version",0)+1 WHERE ${where.clause}`;
253
+ const r = this.deps.db.prepare(sql).run(Date.now(), ...where.values);
254
+ return { op: "delete", changes: Number(r.changes) };
255
+ }
256
+ doAudit(_mid, mod, step) {
257
+ this.requireTableWrite(mod, step.table);
258
+ const dataJson = step.data ? JSON.stringify(step.data) : null;
259
+ const r = this.deps.db
260
+ .prepare(`INSERT INTO sfmc__audit (module_id, table_name, row_id, action, data, created_at)
261
+ VALUES (?, ?, ?, ?, ?, ?)`)
262
+ .run(mod.id, step.table, step.rowId, step.action, dataJson, new Date().toISOString());
263
+ return { op: "audit", changes: Number(r.changes) };
264
+ }
265
+ async doService(_mid, mod, step) {
266
+ // requires / 自调用豁免的唯一权威在 ServiceRegistry.dispatch(DRY/LSP);
267
+ // 此处只补 dispatch 不做的 service:<name> 权限门(与 HTTP service-routes 对齐)。
268
+ assertModulePermission(mod.id, mod.permissions, Perm.service(step.name));
269
+ const result = await this.deps.serviceRegistry.dispatch(this.deps.enabled, mod.id, step.name, step.input, { query: this.deps.query, db: this.deps.db });
270
+ return { op: "service", result: result.result };
271
+ }
272
+ }
273
+ //# sourceMappingURL=tx-runner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tx-runner.js","sourceRoot":"","sources":["../src/tx-runner.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,48 @@
1
+ /**
2
+ * where.ts — WhereExpr → SQL WHERE 子句 + 参数化 values
3
+ *
4
+ * 目的:模块作者写 {eq:["owner","abc"]} / {and:[...]} 这种结构化查询,
5
+ * 平台翻译成带占位符的 SQL,杜绝 raw SQL 字符串拼接。
6
+ *
7
+ * 支持的算子:
8
+ * eq / ne / gt / gte / lt / lte / like / in / isNull / isNotNull / and / or / not
9
+ *
10
+ * 安全:
11
+ * - 列名必须匹配 /^[A-Za-z_][A-Za-z0-9_.]*$/ (允许 table.col)
12
+ * - 不接受字符串形式的 SQL
13
+ * - inList 展开成多个 ? 占位符
14
+ */
15
+ export type Primitive = string | number | boolean | null;
16
+ export type WhereExpr = {
17
+ eq: [string, Primitive];
18
+ } | {
19
+ ne: [string, Primitive];
20
+ } | {
21
+ gt: [string, Primitive | number];
22
+ } | {
23
+ gte: [string, Primitive | number];
24
+ } | {
25
+ lt: [string, Primitive | number];
26
+ } | {
27
+ lte: [string, Primitive | number];
28
+ } | {
29
+ like: [string, string];
30
+ } | {
31
+ in: [string, Primitive[]];
32
+ } | {
33
+ isNull: string;
34
+ } | {
35
+ isNotNull: string;
36
+ } | {
37
+ and: WhereExpr[];
38
+ } | {
39
+ or: WhereExpr[];
40
+ } | {
41
+ not: WhereExpr;
42
+ };
43
+ export interface CompiledWhere {
44
+ sql: string;
45
+ values: unknown[];
46
+ }
47
+ export declare function compile(expr: WhereExpr | undefined): CompiledWhere;
48
+ //# sourceMappingURL=where.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"where.d.ts","sourceRoot":"","sources":["../src/where.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAEzD,MAAM,MAAM,SAAS,GACjB;IAAE,EAAE,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CAAE,GAC3B;IAAE,EAAE,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CAAE,GAC3B;IAAE,EAAE,EAAE,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,CAAA;CAAE,GACpC;IAAE,GAAG,EAAE,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,CAAA;CAAE,GACrC;IAAE,EAAE,EAAE,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,CAAA;CAAE,GACpC;IAAE,GAAG,EAAE,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC1B;IAAE,EAAE,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;CAAE,GAC7B;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GACrB;IAAE,GAAG,EAAE,SAAS,EAAE,CAAA;CAAE,GACpB;IAAE,EAAE,EAAE,SAAS,EAAE,CAAA;CAAE,GACnB;IAAE,GAAG,EAAE,SAAS,CAAA;CAAE,CAAC;AAEvB,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAqBD,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,aAAa,CAGlE"}
package/dist/where.js ADDED
@@ -0,0 +1,107 @@
1
+ /**
2
+ * where.ts — WhereExpr → SQL WHERE 子句 + 参数化 values
3
+ *
4
+ * 目的:模块作者写 {eq:["owner","abc"]} / {and:[...]} 这种结构化查询,
5
+ * 平台翻译成带占位符的 SQL,杜绝 raw SQL 字符串拼接。
6
+ *
7
+ * 支持的算子:
8
+ * eq / ne / gt / gte / lt / lte / like / in / isNull / isNotNull / and / or / not
9
+ *
10
+ * 安全:
11
+ * - 列名必须匹配 /^[A-Za-z_][A-Za-z0-9_.]*$/ (允许 table.col)
12
+ * - 不接受字符串形式的 SQL
13
+ * - inList 展开成多个 ? 占位符
14
+ */
15
+ const IDENT = /^[A-Za-z_][A-Za-z0-9_]*$/;
16
+ const IDENT_DOT = /^[A-Za-z_][A-Za-z0-9_]*\.[A-Za-z_][A-Za-z0-9_]*$/;
17
+ function q(col) {
18
+ if (!IDENT.test(col) && !IDENT_DOT.test(col)) {
19
+ throw new Error(`[where] invalid column name: ${JSON.stringify(col)}`);
20
+ }
21
+ // table.col → "table"."col"
22
+ if (col.includes(".")) {
23
+ const [t, c] = col.split(".");
24
+ return `"${t}"."${c}"`;
25
+ }
26
+ return `"${col}"`;
27
+ }
28
+ function isPrimitive(v) {
29
+ return typeof v === "string" || typeof v === "number" || typeof v === "boolean" || v === null;
30
+ }
31
+ export function compile(expr) {
32
+ if (!expr)
33
+ return { sql: "1=1", values: [] };
34
+ return compileOne(expr);
35
+ }
36
+ function compileOne(e) {
37
+ if ("and" in e) {
38
+ if (!Array.isArray(e.and) || e.and.length === 0)
39
+ return { sql: "1=1", values: [] };
40
+ const parts = e.and.map(compileOne);
41
+ return {
42
+ sql: "(" + parts.map((p) => p.sql).join(" AND ") + ")",
43
+ values: parts.flatMap((p) => p.values),
44
+ };
45
+ }
46
+ if ("or" in e) {
47
+ if (!Array.isArray(e.or) || e.or.length === 0)
48
+ return { sql: "1=0", values: [] };
49
+ const parts = e.or.map(compileOne);
50
+ return {
51
+ sql: "(" + parts.map((p) => p.sql).join(" OR ") + ")",
52
+ values: parts.flatMap((p) => p.values),
53
+ };
54
+ }
55
+ if ("not" in e) {
56
+ const inner = compileOne(e.not);
57
+ return { sql: "NOT (" + inner.sql + ")", values: inner.values };
58
+ }
59
+ if ("isNull" in e) {
60
+ return { sql: `${q(e.isNull)} IS NULL`, values: [] };
61
+ }
62
+ if ("isNotNull" in e) {
63
+ return { sql: `${q(e.isNotNull)} IS NOT NULL`, values: [] };
64
+ }
65
+ if ("eq" in e) {
66
+ if (!isPrimitive(e.eq[1]))
67
+ throw new Error("[where] eq value must be primitive");
68
+ return { sql: `${q(e.eq[0])} = ?`, values: [e.eq[1]] };
69
+ }
70
+ if ("ne" in e) {
71
+ if (!isPrimitive(e.ne[1]))
72
+ throw new Error("[where] ne value must be primitive");
73
+ return { sql: `${q(e.ne[0])} <> ?`, values: [e.ne[1]] };
74
+ }
75
+ if ("gt" in e)
76
+ return numeric(q(e.gt[0]), ">", e.gt[1]);
77
+ if ("gte" in e)
78
+ return numeric(q(e.gte[0]), ">=", e.gte[1]);
79
+ if ("lt" in e)
80
+ return numeric(q(e.lt[0]), "<", e.lt[1]);
81
+ if ("lte" in e)
82
+ return numeric(q(e.lte[0]), "<=", e.lte[1]);
83
+ if ("like" in e) {
84
+ if (typeof e.like[1] !== "string")
85
+ throw new Error("[where] like value must be string");
86
+ return { sql: `${q(e.like[0])} LIKE ?`, values: [e.like[1]] };
87
+ }
88
+ if ("in" in e) {
89
+ if (!Array.isArray(e.in[1]) || e.in[1].length === 0) {
90
+ throw new Error("[where] in requires non-empty array");
91
+ }
92
+ for (const v of e.in[1]) {
93
+ if (!isPrimitive(v))
94
+ throw new Error("[where] in values must be primitive");
95
+ }
96
+ const placeholders = e.in[1].map(() => "?").join(",");
97
+ return { sql: `${q(e.in[0])} IN (${placeholders})`, values: [...e.in[1]] };
98
+ }
99
+ throw new Error("[where] unknown operator");
100
+ }
101
+ function numeric(col, op, v) {
102
+ if (typeof v === "string" || typeof v === "boolean" || v === null) {
103
+ throw new Error(`[where] ${op} expects number, got ${typeof v}`);
104
+ }
105
+ return { sql: `${col} ${op} ?`, values: [v] };
106
+ }
107
+ //# sourceMappingURL=where.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"where.js","sourceRoot":"","sources":["../src/where.ts"],"names":[],"mappings":"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"}
package/package.json ADDED
@@ -0,0 +1,52 @@
1
+ {
2
+ "name": "@sfmc-bds/db-server",
3
+ "version": "0.1.0",
4
+ "description": "SFMC SQLite HTTP REST backend — configs, modules, gameplay data, QQ message relay",
5
+ "type": "module",
6
+ "license": "ISC",
7
+ "author": "Shiroha7z",
8
+ "homepage": "https://github.com/DogeLakeDev/ScriptsForMinecraftServer/tree/main/db-server#readme",
9
+ "repository": {
10
+ "type": "git",
11
+ "url": "git+https://github.com/DogeLakeDev/ScriptsForMinecraftServer.git",
12
+ "directory": "db-server"
13
+ },
14
+ "bugs": {
15
+ "url": "https://github.com/DogeLakeDev/ScriptsForMinecraftServer/issues"
16
+ },
17
+ "keywords": [
18
+ "minecraft-bedrock",
19
+ "sfmc",
20
+ "sqlite",
21
+ "rest-api",
22
+ "scriptsforminecraftserver"
23
+ ],
24
+ "main": "dist/index.js",
25
+ "types": "./dist/index.d.ts",
26
+ "files": [
27
+ "dist",
28
+ "README.md"
29
+ ],
30
+ "scripts": {
31
+ "start": "node dist/index.js",
32
+ "dev": "tsx src/index.ts",
33
+ "build": "tsc -p tsconfig.json",
34
+ "typecheck": "tsc --noEmit",
35
+ "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
36
+ "test": "npm run build && node --test dist/*.test.js",
37
+ "format": "prettier --write \"src/**/*.{ts,tsx,js,json}\"",
38
+ "prepublishOnly": "npm run build"
39
+ },
40
+ "dependencies": {
41
+ "@sfmc-bds/sdk": "^0.1.0",
42
+ "sql-template-strings": "^2.2.2",
43
+ "ws": "^8.21.1"
44
+ },
45
+ "engines": {
46
+ "node": ">=22.13.0"
47
+ },
48
+ "publishConfig": {
49
+ "access": "public",
50
+ "registry": "https://registry.npmjs.org/"
51
+ }
52
+ }