@sfmc-bds/db-server 0.1.0 → 0.2.0-beta.1

package/dist/lib/http.js

@@ -1,43 +1,34 @@
-/**
- * lib/http.ts — HTTP 工具（JSON 响应 + body 解析）
- *
- * 所有 db-server 路由统一走这里的 json / body / parseBody。
- * 路由上下文 ({ path, method, params, req, res }) 在 routes/_shared.ts 定义。
- */
-/** 写 JSON 响应并结束。 */
-export function json(res, data, status = 200) {
-    res.writeHead(status, { "Content-Type": "application/json" });
-    res.end(JSON.stringify(data));
+function json(res, data, status = 200) {
+  res.writeHead(status, { "Content-Type": "application/json" });
+  res.end(JSON.stringify(data));
 }
-/** 解析请求 body 字符串为对象（解析失败返回空对象）。 */
-export function parseBody(raw) {
-    try {
-        return JSON.parse(raw || "{}");
-    }
-    catch {
-        return {};
-    }
+function parseBody(raw) {
+  try {
+    return JSON.parse(raw || "{}");
+  } catch {
+    return {};
+  }
 }
-/**
- * 异步读取请求 body，结果会缓存到 req._bodyPromise 上以避免重复读取。
- * Buffer 累积 + 异步拼接，正确处理 binary 字节流。
- */
-export function body(req) {
-    const cached = req._bodyPromise;
-    if (cached)
-        return cached;
-    const promise = new Promise((resolve) => {
-        const chunks = [];
-        req.on("data", (chunk) => {
-            chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
-        });
-        req.on("end", () => {
-            const raw = Buffer.concat(chunks).toString("utf-8");
-            resolve(parseBody(raw));
-        });
-        req.on("error", () => resolve({}));
+function body(req) {
+  const cached = req._bodyPromise;
+  if (cached) return cached;
+  const promise = new Promise((resolve) => {
+    const chunks = [];
+    req.on("data", (chunk) => {
+      chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
     });
-    req._bodyPromise = promise;
-    return promise;
+    req.on("end", () => {
+      const raw = Buffer.concat(chunks).toString("utf-8");
+      resolve(parseBody(raw));
+    });
+    req.on("error", () => resolve({}));
+  });
+  req._bodyPromise = promise;
+  return promise;
 }
-//# sourceMappingURL=http.js.map
+export {
+  body,
+  json,
+  parseBody
+};
+//# sourceMappingURL=http.js.map

package/dist/lib/http.js.map

@@ -1 +1,7 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/lib/http.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,oBAAoB;AACpB,MAAM,UAAU,IAAI,CAAC,GAAmB,EAAE,IAA6B,EAAE,SAAiB,GAAG;IAC3F,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC9D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAA4B,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,GAAoB;IACvC,MAAM,MAAM,GAAI,GAA6E,CAAC,YAAY,CAAC;IAC3G,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,OAAO,GAAG,IAAI,OAAO,CAA0B,CAAC,OAAO,EAAE,EAAE;QAC/D,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAsB,EAAE,EAAE;YACxC,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YACjB,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACpD,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IACF,GAA6E,CAAC,YAAY,GAAG,OAAO,CAAC;IACtG,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{
+  "version": 3,
+  "sources": ["../../src/lib/http.ts"],
+  "sourcesContent": ["/**\n * lib/http.ts \u2014 HTTP \u5DE5\u5177\uFF08JSON \u54CD\u5E94 + body \u89E3\u6790\uFF09\n *\n * \u6240\u6709 db-server \u8DEF\u7531\u7EDF\u4E00\u8D70\u8FD9\u91CC\u7684 json / body / parseBody\u3002\n * \u8DEF\u7531\u4E0A\u4E0B\u6587 ({ path, method, params, req, res }) \u5728 routes/_shared.ts \u5B9A\u4E49\u3002\n */\n\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\n\nexport type Method = \"GET\" | \"POST\" | \"PUT\" | \"DELETE\" | \"PATCH\";\n\n/** \u5199 JSON \u54CD\u5E94\u5E76\u7ED3\u675F\u3002 */\nexport function json(res: ServerResponse, data: Record<string, unknown>, status: number = 200): void {\n  res.writeHead(status, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify(data));\n}\n\n/** \u89E3\u6790\u8BF7\u6C42 body \u5B57\u7B26\u4E32\u4E3A\u5BF9\u8C61\uFF08\u89E3\u6790\u5931\u8D25\u8FD4\u56DE\u7A7A\u5BF9\u8C61\uFF09\u3002 */\nexport function parseBody(raw: string): Record<string, unknown> {\n  try {\n    return JSON.parse(raw || \"{}\") as Record<string, unknown>;\n  } catch {\n    return {};\n  }\n}\n\n/**\n * \u5F02\u6B65\u8BFB\u53D6\u8BF7\u6C42 body\uFF0C\u7ED3\u679C\u4F1A\u7F13\u5B58\u5230 req._bodyPromise \u4E0A\u4EE5\u907F\u514D\u91CD\u590D\u8BFB\u53D6\u3002\n * Buffer \u7D2F\u79EF + \u5F02\u6B65\u62FC\u63A5\uFF0C\u6B63\u786E\u5904\u7406 binary \u5B57\u8282\u6D41\u3002\n */\nexport function body(req: IncomingMessage): Promise<Record<string, unknown>> {\n  const cached = (req as IncomingMessage & { _bodyPromise?: Promise<Record<string, unknown>> })._bodyPromise;\n  if (cached) return cached;\n  const promise = new Promise<Record<string, unknown>>((resolve) => {\n    const chunks: Buffer[] = [];\n    req.on(\"data\", (chunk: Buffer | string) => {\n      chunks.push(typeof chunk === \"string\" ? Buffer.from(chunk) : chunk);\n    });\n    req.on(\"end\", () => {\n      const raw = Buffer.concat(chunks).toString(\"utf-8\");\n      resolve(parseBody(raw));\n    });\n    req.on(\"error\", () => resolve({}));\n  });\n  (req as IncomingMessage & { _bodyPromise?: Promise<Record<string, unknown>> })._bodyPromise = promise;\n  return promise;\n}\n"],
+  "mappings": "AAYO,SAAS,KAAK,KAAqB,MAA+B,SAAiB,KAAW;AACnG,MAAI,UAAU,QAAQ,EAAE,gBAAgB,mBAAmB,CAAC;AAC5D,MAAI,IAAI,KAAK,UAAU,IAAI,CAAC;AAC9B;AAGO,SAAS,UAAU,KAAsC;AAC9D,MAAI;AACF,WAAO,KAAK,MAAM,OAAO,IAAI;AAAA,EAC/B,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAMO,SAAS,KAAK,KAAwD;AAC3E,QAAM,SAAU,IAA8E;AAC9F,MAAI,OAAQ,QAAO;AACnB,QAAM,UAAU,IAAI,QAAiC,CAAC,YAAY;AAChE,UAAM,SAAmB,CAAC;AAC1B,QAAI,GAAG,QAAQ,CAAC,UAA2B;AACzC,aAAO,KAAK,OAAO,UAAU,WAAW,OAAO,KAAK,KAAK,IAAI,KAAK;AAAA,IACpE,CAAC;AACD,QAAI,GAAG,OAAO,MAAM;AAClB,YAAM,MAAM,OAAO,OAAO,MAAM,EAAE,SAAS,OAAO;AAClD,cAAQ,UAAU,GAAG,CAAC;AAAA,IACxB,CAAC;AACD,QAAI,GAAG,SAAS,MAAM,QAAQ,CAAC,CAAC,CAAC;AAAA,EACnC,CAAC;AACD,EAAC,IAA8E,eAAe;AAC9F,SAAO;AACT;",
+  "names": []
+}

package/dist/lib/idempotency-store.js

@@ -1,49 +1,36 @@
-/**
- * lib/idempotency.ts — db.idempotent() 后端
- *
- * 表:sfmc__idempotent  (db-tables.ts 创建)
- * key: (module_id, action, key) → cached value?
- *
- * probe(module_id, action, key):
- *   - 命中 → {replayed:true, cached}
- *   - 不命中 → {replayed:false}
- *
- * commit(module_id, action, key, value?):
- *   - INSERT … (replace) — 即使没 probe 也允许直接 commit
- *
- * 事务内调用一律走 tx-runner 不行(commit 必须在事务外完成,跨事务持久化);
- * 这里单独端点 POST /api/sfmc/db/idempotent/{probe,commit},不走 tx。
- */
 import { isValidIdempotencyKey } from "./idempotency.js";
-export function createIdempotencyStore(db) {
-    const probeStmt = db.prepare("SELECT value FROM sfmc__idempotent WHERE module_id=? AND action=? AND key=?");
-    const insertStmt = db.prepare(`INSERT OR REPLACE INTO sfmc__idempotent (module_id, action, key, value, created_at)
-     VALUES (?, ?, ?, ?, ?)`);
-    return {
-        async probe(moduleId, action, key) {
-            if (!isValidIdempotencyKey(key))
-                throw new Error("invalid idempotency key");
-            const row = probeStmt.get(moduleId, action, key);
-            if (!row)
-                return { replayed: false };
-            let cached = null;
-            if (row.value) {
-                try {
-                    cached = JSON.parse(row.value);
-                }
-                catch {
-                    cached = row.value;
-                }
-            }
-            return { replayed: true, cached };
-        },
-        async commit(moduleId, action, key, value) {
-            if (!isValidIdempotencyKey(key))
-                throw new Error("invalid idempotency key");
-            const json = value === undefined ? null : JSON.stringify(value);
-            insertStmt.run(moduleId, action, key, json, new Date().toISOString());
-            return { ok: true };
-        },
-    };
+function createIdempotencyStore(db) {
+  const probeStmt = db.prepare(
+    "SELECT value FROM sfmc__idempotent WHERE module_id=? AND action=? AND key=?"
+  );
+  const insertStmt = db.prepare(
+    `INSERT OR REPLACE INTO sfmc__idempotent (module_id, action, key, value, created_at)
+     VALUES (?, ?, ?, ?, ?)`
+  );
+  return {
+    async probe(moduleId, action, key) {
+      if (!isValidIdempotencyKey(key)) throw new Error("invalid idempotency key");
+      const row = probeStmt.get(moduleId, action, key);
+      if (!row) return { replayed: false };
+      let cached = null;
+      if (row.value) {
+        try {
+          cached = JSON.parse(row.value);
+        } catch {
+          cached = row.value;
+        }
+      }
+      return { replayed: true, cached };
+    },
+    async commit(moduleId, action, key, value) {
+      if (!isValidIdempotencyKey(key)) throw new Error("invalid idempotency key");
+      const json = value === void 0 ? null : JSON.stringify(value);
+      insertStmt.run(moduleId, action, key, json, (/* @__PURE__ */ new Date()).toISOString());
+      return { ok: true };
+    }
+  };
 }
-//# sourceMappingURL=idempotency-store.js.map
+export {
+  createIdempotencyStore
+};
+//# sourceMappingURL=idempotency-store.js.map

package/dist/lib/idempotency-store.js.map

@@ -1 +1,7 @@
-{"version":3,"file":"idempotency-store.js","sourceRoot":"","sources":["../../src/lib/idempotency-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAOzD,MAAM,UAAU,sBAAsB,CAAC,EAAgB;IACrD,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,CAC1B,6EAA6E,CAC9E,CAAC;IACF,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAC3B;4BACwB,CACzB,CAAC;IAEF,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG;YAC/B,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC5E,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAyC,CAAC;YACzF,IAAI,CAAC,GAAG;gBAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;YACrC,IAAI,MAAM,GAAY,IAAI,CAAC;YAC3B,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBACd,IAAI,CAAC;oBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACjC,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC;gBACrB,CAAC;YACH,CAAC;YACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,KAAM;YACxC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC5E,MAAM,IAAI,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAChE,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;YACtE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC"}
+{
+  "version": 3,
+  "sources": ["../../src/lib/idempotency-store.ts"],
+  "sourcesContent": ["/**\n * lib/idempotency.ts \u2014 db.idempotent() \u540E\u7AEF\n *\n * \u8868:sfmc__idempotent  (db-tables.ts \u521B\u5EFA)\n * key: (module_id, action, key) \u2192 cached value?\n *\n * probe(module_id, action, key):\n *   - \u547D\u4E2D \u2192 {replayed:true, cached}\n *   - \u4E0D\u547D\u4E2D \u2192 {replayed:false}\n *\n * commit(module_id, action, key, value?):\n *   - INSERT \u2026 (replace) \u2014 \u5373\u4F7F\u6CA1 probe \u4E5F\u5141\u8BB8\u76F4\u63A5 commit\n *\n * \u4E8B\u52A1\u5185\u8C03\u7528\u4E00\u5F8B\u8D70 tx-runner \u4E0D\u884C(commit \u5FC5\u987B\u5728\u4E8B\u52A1\u5916\u5B8C\u6210,\u8DE8\u4E8B\u52A1\u6301\u4E45\u5316);\n * \u8FD9\u91CC\u5355\u72EC\u7AEF\u70B9 POST /api/sfmc/db/idempotent/{probe,commit},\u4E0D\u8D70 tx\u3002\n */\n\nimport type { DatabaseSync } from \"node:sqlite\";\nimport { isValidIdempotencyKey } from \"./idempotency.js\";\n\nexport interface IdempotencyStore {\n  probe(moduleId: string, action: string, key: string): Promise<{ replayed: boolean; cached?: unknown }>;\n  commit(moduleId: string, action: string, key: string, value?: unknown): Promise<{ ok: boolean }>;\n}\n\nexport function createIdempotencyStore(db: DatabaseSync): IdempotencyStore {\n  const probeStmt = db.prepare(\n    \"SELECT value FROM sfmc__idempotent WHERE module_id=? AND action=? AND key=?\"\n  );\n  const insertStmt = db.prepare(\n    `INSERT OR REPLACE INTO sfmc__idempotent (module_id, action, key, value, created_at)\n     VALUES (?, ?, ?, ?, ?)`\n  );\n\n  return {\n    async probe(moduleId, action, key) {\n      if (!isValidIdempotencyKey(key)) throw new Error(\"invalid idempotency key\");\n      const row = probeStmt.get(moduleId, action, key) as { value: string | null } | undefined;\n      if (!row) return { replayed: false };\n      let cached: unknown = null;\n      if (row.value) {\n        try {\n          cached = JSON.parse(row.value);\n        } catch {\n          cached = row.value;\n        }\n      }\n      return { replayed: true, cached };\n    },\n\n    async commit(moduleId, action, key, value?) {\n      if (!isValidIdempotencyKey(key)) throw new Error(\"invalid idempotency key\");\n      const json = value === undefined ? null : JSON.stringify(value);\n      insertStmt.run(moduleId, action, key, json, new Date().toISOString());\n      return { ok: true };\n    },\n  };\n}\n"],
+  "mappings": "AAkBA,SAAS,6BAA6B;AAO/B,SAAS,uBAAuB,IAAoC;AACzE,QAAM,YAAY,GAAG;AAAA,IACnB;AAAA,EACF;AACA,QAAM,aAAa,GAAG;AAAA,IACpB;AAAA;AAAA,EAEF;AAEA,SAAO;AAAA,IACL,MAAM,MAAM,UAAU,QAAQ,KAAK;AACjC,UAAI,CAAC,sBAAsB,GAAG,EAAG,OAAM,IAAI,MAAM,yBAAyB;AAC1E,YAAM,MAAM,UAAU,IAAI,UAAU,QAAQ,GAAG;AAC/C,UAAI,CAAC,IAAK,QAAO,EAAE,UAAU,MAAM;AACnC,UAAI,SAAkB;AACtB,UAAI,IAAI,OAAO;AACb,YAAI;AACF,mBAAS,KAAK,MAAM,IAAI,KAAK;AAAA,QAC/B,QAAQ;AACN,mBAAS,IAAI;AAAA,QACf;AAAA,MACF;AACA,aAAO,EAAE,UAAU,MAAM,OAAO;AAAA,IAClC;AAAA,IAEA,MAAM,OAAO,UAAU,QAAQ,KAAK,OAAQ;AAC1C,UAAI,CAAC,sBAAsB,GAAG,EAAG,OAAM,IAAI,MAAM,yBAAyB;AAC1E,YAAM,OAAO,UAAU,SAAY,OAAO,KAAK,UAAU,KAAK;AAC9D,iBAAW,IAAI,UAAU,QAAQ,KAAK,OAAM,oBAAI,KAAK,GAAE,YAAY,CAAC;AACpE,aAAO,EAAE,IAAI,KAAK;AAAA,IACpB;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/lib/idempotency.js

@@ -1,14 +1,9 @@
-/**
- * 验证幂等键格式
- *
- * @export
- * @param {string} key
- * @return {*}  {(boolean | string)}
- */
-export function isValidIdempotencyKey(key) {
-    if (!key || typeof key !== "string")
-        return false;
-    const trimmed = key.trim();
-    return trimmed.length > 0 && /^[A-Za-z0-9_.:-]{1,128}$/.test(trimmed);
+function isValidIdempotencyKey(key) {
+  if (!key || typeof key !== "string") return false;
+  const trimmed = key.trim();
+  return trimmed.length > 0 && /^[A-Za-z0-9_.:-]{1,128}$/.test(trimmed);
 }
-//# sourceMappingURL=idempotency.js.map
+export {
+  isValidIdempotencyKey
+};
+//# sourceMappingURL=idempotency.js.map

package/dist/lib/idempotency.js.map

@@ -1 +1,7 @@
-{"version":3,"file":"idempotency.js","sourceRoot":"","sources":["../../src/lib/idempotency.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACxE,CAAC"}
+{
+  "version": 3,
+  "sources": ["../../src/lib/idempotency.ts"],
+  "sourcesContent": ["/**\n * \u9A8C\u8BC1\u5E42\u7B49\u952E\u683C\u5F0F\n *\n * @export\n * @param {string} key\n * @return {*}  {(boolean | string)}\n */\nexport function isValidIdempotencyKey(key: string): boolean {\n  if (!key || typeof key !== \"string\") return false;\n  const trimmed = key.trim();\n  return trimmed.length > 0 && /^[A-Za-z0-9_.:-]{1,128}$/.test(trimmed);\n}\n"],
+  "mappings": "AAOO,SAAS,sBAAsB,KAAsB;AAC1D,MAAI,CAAC,OAAO,OAAO,QAAQ,SAAU,QAAO;AAC5C,QAAM,UAAU,IAAI,KAAK;AACzB,SAAO,QAAQ,SAAS,KAAK,2BAA2B,KAAK,OAAO;AACtE;",
+  "names": []
+}

package/dist/lib/identifiers.js

@@ -1,18 +1,22 @@
 class IdentifierError extends Error {
-    code;
-    constructor(message, code) {
-        super(message);
-        this.code = code;
-        Object.setPrototypeOf(this, IdentifierError.prototype);
-    }
+  code;
+  constructor(message, code) {
+    super(message);
+    this.code = code;
+    Object.setPrototypeOf(this, IdentifierError.prototype);
+  }
 }
-export function assertIdentifier(value, label = "identifier") {
-    if (typeof value !== "string" || !/^[A-Za-z_][A-Za-z0-9_]*$/.test(value)) {
-        throw new IdentifierError(`Invalid SQL ${label}`, "INVALID_IDENTIFIER");
-    }
-    return value;
+function assertIdentifier(value, label = "identifier") {
+  if (typeof value !== "string" || !/^[A-Za-z_][A-Za-z0-9_]*$/.test(value)) {
+    throw new IdentifierError(`Invalid SQL ${label}`, "INVALID_IDENTIFIER");
+  }
+  return value;
 }
-export function quoteIdentifier(value, label) {
-    return `"${assertIdentifier(value, label)}"`;
+function quoteIdentifier(value, label) {
+  return `"${assertIdentifier(value, label)}"`;
 }
-//# sourceMappingURL=identifiers.js.map
+export {
+  assertIdentifier,
+  quoteIdentifier
+};
+//# sourceMappingURL=identifiers.js.map

package/dist/lib/identifiers.js.map

@@ -1 +1,7 @@
-{"version":3,"file":"identifiers.js","sourceRoot":"","sources":["../../src/lib/identifiers.ts"],"names":[],"mappings":"AAAA,MAAM,eAAgB,SAAQ,KAAK;IACjC,IAAI,CAAS;IACb,YAAY,OAAe,EAAE,IAAY;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACF;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc,EAAE,QAAgB,YAAY;IAC3E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,eAAe,CAAC,eAAe,KAAK,EAAE,EAAE,oBAAoB,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,KAAa;IAC1D,OAAO,IAAI,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC;AAC/C,CAAC"}
+{
+  "version": 3,
+  "sources": ["../../src/lib/identifiers.ts"],
+  "sourcesContent": ["class IdentifierError extends Error {\n  code: string;\n  constructor(message: string, code: string) {\n    super(message);\n    this.code = code;\n    Object.setPrototypeOf(this, IdentifierError.prototype);\n  }\n}\n\nexport function assertIdentifier(value: unknown, label: string = \"identifier\"): string {\n  if (typeof value !== \"string\" || !/^[A-Za-z_][A-Za-z0-9_]*$/.test(value)) {\n    throw new IdentifierError(`Invalid SQL ${label}`, \"INVALID_IDENTIFIER\");\n  }\n  return value;\n}\n\nexport function quoteIdentifier(value: string, label: string): string {\n  return `\"${assertIdentifier(value, label)}\"`;\n}\n"],
+  "mappings": "AAAA,MAAM,wBAAwB,MAAM;AAAA,EAClC;AAAA,EACA,YAAY,SAAiB,MAAc;AACzC,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,WAAO,eAAe,MAAM,gBAAgB,SAAS;AAAA,EACvD;AACF;AAEO,SAAS,iBAAiB,OAAgB,QAAgB,cAAsB;AACrF,MAAI,OAAO,UAAU,YAAY,CAAC,2BAA2B,KAAK,KAAK,GAAG;AACxE,UAAM,IAAI,gBAAgB,eAAe,KAAK,IAAI,oBAAoB;AAAA,EACxE;AACA,SAAO;AACT;AAEO,SAAS,gBAAgB,OAAe,OAAuB;AACpE,SAAO,IAAI,iBAAiB,OAAO,KAAK,CAAC;AAC3C;",
+  "names": []
+}

package/dist/lib/log.d.ts

@@ -1,11 +1,8 @@
 /**
  * log.ts — db-server 统一日志实例
  *
- * 通过 @sfmc-bds/logs 共享包接入,source = "db"。
- * sfmc 主进程通过捕获本进程 stdout 汇聚展示。
- *
- * bare 模式: stdout 只输出纯 text,不加时间戳/source/level 前缀
- * (由 sfmc 的 formatLog 统一添加,避免重复)。error 走 stderr。
+ * stdout bare + 落盘 `<SFMC_ROOT>/.sfmc/logs/db.log`。
+ * bare: 只输出纯 text,由 sfmc 捕获后统一加前缀;error 走 stderr。
  */
-export declare const log: import("@sfmc-bds/sdk/logs").Logger;
+export declare const log: import("@sfmc-bds/sdk/logs").NodeServiceLogger;
 //# sourceMappingURL=log.d.ts.map

package/dist/lib/log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/lib/log.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,eAAO,MAAM,GAAG,qCAGd,CAAC"}
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/lib/log.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,eAAO,MAAM,GAAG,gDAGd,CAAC"}

package/dist/lib/log.js

@@ -1,15 +1,14 @@
-/**
- * log.ts — db-server 统一日志实例
- *
- * 通过 @sfmc-bds/logs 共享包接入,source = "db"。
- * sfmc 主进程通过捕获本进程 stdout 汇聚展示。
- *
- * bare 模式: stdout 只输出纯 text,不加时间戳/source/level 前缀
- * (由 sfmc 的 formatLog 统一添加,避免重复)。error 走 stderr。
- */
-import { createLogger, createStdoutSink } from "@sfmc-bds/sdk/logs";
-export const log = createLogger({
-    source: "db",
-    sinks: [createStdoutSink({ bare: true })],
+import { createNodeServiceLogger } from "@sfmc-bds/sdk/logs";
+import { logFile, resolveRuntimeRoot } from "@sfmc-bds/sdk/node/config";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const ROOT = resolveRuntimeRoot(resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", ".."));
+const log = createNodeServiceLogger({
+  source: "db",
+  logPath: logFile(ROOT, "db")
 });
-//# sourceMappingURL=log.js.map
+process.on("exit", () => log.close());
+export {
+  log
+};
+//# sourceMappingURL=log.js.map

package/dist/lib/log.js.map

@@ -1 +1,7 @@
-{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/lib/log.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEpE,MAAM,CAAC,MAAM,GAAG,GAAG,YAAY,CAAC;IAC9B,MAAM,EAAE,IAAI;IACZ,KAAK,EAAE,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;CAC1C,CAAC,CAAC"}
+{
+  "version": 3,
+  "sources": ["../../src/lib/log.ts"],
+  "sourcesContent": ["/**\n * log.ts \u2014 db-server \u7EDF\u4E00\u65E5\u5FD7\u5B9E\u4F8B\n *\n * stdout bare + \u843D\u76D8 `<SFMC_ROOT>/.sfmc/logs/db.log`\u3002\n * bare: \u53EA\u8F93\u51FA\u7EAF text,\u7531 sfmc \u6355\u83B7\u540E\u7EDF\u4E00\u52A0\u524D\u7F00;error \u8D70 stderr\u3002\n */\n\nimport { createNodeServiceLogger } from \"@sfmc-bds/sdk/logs\";\nimport { logFile, resolveRuntimeRoot } from \"@sfmc-bds/sdk/node/config\";\nimport { dirname, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\n/** src/lib \u2192 \u4ED3\u6839(\u4E0E env.ts \u7684 src \u4E0A\u6EAF\u5DEE\u4E00\u5C42) */\nconst ROOT = resolveRuntimeRoot(resolve(dirname(fileURLToPath(import.meta.url)), \"..\", \"..\", \"..\"));\n\nexport const log = createNodeServiceLogger({\n  source: \"db\",\n  logPath: logFile(ROOT, \"db\"),\n});\n\nprocess.on(\"exit\", () => log.close());\n"],
+  "mappings": "AAOA,SAAS,+BAA+B;AACxC,SAAS,SAAS,0BAA0B;AAC5C,SAAS,SAAS,eAAe;AACjC,SAAS,qBAAqB;AAG9B,MAAM,OAAO,mBAAmB,QAAQ,QAAQ,cAAc,YAAY,GAAG,CAAC,GAAG,MAAM,MAAM,IAAI,CAAC;AAE3F,MAAM,MAAM,wBAAwB;AAAA,EACzC,QAAQ;AAAA,EACR,SAAS,QAAQ,MAAM,IAAI;AAC7B,CAAC;AAED,QAAQ,GAAG,QAAQ,MAAM,IAAI,MAAM,CAAC;",
+  "names": []
+}

package/dist/lib/module-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-state.d.ts","sourceRoot":"","sources":["../../src/lib/module-state.ts"],"names":[],"mappings":"AAEA,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE;AAED,KAAK,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAI3D;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAEvE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,GAAE,WAAgB,GAAG,WAAW,CAGpG;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,GAAE,OAAe,GAAG,OAAO,CAE9F;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,GAC7C,WAAW,CASb"}
+{"version":3,"file":"module-state.d.ts","sourceRoot":"","sources":["../../src/lib/module-state.ts"],"names":[],"mappings":"AAEA,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE;AAED,KAAK,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAS3D;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAEvE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,GAAE,WAAgB,GAAG,WAAW,CAGpG;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,GAAE,OAAe,GAAG,OAAO,CAE9F;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,GAC7C,WAAW,CASb"}

package/dist/lib/module-state.js

@@ -1,27 +1,38 @@
 import { readJson, writeJson } from "@sfmc-bds/sdk/node/config";
-export function loadModuleLock(filePath) {
-    const data = readJson(filePath);
-    const modules = data?.modules && typeof data.modules === "object" ? data.modules : {};
-    return { version: 1, modules };
+function loadModuleLock(filePath) {
+  const data = readJson(filePath);
+  const modules = data?.modules && typeof data.modules === "object" ? data.modules : {};
+  const lock = { version: 1, modules };
+  if (!data) {
+    saveModuleLock(filePath, lock);
+  }
+  return lock;
 }
-export function saveModuleLock(filePath, lock) {
-    writeJson(filePath, lock);
+function saveModuleLock(filePath, lock) {
+  writeJson(filePath, lock);
 }
-export function getModuleState(lock, id, defaults = {}) {
-    const state = lock.modules[id];
-    return state && typeof state === "object" ? state : defaults;
+function getModuleState(lock, id, defaults = {}) {
+  const state = lock.modules[id];
+  return state && typeof state === "object" ? state : defaults;
 }
-export function isEnabled(lock, id, defaultValue = false) {
-    return getModuleState(lock, id).enabled ?? defaultValue;
+function isEnabled(lock, id, defaultValue = false) {
+  return getModuleState(lock, id).enabled ?? defaultValue;
 }
-export function updateModuleState(lock, id, patch) {
-    const now = Date.now();
-    const previous = getModuleState(lock, id);
-    lock.modules[id] = {
-        ...previous,
-        ...patch,
-        updatedAt: now,
-    };
-    return lock.modules[id];
+function updateModuleState(lock, id, patch) {
+  const now = Date.now();
+  const previous = getModuleState(lock, id);
+  lock.modules[id] = {
+    ...previous,
+    ...patch,
+    updatedAt: now
+  };
+  return lock.modules[id];
 }
-//# sourceMappingURL=module-state.js.map
+export {
+  getModuleState,
+  isEnabled,
+  loadModuleLock,
+  saveModuleLock,
+  updateModuleState
+};
+//# sourceMappingURL=module-state.js.map

package/dist/lib/module-state.js.map

@@ -1 +1,7 @@
-{"version":3,"file":"module-state.js","sourceRoot":"","sources":["../../src/lib/module-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAShE,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,IAAI,GAAG,QAAQ,CAAa,QAAQ,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACtF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,IAAgB;IAC/D,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAgB,EAAE,EAAU,EAAE,WAAwB,EAAE;IACrF,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC/B,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAgB,EAAE,EAAU,EAAE,eAAwB,KAAK;IACnF,OAAO,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,YAAY,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAAgB,EAChB,EAAU,EACV,KAA8C;IAE9C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG;QACjB,GAAG,QAAQ;QACX,GAAG,KAAK;QACR,SAAS,EAAE,GAAG;KACf,CAAC;IACF,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC1B,CAAC"}
+{
+  "version": 3,
+  "sources": ["../../src/lib/module-state.ts"],
+  "sourcesContent": ["import { readJson, writeJson } from \"@sfmc-bds/sdk/node/config\";\n\ninterface ModuleLock {\n  version: number;\n  modules: Record<string, { enabled?: boolean; updatedAt?: number }>;\n}\n\ntype ModuleState = ModuleLock[\"modules\"][string];\n\nexport function loadModuleLock(filePath: string): ModuleLock {\n  const data = readJson<ModuleLock>(filePath);\n  const modules = data?.modules && typeof data.modules === \"object\" ? data.modules : {};\n  const lock: ModuleLock = { version: 1, modules };\n  // \u7F3A\u6587\u4EF6\u65F6\u843D\u76D8\u7A7A\u9AA8\u67B6\uFF0C\u4FBF\u4E8E\u540E\u7EED enable/disable\uFF08\u4E0E configs \u540C\u5C5E\u672C\u5730\u72B6\u6001\uFF09\n  if (!data) {\n    saveModuleLock(filePath, lock);\n  }\n  return lock;\n}\n\nexport function saveModuleLock(filePath: string, lock: ModuleLock): void {\n  writeJson(filePath, lock);\n}\n\nexport function getModuleState(lock: ModuleLock, id: string, defaults: ModuleState = {}): ModuleState {\n  const state = lock.modules[id];\n  return state && typeof state === \"object\" ? state : defaults;\n}\n\nexport function isEnabled(lock: ModuleLock, id: string, defaultValue: boolean = false): boolean {\n  return getModuleState(lock, id).enabled ?? defaultValue;\n}\n\nexport function updateModuleState(\n  lock: ModuleLock,\n  id: string,\n  patch: Partial<Omit<ModuleState, \"updatedAt\">>\n): ModuleState {\n  const now = Date.now();\n  const previous = getModuleState(lock, id);\n  lock.modules[id] = {\n    ...previous,\n    ...patch,\n    updatedAt: now,\n  };\n  return lock.modules[id];\n}"],
+  "mappings": "AAAA,SAAS,UAAU,iBAAiB;AAS7B,SAAS,eAAe,UAA8B;AAC3D,QAAM,OAAO,SAAqB,QAAQ;AAC1C,QAAM,UAAU,MAAM,WAAW,OAAO,KAAK,YAAY,WAAW,KAAK,UAAU,CAAC;AACpF,QAAM,OAAmB,EAAE,SAAS,GAAG,QAAQ;AAE/C,MAAI,CAAC,MAAM;AACT,mBAAe,UAAU,IAAI;AAAA,EAC/B;AACA,SAAO;AACT;AAEO,SAAS,eAAe,UAAkB,MAAwB;AACvE,YAAU,UAAU,IAAI;AAC1B;AAEO,SAAS,eAAe,MAAkB,IAAY,WAAwB,CAAC,GAAgB;AACpG,QAAM,QAAQ,KAAK,QAAQ,EAAE;AAC7B,SAAO,SAAS,OAAO,UAAU,WAAW,QAAQ;AACtD;AAEO,SAAS,UAAU,MAAkB,IAAY,eAAwB,OAAgB;AAC9F,SAAO,eAAe,MAAM,EAAE,EAAE,WAAW;AAC7C;AAEO,SAAS,kBACd,MACA,IACA,OACa;AACb,QAAM,MAAM,KAAK,IAAI;AACrB,QAAM,WAAW,eAAe,MAAM,EAAE;AACxC,OAAK,QAAQ,EAAE,IAAI;AAAA,IACjB,GAAG;AAAA,IACH,GAAG;AAAA,IACH,WAAW;AAAA,EACb;AACA,SAAO,KAAK,QAAQ,EAAE;AACxB;",
+  "names": []
+}

package/dist/lib/order-by.d.ts

@@ -0,0 +1,17 @@
+/**
+ * order-by.ts — 规范化 QueryOptions.orderBy(DRY + LSP)
+ *
+ * SDK 权威形态是 `{ field, dir? }`(见 @sfmc-bds/sdk/db OrderBy);
+ * tx-runner 早期用过 `{ col, dir? }`。两端必须互通,否则
+ * `ORDER BY "undefined"` / `orderBy bad column` 静默炸。
+ */
+export type NormalizedOrder = {
+    col: string;
+    dir: "asc" | "desc";
+};
+/**
+ * 把 SDK `field` / 遗留 `col`、单值 / 数组 统一成 `{col,dir}[]`。
+ * @throws 缺列名或类型非法时
+ */
+export declare function normalizeOrderBy(orderBy: unknown): NormalizedOrder[];
+//# sourceMappingURL=order-by.d.ts.map

package/dist/lib/order-by.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-by.d.ts","sourceRoot":"","sources":["../../src/lib/order-by.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,eAAe,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,CAAC;AAEnE;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,EAAE,CAmBpE"}

package/dist/lib/order-by.js

@@ -0,0 +1,24 @@
+function normalizeOrderBy(orderBy) {
+  if (orderBy == null) return [];
+  const list = Array.isArray(orderBy) ? orderBy : [orderBy];
+  const out = [];
+  for (const item of list) {
+    if (item == null || typeof item !== "object") {
+      throw new Error("[tx] orderBy \u9879\u5FC5\u987B\u662F\u5BF9\u8C61");
+    }
+    const rec = item;
+    const col = rec.col ?? rec.field;
+    if (typeof col !== "string" || !col) {
+      throw new Error("[tx] orderBy \u7F3A\u5C11 field/col");
+    }
+    out.push({
+      col,
+      dir: rec.dir === "desc" ? "desc" : "asc"
+    });
+  }
+  return out;
+}
+export {
+  normalizeOrderBy
+};
+//# sourceMappingURL=order-by.js.map

package/dist/lib/order-by.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/order-by.ts"],
+  "sourcesContent": ["/**\n * order-by.ts \u2014 \u89C4\u8303\u5316 QueryOptions.orderBy(DRY + LSP)\n *\n * SDK \u6743\u5A01\u5F62\u6001\u662F `{ field, dir? }`(\u89C1 @sfmc-bds/sdk/db OrderBy);\n * tx-runner \u65E9\u671F\u7528\u8FC7 `{ col, dir? }`\u3002\u4E24\u7AEF\u5FC5\u987B\u4E92\u901A,\u5426\u5219\n * `ORDER BY \"undefined\"` / `orderBy bad column` \u9759\u9ED8\u70B8\u3002\n */\n\nexport type NormalizedOrder = { col: string; dir: \"asc\" | \"desc\" };\n\n/**\n * \u628A SDK `field` / \u9057\u7559 `col`\u3001\u5355\u503C / \u6570\u7EC4 \u7EDF\u4E00\u6210 `{col,dir}[]`\u3002\n * @throws \u7F3A\u5217\u540D\u6216\u7C7B\u578B\u975E\u6CD5\u65F6\n */\nexport function normalizeOrderBy(orderBy: unknown): NormalizedOrder[] {\n  if (orderBy == null) return [];\n  const list = Array.isArray(orderBy) ? orderBy : [orderBy];\n  const out: NormalizedOrder[] = [];\n  for (const item of list) {\n    if (item == null || typeof item !== \"object\") {\n      throw new Error(\"[tx] orderBy \u9879\u5FC5\u987B\u662F\u5BF9\u8C61\");\n    }\n    const rec = item as Record<string, unknown>;\n    const col = rec.col ?? rec.field;\n    if (typeof col !== \"string\" || !col) {\n      throw new Error(\"[tx] orderBy \u7F3A\u5C11 field/col\");\n    }\n    out.push({\n      col,\n      dir: rec.dir === \"desc\" ? \"desc\" : \"asc\",\n    });\n  }\n  return out;\n}\n"],
+  "mappings": "AAcO,SAAS,iBAAiB,SAAqC;AACpE,MAAI,WAAW,KAAM,QAAO,CAAC;AAC7B,QAAM,OAAO,MAAM,QAAQ,OAAO,IAAI,UAAU,CAAC,OAAO;AACxD,QAAM,MAAyB,CAAC;AAChC,aAAW,QAAQ,MAAM;AACvB,QAAI,QAAQ,QAAQ,OAAO,SAAS,UAAU;AAC5C,YAAM,IAAI,MAAM,mDAAqB;AAAA,IACvC;AACA,UAAM,MAAM;AACZ,UAAM,MAAM,IAAI,OAAO,IAAI;AAC3B,QAAI,OAAO,QAAQ,YAAY,CAAC,KAAK;AACnC,YAAM,IAAI,MAAM,qCAA2B;AAAA,IAC7C;AACA,QAAI,KAAK;AAAA,MACP;AAAA,MACA,KAAK,IAAI,QAAQ,SAAS,SAAS;AAAA,IACrC,CAAC;AAAA,EACH;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/lib/runtime.js

@@ -1,34 +1,19 @@
-/**
- * 解析 Node.js 版本字符串，提取主版本号、次版本号和补丁号。
- * @param version - 版本字符串（可选），例如 "v14.17.0" 或 "14.17.0"。默认为 process.versions.node。
- * @returns 包含 major, minor, patch 的对象，若格式无效则返回 null。
- */
 import { log } from "./log.js";
-export function parseNodeVersion(version = process.versions.node) {
-    const match = String(version).match(/^v?(\d+)\.(\d+)\.(\d+)/);
-    return match ? { major: Number(match[1]), minor: Number(match[2]), patch: Number(match[3]) } : null;
+function parseNodeVersion(version = process.versions.node) {
+  const match = String(version).match(/^v?(\d+)\.(\d+)\.(\d+)/);
+  return match ? { major: Number(match[1]), minor: Number(match[2]), patch: Number(match[3]) } : null;
 }
-/**
- * 校验当前 Node.js 版本是否满足最低要求。
- *
- * 默认下限 22.13 —— `node:sqlite`（db-server 的核心依赖）在 22.5.0–22.12.x
- * 仍需 `--experimental-sqlite` CLI 参数才能加载，未带参数时会在 import 阶段
- * 直接抛出 `ERR_UNKNOWN_BUILTIN_MODULE`；该模块从 22.13.0 起默认可用（仍标记为
- * experimental）。注意：由于 ESM 静态 import 会在本文件被调用之前完成解析，
- * 这里的检查无法拦截 `./lib/sqlite.ts` 自身的 import 崩溃，只能作为其余场景
- * 的兜底防线与版本要求的单一事实来源。
- *
- * @param {number} [minMajor=22]
- * @param {number} [minMinor=13]
- * @return {*}  {boolean}
- */
-export function assertNodeVersion(minMajor = 22, minMinor = 13) {
-    const actual = parseNodeVersion();
-    if (!actual || actual.major < minMajor || (actual.major === minMajor && actual.minor < minMinor)) {
-        log.error(`[Runtime] Node.js ${minMajor}.${minMinor}+ is required; found ${process.versions.node}`);
-        process.exitCode = 2;
-        return false;
-    }
-    return true;
+function assertNodeVersion(minMajor = 22, minMinor = 13) {
+  const actual = parseNodeVersion();
+  if (!actual || actual.major < minMajor || actual.major === minMajor && actual.minor < minMinor) {
+    log.error(`[Runtime] Node.js ${minMajor}.${minMinor}+ is required; found ${process.versions.node}`);
+    process.exitCode = 2;
+    return false;
+  }
+  return true;
 }
-//# sourceMappingURL=runtime.js.map
+export {
+  assertNodeVersion,
+  parseNodeVersion
+};
+//# sourceMappingURL=runtime.js.map

package/dist/lib/runtime.js.map

@@ -1 +1,7 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/lib/runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,MAAM,UAAU,gBAAgB,CAAC,UAAkB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAKtE,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC9D,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACtG,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAmB,EAAE,EAAE,WAAmB,EAAE;IAC5E,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,GAAG,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC,EAAE,CAAC;QACjG,GAAG,CAAC,KAAK,CAAC,qBAAqB,QAAQ,IAAI,QAAQ,wBAAwB,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACpG,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{
+  "version": 3,
+  "sources": ["../../src/lib/runtime.ts"],
+  "sourcesContent": ["/**\n * \u89E3\u6790 Node.js \u7248\u672C\u5B57\u7B26\u4E32\uFF0C\u63D0\u53D6\u4E3B\u7248\u672C\u53F7\u3001\u6B21\u7248\u672C\u53F7\u548C\u8865\u4E01\u53F7\u3002\n * @param version - \u7248\u672C\u5B57\u7B26\u4E32\uFF08\u53EF\u9009\uFF09\uFF0C\u4F8B\u5982 \"v14.17.0\" \u6216 \"14.17.0\"\u3002\u9ED8\u8BA4\u4E3A process.versions.node\u3002\n * @returns \u5305\u542B major, minor, patch \u7684\u5BF9\u8C61\uFF0C\u82E5\u683C\u5F0F\u65E0\u6548\u5219\u8FD4\u56DE null\u3002\n */\nimport { log } from \"./log.js\";\n\nexport function parseNodeVersion(version: string = process.versions.node): {\n  major: number;\n  minor: number;\n  patch: number;\n} | null {\n  const match = String(version).match(/^v?(\\d+)\\.(\\d+)\\.(\\d+)/);\n  return match ? { major: Number(match[1]), minor: Number(match[2]), patch: Number(match[3]) } : null;\n}\n\n/**\n * \u6821\u9A8C\u5F53\u524D Node.js \u7248\u672C\u662F\u5426\u6EE1\u8DB3\u6700\u4F4E\u8981\u6C42\u3002\n *\n * \u9ED8\u8BA4\u4E0B\u9650 22.13 \u2014\u2014 `node:sqlite`\uFF08db-server \u7684\u6838\u5FC3\u4F9D\u8D56\uFF09\u5728 22.5.0\u201322.12.x\n * \u4ECD\u9700 `--experimental-sqlite` CLI \u53C2\u6570\u624D\u80FD\u52A0\u8F7D\uFF0C\u672A\u5E26\u53C2\u6570\u65F6\u4F1A\u5728 import \u9636\u6BB5\n * \u76F4\u63A5\u629B\u51FA `ERR_UNKNOWN_BUILTIN_MODULE`\uFF1B\u8BE5\u6A21\u5757\u4ECE 22.13.0 \u8D77\u9ED8\u8BA4\u53EF\u7528\uFF08\u4ECD\u6807\u8BB0\u4E3A\n * experimental\uFF09\u3002\u6CE8\u610F\uFF1A\u7531\u4E8E ESM \u9759\u6001 import \u4F1A\u5728\u672C\u6587\u4EF6\u88AB\u8C03\u7528\u4E4B\u524D\u5B8C\u6210\u89E3\u6790\uFF0C\n * \u8FD9\u91CC\u7684\u68C0\u67E5\u65E0\u6CD5\u62E6\u622A `./lib/sqlite.ts` \u81EA\u8EAB\u7684 import \u5D29\u6E83\uFF0C\u53EA\u80FD\u4F5C\u4E3A\u5176\u4F59\u573A\u666F\n * \u7684\u515C\u5E95\u9632\u7EBF\u4E0E\u7248\u672C\u8981\u6C42\u7684\u5355\u4E00\u4E8B\u5B9E\u6765\u6E90\u3002\n *\n * @param {number} [minMajor=22]\n * @param {number} [minMinor=13]\n * @return {*}  {boolean}\n */\nexport function assertNodeVersion(minMajor: number = 22, minMinor: number = 13): boolean {\n  const actual = parseNodeVersion();\n  if (!actual || actual.major < minMajor || (actual.major === minMajor && actual.minor < minMinor)) {\n    log.error(`[Runtime] Node.js ${minMajor}.${minMinor}+ is required; found ${process.versions.node}`);\n    process.exitCode = 2;\n    return false;\n  }\n  return true;\n}\n"],
+  "mappings": "AAKA,SAAS,WAAW;AAEb,SAAS,iBAAiB,UAAkB,QAAQ,SAAS,MAI3D;AACP,QAAM,QAAQ,OAAO,OAAO,EAAE,MAAM,wBAAwB;AAC5D,SAAO,QAAQ,EAAE,OAAO,OAAO,MAAM,CAAC,CAAC,GAAG,OAAO,OAAO,MAAM,CAAC,CAAC,GAAG,OAAO,OAAO,MAAM,CAAC,CAAC,EAAE,IAAI;AACjG;AAgBO,SAAS,kBAAkB,WAAmB,IAAI,WAAmB,IAAa;AACvF,QAAM,SAAS,iBAAiB;AAChC,MAAI,CAAC,UAAU,OAAO,QAAQ,YAAa,OAAO,UAAU,YAAY,OAAO,QAAQ,UAAW;AAChG,QAAI,MAAM,qBAAqB,QAAQ,IAAI,QAAQ,wBAAwB,QAAQ,SAAS,IAAI,EAAE;AAClG,YAAQ,WAAW;AACnB,WAAO;AAAA,EACT;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/lib/sql-helpers.js

@@ -1,30 +1,12 @@
-/**
- * lib/sql-helpers.ts — SQL 构造辅助
- *
- * sql-template-strings 会把每一次 ${} 插值都变成 `?` 绑定值。
- * 表名/列名等信任标识符必须嵌入 SQL 文本,不能走绑定 —— 否则会出现
- * `FROM ?` → `near "?": syntax error`(见 economy 域修复)。
- */
 import { SQL } from "sql-template-strings";
-/**
- * 构造「标识符已嵌入、值走 ?」的查询。
- * 表名等信任常量用模板字符串嵌入;用户输入只放进 values。
- *
- * @example
- *   sql(`SELECT * FROM ${TABLE} WHERE id = ?`, [id])
- */
-export function sql(text, values = []) {
-    return { sql: text, values };
+function sql(text, values = []) {
+  return { sql: text, values };
 }
-/**
- * 把一段静态 SQL 文本包装成 SQLStatement,仅可与 `.append(...)` 合用。
- *
- * 警告(LSP):切勿写成 `SQL\`... FROM ${raw(table)} ...\`` —— 模板插值仍会变成 `?`,
- * 与直接插值表名同病。正确用法:
- *   SQL`SELECT * FROM `.append(raw(TABLE)).append(SQL` WHERE id = ${id}`)
- * 纯字符串 `.append(TABLE)` 效果相同;优先用 {@link sql}。
- */
-export function raw(text) {
-    return SQL([text]);
+function raw(text) {
+  return SQL([text]);
 }
-//# sourceMappingURL=sql-helpers.js.map
+export {
+  raw,
+  sql
+};
+//# sourceMappingURL=sql-helpers.js.map

package/dist/lib/sql-helpers.js.map

@@ -1 +1,7 @@
-{"version":3,"file":"sql-helpers.js","sourceRoot":"","sources":["../../src/lib/sql-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,GAAG,EAAqB,MAAM,sBAAsB,CAAC;AAK9D;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,SAAoB,EAAE;IACtD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,GAAG,CAAC,IAAY;IAC9B,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,CAAiB,CAAC;AACrC,CAAC"}
+{
+  "version": 3,
+  "sources": ["../../src/lib/sql-helpers.ts"],
+  "sourcesContent": ["/**\n * lib/sql-helpers.ts \u2014 SQL \u6784\u9020\u8F85\u52A9\n *\n * sql-template-strings \u4F1A\u628A\u6BCF\u4E00\u6B21 ${} \u63D2\u503C\u90FD\u53D8\u6210 `?` \u7ED1\u5B9A\u503C\u3002\n * \u8868\u540D/\u5217\u540D\u7B49\u4FE1\u4EFB\u6807\u8BC6\u7B26\u5FC5\u987B\u5D4C\u5165 SQL \u6587\u672C,\u4E0D\u80FD\u8D70\u7ED1\u5B9A \u2014\u2014 \u5426\u5219\u4F1A\u51FA\u73B0\n * `FROM ?` \u2192 `near \"?\": syntax error`(\u89C1 economy \u57DF\u4FEE\u590D)\u3002\n */\n\nimport { SQL, type SQLStatement } from \"sql-template-strings\";\n\n/** \u53C2\u6570\u5316\u67E5\u8BE2\u4FE1\u5C01,\u4E0E createQuery / AnyQuery \u7684\u683C\u5F0F 2 \u5BF9\u9F50 */\nexport type BoundSql = { sql: string; values: unknown[] };\n\n/**\n * \u6784\u9020\u300C\u6807\u8BC6\u7B26\u5DF2\u5D4C\u5165\u3001\u503C\u8D70 ?\u300D\u7684\u67E5\u8BE2\u3002\n * \u8868\u540D\u7B49\u4FE1\u4EFB\u5E38\u91CF\u7528\u6A21\u677F\u5B57\u7B26\u4E32\u5D4C\u5165;\u7528\u6237\u8F93\u5165\u53EA\u653E\u8FDB values\u3002\n *\n * @example\n *   sql(`SELECT * FROM ${TABLE} WHERE id = ?`, [id])\n */\nexport function sql(text: string, values: unknown[] = []): BoundSql {\n  return { sql: text, values };\n}\n\n/**\n * \u628A\u4E00\u6BB5\u9759\u6001 SQL \u6587\u672C\u5305\u88C5\u6210 SQLStatement,\u4EC5\u53EF\u4E0E `.append(...)` \u5408\u7528\u3002\n *\n * \u8B66\u544A(LSP):\u5207\u52FF\u5199\u6210 `SQL\\`... FROM ${raw(table)} ...\\`` \u2014\u2014 \u6A21\u677F\u63D2\u503C\u4ECD\u4F1A\u53D8\u6210 `?`,\n * \u4E0E\u76F4\u63A5\u63D2\u503C\u8868\u540D\u540C\u75C5\u3002\u6B63\u786E\u7528\u6CD5:\n *   SQL`SELECT * FROM `.append(raw(TABLE)).append(SQL` WHERE id = ${id}`)\n * \u7EAF\u5B57\u7B26\u4E32 `.append(TABLE)` \u6548\u679C\u76F8\u540C;\u4F18\u5148\u7528 {@link sql}\u3002\n */\nexport function raw(text: string): SQLStatement {\n  return SQL([text]) as SQLStatement;\n}\n"],
+  "mappings": "AAQA,SAAS,WAA8B;AAYhC,SAAS,IAAI,MAAc,SAAoB,CAAC,GAAa;AAClE,SAAO,EAAE,KAAK,MAAM,OAAO;AAC7B;AAUO,SAAS,IAAI,MAA4B;AAC9C,SAAO,IAAI,CAAC,IAAI,CAAC;AACnB;",
+  "names": []
+}