inqjs 1.0.0 → 1.0.1

package/README.md

@@ -1,5 +1,9 @@
 # inqjs (Integrated Query for JavaScript)
 
+[![npm version](https://badge.fury.io/js/inqjs.svg)](https://www.npmjs.com/package/inqjs)
+[![npm downloads](https://img.shields.io/npm/dm/inqjs.svg)](https://www.npmjs.com/package/inqjs)
+[![license](https://img.shields.io/npm/l/inqjs.svg)](https://github.com/ptp28/inqjs/blob/main/LICENSE)
+
 A lightweight, dependency-free LINQ engine for TypeScript and JavaScript with comprehensive query capabilities.
 
 > **Note**: This project was developed with heavy assistance from AI (Google Gemini), demonstrating modern AI-powered software development workflows.

package/dist/{src/Query.js → Query.js}

@@ -18,6 +18,12 @@ const first_1 = require("./operators/first");
 const toArray_1 = require("./operators/toArray");
 const take_1 = require("./operators/take");
 const count_1 = require("./operators/count");
+const append_1 = require("./operators/append");
+const prepend_1 = require("./operators/prepend");
+const concat_1 = require("./operators/concat");
+const union_1 = require("./operators/union");
+const intersect_1 = require("./operators/intersect");
+const except_1 = require("./operators/except");
 const AsyncQuery_1 = require("./async/AsyncQuery");
 class Query {
     constructor(source) {
@@ -100,6 +106,34 @@ class Query {
             (0, guards_1.assertFunction)(predicate, 'predicate');
         return (0, count_1.count)(this._source, predicate);
     }
+    append(element) {
+        return new Query((0, append_1.append)(this._source, element));
+    }
+    prepend(element) {
+        return new Query((0, prepend_1.prepend)(this._source, element));
+    }
+    concat(other) {
+        (0, guards_1.assertIterable)(other, 'other');
+        return new Query((0, concat_1.concat)(this._source, other));
+    }
+    union(other, keySelector = comparers_1.identity) {
+        (0, guards_1.assertIterable)(other, 'other');
+        if (keySelector !== undefined)
+            (0, guards_1.assertFunction)(keySelector, 'keySelector');
+        return new Query((0, union_1.union)(this._source, other, keySelector));
+    }
+    intersect(other, keySelector = comparers_1.identity) {
+        (0, guards_1.assertIterable)(other, 'other');
+        if (keySelector !== undefined)
+            (0, guards_1.assertFunction)(keySelector, 'keySelector');
+        return new Query((0, intersect_1.intersect)(this._source, other, keySelector));
+    }
+    except(other, keySelector = comparers_1.identity) {
+        (0, guards_1.assertIterable)(other, 'other');
+        if (keySelector !== undefined)
+            (0, guards_1.assertFunction)(keySelector, 'keySelector');
+        return new Query((0, except_1.except)(this._source, other, keySelector));
+    }
     toAsync() {
         return AsyncQuery_1.AsyncQuery.from(this._source);
     }
@@ -113,3 +147,4 @@ var fromJson_1 = require("./json/fromJson");
 Object.defineProperty(exports, "fromJson", { enumerable: true, get: function () { return fromJson_1.fromJson; } });
 Object.defineProperty(exports, "fromJsonArray", { enumerable: true, get: function () { return fromJson_1.fromJsonArray; } });
 Object.defineProperty(exports, "fromJsonObject", { enumerable: true, get: function () { return fromJson_1.fromJsonObject; } });
+//# sourceMappingURL=Query.js.map

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "inqjs",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "A lightweight, dependency-free LINQ engine for TypeScript and JavaScript with comprehensive query capabilities",
-  "main": "dist/src/Query.js",
-  "types": "dist/src/Query.d.ts",
+  "main": "dist/Query.js",
+  "types": "dist/Query.d.ts",
   "files": [
     "dist/src/**/*",
     "README.md",

package/dist/src/async/AsyncQuery.js

@@ -1,107 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AsyncQuery = void 0;
-exports.fromAsync = fromAsync;
-const guards_1 = require("../utils/guards");
-const comparers_1 = require("../utils/comparers");
-const whereAsync_1 = require("./operators/whereAsync");
-const selectAsync_1 = require("./operators/selectAsync");
-const orderByAsync_1 = require("./operators/orderByAsync");
-const skipAsync_1 = require("./operators/skipAsync");
-const distinctAsync_1 = require("./operators/distinctAsync");
-const anyAsync_1 = require("./operators/anyAsync");
-const allAsync_1 = require("./operators/allAsync");
-const sumAsync_1 = require("./operators/sumAsync");
-const minAsync_1 = require("./operators/minAsync");
-const maxAsync_1 = require("./operators/maxAsync");
-const firstAsync_1 = require("./operators/firstAsync");
-const toArrayAsync_1 = require("./operators/toArrayAsync");
-const takeAsync_1 = require("./operators/takeAsync");
-const countAsync_1 = require("./operators/countAsync");
-class AsyncQuery {
-    constructor(source) {
-        this._source = source;
-    }
-    [Symbol.asyncIterator]() {
-        return this._source[Symbol.asyncIterator]();
-    }
-    static from(source) {
-        async function* wrap(src) {
-            for await (const item of src) {
-                yield item;
-            }
-        }
-        return new AsyncQuery(wrap(source));
-    }
-    where(predicate) {
-        (0, guards_1.assertFunction)(predicate, 'predicate');
-        return new AsyncQuery((0, whereAsync_1.whereAsync)(this._source, predicate));
-    }
-    select(selector) {
-        (0, guards_1.assertFunction)(selector, 'selector');
-        return new AsyncQuery((0, selectAsync_1.selectAsync)(this._source, selector));
-    }
-    orderBy(keySelector = comparers_1.identity, comparer = comparers_1.defaultComparer) {
-        if (keySelector !== undefined)
-            (0, guards_1.assertFunction)(keySelector, 'keySelector');
-        if (comparer !== undefined)
-            (0, guards_1.assertFunction)(comparer, 'comparer');
-        return new AsyncQuery((0, orderByAsync_1.orderByAsync)(this._source, keySelector, comparer));
-    }
-    skip(count) {
-        (0, guards_1.assertInteger)(count, 'count');
-        (0, guards_1.assertNonNegative)(count, 'count');
-        return new AsyncQuery((0, skipAsync_1.skipAsync)(this._source, count));
-    }
-    distinct(keySelector = comparers_1.identity) {
-        if (keySelector !== undefined)
-            (0, guards_1.assertFunction)(keySelector, 'keySelector');
-        return new AsyncQuery((0, distinctAsync_1.distinctAsync)(this._source, keySelector));
-    }
-    any(predicate) {
-        if (predicate !== undefined)
-            (0, guards_1.assertFunction)(predicate, 'predicate');
-        return (0, anyAsync_1.anyAsync)(this._source, predicate);
-    }
-    all(predicate) {
-        (0, guards_1.assertFunction)(predicate, 'predicate');
-        return (0, allAsync_1.allAsync)(this._source, predicate);
-    }
-    sum(selector = comparers_1.identity) {
-        if (selector !== undefined)
-            (0, guards_1.assertFunction)(selector, 'selector');
-        return (0, sumAsync_1.sumAsync)(this._source, selector);
-    }
-    min(selector = comparers_1.identity) {
-        if (selector !== undefined)
-            (0, guards_1.assertFunction)(selector, 'selector');
-        return (0, minAsync_1.minAsync)(this._source, selector);
-    }
-    max(selector = comparers_1.identity) {
-        if (selector !== undefined)
-            (0, guards_1.assertFunction)(selector, 'selector');
-        return (0, maxAsync_1.maxAsync)(this._source, selector);
-    }
-    first(predicate) {
-        if (predicate !== undefined)
-            (0, guards_1.assertFunction)(predicate, 'predicate');
-        return (0, firstAsync_1.firstAsync)(this._source, predicate);
-    }
-    toArray() {
-        return (0, toArrayAsync_1.toArrayAsync)(this._source);
-    }
-    take(count) {
-        (0, guards_1.assertInteger)(count, 'count');
-        (0, guards_1.assertNonNegative)(count, 'count');
-        return new AsyncQuery((0, takeAsync_1.takeAsync)(this._source, count));
-    }
-    count(predicate) {
-        if (predicate !== undefined)
-            (0, guards_1.assertFunction)(predicate, 'predicate');
-        return (0, countAsync_1.countAsync)(this._source, predicate);
-    }
-}
-exports.AsyncQuery = AsyncQuery;
-function fromAsync(source) {
-    return AsyncQuery.from(source);
-}

package/dist/src/async/operators/allAsync.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.allAsync = allAsync;
-async function allAsync(source, predicate) {
-    for await (const item of source) {
-        if (!(await predicate(item))) {
-            return false;
-        }
-    }
-    return true;
-}

package/dist/src/async/operators/anyAsync.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.anyAsync = anyAsync;
-async function anyAsync(source, predicate) {
-    if (predicate) {
-        for await (const item of source) {
-            if (await predicate(item)) {
-                return true;
-            }
-        }
-        return false;
-    }
-    // If no predicate, check if source has any elements
-    const iterator = source[Symbol.asyncIterator]();
-    const result = await iterator.next();
-    return !result.done;
-}

package/dist/src/async/operators/countAsync.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.countAsync = countAsync;
-async function countAsync(source, predicate) {
-    let count = 0;
-    for await (const item of source) {
-        if (!predicate || await predicate(item)) {
-            count++;
-        }
-    }
-    return count;
-}

package/dist/src/async/operators/distinctAsync.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.distinctAsync = distinctAsync;
-async function* distinctAsync(source, keySelector) {
-    const seen = new Set();
-    for await (const item of source) {
-        const key = await keySelector(item);
-        if (!seen.has(key)) {
-            seen.add(key);
-            yield item;
-        }
-    }
-}

package/dist/src/async/operators/firstAsync.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.firstAsync = firstAsync;
-async function firstAsync(source, predicate) {
-    if (predicate) {
-        for await (const item of source) {
-            if (await predicate(item)) {
-                return item;
-            }
-        }
-    }
-    else {
-        const iterator = source[Symbol.asyncIterator]();
-        const result = await iterator.next();
-        if (!result.done) {
-            return result.value;
-        }
-    }
-    throw new Error('Sequence contains no matching element.');
-}

package/dist/src/async/operators/maxAsync.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.maxAsync = maxAsync;
-async function maxAsync(source, selector) {
-    let maxValue;
-    for await (const item of source) {
-        const value = await selector(item);
-        if (typeof value !== 'number' || !Number.isFinite(value)) {
-            throw new TypeError('maxAsync: value must be a finite number.');
-        }
-        if (maxValue === undefined || value > maxValue) {
-            maxValue = value;
-        }
-    }
-    return maxValue;
-}

package/dist/src/async/operators/minAsync.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.minAsync = minAsync;
-async function minAsync(source, selector) {
-    let minValue;
-    for await (const item of source) {
-        const value = await selector(item);
-        if (typeof value !== 'number' || !Number.isFinite(value)) {
-            throw new TypeError('minAsync: value must be a finite number.');
-        }
-        if (minValue === undefined || value < minValue) {
-            minValue = value;
-        }
-    }
-    return minValue;
-}

package/dist/src/async/operators/orderByAsync.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.orderByAsync = orderByAsync;
-async function* orderByAsync(source, keySelector, comparer) {
-    const buffer = [];
-    for await (const item of source) {
-        buffer.push(item);
-    }
-    // We need to resolve keys for all items to sort them
-    const itemsWithKeys = await Promise.all(buffer.map(async (item) => ({
-        item,
-        key: await keySelector(item),
-    })));
-    itemsWithKeys.sort((a, b) => comparer(a.key, b.key));
-    for (const { item } of itemsWithKeys) {
-        yield item;
-    }
-}

package/dist/src/async/operators/selectAsync.js

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.selectAsync = selectAsync;
-async function* selectAsync(source, selector) {
-    let index = 0;
-    for await (const item of source) {
-        yield await selector(item, index++);
-    }
-}

package/dist/src/async/operators/skipAsync.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.skipAsync = skipAsync;
-async function* skipAsync(source, count) {
-    let skipped = 0;
-    for await (const item of source) {
-        if (skipped < count) {
-            skipped++;
-            continue;
-        }
-        yield item;
-    }
-}

package/dist/src/async/operators/sumAsync.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.sumAsync = sumAsync;
-async function sumAsync(source, selector) {
-    let total = 0;
-    for await (const item of source) {
-        const value = await selector(item);
-        if (typeof value !== 'number' || !Number.isFinite(value)) {
-            throw new TypeError('sumAsync: value must be a finite number.');
-        }
-        total += value;
-    }
-    return total;
-}

package/dist/src/async/operators/takeAsync.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.takeAsync = takeAsync;
-async function* takeAsync(source, count) {
-    let taken = 0;
-    for await (const item of source) {
-        if (taken >= count)
-            break;
-        yield item;
-        taken++;
-    }
-}

package/dist/src/async/operators/toArrayAsync.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.toArrayAsync = toArrayAsync;
-async function toArrayAsync(source) {
-    const result = [];
-    for await (const item of source) {
-        result.push(item);
-    }
-    return result;
-}

package/dist/src/async/operators/whereAsync.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.whereAsync = whereAsync;
-async function* whereAsync(source, predicate) {
-    let index = 0;
-    for await (const item of source) {
-        if (await predicate(item, index++)) {
-            yield item;
-        }
-    }
-}

package/dist/src/json/fromJson.js

@@ -1,48 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.fromJson = fromJson;
-exports.fromJsonArray = fromJsonArray;
-exports.fromJsonObject = fromJsonObject;
-const Query_1 = require("../Query");
-/**
- * Parse a JSON string and return a Query over the result.
- * - If the JSON is an array, returns a Query over the array elements.
- * - If the JSON is an object, returns a Query over the object's entries as [key, value] tuples.
- * - For primitive values, wraps them in a single-element array.
- */
-function fromJson(jsonString) {
-    const parsed = JSON.parse(jsonString);
-    if (Array.isArray(parsed)) {
-        return Query_1.Query.from(parsed);
-    }
-    else if (parsed !== null && typeof parsed === 'object') {
-        return Query_1.Query.from(Object.entries(parsed));
-    }
-    else {
-        // Primitive value - wrap in array
-        return Query_1.Query.from([parsed]);
-    }
-}
-/**
- * Parse a JSON string as an array and return a Query over its elements.
- * Throws if the JSON is not an array.
- */
-function fromJsonArray(jsonString) {
-    const parsed = JSON.parse(jsonString);
-    if (!Array.isArray(parsed)) {
-        throw new TypeError('JSON value is not an array');
-    }
-    return Query_1.Query.from(parsed);
-}
-/**
- * Parse a JSON string as an object and return a Query over its entries.
- * Each entry is a [key, value] tuple.
- * Throws if the JSON is not an object.
- */
-function fromJsonObject(jsonString) {
-    const parsed = JSON.parse(jsonString);
-    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
-        throw new TypeError('JSON value is not an object');
-    }
-    return Query_1.Query.from(Object.entries(parsed));
-}

package/dist/src/operators/all.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.all = all;
-function all(source, predicate) {
-    for (const item of source) {
-        if (!predicate(item)) {
-            return false;
-        }
-    }
-    return true;
-}

package/dist/src/operators/any.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.any = any;
-function any(source, predicate) {
-    if (predicate) {
-        for (const item of source) {
-            if (predicate(item)) {
-                return true;
-            }
-        }
-        return false;
-    }
-    // If no predicate, check if source has any elements
-    const iterator = source[Symbol.iterator]();
-    return !iterator.next().done;
-}

package/dist/src/operators/count.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.count = count;
-function count(source, predicate) {
-    let count = 0;
-    for (const item of source) {
-        if (!predicate || predicate(item)) {
-            count++;
-        }
-    }
-    return count;
-}

package/dist/src/operators/distinct.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.distinct = distinct;
-function* distinct(source, keySelector) {
-    const seen = new Set();
-    for (const item of source) {
-        const key = keySelector(item);
-        if (!seen.has(key)) {
-            seen.add(key);
-            yield item;
-        }
-    }
-}

package/dist/src/operators/first.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.first = first;
-function first(source, predicate) {
-    if (predicate) {
-        for (const item of source) {
-            if (predicate(item)) {
-                return item;
-            }
-        }
-    }
-    else {
-        const iterator = source[Symbol.iterator]();
-        const result = iterator.next();
-        if (!result.done) {
-            return result.value;
-        }
-    }
-    throw new Error('Sequence contains no matching element.');
-}

package/dist/src/operators/max.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.max = max;
-function max(source, selector) {
-    let maxValue;
-    for (const item of source) {
-        const value = selector(item);
-        if (typeof value !== 'number' || !Number.isFinite(value)) {
-            throw new TypeError('max: value must be a finite number.');
-        }
-        if (maxValue === undefined || value > maxValue) {
-            maxValue = value;
-        }
-    }
-    return maxValue;
-}

package/dist/src/operators/min.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.min = min;
-function min(source, selector) {
-    let minValue;
-    for (const item of source) {
-        const value = selector(item);
-        if (typeof value !== 'number' || !Number.isFinite(value)) {
-            throw new TypeError('min: value must be a finite number.');
-        }
-        if (minValue === undefined || value < minValue) {
-            minValue = value;
-        }
-    }
-    return minValue;
-}

package/dist/src/operators/orderBy.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.orderBy = orderBy;
-function* orderBy(source, keySelector, comparer) {
-    const buffer = Array.from(source);
-    buffer.sort((a, b) => {
-        const keyA = keySelector(a);
-        const keyB = keySelector(b);
-        return comparer(keyA, keyB);
-    });
-    for (const item of buffer) {
-        yield item;
-    }
-}

package/dist/src/operators/select.js

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.select = select;
-function* select(source, selector) {
-    let index = 0;
-    for (const item of source) {
-        yield selector(item, index++);
-    }
-}

package/dist/src/operators/skip.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.skip = skip;
-function* skip(source, count) {
-    let skipped = 0;
-    for (const item of source) {
-        if (skipped < count) {
-            skipped++;
-            continue;
-        }
-        yield item;
-    }
-}

package/dist/src/operators/sum.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.sum = sum;
-function sum(source, selector) {
-    let total = 0;
-    for (const item of source) {
-        const value = selector(item);
-        if (typeof value !== 'number' || !Number.isFinite(value)) {
-            throw new TypeError('sum: value must be a finite number.');
-        }
-        total += value;
-    }
-    return total;
-}

package/dist/src/operators/take.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.take = take;
-function* take(source, count) {
-    let taken = 0;
-    for (const item of source) {
-        if (taken >= count)
-            break;
-        yield item;
-        taken++;
-    }
-}

package/dist/src/operators/toArray.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.toArray = toArray;
-function toArray(source) {
-    return Array.from(source);
-}

package/dist/src/operators/where.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.where = where;
-function* where(source, predicate) {
-    let index = 0;
-    for (const item of source) {
-        if (predicate(item, index++)) {
-            yield item;
-        }
-    }
-}

package/dist/src/utils/comparers.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultComparer = defaultComparer;
-exports.identity = identity;
-function defaultComparer(a, b) {
-    if (a === b)
-        return 0;
-    if (a === null || a === undefined)
-        return -1;
-    if (b === null || b === undefined)
-        return 1;
-    if (a < b)
-        return -1;
-    if (a > b)
-        return 1;
-    return 0;
-}
-function identity(item) {
-    return item;
-}

package/dist/src/utils/guards.js

@@ -1,34 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isIterable = isIterable;
-exports.isFunction = isFunction;
-exports.assertIterable = assertIterable;
-exports.assertFunction = assertFunction;
-exports.assertInteger = assertInteger;
-exports.assertNonNegative = assertNonNegative;
-function isIterable(obj) {
-    return obj != null && typeof obj[Symbol.iterator] === 'function';
-}
-function isFunction(obj) {
-    return typeof obj === 'function';
-}
-function assertIterable(source, name = 'source') {
-    if (!isIterable(source)) {
-        throw new TypeError(`${name} must be an iterable.`);
-    }
-}
-function assertFunction(fn, name) {
-    if (!isFunction(fn)) {
-        throw new TypeError(`${name} must be a function.`);
-    }
-}
-function assertInteger(num, name) {
-    if (typeof num !== 'number' || !Number.isFinite(num) || !Number.isInteger(num)) {
-        throw new TypeError(`${name} must be a finite integer.`);
-    }
-}
-function assertNonNegative(num, name) {
-    if (num < 0) {
-        throw new TypeError(`${name} must be non-negative.`);
-    }
-}