first commit

packages/nodes-base/nodes/Oracle/Sql/test/utils.test.ts

@@ -0,0 +1,238 @@
+import { DateTime } from 'luxon';
+import * as oracleDBTypes from 'oracledb';
+
+import type { ExecuteOpBindParam } from '../helpers/interfaces';
+import {
+	addSortRules,
+	getBindParameters,
+	getCompatibleValue,
+	getOutBindDefsForExecute,
+} from '../helpers/utils';
+
+describe('Test addSortRules', () => {
+	it('should ORDER BY ASC', () => {
+		const query = 'SELECT * FROM "scott"."employees"';
+		const sortRules = [{ column: 'id', direction: 'ASC' }];
+
+		const updatedQuery = addSortRules(query, sortRules);
+
+		expect(updatedQuery).toEqual(`${query} ORDER BY "id" ASC`);
+	});
+
+	it('should ORDER BY DESC', () => {
+		const query = 'SELECT * FROM "scott"."employees"';
+		const sortRules = [{ column: 'id', direction: 'DESC' }];
+
+		const updatedQuery = addSortRules(query, sortRules);
+
+		expect(updatedQuery).toEqual(`${query} ORDER BY "id" DESC`);
+	});
+
+	it('should handle multiple sort rules', () => {
+		const query = 'SELECT * FROM "scott"."employees"';
+		const sortRules = [
+			{ column: 'id', direction: 'ASC' },
+			{ column: 'name', direction: 'DESC' },
+		];
+
+		const updatedQuery = addSortRules(query, sortRules);
+
+		expect(updatedQuery).toEqual(`${query} ORDER BY "id" ASC, "name" DESC`);
+	});
+
+	it('should ignore incorrect direction', () => {
+		const query = 'SELECT * FROM "scott"."employees"';
+		const sortRules = [{ column: 'id', direction: 'SELECT * ' }];
+
+		const updatedQuery = addSortRules(query, sortRules);
+
+		expect(updatedQuery).toEqual(`${query} ORDER BY "id" ASC`); // by default we just use ASC
+	});
+});
+
+describe('Test returning Clause', () => {
+	it('should add RETURNING clause', () => {
+		const query =
+			'INSERT INTO "VECTOR"."FRUITS" ("FRUIT_ID","PRICE_PER_KG","FRUIT_NAME") VALUES (:0,:1,:2)';
+		const metaData = {
+			COLOR: {
+				type: 'VARCHAR2',
+				nullable: true,
+				maxSize: 256,
+			},
+			FRUIT_ID: {
+				type: 'NUMBER',
+				nullable: false,
+				maxSize: 22,
+			},
+			FRUIT_NAME: {
+				type: 'VARCHAR2',
+				nullable: false,
+				maxSize: 256,
+			},
+			PRICE_PER_KG: {
+				type: 'NUMBER',
+				nullable: true,
+				maxSize: 22,
+			},
+		};
+		const outputColumns = ['FRUIT_NAME'];
+		const bindInfo = [
+			{
+				type: oracleDBTypes.NUMBER,
+			},
+			{
+				type: oracleDBTypes.NUMBER,
+			},
+			{
+				type: oracleDBTypes.STRING,
+				maxSize: 10000000,
+			},
+		];
+		const bindIndex = 3;
+		const expectedQuery = `${query} RETURNING "FRUIT_NAME" INTO :3`;
+
+		const updatedQuery = getOutBindDefsForExecute(
+			query,
+			metaData,
+			outputColumns,
+			bindInfo,
+			bindIndex,
+		);
+
+		expect(updatedQuery).toEqual(expectedQuery);
+	});
+});
+
+describe('Test getCompatibleValue ', () => {
+	it('Verify DateTime object is accepted', () => {
+		const jsDate = new Date(2024, 0, 1, 14, 30, 0);
+		const dtUTC = DateTime.fromJSDate(jsDate, { zone: 'utc' });
+		const result = getCompatibleValue('DATE', dtUTC);
+
+		expect(result).toBeInstanceOf(Date);
+	});
+});
+
+describe('Test getBindParameters ', () => {
+	it('Verify different types are accepted', () => {
+		const query = `INSERT INTO demo_all_types (id, col_number, col_varchar, col_char, col_date, col_timestamp, col_blob, col_json, col_bool, col_vector)
+		VALUES (:pid, 12345.67, 'Hello World', 'ABC', DATE '2024-05-01', TIMESTAMP '2024-05-01 10:15:30', :pblob, :pjs, TRUE, :pvecsp)`;
+		const paramList: ExecuteOpBindParam[] = [
+			{
+				name: 'pblob',
+				bindDirection: 'in',
+				datatype: 'blob',
+				valueBlob: Buffer.from([
+					98, 105, 110, 97, 114, 121, 95, 100, 97, 116, 97, 95, 104, 101, 114, 101, 32, 102, 111,
+					114, 32, 66, 76, 79, 66,
+				]),
+				parseInStatement: false,
+			},
+			{
+				name: 'pjs',
+				bindDirection: 'in',
+				datatype: 'json',
+				valueJson: {
+					user: 'John',
+					active: true,
+					roles: ['admin', 'developer'],
+				},
+				parseInStatement: false,
+			},
+			{
+				name: 'pvecsp',
+				bindDirection: 'in',
+				datatype: 'sparse',
+				valueSparse: {
+					dimensions: 4,
+					indices: [0, 2],
+					values: [3, 4],
+				},
+				parseInStatement: false,
+			},
+			{
+				name: 'pid',
+				bindDirection: 'in',
+				datatype: 'number',
+				valueNumber: 2471,
+				parseInStatement: false,
+			},
+		];
+
+		const expectedBindParams: any = {
+			pblob: {
+				type: oracleDBTypes.BLOB,
+				val: Buffer.from([
+					98, 105, 110, 97, 114, 121, 95, 100, 97, 116, 97, 95, 104, 101, 114, 101, 32, 102, 111,
+					114, 32, 66, 76, 79, 66,
+				]),
+				dir: 3001,
+			},
+			pjs: {
+				type: oracleDBTypes.DB_TYPE_JSON,
+				val: {
+					user: 'John',
+					active: true,
+					roles: ['admin', 'developer'],
+				},
+				dir: 3001,
+			},
+			pvecsp: {
+				type: oracleDBTypes.DB_TYPE_VECTOR,
+				val: new oracleDBTypes.SparseVector({
+					indices: new Uint32Array([0, 2]),
+					values: new Float64Array([3, 4]),
+					numDimensions: 4,
+				}),
+				dir: 3001,
+			},
+			pid: {
+				type: oracleDBTypes.NUMBER,
+				val: 2471,
+				dir: 3001,
+			},
+		};
+		let updatedQuery: string;
+		let bindParameters: oracleDBTypes.BindParameters;
+
+		// test Sparse Vector
+		({ updatedQuery, bindParameters } = getBindParameters(query, paramList));
+		expect(updatedQuery).toEqual(query);
+		expect(bindParameters).toEqual(expectedBindParams);
+
+		// test VECTOR type
+		paramList[2] = {
+			name: 'pvecsp',
+			bindDirection: 'in',
+			datatype: 'vector',
+			valueVector: [3, 4, 5, 6, 78],
+			parseInStatement: false,
+		};
+		expectedBindParams.pvecsp = {
+			type: oracleDBTypes.DB_TYPE_VECTOR,
+			val: [3, 4, 5, 6, 78],
+			dir: 3001,
+		};
+		({ updatedQuery, bindParameters } = getBindParameters(query, paramList));
+		expect(updatedQuery).toEqual(query);
+		expect(bindParameters).toEqual(expectedBindParams);
+
+		//  test null value
+		paramList[2] = {
+			name: 'pvecsp',
+			bindDirection: 'in',
+			datatype: 'vector',
+			valueVector: null,
+			parseInStatement: false,
+		};
+		expectedBindParams.pvecsp = {
+			type: oracleDBTypes.DB_TYPE_VECTOR,
+			val: null,
+			dir: 3001,
+		};
+		({ updatedQuery, bindParameters } = getBindParameters(query, paramList));
+		expect(updatedQuery).toEqual(query);
+		expect(bindParameters).toEqual(expectedBindParams);
+	});
+});