alasql 4.6.0 → 4.6.2

package/README.md

@@ -1,8 +1,8 @@
-- _AlaSQL is an unfunded open source project installed 200k+ times each month. [Please donate your time](https://github.com/AlaSQL/alasql/issues?q=is%3Aopen+label%3A%22Help+wanted%22+sort%3Aupdated-desc). We appreciate any and all contributions we can get._
+- _AlaSQL is an unfunded open source project installed 250k+ times each month. [Please donate your time](https://github.com/AlaSQL/alasql/issues?q=is%3Aopen+label%3A%22Help+wanted%22+sort%3Aupdated-desc). We appreciate any and all contributions we can get._
 
 - _Have a question? [Ask the AlaSQL bot](https://chat.openai.com/g/g-XcBL24WTe-alasql-bot) or post on [Stack Overflow](http://stackoverflow.com/questions/ask?tags=AlaSQL)._
 
-[![CI-test](https://github.com/alasql/alasql/workflows/CI-test/badge.svg)](https://github.com/alasql/alasql/actions)
+[![CI-test](https://github.com/alasql/alasql/workflows/CI%20build%20&%20test/badge.svg)](https://github.com/alasql/alasql/actions)
 [![NPM downloads](http://img.shields.io/npm/dm/alasql.svg?style=flat&label=npm%20downloads)](https://npm-stat.com/charts.html?package=alasql)
 [![OPEN open source software](https://img.shields.io/badge/Open--OSS-%E2%9C%94-brightgreen.svg)](http://open-oss.com)
 [![Release](https://img.shields.io/github/release/alasql/alasql.svg?label=npm&a)](https://www.npmjs.com/package/alasql)
@@ -600,6 +600,15 @@ AlaSQL uses `SQLLOGICTEST` to test its compatibility with SQL-99. The tests incl
 
 The testruns can be found in the [testlog](TESTLOG.md).
 
+## Rebuilding the parser 
+
+To rebuild the parser, follow these steps:
+
+* Make changes to alasqlparser.jison
+* `npm install -g jison`
+* `npm run jison`
+* `npm test` to validate the changes made
+* Commit changes to alasqlparser.jison and alasqlparser.js
 
 
 ## Contributing
@@ -612,13 +621,7 @@ Thanks to all the people who already contributed!
   <img src="https://contributors-img.web.app/image?repo=alasql/alasql" />
 </a>
 
-
-## License
-
-MIT - see [MIT licence information](LICENSE)
-
-
-## Main contributors
+**Main contributors**
 
 * [Andrey Gershun](https://github.com/alasql)
 * [Mathias Rangel Wulff](https://twitter.com/rangelwulff)
@@ -629,15 +632,51 @@ AlaSQL is an [OPEN Open Source Project](http://openopensource.org/). This means
 
 We appreciate any and all contributions we can get. If you feel like contributing, have a look at [CONTRIBUTING.md](https://github.com/alasql/alasql/blob/develop/CONTRIBUTING.md)
 
-## Rebuilding the parser 
 
-To rebuild the parser, follow these steps:
 
-* Make changes to alasqlparser.jison
-* `npm install -g jison`
-* `npm run jison`
-* `npm test` to validate the changes made
-* Commit changes to alasqlparser.jison and alasqlparser.js
+## Sponsors
+
+We extend our heartfelt thanks to each and every sponsor for generously supporting the AlaSQL open-source project by providing infrastructure at no cost. Their contributions enhance the development experience, and we highly recommend exploring their offerings.
+
+
+### Faster GitHub Actions with Blacksmith
+
+[Blacksmith](https://www.blacksmith.sh/?source=alasql) significantly improves the speed of our GitHub Actions workflows by offering more powerful machines and enhanced caching mechanisms. Transitining was a one-line change and it has reduced our automated test times from 70-90 seconds to 15-17 seconds.
+
+<a href="https://www.blacksmith.sh/?source=alasql">
+    <img src="https://github.com/user-attachments/assets/a85a8a5f-65fd-48e1-aaad-b3f247248928" alt="Blacksmith Logo" width="300">
+</a>
+
+----
+
+### Browser Testing on Physical Devices with BrowserStack
+
+[BrowserStack](https://www.browserstack.com/?source=alasql) enables us to run automated tests in real browsers on physical devices to help us identify cross-browser issues early.
+
+<a href="https://www.browserstack.com/?source=alasql">
+    <img src="https://github.com/user-attachments/assets/9f74c25b-7dde-4a62-944e-8f23fc399ba9" alt="BrowserStack Logo" width="300">
+</a>
+
+----
+
+### Development Practice Tracking with OpenSSF
+
+The [Open Source Security Foundation (OpenSSF)](https://openssf.org) provides automated tools to evaluate and monitor the development practices in our repository, ensuring we maintain high standards of security and reliability.
+
+<div style="background-color: #321e6b; padding: 10px;">
+    <a href="https://openssf.org">
+        <img src="https://github.com/user-attachments/assets/30a5e4ef-62b2-431d-905e-19ce5f9b6048" alt="OpenSSF Logo" width="300">
+    </a>
+</div>
+
+
+
+## License
+
+MIT - see [MIT licence information](LICENSE)
+
+
+
 
 ## Credits
 

package/dist/alasql-worker.js

@@ -1,7 +1,7 @@
-//! AlaSQL v4.5.2 build: develop-1e5fefa4 | © 2014-2024 Andrey Gershun & Mathias Wulff | License: MIT
+//! AlaSQL v4.6.1 build: develop-a4c1a42d | © 2014-2024 Andrey Gershun & Mathias Wulff | License: MIT
 /*
 @module alasql
-@version 4.5.2
+@version 4.6.1
 
 AlaSQL - JavaScript SQL database
 © 2014-2024	Andrey Gershun & Mathias Wulff

package/dist/alasql.d.ts

@@ -3,8 +3,9 @@
 declare module 'alasql' {
 	import * as xlsx from 'xlsx';
 
-	interface AlaSQLCallback {
-		(data?: any, err?: Error): void;
+	// Callback with error-first convention and optional data
+	interface AlaSQLCallback<T = unknown> {
+		(err: Error | null, data?: T): void;
 	}
 
 	interface AlaSQLOptions {
@@ -15,7 +16,7 @@ declare module 'alasql' {
 		casesensitive: boolean; // table and column names are case sensitive and converted to lower-case
 		logtarget: string; // target for log. Values: 'console', 'output', 'id' of html tag
 		logprompt: boolean; // print SQL at log
-		modifier: any; // values: RECORDSET, VALUE, ROW, COLUMN, MATRIX, TEXTSTRING, INDEX
+		modifier?: 'RECORDSET' | 'VALUE' | 'ROW' | 'COLUMN' | 'MATRIX' | 'TEXTSTRING' | 'INDEX';
 		columnlookup: number; // how many rows to lookup to define columns
 		autovertex: boolean; // create vertex if not found
 		usedbo: boolean; // use dbo as current database (for partial T-SQL comaptibility)
@@ -30,12 +31,12 @@ declare module 'alasql' {
 		oracle: boolean;
 		sqlite: boolean;
 		orientdb: boolean;
-		excel: any;
+		excel?: xlsx.WorkBook; // now typed
 	}
 
 	// compiled Statement
 	interface AlaSQLStatement {
-		(params?: any, cb?: AlaSQLCallback, scope?: any): any;
+		<T = unknown>(params?: Record<string, unknown>, cb?: AlaSQLCallback<T>, scope?: unknown): T;
 	}
 
 	// abstract Syntax Tree
@@ -43,22 +44,9 @@ declare module 'alasql' {
 		compile(databaseid: string): AlaSQLStatement;
 	}
 
-	// https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/es6-promise/es6-promise.d.ts
-	interface Thenable<T> {
-		then<U>(
-			onFulfilled?: (value: T) => U | Thenable<U>,
-			onRejected?: (error: any) => U | Thenable<U>
-		): Thenable<U>;
-		then<U>(
-			onFulfilled?: (value: T) => U | Thenable<U>,
-			onRejected?: (error: any) => void
-		): Thenable<U>;
-		catch<U>(onRejected?: (error: any) => U | Thenable<U>): Thenable<U>;
-	}
-
 	// see https://github.com/alasql/alasql/wiki/User%20Defined%20Functions
 	interface userDefinedFunction {
-		(...x: any[]): any;
+		(...x: unknown[]): unknown;
 	}
 
 	interface userDefinedFunctionLookUp {
@@ -67,7 +55,7 @@ declare module 'alasql' {
 
 	// see https://github.com/alasql/alasql/wiki/User%20Defined%20Functions
 	interface userAggregator {
-		(value: any, accumulator: any, stage: number): any;
+		(value: unknown, accumulator: unknown, stage: number): unknown;
 	}
 
 	interface userAggregatorLookUp {
@@ -75,7 +63,13 @@ declare module 'alasql' {
 	}
 
 	interface userFromFunction {
-		(dataReference: any, options: any, callback: any, index: any, query: any): any;
+		(
+			dataReference: unknown,
+			options: unknown,
+			callback: (res: unknown) => void,
+			index: unknown,
+			query: unknown
+		): void;
 	}
 
 	interface userFromFunctionLookUp {
@@ -117,7 +111,7 @@ declare module 'alasql' {
 		 * @type {any[]}
 		 * @memberof table
 		 */
-		data: any[];
+		data: unknown[];
 	}
 
 	/**
@@ -142,25 +136,31 @@ declare module 'alasql' {
 		new (databaseid?: string): Database;
 		databaseid: string;
 		dbversion: number;
-		tables: {[key: string]: any};
-		views: {[key: string]: any};
-		triggers: {[key: string]: any};
-		indices: {[key: string]: any};
-		objects: {[key: string]: any};
+		tables: {[key: string]: unknown};
+		views: {[key: string]: unknown};
+		triggers: {[key: string]: unknown};
+		indices: {[key: string]: unknown};
+		objects: {[key: string]: unknown};
 		counter: number;
-		sqlCache: {[key: string]: any};
+		sqlCache: {[key: string]: unknown};
 		sqlCacheSize: number;
-		astCache: {[key: string]: any};
-		resetSqlCache: () => void;
-		exec: (sql: string, params?: object, cb?: Function) => any;
-		autoval: (tablename: string, colname: string, getNext: boolean) => any;
+		astCache: {[key: string]: unknown};
+		resetSqlCache(): void;
+		exec<T = unknown>(sql: string, params?: Record<string, unknown>, cb?: AlaSQLCallback<T>): T;
+		autoval(tablename: string, colname: string, getNext: boolean): unknown;
 	}
+
 	interface AlaSQL {
 		options: AlaSQLOptions;
 		error: Error;
-		(sql: any, params?: any, cb?: AlaSQLCallback, scope?: any): any;
-		parse(sql: any): AlaSQLAST;
-		promise(sql: any, params?: any): Thenable<any>;
+		<T = unknown>(
+			sql: string,
+			params?: Record<string, unknown>,
+			cb?: AlaSQLCallback<T>,
+			scope?: unknown
+		): T;
+		parse(sql: string): AlaSQLAST;
+		promise<T = unknown>(sql: string, params?: Record<string, unknown>): Promise<T>;
 		fn: userDefinedFunctionLookUp;
 		from: userFromFunctionLookUp;
 		aggr: userAggregatorLookUp;
@@ -200,7 +200,7 @@ declare module 'alasql' {
 
 		/**
 		 * Array of the tables in the default database (called alasql). If
-		 * the database is changes via a USE statement or the use method, this
+		 * the database is changed via a USE statement or the use method, this
 		 * becomes the tables in the new database.
 		 *
 		 * @type {tableLookUp}