sql-love 1.0.3 → 1.0.4

package/dist/index.mjs

@@ -0,0 +1,16 @@
+var c=class{query;constructor(t){this.query=t}_stripComments(t){return t=t.replace(/\/\*[\s\S]*?\*\//g,""),t=t.replace(/--([\r\n]|\s+[^\r\n]+[\r\n])/g,""),t=t.replace(/#[^\r\n]+[\r\n]/g,""),t}_extractSubQueries(t){let e={},n=0,s=r=>{let o=`~~SUBQUERY_${n++}~~`;return e[o]=r,o};return t=t.replace(/\(\s*SELECT\s+.+\)\s+AS\s+[^\s,]+/,s),t=t.replace(/\bIF\s*\(.+\)\s+AS\s+[^\s,]+/,s),t=t.replace(/\bIN\s*\(\s*SELECT\s.+?\)/,s),{sql:t,subQueries:e}}_injectSubQueries(t){let e=s=>t[s]||s,n=s=>s.replace(/~~SUBQUERY_\d+~~/g,e);this.query._columns=this.query._columns.map(e),this.query._joins=this.query._joins.map(n),this.query._wheres=this.query._wheres.map(n),this.query._havings=this.query._havings.map(n)}_split(t){let e=/(?:^|\s)(SELECT|FROM|(?:INNER|LEFT\s+OUTER|RIGHT\s+OUTER|LEFT|RIGHT|CROSS|FULL|FULL\s+OUTER)\s+JOIN|WHERE|GROUP\s+BY|HAVING|ORDER\s+BY|LIMIT|OFFSET|FETCH\s+NEXT)\b/i;return t.split(e)}parse(t){let e=this._stripComments(t),{sql:n,subQueries:s}=this._extractSubQueries(e),r=this._split(n),o=1;for(;o<r.length;){let l=r[o++].trim().toUpperCase().replace(/\s+/g,"_"),h=r[o++].trim(),a=`_handle${l}`;this[a](h)}return this._injectSubQueries(s),!0}_handleSELECT(t){let e=t.split(/s*,s*/),n="";e.forEach((s,r)=>{if(r===0){let o=/^(SQL_CALC_FOUND_ROWS)\s+/i,u=s.match(o);u&&(this.query.option(u[1]),s=s.replace(o,""))}n.length?s.indexOf(")")>0?(n+=s,this.query.column(n.trim()),n=""):n+=s+",":s.match(/\([^)]+$/)?n=s+",":this.query.column(s.trim())})}_handleFROM(t){t.split(/\s*,\s*/).forEach(n=>this.query.table(n))}_handleINNER_JOIN(t){this.query.innerJoin(t)}_handleLEFT_JOIN(t){this.query.leftJoin(t)}_handleLEFT_OUTER_JOIN(t){this.query.leftOuterJoin(t)}_handleRIGHT_JOIN(t){this.query.rightJoin(t)}_handleRIGHT_OUTER_JOIN(t){this.query.rightOuterJoin(t)}_handleCROSS_JOIN(t){this.query.crossJoin(t)}_handleFULL_JOIN(t){this.query.fullJoin(t)}_handleFULL_OUTER_JOIN(t){this.query.fullOuterJoin(t)}_handleWHERE(t){/^(1|'1'|true)$/i.test(t)?this.query._wheres.push(t):this._handleConditions("where",t)}_handleHAVING(t){this._handleConditions("having",t)}_handleConditions(t,e){e.split(/\bAND\b/i).forEach(s=>{let r=s.split(/\bOR\b/i).map(o=>o.trim());if(r.length===1){let o=t;this.query[o](r[0])}else{let o=t==="where"?"orWhere":"orHaving";this.query[o](r.map(u=>[u]))}})}_handleGROUP_BY(t){t.split(/\s*,\s*/).forEach(n=>this.query.groupBy(n))}_handleORDER_BY(t){t.split(/\s*,\s*/).forEach(n=>this.query.orderBy(n))}_handleLIMIT(t){let e=t.match(/^(\d+|\?|:\w+)\s*,\s*(\d+|\?|:\w+)$/);e?(this.query.offset(e[1]),this.query.limit(e[2])):(t=t.replace(/ ROWS$/i,""),this.query.limit(t))}_handleOFFSET(t){t=t.replace(/^(\d+) ROWS$/i,"$1"),this.query.offset(t)}_handleFETCH_NEXT(t){t=t.replace(/^(\d+) ROWS ONLY$/i,"$1"),this.query.limit(t)}};function m(i,t){let e=0,n=i.indexOf(t);for(;n!==-1;)e+=1,n=i.indexOf(t,n+1);return e}var _=i=>i==null||i===!1||isNaN(i),f="mysql",y=class i{_bindings=[];_options=[];_tables=[];_columns=[];_joins=[];_wheres=[];_groupBys=[];_havings=[];_orderBys=[];_limit;_offset;_page;constructor(t=null,e=null){if(t){if(e){let n=Object.keys(e),s=new RegExp(`:(${n.join("|")})`,"g");t=t.replace(s,(r,o)=>(this._bindings.push(e[o]),`__BOUND_${this._bindings.length-1}__`))}new c(this).parse(t)}}static setDefaultEngine(t){return f=t,i}compile({engine:t=f,bindingIndex:e=1}={}){let n=["SELECT",this._options.length?`  ${this._options.join(`
+  `)}`:null,this._columns.length?`  ${this._columns.join(`,
+  `)}`:`  *
+`,`FROM ${this._tables.join(", ")}`,this._joins.length?this._joins.join(`
+`):null,this._wheres.length?`WHERE ${this._wheres.join(`
+  AND `)}`:null,this._groupBys.length?`GROUP BY ${this._groupBys.join(`,
+  `)}`:null,this._havings.length?`HAVING ${this._havings.join(`
+  AND `)}`:null,this._orderBys.length?`ORDER BY ${this._orderBys.join(`,
+  `)}`:null];if(this._page>0){let l=(this._page-1)*this._limit;n.push(this._compileOFFSET(t,l)),n.push(this._compileLIMIT(t,this._limit))}else this._offset&&n.push(this._compileOFFSET(t,this._offset)),this._limit&&n.push(this._compileLIMIT(t,this._limit));let s=n.filter(Boolean).join(`
+`).trim(),r,o=[];if(t==="pg"){let l=e;r=(h,a)=>(o.push(this._bindings[a]),"$"+l++)}else r=(l,h)=>(o.push(this._bindings[h]),"?");return{sql:s.replace(/__BOUND_(\d+)__/g,r),bindings:o}}_compileLIMIT(t,e){if(t==="pg"||t==="mysql")return`LIMIT ${e}`;if(t==="mssql")return`FETCH NEXT ${e} ROWS ONLY`}_compileOFFSET(t,e){if(t==="pg"||t==="mysql")return`OFFSET ${e}`;if(t==="mssql"||t==="oracle")return`OFFSET ${e} ROWS`}compileCount({countExpr:t="*",engine:e=f,bindingIndex:n=1}={}){let s=this.getFoundRowsQuery(t),{sql:r,bindings:o}=s.compile({engine:e,bindingIndex:n});return this._havings.length===0?{sql:r,bindings:o}:{sql:`SELECT COUNT(*) AS found_rows
+FROM (
+${r.replace(/\n/g,`
+	`)}
+) AS subquery_results`,bindings:o}}compileUnion(t,{engine:e=f,bindingIndex:n=1}={}){let s=this.compile({engine:e,bindingIndex:n}),r=t.compile({engine:e,bindingIndex:s.bindings.length+n});return{sql:`(${s.sql})
+UNION
+(${r.sql})`,bindings:[...s.bindings,...r.bindings]}}reset(t=null){if(Array.isArray(t))return t.forEach(e=>this.reset(e)),this;if(t){let e=["option","column","table","where","having","groupBy","orderBy"],n="_"+t.replace(/s$/,"");e.indexOf(t)>-1&&(n+="s");let s=["limit","offset","page"].indexOf(t)>-1;this[n]=s?null:[]}else this._options=[],this._columns=[],this._tables=[],this._joins=[],this._wheres=[],this._groupBys=[],this._havings=[],this._orderBys=[],this._limit=null,this._offset=null,this._page=null,this._bindings=[];return this}getClone(){let t=new i;return t._options=[...this._options],t._columns=[...this._columns],t._tables=[...this._tables],t._joins=[...this._joins],t._wheres=[...this._wheres],t._havings=[...this._havings],t._groupBys=[...this._groupBys],t._orderBys=[...this._orderBys],t._limit=this._limit,t._offset=this._offset,t._page=this._page,t._bindings=[...this._bindings],t}getFoundRowsQuery(t="*"){if(this._havings.length===0){let e=this.getClone();return e._columns=[`COUNT(${t}) AS found_rows`],e._options=[],e._groupBys=[],e._orderBys=[],e._limit=null,e._offset=null,e._page=null,e}else{let e=this.getClone();return e._limit=null,e._offset=null,e._page=null,e}}select(t){return this._columns=this._columns.concat(t),this}columns(t){return this._columns=this._columns.concat(t),this}column(t){return this._columns.push(t),this}option(t){return this._options.push(t),this}table(t){return this._tables.push(t),this}tables(t){return this._tables.push(...t),this}from(t){return this._tables.push(t),this}_addJoin(t,e,n=[]){n.length>0&&(e=e.replace(/\?/g,()=>(this._bindings.push(n.shift()),`__BOUND_${this._bindings.length-1}__`))),this._joins.push(`${t} ${e}`)}join(t,e=[]){return this._addJoin("JOIN",t,e),this}leftJoin(t,e=[]){return this._addJoin("LEFT JOIN",t,e),this}fullJoin(t,e=[]){return this._addJoin("FULL JOIN",t,e),this}rightJoin(t,e=[]){return this._addJoin("RIGHT JOIN",t,e),this}crossJoin(t,e=[]){return this._addJoin("CROSS JOIN",t,e),this}innerJoin(t,e=[]){return this._addJoin("INNER JOIN",t,e),this}leftOuterJoin(t,e=[]){return this._addJoin("LEFT OUTER JOIN",t,e),this}fullOuterJoin(t,e=[]){return this._addJoin("FULL OUTER JOIN",t,e),this}rightOuterJoin(t,e=[]){return this._addJoin("RIGHT OUTER JOIN",t,e),this}unjoin(t){return Array.isArray(t)?(t.forEach(e=>this.unjoin(e)),this):(this._joins=this._joins.filter(e=>!new RegExp(`JOIN ${t}\\b`).test(e)),this)}_conditions(t,e){let n=e.length,[s,r,o]=e;if(typeof s=="object"){for(let l of Object.entries(s))this._conditions(t,l);return this}if(n===1)return t.push(s),this;if(n===2&&Array.isArray(r)&&r.length>0&&m(s,"?")===r.length){let l=r,h=s.replace(/\?/g,()=>(this._bindings.push(l.shift()),`__BOUND_${this._bindings.length-1}__`));return t.push(h),this}else if(n===2){o=r;let l=s.split(" ");s=l.shift(),r=l.join(" ")}(typeof r!="string"||r==="")&&(r="="),r=r.toLocaleUpperCase();let u=r.match(/^(LIKE|NOT LIKE|ILIKE|NOT ILIKE)(?: (\?|\?%|%\?|%\?%))?$/i);if(r==="NOT BETWEEN"||r==="BETWEEN"){let l=this._bindings.length,h=this._bindings.length+1;t.push(`${s} ${r} __BOUND_${l}__ AND __BOUND_${h}__`),this._bindings.push(o[0],o[1])}else if(u){let l=u[1].toUpperCase(),h=u[2]||"?";if(Array.isArray(o)){let a=[];for(let T of o)a.push(`${s} ${l} __BOUND_${this._bindings.length}__`),this._bindings.push(h.replace("?",T));let d=a.join(" OR ");t.push(`(${d})`)}else t.push(`${s} ${l} __BOUND_${this._bindings.length}__`),this._bindings.push(h.replace("?",o||""))}else if(o===null)t.push(r==="="?`${s} IS NULL`:`${s} IS NOT NULL`);else if(Array.isArray(o)){let l=[];for(let a=0;a<o.length;a++)l.push(`__BOUND_${this._bindings.length}__`),this._bindings.push(o[a]);let h=l.join(", ");t.push(r==="="||r==="IN"?`${s} IN(${h})`:`${s} NOT IN(${h})`)}else r==="IN"||r==="NOT IN"?(t.push(`${s} ${r}(__BOUND_${this._bindings.length}__)`),this._bindings.push(o)):(t.push(`${s} ${r} __BOUND_${this._bindings.length}__`),this._bindings.push(o));return this}groupBy(t){return this._groupBys.push(t),this}where(...t){return this._conditions(this._wheres,t),this}whereBetween(t,e){return!_(e[0])&&!_(e[1])?this.where(t,"BETWEEN",e):!_(e[0])&&_(e[1])?this.where(t,">=",e[0]):_(e[0])&&!_(e[1])&&this.where(t,"<=",e[1]),this}_orConditions(t){let e=[];if(Array.isArray(t))for(let s of t)Array.isArray(s)?this._conditions(e,s):this._conditions(e,[s]);else for(let[s,r]of Object.entries(t)){let o=[];this._conditions(o,[s,r]),e.push(o[0])}let n=e.join(" OR ");return n.startsWith("(")&&n.endsWith(")")?n.slice(1,-1):n}orWhere(t){let e=this._orConditions(t);return this.where(`(${e})`),this}orHaving(t){let e=this._orConditions(t);return this.having(`(${e})`),this}having(...t){return this._conditions(this._havings,t),this}orderBy(t,e=null){if(e)this._orderBys.push(`${t} ${e}`);else{let n=t.replace(/^-(.+)/,"$1 DESC");this._orderBys.push(n)}return this}sortField(t,e={}){let n="ASC";t.startsWith("-")&&(n="DESC",t=t.slice(1));let s=e[t]||t;return this.orderBy(s,n),this}_isEntirelyDigits(t){return/^(0|[1-9]\d*)$/.test(t)}_isEntirelyDigitsNoZeros(t){return/^[1-9]\d*$/.test(t)}limit(t){if(typeof t=="string")t=t.trim(),this._isEntirelyDigitsNoZeros(t)&&(this._limit=parseInt(t,10));else if(typeof t=="number"&&Number.isInteger(t)&&t>=1)this._limit=t;else throw new Error(`SelectBuilder: "limit(n)" must receive a positive integer (got "${t}")`);return this}offset(t){if(typeof t=="string"&&this._isEntirelyDigits(t.trim()))this._offset=parseInt(t,10);else if(typeof t=="number"&&Number.isInteger(t)&&t>=0)this._offset=t;else throw new Error(`SelectBuilder: "offset(n)" must receive a positive integer (got "${t}")`);return this}page(t){if(typeof t=="string"&&this._isEntirelyDigitsNoZeros(t.trim()))this._page=parseInt(t,10);else if(typeof t=="number"&&Number.isInteger(t)&&t>=1)this._page=t;else throw new Error('SelectBuilder: "page(n)" must receive a positive integer');return this}};function S(i,t){let e=0,n={};for(let s of t){if(!(i in s))throw new Error(`Column "${String(i)}" is not present in record ${e}`);n[s[i]]||(n[s[i]]=[]),n[s[i]].push(s),e++}return n}function E(i,t){let e=0,n={};for(let s of t){if(!(i in s))throw new Error(`Column "${String(i)}" is not present in record ${e}`);n[s[i]]=s,e++}return n}function R(i,t,e){let n={},s=0;for(let r of e){if(!(i in r))throw new Error(`Column "${String(i)}" is not present in record ${s}`);if(!(t in r))throw new Error(`Column "${String(t)}" is not present in record ${s}`);s++,n[String(r[i])]=r[t]}return n}function g(i,t){t=Number(t)||0;let e=Number(i._limit)||null,n=null;t===0?n=null:i._page?n=Number(i._page):i._limit&&i._offset?n=Math.floor(Number(i._offset)/Number(i._limit))+1:i._limit&&!i._offset?n=1:n=null;let s=t===0||e===null?0:Math.ceil(t/e)||0,r=n===1,o=s>0&&n===s,u=s===0?null:n-1||null,l=s>0&&n+1<=s?n+1:null;return{page:n,prevPage:u,nextPage:l,perPage:e,numPages:s,total:t,isFirst:r,isLast:o}}function b(i,t,e){return new Promise((n,s)=>{i.query(t,e,(r,o,u)=>{if(r){s(r);return}n([o,u])})})}async function N(i,t){let{sql:e,bindings:n}=t.compile({engine:"mysql"});return b(i,e,n)}async function B(i,t,{countExpr:e="*"}={}){let{sql:n,bindings:s}=t.compile({engine:"mysql"}),[r,o]=await b(i,n,s);if(r.length>0){let{sql:u,bindings:l}=t.compileCount({engine:"mysql",countExpr:e}),[h]=await b(i,u,l),a=h[0].found_rows;return{records:r,total:a,pagination:g(t,a),fields:o}}else return{records:r,total:0,pagination:g(t,0),fields:o}}async function $(i,t){let{sql:e,bindings:n}=t.compile({engine:"mysql"});return i.query(e,n)}async function I(i,t,{engine:e="mysql",countExpr:n="*"}={}){let{sql:s,bindings:r}=t.compile({engine:e}),[o,u]=await i.query(s,r);if(o.length>0){let{sql:l,bindings:h}=t.compileCount({engine:e,countExpr:n}),[a]=await i.query(l,h),d=a[0].found_rows;return{records:o,total:d,pagination:g(t,d),fields:u}}else return{records:o,total:0,pagination:g(t,0),fields:u}}function p(i){if(typeof i=="bigint"){let t=Number(i);return i==t?t:i.toString()}return i}function O(i){let t={};for(let e in i)Object.prototype.hasOwnProperty.call(i,e)&&(t[e]=p(i[e]));return t}function C(i){return i.map(O)}function w(i){return JSON.stringify(i,(t,e)=>p(e))}async function x(i,t,{engine:e=void 0}={}){let{sql:n,bindings:s}=t.compile({engine:e});return i.$queryRawUnsafe(n,...s)}async function q(i,t,{engine:e=void 0,countExpr:n="*"}={}){let{sql:s,bindings:r}=t.compile({engine:e}),o=await i.$queryRawUnsafe(s,...r);if(o.length>0){let{sql:u,bindings:l}=t.compileCount({engine:e,countExpr:n}),h=await i.$queryRawUnsafe(u,...l),a=p(h[0].found_rows);return{records:o,total:a,pagination:g(t,a)}}else return{records:o,total:0,pagination:g(t,0)}}export{c as Parser,y as SelectBuilder,S as extractGrouped,E as extractIndexed,R as extractLookup,g as getPagination,N as runMysql,$ as runMysqlAsync,I as runMysqlAsyncWithCount,B as runMysqlWithCount,x as runPrisma,q as runPrismaWithCount,O as toSafeJsonRecord,C as toSafeJsonRecords,w as toSafeJsonString,p as toSafeJsonValue};

package/package.json

@@ -1,18 +1,34 @@
 {
   "name": "sql-love",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Build SQL queries with JavaScript",
-  "main": "dist/index.js",
   "type": "module",
-  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.cjs",
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
   "scripts": {
     "test": "vitest run",
     "test-watch": "vitest",
     "coverage": "vitest run --coverage",
-    "clean": "rimraf dist/ && mkdir dist && touch dist/.gitkeep",
-    "build": "npm run clean && npx -p typescript tsc --project tsconfig.build.json",
-    "release": "npm i && npm run build && npm publish"
+    "view-coverage": "open ./coverage/lcov-report/index.html",
+    "build": "npm run build:clean && npm run build:dts && npm run build:esm && npm run build:cjs",
+    "build:clean": "rimraf dist/ && mkdir dist && touch dist/.gitkeep",
+    "build:dts": "yes | npx dts-bundle-generator -o dist/index.d.ts index.ts",
+    "build:esm": "yes | npx esbuild index.ts --minify --bundle --platform=node --format=esm --outfile=dist/index.mjs",
+    "build:cjs": "yes | npx esbuild index.ts --minify --bundle --platform=node --format=cjs --outfile=dist/index.cjs"
   },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.md"
+  ],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/kensnyder/sql-love.git"
@@ -32,11 +48,12 @@
   },
   "homepage": "https://github.com/kensnyder/sql-love#readme",
   "devDependencies": {
-    "@vitest/coverage-v8": "2.0.2",
+    "@types/node": "22.6.1",
+    "@vitest/coverage-v8": "2.1.1",
     "prettier": "3.3.3",
-    "prettier-plugin-organize-imports": "4.0.0",
+    "prettier-plugin-organize-imports": "4.1.0",
     "rimraf": "6.0.1",
-    "typescript": "5.5.3",
-    "vitest": "2.0.2"
+    "typescript": "5.6.2",
+    "vitest": "2.1.1"
   }
 }

package/.github/workflows/node.js.yml

@@ -1,37 +0,0 @@
-# This workflow will do a clean installation of node dependencies, cache/restore them, build the source code and run tests across different versions of node
-# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-nodejs
-
-name: build
-
-on:
-  push:
-    branches: ['main']
-  pull_request:
-    branches: ['main']
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-
-    strategy:
-      matrix:
-        node-version: [18.x, 20.x]
-        # See supported Node.js release schedule at https://nodejs.org/en/about/previous-releases
-
-    steps:
-      - uses: actions/checkout@v3
-      - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v3
-        with:
-          node-version: ${{ matrix.node-version }}
-          cache: 'npm'
-      - run: |
-          npm ci
-          npm run build
-          npm test
-          npm run coverage
-      - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v3
-        with:
-          token: ${{ secrets.CODECOV_TOKEN }}
-          directory: ./coverage/

package/.prettierrc.json

@@ -1,13 +0,0 @@
-{
-  "plugins": ["prettier-plugin-organize-imports"],
-  "trailingComma": "es5",
-  "printWidth": 80,
-  "tabWidth": 2,
-  "useTabs": false,
-  "semi": true,
-  "singleQuote": true,
-  "bracketSpacing": true,
-  "jsxBracketSameLine": false,
-  "arrowParens": "avoid",
-  "endOfLine": "lf"
-}

package/CHANGELOG.md

@@ -1,39 +0,0 @@
-## Change Log
-
-### v1.0.0 - 12 Dec 2023
-
-- Upgrade to vitest v1
-- More documentation
-- 100% test coverage
-- First stable release
-
-### v0.9.7 - 7 Dec 2023
-
-- Added extractLookup utility
-- Added toSafeJson utilities
-
-### v0.9.6 - 5 Dec 2023
-
-- Utility functions (extractGrouped, extractIndexed, getPagination, runPrisma, runMysql)
-- Added `SelectBuilder.setDefaultEngine(engine)`
-- More documentation
-- Fix `.sortField()` logic
-
-### v0.9.4 - 30 Nov 2023
-
-- Support parsing and building "ILIKE" and "NOT ILIKE"
-
-### v0.9.2 - 30 Nov 2023
-
-- Fixes to readme
-
-### v0.9.1 - 30 Nov 2023
-
-- More documentation
-- GitHub Actions CI
-- Support for parsing "OFFSET # ROWS"
-- Support for parsing "FETCH NEXT # ROWS ONLY"
-
-### v0.9.0 - 29 Nov 2023
-
-- Initial release with `SelectBuilder`

package/CONTRIBUTING.md

@@ -1,85 +0,0 @@
-# Contributing
-
-When contributing to this repository, please note we have a code of conduct;
-please follow it in all your interactions with the project.
-
-## Pull Request Process
-
-1. Ensure all unit tests pass. Add more unit tests if applicable.
-2. Update the README.md with details of change if applicable.
-3. Give maintainers some time to review the changes.
-
-## Code of Conduct
-
-### Our Pledge
-
-In the interest of fostering an open and welcoming environment, we as
-contributors and maintainers pledge to making participation in our project and
-our community a harassment-free experience for everyone, regardless of age, body
-size, disability, ethnicity, gender identity and expression, level of experience,
-nationality, personal appearance, race, religion, or sexual identity and
-orientation.
-
-### Our Standards
-
-Examples of behavior that contributes to creating a positive environment
-include:
-
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
-
-Examples of unacceptable behavior by participants include:
-
-* The use of sexualized language or imagery and unwelcome sexual attention or
-advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or electronic
-  address, without explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-### Our Responsibilities
-
-Project maintainers are responsible for clarifying the standards of acceptable
-behavior and are expected to take appropriate and fair corrective action in
-response to any instances of unacceptable behavior.
-
-Project maintainers have the right and responsibility to remove, edit, or
-reject comments, commits, code, wiki edits, issues, and other contributions
-that are not aligned to this Code of Conduct, or to ban temporarily or
-permanently any contributor for other behaviors that they deem inappropriate,
-threatening, offensive, or harmful.
-
-### Scope
-
-This Code of Conduct applies both within project spaces and in public spaces
-when an individual is representing the project or its community. Examples of
-representing a project or community include using an official project e-mail
-address, posting via an official social media account, or acting as an appointed
-representative at an online or offline event. Representation of a project may be
-further defined and clarified by project maintainers.
-
-### Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by opening a GitHub ticket. All complaints will be reviewed and
-investigated and will result in a response that is deemed necessary and
-appropriate to the circumstances. The project team is obligated to maintain
-confidentiality with regard to the reporter of an incident. Further details of
-specific enforcement policies may be posted separately.
-
-Project maintainers who do not follow or enforce the Code of Conduct in good
-faith may face temporary or permanent repercussions as determined by other
-members of the project's leadership.
-
-### Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
-available at [http://contributor-covenant.org/version/1/4][version]
-
-[homepage]: http://contributor-covenant.org
-[version]: http://contributor-covenant.org/version/1/4/

package/codecov.yml

@@ -1,7 +0,0 @@
-codecov:
-  branch: main
-
-coverage:
-  precision: 1
-  round: down
-  range: '70...100'

package/dist/index.js

@@ -1,9 +0,0 @@
-export { default as Parser } from './src/Parser/Parser';
-export { default as SelectBuilder } from './src/SelectBuilder/SelectBuilder';
-export { default as extractGrouped } from './src/extractGrouped/extractGrouped';
-export { default as extractIndexed } from './src/extractIndexed/extractIndexed';
-export { default as extractLookup } from './src/extractLookup/extractLookup';
-export { default as getPagination } from './src/getPagination/getPagination';
-export { runMysql, runMysqlAsync, runMysqlAsyncWithCount, runMysqlWithCount, } from './src/runMysql/runMysql';
-export { runPrisma, runPrismaWithCount } from './src/runPrisma/runPrisma';
-export { toSafeJsonRecord, toSafeJsonRecords, toSafeJsonString, toSafeJsonValue, } from './src/toSafeJson/toSafeJson';

package/dist/src/Parser/Parser.d.ts

@@ -1,157 +0,0 @@
-import type Select from '../SelectBuilder/SelectBuilder';
-/**
- * Parse SQL and populate onto a Select query object
- */
-export default class Parser {
-    query: Select;
-    /**
-     * Create a new instance
-     * @param query  A Select object on which to build parsed conditions
-     */
-    constructor(query: Select);
-    /**
-     * Strip single-line and multi-line comment blocks
-     * @param sql  The SQL string
-     * @return  The SQL string without comments
-     * @private
-     */
-    _stripComments(sql: string): string;
-    /**
-     * Before splitting into SQL clauses, extract some regex-able subQueries
-     * @param sql  The unparsed sql string
-     * @return  An array with new sql and subQueries
-     * @private
-     */
-    _extractSubQueries(sql: string): {
-        sql: string;
-        subQueries: {};
-    };
-    /**
-     * Inject column subQueries back into this object
-     * @param subQueries  The lookup of extracted subQueries
-     * @private
-     */
-    _injectSubQueries(subQueries: Record<string, string>): void;
-    /**
-     * Split SQL into clauses (used by parse())
-     * @param sql  The SQL to split
-     * @return
-     * @private
-     */
-    _split(sql: string): string[];
-    /**
-     * Get a QuickSelect object representing the given SQL SELECT statement
-     * @param  rawSql  The raw SQL for the SELECT statement
-     * @return True if the SQL was parsed successfully
-     */
-    parse(rawSql: string): boolean;
-    /**
-     * Handle SQL_CALC_FOUND_ROWS and column names
-     * @param clause  The clause after the SELECT
-     * @private
-     */
-    _handleSELECT(clause: string): void;
-    /**
-     * Handle table names
-     * @param clause  The clause after the FROM
-     * @private
-     */
-    _handleFROM(clause: string): void;
-    /**
-     * Handle INNER JOIN statements
-     * @param clause  The clause after the INNER JOIN
-     * @private
-     */
-    _handleINNER_JOIN(clause: string): void;
-    /**
-     * Handle LEFT JOIN statements
-     * @param clause  The clause after the LEFT JOIN
-     * @private
-     */
-    _handleLEFT_JOIN(clause: string): void;
-    /**
-     * Handle LEFT OUTER JOIN statements
-     * @param clause  The clause after the LEFT OUTER JOIN
-     * @private
-     */
-    _handleLEFT_OUTER_JOIN(clause: string): void;
-    /**
-     * Handle RIGHT JOIN statements
-     * @param clause  The clause after the RIGHT JOIN
-     * @private
-     */
-    _handleRIGHT_JOIN(clause: string): void;
-    /**
-     * Handle RIGHT OUTER JOIN statements
-     * @param clause  The clause after the RIGHT OUTER JOIN
-     * @private
-     */
-    _handleRIGHT_OUTER_JOIN(clause: string): void;
-    /**
-     * Handle CROSS JOIN statements
-     * @param clause  The clause after the CROSS JOIN
-     * @private
-     */
-    _handleCROSS_JOIN(clause: string): void;
-    /**
-     * Handle FULL JOIN statements
-     * @param clause  The clause after the FULL JOIN
-     * @private
-     */
-    _handleFULL_JOIN(clause: string): void;
-    /**
-     * Handle FULL OUTER JOIN statements
-     * @param clause  The clause after the FULL OUTER JOIN
-     * @private
-     */
-    _handleFULL_OUTER_JOIN(clause: string): void;
-    /**
-     * Handle WHERE conditions
-     * @param clause  All the conditions after WHERE
-     * @private
-     */
-    _handleWHERE(clause: string): void;
-    /**
-     * Handle HAVING statements
-     * @param clause  All the conditions after HAVING
-     * @private
-     */
-    _handleHAVING(clause: string): void;
-    /**
-     * Build a conditions list
-     * @param type  Either where or having
-     * @param clause  The expressions following the type keyword
-     * @private
-     */
-    _handleConditions(type: 'where' | 'having', clause: string): void;
-    /**
-     * Handle GROUP BY statements
-     * @param clause  The clauses after the GROUP BY
-     * @private
-     */
-    _handleGROUP_BY(clause: string): void;
-    /**
-     * Handle ORDER BY statements
-     * @param clause  The clause after the ORDER BY
-     * @private
-     */
-    _handleORDER_BY(clause: string): void;
-    /**
-     * Handle LIMIT statements including "LIMIT #" and "LIMIT #, #"
-     * @param clause  The clause after the LIMIT
-     * @private
-     */
-    _handleLIMIT(clause: string): void;
-    /**
-     * Handle OFFSET statements
-     * @param clause  The number after the OFFSET
-     * @private
-     */
-    _handleOFFSET(clause: string): void;
-    /**
-     * Handle OFFSET statements
-     * @param clause  The number after the OFFSET
-     * @private
-     */
-    _handleFETCH_NEXT(clause: string): void;
-}