web-dc-api 0.1.5 → 0.1.6

package/lib/serverless/babel-browser.ts

@@ -1,39 +0,0 @@
-export async function loadBabel() {
-  if (!(globalThis as any).process) {
-    (globalThis as any).process = { env: {} };
-  }
-
-  const [parserMod, typesMod, traverseMod] = await Promise.all([
-    import("@babel/parser"),
-    import("@babel/types"),
-    import("@babel/traverse"),
-  ]);
-
-  // 规范化 parser.parse（兼容多种打包形态）
-  const parse =
-    (parserMod as any).parse ??
-    (parserMod as any).default?.parse ??
-    (parserMod as any).default; // 有些打包器把默认导出直接设为 parse
-
-  if (typeof parse !== "function") {
-    console.error("parserMod keys:", Object.keys(parserMod));
-    throw new Error("Failed to resolve @babel/parser.parse as a function");
-  }
-
-  // types：有的环境在 default 下
-  const t = (typesMod as any).default ?? typesMod;
-
-  // 规范化 traverse
-  const traverse: (node: any, visitors: any) => void =
-    (traverseMod as any).default?.default ??
-    (traverseMod as any).default ??
-    (traverseMod as any).traverse ??
-    (traverseMod as any);
-
-  if (typeof traverse !== "function") {
-    console.error("traverseMod keys:", Object.keys(traverseMod));
-    throw new Error("Failed to resolve @babel/traverse as a function");
-  }
-
-  return { parse, t, traverse };
-}

package/lib/serverless/base_entity.ts

@@ -1,78 +0,0 @@
-// 领域模型基类：不包含任何存储逻辑
-export abstract class BaseEntity {
-  // 默认元字段
-  public dc_timestamp?: number;  // 毫秒时间戳
-  public dc_opuser?: string;    // 操作人
-
-  constructor() {
-    // 时间戳,opuser 留空，主要用于从dc取回数据时填充
-   
-  }
-
-  // 可重写以自定义主键策略
-  protected getPrimaryKey(): string {
-    const anySelf = this as any;
-    const id = anySelf.id ?? anySelf.key ?? anySelf.pk;
-
-    // 仅判 null/undefined，为 0 的数字是合法主键
-    if (id === null || id === undefined) {
-      throw new Error(`${this.constructor.name}: primary key (id/key/pk) is required`);
-    }
-
-    if (typeof id === 'string') {
-      const s = id.trim();
-      if (s.length === 0) {
-        throw new Error(`${this.constructor.name}: primary key (string) cannot be empty`);
-      }
-      return s;
-    }
-
-    if (typeof id === 'number') {
-      if (Number.isNaN(id)) {
-        throw new Error(`${this.constructor.name}: primary key (number) cannot be NaN`);
-      }
-      return String(id);
-    }
-
-    if (typeof id === 'bigint') {
-      return id.toString();
-    }
-
-    // 其它类型统一转字符串（如需自定义请在子类中重写）
-    return String(id);
-  }
-
-  // 标记更新时间与操作人
-  touch(opuser?: string, timeMs: number = Date.now()): this {
-    this.dc_timestamp = timeMs;
-    if (opuser !== undefined) this.dc_opuser = opuser;
-    return this;
-  }
-
-  // 设置操作人
-  setOpUser(opuser: string): this {
-    this.dc_opuser = opuser;
-    return this;
-  }
-
-  // 可选：领域校验（子类覆盖）
-  validate(): void {
-    // no-op by default
-  }
-
-  // 工厂：从 PlainObject 创建实体
-  static from<T extends BaseEntity>(this: new () => T, data: Partial<T>): T {
-    const inst = new this();
-    Object.assign(inst, data);
-    return inst;
-  }
-
-  // 导出为可序列化对象（可覆写以裁剪敏感字段）
-  toJSON(): Record<string, unknown> {
-    const out: Record<string, unknown> = {};
-    for (const k of Object.keys(this as any)) {
-      (out as any)[k] = (this as any)[k];
-    }
-    return out;
-  }
-}

package/lib/serverless/base_repository.ts

@@ -1,414 +0,0 @@
-import { Direction } from "../common/define";
-import type { IKeyValueOperations } from "../interfaces/keyvalue-interface";
-import type { KeyValueDB } from "../implements/keyvalue/manager";
-import { metadata } from "./decorator_factory";
-import { BaseEntity } from "./base_entity";
-
-type Ctor<T> = new (...args: any[]) => T;
-
-const EXTRA_SEP = "$$$dckv_extra$$$";
-
-function extractRawValue(s: string): [string, string]  {
-  const i = s.indexOf(EXTRA_SEP);
-  return i >= 0 ? [s.slice(0, i), s.slice(i + EXTRA_SEP.length)] : [s, ""];
-}
-
-function safeParseJSON<T>(s: string | null): T | null {
-  if (!s) return null;
-  try { return JSON.parse(s) as T; } catch { return null; }
-}
-
-
-
-
-// 兼容 getWithIndex 返回的两种格式（string[] 或 Record<string,string>[]）
-function parseIndexResultValues(raw: string): string[] {
-  const parsed = safeParseJSON<any>(raw);
-  if (!Array.isArray(parsed)) return [];
-  const out: string[] = [];
-  for (const item of parsed) {
-    if (typeof item === "string") {
-      out.push(item);
-    } else if (item && typeof item === "object") {
-      for (const v of Object.values(item)) {
-        if (v != null) out.push(String(v));
-      }
-    }
-  }
-  return out;
-}
-
-function maybeStripKeyPrefix(s: string): string {
-  const t = s.trimStart();
-  const i = t.indexOf(":");
-  if (i > 0 && i < 64 && t[0] !== "{" && t[0] !== "[" && t[0] !== "\"") {
-    return t.slice(i + 1).trim();
-  }
-  return s;
-}
-
-
-
-// 将列声明类型与实际值映射到 KV 可识别的索引类型和值
-function asIndexTypeAndValue(value: unknown, declaredType?: string): { type: string; value: string } {
-  const t = declaredType ?? (value instanceof Date ? "date" : typeof value);
-  switch (t) {
-    case "date":
-      return { type: "number", value: String(value instanceof Date ? value.getTime() : Number(value)) };
-    case "boolean":
-      return { type: "number", value: String(value ? 1 : 0) };
-    case "number":
-      return { type: "number", value: String(value ?? 0) };
-    case "json":
-      return { type: "json", value: JSON.stringify(value) };
-    default:
-      return { type: "string", value: String(value ?? "") };
-  }
-}
-
-function buildIndexPayload(entity: object, ctor: Function): string {
-  const cols = metadata.getColumns(ctor);
-  const colTypeByName = new Map<string, string>();
-  cols.forEach(c => {
-    if (c.options?.type) colTypeByName.set(c.resolvedName, c.options.type);
-  });
-
-  const idxMetas = metadata.getIndexes(ctor);
-  const items: Array<{ key: string; type: string; value: string }> = [];
-
-    for (const idx of idxMetas) {
-    if (!idx.fields.length) continue;
-
-    if (idx.fields.length === 1) {
-      const [first] = idx.fields;
-      if (!first) continue;
-      const f = first.field;
-      const raw = (entity as any)[f];
-      const { type, value } = asIndexTypeAndValue(raw, colTypeByName.get(f));
-      // 单列索引用字段名作为索引键
-      items.push({ key: f, type, value });
-    } else {
-      // 复合索引：索引名作为 key，值为字段值数组的 JSON，类型 json
-      const key = idx.name;
-      const tuple = idx.fields.map(ff => (entity as any)[ff.field]);
-      items.push({ key, type: "json", value: JSON.stringify(tuple) });
-    }
-  }
-
-  return JSON.stringify(items);
-}
-
-export function composeCompositeIndexValue(values: unknown[]): string {
-  // 用于复合索引查询：indexValue 需为 JSON 数组字符串
-  return JSON.stringify(values);
-}
-
-export type FindIndexOptions = {
-  type?: "string" | "number" | "boolean" | "date" | "json" | "binary";
-  limit?: number;
-  seekKey?: string;
-  direction?: Direction; //Direction.Forward(升序) | Direction.Reverse(降序);
-  offset?: number;
-  vaccount?: string;
-};
-
-export type FindValuesOptions = {
-  limit?: number;
-  seekKey?: string;
-  direction?: Direction;//Direction.Forward(升序) | Direction.Reverse(降序);
-  offset?: number;
-  vaccount?: string;
-};
-
-type Operator = "=" | ">" | "<" | ">=" | "<=" | "!=";
-
-interface WhereCond {
-  field: string;
-  operator: Operator;
-  value: any;
-}
-
-function toIndexQuery(
-  cond: WhereCond
-): { indexKey: string; indexValue: string; options: FindIndexOptions; fullScan?: boolean } {
-  const { field, operator, value } = cond;
-  let direction: Direction | undefined;
-  let seekKey: string | undefined;
-  let limit: number | undefined;
-
-  switch (operator) {
-    case "=":
-      return {
-        indexKey: field,
-        indexValue: String(value),
-        options: {}
-      };
-    case ">":
-      direction = Direction.Forward;
-      seekKey = String(value);
-      limit = 1000;
-      break;
-    case ">=":
-      direction = Direction.Forward;
-      seekKey = String(value);
-      limit = 1000;
-      break;
-    case "<":
-      direction = Direction.Reverse;
-      seekKey = String(value);
-      limit = 1000;
-      break;
-    case "<=":
-      direction = Direction.Reverse;
-      seekKey = String(value);
-      limit = 1000;
-      break;
-    case "!=":
-      // 需要全量拉取
-      return {
-        indexKey: "",
-        indexValue: "",
-        options: {},
-        fullScan: true
-      };
-    default:
-      throw new Error("不支持的操作符: " + operator);
-  }
-
-  return {
-    indexKey: field,
-    indexValue: "",
-    options: {
-      direction,
-      seekKey,
-      limit
-    }
-  };
-}
-// 支持 "field>=value" 这种字符串解析
-function parseWhereString(whereStr: string): { field: string, operator: Operator, value: any } {
-  // 支持 >=, <=, >, <, =, !=
-  const m = whereStr.match(/^(\w+)\s*(>=|<=|=|>|<|!=)\s*(.+)$/);
-  if (!m) throw new Error("不支持的查询字符串格式: " + whereStr);
-  // 明确断言为 string，保证类型安全
-  const field = m[1] as string;
-  const operator = m[2] as Operator;
-  const value = m[3] as string;
-  return { field, operator, value };
-}
-
-
-function sanitizeGetWithIndexOptions(options: FindIndexOptions): { type?: string; limit?: number; seekKey?: string; direction?: Direction; offset?: number } {
-  return {
-    ...(options.type !== undefined ? { type: options.type } : {}),
-    ...(options.limit !== undefined ? { limit: options.limit } : {}),
-    ...(options.seekKey !== undefined ? { seekKey: options.seekKey } : {}),
-    ...(options.direction !== undefined ? { direction: options.direction } : {}),
-    ...(options.offset !== undefined ? { offset: options.offset } : {}),
-  };
-}
-
-function sanitizeGetValuesOptions(options: FindValuesOptions): { limit?: number; seekKey?: string; direction?: Direction; offset?: number } {
-  return {
-    ...(options.limit !== undefined ? { limit: options.limit } : {}),
-    ...(options.seekKey !== undefined ? { seekKey: options.seekKey } : {}),
-    ...(options.direction !== undefined ? { direction: options.direction } : {}),
-    ...(options.offset !== undefined ? { offset: options.offset } : {}),
-  };
-}
-
-
-
-// 通用仓储：承载所有持久化与查询逻辑
-export class EntityRepository<T extends BaseEntity> {
-  constructor(
-    private readonly entityCtor: Ctor<T>,
-    private readonly ops: IKeyValueOperations,
-    private readonly db: KeyValueDB
-  ) {}
-
-  // 保存实体（写入并附带索引）
-  async save(entity: T, vaccount?: string): Promise<number> {
-    entity.validate();
-    const key= (entity as any).getPrimaryKey();
-    //移除dc_timestamp和dc_opuser字段，由dc节点自动维护
-    delete (entity as any).dc_timestamp;
-    delete (entity as any).dc_opuser;
-    const value = JSON.stringify(entity.toJSON());
-    const indexs = buildIndexPayload(entity, this.entityCtor);
-
-    const [ok,resTimestamp, err] = await this.ops.set(this.db, key, value, indexs, vaccount);
-    if (err) throw err;
-    if (!ok) throw new Error(`${this.entityCtor.name}.save failed`);
-    entity.dc_timestamp = resTimestamp ? resTimestamp : 0; // 设置时间戳
-    return entity.dc_timestamp;
-  }
-
-
-  async deleteById(id: string, vaccount?: string): Promise<void> {
-    const key = id;
-    const [ok,_ ,err] = await this.ops.set(this.db, key, "","", vaccount); // 空值用于标记删除
-    if (err) throw err;
-    if (!ok) throw new Error(`${this.entityCtor.name}.deleteById failed`);
-  }
-
-  // 局部更新（按 id 合并字段后保存）
-  async update(id: string, patch: Partial<T>, vaccount?: string): Promise<T | null> {
-    const key = id; 
-     const [curr, err] = await this.ops.getValueSetByCurrentUser(this.db, key, vaccount);
-    if (err || !curr) return null;
-    const [json, extra] = extractRawValue(curr);
-    const obj = safeParseJSON<any>(json);
-    if (!obj) return null;
-    if (extra) {
-        const extraObj = safeParseJSON<any>(extra);
-        if (extraObj) Object.assign(obj, extraObj);
-    }   
-    const inst = new this.entityCtor();
-    Object.assign(inst, obj);
-    Object.assign(inst as any, patch);
-    const resTimestamp = await this.save(inst, vaccount);
-    inst.dc_timestamp = resTimestamp;
-    return inst;
-  }
-
-
-
-  async query(
-    where: WhereCond | string,
-    options: FindIndexOptions = {}
-  ): Promise<T[]> {
-    let cond: WhereCond;
-    if (typeof where === "string") {
-      cond = parseWhereString(where);
-    } else {
-      cond = where;
-    }
-
-    const { indexKey, indexValue, options: indexOptions, fullScan } = toIndexQuery(cond);
-    const mergedOptions = { ...indexOptions, ...options };
-
-    let list: T[];
-    if (fullScan) {
-      // 全量拉取
-      list = await this.find();
-    } else {
-      list = await this.findByIndex(indexKey, indexValue, mergedOptions);
-    }
-
-    const { field, operator, value } = cond;
-    const filtered = list.filter(obj => {
-      const v = (obj as any)[field];
-      switch (operator) {
-        case "=": return v == value;
-        case "!=": return v != value;
-        case ">": return v > value;
-        case "<": return v < value;
-        case ">=": return v >= value;
-        case "<=": return v <= value;
-        default: return false;
-      }
-    });
-
-    return filtered;
-  }
-
-   // 获取
-  async find( options: FindIndexOptions = {}): Promise<T[]> {
-    return this.getValues("",  options);
-  }
-
-  // 通过 id 获取
-  async findById(id: string, writerPubkey?: string, vaccount?: string): Promise<T | null> {
-    const key = id; 
-    const [raw, err] = await this.ops.get(this.db, key, writerPubkey, vaccount);
-    if (err || !raw) return null;
-
-    const [json, extra] = extractRawValue(raw);
-    const obj = safeParseJSON<any>(json);
-    if (!obj) return null;
-    if (extra) {
-      const extraObj = safeParseJSON<any>(extra);
-      if (extraObj) Object.assign(obj, extraObj);
-    }   
-    
-
-    const inst = new this.entityCtor();
-    Object.assign(inst, obj);
-    return inst;
-  }
-
-
-  
-
-  // 通过索引查询（单字段：indexKey=字段名；复合：indexKey=索引名，indexValue=JSON数组字符串）
-  async findByIndex(indexKey: string, indexValue: string, options: FindIndexOptions = {}): Promise<T[]> {
-    const [raw, err] = await this.ops.getWithIndex(
-      this.db,
-      indexKey,
-      indexValue,
-      sanitizeGetWithIndexOptions(options),
-      options.vaccount
-    );
-    if (err || !raw) return [];
-
-    const values = parseIndexResultValues(raw);
-    const out: T[] = [];
-    for (let val of values) {
-      // 兼容老格式 "key:value"；新格式是纯 value，不会命中
-      val = maybeStripKeyPrefix(val);
-
-      const [json, extra] = extractRawValue(val);
-      const obj = safeParseJSON<any>(json);
-      if (!obj) continue;
-      if (extra) {
-        const extraObj = safeParseJSON<any>(extra);
-        if (extraObj) Object.assign(obj, extraObj);
-      }
-      const inst = new this.entityCtor();
-      Object.assign(inst, obj);
-      out.push(inst);
-    }
-    return out;
-  }
-
-  async findOneByIndex(indexKey: string, indexValue: string, options: Omit<FindIndexOptions, "limit"> = {}): Promise<T | null> {
-    const list = await this.findByIndex(indexKey, indexValue, { ...options, limit: 1 });
-    return list[0] ?? null;
-  }
-
-  // 按键前缀遍历（用于分页场景）
-  async getValues(keyPrefix: string, options: FindValuesOptions = {}): Promise<T[]> {
-    const [raw, err] = await this.ops.getValues(
-      this.db,
-      keyPrefix,
-      sanitizeGetValuesOptions(options),
-      options.vaccount
-    );
-    if (err || !raw) return [];
-
-    const list = safeParseJSON<string[]>(raw) ?? [];
-    const out: T[] = [];
-    for (const item of list) {
-      let itemValue = String(item);
-      if (typeof item !== "string") {
-        //是{key: value}格式,取出value
-        for (const [_, v] of Object.entries(item)) {
-            itemValue = String(v);
-            break;
-        } 
-      }
-      const [v,extra] = extractRawValue(itemValue);
-      const obj = safeParseJSON<any>(v);
-      if (!obj) continue;
-      if (extra) {
-        const extraObj = safeParseJSON<any>(extra);
-        if (extraObj) Object.assign(obj, extraObj);
-      }
-      const inst = new this.entityCtor();
-      Object.assign(inst, obj);
-      out.push(inst);
-    }
-    return out;
-  }
-}