Go to file
2015-12-08 10:40:52 -05:00
docs Remove transpiling, drop node < 4, start moving tests to mocha/chai 2015-12-03 20:43:42 -05:00
lib More style fixes 2015-12-08 10:40:52 -05:00
test Even more code coverage 2015-12-08 10:06:29 -05:00
.gitignore Update some metadata config files 2015-11-19 14:17:01 -05:00
.istanbul.yml Move from grunt to gulp 2015-11-20 09:14:09 -05:00
.jscsrc Start of some code style cleanup 2015-12-07 15:58:31 -05:00
.npmignore Update some metadata to publish to npm 2014-10-28 09:46:27 -04:00
.travis.yml Increase code coverage 2015-12-07 12:03:42 -05:00
gulpfile.js More style fixes 2015-12-07 17:03:36 -05:00
package.json More style fixes 2015-12-07 17:03:36 -05:00
README.md Remove troublesome/unstable sqlite3 adapter. Dblite supports sqlite3, and actually installs reliably 2015-01-28 16:10:10 -05:00
sonar-project.properties Remove transpiling, drop node < 4, start moving tests to mocha/chai 2015-12-03 20:43:42 -05:00

#CI-Node-query

A node query builder for various SQL databases, based on CodeIgniter's query builder.

Build Status

Supported adapters

  • mysql
  • mysql2
  • pg
  • dblite
  • node-firebird

Installation

npm install ci-node-query

Basic use

var nodeQuery = require('ci-node-query');

var connection = ... // Database module connection 

// Three arguments: database type, database connection, database connection library 
var query = nodeQuery.init('mysql', connection, 'mysql2');

// The third argument is optional if the database connection library has the same name as the adapter, eg..
nodeQuery.init('mysql', connection, 'mysql');
// Can be instead
nodeQuery.init('mysql', connection);

// You can also retrieve the instance later
query = nodeQuery.getQuery();

query.select('foo')
	.from('bar')
	.where('x', 3)
	.orWhere({y: 2})
	.join('baz', 'baz.boo = bar.foo', 'left')
	.orderBy('x', 'DESC')
	.limit(2, 3)
	.get(function(/* Adapter dependent arguments */) {
		// Database module result handling
	});

Security notes

As of version 2, where and having type methods parse the values passed to look for function calls. While values passed are still passed as query parameters, take care to avoid passing these kinds of methods unfiltered input. SQL function arguments are not currently parsed, so they need to be properly escaped for the current database.

Additional help

  • Generated documentation is in the docs/ folder
  • tests/query-builder-base.js contains a lot of usage examples
  • The tests/adapters folder contains examples of how to set up a connection for the appropriate database library
  • The documentation generated for the latest dev build is also Available