A modern, high-performance Node.js driver for SAP SQL Anywhere.

This driver is built using N-API, ensuring a stable and future-proof interface that is independent of the underlying JavaScript engine. It is fully async/await compatible, providing a clean and modern developer experience.

• Node.js: Version 18.0.0 or higher.
• SAP SQL Anywhere: The appropriate SQL Anywhere client libraries must be installed and correctly configured in your environment (e.g., via the $SQLANY environment variable and system path). - These can be downloaded from SAP Support
• If compiling;
  • C++ Toolchain: A C++ compiler and build tools are required for the native addon compilation. This is typically handled by node-gyp. Please see the node-gyp installation guide for platform-specific instructions.

npm install @iqx-limited/sqlanywhere

The installation process will attempt to use pre-built binaries, if that fails, it will automatically compile the native C++ addon for your platform.

If dbcapi is only available as x86_64, you can keep your main Node.js app running natively on ARM and run only the SQL Anywhere driver work in a Rosetta-backed helper process.

Enable bridge mode:

SQLANYWHERE_BRIDGE=1 node app.js

On MacOS ARM, bridge mode automatically starts the helper as:

arch -x86_64 <current-node-exec> <package>/bridge/server.js

Optional overrides:

• SQLANYWHERE_BRIDGE_EXECUTABLE: custom bridge executable (for example, a specific arch path or a wrapper script).
• SQLANYWHERE_BRIDGE_ARGS: JSON array of arguments for the executable.
• SQLANYWHERE_BRIDGE_SERVER: custom bridge server script path.

Example with explicit executable + args:

SQLANYWHERE_BRIDGE=1 \
SQLANYWHERE_BRIDGE_EXECUTABLE=arch \
SQLANYWHERE_BRIDGE_ARGS='["-x86_64","/usr/local/bin/node","/absolute/path/to/node_modules/@iqx-limited/sqlanywhere/bridge/server.js"]' \
node app.js

const sqlanywhere = require('@iqx-limited/sqlanywhere/promise');

// --- For security, use environment variables for credentials ---
const connParams = {
  ServerName: process.env.DB_SERVER || 'demo',
  UserID: process.env.DB_USER || 'DBA',
  Password: process.env.DB_PASSWORD || 'sql'
};

async function main() {
  const connection = sqlanywhere.createConnection();

  try {
    // 1. Connect to the database
    console.log('Connecting...');
    await connection.connect(connParams);
    console.log('Connection successful!');

    // 2. Execute a query with parameters
    const products = await connection.exec(
      'SELECT Name, Description FROM Products WHERE id = ?',
      [301]
    );
    console.log('Query Result:', products[0]);
    // output --> Query Result: { Name: 'Tee Shirt', Description: 'V-neck' }

  } catch (error) {
    console.error('An error occurred:', error);
  } finally {
    // 3. Disconnect when finished
    console.log('Disconnecting...');
    await connection.disconnect();
    console.log('Disconnected.');
  }
}

main();

sqlanywhere.createConnection() Creates a new, uninitialized connection object.

connection.connect(params) Establishes a connection to the database. The params object can contain most valid SQL Anywhere connection properties.

connection.disconnect() or connection.close() Closes the database connection.

connection.exec(sql, [params]) Executes a SQL statement directly.

• For SELECT queries, it returns a Promise that resolves to an array of result objects.
• For DML statements (INSERT, UPDATE, DELETE), it returns a Promise that resolves to the number of affected rows.
• Parameters can be bound using ? placeholders.

connection.prepare(sql) Prepares a SQL statement for later execution. Returns a Promise that resolves to a Statement object.

connection.commit() Commits the current transaction.

connection.rollback() Rolls back the current transaction.

statement.exec([params]) Executes a prepared statement. The return value is the same as connection.exec().

statement.getMoreResults() For procedures or batches that return multiple result sets, this method advances to the next result set. Returns a Promise that resolves to the next array of results. When no more result sets are available, the promise will reject with a "Procedure has completed" message.

statement.drop() Frees the resources associated with the prepared statement on the database server.

This driver provides comprehensive support for a wide range of SQL Anywhere data types, which are automatically mapped to the most appropriate JavaScript types:

// Import from the main package:
import { debugLogging } from '@iqx-limited/sqlanywhere';
// or: const { debugLogging } = require('@iqx-limited/sqlanywhere');

// Or import from the /promise entry point:
import { debugLogging } from '@iqx-limited/sqlanywhere/promise';
// or: const { debugLogging } = require('@iqx-limited/sqlanywhere/promise');

// Then set to true
debugLogging(true);

The project includes a comprehensive test suite that validates all driver functionality against a live database.

1. Configure Credentials: Copy the examples/.env.sample file to a new file named examples/.env and fill in your database connection details.

2. Run Tests: Execute the following command from the examples directory:

   npm run test

• SAP SQL Anywhere Documentation
• SAP SQL Anywhere Developer Q&A Forum