feat: add orderBy parameter

src/__tests__/search.test.ts

@@ -40,6 +40,14 @@ test('number', () => {
   expect(search('numberColumn:5..6', db)).toHaveLength(4);
 });
 
+test('orderBy', () => {
+  const db = getDB();
+  const result = search('numberColumn:1,2,3', db, {
+    orderBy: 'numberColumn DESC',
+  }).map((entry) => entry.numberColumn);
+  expect(result).toEqual([3, 3, 2, 2, 1, 1]);
+});
+
 test('errors', () => {
   const db = getDB();
   expect(() => search('numberColumn:>1,2', db)).toThrow(

src/search.ts

@@ -6,6 +6,11 @@ import { appendSQLForCriteria } from './utils/appendSQLForCriteria';
 import { parseQueryString } from './utils/parseQueryString';
 
 export interface SearchOptions {
+  /**
+   * Specify the order of the results
+   * @default: ''
+   */
+  orderBy?: string;
   /**
    * The name of the table to search. If not provided and there is only a table in the database it will be sued.
    */
@@ -40,7 +45,7 @@ export function search(
   db: Database,
   options: SearchOptions = {},
 ): Entry[] {
-  const { tableName = getTableName(db), limit = 1000 } = options;
+  const { tableName = getTableName(db), limit = 1000, orderBy = '' } = options;
   const schema = getSchema(db, tableName);
   let criteria = parseQueryString(queryString);
   const values = appendSQLForCriteria(criteria, schema, options);
@@ -54,6 +59,9 @@ export function search(
       `WHERE ${criteria.map((criterium) => criterium.sql).join(' AND ')}`,
     );
   }
+  if (orderBy) {
+    sqls.push(`ORDER BY ${orderBy}`);
+  }
   if (limit) {
     sqls.push(`LIMIT ${limit}`);
   }