feat(datastore): add 'in' and 'notIn' operators for multi-value filtering

[anivar]

Implements support for 'in' and 'notIn' operators in DataStore predicates, enabling cleaner multi-value filtering without complex OR chains.

Resolves #14543

Description

Instead of writing multiple OR conditions, developers can now use array-based filtering. The implementation adds these operators to the comparison set, implements matching logic to check array membership, validates that operands are arrays, and includes TypeScript type definitions for IDE support.

Implementation Details

Core Predicates (datastore package)

• Added 'in' and 'notIn' operators to comparison operators
• Implemented array membership checking logic
• Added validation and TypeScript definitions

SQLite Adapter (datastore-storage-adapter package)

• Implemented SQL generation for IN/NOT IN operators in whereConditionFromPredicateObject
• Empty arrays return logical SQL conditions (1=0 for 'in', 1=1 for 'notIn')
• Uses parameterized queries to prevent SQL injection
• Handles complex types through prepareValueForDML (JSON.stringify for objects)
• Fixed TypeScript issue in CommonSQLiteAdapter with optional chaining

Testing

• Added comprehensive test coverage for both predicates and SQL generation
• 10 unit tests for whereConditionFromPredicateObject
• 3 integration tests for compound predicates (AND/OR/nested)
• Edge cases covered: empty arrays, non-arrays, null values, complex objects
• All tests pass, linting clean, build successful

Example Usage

// Filter posts by multiple statuses
await DataStore.query(Post, p => 
  p.status.in(['draft', 'review', 'pending'])
);

// Exclude archived items
await DataStore.query(Post, p => 
  p.status.notIn(['archived', 'deleted'])
);

Compatibility

The existing GraphQL filter generation and storage adapters handle these operators without modification since they process operators generically. This is a purely additive feature with no breaking changes.

Signed-off-by: Anivar Aravind [email protected]