@fluxbase/sdk 0.0.1-rc.30 → 0.0.1-rc.31

package/dist/index.cjs

@@ -3961,8 +3961,11 @@ var QueryBuilder = class {
   constructor(fetch2, table) {
     this.selectQuery = "*";
     this.filters = [];
+    this.orFilters = [];
+    this.andFilters = [];
     this.orderBys = [];
     this.singleRow = false;
+    this.maybeSingleRow = false;
     this.fetch = fetch2;
     this.table = table;
   }
@@ -3991,15 +3994,29 @@ var QueryBuilder = class {
     };
   }
   /**
-   * Upsert (insert or update) rows
+   * Upsert (insert or update) rows (Supabase-compatible)
+   * @param data - Row(s) to upsert
+   * @param options - Upsert options (onConflict, ignoreDuplicates, defaultToNull)
    */
-  async upsert(data) {
+  async upsert(data, options) {
     const body = Array.isArray(data) ? data : data;
-    const response = await this.fetch.post(`/api/v1/tables/${this.table}`, body, {
-      headers: {
-        Prefer: "resolution=merge-duplicates"
-      }
-    });
+    const preferValues = [];
+    if (options?.ignoreDuplicates) {
+      preferValues.push("resolution=ignore-duplicates");
+    } else {
+      preferValues.push("resolution=merge-duplicates");
+    }
+    if (options?.defaultToNull) {
+      preferValues.push("missing=default");
+    }
+    const headers = {
+      Prefer: preferValues.join(",")
+    };
+    let path = `/api/v1/tables/${this.table}`;
+    if (options?.onConflict) {
+      path += `?on_conflict=${encodeURIComponent(options.onConflict)}`;
+    }
+    const response = await this.fetch.post(path, body, { headers });
     return {
       data: response,
       error: null,
@@ -4122,6 +4139,71 @@ var QueryBuilder = class {
     this.filters.push({ column, operator: "fts", value: query });
     return this;
   }
+  /**
+   * Negate a filter condition (Supabase-compatible)
+   * @example not('status', 'eq', 'deleted')
+   * @example not('completed_at', 'is', null)
+   */
+  not(column, operator, value) {
+    this.filters.push({ column, operator: "not", value: `${operator}.${this.formatValue(value)}` });
+    return this;
+  }
+  /**
+   * Apply OR logic to filters (Supabase-compatible)
+   * @example or('status.eq.active,status.eq.pending')
+   * @example or('id.eq.2,name.eq.Han')
+   */
+  or(filters) {
+    this.orFilters.push(filters);
+    return this;
+  }
+  /**
+   * Apply AND logic to filters (Supabase-compatible)
+   * Groups multiple conditions that must all be true
+   * @example and('status.eq.active,verified.eq.true')
+   * @example and('age.gte.18,age.lte.65')
+   */
+  and(filters) {
+    this.andFilters.push(filters);
+    return this;
+  }
+  /**
+   * Match multiple columns with exact values (Supabase-compatible)
+   * Shorthand for multiple .eq() calls
+   * @example match({ id: 1, status: 'active', role: 'admin' })
+   */
+  match(conditions) {
+    for (const [column, value] of Object.entries(conditions)) {
+      this.eq(column, value);
+    }
+    return this;
+  }
+  /**
+   * Generic filter method using PostgREST syntax (Supabase-compatible)
+   * @example filter('name', 'in', '("Han","Yoda")')
+   * @example filter('age', 'gte', '18')
+   */
+  filter(column, operator, value) {
+    this.filters.push({ column, operator, value });
+    return this;
+  }
+  /**
+   * Check if column is contained by value (Supabase-compatible)
+   * For arrays and JSONB
+   * @example containedBy('tags', '["news","update"]')
+   */
+  containedBy(column, value) {
+    this.filters.push({ column, operator: "cd", value });
+    return this;
+  }
+  /**
+   * Check if arrays have common elements (Supabase-compatible)
+   * @example overlaps('tags', '["news","sports"]')
+   */
+  overlaps(column, value) {
+    this.filters.push({ column, operator: "ov", value });
+    return this;
+  }
   /**
    * Order results
    */
@@ -4149,12 +4231,32 @@ var QueryBuilder = class {
   }
   /**
    * Return a single row (adds limit(1))
+   * Errors if no rows found
    */
   single() {
     this.singleRow = true;
     this.limitValue = 1;
     return this;
   }
+  /**
+   * Return a single row or null (adds limit(1))
+   * Does not error if no rows found (Supabase-compatible)
+   * @example
+   * ```typescript
+   * // Returns null instead of erroring when no row exists
+   * const { data, error } = await client
+   *   .from('users')
+   *   .select('*')
+   *   .eq('id', 999)
+   *   .maybeSingle()
+   * // data will be null if no row found
+   * ```
+   */
+  maybeSingle() {
+    this.maybeSingleRow = true;
+    this.limitValue = 1;
+    return this;
+  }
   /**
    * Range selection (pagination)
    */
@@ -4422,6 +4524,25 @@ var QueryBuilder = class {
           statusText: "OK"
         };
       }
+      if (this.maybeSingleRow) {
+        if (Array.isArray(data) && data.length === 0) {
+          return {
+            data: null,
+            error: null,
+            count: 0,
+            status: 200,
+            statusText: "OK"
+          };
+        }
+        const singleData = Array.isArray(data) ? data[0] : data;
+        return {
+          data: singleData,
+          error: null,
+          count: 1,
+          status: 200,
+          statusText: "OK"
+        };
+      }
       return {
         data,
         error: null,
@@ -4443,6 +4564,37 @@ var QueryBuilder = class {
       };
     }
   }
+  /**
+   * Execute the query and throw an error if one occurs (Supabase-compatible)
+   * Returns the data directly instead of { data, error } wrapper
+   *
+   * @throws {Error} If the query fails or returns an error
+   * @example
+   * ```typescript
+   * // Throws error instead of returning { data, error }
+   * try {
+   *   const user = await client
+   *     .from('users')
+   *     .select('*')
+   *     .eq('id', 1)
+   *     .single()
+   *     .throwOnError()
+   * } catch (error) {
+   *   console.error('Query failed:', error)
+   * }
+   * ```
+   */
+  async throwOnError() {
+    const response = await this.execute();
+    if (response.error) {
+      const error = new Error(response.error.message);
+      if (response.error.code) {
+        error.code = response.error.code;
+      }
+      throw error;
+    }
+    return response.data;
+  }
   /**
    * Make QueryBuilder awaitable (implements PromiseLike)
    * This allows using `await client.from('table').select()` without calling `.execute()`
@@ -4470,6 +4622,12 @@ var QueryBuilder = class {
     for (const filter of this.filters) {
       params.append(filter.column, `${filter.operator}.${this.formatValue(filter.value)}`);
     }
+    for (const orFilter of this.orFilters) {
+      params.append("or", `(${orFilter})`);
+    }
+    for (const andFilter of this.andFilters) {
+      params.append("and", `(${andFilter})`);
+    }
     if (this.groupByColumns && this.groupByColumns.length > 0) {
       params.append("group_by", this.groupByColumns.join(","));
     }