qarjs 0.8.2

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Zsolt Tövis
+
+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,771 @@
+     ██████╗  █████╗ ██████╗
+    ██╔═══██╗██╔══██╗██╔══██╗
+    ██║   ██║███████║██████╔╝
+    ██║▄▄ ██║██╔══██║██╔══██╗
+    ╚██████╔╝██║  ██║██║  ██║
+     ╚══▀▀═╝ ╚═╝  ╚═╝╚═╝  ╚═╝
+
+# Qar - Query Arrays
+
+MongoDB-style queries for plain JavaScript arrays. Simple, lightweight, and perfect for Next.js, static sites, and JSON data.
+
+## Why Qar?
+
+When you have a JSON file or an array of objects and need to filter, search, or query them with MongoDB-style syntax - without setting up a database.
+
+```javascript
+import { Qar } from 'qarjs';
+
+const products = new Qar(productsData);
+
+// Simple queries
+products.find({ category: 'electronics', price: { $lt: 500 } }).toArray();
+
+// Chainable API with sorting and pagination
+products.find({ inStock: true }).sort({ price: -1 }).limit(10).toArray();
+
+// Field projection
+products.find({ category: 'phones' }, { name: 1, price: 1, _id: 0 }).toArray();
+
+// Aggregation pipeline
+products.aggregate([
+  { $match: { inStock: true } },
+  { $group: { _id: '$category', count: { $sum: 1 } } },
+  { $sort: { count: -1 } },
+]);
+
+// Get unique values
+products.distinct('category'); // => ['electronics', 'clothing', 'books']
+```
+
+## Installation
+
+```bash
+npm install qarjs
+```
+
+```bash
+yarn add qarjs
+```
+
+```bash
+pnpm add qarjs
+```
+
+## Quick Start
+
+```javascript
+import { Qar } from 'qarjs';
+
+const data = [
+  { _id: 1, name: 'Alice', age: 20, role: 'user' },
+  { _id: 2, name: 'Bob', age: 30, role: 'admin' },
+  { _id: 3, name: 'Carol', age: 40, role: 'user' },
+];
+
+const users = new Qar(data);
+
+// Find all users older than 25
+users.find({ age: { $gt: 25 } }).toArray();
+// => [{ _id: 2, ... }, { _id: 3, ... }]
+
+// Find one admin
+users.findOne({ role: 'admin' });
+// => { _id: 2, name: 'Bob', age: 30, role: 'admin' }
+
+// Count users
+users.count({ role: 'user' });
+// => 2
+
+// Check if exists
+users.exists({ name: 'Alice' });
+// => true
+```
+
+## API Reference
+
+### Constructor
+
+```javascript
+const collection = new Qar(arrayOfObjects);
+```
+
+Creates a new Qar instance with your array of objects.
+
+### Methods
+
+#### `find(query, projection?)`
+
+Returns a cursor for chaining operations. Call `.toArray()` to execute.
+
+```javascript
+// Basic query
+users.find({ age: { $gte: 30 } }).toArray();
+
+// With projection
+users.find({ role: 'admin' }, { name: 1, email: 1 }).toArray();
+
+// Chainable
+users.find({ active: true }).sort({ name: 1 }).skip(10).limit(5).toArray();
+```
+
+#### `findOne(query, projection?)`
+
+Returns the first object matching the query, or `null` if not found.
+
+```javascript
+users.findOne({ name: 'Alice' });
+// => { _id: 1, name: 'Alice', ... } or null
+
+users.findOne({ role: 'admin' }, { name: 1, email: 1 });
+// => { name: 'Bob', email: 'bob@example.com' }
+```
+
+#### `count(query)`
+
+Returns the number of objects matching the query.
+
+```javascript
+users.count({ role: 'admin' });
+// => 1
+```
+
+#### `exists(query)`
+
+Returns `true` if at least one object matches the query, `false` otherwise.
+
+```javascript
+users.exists({ age: { $lt: 18 } });
+// => false
+```
+
+#### `distinct(field)`
+
+Returns an array of unique values for the specified field.
+
+```javascript
+users.distinct('role');
+// => ['user', 'admin']
+
+products.distinct('category');
+// => ['electronics', 'clothing', 'books']
+```
+
+#### `aggregate(pipeline)`
+
+Execute an aggregation pipeline. See [Aggregation Pipeline](#aggregation-pipeline) section.
+
+```javascript
+users.aggregate([{ $match: { age: { $gte: 18 } } }, { $group: { _id: '$role', count: { $sum: 1 } } }]);
+```
+
+#### `toArray()`
+
+Returns a shallow copy of the raw array.
+
+```javascript
+users.toArray();
+// => [{ ... }, { ... }, { ... }]
+```
+
+### Cursor Methods
+
+When you call `find()`, you get a cursor that supports chaining:
+
+#### `sort(spec)`
+
+Sort results by one or more fields.
+
+```javascript
+// Single field, ascending
+users.find({}).sort({ name: 1 }).toArray();
+
+// Single field, descending
+users.find({}).sort({ age: -1 }).toArray();
+
+// Multiple fields
+users.find({}).sort({ role: 1, age: -1 }).toArray();
+```
+
+#### `skip(n)`
+
+Skip the first `n` results (useful for pagination).
+
+```javascript
+users.find({}).skip(10).toArray();
+```
+
+#### `limit(n)`
+
+Limit results to `n` items.
+
+```javascript
+users.find({}).limit(5).toArray();
+```
+
+#### `project(spec)`
+
+Apply field projection (alternative to passing projection to `find()`).
+
+```javascript
+users.find({}).project({ name: 1, email: 1 }).toArray();
+```
+
+#### `toArray()`
+
+Execute the query and return results as an array.
+
+```javascript
+users.find({ active: true }).sort({ createdAt: -1 }).limit(10).toArray();
+```
+
+## Query Operators
+
+### Comparison Operators
+
+| Operator | Description           | Example                                      |
+| -------- | --------------------- | -------------------------------------------- |
+| `$eq`    | Equal to              | `{ age: { $eq: 30 } }` or `{ age: 30 }`      |
+| `$ne`    | Not equal to          | `{ role: { $ne: 'admin' } }`                 |
+| `$gt`    | Greater than          | `{ price: { $gt: 100 } }`                    |
+| `$gte`   | Greater than or equal | `{ age: { $gte: 18 } }`                      |
+| `$lt`    | Less than             | `{ stock: { $lt: 10 } }`                     |
+| `$lte`   | Less than or equal    | `{ rating: { $lte: 3 } }`                    |
+| `$in`    | In array              | `{ status: { $in: ['active', 'pending'] } }` |
+| `$nin`   | Not in array          | `{ role: { $nin: ['guest', 'banned'] } }`    |
+
+### Logical Operators
+
+| Operator | Description                    | Example                                               |
+| -------- | ------------------------------ | ----------------------------------------------------- |
+| `$and`   | All conditions must match      | `{ $and: [{ age: { $gt: 18 } }, { role: 'user' }] }`  |
+| `$or`    | At least one condition matches | `{ $or: [{ role: 'admin' }, { role: 'moderator' }] }` |
+| `$not`   | Inverts the query              | `{ $not: { age: { $lt: 18 } } }`                      |
+| `$nor`   | None of the conditions match   | `{ $nor: [{ status: 'deleted' }, { banned: true }] }` |
+
+### Element Operators
+
+| Operator  | Description           | Example                        |
+| --------- | --------------------- | ------------------------------ |
+| `$exists` | Field exists (or not) | `{ email: { $exists: true } }` |
+| `$type`   | Field type check      | `{ age: { $type: 'number' } }` |
+
+Type values: `'string'`, `'number'`, `'boolean'`, `'array'`, `'object'`, `'null'`, `'undefined'`, `'date'`
+
+### Array Operators
+
+| Operator     | Description                     | Example                                              |
+| ------------ | ------------------------------- | ---------------------------------------------------- |
+| `$all`       | Array contains all values       | `{ tags: { $all: ['javascript', 'nodejs'] } }`       |
+| `$size`      | Array has exact length          | `{ tags: { $size: 3 } }`                             |
+| `$elemMatch` | Array contains matching element | `{ items: { $elemMatch: { price: { $gt: 100 } } } }` |
+
+### Evaluation Operators
+
+| Operator | Description                     | Example                                      |
+| -------- | ------------------------------- | -------------------------------------------- |
+| `$regex` | Regular expression match        | `{ name: { $regex: '^A', $options: 'i' } }`  |
+| `$mod`   | Modulo operation                | `{ qty: { $mod: [4, 0] } }` (divisible by 4) |
+| `$expr`  | Compare fields with expressions | `{ $expr: { $gt: ['$price', '$cost'] } }`    |
+
+### Expression Operators (used in $expr)
+
+#### Comparison
+
+`$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`
+
+```javascript
+// Find products where price is less than MSRP
+products.find({ $expr: { $lt: ['$price', '$msrp'] } });
+```
+
+#### Arithmetic
+
+`$add`, `$subtract`, `$multiply`, `$divide`
+
+```javascript
+// Total value greater than 1000
+products.find({
+  $expr: { $gt: [{ $multiply: ['$price', '$quantity'] }, 1000] },
+});
+```
+
+#### String
+
+`$concat`, `$toLower`, `$toUpper`, `$substr`, `$strLenCP`, `$indexOfCP`, `$split`
+
+```javascript
+// Concatenate fields
+users.find({
+  $expr: { $eq: [{ $concat: ['$firstName', ' ', '$lastName'] }, 'John Doe'] },
+});
+```
+
+#### Array
+
+`$size`, `$arrayElemAt`, `$filter`, `$map`, `$reduce`
+
+```javascript
+// Products with more than 5 tags
+products.find({ $expr: { $gt: [{ $size: '$tags' }, 5] } });
+```
+
+#### Date
+
+`$year`, `$month`, `$dayOfMonth`, `$hour`, `$minute`, `$second`
+
+```javascript
+// Posts from 2024
+posts.find({ $expr: { $eq: [{ $year: '$publishDate' }, 2024] } });
+```
+
+#### Conditional
+
+`$cond`, `$ifNull`, `$switch`
+
+```javascript
+// Using $cond (if-then-else)
+products.find({
+  $expr: {
+    $cond: [{ $gt: ['$stock', 0] }, { $eq: ['$status', 'available'] }, { $eq: ['$status', 'sold-out'] }],
+  },
+});
+```
+
+#### Type Conversion
+
+`$toString`, `$toInt`, `$toDouble`, `$toDate`
+
+### Nested Properties
+
+Use dot notation to query nested objects:
+
+```javascript
+const data = [
+  { name: 'Alice', address: { city: 'New York', zip: '10001' } },
+  { name: 'Bob', address: { city: 'Los Angeles', zip: '90001' } },
+];
+
+const collection = new Qar(data);
+
+collection.find({ 'address.city': 'New York' }).toArray();
+// => [{ name: 'Alice', ... }]
+```
+
+## Field Projection
+
+Control which fields are returned in results.
+
+### Include/Exclude Fields
+
+```javascript
+// Include only specific fields
+users.find({}, { name: 1, email: 1 });
+// => [{ _id: 1, name: 'Alice', email: 'alice@...' }, ...]
+
+// Exclude _id
+users.find({}, { name: 1, email: 1, _id: 0 });
+// => [{ name: 'Alice', email: 'alice@...' }, ...]
+
+// Exclude specific fields
+users.find({}, { password: 0, secretKey: 0 });
+// => All fields except password and secretKey
+```
+
+### Array Slicing with $slice
+
+Limit array elements returned:
+
+```javascript
+// Get only first 3 comments
+posts.find({}, { title: 1, comments: { $slice: 3 } });
+
+// Get last 5 items
+posts.find({}, { title: 1, recentViews: { $slice: -5 } });
+
+// Multiple slices
+posts.find(
+  {},
+  {
+    title: 1,
+    comments: { $slice: 3 },
+    tags: { $slice: 5 },
+  },
+);
+```
+
+### Positional Operator ($)
+
+Return only the first matching array element:
+
+```javascript
+// Only return the first comment by Alice
+posts.find({ 'comments.author': 'Alice' }, { 'comments.$': 1 });
+```
+
+### $elemMatch Projection
+
+Return only the first array element matching a condition:
+
+```javascript
+// Only return comments with more than 10 likes
+posts.find(
+  {},
+  {
+    title: 1,
+    comments: { $elemMatch: { likes: { $gt: 10 } } },
+  },
+);
+```
+
+## Aggregation Pipeline
+
+Perform advanced data processing with aggregation pipelines.
+
+### Stages
+
+#### $match
+
+Filter documents (same syntax as `find()`):
+
+```javascript
+users.aggregate([{ $match: { age: { $gte: 18 } } }]);
+```
+
+#### $group
+
+Group documents and calculate aggregated values:
+
+```javascript
+// Count users by role
+users.aggregate([
+  {
+    $group: {
+      _id: '$role',
+      count: { $sum: 1 },
+    },
+  },
+]);
+
+// Multiple aggregations
+products.aggregate([
+  {
+    $group: {
+      _id: '$category',
+      totalProducts: { $sum: 1 },
+      avgPrice: { $avg: '$price' },
+      maxPrice: { $max: '$price' },
+      minPrice: { $min: '$price' },
+    },
+  },
+]);
+```
+
+**Accumulator Operators:**
+
+- `$sum` - Sum values
+- `$avg` - Calculate average
+- `$max` - Maximum value
+- `$min` - Minimum value
+- `$push` - Build array of values
+- `$first` - First value in group
+- `$last` - Last value in group
+
+#### $sort
+
+Sort documents:
+
+```javascript
+users.aggregate([{ $group: { _id: '$city', count: { $sum: 1 } } }, { $sort: { count: -1 } }]);
+```
+
+#### $project
+
+Reshape documents and create computed fields:
+
+```javascript
+users.aggregate([
+  {
+    $project: {
+      name: 1,
+      email: 1,
+      fullName: { $concat: ['$firstName', ' ', '$lastName'] },
+    },
+  },
+]);
+```
+
+#### $limit
+
+Limit number of documents:
+
+```javascript
+users.aggregate([{ $group: { _id: '$role', count: { $sum: 1 } } }, { $sort: { count: -1 } }, { $limit: 5 }]);
+```
+
+#### $unwind
+
+Deconstruct an array field into separate documents:
+
+```javascript
+const posts = new Qar([
+  { title: 'Post 1', tags: ['js', 'node'] },
+  { title: 'Post 2', tags: ['react', 'js'] },
+]);
+
+posts.aggregate([{ $unwind: '$tags' }, { $group: { _id: '$tags', count: { $sum: 1 } } }]);
+// => [{ _id: 'js', count: 2 }, { _id: 'node', count: 1 }, { _id: 'react', count: 1 }]
+```
+
+### Complete Example
+
+```javascript
+// Analyze product sales by category
+const salesReport = products.aggregate([
+  // Filter in-stock products
+  { $match: { inStock: true } },
+
+  // Calculate total value per product
+  {
+    $project: {
+      category: 1,
+      totalValue: { $multiply: ['$price', '$quantity'] },
+    },
+  },
+
+  // Group by category
+  {
+    $group: {
+      _id: '$category',
+      totalRevenue: { $sum: '$totalValue' },
+      productCount: { $sum: 1 },
+      avgValue: { $avg: '$totalValue' },
+    },
+  },
+
+  // Sort by revenue
+  { $sort: { totalRevenue: -1 } },
+
+  // Top 10 categories
+  { $limit: 10 },
+]);
+```
+
+## Use Cases
+
+### Next.js Static Data
+
+Perfect for querying JSON data in Next.js applications:
+
+```javascript
+// app/products/page.tsx
+import productsData from '@/data/products.json';
+import { Qar } from 'qarjs';
+
+const products = new Qar(productsData);
+
+export default function ProductsPage({ searchParams }) {
+  const filtered = products
+    .find({
+      category: searchParams.category,
+      price: { $lte: Number(searchParams.maxPrice) || 1000 },
+      inStock: true,
+    })
+    .sort({ price: 1 })
+    .skip((Number(searchParams.page) - 1) * 20)
+    .limit(20)
+    .toArray();
+
+  return <ProductList items={filtered} />;
+}
+```
+
+### API Routes
+
+```javascript
+// app/api/search/route.ts
+import data from '@/data/items.json';
+import { Qar } from 'qarjs';
+
+const items = new Qar(data);
+
+export async function GET(request) {
+  const q = request.nextUrl.searchParams.get('q');
+
+  const results = items
+    .find({
+      $or: [{ name: { $regex: q, $options: 'i' } }, { description: { $regex: q, $options: 'i' } }],
+    })
+    .limit(50)
+    .toArray();
+
+  return Response.json(results);
+}
+```
+
+### Static Site Generation
+
+```javascript
+import blogPosts from './posts.json';
+import { Qar } from 'qarjs';
+
+const posts = new Qar(blogPosts);
+
+// Get published posts by category
+const techPosts = posts
+  .find({
+    category: 'technology',
+    published: true,
+    publishDate: { $lte: new Date().toISOString() },
+  })
+  .sort({ publishDate: -1 })
+  .toArray();
+
+// Get featured post
+const featured = posts.findOne({ featured: true });
+
+// Count drafts
+const draftCount = posts.count({ published: false });
+
+// Get all categories with post counts
+const categories = posts.aggregate([
+  { $match: { published: true } },
+  { $group: { _id: '$category', count: { $sum: 1 } } },
+  { $sort: { count: -1 } },
+]);
+```
+
+## Why Qar over alternatives?
+
+| Feature               | Qar     | mingo      | sift.js | lodash   |
+| --------------------- | ------- | ---------- | ------- | -------- |
+| MongoDB-style queries | ✅      | ✅         | ✅      | ❌       |
+| Chainable API         | ✅      | ⚠️ Limited | ❌      | ✅       |
+| Aggregation pipeline  | ✅      | ✅         | ❌      | ❌       |
+| Field projection      | ✅      | ✅         | ❌      | ❌       |
+| Expression operators  | ✅ 30+  | ✅         | ❌      | ❌       |
+| Zero dependencies     | ✅      | ❌         | ✅      | ❌       |
+| Bundle size (gzipped) | ✅ ~5KB | ❌ ~15KB   | ✅ ~2KB | ❌ ~24KB |
+
+**Qar is perfect when you:**
+
+- Work with static JSON data in Next.js or static sites
+- Want MongoDB-style queries without a database
+- Need aggregation and data transformation
+- Want a clean, intuitive API
+- Care about bundle size
+
+**Not recommended for:**
+
+- Very large datasets - use a real database
+- Real-time data updates - use a database with subscriptions
+- Complex JOIN operations across multiple collections
+
+## Examples
+
+### Complex Queries
+
+```javascript
+const users = new Qar(userData);
+
+// Find active admins or moderators over 25
+users
+  .find({
+    $and: [{ age: { $gt: 25 } }, { status: 'active' }, { $or: [{ role: 'admin' }, { role: 'moderator' }] }],
+  })
+  .toArray();
+
+// Users NOT in specific roles
+users
+  .find({
+    $nor: [{ role: 'guest' }, { role: 'banned' }],
+  })
+  .toArray();
+
+// Regex search (case-insensitive)
+users
+  .find({
+    email: { $regex: '@gmail\\.com$', $options: 'i' },
+  })
+  .toArray();
+
+// Compare fields
+products
+  .find({
+    $expr: { $lt: ['$currentPrice', '$originalPrice'] },
+  })
+  .toArray();
+```
+
+### Pagination
+
+```javascript
+const page = 2;
+const pageSize = 20;
+
+const results = products
+  .find({ category: 'electronics' })
+  .sort({ price: 1 })
+  .skip((page - 1) * pageSize)
+  .limit(pageSize)
+  .toArray();
+
+const total = products.count({ category: 'electronics' });
+const totalPages = Math.ceil(total / pageSize);
+```
+
+### Multiple Collections
+
+```javascript
+const products = new Qar(productsData);
+const orders = new Qar(ordersData);
+const users = new Qar(usersData);
+
+// Query each independently
+const electronics = products.find({ category: 'electronics' }).toArray();
+const recentOrders = orders.find({ date: { $gte: '2026-01-01' } }).toArray();
+const admins = users.find({ role: 'admin' }).toArray();
+```
+
+## TypeScript
+
+Full TypeScript support included:
+
+```typescript
+import { Qar } from 'qarjs';
+
+interface User {
+  id: number;
+  name: string;
+  age: number;
+  role: 'user' | 'admin';
+}
+
+const users = new Qar<User>(userData);
+
+// Type-safe queries
+const result = users.find({ age: { $gt: 25 } }).toArray(); // User[]
+const admin = users.findOne({ role: 'admin' }); // User | null
+const roles = users.distinct('role'); // string[]
+```
+
+## Browser Support
+
+Works in all modern browsers and Node.js environments:
+
+- Chrome/Edge: ✅
+- Firefox: ✅
+- Safari: ✅
+- Node.js: ✅ (v14+)
+
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request.
+
+## License
+
+MIT © Zsolt Tövis
+
+---
+
+Made with ❤️ for developers who love clean APIs and don't need a database for everything

package/dist/qar.cjs

@@ -0,0 +1 @@
+var w=Object.defineProperty;var E=Object.getOwnPropertyDescriptor;var W=Object.getOwnPropertyNames;var R=Object.prototype.hasOwnProperty;var I=(e,t)=>{for(var i in t)w(e,i,{get:t[i],enumerable:!0})},V=(e,t,i,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of W(t))!R.call(e,r)&&r!==i&&w(e,r,{get:()=>t[r],enumerable:!(n=E(t,r))||n.enumerable});return e};var D=e=>V(w({},"__esModule",{value:!0}),e);var G={};I(G,{Qar:()=>P});module.exports=D(G);var s=e=>e==null?e===null?"null":"undefined":Array.isArray(e)?"array":e instanceof Date?"date":typeof e;var $=(e={},t="")=>t.includes(".")?Q(e,t):e[t],Q=(e={},t="")=>t?(e=e||{},t.split(".").reduce((r,o)=>{if(r!=null)return r[o]},e)):e,y=e=>{if(e==null)return e;if(e instanceof Date)return new Date(e.getTime());if(e instanceof RegExp)return new RegExp(e);if(e instanceof Map){let t=new Map;for(let[i,n]of e.entries())t.set(i,y(n));return t}if(e instanceof Set){let t=new Set;for(let i of e.values())t.add(y(i));return t}if(s(e)==="array")return e.map(t=>y(t));if(s(e)==="object"){let t={},i=Object.keys(e);for(let n=0;n<i.length;n++)t[i[n]]=y(e[i[n]]);return t}return e};var p=(e,t)=>{if(e instanceof Date)return e;if(s(e)==="string"){if(e.startsWith("$$")){let i=e.slice(2);return t&&t.__vars?t.__vars[i]:void 0}if(e.startsWith("$"))return $(t,e.slice(1))}return s(e)==="array"?e.map(i=>p(i,t)):s(e)==="object"?g(e,t):e},g=(e,t)=>{if(e==null||s(e)!=="object")return e;let i=Object.keys(e);if(i.length===0)return!1;let n=i[0];if(n==="$and"){let r=e[n];return s(r)!=="array"?!1:r.every(o=>!!g(o,t))}if(n==="$or"){let r=e[n];return s(r)!=="array"?!1:r.some(o=>!!g(o,t))}if(n==="$not")return!g(e[n],t);if(["$add","$subtract","$multiply","$divide"].includes(n)){let r=e[n];if(s(r)!=="array"||r.length<2)return!1;let o=p(r[0],t),a=p(r[1],t);switch(n){case"$add":return o+a;case"$subtract":return o-a;case"$multiply":return o*a;case"$divide":return o/a}}if(["$lt","$lte","$gt","$gte","$eq","$ne"].includes(n)){let r=e[n];if(s(r)!=="array"||r.length<2)return!1;let o=p(r[0],t),a=p(r[1],t);switch(n){case"$lt":return o<a;case"$lte":return o<=a;case"$gt":return o>a;case"$gte":return o>=a;case"$eq":return o===a;case"$ne":return o!==a}}if(n==="$in"){let r=e[n];if(s(r)!=="array"||r.length<2)return!1;let o=p(r[0],t),a=p(r[1],t);return s(a)==="array"&&a.includes(o)}if(n==="$strLenCP"){let r=p(e[n],t);return r==null?0:s(r)==="array"?r.length:Array.from(String(r)).length}if(n==="$indexOfCP"){let r=e[n];if(s(r)!=="array"||r.length<2)return-1;let o=String(p(r[0],t)),a=String(p(r[1],t)),f=r.length>2&&Number(p(r[2],t))||0;return o.indexOf(a,f)}if(n==="$split"){let r=e[n];if(s(r)!=="array"||r.length<2)return[];let o=String(p(r[0],t)),a=String(p(r[1],t));return o.split(a)}if(n==="$size"){let r=p(e[n],t);return s(r)==="array"?r.length:0}if(n==="$arrayElemAt"){let r=e[n];if(s(r)!=="array"||r.length<2)return;let o=p(r[0],t),a=Number(p(r[1],t));return s(o)!=="array"?void 0:a<0?o[o.length+a]:o[a]}if(n==="$filter"){let r=e[n];if(s(r)!=="object")return[];let o=p(r.input,t);if(s(o)!=="array")return[];let a=r.as||"this",f=r.cond;return o.filter((u,d)=>{let c=Object.assign({},u);return c.__vars=Object.assign({},t&&t.__vars?t.__vars:{},{[a]:u,index:d}),!!g(f,c)})}if(n==="$map"){let r=e[n];if(s(r)!=="object")return[];let o=p(r.input,t);if(s(o)!=="array")return[];let a=r.as||"this",f=r.in;return o.map((u,d)=>{let c=Object.assign({},u);return c.__vars=Object.assign({},t&&t.__vars?t.__vars:{},{[a]:u,index:d}),g(f,c)})}if(n==="$reduce"){let r=e[n];if(s(r)!=="object")return null;let o=p(r.input,t),a=r.in,f=p(r.initialValue,t);return s(o)!=="array"?f:o.reduce((u,d,c)=>{let l=Object.assign({},d);return l.__vars=Object.assign({},t&&t.__vars?t.__vars:{},{value:u,this:d,index:c}),g(a,l)},f)}if(n==="$year"||n==="$month"||n==="$dayOfMonth"||n==="$hour"||n==="$minute"||n==="$second"){let r=new Date(p(e[n],t));if(isNaN(r.getTime()))return null;switch(n){case"$year":return r.getUTCFullYear();case"$month":return r.getUTCMonth()+1;case"$dayOfMonth":return r.getUTCDate();case"$hour":return r.getUTCHours();case"$minute":return r.getUTCMinutes();case"$second":return r.getUTCSeconds()}}if(n==="$cond"){let r=e[n];if(s(r)==="array"&&r.length===3)return p(r[0],t)?p(r[1],t):p(r[2],t);if(s(r)==="object"){let{if:o,then:a,else:f}=r;return g(o,t)?g(a,t):g(f,t)}return null}if(n==="$ifNull"){let r=e[n];if(s(r)!=="array"||r.length<2)return p(r,t);let o=p(r[0],t);return o??p(r[1],t)}if(n==="$switch"){let r=e[n];if(s(r)!=="object")return null;let o=r.branches||[];for(let a of o)if(g(a.case,t))return g(a.then,t);return r.default!==void 0?g(r.default,t):null}if(n==="$toString")return p(e[n],t)==null?null:String(p(e[n],t));if(n==="$toInt")return Number.parseInt(p(e[n],t),10)||0;if(n==="$toDouble")return Number.parseFloat(p(e[n],t))||0;if(n==="$toDate"){let r=p(e[n],t),o=new Date(r);return isNaN(o.getTime())?null:o}if(n==="$concat"){let r=e[n];return s(r)!=="array"?"":r.map(o=>p(o,t)).join("")}if(n==="$toLower"){let r=p(e[n],t);return r==null?r:String(r).toLowerCase()}if(n==="$toUpper"){let r=p(e[n],t);return r==null?r:String(r).toUpperCase()}if(n==="$substr"){let r=e[n];if(s(r)!=="array"||r.length<3)return"";let o=String(p(r[0],t)),a=Number(p(r[1],t))||0,f=Number(p(r[2],t))||0;return o.substr(a,f)}return!1};var S=Object.freeze({$eq:(e,t)=>e===t,$ne:(e,t)=>e!==t,$in:(e,t)=>s(t)!=="array"?!1:s(e)==="array"?e.some(i=>t.includes(i)):t.includes(e),$nin:(e,t)=>s(t)!=="array"?!1:s(e)==="array"?!e.some(i=>t.includes(i)):!t.includes(e),$exists:(e,t)=>e!==void 0===t,$size:(e,t)=>s(e)==="array"&&e.length===t,$all:(e,t)=>s(e)!=="array"||s(t)!=="array"?!1:t.every(i=>e.includes(i)),$elemMatch:(e,t)=>{if(s(e)!=="array"||s(t)!=="object")return!1;let i=Object.keys(t);return i.length===0?!1:e.some(n=>{if(s(n)!=="object")return!1;for(let r of i){let o=$(n,r);if(!j(o,t[r]))return!1}return!0})},$type:(e,t)=>s(t)==="array"?t.some(i=>s(e)===i):s(e)===t,$mod:(e,t)=>{if(s(e)!=="number"||s(t)!=="array"||t.length<2)return!1;let i=t[0],n=t[1];return s(i)!=="number"||s(n)!=="number"?!1:e%i===n},$lt:(e,t)=>s(e)==="date"&&s(t)==="date"?e.getTime()<t.getTime():s(e)!==s(t)?!1:e<t,$lte:(e,t)=>s(e)==="date"&&s(t)==="date"?e.getTime()<=t.getTime():s(e)!==s(t)?!1:e<=t,$gt:(e,t)=>s(e)==="date"&&s(t)==="date"?e.getTime()>t.getTime():s(e)!==s(t)?!1:e>t,$gte:(e,t)=>s(e)==="date"&&s(t)==="date"?e.getTime()>=t.getTime():s(e)!==s(t)?!1:e>=t,$regex:(e,t,i)=>{try{return new RegExp(t,i).test(String(e))}catch(n){return console.warn("[applyQuery] invalid $regex pattern:",t,"error:",n&&n.message),!1}}}),j=(e,t)=>{if(s(t)!=="object")return e===t;let i=Object.keys(t).filter(n=>Object.prototype.hasOwnProperty.call(S,n));return i.length===0?(console.warn("[applyQuery] no recognized operators in condition:",t),!1):i.every(n=>n==="$regex"?S[n](e,t[n],t.$options):S[n](e,t[n]))},b=(e,t)=>{if(s(t)!=="object")return!1;if(s(t.$and)==="array")return t.$and.every(i=>b(e,i));if(s(t.$or)==="array")return t.$or.some(i=>b(e,i));if(s(t.$not)==="object")return!b(e,t.$not);if(s(t.$nor)==="array")return!t.$nor.some(i=>b(e,i));if(t.$expr!==void 0)return!!g(t.$expr,e);for(let i of Object.keys(t)){let n=t[i],r=$(e,i);if((i==="$regex"||s(n)==="object"&&Object.prototype.hasOwnProperty.call(n,"$regex"))&&s(r)!=="string")return console.warn("[applyQuery] $regex used on non-string value, skipping match"),!1;if(!j(r,n))return!1}return!0},_=(e=[],t,i={})=>{let n=e||[];if(s(t)!=="object")return n;t.$and!==void 0&&s(t.$and)!=="array"&&console.warn("[applyQuery] $and should be an array, ignoring as combinator:",t.$and),t.$or!==void 0&&s(t.$or)!=="array"&&console.warn("[applyQuery] $or should be an array, ignoring as combinator:",t.$or),t.$nor!==void 0&&s(t.$nor)!=="array"&&console.warn("[applyQuery] $nor should be an array, ignoring as combinator:",t.$nor),t.$not!==void 0&&s(t.$not)!=="object"&&console.warn("[applyQuery] $not should be an object, ignoring as combinator:",t.$not);let r=i&&i.indexes;if(r&&s(r)==="object"){let o=Object.keys(t).filter(a=>!["$and","$or","$not","$nor"].includes(a));if(o.length===1){let a=o[0],f=t[a],u=s(f)!=="object"?f:Object.prototype.hasOwnProperty.call(f,"$eq")?f.$eq:void 0;if(u!==void 0&&r[a]instanceof Map)return(r[a].get(u)||[]).filter(h=>b(h,t))}}return n.filter(o=>b(o,t))};var U=(e,t)=>{let i=f=>s(f)==="string"?{path:f,preserveNull:!1}:s(f)==="object"?{path:f.path||f.$path||f.field,preserveNull:!!f.preserveNullAndEmptyArrays}:{path:void 0,preserveNull:!1},{path:n,preserveNull:r}=i(t);if(!n)return e;let o=n.startsWith("$")?n.slice(1):n,a=[];for(let f of e){let u=$(f??{},o);if(s(u)!=="array"){if(r){let d=y(f),c=o.split("."),l=N(d,c);l!=null&&(l[c[c.length-1]]=null),a.push(d)}continue}for(let d of u){let c=y(f),l=o.split("."),h=N(c,l);h!=null&&(h[l[l.length-1]]=d),a.push(c)}}return a},N=(e,t)=>{let i=e;for(let n of t.slice(0,-1)){if(i==null)return i;(!Object.prototype.hasOwnProperty.call(i,n)||s(i[n])!=="object")&&(i[n]={}),i=i[n]}return i},B=(e,t)=>{let i=new Map;for(let r of e){let o=t._id===null?null:s(t._id)==="string"&&t._id.startsWith("$")?$(r,t._id.slice(1)):s(t._id)==="object"?g(t._id,r):t._id,a=s(o)==="object"?JSON.stringify(o):String(o);if(!i.has(a)){let u={_id:o};for(let[d,c]of Object.entries(t)){if(d==="_id")continue;let l=Object.keys(c)[0];l==="$sum"?u[d]=0:l==="$push"?u[d]=[]:l==="$avg"?u[d]={sum:0,cnt:0}:l==="$max"||l==="$min"||l==="$first"||l==="$last"?u[d]=void 0:u[d]=null}i.set(a,u)}let f=i.get(a);for(let[u,d]of Object.entries(t)){if(u==="_id")continue;let c=Object.keys(d)[0],l=d[c];if(c==="$sum"){let h=s(l)==="number"?l:s(l)==="string"&&l.startsWith("$")?$(r,l.slice(1)):g(l,r);f[u]=(f[u]||0)+(Number(h)||0)}else if(c==="$push"){let h=s(l)==="string"&&l.startsWith("$")?$(r,l.slice(1)):g(l,r);f[u].push(h)}else if(c==="$avg"){let h=s(l)==="number"?l:s(l)==="string"&&l.startsWith("$")?$(r,l.slice(1)):g(l,r),m=Number(h);Number.isNaN(m)||(f[u].sum+=m,f[u].cnt+=1)}else if(c==="$max"){let h=s(l)==="string"&&l.startsWith("$")?$(r,l.slice(1)):g(l,r);(f[u]===void 0||h>f[u])&&(f[u]=h)}else if(c==="$min"){let h=s(l)==="string"&&l.startsWith("$")?$(r,l.slice(1)):g(l,r);(f[u]===void 0||h<f[u])&&(f[u]=h)}else if(c==="$first"){if(f[u]===void 0){let h=s(l)==="string"&&l.startsWith("$")?$(r,l.slice(1)):g(l,r);f[u]=h}}else if(c==="$last"){let h=s(l)==="string"&&l.startsWith("$")?$(r,l.slice(1)):g(l,r);f[u]=h}}}let n=[];for(let r of i.values()){for(let[o,a]of Object.entries(r)){let f=t[o];if(!f)continue;Object.keys(f)[0]==="$avg"&&(r[o]=a.cnt===0?null:a.sum/a.cnt)}n.push(r)}return n},z=(e,t)=>{if(s(t)!=="object")return e;let i=Object.keys(t);return e.slice().sort((n,r)=>{for(let o of i){let a=t[o]===-1?-1:1,f=$(n,o),u=$(r,o);if(!(f==null&&u==null)){if(f==null)return-1*a;if(u==null)return 1*a;if(f<u)return-1*a;if(f>u)return 1*a}}return 0})},F=(e,t)=>e.map(i=>{if(s(t)!=="object")return{...i};let n=Object.keys(t).some(o=>t[o]===1),r={};if(n){for(let[o,a]of Object.entries(t))if(a===1){let f=$(i,o);f!==void 0&&(r[o]=f)}else s(a)==="string"&&a.startsWith("$")?r[o]=$(i,a.slice(1)):s(a)==="object"&&(r[o]=g(a,i));return r}for(let o of Object.keys(i))r[o]=i[o];for(let[o,a]of Object.entries(t))a===0?delete r[o]:s(a)==="string"&&a.startsWith("$")?r[o]=$(i,a.slice(1)):s(a)==="object"&&(r[o]=g(a,i));return r}),L=(e,t)=>{let i=Math.max(0,parseInt(t,10)||0);return e.slice(0,i)},C=(e=[],t=[])=>{let i=s(e)==="array"?e.slice():[];return t.reduce((n,r)=>{let o=Object.keys(r)[0],a=r[o];return o==="$match"?_(n,a):o==="$unwind"?U(n,a):o==="$group"?B(n,a):o==="$sort"?z(n,a):o==="$project"?F(n,a):o==="$limit"?L(n,a):n},i)};var v=(e,t,i)=>{let n=t.split("."),r=n[n.length-1],o=n.slice(0,-1).reduce((a,f)=>a==null?a:((!Object.prototype.hasOwnProperty.call(a,f)||s(a[f])!=="object")&&(a[f]={}),a[f]),e);o!=null&&(o[r]=i)},O=(e,t)=>t.split(".").reduce((n,r)=>{if(!(n==null||!Object.prototype.hasOwnProperty.call(n,r)))return n[r]},e),M=(e,t,i=[])=>{if(!e||s(e)!=="object")return i;if(s(e.$and)==="array"){for(let n of e.$and)M(n,t,i);return i}for(let n of Object.keys(e))if(!(n==="$and"||n==="$or"||n==="$not"||n==="$nor")&&(n===t&&e[n]&&s(e[n])==="object"&&Object.prototype.hasOwnProperty.call(e[n],"$elemMatch")&&i.push({type:"elemMatch",cond:e[n].$elemMatch}),n.startsWith(t+"."))){let r=n.slice(t.length+1);i.push({type:"subfield",subfield:r,cond:e[n]})}return i},H=(e,t)=>{let i=M(e,t);return i.length===0?null:n=>{for(let r of i)if(r.type==="elemMatch"){if(s(r.cond)!=="object")return!1;let o=Object.keys(r.cond);if(o.length===0)return!1;for(let a of o){let f=$(n,a);if(!j(f,r.cond[a]))return!1}}else if(r.type==="subfield"){let o=$(n,r.subfield);if(!j(o,r.cond))return!1}return!0}},J=(e,t)=>{if(!t||s(t)!=="object")return!1;let i=Object.keys(t);if(i.length===0)return!1;for(let n of i){let r=$(e,n);if(!j(r,t[n]))return!1}return!0},Y=(e={},t,i=null)=>{if(!t||s(t)!=="object")return{...e};let n=Object.keys(t),r=n.some(u=>t[u]===0),a=n.some(u=>{let d=t[u];return d===1?!0:s(d)==="object"?Object.prototype.hasOwnProperty.call(d,"$slice")||Object.prototype.hasOwnProperty.call(d,"$elemMatch"):!1})?"include":"exclude",f={};if(a==="include"){for(let u of n){if(u==="_id"&&t._id===0)continue;let d=t[u];if(u.endsWith(".$")){let c=u.slice(0,-2),l=O(e,c);if(s(l)==="array"){let h=H(i,c);if(h){let m=l.find(A=>h(A));m!==void 0&&v(f,c,[m])}}continue}if(d===1){let c=O(e,u);c!==void 0&&v(f,u,c)}else if(s(d)==="object"&&Object.prototype.hasOwnProperty.call(d,"$elemMatch")){let c=O(e,u);if(s(c)==="array"){let l=c.find(h=>J(h,d.$elemMatch));l!==void 0&&v(f,u,[l])}}else if(s(d)==="object"&&Object.prototype.hasOwnProperty.call(d,"$slice")){let c=O(e,u);if(c!==void 0){let l=d.$slice,h=s(c)==="array"?s(l)!=="number"||l===0?[]:l>0?c.slice(0,l):c.slice(l):c;v(f,u,h)}}}return t._id!==0&&Object.prototype.hasOwnProperty.call(e,"_id")&&(f._id=e._id),f}for(let u of Object.keys(e))f[u]=e[u];for(let u of n)if(t[u]===0){let c=u.split(".");if(c.length===1)delete f[u];else{let l=c.pop(),h=c.join("."),m=O(f,h);m&&Object.prototype.hasOwnProperty.call(m,l)&&delete m[l]}}return f},T=(e=[],t,i=null)=>s(e)!=="array"?e:!t||s(t)!=="object"?e.map(n=>({...n})):e.map(n=>Y(n,t,i));var k=class e{constructor(t=[],i={},n=null){this._items=t||[],this._query=i||{},this._projection=n||null,this._sortSpec=null,this._skip=0,this._limit=null}sort(t={}){return this._sortSpec=t&&s(t)==="object"?t:null,this}project(t=null){return this._projection=t&&s(t)==="object"?t:this._projection,this}skip(t=0){return this._skip=Math.max(0,parseInt(String(t),10)||0),this}limit(t){return t==null?this.toArray():(this._limit=Math.max(0,parseInt(String(t),10)||0),this)}toArray(){let t=_(this._items,this._query),i=this._sortSpec?(()=>{let a=Object.keys(this._sortSpec);return t.slice().sort((f,u)=>{for(let d of a){let c=this._sortSpec[d]===-1?-1:1,l=$(f,d),h=$(u,d);if(!(l==null&&h==null)){if(l==null)return-1*c;if(h==null)return 1*c;if(l<h)return-1*c;if(l>h)return 1*c}}return 0})})():t,n=this._skip&&this._skip>0?i.slice(this._skip):i,r=this._limit!=null?n.slice(0,this._limit):n;return this._projection?T(r,this._projection,this._query):r}static from(t,i={},n=null){return new e(t,i,n)}};var P=class{constructor(t=[]){if(s(t)!=="array")throw new TypeError("Items must be an array of objects");this._items=t}find(t={},i){return k.from(this._items,t,i)}findOne(t={},i){let n=this.find(t,i).toArray();return n.length>0?n[0]:null}count(t={}){return this.find(t).toArray().length}exists(t={}){return this.find(t).toArray().length>0}distinct(t){if(!t)return[];let i=new Set;for(let n of this._items){let r=s(t)==="string"&&t.startsWith("$")?$(n,t.slice(1)):$(n,t);r!==void 0&&i.add(r)}return Array.from(i)}aggregate(t=[]){return C(this._items,t)}toArray(){return s(this._items)==="array"?[...this._items]:[]}};0&&(module.exports={Qar});

package/dist/qar.d.ts

@@ -0,0 +1,79 @@
+export type QueryOperators<T = any> = {
+  $eq?: T;
+  $ne?: T;
+  $lt?: T;
+  $lte?: T;
+  $gt?: T;
+  $gte?: T;
+  $in?: T[];
+  $nin?: T[];
+  $exists?: boolean;
+  $regex?: string | RegExp;
+  $options?: string;
+  $size?: number;
+  $all?: any[];
+  $elemMatch?: Record<string, any>;
+  $type?: string | string[];
+  $mod?: [number, number];
+};
+
+export type Query<T = any> = {
+  [K in keyof T]?: T[K] | QueryOperators<T[K]>;
+} & {
+  $and?: Query<T>[];
+  $or?: Query<T>[];
+  $nor?: Query<T>[];
+  $not?: Query<T>;
+  $expr?: Record<string, any>;
+};
+
+export type Projection<T = any> =
+  | ({
+      [K in keyof T]?: 1 | 0 | { $slice?: number; $elemMatch?: Record<string, any> };
+    } & {
+      _id?: 0 | 1;
+      [key: string]: 1 | 0 | { $slice?: number; $elemMatch?: Record<string, any> } | undefined;
+    })
+  | null;
+
+export type Pipeline = Array<
+  | { $match: Record<string, any> }
+  | { $group: Record<string, any> }
+  | { $sort: Record<string, 1 | -1> }
+  | { $project: Record<string, any> }
+  | { $limit: number }
+  | { $unwind: string | { path: string; preserveNullAndEmptyArrays?: boolean } }
+  | Record<string, any>
+>;
+
+export class QueryCursor<T = any> {
+  constructor(items?: T[], query?: Query<T>, projection?: Projection<T>);
+
+  sort(spec?: Record<string, 1 | -1>): this;
+  project(spec?: Projection<T>): this;
+  skip(n?: number): this;
+  limit(): T[];
+  limit(n: number): this;
+  limit(n?: number): this | T[];
+
+  toArray(): T[];
+
+  static from<T = any>(items: T[], query?: Query<T>, projection?: Projection<T>): QueryCursor<T>;
+}
+
+export class Qar<T = any> {
+  constructor(items?: T[]);
+
+  find(query?: Query<T>, projection?: Projection<T>): QueryCursor<T>;
+  findOne(query?: Query<T>, projection?: Projection<T>): T | null;
+  count(query?: Query<T>): number;
+  exists(query?: Query<T>): boolean;
+
+  distinct<K extends keyof T>(field: K): Array<T[K]>;
+  distinct(field: string): any[];
+
+  aggregate<R = any>(pipeline?: Pipeline): R[];
+  toArray(): T[];
+}
+
+export default Qar;

package/dist/qar.js

@@ -0,0 +1 @@
+var s=e=>e==null?e===null?"null":"undefined":Array.isArray(e)?"array":e instanceof Date?"date":typeof e;var $=(e={},t="")=>t.includes(".")?A(e,t):e[t],A=(e={},t="")=>t?(e=e||{},t.split(".").reduce((r,o)=>{if(r!=null)return r[o]},e)):e,y=e=>{if(e==null)return e;if(e instanceof Date)return new Date(e.getTime());if(e instanceof RegExp)return new RegExp(e);if(e instanceof Map){let t=new Map;for(let[i,n]of e.entries())t.set(i,y(n));return t}if(e instanceof Set){let t=new Set;for(let i of e.values())t.add(y(i));return t}if(s(e)==="array")return e.map(t=>y(t));if(s(e)==="object"){let t={},i=Object.keys(e);for(let n=0;n<i.length;n++)t[i[n]]=y(e[i[n]]);return t}return e};var p=(e,t)=>{if(e instanceof Date)return e;if(s(e)==="string"){if(e.startsWith("$$")){let i=e.slice(2);return t&&t.__vars?t.__vars[i]:void 0}if(e.startsWith("$"))return $(t,e.slice(1))}return s(e)==="array"?e.map(i=>p(i,t)):s(e)==="object"?g(e,t):e},g=(e,t)=>{if(e==null||s(e)!=="object")return e;let i=Object.keys(e);if(i.length===0)return!1;let n=i[0];if(n==="$and"){let r=e[n];return s(r)!=="array"?!1:r.every(o=>!!g(o,t))}if(n==="$or"){let r=e[n];return s(r)!=="array"?!1:r.some(o=>!!g(o,t))}if(n==="$not")return!g(e[n],t);if(["$add","$subtract","$multiply","$divide"].includes(n)){let r=e[n];if(s(r)!=="array"||r.length<2)return!1;let o=p(r[0],t),a=p(r[1],t);switch(n){case"$add":return o+a;case"$subtract":return o-a;case"$multiply":return o*a;case"$divide":return o/a}}if(["$lt","$lte","$gt","$gte","$eq","$ne"].includes(n)){let r=e[n];if(s(r)!=="array"||r.length<2)return!1;let o=p(r[0],t),a=p(r[1],t);switch(n){case"$lt":return o<a;case"$lte":return o<=a;case"$gt":return o>a;case"$gte":return o>=a;case"$eq":return o===a;case"$ne":return o!==a}}if(n==="$in"){let r=e[n];if(s(r)!=="array"||r.length<2)return!1;let o=p(r[0],t),a=p(r[1],t);return s(a)==="array"&&a.includes(o)}if(n==="$strLenCP"){let r=p(e[n],t);return r==null?0:s(r)==="array"?r.length:Array.from(String(r)).length}if(n==="$indexOfCP"){let r=e[n];if(s(r)!=="array"||r.length<2)return-1;let o=String(p(r[0],t)),a=String(p(r[1],t)),f=r.length>2&&Number(p(r[2],t))||0;return o.indexOf(a,f)}if(n==="$split"){let r=e[n];if(s(r)!=="array"||r.length<2)return[];let o=String(p(r[0],t)),a=String(p(r[1],t));return o.split(a)}if(n==="$size"){let r=p(e[n],t);return s(r)==="array"?r.length:0}if(n==="$arrayElemAt"){let r=e[n];if(s(r)!=="array"||r.length<2)return;let o=p(r[0],t),a=Number(p(r[1],t));return s(o)!=="array"?void 0:a<0?o[o.length+a]:o[a]}if(n==="$filter"){let r=e[n];if(s(r)!=="object")return[];let o=p(r.input,t);if(s(o)!=="array")return[];let a=r.as||"this",f=r.cond;return o.filter((u,d)=>{let c=Object.assign({},u);return c.__vars=Object.assign({},t&&t.__vars?t.__vars:{},{[a]:u,index:d}),!!g(f,c)})}if(n==="$map"){let r=e[n];if(s(r)!=="object")return[];let o=p(r.input,t);if(s(o)!=="array")return[];let a=r.as||"this",f=r.in;return o.map((u,d)=>{let c=Object.assign({},u);return c.__vars=Object.assign({},t&&t.__vars?t.__vars:{},{[a]:u,index:d}),g(f,c)})}if(n==="$reduce"){let r=e[n];if(s(r)!=="object")return null;let o=p(r.input,t),a=r.in,f=p(r.initialValue,t);return s(o)!=="array"?f:o.reduce((u,d,c)=>{let l=Object.assign({},d);return l.__vars=Object.assign({},t&&t.__vars?t.__vars:{},{value:u,this:d,index:c}),g(a,l)},f)}if(n==="$year"||n==="$month"||n==="$dayOfMonth"||n==="$hour"||n==="$minute"||n==="$second"){let r=new Date(p(e[n],t));if(isNaN(r.getTime()))return null;switch(n){case"$year":return r.getUTCFullYear();case"$month":return r.getUTCMonth()+1;case"$dayOfMonth":return r.getUTCDate();case"$hour":return r.getUTCHours();case"$minute":return r.getUTCMinutes();case"$second":return r.getUTCSeconds()}}if(n==="$cond"){let r=e[n];if(s(r)==="array"&&r.length===3)return p(r[0],t)?p(r[1],t):p(r[2],t);if(s(r)==="object"){let{if:o,then:a,else:f}=r;return g(o,t)?g(a,t):g(f,t)}return null}if(n==="$ifNull"){let r=e[n];if(s(r)!=="array"||r.length<2)return p(r,t);let o=p(r[0],t);return o??p(r[1],t)}if(n==="$switch"){let r=e[n];if(s(r)!=="object")return null;let o=r.branches||[];for(let a of o)if(g(a.case,t))return g(a.then,t);return r.default!==void 0?g(r.default,t):null}if(n==="$toString")return p(e[n],t)==null?null:String(p(e[n],t));if(n==="$toInt")return Number.parseInt(p(e[n],t),10)||0;if(n==="$toDouble")return Number.parseFloat(p(e[n],t))||0;if(n==="$toDate"){let r=p(e[n],t),o=new Date(r);return isNaN(o.getTime())?null:o}if(n==="$concat"){let r=e[n];return s(r)!=="array"?"":r.map(o=>p(o,t)).join("")}if(n==="$toLower"){let r=p(e[n],t);return r==null?r:String(r).toLowerCase()}if(n==="$toUpper"){let r=p(e[n],t);return r==null?r:String(r).toUpperCase()}if(n==="$substr"){let r=e[n];if(s(r)!=="array"||r.length<3)return"";let o=String(p(r[0],t)),a=Number(p(r[1],t))||0,f=Number(p(r[2],t))||0;return o.substr(a,f)}return!1};var w=Object.freeze({$eq:(e,t)=>e===t,$ne:(e,t)=>e!==t,$in:(e,t)=>s(t)!=="array"?!1:s(e)==="array"?e.some(i=>t.includes(i)):t.includes(e),$nin:(e,t)=>s(t)!=="array"?!1:s(e)==="array"?!e.some(i=>t.includes(i)):!t.includes(e),$exists:(e,t)=>e!==void 0===t,$size:(e,t)=>s(e)==="array"&&e.length===t,$all:(e,t)=>s(e)!=="array"||s(t)!=="array"?!1:t.every(i=>e.includes(i)),$elemMatch:(e,t)=>{if(s(e)!=="array"||s(t)!=="object")return!1;let i=Object.keys(t);return i.length===0?!1:e.some(n=>{if(s(n)!=="object")return!1;for(let r of i){let o=$(n,r);if(!j(o,t[r]))return!1}return!0})},$type:(e,t)=>s(t)==="array"?t.some(i=>s(e)===i):s(e)===t,$mod:(e,t)=>{if(s(e)!=="number"||s(t)!=="array"||t.length<2)return!1;let i=t[0],n=t[1];return s(i)!=="number"||s(n)!=="number"?!1:e%i===n},$lt:(e,t)=>s(e)==="date"&&s(t)==="date"?e.getTime()<t.getTime():s(e)!==s(t)?!1:e<t,$lte:(e,t)=>s(e)==="date"&&s(t)==="date"?e.getTime()<=t.getTime():s(e)!==s(t)?!1:e<=t,$gt:(e,t)=>s(e)==="date"&&s(t)==="date"?e.getTime()>t.getTime():s(e)!==s(t)?!1:e>t,$gte:(e,t)=>s(e)==="date"&&s(t)==="date"?e.getTime()>=t.getTime():s(e)!==s(t)?!1:e>=t,$regex:(e,t,i)=>{try{return new RegExp(t,i).test(String(e))}catch(n){return console.warn("[applyQuery] invalid $regex pattern:",t,"error:",n&&n.message),!1}}}),j=(e,t)=>{if(s(t)!=="object")return e===t;let i=Object.keys(t).filter(n=>Object.prototype.hasOwnProperty.call(w,n));return i.length===0?(console.warn("[applyQuery] no recognized operators in condition:",t),!1):i.every(n=>n==="$regex"?w[n](e,t[n],t.$options):w[n](e,t[n]))},b=(e,t)=>{if(s(t)!=="object")return!1;if(s(t.$and)==="array")return t.$and.every(i=>b(e,i));if(s(t.$or)==="array")return t.$or.some(i=>b(e,i));if(s(t.$not)==="object")return!b(e,t.$not);if(s(t.$nor)==="array")return!t.$nor.some(i=>b(e,i));if(t.$expr!==void 0)return!!g(t.$expr,e);for(let i of Object.keys(t)){let n=t[i],r=$(e,i);if((i==="$regex"||s(n)==="object"&&Object.prototype.hasOwnProperty.call(n,"$regex"))&&s(r)!=="string")return console.warn("[applyQuery] $regex used on non-string value, skipping match"),!1;if(!j(r,n))return!1}return!0},_=(e=[],t,i={})=>{let n=e||[];if(s(t)!=="object")return n;t.$and!==void 0&&s(t.$and)!=="array"&&console.warn("[applyQuery] $and should be an array, ignoring as combinator:",t.$and),t.$or!==void 0&&s(t.$or)!=="array"&&console.warn("[applyQuery] $or should be an array, ignoring as combinator:",t.$or),t.$nor!==void 0&&s(t.$nor)!=="array"&&console.warn("[applyQuery] $nor should be an array, ignoring as combinator:",t.$nor),t.$not!==void 0&&s(t.$not)!=="object"&&console.warn("[applyQuery] $not should be an object, ignoring as combinator:",t.$not);let r=i&&i.indexes;if(r&&s(r)==="object"){let o=Object.keys(t).filter(a=>!["$and","$or","$not","$nor"].includes(a));if(o.length===1){let a=o[0],f=t[a],u=s(f)!=="object"?f:Object.prototype.hasOwnProperty.call(f,"$eq")?f.$eq:void 0;if(u!==void 0&&r[a]instanceof Map)return(r[a].get(u)||[]).filter(h=>b(h,t))}}return n.filter(o=>b(o,t))};var E=(e,t)=>{let i=f=>s(f)==="string"?{path:f,preserveNull:!1}:s(f)==="object"?{path:f.path||f.$path||f.field,preserveNull:!!f.preserveNullAndEmptyArrays}:{path:void 0,preserveNull:!1},{path:n,preserveNull:r}=i(t);if(!n)return e;let o=n.startsWith("$")?n.slice(1):n,a=[];for(let f of e){let u=$(f??{},o);if(s(u)!=="array"){if(r){let d=y(f),c=o.split("."),l=S(d,c);l!=null&&(l[c[c.length-1]]=null),a.push(d)}continue}for(let d of u){let c=y(f),l=o.split("."),h=S(c,l);h!=null&&(h[l[l.length-1]]=d),a.push(c)}}return a},S=(e,t)=>{let i=e;for(let n of t.slice(0,-1)){if(i==null)return i;(!Object.prototype.hasOwnProperty.call(i,n)||s(i[n])!=="object")&&(i[n]={}),i=i[n]}return i},W=(e,t)=>{let i=new Map;for(let r of e){let o=t._id===null?null:s(t._id)==="string"&&t._id.startsWith("$")?$(r,t._id.slice(1)):s(t._id)==="object"?g(t._id,r):t._id,a=s(o)==="object"?JSON.stringify(o):String(o);if(!i.has(a)){let u={_id:o};for(let[d,c]of Object.entries(t)){if(d==="_id")continue;let l=Object.keys(c)[0];l==="$sum"?u[d]=0:l==="$push"?u[d]=[]:l==="$avg"?u[d]={sum:0,cnt:0}:l==="$max"||l==="$min"||l==="$first"||l==="$last"?u[d]=void 0:u[d]=null}i.set(a,u)}let f=i.get(a);for(let[u,d]of Object.entries(t)){if(u==="_id")continue;let c=Object.keys(d)[0],l=d[c];if(c==="$sum"){let h=s(l)==="number"?l:s(l)==="string"&&l.startsWith("$")?$(r,l.slice(1)):g(l,r);f[u]=(f[u]||0)+(Number(h)||0)}else if(c==="$push"){let h=s(l)==="string"&&l.startsWith("$")?$(r,l.slice(1)):g(l,r);f[u].push(h)}else if(c==="$avg"){let h=s(l)==="number"?l:s(l)==="string"&&l.startsWith("$")?$(r,l.slice(1)):g(l,r),m=Number(h);Number.isNaN(m)||(f[u].sum+=m,f[u].cnt+=1)}else if(c==="$max"){let h=s(l)==="string"&&l.startsWith("$")?$(r,l.slice(1)):g(l,r);(f[u]===void 0||h>f[u])&&(f[u]=h)}else if(c==="$min"){let h=s(l)==="string"&&l.startsWith("$")?$(r,l.slice(1)):g(l,r);(f[u]===void 0||h<f[u])&&(f[u]=h)}else if(c==="$first"){if(f[u]===void 0){let h=s(l)==="string"&&l.startsWith("$")?$(r,l.slice(1)):g(l,r);f[u]=h}}else if(c==="$last"){let h=s(l)==="string"&&l.startsWith("$")?$(r,l.slice(1)):g(l,r);f[u]=h}}}let n=[];for(let r of i.values()){for(let[o,a]of Object.entries(r)){let f=t[o];if(!f)continue;Object.keys(f)[0]==="$avg"&&(r[o]=a.cnt===0?null:a.sum/a.cnt)}n.push(r)}return n},R=(e,t)=>{if(s(t)!=="object")return e;let i=Object.keys(t);return e.slice().sort((n,r)=>{for(let o of i){let a=t[o]===-1?-1:1,f=$(n,o),u=$(r,o);if(!(f==null&&u==null)){if(f==null)return-1*a;if(u==null)return 1*a;if(f<u)return-1*a;if(f>u)return 1*a}}return 0})},I=(e,t)=>e.map(i=>{if(s(t)!=="object")return{...i};let n=Object.keys(t).some(o=>t[o]===1),r={};if(n){for(let[o,a]of Object.entries(t))if(a===1){let f=$(i,o);f!==void 0&&(r[o]=f)}else s(a)==="string"&&a.startsWith("$")?r[o]=$(i,a.slice(1)):s(a)==="object"&&(r[o]=g(a,i));return r}for(let o of Object.keys(i))r[o]=i[o];for(let[o,a]of Object.entries(t))a===0?delete r[o]:s(a)==="string"&&a.startsWith("$")?r[o]=$(i,a.slice(1)):s(a)==="object"&&(r[o]=g(a,i));return r}),V=(e,t)=>{let i=Math.max(0,parseInt(t,10)||0);return e.slice(0,i)},P=(e=[],t=[])=>{let i=s(e)==="array"?e.slice():[];return t.reduce((n,r)=>{let o=Object.keys(r)[0],a=r[o];return o==="$match"?_(n,a):o==="$unwind"?E(n,a):o==="$group"?W(n,a):o==="$sort"?R(n,a):o==="$project"?I(n,a):o==="$limit"?V(n,a):n},i)};var v=(e,t,i)=>{let n=t.split("."),r=n[n.length-1],o=n.slice(0,-1).reduce((a,f)=>a==null?a:((!Object.prototype.hasOwnProperty.call(a,f)||s(a[f])!=="object")&&(a[f]={}),a[f]),e);o!=null&&(o[r]=i)},O=(e,t)=>t.split(".").reduce((n,r)=>{if(!(n==null||!Object.prototype.hasOwnProperty.call(n,r)))return n[r]},e),N=(e,t,i=[])=>{if(!e||s(e)!=="object")return i;if(s(e.$and)==="array"){for(let n of e.$and)N(n,t,i);return i}for(let n of Object.keys(e))if(!(n==="$and"||n==="$or"||n==="$not"||n==="$nor")&&(n===t&&e[n]&&s(e[n])==="object"&&Object.prototype.hasOwnProperty.call(e[n],"$elemMatch")&&i.push({type:"elemMatch",cond:e[n].$elemMatch}),n.startsWith(t+"."))){let r=n.slice(t.length+1);i.push({type:"subfield",subfield:r,cond:e[n]})}return i},D=(e,t)=>{let i=N(e,t);return i.length===0?null:n=>{for(let r of i)if(r.type==="elemMatch"){if(s(r.cond)!=="object")return!1;let o=Object.keys(r.cond);if(o.length===0)return!1;for(let a of o){let f=$(n,a);if(!j(f,r.cond[a]))return!1}}else if(r.type==="subfield"){let o=$(n,r.subfield);if(!j(o,r.cond))return!1}return!0}},Q=(e,t)=>{if(!t||s(t)!=="object")return!1;let i=Object.keys(t);if(i.length===0)return!1;for(let n of i){let r=$(e,n);if(!j(r,t[n]))return!1}return!0},U=(e={},t,i=null)=>{if(!t||s(t)!=="object")return{...e};let n=Object.keys(t),r=n.some(u=>t[u]===0),a=n.some(u=>{let d=t[u];return d===1?!0:s(d)==="object"?Object.prototype.hasOwnProperty.call(d,"$slice")||Object.prototype.hasOwnProperty.call(d,"$elemMatch"):!1})?"include":"exclude",f={};if(a==="include"){for(let u of n){if(u==="_id"&&t._id===0)continue;let d=t[u];if(u.endsWith(".$")){let c=u.slice(0,-2),l=O(e,c);if(s(l)==="array"){let h=D(i,c);if(h){let m=l.find(T=>h(T));m!==void 0&&v(f,c,[m])}}continue}if(d===1){let c=O(e,u);c!==void 0&&v(f,u,c)}else if(s(d)==="object"&&Object.prototype.hasOwnProperty.call(d,"$elemMatch")){let c=O(e,u);if(s(c)==="array"){let l=c.find(h=>Q(h,d.$elemMatch));l!==void 0&&v(f,u,[l])}}else if(s(d)==="object"&&Object.prototype.hasOwnProperty.call(d,"$slice")){let c=O(e,u);if(c!==void 0){let l=d.$slice,h=s(c)==="array"?s(l)!=="number"||l===0?[]:l>0?c.slice(0,l):c.slice(l):c;v(f,u,h)}}}return t._id!==0&&Object.prototype.hasOwnProperty.call(e,"_id")&&(f._id=e._id),f}for(let u of Object.keys(e))f[u]=e[u];for(let u of n)if(t[u]===0){let c=u.split(".");if(c.length===1)delete f[u];else{let l=c.pop(),h=c.join("."),m=O(f,h);m&&Object.prototype.hasOwnProperty.call(m,l)&&delete m[l]}}return f},C=(e=[],t,i=null)=>s(e)!=="array"?e:!t||s(t)!=="object"?e.map(n=>({...n})):e.map(n=>U(n,t,i));var k=class e{constructor(t=[],i={},n=null){this._items=t||[],this._query=i||{},this._projection=n||null,this._sortSpec=null,this._skip=0,this._limit=null}sort(t={}){return this._sortSpec=t&&s(t)==="object"?t:null,this}project(t=null){return this._projection=t&&s(t)==="object"?t:this._projection,this}skip(t=0){return this._skip=Math.max(0,parseInt(String(t),10)||0),this}limit(t){return t==null?this.toArray():(this._limit=Math.max(0,parseInt(String(t),10)||0),this)}toArray(){let t=_(this._items,this._query),i=this._sortSpec?(()=>{let a=Object.keys(this._sortSpec);return t.slice().sort((f,u)=>{for(let d of a){let c=this._sortSpec[d]===-1?-1:1,l=$(f,d),h=$(u,d);if(!(l==null&&h==null)){if(l==null)return-1*c;if(h==null)return 1*c;if(l<h)return-1*c;if(l>h)return 1*c}}return 0})})():t,n=this._skip&&this._skip>0?i.slice(this._skip):i,r=this._limit!=null?n.slice(0,this._limit):n;return this._projection?C(r,this._projection,this._query):r}static from(t,i={},n=null){return new e(t,i,n)}};var M=class{constructor(t=[]){if(s(t)!=="array")throw new TypeError("Items must be an array of objects");this._items=t}find(t={},i){return k.from(this._items,t,i)}findOne(t={},i){let n=this.find(t,i).toArray();return n.length>0?n[0]:null}count(t={}){return this.find(t).toArray().length}exists(t={}){return this.find(t).toArray().length>0}distinct(t){if(!t)return[];let i=new Set;for(let n of this._items){let r=s(t)==="string"&&t.startsWith("$")?$(n,t.slice(1)):$(n,t);r!==void 0&&i.add(r)}return Array.from(i)}aggregate(t=[]){return P(this._items,t)}toArray(){return s(this._items)==="array"?[...this._items]:[]}};export{M as Qar};

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "qarjs",
+  "version": "0.8.2",
+  "description": "MongoDB-like queries for JavaScript arrays",
+  "keywords": [
+    "query",
+    "array",
+    "mongodb",
+    "filter",
+    "json"
+  ],
+  "author": {
+    "name": "Zsolt Tovis",
+    "email": "tovis.zsolt@gmail.com",
+    "url": "https://toviszsolt.github.io/"
+  },
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/toviszsolt"
+    },
+    {
+      "type": "paypal",
+      "url": "https://www.paypal.com/paypalme/toviszsolt"
+    }
+  ],
+  "homepage": "https://github.com/toviszsolt/qar",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/toviszsolt/qar.git"
+  },
+  "bugs": {
+    "url": "https://github.com/toviszsolt/qar/issues"
+  },
+  "type": "module",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist/*"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/qar.d.ts",
+      "import": "./dist/qar.js",
+      "require": "./dist/qar.cjs"
+    }
+  },
+  "scripts": {
+    "watch": "node build.js --watch",
+    "build": "jest --verbose ./test && node build.js",
+    "test": "jest --verbose ./test",
+    "coverage": "jest --collect-coverage",
+    "coverage:open": "(start ./coverage/lcov-report/index.html || open ./coverage/lcov-report/index.html || xdg-open ./coverage/lcov-report/index.html)"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "esbuild": "^0.27.3",
+    "jest": "^30.2.0",
+    "jest-esbuild": "^0.4.0"
+  }
+}