supabase-typed-query 0.12.0 → 0.13.0

package/README.md

@@ -128,8 +128,47 @@ const selectedPosts = await query(supabase, "posts", {
 const drafts = await query(supabase, "posts", {
   published_at: { is: null },
 }).many()
+
+// IS NOT NULL checks (using NOT operator)
+const publishedPosts = await query(supabase, "posts", {
+  not: { is: { published_at: null } },
+}).many()
+
+// NOT IN queries
+const activePosts = await query(supabase, "posts", {
+  not: { in: { status: ["draft", "archived"] } },
+}).many()
+```
+
+### NOT Operator
+
+The `not` operator follows Supabase conventions for negating conditions:
+
+```typescript
+// IS NOT NULL - find posts with external_id set
+const linkedPosts = await PostEntity.getItems({
+  not: { is: { external_id: null } },
+}).many()
+
+// IS NOT TRUE / IS NOT FALSE
+const nonFeatured = await PostEntity.getItems({
+  not: { is: { featured: true } },
+}).many()
+
+// NOT IN - exclude specific statuses
+const visiblePosts = await PostEntity.getItems({
+  not: { in: { status: ["spam", "trash", "deleted"] } },
+}).many()
+
+// Combine NOT with other conditions
+const activeLinkedPosts = await PostEntity.getItems({
+  where: { status: "published" },
+  not: { is: { external_id: null } },
+}).many()
 ```
 
+> **Note**: `neq: null` is deprecated. Use `not: { is: { field: null } }` instead for IS NOT NULL checks.
+
 ### Chaining OR Conditions
 
 ```typescript

package/dist/index.js

@@ -69,7 +69,7 @@ const QueryBuilder = (client, config) => {
     return finalQuery;
   };
   const applyCondition = (query2, condition) => {
-    const { where, is, wherein, gt, gte, lt, lte, neq, like, ilike } = condition;
+    const { where, is, wherein, gt, gte, lt, lte, neq, like, ilike, not } = condition;
     const processedWhere = {};
     const extractedOperators = {};
     if (where) {
@@ -183,10 +183,18 @@ const QueryBuilder = (client, config) => {
     const queryWithGte = Object.keys(mergedGte).length > 0 ? Object.entries(mergedGte).reduce((q, [key, value]) => q.gte(key, value), queryWithGt) : queryWithGt;
     const queryWithLt = Object.keys(mergedLt).length > 0 ? Object.entries(mergedLt).reduce((q, [key, value]) => q.lt(key, value), queryWithGte) : queryWithGte;
     const queryWithLte = Object.keys(mergedLte).length > 0 ? Object.entries(mergedLte).reduce((q, [key, value]) => q.lte(key, value), queryWithLt) : queryWithLt;
-    const queryWithNeq = Object.keys(mergedNeq).length > 0 ? Object.entries(mergedNeq).reduce((q, [key, value]) => q.neq(key, value), queryWithLte) : queryWithLte;
+    const queryWithNeq = Object.keys(mergedNeq).length > 0 ? Object.entries(mergedNeq).reduce((q, [key, value]) => {
+      if (value === null) {
+        log.warn(`neq: null is deprecated. Use not: { is: { ${key}: null } } for IS NOT NULL`);
+        return q.not(key, "is", null);
+      }
+      return q.neq(key, value);
+    }, queryWithLte) : queryWithLte;
     const queryWithLike = Object.keys(mergedLike).length > 0 ? Object.entries(mergedLike).reduce((q, [key, pattern]) => q.like(key, pattern), queryWithNeq) : queryWithNeq;
     const queryWithIlike = Object.keys(mergedIlike).length > 0 ? Object.entries(mergedIlike).reduce((q, [key, pattern]) => q.ilike(key, pattern), queryWithLike) : queryWithLike;
-    return queryWithIlike;
+    const queryWithNotIs = not?.is ? Object.entries(not.is).reduce((q, [key, value]) => q.not(key, "is", value), queryWithIlike) : queryWithIlike;
+    const queryWithNot = not?.in ? Object.entries(not.in).reduce((q, [key, values]) => q.not(key, "in", values), queryWithNotIs) : queryWithNotIs;
+    return queryWithNot;
   };
   const applyOrConditions = (query2, conditions) => {
     const selectQuery = query2.select("*");
@@ -223,7 +231,8 @@ const QueryBuilder = (client, config) => {
           return {
             where: newWhere,
             is: condition.is,
-            wherein: condition.wherein
+            wherein: condition.wherein,
+            not: condition.not
           };
         })
       );
@@ -287,6 +296,7 @@ const QueryBuilder = (client, config) => {
       if (condition.neq) {
         Object.entries(condition.neq).forEach(([key, value]) => {
           if (value === null) {
+            log.warn(`neq: null is deprecated. Use not: { is: { ${key}: null } } for IS NOT NULL`);
             parts.push(`${key}.not.is.null`);
           } else {
             parts.push(`${key}.neq."${value}"`);
@@ -303,6 +313,25 @@ const QueryBuilder = (client, config) => {
           parts.push(`${key}.ilike."${pattern}"`);
         });
       }
+      if (condition.not) {
+        if (condition.not.is) {
+          Object.entries(condition.not.is).forEach(([key, value]) => {
+            if (value === null) {
+              parts.push(`${key}.not.is.null`);
+            } else {
+              parts.push(`${key}.not.is.${value}`);
+            }
+          });
+        }
+        if (condition.not.in) {
+          Object.entries(condition.not.in).forEach(([key, values]) => {
+            if (values && Array.isArray(values) && values.length > 0) {
+              const valueList = values.map((v) => `"${v}"`).join(",");
+              parts.push(`${key}.not.in.(${valueList})`);
+            }
+          });
+        }
+      }
       return parts.join(",");
     }).filter((condition) => condition.length > 0);
     const finalQuery = orConditions.length > 0 ? queryWithCommon.or(orConditions.join(",")) : queryWithCommon;
@@ -555,10 +584,10 @@ const createMappedQuery = (sourceQuery, mapFn) => {
     }
   };
 };
-const createQuery = (client, table, where = {}, is, wherein, order, softDeleteConfig, schema, comparison) => {
+const createQuery = (client, table, where = {}, is, wherein, order, softDeleteConfig, schema, comparison, not) => {
   const config = {
     table,
-    conditions: [{ where, is, wherein, ...comparison }],
+    conditions: [{ where, is, wherein, ...comparison, not }],
     order,
     softDeleteMode: softDeleteConfig?.mode,
     softDeleteAppliedByDefault: softDeleteConfig?.appliedByDefault,
@@ -868,7 +897,7 @@ function createGetItemQuery(client, name, whereConditions, is, softDeleteMode, s
     schema
   );
 }
-function createGetItemsQuery(client, name, whereConditions, is, wherein, order, softDeleteMode, schema, comparison) {
+function createGetItemsQuery(client, name, whereConditions, is, wherein, order, softDeleteMode, schema, comparison, not) {
   return createQuery(
     client,
     name,
@@ -881,7 +910,8 @@ function createGetItemsQuery(client, name, whereConditions, is, wherein, order,
       appliedByDefault: true
     },
     schema,
-    comparison
+    comparison,
+    not
   );
 }
 function createAddItemsMutation(client, name, items, schema) {
@@ -948,7 +978,8 @@ function makeGetItems(client, name, softDeleteMode, schema) {
     lt,
     neq,
     like,
-    ilike
+    ilike,
+    not
   } = {}) {
     return createGetItemsQuery(
       client,
@@ -959,7 +990,8 @@ function makeGetItems(client, name, softDeleteMode, schema) {
       order,
       softDeleteMode,
       schema,
-      { gte, gt, lte, lt, neq, like, ilike }
+      { gte, gt, lte, lt, neq, like, ilike },
+      not
     );
   };
 }
@@ -977,7 +1009,7 @@ function makePartitionedGetItem(client, name, partitionField, softDeleteMode, sc
   };
 }
 function makePartitionedGetItems(client, name, partitionField, softDeleteMode, schema) {
-  return function getItems(partitionKey, { where, is, wherein, order, gte, gt, lte, lt, neq, like, ilike } = {}) {
+  return function getItems(partitionKey, { where, is, wherein, order, gte, gt, lte, lt, neq, like, ilike, not } = {}) {
     const whereConditions = buildWhereWithPartition(partitionField, partitionKey, where);
     return createGetItemsQuery(
       client,
@@ -988,7 +1020,8 @@ function makePartitionedGetItems(client, name, partitionField, softDeleteMode, s
       order,
       softDeleteMode,
       schema,
-      { gte, gt, lte, lt, neq, like, ilike }
+      { gte, gt, lte, lt, neq, like, ilike },
+      not
     );
   };
 }