mongosupa 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 meerkapp
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,69 @@
+# mongosupa
+
+Translate MongoDB query syntax to Supabase JS queries.
+
+## Install
+
+```bash
+npm install mongosupa
+```
+
+Requires `@supabase/supabase-js` as peer dependency.
+
+## Usage
+
+```typescript
+import { createClient } from '@supabase/supabase-js'
+import { mongoToSupabase, createTranslator } from 'mongosupa'
+
+const supabase = createClient(url, key)
+
+const { data } = await mongoToSupabase(supabase, {
+  collection: 'users',
+  filter: { age: { $gte: 18 }, status: 'active' },
+  options: {
+    sort: { createdAt: -1 },
+    limit: 10,
+    select: ['id', 'name', 'email']
+  }
+})
+
+const query = createTranslator(supabase)
+
+const { data: products } = await query({
+  collection: 'products',
+  filter: { price: { $lt: 100 } }
+})
+```
+
+## Supported Operators
+
+| MongoDB | Supabase |
+|---------|----------|
+| `$eq` | `.eq()` |
+| `$ne` | `.neq()` |
+| `$gt` | `.gt()` |
+| `$gte` | `.gte()` |
+| `$lt` | `.lt()` |
+| `$lte` | `.lte()` |
+| `$in` | `.in()` |
+| `$nin` | `.not().in()` |
+| `$regex` | `.ilike()` |
+| `$exists` | `.is(null)` / `.not().is(null)` |
+| `$and` | chained filters |
+| `$or` | `.or()` |
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `collection` | Table name |
+| `filter` | MongoDB-style filter object |
+| `options.sort` | `{ field: -1 }` for desc, `{ field: 1 }` for asc |
+| `options.limit` | Max rows |
+| `options.skip` | Offset |
+| `options.select` | `['field1', 'field2']` or `{ field1: 1, field2: 1 }` |
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1 @@
+'use strict';var u=n=>typeof n!="object"||n===null||Array.isArray(n)?false:Object.keys(n).some(t=>t.startsWith("$")),$=n=>(typeof n=="string"?n:n.source).replace(/^\^/,"").replace(/\$$/,"").replace(/\.\*/g,"%").replace(/\./g,"_"),m=(n,t,o)=>{if(!u(o))return o===null?n.is(t,null):n.eq(t,o);let i=o;for(let[s,e]of Object.entries(i))switch(s){case "$eq":n=e===null?n.is(t,null):n.eq(t,e);break;case "$ne":n=e===null?n.not(t,"is",null):n.neq(t,e);break;case "$gt":n=n.gt(t,e);break;case "$gte":n=n.gte(t,e);break;case "$lt":n=n.lt(t,e);break;case "$lte":n=n.lte(t,e);break;case "$in":Array.isArray(e)&&(n=n.in(t,e));break;case "$nin":Array.isArray(e)&&(n=n.not(t,"in",`(${e.map(r=>typeof r=="string"?`"${r}"`:r).join(",")})`));break;case "$regex":n=n.ilike(t,`%${$(e)}%`);break;case "$exists":n=e?n.not(t,"is",null):n.is(t,null);break}return n},c=(n,t)=>{for(let[o,i]of Object.entries(t)){if(o==="$and"&&Array.isArray(i)){for(let s of i)n=c(n,s);continue}if(o==="$or"&&Array.isArray(i)){let s=i.map(e=>Object.entries(e).map(([r,l])=>u(l)?Object.entries(l).map(([g,a])=>{switch(g){case "$eq":return `${r}.eq.${a}`;case "$ne":return `${r}.neq.${a}`;case "$gt":return `${r}.gt.${a}`;case "$gte":return `${r}.gte.${a}`;case "$lt":return `${r}.lt.${a}`;case "$lte":return `${r}.lte.${a}`;case "$in":return `${r}.in.(${a.join(",")})`;default:return ""}}).filter(Boolean).join(","):l===null?`${r}.is.null`:`${r}.eq.${l}`).join(",")).join(",");n=n.or(s);continue}o.startsWith("$")||(n=m(n,o,i));}return n},p=(n,t)=>{for(let[o,i]of Object.entries(t))n=n.order(o,{ascending:i===1||i==="asc"});return n};function b(n,t){let{collection:o,filter:i,options:s}=t,e=s?.select?n.from(o).select(Array.isArray(s.select)?s.select.join(","):Object.entries(s.select).filter(([,r])=>r===1).map(([r])=>r).join(",")||"*"):n.from(o).select("*");if(i&&Object.keys(i).length>0&&(e=c(e,i)),s?.sort&&(e=p(e,s.sort)),s?.limit!==void 0&&(e=e.limit(s.limit)),s?.skip!==void 0){let r=s.skip,l=s.limit?r+s.limit-1:r+999;e=e.range(r,l);}return e}function B(n){return t=>b(n,t)}function j(n,t){return c(n,t)}exports.createTranslator=B;exports.mongoToSupabase=b;exports.translateFilter=j;

package/dist/index.d.cts

@@ -0,0 +1,44 @@
+import { SupabaseClient as SupabaseClient$1 } from '@supabase/supabase-js';
+
+interface ComparisonOperators {
+    $eq?: unknown;
+    $ne?: unknown;
+    $gt?: unknown;
+    $gte?: unknown;
+    $lt?: unknown;
+    $lte?: unknown;
+    $in?: unknown[];
+    $nin?: unknown[];
+    $regex?: string | RegExp;
+    $exists?: boolean;
+}
+interface LogicalOperators {
+    $and?: MongoFilter[];
+    $or?: MongoFilter[];
+    $not?: MongoFilter;
+    $nor?: MongoFilter[];
+}
+type FieldFilter = unknown | ComparisonOperators;
+type MongoFilter = LogicalOperators & {
+    [field: string]: FieldFilter;
+};
+type SortDirection = 1 | -1 | 'asc' | 'desc';
+type MongoSort = Record<string, SortDirection>;
+interface QueryOptions {
+    sort?: MongoSort;
+    limit?: number;
+    skip?: number;
+    select?: string[] | Record<string, 0 | 1>;
+}
+interface MongoQuery {
+    collection: string;
+    filter?: MongoFilter;
+    options?: QueryOptions;
+}
+
+type SupabaseClient = SupabaseClient$1<any, any, any>;
+declare function mongoToSupabase(client: SupabaseClient, query: MongoQuery): any;
+declare function createTranslator(client: SupabaseClient): (query: MongoQuery) => any;
+declare function translateFilter<T>(query: T, filter: MongoFilter): T;
+
+export { type MongoFilter, type MongoQuery, type QueryOptions, type SupabaseClient, createTranslator, mongoToSupabase, translateFilter };

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+import { SupabaseClient as SupabaseClient$1 } from '@supabase/supabase-js';
+
+interface ComparisonOperators {
+    $eq?: unknown;
+    $ne?: unknown;
+    $gt?: unknown;
+    $gte?: unknown;
+    $lt?: unknown;
+    $lte?: unknown;
+    $in?: unknown[];
+    $nin?: unknown[];
+    $regex?: string | RegExp;
+    $exists?: boolean;
+}
+interface LogicalOperators {
+    $and?: MongoFilter[];
+    $or?: MongoFilter[];
+    $not?: MongoFilter;
+    $nor?: MongoFilter[];
+}
+type FieldFilter = unknown | ComparisonOperators;
+type MongoFilter = LogicalOperators & {
+    [field: string]: FieldFilter;
+};
+type SortDirection = 1 | -1 | 'asc' | 'desc';
+type MongoSort = Record<string, SortDirection>;
+interface QueryOptions {
+    sort?: MongoSort;
+    limit?: number;
+    skip?: number;
+    select?: string[] | Record<string, 0 | 1>;
+}
+interface MongoQuery {
+    collection: string;
+    filter?: MongoFilter;
+    options?: QueryOptions;
+}
+
+type SupabaseClient = SupabaseClient$1<any, any, any>;
+declare function mongoToSupabase(client: SupabaseClient, query: MongoQuery): any;
+declare function createTranslator(client: SupabaseClient): (query: MongoQuery) => any;
+declare function translateFilter<T>(query: T, filter: MongoFilter): T;
+
+export { type MongoFilter, type MongoQuery, type QueryOptions, type SupabaseClient, createTranslator, mongoToSupabase, translateFilter };

package/dist/index.js

@@ -0,0 +1 @@
+var u=n=>typeof n!="object"||n===null||Array.isArray(n)?false:Object.keys(n).some(t=>t.startsWith("$")),$=n=>(typeof n=="string"?n:n.source).replace(/^\^/,"").replace(/\$$/,"").replace(/\.\*/g,"%").replace(/\./g,"_"),m=(n,t,o)=>{if(!u(o))return o===null?n.is(t,null):n.eq(t,o);let i=o;for(let[s,e]of Object.entries(i))switch(s){case "$eq":n=e===null?n.is(t,null):n.eq(t,e);break;case "$ne":n=e===null?n.not(t,"is",null):n.neq(t,e);break;case "$gt":n=n.gt(t,e);break;case "$gte":n=n.gte(t,e);break;case "$lt":n=n.lt(t,e);break;case "$lte":n=n.lte(t,e);break;case "$in":Array.isArray(e)&&(n=n.in(t,e));break;case "$nin":Array.isArray(e)&&(n=n.not(t,"in",`(${e.map(r=>typeof r=="string"?`"${r}"`:r).join(",")})`));break;case "$regex":n=n.ilike(t,`%${$(e)}%`);break;case "$exists":n=e?n.not(t,"is",null):n.is(t,null);break}return n},c=(n,t)=>{for(let[o,i]of Object.entries(t)){if(o==="$and"&&Array.isArray(i)){for(let s of i)n=c(n,s);continue}if(o==="$or"&&Array.isArray(i)){let s=i.map(e=>Object.entries(e).map(([r,l])=>u(l)?Object.entries(l).map(([g,a])=>{switch(g){case "$eq":return `${r}.eq.${a}`;case "$ne":return `${r}.neq.${a}`;case "$gt":return `${r}.gt.${a}`;case "$gte":return `${r}.gte.${a}`;case "$lt":return `${r}.lt.${a}`;case "$lte":return `${r}.lte.${a}`;case "$in":return `${r}.in.(${a.join(",")})`;default:return ""}}).filter(Boolean).join(","):l===null?`${r}.is.null`:`${r}.eq.${l}`).join(",")).join(",");n=n.or(s);continue}o.startsWith("$")||(n=m(n,o,i));}return n},p=(n,t)=>{for(let[o,i]of Object.entries(t))n=n.order(o,{ascending:i===1||i==="asc"});return n};function b(n,t){let{collection:o,filter:i,options:s}=t,e=s?.select?n.from(o).select(Array.isArray(s.select)?s.select.join(","):Object.entries(s.select).filter(([,r])=>r===1).map(([r])=>r).join(",")||"*"):n.from(o).select("*");if(i&&Object.keys(i).length>0&&(e=c(e,i)),s?.sort&&(e=p(e,s.sort)),s?.limit!==void 0&&(e=e.limit(s.limit)),s?.skip!==void 0){let r=s.skip,l=s.limit?r+s.limit-1:r+999;e=e.range(r,l);}return e}function B(n){return t=>b(n,t)}function j(n,t){return c(n,t)}export{B as createTranslator,b as mongoToSupabase,j as translateFilter};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "mongosupa",
+  "version": "0.1.0",
+  "description": "Translate MongoDB query syntax to Supabase JS queries",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mongodb",
+    "supabase",
+    "query",
+    "translator",
+    "adapter"
+  ],
+  "author": "",
+  "license": "MIT",
+  "peerDependencies": {
+    "@supabase/supabase-js": "^2.0.0"
+  },
+  "devDependencies": {
+    "@supabase/supabase-js": "^2.49.1",
+    "tsup": "^8.3.6",
+    "typescript": "^5.7.3"
+  }
+}