cts.query builder

[ehennum]

Similar to the Java API, reuse the cts.query builder included with the Optic builder for search requests.

[ehennum]

The Java equivalent:

• Add CtsQueryBuilder for search in Java API java-client-api#1260
• https://github.com/marklogic/java-client-api/pull/1261/files/850e237acb560e2863daac6d0846b6d6d033b61a

Something along the following lines should work:

• In lib/plan-builder-base.js, add the existing exportArg function to the exports
• Add a new lib/ctsquery-builder.js module
• Start with the copyright comment and strict pragma
• Import bldrgen = require('./plan-builder-generated.js')
• Define a CtsQueryBuilder class
• In the constructor, set the documented fn, geo, json, map, math, rdf, sem, spell, sql, xdmp, and xs fields to new bldrgen CtsExpr, FnExpr, GeoExpr, JsonExpr, MapExpr, MathExpr, RdfExpr, SemExpr, SpellExpr, SqlExpr, XdmpExpr, and XsExpr objects
• Export a builder object that's an instance of the CtsQueryBuilder class
• In query-builder.js, import bldrbase = require('./plan-builder-base.js')
• Import types = require('./server-types-generated.js')
• Modify the where() function to add a case that tests arg instanceof types.CtsQuery similar to the existing case for arg.$query != null that sets self.whereClause to arg and self.queryType to 'cts'
• Modify the makeSearchBody() function in query-builder.js to add a case for builtQuery.queryType === 'cts' similar to the existing case for builtQuery.queryType === 'qbe' that set the search.ctsast property to the result of bldrbase.exportArg(whereClause)
• Add a ctsQueryBuilder field to the export object for marklogic.js
• Add tests to documents-query.js that uses the ctsQueryBuilder to construct a query and pass it to queryBuilder.where()