Support ILIKE and custom case-insensitive search functions for MySQL-compatible adapters

[Copilot]

• Understand existing caseInsensitiveMode / shadowColumns / applyCaseInsensitive / applyShadowColumns code
• sql.js: Add 'ilike-fn' mode to applyCaseInsensitive → returns { statementTemplate: 'ILIKE(field, {param}) = 1', value } for StarRocks function-call syntax
• sql.js: Update addParameters to handle statementTemplate return (bind param normally, push custom statement with {param} replaced)
• sql.js: Add caseInsensitiveOrderBy = false property + setConfig support
• sql.js: Add applyOrderByCaseInsensitive(fieldName) method (false = no-op, true/'upper' = UPPER wrap, function = custom)
• business-base.mjs: Fix ORDER BY construction — parse field/direction separately, sanitize field name part, then apply applyOrderByCaseInsensitive, remove the double-sanitize bug on the joined string
• tests/case-insensitive.test.js: Tests for 'ilike-fn' mode, applyOrderByCaseInsensitive, setConfig caseInsensitiveOrderBy
• Code review: removed non-standard operators (CONTAINS/STARTSWITH/ENDSWITH) from ilike-fn sets; added comment in business-base clarifying sanitize-then-wrap order
• All 41 case-insensitive tests pass; CodeQL: 0 alerts

[precious-ndamati-stream4Tech]

I've verified the changes

1. filtering is not working - no record was returned
2. Sorting works fine

I analyzed the final generated query, ILIKE function is not used in the where part of the query, it still maintains the "UPPER(Name) Like ". We also also add a ReadMe.md file too so backend application can kow how effectively apply the needed changes.

caseInsensitiveMode: 'ilike-fn' was added to the mysqlConfig

[durlabhjain]

@copilot Update documentation/ examples on how different features can be activated for comparisons and how do they work in an application

[Copilot]

I've verified the changes

1. filtering is not working - no record was returned
   ...

The root cause of filtering not working with caseInsensitiveMode: 'ilike-fn' is a missing forceCaseInsensitive: true. The mode is only activated when that master switch is set. You need both in the same setConfig call:

await mysql.setConfig({
    host: '...', user: '...', password: '...', database: '...',
    namedPlaceholders: true,
    forceCaseInsensitive: true,       // ← required — without this no transformation is applied
    caseInsensitiveMode: 'ilike-fn',  // ← selects ILIKE(field, :param) = 1 syntax
});

Without forceCaseInsensitive: true, the default 'upper' mode produces UPPER(Name) LIKE :Name for any existing forceCaseInsensitive setting elsewhere.

Added a full guide with troubleshooting at docs/CASE_INSENSITIVE_SEARCH.md (commit d91e295).

@copilot Update documentation/ examples on how different features can be activated for comparisons and how do they work in an application

Added docs/CASE_INSENSITIVE_SEARCH.md (commit d91e295) covering:

• Master switch — forceCaseInsensitive (must be true to activate any mode)
• Comparison modes — 'upper' (MSSQL default), 'ilike' (PostgreSQL infix), 'ilike-fn' (StarRocks function syntax), and custom function
• ORDER BY — caseInsensitiveOrderBy (false / true / custom function)
• Shadow columns — pre-computed sort columns as an alternative to function wrapping
• Full config examples for MSSQL, MySQL, StarRocks, and PostgreSQL
• BusinessBase / Framework integration example
• Troubleshooting section (filters returning no rows, still seeing UPPER(), etc.)

Also updated README.md and docs/DATABASE_CONFIGURATION.md with a quick-start snippet and a link to the guide.

[Copilot]

Pull request overview

This PR extends DFramework’s configurable case-insensitive filtering/sorting to better support MySQL-compatible adapters (notably StarRocks) by adding an ilike-fn mode and configurable ORDER BY case handling, along with documentation and tests.

Changes:

• Added caseInsensitiveMode: 'ilike-fn' (ILIKE function-call form) plus caseInsensitiveOrderBy and supporting helpers in Sql.
• Fixed/updated BusinessBase.list() ORDER BY construction to sanitize per-field and apply optional case-insensitive wrapping.
• Added/updated docs and a comprehensive test suite for case-insensitive modes, ORDER BY wrapping, and setConfig support.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
tests/case-insensitive.test.js	Adds coverage for applyCaseInsensitive modes (upper/ilike/ilike-fn/custom), ORDER BY wrapping, shadow columns, and setConfig.
README.md	Adds a documentation link for case-insensitive search/sorting.
lib/sql.js	Implements ilike-fn statement-template support, adds ORDER BY case handling config, and updates parameter binding logic.
lib/business/business-base.mjs	Reworks ORDER BY building (per-field sanitize + optional wrapping) and integrates shadow column substitution.
docs/DATABASE_CONFIGURATION.md	Documents new configuration options and provides a StarRocks example.
docs/CASE_INSENSITIVE_SEARCH.md	New end-to-end guide for modes, ORDER BY options, and troubleshooting.

[Copilot]

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 4 comments.

[Copilot]

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated no new comments.