@furystack/core 15.1.0 → 15.2.1

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## [15.2.1] - 2026-02-26
+
+### 📝 Documentation
+
+- Added JSDoc recommendations to `PhysicalStore` and `StoreManager.getStoreFor()` pointing to `DataSet` as the preferred write gateway for application-level code
+
+## [15.2.0] - 2026-02-22
+
+### ✨ Features
+
+### Public `filterItems()` function
+
+Extracted the filter logic from `InMemoryStore` into a standalone `filterItems()` function, now exported from `@furystack/core`. This allows consumers to filter arrays using `FilterType` expressions without needing a store instance.
+
+**Usage:**
+
+```typescript
+import { filterItems } from '@furystack/core'
+
+const results = filterItems(myArray, {
+  name: { $startsWith: 'foo' },
+  age: { $gte: 18 },
+})
+```
+
+### ♻️ Refactoring
+
+- `InMemoryStore` now delegates to the public `filterItems()` function internally instead of using a private method
+
 ## [15.1.0] - 2026-02-19
 
 ### ✨ Features

package/esm/filter-items.d.ts

@@ -0,0 +1,11 @@
+import type { FilterType } from './models/physical-store.js';
+/**
+ * Filters an array of items using a {@link FilterType} expression.
+ * Supports field-level operators ($eq, $ne, $in, $nin, $gt, $gte, $lt, $lte, $startsWith, $endsWith, $like, $regex)
+ * and logical operators ($and, $or).
+ * @param values The array of items to filter
+ * @param filter The filter expression to apply
+ * @returns The filtered array of items
+ */
+export declare function filterItems<T>(values: T[], filter?: FilterType<T>): T[];
+//# sourceMappingURL=filter-items.d.ts.map

package/esm/filter-items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-items.d.ts","sourceRoot":"","sources":["../src/filter-items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAyB5D;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAkHvE"}

package/esm/filter-items.js

@@ -0,0 +1,130 @@
+import { isLogicalOperator, isOperator } from './models/physical-store.js';
+const escapeRegexMeta = (str) => str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+const evaluateLike = (value, likeString) => {
+    const likeRegex = `^${likeString.split('%').map(escapeRegexMeta).join('.*')}$`;
+    return value.match(new RegExp(likeRegex, 'i'));
+};
+/**
+ * Filters an array of items using a {@link FilterType} expression.
+ * Supports field-level operators ($eq, $ne, $in, $nin, $gt, $gte, $lt, $lte, $startsWith, $endsWith, $like, $regex)
+ * and logical operators ($and, $or).
+ * @param values The array of items to filter
+ * @param filter The filter expression to apply
+ * @returns The filtered array of items
+ */
+export function filterItems(values, filter) {
+    if (!filter) {
+        return values;
+    }
+    return values.filter((item) => {
+        const filterRecord = filter;
+        const itemRecord = item;
+        for (const key in filterRecord) {
+            if (isLogicalOperator(key)) {
+                const filterValue = filterRecord[key];
+                switch (key) {
+                    case '$and':
+                        if (filterValue.some((v) => !filterItems([item], v).length)) {
+                            return false;
+                        }
+                        break;
+                    case '$or':
+                        if (filterValue.some((v) => filterItems([item], v).length)) {
+                            break;
+                        }
+                        return false;
+                    default:
+                        throw new Error(`The logical operation '${key}' is not a valid operation`);
+                }
+            }
+            else {
+                const fieldFilter = filterRecord[key];
+                if (typeof fieldFilter === 'object' && fieldFilter !== null) {
+                    for (const filterKey in fieldFilter) {
+                        if (isOperator(filterKey)) {
+                            const itemValue = itemRecord[key];
+                            const filterValue = fieldFilter[filterKey];
+                            switch (filterKey) {
+                                case '$eq':
+                                    if (filterValue !== itemValue) {
+                                        return false;
+                                    }
+                                    break;
+                                case '$ne':
+                                    if (filterValue === itemValue) {
+                                        return false;
+                                    }
+                                    break;
+                                case '$in':
+                                    if (!filterValue.includes(itemValue)) {
+                                        return false;
+                                    }
+                                    break;
+                                case '$nin':
+                                    if (filterValue.includes(itemValue)) {
+                                        return false;
+                                    }
+                                    break;
+                                case '$lt':
+                                    if (itemValue < filterValue) {
+                                        break;
+                                    }
+                                    return false;
+                                case '$lte':
+                                    if (itemValue <= filterValue) {
+                                        break;
+                                    }
+                                    return false;
+                                case '$gt':
+                                    if (itemValue > filterValue) {
+                                        break;
+                                    }
+                                    return false;
+                                case '$gte':
+                                    if (itemValue >= filterValue) {
+                                        break;
+                                    }
+                                    return false;
+                                case '$regex':
+                                    try {
+                                        if (!new RegExp(filterValue).test(String(itemValue))) {
+                                            return false;
+                                        }
+                                    }
+                                    catch (e) {
+                                        throw new Error(`Invalid regular expression for $regex filter on field '${key}': ${e.message}`, { cause: e });
+                                    }
+                                    break;
+                                case '$startsWith':
+                                    if (!itemValue.startsWith(filterValue)) {
+                                        return false;
+                                    }
+                                    break;
+                                case '$endsWith':
+                                    if (!itemValue.endsWith(filterValue)) {
+                                        return false;
+                                    }
+                                    break;
+                                case '$like':
+                                    if (!evaluateLike(itemValue, filterValue)) {
+                                        return false;
+                                    }
+                                    break;
+                                default:
+                                    throw new Error(`The expression (${filterKey}) is not a supported filter operation`);
+                            }
+                        }
+                        else {
+                            throw new Error(`The filter key '${filterKey}' is not a valid operation`);
+                        }
+                    }
+                }
+                else {
+                    throw new Error(`The filter has to be an object, got ${typeof fieldFilter} for field '${key}'`);
+                }
+            }
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=filter-items.js.map

package/esm/filter-items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-items.js","sourceRoot":"","sources":["../src/filter-items.ts"],"names":[],"mappings":"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"}

package/esm/filter-items.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=filter-items.spec.d.ts.map

package/esm/filter-items.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-items.spec.d.ts","sourceRoot":"","sources":["../src/filter-items.spec.ts"],"names":[],"mappings":""}

package/esm/filter-items.spec.js

@@ -0,0 +1,174 @@
+import { describe, it, expect } from 'vitest';
+import { filterItems } from './filter-items.js';
+const items = [
+    { id: 1, name: 'Alice', age: 30, active: true },
+    { id: 2, name: 'Bob', age: 25, active: false },
+    { id: 3, name: 'Charlie', age: 35, active: true },
+    { id: 4, name: 'Diana', age: 28, active: false },
+    { id: 5, name: 'Eve', age: 22, active: true },
+];
+describe('filterItems', () => {
+    describe('no filter', () => {
+        it('should return all items when filter is undefined', () => {
+            expect(filterItems(items, undefined)).toEqual(items);
+        });
+        it('should return all items when filter is not provided', () => {
+            expect(filterItems(items)).toEqual(items);
+        });
+        it('should return an empty array when input is empty', () => {
+            expect(filterItems([], { name: { $eq: 'Alice' } })).toEqual([]);
+        });
+        it('should return all items when filter is an empty object', () => {
+            expect(filterItems(items, {})).toEqual(items);
+        });
+    });
+    describe('$eq', () => {
+        it('should return items matching the exact value', () => {
+            const result = filterItems(items, { name: { $eq: 'Alice' } });
+            expect(result).toEqual([items[0]]);
+        });
+        it('should return empty array when no items match', () => {
+            const result = filterItems(items, { name: { $eq: 'Nobody' } });
+            expect(result).toEqual([]);
+        });
+    });
+    describe('$ne', () => {
+        it('should return items not matching the value', () => {
+            const result = filterItems(items, { name: { $ne: 'Alice' } });
+            expect(result).toEqual([items[1], items[2], items[3], items[4]]);
+        });
+    });
+    describe('$in', () => {
+        it('should return items whose value is in the array', () => {
+            const result = filterItems(items, { name: { $in: ['Alice', 'Bob'] } });
+            expect(result).toEqual([items[0], items[1]]);
+        });
+        it('should return empty array when no values match', () => {
+            const result = filterItems(items, { name: { $in: ['Nobody'] } });
+            expect(result).toEqual([]);
+        });
+    });
+    describe('$nin', () => {
+        it('should return items whose value is not in the array', () => {
+            const result = filterItems(items, { name: { $nin: ['Alice', 'Bob'] } });
+            expect(result).toEqual([items[2], items[3], items[4]]);
+        });
+    });
+    describe('$gt', () => {
+        it('should return items with value greater than the threshold', () => {
+            const result = filterItems(items, { age: { $gt: 30 } });
+            expect(result).toEqual([items[2]]);
+        });
+        it('should exclude items equal to the threshold', () => {
+            const result = filterItems(items, { age: { $gt: 35 } });
+            expect(result).toEqual([]);
+        });
+    });
+    describe('$gte', () => {
+        it('should return items with value greater than or equal to the threshold', () => {
+            const result = filterItems(items, { age: { $gte: 30 } });
+            expect(result).toEqual([items[0], items[2]]);
+        });
+    });
+    describe('$lt', () => {
+        it('should return items with value less than the threshold', () => {
+            const result = filterItems(items, { age: { $lt: 25 } });
+            expect(result).toEqual([items[4]]);
+        });
+        it('should exclude items equal to the threshold', () => {
+            const result = filterItems(items, { age: { $lt: 22 } });
+            expect(result).toEqual([]);
+        });
+    });
+    describe('$lte', () => {
+        it('should return items with value less than or equal to the threshold', () => {
+            const result = filterItems(items, { age: { $lte: 25 } });
+            expect(result).toEqual([items[1], items[4]]);
+        });
+    });
+    describe('$startsWith', () => {
+        it('should return items whose string field starts with the value', () => {
+            const result = filterItems(items, { name: { $startsWith: 'Al' } });
+            expect(result).toEqual([items[0]]);
+        });
+        it('should return empty array when no items match', () => {
+            const result = filterItems(items, { name: { $startsWith: 'Zz' } });
+            expect(result).toEqual([]);
+        });
+    });
+    describe('$endsWith', () => {
+        it('should return items whose string field ends with the value', () => {
+            const result = filterItems(items, { name: { $endsWith: 'ce' } });
+            expect(result).toEqual([items[0]]);
+        });
+    });
+    describe('$like', () => {
+        it('should match with % wildcards', () => {
+            const result = filterItems(items, { name: { $like: 'A%' } });
+            expect(result).toEqual([items[0]]);
+        });
+        it('should match with % in the middle', () => {
+            const result = filterItems(items, { name: { $like: 'A%e' } });
+            expect(result).toEqual([items[0]]);
+        });
+        it('should be case-insensitive', () => {
+            const result = filterItems(items, { name: { $like: 'alice' } });
+            expect(result).toEqual([items[0]]);
+        });
+        it('should escape regex metacharacters in the pattern', () => {
+            const testItems = [{ value: 'foo.bar' }, { value: 'fooXbar' }];
+            const result = filterItems(testItems, { value: { $like: 'foo.bar' } });
+            expect(result).toEqual([{ value: 'foo.bar' }]);
+        });
+    });
+    describe('$regex', () => {
+        it('should return items matching the regex', () => {
+            const result = filterItems(items, { name: { $regex: '^[A-C]' } });
+            expect(result).toEqual([items[0], items[1], items[2]]);
+        });
+        it('should return empty array when no items match', () => {
+            const result = filterItems(items, { name: { $regex: '^Z' } });
+            expect(result).toEqual([]);
+        });
+        it('should throw on invalid regex syntax', () => {
+            expect(() => filterItems(items, { name: { $regex: '[invalid' } })).toThrow();
+        });
+    });
+    describe('$and', () => {
+        it('should return items matching all conditions', () => {
+            const result = filterItems(items, { $and: [{ age: { $gte: 25 } }, { active: { $eq: true } }] });
+            expect(result).toEqual([items[0], items[2]]);
+        });
+        it('should return empty array when conditions are mutually exclusive', () => {
+            const result = filterItems(items, { $and: [{ name: { $eq: 'Alice' } }, { name: { $eq: 'Bob' } }] });
+            expect(result).toEqual([]);
+        });
+    });
+    describe('$or', () => {
+        it('should return items matching any condition', () => {
+            const result = filterItems(items, { $or: [{ name: { $eq: 'Alice' } }, { name: { $eq: 'Bob' } }] });
+            expect(result).toEqual([items[0], items[1]]);
+        });
+        it('should return empty array when no conditions match', () => {
+            const result = filterItems(items, { $or: [{ name: { $eq: 'Nobody' } }, { name: { $eq: 'Nope' } }] });
+            expect(result).toEqual([]);
+        });
+    });
+    describe('combined field-level filters', () => {
+        it('should AND multiple field filters together', () => {
+            const result = filterItems(items, { age: { $gte: 25 }, active: { $eq: true } });
+            expect(result).toEqual([items[0], items[2]]);
+        });
+    });
+    describe('error cases', () => {
+        it('should throw when a field filter is not an object', () => {
+            const badFilter = { name: 'Alice' };
+            expect(() => filterItems(items, badFilter)).toThrow("The filter has to be an object, got string for field 'name'");
+        });
+        it('should throw for an unsupported filter operation', () => {
+            const badFilter = { name: { $unknown: 'x' } };
+            expect(() => filterItems(items, badFilter)).toThrow("The filter key '$unknown' is not a valid operation");
+        });
+    });
+});
+//# sourceMappingURL=filter-items.spec.js.map

package/esm/filter-items.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-items.spec.js","sourceRoot":"","sources":["../src/filter-items.spec.ts"],"names":[],"mappings":"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"}

package/esm/in-memory-store.d.ts

@@ -21,8 +21,6 @@ export declare class InMemoryStore<T, TPrimaryKey extends keyof T> extends Event
     add(...entries: T[]): Promise<CreateResult<T>>;
     cache: Map<T[TPrimaryKey], T>;
     get: (key: T[TPrimaryKey], select?: Array<keyof T>) => Promise<Awaited<T> | undefined>;
-    private evaluateLike;
-    private filterInternal;
     find<TFields extends Array<keyof T>>(searchOptions: FindOptions<T, TFields>): Promise<PartialResult<T, TFields>[]>;
     count(filter?: FilterType<T>): Promise<number>;
     update(id: T[TPrimaryKey], data: T): Promise<void>;

package/esm/in-memory-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"in-memory-store.d.ts","sourceRoot":"","sources":["../src/in-memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAqBrH,qBAAa,aAAa,CAAC,CAAC,EAAE,WAAW,SAAS,MAAM,CAAC,CACvD,SAAQ,QAAQ,CAAC;IACf,aAAa,EAAE;QAAE,MAAM,EAAE,CAAC,CAAA;KAAE,CAAA;IAC5B,eAAe,EAAE;QAAE,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE,CAAA;IAC3D,eAAe,EAAE;QAAE,GAAG,EAAE,CAAC,CAAC,WAAW,CAAC,CAAA;KAAE,CAAA;CACzC,CACD,YAAW,aAAa,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IAE3C;;;OAGG;IACU,MAAM,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrD,GAAG,CAAC,GAAG,OAAO,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAapD,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAY;IACzC,GAAG,GAAI,KAAK,CAAC,CAAC,WAAW,CAAC,EAAE,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,qCAGzD;IAED,OAAO,CAAC,YAAY,CAGnB;IAED,OAAO,CAAC,cAAc;IA8GT,IAAI,CAAC,OAAO,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,EAAE,OAAO,CAAC;IA4B3E,KAAK,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;IAI5B,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC;IAWxC,CAAC,MAAM,CAAC,OAAO,CAAC;IAKvB,SAAgB,UAAU,EAAE,WAAW,CAAA;IACvC,SAAgB,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAEvC;;;;;OAKG;gBACS,OAAO,EAAE;QACnB;;WAEG;QACH,UAAU,EAAE,WAAW,CAAA;QACvB;;WAEG;QACH,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;KACxB;CAKF"}
+{"version":3,"file":"in-memory-store.d.ts","sourceRoot":"","sources":["../src/in-memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAIrH,qBAAa,aAAa,CAAC,CAAC,EAAE,WAAW,SAAS,MAAM,CAAC,CACvD,SAAQ,QAAQ,CAAC;IACf,aAAa,EAAE;QAAE,MAAM,EAAE,CAAC,CAAA;KAAE,CAAA;IAC5B,eAAe,EAAE;QAAE,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE,CAAA;IAC3D,eAAe,EAAE;QAAE,GAAG,EAAE,CAAC,CAAC,WAAW,CAAC,CAAA;KAAE,CAAA;CACzC,CACD,YAAW,aAAa,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IAE3C;;;OAGG;IACU,MAAM,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrD,GAAG,CAAC,GAAG,OAAO,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAapD,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAY;IACzC,GAAG,GAAI,KAAK,CAAC,CAAC,WAAW,CAAC,EAAE,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,qCAGzD;IAEY,IAAI,CAAC,OAAO,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,EAAE,OAAO,CAAC;IA4B3E,KAAK,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;IAI5B,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC;IAWxC,CAAC,MAAM,CAAC,OAAO,CAAC;IAKvB,SAAgB,UAAU,EAAE,WAAW,CAAA;IACvC,SAAgB,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAEvC;;;;;OAKG;gBACS,OAAO,EAAE;QACnB;;WAEG;QACH,UAAU,EAAE,WAAW,CAAA;QACvB;;WAEG;QACH,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;KACxB;CAKF"}

package/esm/in-memory-store.js

@@ -1,5 +1,6 @@
 import { EventHub } from '@furystack/utils';
-import { isLogicalOperator, isOperator, selectFields } from './models/physical-store.js';
+import { selectFields } from './models/physical-store.js';
+import { filterItems } from './filter-items.js';
 export class InMemoryStore extends EventHub {
     /**
      *
@@ -28,122 +29,8 @@ export class InMemoryStore extends EventHub {
         const item = this.cache.get(key);
         return Promise.resolve(item && select ? selectFields(item, ...select) : item);
     };
-    evaluateLike = (value, likeString) => {
-        const likeRegex = `^${likeString.replace(/%/g, '.*')}$`;
-        return value.match(new RegExp(likeRegex, 'i'));
-    };
-    filterInternal(values, filter) {
-        if (!filter) {
-            return values;
-        }
-        return values.filter((item) => {
-            const filterRecord = filter;
-            const itemRecord = item;
-            for (const key in filterRecord) {
-                if (isLogicalOperator(key)) {
-                    const filterValue = filterRecord[key];
-                    switch (key) {
-                        case '$and':
-                            if (filterValue.some((v) => !this.filterInternal([item], v).length)) {
-                                return false;
-                            }
-                            break;
-                        case '$or':
-                            if (filterValue.some((v) => this.filterInternal([item], v).length)) {
-                                break;
-                            }
-                            return false;
-                        default:
-                            throw new Error(`The logical operation '${key}' is not a valid operation`);
-                    }
-                }
-                else {
-                    const fieldFilter = filterRecord[key];
-                    if (typeof fieldFilter === 'object' && fieldFilter !== null) {
-                        for (const filterKey in fieldFilter) {
-                            if (isOperator(filterKey)) {
-                                const itemValue = itemRecord[key];
-                                const filterValue = fieldFilter[filterKey];
-                                switch (filterKey) {
-                                    case '$eq':
-                                        if (filterValue !== itemValue) {
-                                            return false;
-                                        }
-                                        break;
-                                    case '$ne':
-                                        if (filterValue === itemValue) {
-                                            return false;
-                                        }
-                                        break;
-                                    case '$in':
-                                        if (!filterValue.includes(itemValue)) {
-                                            return false;
-                                        }
-                                        break;
-                                    case '$nin':
-                                        if (filterValue.includes(itemValue)) {
-                                            return false;
-                                        }
-                                        break;
-                                    case '$lt':
-                                        if (itemValue < filterValue) {
-                                            break;
-                                        }
-                                        return false;
-                                    case '$lte':
-                                        if (itemValue <= filterValue) {
-                                            break;
-                                        }
-                                        return false;
-                                    case '$gt':
-                                        if (itemValue > filterValue) {
-                                            break;
-                                        }
-                                        return false;
-                                    case '$gte':
-                                        if (itemValue >= filterValue) {
-                                            break;
-                                        }
-                                        return false;
-                                    case '$regex':
-                                        if (!new RegExp(filterValue).test(String(itemValue))) {
-                                            return false;
-                                        }
-                                        break;
-                                    case '$startsWith':
-                                        if (!itemValue.startsWith(filterValue)) {
-                                            return false;
-                                        }
-                                        break;
-                                    case '$endsWith':
-                                        if (!itemValue.endsWith(filterValue)) {
-                                            return false;
-                                        }
-                                        break;
-                                    case '$like':
-                                        if (!this.evaluateLike(itemValue, filterValue)) {
-                                            return false;
-                                        }
-                                        break;
-                                    default:
-                                        throw new Error(`The expression (${filterKey}) is not supported by '${this.constructor.name}'!`);
-                                }
-                            }
-                            else {
-                                throw new Error(`The filter key '${filterKey}' is not a valid operation`);
-                            }
-                        }
-                    }
-                    else {
-                        throw new Error(`The filter has to be an object, got ${typeof fieldFilter} for field '${key}'`);
-                    }
-                }
-            }
-            return true;
-        });
-    }
     async find(searchOptions) {
-        let value = this.filterInternal([...this.cache.values()], searchOptions.filter);
+        let value = filterItems([...this.cache.values()], searchOptions.filter);
         if (searchOptions.order) {
             const orderRecord = searchOptions.order;
             for (const fieldName of Object.keys(searchOptions.order)) {
@@ -168,7 +55,7 @@ export class InMemoryStore extends EventHub {
         return value;
     }
     async count(filter) {
-        return this.filterInternal([...this.cache.values()], filter).length;
+        return filterItems([...this.cache.values()], filter).length;
     }
     async update(id, data) {
         if (!this.cache.has(id)) {

package/esm/in-memory-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"in-memory-store.js","sourceRoot":"","sources":["../src/in-memory-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"in-memory-store.js","sourceRoot":"","sources":["../src/in-memory-store.ts"],"names":[],"mappings":"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"}

package/esm/index.d.ts

@@ -1,6 +1,7 @@
 export * from './errors/index.js';
 export * from './models/physical-store.js';
 export * from './models/user.js';
+export * from './filter-items.js';
 export * from './in-memory-store.js';
 export * from './store-manager.js';
 export * from './global-disposables.js';

package/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,uBAAuB,CAAA;AACrC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,uBAAuB,CAAA;AACrC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,cAAc,CAAA"}

package/esm/index.js

@@ -1,6 +1,7 @@
 export * from './errors/index.js';
 export * from './models/physical-store.js';
 export * from './models/user.js';
+export * from './filter-items.js';
 export * from './in-memory-store.js';
 export * from './store-manager.js';
 export * from './global-disposables.js';

package/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,uBAAuB,CAAA;AACrC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,uBAAuB,CAAA;AACrC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,cAAc,CAAA"}

package/esm/models/physical-store.d.ts

@@ -64,12 +64,14 @@ export declare const selectFields: <T extends object, TField extends Array<keyof
 /**
  * Interface that defines a physical store implementation.
  *
- * **Important:** Writing directly to a physical store bypasses the Repository {@link DataSet} layer.
+ * **Recommended:** `DataSet` from `@furystack/repository` is the preferred write gateway for application-level code.
+ *
+ * **Important:** Writing directly to a physical store bypasses the Repository `DataSet` layer.
  * This means authorization, modification hooks, and DataSet events (used by entity sync) will **not** be triggered.
  * For any write operation that should be observable by other parts of the system (e.g. entity sync, audit logging),
- * use the corresponding {@link DataSet} method instead via `getDataSetFor()`.
+ * use the corresponding `DataSet` method instead via `getDataSetFor()` from `@furystack/repository`.
  *
- * @see {@link DataSet} for the authorized, event-emitting write gateway
+ * @see `DataSet` from `@furystack/repository` for the authorized, event-emitting write gateway
  */
 export interface PhysicalStore<T, TPrimaryKey extends keyof T, TWriteableData = WithOptionalId<T, TPrimaryKey>> extends EventHub<{
     onEntityAdded: {

package/esm/models/physical-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"physical-store.d.ts","sourceRoot":"","sources":["../../src/models/physical-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"physical-store.d.ts","sourceRoot":"","sources":["../../src/models/physical-store.ts"],"names":[],"mappings":"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"}

package/esm/store-manager.d.ts

@@ -12,6 +12,12 @@ export declare class StoreManager implements AsyncDisposable {
     /**
      * Returns a store model for a constructable object.
      * Throws error if no store is registered
+     *
+     * **Note:** For application-level data access, prefer `getDataSetFor` from `@furystack/repository`.
+     * Writing through the DataSet ensures authorization, modification hooks, and change events
+     * (required for entity sync) are properly triggered.
+     * This method is intended for internal use by `Repository.createDataSet` and for physical store tests.
+     *
      * @param model The Constructable object
      * @param primaryKey The Primary Key field
      * @throws if the Store is not registered

package/esm/store-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store-manager.d.ts","sourceRoot":"","sources":["../src/store-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAItD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAE/D;;GAEG;AACH,qBACa,YAAa,YAAW,eAAe;IAClD;;OAEG;IACU,CAAC,MAAM,CAAC,YAAY,CAAC;IAoBlC,OAAO,CAAC,MAAM,CAAkE;IAEhF;;;;;;;OAOG;IACI,WAAW,CAAC,CAAC,EAAE,WAAW,SAAS,MAAM,CAAC,EAAE,KAAK,SAAS,aAAa,CAAC,CAAC,EAAE,WAAW,CAAC,EAC5F,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,UAAU,EAAE,WAAW,GASJ,KAAK;IAG1B;;;;OAIG;IACI,QAAQ,CAAC,CAAC,EAAE,WAAW,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,EAAE,WAAW,CAAC;CAIrF"}
+{"version":3,"file":"store-manager.d.ts","sourceRoot":"","sources":["../src/store-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAItD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAE/D;;GAEG;AACH,qBACa,YAAa,YAAW,eAAe;IAClD;;OAEG;IACU,CAAC,MAAM,CAAC,YAAY,CAAC;IAoBlC,OAAO,CAAC,MAAM,CAAkE;IAEhF;;;;;;;;;;;;;OAaG;IACI,WAAW,CAAC,CAAC,EAAE,WAAW,SAAS,MAAM,CAAC,EAAE,KAAK,SAAS,aAAa,CAAC,CAAC,EAAE,WAAW,CAAC,EAC5F,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,UAAU,EAAE,WAAW,GASJ,KAAK;IAG1B;;;;OAIG;IACI,QAAQ,CAAC,CAAC,EAAE,WAAW,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,EAAE,WAAW,CAAC;CAIrF"}

package/esm/store-manager.js

@@ -33,6 +33,12 @@ let StoreManager = class StoreManager {
     /**
      * Returns a store model for a constructable object.
      * Throws error if no store is registered
+     *
+     * **Note:** For application-level data access, prefer `getDataSetFor` from `@furystack/repository`.
+     * Writing through the DataSet ensures authorization, modification hooks, and change events
+     * (required for entity sync) are properly triggered.
+     * This method is intended for internal use by `Repository.createDataSet` and for physical store tests.
+     *
      * @param model The Constructable object
      * @param primaryKey The Primary Key field
      * @throws if the Store is not registered

package/esm/store-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"store-manager.js","sourceRoot":"","sources":["../src/store-manager.ts"],"names":[],"mappings":";;;;;;AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAG9D;;GAEG;AAEI,IAAM,YAAY,GAAlB,MAAM,YAAY;IACvB;;OAEG;IACI,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CACrC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE;YACvD,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxB,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAA;YACzB,CAAC;YACD,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,MAAM,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAA;YACpC,CAAC;QACH,CAAC,CAAC,CACH,CAAA;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAA;QAC3D,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,IAAI,eAAe,CAC/B,uCAAuC,KAAK,CAAC,MAAM,YAAY,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAChH,KAAK,CACN,CAAA;YACD,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IACO,MAAM,GAAyD,IAAI,GAAG,EAAE,CAAA;IAEhF;;;;;;;OAOG;IACI,WAAW,CAChB,KAAuB,EACvB,UAAuB;QAEvB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,KAAK,CAAC,wBAAwB,KAAK,CAAC,IAAI,GAAG,CAAC,CAAA;QACpD,CAAC;QACD,IAAI,UAAU,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC;YACvC,MAAM,KAAK,CAAC,wBAAwB,CAAC,CAAA;QACvC,CAAC;QACD,OAAO,QAAiB,CAAA;IAC1B,CAAC;IAED;;;;OAIG;IACI,QAAQ,CAAiC,KAAoC;QAClF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,KAAgC,CAAC,CAAA;QAC9D,OAAO,IAAI,CAAA;IACb,CAAC;CACF,CAAA;AAzDY,YAAY;IADxB,UAAU,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;GACzB,YAAY,CAyDxB"}
+{"version":3,"file":"store-manager.js","sourceRoot":"","sources":["../src/store-manager.ts"],"names":[],"mappings":";;;;;;AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAG9D;;GAEG;AAEI,IAAM,YAAY,GAAlB,MAAM,YAAY;IACvB;;OAEG;IACI,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CACrC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE;YACvD,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxB,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAA;YACzB,CAAC;YACD,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,MAAM,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAA;YACpC,CAAC;QACH,CAAC,CAAC,CACH,CAAA;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAA;QAC3D,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,IAAI,eAAe,CAC/B,uCAAuC,KAAK,CAAC,MAAM,YAAY,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAChH,KAAK,CACN,CAAA;YACD,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IACO,MAAM,GAAyD,IAAI,GAAG,EAAE,CAAA;IAEhF;;;;;;;;;;;;;OAaG;IACI,WAAW,CAChB,KAAuB,EACvB,UAAuB;QAEvB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,KAAK,CAAC,wBAAwB,KAAK,CAAC,IAAI,GAAG,CAAC,CAAA;QACpD,CAAC;QACD,IAAI,UAAU,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC;YACvC,MAAM,KAAK,CAAC,wBAAwB,CAAC,CAAA;QACvC,CAAC;QACD,OAAO,QAAiB,CAAA;IAC1B,CAAC;IAED;;;;OAIG;IACI,QAAQ,CAAiC,KAAoC;QAClF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,KAAgC,CAAC,CAAA;QAC9D,OAAO,IAAI,CAAA;IACb,CAAC;CACF,CAAA;AA/DY,YAAY;IADxB,UAAU,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;GACzB,YAAY,CA+DxB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@furystack/core",
-  "version": "15.1.0",
+  "version": "15.2.1",
   "description": "Core FuryStack package",
   "type": "module",
   "scripts": {

package/src/filter-items.spec.ts

@@ -0,0 +1,216 @@
+import { describe, it, expect } from 'vitest'
+import { filterItems } from './filter-items.js'
+import type { FilterType } from './models/physical-store.js'
+
+type TestItem = {
+  id: number
+  name: string
+  age: number
+  active: boolean
+}
+
+const items: TestItem[] = [
+  { id: 1, name: 'Alice', age: 30, active: true },
+  { id: 2, name: 'Bob', age: 25, active: false },
+  { id: 3, name: 'Charlie', age: 35, active: true },
+  { id: 4, name: 'Diana', age: 28, active: false },
+  { id: 5, name: 'Eve', age: 22, active: true },
+]
+
+describe('filterItems', () => {
+  describe('no filter', () => {
+    it('should return all items when filter is undefined', () => {
+      expect(filterItems(items, undefined)).toEqual(items)
+    })
+
+    it('should return all items when filter is not provided', () => {
+      expect(filterItems(items)).toEqual(items)
+    })
+
+    it('should return an empty array when input is empty', () => {
+      expect(filterItems<TestItem>([], { name: { $eq: 'Alice' } })).toEqual([])
+    })
+
+    it('should return all items when filter is an empty object', () => {
+      expect(filterItems(items, {} as FilterType<TestItem>)).toEqual(items)
+    })
+  })
+
+  describe('$eq', () => {
+    it('should return items matching the exact value', () => {
+      const result = filterItems(items, { name: { $eq: 'Alice' } })
+      expect(result).toEqual([items[0]])
+    })
+
+    it('should return empty array when no items match', () => {
+      const result = filterItems(items, { name: { $eq: 'Nobody' } })
+      expect(result).toEqual([])
+    })
+  })
+
+  describe('$ne', () => {
+    it('should return items not matching the value', () => {
+      const result = filterItems(items, { name: { $ne: 'Alice' } })
+      expect(result).toEqual([items[1], items[2], items[3], items[4]])
+    })
+  })
+
+  describe('$in', () => {
+    it('should return items whose value is in the array', () => {
+      const result = filterItems(items, { name: { $in: ['Alice', 'Bob'] } })
+      expect(result).toEqual([items[0], items[1]])
+    })
+
+    it('should return empty array when no values match', () => {
+      const result = filterItems(items, { name: { $in: ['Nobody'] } })
+      expect(result).toEqual([])
+    })
+  })
+
+  describe('$nin', () => {
+    it('should return items whose value is not in the array', () => {
+      const result = filterItems(items, { name: { $nin: ['Alice', 'Bob'] } })
+      expect(result).toEqual([items[2], items[3], items[4]])
+    })
+  })
+
+  describe('$gt', () => {
+    it('should return items with value greater than the threshold', () => {
+      const result = filterItems(items, { age: { $gt: 30 } })
+      expect(result).toEqual([items[2]])
+    })
+
+    it('should exclude items equal to the threshold', () => {
+      const result = filterItems(items, { age: { $gt: 35 } })
+      expect(result).toEqual([])
+    })
+  })
+
+  describe('$gte', () => {
+    it('should return items with value greater than or equal to the threshold', () => {
+      const result = filterItems(items, { age: { $gte: 30 } })
+      expect(result).toEqual([items[0], items[2]])
+    })
+  })
+
+  describe('$lt', () => {
+    it('should return items with value less than the threshold', () => {
+      const result = filterItems(items, { age: { $lt: 25 } })
+      expect(result).toEqual([items[4]])
+    })
+
+    it('should exclude items equal to the threshold', () => {
+      const result = filterItems(items, { age: { $lt: 22 } })
+      expect(result).toEqual([])
+    })
+  })
+
+  describe('$lte', () => {
+    it('should return items with value less than or equal to the threshold', () => {
+      const result = filterItems(items, { age: { $lte: 25 } })
+      expect(result).toEqual([items[1], items[4]])
+    })
+  })
+
+  describe('$startsWith', () => {
+    it('should return items whose string field starts with the value', () => {
+      const result = filterItems(items, { name: { $startsWith: 'Al' } })
+      expect(result).toEqual([items[0]])
+    })
+
+    it('should return empty array when no items match', () => {
+      const result = filterItems(items, { name: { $startsWith: 'Zz' } })
+      expect(result).toEqual([])
+    })
+  })
+
+  describe('$endsWith', () => {
+    it('should return items whose string field ends with the value', () => {
+      const result = filterItems(items, { name: { $endsWith: 'ce' } })
+      expect(result).toEqual([items[0]])
+    })
+  })
+
+  describe('$like', () => {
+    it('should match with % wildcards', () => {
+      const result = filterItems(items, { name: { $like: 'A%' } })
+      expect(result).toEqual([items[0]])
+    })
+
+    it('should match with % in the middle', () => {
+      const result = filterItems(items, { name: { $like: 'A%e' } })
+      expect(result).toEqual([items[0]])
+    })
+
+    it('should be case-insensitive', () => {
+      const result = filterItems(items, { name: { $like: 'alice' } })
+      expect(result).toEqual([items[0]])
+    })
+
+    it('should escape regex metacharacters in the pattern', () => {
+      type Item = { value: string }
+      const testItems: Item[] = [{ value: 'foo.bar' }, { value: 'fooXbar' }]
+      const result = filterItems(testItems, { value: { $like: 'foo.bar' } } as FilterType<Item>)
+      expect(result).toEqual([{ value: 'foo.bar' }])
+    })
+  })
+
+  describe('$regex', () => {
+    it('should return items matching the regex', () => {
+      const result = filterItems(items, { name: { $regex: '^[A-C]' } })
+      expect(result).toEqual([items[0], items[1], items[2]])
+    })
+
+    it('should return empty array when no items match', () => {
+      const result = filterItems(items, { name: { $regex: '^Z' } })
+      expect(result).toEqual([])
+    })
+
+    it('should throw on invalid regex syntax', () => {
+      expect(() => filterItems(items, { name: { $regex: '[invalid' } })).toThrow()
+    })
+  })
+
+  describe('$and', () => {
+    it('should return items matching all conditions', () => {
+      const result = filterItems(items, { $and: [{ age: { $gte: 25 } }, { active: { $eq: true } }] })
+      expect(result).toEqual([items[0], items[2]])
+    })
+
+    it('should return empty array when conditions are mutually exclusive', () => {
+      const result = filterItems(items, { $and: [{ name: { $eq: 'Alice' } }, { name: { $eq: 'Bob' } }] })
+      expect(result).toEqual([])
+    })
+  })
+
+  describe('$or', () => {
+    it('should return items matching any condition', () => {
+      const result = filterItems(items, { $or: [{ name: { $eq: 'Alice' } }, { name: { $eq: 'Bob' } }] })
+      expect(result).toEqual([items[0], items[1]])
+    })
+
+    it('should return empty array when no conditions match', () => {
+      const result = filterItems(items, { $or: [{ name: { $eq: 'Nobody' } }, { name: { $eq: 'Nope' } }] })
+      expect(result).toEqual([])
+    })
+  })
+
+  describe('combined field-level filters', () => {
+    it('should AND multiple field filters together', () => {
+      const result = filterItems(items, { age: { $gte: 25 }, active: { $eq: true } })
+      expect(result).toEqual([items[0], items[2]])
+    })
+  })
+
+  describe('error cases', () => {
+    it('should throw when a field filter is not an object', () => {
+      const badFilter = { name: 'Alice' } as unknown as FilterType<TestItem>
+      expect(() => filterItems(items, badFilter)).toThrow("The filter has to be an object, got string for field 'name'")
+    })
+
+    it('should throw for an unsupported filter operation', () => {
+      const badFilter = { name: { $unknown: 'x' } } as unknown as FilterType<TestItem>
+      expect(() => filterItems(items, badFilter)).toThrow("The filter key '$unknown' is not a valid operation")
+    })
+  })
+})

package/src/filter-items.ts

@@ -0,0 +1,148 @@
+import type { FilterType } from './models/physical-store.js'
+import { isLogicalOperator, isOperator } from './models/physical-store.js'
+
+type FieldOperatorFilter = {
+  $eq?: unknown
+  $ne?: unknown
+  $in?: unknown[]
+  $nin?: unknown[]
+  $gt?: unknown
+  $gte?: unknown
+  $lt?: unknown
+  $lte?: unknown
+  $startsWith?: string
+  $endsWith?: string
+  $like?: string
+  $regex?: string
+}
+
+const escapeRegexMeta = (str: string) => str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+
+const evaluateLike = (value: string, likeString: string) => {
+  const likeRegex = `^${likeString.split('%').map(escapeRegexMeta).join('.*')}$`
+  return value.match(new RegExp(likeRegex, 'i'))
+}
+
+/**
+ * Filters an array of items using a {@link FilterType} expression.
+ * Supports field-level operators ($eq, $ne, $in, $nin, $gt, $gte, $lt, $lte, $startsWith, $endsWith, $like, $regex)
+ * and logical operators ($and, $or).
+ * @param values The array of items to filter
+ * @param filter The filter expression to apply
+ * @returns The filtered array of items
+ */
+export function filterItems<T>(values: T[], filter?: FilterType<T>): T[] {
+  if (!filter) {
+    return values
+  }
+  return values.filter((item) => {
+    const filterRecord = filter as Record<string, Array<FilterType<T>> | FieldOperatorFilter | undefined>
+    const itemRecord = item as Record<string, unknown>
+
+    for (const key in filterRecord) {
+      if (isLogicalOperator(key)) {
+        const filterValue = filterRecord[key] as Array<FilterType<T>>
+        switch (key) {
+          case '$and':
+            if (filterValue.some((v: FilterType<T>) => !filterItems([item], v).length)) {
+              return false
+            }
+            break
+          case '$or':
+            if (filterValue.some((v: FilterType<T>) => filterItems([item], v).length)) {
+              break
+            }
+            return false
+          default:
+            throw new Error(`The logical operation '${key}' is not a valid operation`)
+        }
+      } else {
+        const fieldFilter = filterRecord[key] as FieldOperatorFilter | undefined
+        if (typeof fieldFilter === 'object' && fieldFilter !== null) {
+          for (const filterKey in fieldFilter) {
+            if (isOperator(filterKey)) {
+              const itemValue = itemRecord[key]
+              const filterValue = fieldFilter[filterKey as keyof FieldOperatorFilter]
+              switch (filterKey) {
+                case '$eq':
+                  if (filterValue !== itemValue) {
+                    return false
+                  }
+                  break
+                case '$ne':
+                  if (filterValue === itemValue) {
+                    return false
+                  }
+                  break
+                case '$in':
+                  if (!(filterValue as unknown[]).includes(itemValue)) {
+                    return false
+                  }
+                  break
+                case '$nin':
+                  if ((filterValue as unknown[]).includes(itemValue)) {
+                    return false
+                  }
+                  break
+                case '$lt':
+                  if ((itemValue as number) < (filterValue as number)) {
+                    break
+                  }
+                  return false
+                case '$lte':
+                  if ((itemValue as number) <= (filterValue as number)) {
+                    break
+                  }
+                  return false
+                case '$gt':
+                  if ((itemValue as number) > (filterValue as number)) {
+                    break
+                  }
+                  return false
+                case '$gte':
+                  if ((itemValue as number) >= (filterValue as number)) {
+                    break
+                  }
+                  return false
+                case '$regex':
+                  try {
+                    if (!new RegExp(filterValue as string).test(String(itemValue))) {
+                      return false
+                    }
+                  } catch (e) {
+                    throw new Error(
+                      `Invalid regular expression for $regex filter on field '${key}': ${(e as Error).message}`,
+                      { cause: e },
+                    )
+                  }
+                  break
+                case '$startsWith':
+                  if (!(itemValue as string).startsWith(filterValue as string)) {
+                    return false
+                  }
+                  break
+                case '$endsWith':
+                  if (!(itemValue as string).endsWith(filterValue as string)) {
+                    return false
+                  }
+                  break
+                case '$like':
+                  if (!evaluateLike(itemValue as string, filterValue as string)) {
+                    return false
+                  }
+                  break
+                default:
+                  throw new Error(`The expression (${filterKey}) is not a supported filter operation`)
+              }
+            } else {
+              throw new Error(`The filter key '${filterKey}' is not a valid operation`)
+            }
+          }
+        } else {
+          throw new Error(`The filter has to be an object, got ${typeof fieldFilter} for field '${key}'`)
+        }
+      }
+    }
+    return true
+  })
+}

package/src/in-memory-store.ts

@@ -1,25 +1,8 @@
 import type { Constructable } from '@furystack/inject'
 import { EventHub } from '@furystack/utils'
 import type { CreateResult, FilterType, FindOptions, PartialResult, PhysicalStore } from './models/physical-store.js'
-import { isLogicalOperator, isOperator, selectFields } from './models/physical-store.js'
-
-/**
- * Helper type representing all possible field filter operations
- */
-type FieldOperatorFilter = {
-  $eq?: unknown
-  $ne?: unknown
-  $in?: unknown[]
-  $nin?: unknown[]
-  $gt?: unknown
-  $gte?: unknown
-  $lt?: unknown
-  $lte?: unknown
-  $startsWith?: string
-  $endsWith?: string
-  $like?: string
-  $regex?: string
-}
+import { selectFields } from './models/physical-store.js'
+import { filterItems } from './filter-items.js'
 
 export class InMemoryStore<T, TPrimaryKey extends keyof T>
   extends EventHub<{
@@ -59,123 +42,8 @@ export class InMemoryStore<T, TPrimaryKey extends keyof T>
     return Promise.resolve(item && select ? selectFields(item, ...select) : item)
   }
 
-  private evaluateLike = (value: string, likeString: string) => {
-    const likeRegex = `^${likeString.replace(/%/g, '.*')}$`
-    return value.match(new RegExp(likeRegex, 'i'))
-  }
-
-  private filterInternal(values: T[], filter?: FilterType<T>): T[] {
-    if (!filter) {
-      return values
-    }
-    return values.filter((item) => {
-      const filterRecord = filter as Record<string, Array<FilterType<T>> | FieldOperatorFilter | undefined>
-      const itemRecord = item as Record<string, unknown>
-
-      for (const key in filterRecord) {
-        if (isLogicalOperator(key)) {
-          const filterValue = filterRecord[key] as Array<FilterType<T>>
-          switch (key) {
-            case '$and':
-              if (filterValue.some((v: FilterType<T>) => !this.filterInternal([item], v).length)) {
-                return false
-              }
-              break
-            case '$or':
-              if (filterValue.some((v: FilterType<T>) => this.filterInternal([item], v).length)) {
-                break
-              }
-              return false
-            default:
-              throw new Error(`The logical operation '${key}' is not a valid operation`)
-          }
-        } else {
-          const fieldFilter = filterRecord[key] as FieldOperatorFilter | undefined
-          if (typeof fieldFilter === 'object' && fieldFilter !== null) {
-            for (const filterKey in fieldFilter) {
-              if (isOperator(filterKey)) {
-                const itemValue = itemRecord[key]
-                const filterValue = fieldFilter[filterKey as keyof FieldOperatorFilter]
-                switch (filterKey) {
-                  case '$eq':
-                    if (filterValue !== itemValue) {
-                      return false
-                    }
-                    break
-                  case '$ne':
-                    if (filterValue === itemValue) {
-                      return false
-                    }
-                    break
-                  case '$in':
-                    if (!(filterValue as unknown[]).includes(itemValue)) {
-                      return false
-                    }
-                    break
-
-                  case '$nin':
-                    if ((filterValue as unknown[]).includes(itemValue)) {
-                      return false
-                    }
-                    break
-                  case '$lt':
-                    if ((itemValue as number) < (filterValue as number)) {
-                      break
-                    }
-                    return false
-                  case '$lte':
-                    if ((itemValue as number) <= (filterValue as number)) {
-                      break
-                    }
-                    return false
-                  case '$gt':
-                    if ((itemValue as number) > (filterValue as number)) {
-                      break
-                    }
-                    return false
-                  case '$gte':
-                    if ((itemValue as number) >= (filterValue as number)) {
-                      break
-                    }
-                    return false
-                  case '$regex':
-                    if (!new RegExp(filterValue as string).test(String(itemValue))) {
-                      return false
-                    }
-                    break
-                  case '$startsWith':
-                    if (!(itemValue as string).startsWith(filterValue as string)) {
-                      return false
-                    }
-                    break
-                  case '$endsWith':
-                    if (!(itemValue as string).endsWith(filterValue as string)) {
-                      return false
-                    }
-                    break
-                  case '$like':
-                    if (!this.evaluateLike(itemValue as string, filterValue as string)) {
-                      return false
-                    }
-                    break
-                  default:
-                    throw new Error(`The expression (${filterKey}) is not supported by '${this.constructor.name}'!`)
-                }
-              } else {
-                throw new Error(`The filter key '${filterKey}' is not a valid operation`)
-              }
-            }
-          } else {
-            throw new Error(`The filter has to be an object, got ${typeof fieldFilter} for field '${key}'`)
-          }
-        }
-      }
-      return true
-    })
-  }
-
   public async find<TFields extends Array<keyof T>>(searchOptions: FindOptions<T, TFields>) {
-    let value: Array<PartialResult<T, TFields>> = this.filterInternal([...this.cache.values()], searchOptions.filter)
+    let value: Array<PartialResult<T, TFields>> = filterItems([...this.cache.values()], searchOptions.filter)
 
     if (searchOptions.order) {
       const orderRecord = searchOptions.order as Record<string, 'ASC' | 'DESC'>
@@ -203,7 +71,7 @@ export class InMemoryStore<T, TPrimaryKey extends keyof T>
   }
 
   public async count(filter?: FilterType<T>) {
-    return this.filterInternal([...this.cache.values()], filter).length
+    return filterItems([...this.cache.values()], filter).length
   }
 
   public async update(id: T[TPrimaryKey], data: T) {

package/src/index.ts

@@ -1,6 +1,7 @@
 export * from './errors/index.js'
 export * from './models/physical-store.js'
 export * from './models/user.js'
+export * from './filter-items.js'
 export * from './in-memory-store.js'
 export * from './store-manager.js'
 export * from './global-disposables.js'

package/src/models/physical-store.ts

@@ -90,12 +90,14 @@ export const selectFields = <T extends object, TField extends Array<keyof T>>(en
 /**
  * Interface that defines a physical store implementation.
  *
- * **Important:** Writing directly to a physical store bypasses the Repository {@link DataSet} layer.
+ * **Recommended:** `DataSet` from `@furystack/repository` is the preferred write gateway for application-level code.
+ *
+ * **Important:** Writing directly to a physical store bypasses the Repository `DataSet` layer.
  * This means authorization, modification hooks, and DataSet events (used by entity sync) will **not** be triggered.
  * For any write operation that should be observable by other parts of the system (e.g. entity sync, audit logging),
- * use the corresponding {@link DataSet} method instead via `getDataSetFor()`.
+ * use the corresponding `DataSet` method instead via `getDataSetFor()` from `@furystack/repository`.
  *
- * @see {@link DataSet} for the authorized, event-emitting write gateway
+ * @see `DataSet` from `@furystack/repository` for the authorized, event-emitting write gateway
  */
 export interface PhysicalStore<
   T,

package/src/store-manager.ts

@@ -37,6 +37,12 @@ export class StoreManager implements AsyncDisposable {
   /**
    * Returns a store model for a constructable object.
    * Throws error if no store is registered
+   *
+   * **Note:** For application-level data access, prefer `getDataSetFor` from `@furystack/repository`.
+   * Writing through the DataSet ensures authorization, modification hooks, and change events
+   * (required for entity sync) are properly triggered.
+   * This method is intended for internal use by `Repository.createDataSet` and for physical store tests.
+   *
    * @param model The Constructable object
    * @param primaryKey The Primary Key field
    * @throws if the Store is not registered