@sfutureapps/db-sdk 0.3.26 → 0.3.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sfutureapps/db-sdk",
-  "version": "0.3.26",
+  "version": "0.3.27",
   "description": "SfutureApps JS SDK for ThinkPHP DB Gateway (MySQL)",
   "license": "MIT",
   "type": "module",

package/src/index.d.ts

@@ -25,6 +25,8 @@ export type OrderOptions = {
   ascending?: boolean;
 };
 
+export type JoinType = "INNER" | "LEFT" | "RIGHT" | "FULL" | "CROSS" | (string & {});
+
 export class QueryBuilder<T = any, TSingle extends boolean = false> {
   constructor(table: string);
 
@@ -79,6 +81,9 @@ export class QueryBuilder<T = any, TSingle extends boolean = false> {
   havingLt(col: keyof T | string, val: any): QueryBuilder<T, TSingle>;
   havingNeq(col: keyof T | string, val: any): QueryBuilder<T, TSingle>;
 
+  // ---- join ----
+  join(table: string, on: string, type?: JoinType): QueryBuilder<T, TSingle>;
+
   // ---- execute ----
   execute(): Promise<QueryResponse<TSingle extends true ? T | null : T[]>>;
 

package/src/query-builder.js

@@ -1,4 +1,4 @@
-import post from "./client";
+import post from "./client.js";
 
 export class QueryBuilder {
   constructor(table) {
@@ -18,6 +18,8 @@ export class QueryBuilder {
     this._distinct = false;
     this._group = [];
     this._having = [];
+
+    this._joins = [];
   }
 
   // ---- select ----
@@ -108,12 +110,24 @@ export class QueryBuilder {
   havingLt(col, val) { this._having.push({ col, op: "lt", val }); return this; }
   havingNeq(col, val) { this._having.push({ col, op: "neq", val }); return this; }
 
+  // ---- join ----
+  join(table, on, type = "INNER") {
+    const joinTable = String(table ?? "").trim();
+    const joinOn = String(on ?? "").trim();
+    if (!joinTable || !joinOn) return this;
+
+    const joinType = String(type ?? "INNER").trim().toUpperCase();
+    this._joins.push({ table: joinTable, on: joinOn, type: joinType });
+    return this;
+  }
+
   // ---- execute ----
   async execute() {
     const payload = {
       table: this.tableName,
       select: this._select,
       filters: JSON.stringify(this._filters),
+
       order: this._order,
       limit: this._limit ?? 20,
       count: this._withCount,
@@ -125,6 +139,7 @@ export class QueryBuilder {
 
     if (this._page != null) payload.page = this._page;
     if (this._offset != null) payload.offset = this._offset;
+    if (this._joins.length > 0) payload.joins = this._joins;
 
     const res = await post({ endpoint: "v3/api/query", data: payload });