API'leriniz için tek bir filtre dili. FlexQL, sorguları SQL, Sequelize, MongoDB, Elasticsearch ve TypeORM çıktısına güvenli şekilde derler.
Query string'den gelen tek satır. ; = AND, , = OR. Sayı ve boolean otomatik tanınır.
{
type: "sql",
payload: {
conditions:
"( status = ? OR role != ? )
AND ( age >= ? OR price < ? )",
values: ["active", "guest", 18, 500000]
}
}WHERE (status = ? OR role != ?)$or · $ne · $gte · $ltOp.or · Op.ne · Op.gtebool.should · rangeBrackets · parametersFiltreleme her backend'in ortak ihtiyacı, ama çoğu zaman elle yazılan, test edilmeyen ve SQL injection riski taşıyan kodlarla çözülüyor.
parse() çağrısıcountry==TR,country==DE;age>=18 — URL'de bile anlaşılır.
Değerler koşuldan ayrı döner. Sürücünüze verin, string'e gömmeyin.
password, token gibi kolonları kapatın, kolon başına operatör kısıtlayın.
SQL, Sequelize, MongoDB, Elasticsearch, TypeORM.
Parantezle gruplayın. Derinlik limiti ayarlanabilir, varsayılan 3.
Tip bildirimleri hazır. Bağımlılıksız TypeORM çıktısı.
Girdi asla çalıştırılmaz; token'lara, sonra ağaca, sonra hedef sorguya dönüştürülür. Bu yüzden denetlenebilir ve taşınabilirdir.
Hepsi status==active;age>=18 ifadesi üzerinden. Sadece adapter değişiyor.
Kullanıcıdan filtre alan her ürün, aynı sorunu yaşar. FlexQL bunu bir kütüphane çağrısına indirir.
?filter= parametresini tek satırda güvenli sorguya çevirin.
GET /users?filter=age>=18;status==activeTablo filtreleri için her ekrana özel sorgu yazmayın.
role==admin,role==editorFiyat, kategori, öne çıkan gibi çoklu filtreler.
price>=100000;(featured==true,city==IST)Hassas kolonları kapatıp müşterilere güvenle filtre açın.
columnProtect: { exclude: ["token"] }Postgres'ten Mongo'ya veya Elasticsearch'e geçerken filtre katmanınız değişmesin.
adapter: "sql" → "mongo"Dahili araçlara, CLI'lara ya da yapay zekâ ajanlarına kısıtlı, doğrulanmış bir filtre dili verin.
rules: { age: [>, >=, <, <=] }Yasaklı kolonlar ve kolon başına izinli operatörler. Kural dışı bir istek derleme aşamasında durur.
flexql.parse(
"email==user@example.com;age>18",
{
adapter: "sql",
columnProtect: {
exclude: ["password", "token"],
rules: {
email: ["=="],
age: [">", ">=", "<", "<="],
},
},
}
);Ayırıcılar özelleştirilebilir: separators: { and: "|", or: "&" }. İç içe gruplar için parantez kullanın.
| == | eşittir |
| != | eşit değildir |
| > < | büyük / küçük |
| >= <= | büyük eşit / küçük eşit |
| , | OR |
| ; | AND |
| ( ) | iç içe grup |
Kurun, bir parse() çağırın, gerisini adaptör halletsin.