fiql-parser

library0.1.5jsnpmunverified

The `fiql-parser` library by `vmoebius` provides a foundational parser for FIQL (Feed Item Query Language) expressions within Node.js environments. FIQL is a URI-friendly syntax primarily designed for filtering entries in syndicated feeds, and it serves as the basis for the more comprehensive RSQL (RESTful Service Query Language) commonly employed in RESTful API query parameters. Currently at version `0.1.5`, this package saw its most recent publish around late 2025/early 2026. Its low version number suggests a lightweight or early-stage development focus, offering a direct implementation of the FIQL grammar for JavaScript applications. While a formal release cadence is not established, the recent publishing activity indicates a minimal level of ongoing attention or re-publishing, differentiating it as a dedicated FIQL parsing utility.

serialization

github ↗package ↗

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

This package primarily uses a CommonJS default export. While direct ESM default import might work in some bundlers, the original intent and explicit README example use CommonJS `require`.

import parser from 'fiql-parser';

This is the documented and intended way to import the parser for CommonJS modules. No named exports are provided.

const parser = require('fiql-parser');

There is no `Parser` class or named `Parser` export. The package exports a single function as its default.

/* The package exports a direct parser function, not a class or named export. */

This example demonstrates how to import the `fiql-parser` and parse two sample FIQL query strings, logging the resulting Abstract Syntax Tree (AST). It includes basic error handling for malformed queries.

const parser = require('fiql-parser'); const fiqlQuery = 'title==foo*;(updated=lt=-P1D,author==*bar*)'; try { const ast = parser.parse(fiqlQuery); console.log('Successfully parsed FIQL query:'); // In a real application, you would now traverse the AST // For example, convert it to SQL, MongoDB query, or filter an array. console.log(JSON.stringify(ast, null, 2)); const anotherQuery = 'price=gt=100;category==electronics'; const anotherAst = parser.parse(anotherQuery); console.log('\nSuccessfully parsed another query:'); console.log(JSON.stringify(anotherAst, null, 2)); } catch (error) { console.error('Error parsing FIQL query:', error.message); console.error(error); }

Debug

Known footguns

gotchaThe package is at a low major version (0.1.5), indicating that the API might not be fully stable and could introduce breaking changes in minor versions, or may lack advanced features found in more mature RSQL/FIQL parsers.

gotchaThis library is primarily designed for CommonJS (`require`) environments. While modern bundlers might polyfill or adapt, direct ESM (`import`) usage is not explicitly documented or guaranteed to work without configuration or wrapper code.

gotchaBeing a parser, the library will throw errors for malformed FIQL query strings. Robust applications must implement comprehensive error handling around `parser.parse()` calls.

Upgrade

Version history

Breaking-change detection hasn't run for this library yet.

Audit

Security & dependencies

CVE tracking and dependency tree are planned for a later release.

Agent activity

16 hits · last 30 days

gptbot

ahrefsbot

amazonbot

script

Resources

githubhttps://github.com/vmoebius/node-fiql-parser ↗

packagehttps://www.npmjs.com/package/fiql-parser ↗