+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ ++ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 | 22x + + + +28x + | import { and } from './where.js'
+
+export { and }
+
+export default and
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 | 22x +22x +22x +22x +22x + + + + + + + + + + +10x +10x +10x +22x +3x +3x + + + + + + +3x + +19x + +10x +1x + + + + +1x + +10x + + +22x + | import assign from './assign.js'
+import id from './identifier.js'
+import jsonPath from './json-path.js'
+import list from './list.js'
+import tsql from './template.js'
+import type S from './sanitised.js'
+
+/**
+ * @returns assigment clause based on provided record, ie. for UPDATE SET.
+ *
+ * `undefined` entries are filtered out.
+ *
+ * Propagates undefined if there are no non-undefined entries.
+ */
+export function assignObject(record: Record<string, unknown>): undefined | S {
+ const assignments: (undefined | S)[] = []
+ const jsonAssignments: Record<string, S> = {}
+ for (const [ lvalue, rvalue ] of Object.entries(record)) {
+ if (lvalue.indexOf('->') !== -1) {
+ const [ llvalue, lrvalue ] = lvalue.split('->')
+ jsonAssignments[llvalue] = tsql`
+ json_modify(
+ ${jsonAssignments[llvalue] ?? id(llvalue)},
+ ${jsonPath(lrvalue)},
+ ${rvalue}
+ )
+ `
+ continue
+ }
+ assignments.push(assign(id(lvalue), rvalue))
+ }
+ for (const [ lvalue, rvalue ] of Object.entries(jsonAssignments)) {
+ const a = assign(id(lvalue), tsql`
+ (
+ ${rvalue}
+ )
+ `)
+ assignments.push(a)
+ }
+ return list(assignments, undefined, ',\n')
+}
+
+export default assignObject
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 | 22x +22x +22x +22x + + + + + + + + + + +31x +9x + +22x +15x + +7x +6x + +1x +1x + + +31x + | import id from './identifier.js'
+import jsonPath from './json-path.js'
+import S from './sanitised.js'
+import tsql from './template.js'
+import type Sid from './sanitised-identifier.js'
+
+/**
+ * @returns assigment operator LHS = RHS.
+ *
+ * `undefined` RHS is propagated.
+ *
+ * `null` RHS is left as is LHS = null.
+ */
+export function assign(lvalue: Sid | string, rvalue: unknown): undefined | S {
+ if (typeof rvalue === 'undefined') {
+ return undefined
+ }
+ if (lvalue instanceof S) {
+ return tsql`${lvalue} = ${rvalue}`
+ }
+ if (lvalue.indexOf('->') === -1) {
+ return tsql`${id(lvalue)} = ${rvalue}`
+ }
+ const [ llvalue, lrvalue ] = lvalue.split('->')
+ return tsql`${id(llvalue)} = json_modify(${id(llvalue)}, ${jsonPath(lrvalue)}, ${rvalue})`
+}
+
+export default assign
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 | 22x +22x +22x +22x +22x +22x +22x +22x + + + + + + + + + + + + + + + + + + + + + + + + + +22x +13442x +9096x + +4346x +1x +75x +9x +4246x + +15x +7x + +8x + + +8x + + +8x + + + + + + +8879x + | import falseValue from './false-value.js'
+import json from './json.js'
+import nstring from './nstring.js'
+import null_ from './null.js'
+import number from './number.js'
+import raw from './raw.js'
+import S from './sanitised.js'
+import trueValue from './true-value.js'
+
+/**
+ * @returns automatically sanitised value.
+ *
+ * Already sanitised values are returned as is.
+ *
+ * `undefined` and `null` return sanitised `null`.
+ *
+ * Finite numbers return sanitised, decimal numbers.
+ *
+ * Booleans return sanitised `1` (true) or `0` (false).
+ *
+ * Strings return sanitised unicode strings, ie. `N'foo'`.
+ *
+ * Dates return ISO strings.
+ *
+ * Buffers return hex literals.
+ *
+ * Other objects return json-stringified, sanitised unicode strings, ie. `{foo:1}` returns `N'{"foo":1}'`.
+ *
+ * @throws {TypeError} for non-finite numbers (not supported by mssql).
+ *
+ * @throws {TypeError} for all other values.
+ */
+export const auto =
+ (value: unknown): S => {
+ if (value instanceof S) {
+ return value
+ }
+ switch (typeof value) {
+ case 'undefined': return null_
+ case 'number': return number(value)
+ case 'boolean': return value ? trueValue : falseValue
+ case 'string': return nstring(value)
+ case 'object': {
+ if (value === null) {
+ return null_
+ }
+ Iif (value instanceof Date) {
+ return nstring(value.toISOString())
+ }
+ Iif (typeof Buffer !== 'undefined' && value instanceof Buffer) {
+ return raw('0x' + value.toString('hex'))
+ }
+ return json(value)
+ }
+ default:
+ throw new TypeError(`Unable to auto generate sql for ${value}.`)
+ }
+ }
+
+export default auto
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 | 22x +22x +22x + + + +22x +1x + + + +22x + | import fallback from './fallback.js' +import id from './identifier.js' +import tsql from './template.js' +import type S from './sanitised.js' + +export const between = + <T>(l: string | S, r: undefined | null | [beginExpression: T, endExpression: T]): undefined | S => + typeof l === 'undefined' || r == null ? + undefined : + tsql`${fallback(l, id)} between ${r[0]} and ${r[1]}` + +export default between + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 | 22x +22x +22x + + + + + + + + +22x + + + + + + + + + +22x + | import id from './identifier.js' +import list from './list.js' +import fallback from './fallback.js' +import type S from './sanitised.js' + +/** + * @returns column projection based on provided record and optional filter. + * + * Propagates `undefined` if there are no non-`undefined` entries. + */ +export const columns = + (record: Record<string, boolean | string | S>, filter: Record<string, boolean> = {}): undefined | S => { + const values: (string | S)[] = [] + for (const key of Object.keys(record)) { + Iif (filter[key] !== false) { + values.push(record[key] === true ? key : record[key] as string | S) + } + } + return list(values.map(_ => fallback(_, id))) + } + +export default columns + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 | + +22x +10x +10x +24x + + +1x + + +10x + + +22x + | /** @returns object without undefined values. */
+const defined =
+ (object: Record<string, unknown>): Record<string, unknown> => {
+ const object_ = Object.assign({}, object)
+ for (const key in object) {
+ if (typeof object_[key] === 'undefined') {
+
+ // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
+ delete object_[key]
+ }
+ }
+ return object_
+ }
+
+export default defined
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 | 22x +22x +22x + + +22x +22x + + + +22x +13x + + + + + + +22x + | import fallback from './fallback.js' +import id from './identifier.js' +import line from './line.js' +import type S from './sanitised.js' +import type Sid from './sanitised-identifier.js' +import tsql from './template.js' +import whereOf from './where.js' + +/** @returns DELETE DML for table with optional WHERE clause. */ +export const delete_ = + (table: Sid | string, where?: S | Record<string, unknown>): S => + line( + tsql`delete from ${id(table)}`, + where ? + tsql`where ${fallback(where, whereOf)}` : + undefined + ) + +export default delete_ + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 | 22x + + + +22x +421x + + +421x +421x +81x + +683x +66x + +421x +421x +6910x +65027x +6909x +6909x + + + +421x + + +421x +6910x + + + +421x + | import isString from './is-string.js' + +/** @internal */ +export const demargin = + (value: string): string => { + Iif (!isString(value)) { + throw new TypeError(`Expected value to be string, got ${value}.`) + } + const lines = value.split('\n') + if ((lines.length > 0) && lines[0].split('').every(_ => _ === ' ')) { + lines.shift() + } + if ((lines.length > 0) && lines[lines.length - 1].split('').every(_ => _ === ' ')) { + lines.pop() + } + let margin = Infinity + for (const line of lines) { + for (let i = 0; i < line.length; i++) { + if (line[i] !== ' ') { + margin = Math.min(margin, i) + break + } + } + } + Iif (margin === Infinity) { + return lines.join('\n') + } + return lines + .map(_ => _.slice(margin)) + .join('\n') + } + +export default demargin + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 | 22x +22x +22x + + + + + + + + + + +22x + + + + + + + +22x + | import fallback from './fallback.js' +import id from './identifier.js' +import template from './template.js' +import type S from './sanitised.js' + +/** + * @returns emulated NULL aware comparision. + * + * MSSQL doesn't support IS DISTINCT FROM comparision directly. + * + * Single invocation of RHS is not guaranteed. + */ +export const distinct = + (lhs: S | string, rhs: unknown): undefined | S => { + Iif (typeof lhs === 'undefined' || typeof rhs === 'undefined') { + return undefined + } + const lhs_ = fallback(lhs, id) + return template`((${lhs_} <> ${rhs} or ${lhs_} is null or ${rhs} is null) and not (${lhs_} is null and ${rhs} is null))` + } + +export default distinct + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 | 22x +22x +22x +22x + + + +22x +53x + + + + + + + + + + + + + +22x +64x + + + +85x + | import fallback from './fallback.js'
+import id from './identifier.js'
+import isNull from './is-null.js'
+import tsql from './template.js'
+import type S from './sanitised.js'
+
+const rhsEq =
+ (rhs: unknown): S =>
+ isNull(rhs) ?
+ tsql`is null` :
+ tsql`= ${rhs}`
+
+/**
+ * @returns comparision expression.
+ *
+ * `null` RHS returns LHS IS NULL.
+ *
+ * `undefined` RHS propagates.
+ *
+ * @see distinct for NULL aware comparision.
+ */
+export const eq =
+ (lhs: S | string, rhs: unknown): undefined | S =>
+ typeof rhs === 'undefined' ?
+ undefined :
+ tsql`${fallback(lhs, id)} ${rhsEq(rhs)}`
+
+export default eq
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 | 22x +22x + + +22x +22x + + + +22x + + + + + +22x + | import fallback from './fallback.js' +import id from './identifier.js' +import type S from './sanitised.js' +import type Sid from './sanitised-identifier.js' +import tsql from './template.js' +import whereOf from './where.js' + +/** @returns EXISTS query for table with WHERE clause. */ +export const exists = + (table: Sid | string, where: S | Record<string, unknown>): S => { + const table_ = id(table) + const where_ = fallback(where, whereOf) + return tsql`exists (select top 1 1 from ${table_} where ${where_})` + } + +export default exists + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 | 22x + + + + +22x +105x + + + +105x + | import S from './sanitised.js'
+import type Sid from './sanitised-identifier.js'
+
+/** @returns sanitised value as is, otherwise falls back to provided sanitation function. */
+export const fallback =
+ <T>(x: T, f: (_: Exclude<T, S | Sid>) => undefined | S): undefined | S =>
+ x instanceof S ?
+ x :
+ f(x as Exclude<T, S | Sid>)
+
+export default fallback
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 | +22x + + + + + + + + + + + +22x + +22x + | import type S from './sanitised.js'
+import raw from './raw.js'
+
+/**
+ * Value boolean false – 0 casted as BIT.
+ *
+ * Logical booleans can be used in condition expressions, ie. WHERE clause.
+ *
+ * Value booleans can be used in assignment statements, ie. UPDATE SET clause.
+ *
+ * @see falseValue for value boolean variant.
+ */
+export const falseValue: S =
+ raw('cast(0 as bit)')
+
+export default falseValue
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 | 22x + + + + + + + + +22x +5x + +24x + | import op from './op.js'
+import type S from './sanitised.js'
+
+/**
+ * @returns greater than expression.
+ *
+ * `undefined` RHS is propagated.
+ */
+export const gt =
+ (l: S | string, r: unknown): undefined | S =>
+ op(l, '>', r)
+
+export default gt
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 | 22x + + + + + + + + +22x +1x + +22x + | import op from './op.js'
+import type S from './sanitised.js'
+
+/**
+ * @returns greater than or equal expression.
+ *
+ * `undefined` RHS is propagated.
+ */
+export const gte =
+ (l: S | string, r: unknown): undefined | S =>
+ op(l, '>=', r)
+
+export default gte
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 +65 +66 +67 +68 +69 +70 +71 +72 +73 +74 +75 +76 +77 +78 +79 +80 +81 +82 +83 | 22x +22x +22x + + + + + + + + +424x + + + + + + + +159x + + + + + + + + + + + + + + + + + + + + +485x +1x + +484x +425x +6x +6x + +419x +1x +1x + +418x +2x +2x + +424x + +118x +118x + + + + + +22x +6x + + + +22x +1x + + + + + +22x +2x + + +343x + | import nstring from './nstring.js' +import Sid from './sanitised-identifier.js' +import keywords from './keywords.js' + +export type Identifier = + | string + | Sid + | (Sid | string)[] + +/** @returns `true` if provided string can be used as identifier without quoting, `false` otherwise. */ +export function isPlain(value: string) { + return ( + !keywords[value.toLowerCase()] && + !!String(value).match(/^[a-z_@#]\w*$/i) + ) +} + +/** @returns `[]`-quoted string. */ +export function quote(value: unknown) { + return '[' + String(value).replace(/\]/g, ']]') + ']' +} + +/** + * @returns sanitised identifier. + * + * Already sanitised identifiers are returned as is. + * + * String including `->` is returned as JSON_VALUE(LHS, RHS). + * + * String including `~>` is returned as JSON_QUERY(LHS, RHS?). + * + * `.`-separated string is split and joined. + * + * String including `?>` is returned as JSON_PATH_EXISTS(LHS, RHS). + * + * Strings are quoted if not plain. Non plain string is MSSQL keyword or string containing special characters. + * + * Above rules are recursive with precedence as listed. + */ +export function identifier(value: Identifier): Sid { + if (value instanceof Sid) { + return value + } + if (typeof value === 'string') { + if (value.includes('->')) { + const [ lvalue, jsonPath ] = value.split('->') + return jsonValue(lvalue, jsonPath) + } + if (value.includes('~>')) { + const [ lvalue, jsonPath ] = value.split('~>') + return jsonQuery(lvalue, jsonPath) + } + if (value.includes('?>')) { + const [ lvalue, jsonPath ] = value.split('?>') + return jsonPathExists(lvalue, jsonPath) + } + return new Sid(value.split('.').map(_ => isPlain(_) ? _ : quote(_)).join('.')) + } + if (Array.isArray(value) && value.every(_ => typeof _ === 'string' || _ instanceof Sid)) { + return new Sid(value.map(identifier).map(_ => _.toString()).join('.')) + } + throw new TypeError(`Can't sanitise ${value} identifier.`) +} + +/** @returns JSON_VALUE(C) built-in function call. */ +export function jsonValue(column: Sid | string, query: string) { + return new Sid(`json_value(${identifier(column).toString()}, ${nstring(query).toString()})`) +} + +/** @returns JSON_QUERY(C, Q?) built-in function call. */ +export function jsonQuery(column: Sid | string, query?: undefined | null | string) { + return query ? + new Sid(`json_query(${identifier(column).toString()}, ${nstring(query).toString()})`) : + new Sid(`json_query(${identifier(column).toString()})`) +} + +/** @returns JSON_PATH_EXISTS(C, Q) built-in function call. */ +export function jsonPathExists(column: Sid | string, query: string) { + return new Sid(`json_path_exists(${identifier(column).toString()}, ${nstring(query).toString()})`) +} + +export default identifier + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 | 22x +22x + + + + + + + + + +22x + + +22x + | import id from './identifier.js' +import list from './list.js' +import type S from './sanitised.js' +import type Sid from './sanitised-identifier.js' + +/** + * @returns comma separated list of provided identifiers. + * + * @see identifier + */ +export const identifiers = + (...xs: (Sid | string)[]): undefined | S => + list(xs.map(id)) + +export default identifiers + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 | 22x +22x +22x +22x +22x + +22x + + + + + + + + + +22x +11x + + + + + +32x + | import id from './identifier.js'
+import tsql from './template.js'
+import fallback from './fallback.js'
+import isNull from './is-null.js'
+import row from './row.js'
+import type S from './sanitised.js'
+import logicalFalse from './logical-false.js'
+
+/**
+ * @returns LHS in (RHS) expression.
+ *
+ * `undefined` RHS propagates.
+ *
+ * Falsy or empty array RHS returns logical false.
+ */
+export const in_ =
+ (l: S | string, r: undefined | null | unknown[]): undefined | S =>
+ typeof r === 'undefined' ?
+ undefined :
+ r && !isNull(r) && (r.length > 0) ?
+ tsql`${fallback(l, id)} in ${row(r)}` :
+ logicalFalse
+
+export default in_
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 | + +22x +705x + + + + + +705x + | /** @returns string with all lines but the first one indented with `margin`. */
+const indentTail =
+ (linesString: string, margin: string): string =>
+ margin ?
+ linesString
+ .split('\n')
+ .join(`\n${margin}`) :
+ linesString
+
+export default indentTail
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| File | ++ | Statements | ++ | Branches | ++ | Functions | ++ | Lines | ++ |
|---|---|---|---|---|---|---|---|---|---|
| and.ts | +
+
+ |
+ 75% | +3/4 | +100% | +0/0 | +100% | +0/0 | +66.66% | +2/3 | +
| assign-object.ts | +
+
+ |
+ 95% | +19/20 | +100% | +3/3 | +100% | +1/1 | +94.73% | +18/19 | +
| assign.ts | +
+
+ |
+ 93.33% | +14/15 | +100% | +3/3 | +100% | +1/1 | +92.85% | +13/14 | +
| auto.ts | +
+
+ |
+ 85.18% | +23/27 | +78.57% | +11/14 | +100% | +1/1 | +84.61% | +22/26 | +
| between.ts | +
+
+ |
+ 87.5% | +7/8 | +75% | +3/4 | +100% | +1/1 | +85.71% | +6/7 | +
| columns.ts | +
+
+ |
+ 38.46% | +5/13 | +0% | +0/4 | +0% | +0/2 | +45.45% | +5/11 | +
| defined.ts | +
+
+ |
+ 100% | +8/8 | +100% | +1/1 | +100% | +1/1 | +100% | +7/7 | +
| delete.ts | +
+
+ |
+ 90% | +9/10 | +50% | +1/2 | +100% | +1/1 | +88.88% | +8/9 | +
| demargin.ts | +
+
+ |
+ 88% | +22/25 | +77.77% | +7/9 | +100% | +4/4 | +85.71% | +18/21 | +
| distinct.ts | +
+
+ |
+ 54.54% | +6/11 | +0% | +0/3 | +0% | +0/1 | +50% | +5/10 | +
| eq.ts | +
+
+ |
+ 90.9% | +10/11 | +100% | +4/4 | +100% | +2/2 | +90% | +9/10 | +
| exists.ts | +
+
+ |
+ 54.54% | +6/11 | +100% | +0/0 | +0% | +0/1 | +60% | +6/10 | +
| fallback.ts | +
+
+ |
+ 83.33% | +5/6 | +100% | +2/2 | +100% | +1/1 | +80% | +4/5 | +
| false-value.ts | +
+
+ |
+ 80% | +4/5 | +100% | +0/0 | +100% | +0/0 | +75% | +3/4 | +
| gt.ts | +
+
+ |
+ 83.33% | +5/6 | +100% | +0/0 | +100% | +1/1 | +80% | +4/5 | +
| gte.ts | +
+
+ |
+ 83.33% | +5/6 | +100% | +0/0 | +100% | +1/1 | +80% | +4/5 | +
| identifier.ts | +
+
+ |
+ 88.57% | +31/35 | +87.5% | +14/16 | +100% | +9/9 | +87.09% | +27/31 | +
| identifiers.ts | +
+
+ |
+ 57.14% | +4/7 | +100% | +0/0 | +0% | +0/1 | +66.66% | +4/6 | +
| in.ts | +
+
+ |
+ 90.9% | +10/11 | +100% | +7/7 | +100% | +1/1 | +90% | +9/10 | +
| indent-tail.ts | +
+
+ |
+ 100% | +4/4 | +100% | +2/2 | +100% | +1/1 | +100% | +3/3 | +
| index.ts | +
+
+ |
+ 66.85% | +119/178 | +100% | +0/0 | +100% | +0/0 | +66.85% | +119/178 | +
| inline-table-of-column.ts | +
+
+ |
+ 86.66% | +13/15 | +0% | +0/1 | +100% | +2/2 | +84.61% | +11/13 | +
| inline-table-of-objects.ts | +
+
+ |
+ 94.11% | +16/17 | +100% | +2/2 | +100% | +3/3 | +92.85% | +13/14 | +
| insert-ignore.ts | +
+
+ |
+ 82.14% | +23/28 | +50% | +3/6 | +100% | +5/5 | +80% | +20/25 | +
| insert-not-matched.ts | +
+
+ |
+ 44.44% | +12/27 | +0% | +0/6 | +0% | +0/4 | +48% | +12/25 | +
| insert-object.ts | +
+
+ |
+ 88.88% | +16/18 | +33.33% | +1/3 | +100% | +2/2 | +87.5% | +14/16 | +
| insert-objects.ts | +
+
+ |
+ 91.66% | +22/24 | +80% | +4/5 | +100% | +3/3 | +90.47% | +19/21 | +
| interpolate.ts | +
+
+ |
+ 87.09% | +27/31 | +75% | +12/16 | +100% | +3/3 | +86.2% | +25/29 | +
| interpolate1.ts | +
+
+ |
+ 78.57% | +11/14 | +0% | +0/2 | +100% | +1/1 | +75% | +9/12 | +
| is-defined.ts | +
+
+ |
+ 87.5% | +7/8 | +100% | +2/2 | +100% | +2/2 | +87.5% | +7/8 | +
| is-null.ts | +
+
+ |
+ 83.33% | +5/6 | +100% | +3/3 | +100% | +1/1 | +80% | +4/5 | +
| is-object.ts | +
+
+ |
+ 100% | +2/2 | +100% | +3/3 | +100% | +1/1 | +100% | +2/2 | +
| is-string.ts | +
+
+ |
+ 80% | +4/5 | +50% | +1/2 | +100% | +1/1 | +75% | +3/4 | +
| is.ts | +
+
+ |
+ 100% | +5/5 | +100% | +0/0 | +100% | +2/2 | +100% | +4/4 | +
| json-modify.ts | +
+
+ |
+ 92.85% | +13/14 | +100% | +1/1 | +100% | +2/2 | +92.3% | +12/13 | +
| json-path-exists.ts | +
+
+ |
+ 66.66% | +2/3 | +100% | +0/0 | +100% | +0/0 | +100% | +2/2 | +
| json-path.ts | +
+
+ |
+ 87.5% | +14/16 | +100% | +5/5 | +100% | +1/1 | +92.85% | +13/14 | +
| json-query.ts | +
+
+ |
+ 66.66% | +2/3 | +100% | +0/0 | +100% | +0/0 | +100% | +2/2 | +
| json-value.ts | +
+
+ |
+ 66.66% | +2/3 | +100% | +0/0 | +100% | +0/0 | +100% | +2/2 | +
| json.ts | +
+
+ |
+ 85.71% | +6/7 | +50% | +1/2 | +100% | +1/1 | +83.33% | +5/6 | +
| keys-of-objects.ts | +
+
+ |
+ 73.68% | +14/19 | +40% | +2/5 | +100% | +3/3 | +68.75% | +11/16 | +
| keywords.ts | +
+
+ |
+ 100% | +5/5 | +100% | +0/0 | +100% | +1/1 | +100% | +3/3 | +
| like.ts | +
+
+ |
+ 91.66% | +11/12 | +50% | +2/4 | +100% | +2/2 | +90.9% | +10/11 | +
| limited-hints-identifier.ts | +
+
+ |
+ 100% | +8/8 | +100% | +4/4 | +100% | +1/1 | +100% | +7/7 | +
| line.ts | +
+
+ |
+ 90% | +9/10 | +100% | +0/0 | +100% | +3/3 | +85.71% | +6/7 | +
| lines.ts | +
+
+ |
+ 88.88% | +8/9 | +100% | +2/2 | +100% | +1/1 | +87.5% | +7/8 | +
| list.ts | +
+
+ |
+ 90.9% | +10/11 | +100% | +4/4 | +100% | +4/4 | +90% | +9/10 | +
| logical-false.ts | +
+
+ |
+ 80% | +4/5 | +100% | +0/0 | +100% | +0/0 | +75% | +3/4 | +
| logical-true.ts | +
+
+ |
+ 80% | +4/5 | +100% | +0/0 | +100% | +0/0 | +75% | +3/4 | +
| lt.ts | +
+
+ |
+ 83.33% | +5/6 | +100% | +0/0 | +100% | +1/1 | +80% | +4/5 | +
| lte.ts | +
+
+ |
+ 83.33% | +5/6 | +100% | +0/0 | +100% | +1/1 | +80% | +4/5 | +
| margin-of-first-line.ts | +
+
+ |
+ 100% | +8/8 | +100% | +3/3 | +100% | +1/1 | +100% | +7/7 | +
| margin-of-last-line.ts | +
+
+ |
+ 100% | +5/5 | +100% | +0/0 | +100% | +1/1 | +100% | +4/4 | +
| maybe-line.ts | +
+
+ |
+ 40% | +4/10 | +0% | +0/2 | +0% | +0/3 | +50% | +4/8 | +
| maybe-lines.ts | +
+
+ |
+ 92.85% | +13/14 | +50% | +1/2 | +100% | +5/5 | +92.3% | +12/13 | +
| merge-1n.ts | +
+
+ |
+ 88.23% | +15/17 | +75% | +3/4 | +100% | +1/1 | +87.5% | +14/16 | +
| modify-jsons.ts | +
+
+ |
+ 86.48% | +32/37 | +0% | +0/1 | +100% | +10/10 | +87.09% | +27/31 | +
| ne.ts | +
+
+ |
+ 83.33% | +10/12 | +33.33% | +1/3 | +100% | +1/1 | +81.81% | +9/11 | +
| ng.ts | +
+
+ |
+ 83.33% | +5/6 | +100% | +0/0 | +100% | +1/1 | +80% | +4/5 | +
| nl.ts | +
+
+ |
+ 83.33% | +5/6 | +100% | +0/0 | +100% | +1/1 | +80% | +4/5 | +
| not-between.ts | +
+
+ |
+ 87.5% | +7/8 | +75% | +3/4 | +100% | +1/1 | +85.71% | +6/7 | +
| not-distinct.ts | +
+
+ |
+ 54.54% | +6/11 | +0% | +0/3 | +0% | +0/1 | +50% | +5/10 | +
| not-in.ts | +
+
+ |
+ 90% | +9/10 | +71.42% | +5/7 | +100% | +1/1 | +88.88% | +8/9 | +
| not.ts | +
+
+ |
+ 50% | +2/4 | +100% | +0/0 | +100% | +0/0 | +66.66% | +2/3 | +
| now.ts | +
+
+ |
+ 60% | +3/5 | +100% | +0/0 | +100% | +0/0 | +75% | +3/4 | +
| nstring.ts | +
+
+ |
+ 85.71% | +6/7 | +50% | +2/4 | +100% | +1/1 | +83.33% | +5/6 | +
| null.ts | +
+
+ |
+ 80% | +4/5 | +100% | +0/0 | +100% | +0/0 | +75% | +3/4 | +
| number.ts | +
+
+ |
+ 75% | +6/8 | +0% | +0/1 | +100% | +1/1 | +71.42% | +5/7 | +
| object-id.ts | +
+
+ |
+ 50% | +3/6 | +100% | +0/0 | +0% | +0/1 | +60% | +3/5 | +
| op.ts | +
+
+ |
+ 88.88% | +8/9 | +50% | +1/2 | +100% | +1/1 | +87.5% | +7/8 | +
| or.ts | +
+
+ |
+ 75% | +3/4 | +100% | +0/0 | +100% | +0/0 | +66.66% | +2/3 | +
| order-by.ts | +
+
+ |
+ 100% | +8/8 | +100% | +2/2 | +100% | +2/2 | +100% | +6/6 | +
| pick.ts | +
+
+ |
+ 25% | +2/8 | +0% | +0/2 | +0% | +0/1 | +28.57% | +2/7 | +
| quoted-nstring.ts | +
+
+ |
+ 88.88% | +16/18 | +60% | +3/5 | +100% | +4/4 | +88.23% | +15/17 | +
| random-identifier.ts | +
+
+ |
+ 100% | +10/10 | +0% | +0/2 | +100% | +3/3 | +100% | +8/8 | +
| raw.ts | +
+
+ |
+ 83.33% | +5/6 | +100% | +0/0 | +100% | +1/1 | +80% | +4/5 | +
| replace-objects.ts | +
+
+ |
+ 45.16% | +14/31 | +0% | +0/9 | +0% | +0/5 | +53.84% | +14/26 | +
| row.ts | +
+
+ |
+ 87.5% | +7/8 | +100% | +1/1 | +100% | +1/1 | +85.71% | +6/7 | +
| rowset.ts | +
+
+ |
+ 37.5% | +3/8 | +0% | +0/1 | +0% | +0/1 | +42.85% | +3/7 | +
| sanitised-identifier.ts | +
+
+ |
+ 80% | +4/5 | +100% | +0/0 | +100% | +0/0 | +75% | +3/4 | +
| sanitised.ts | +
+
+ |
+ 75% | +3/4 | +100% | +0/0 | +100% | +0/0 | +66.66% | +2/3 | +
| select.ts | +
+
+ |
+ 45% | +9/20 | +0% | +0/8 | +0% | +0/4 | +52.94% | +9/17 | +
| star.ts | +
+
+ |
+ 57.14% | +4/7 | +0% | +0/2 | +0% | +0/1 | +66.66% | +4/6 | +
| table-hint-limited.ts | +
+
+ |
+ 75% | +6/8 | +0% | +0/1 | +100% | +1/1 | +85.71% | +6/7 | +
| template.ts | +
+
+ |
+ 88.88% | +8/9 | +100% | +0/0 | +100% | +1/1 | +87.5% | +7/8 | +
| top.ts | +
+
+ |
+ 50% | +6/12 | +0% | +0/6 | +0% | +0/1 | +54.54% | +6/11 | +
| true-value.ts | +
+
+ |
+ 80% | +4/5 | +100% | +0/0 | +100% | +0/0 | +75% | +3/4 | +
| unique.ts | +
+
+ |
+ 90.9% | +10/11 | +100% | +1/1 | +100% | +1/1 | +90% | +9/10 | +
| unix.ts | +
+
+ |
+ 75% | +3/4 | +100% | +0/0 | +100% | +0/0 | +100% | +3/3 | +
| update-objects.ts | +
+
+ |
+ 41.93% | +13/31 | +0% | +0/8 | +0% | +0/5 | +46.42% | +13/28 | +
| update.ts | +
+
+ |
+ 94.44% | +17/18 | +83.33% | +5/6 | +100% | +1/1 | +94.11% | +16/17 | +
| upsert-objects.ts | +
+
+ |
+ 42.42% | +14/33 | +0% | +0/10 | +0% | +0/5 | +46.66% | +14/30 | +
| where.ts | +
+
+ |
+ 90.8% | +79/87 | +80% | +24/30 | +100% | +8/8 | +90.58% | +77/85 | +
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 +65 +66 +67 +68 +69 +70 +71 +72 +73 +74 +75 +76 +77 +78 +79 +80 +81 +82 +83 +84 +85 +86 +87 +88 +89 +90 +91 +92 +93 +94 +95 +96 +97 +98 +99 +100 +101 +102 +103 +104 +105 +106 +107 +108 +109 +110 +111 +112 +113 +114 +115 +116 +117 +118 +119 +120 +121 +122 +123 +124 +125 +126 +127 +128 +129 +130 +131 +132 +133 +134 +135 +136 +137 +138 +139 +140 +141 +142 +143 +144 +145 +146 +147 +148 +149 +150 +151 +152 +153 +154 +155 +156 +157 +158 +159 +160 +161 +162 +163 +164 +165 +166 +167 +168 +169 +170 +171 +172 +173 +174 +175 +176 +177 +178 +179 +180 +181 +182 +183 +184 +185 +186 +187 | 22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x + +22x +22x +22x +22x +22x +22x + + +6x +9x +5x +1x + + +13x +15x + +11x + + + +2x + + + +10x + + +1x +10x + +10x +7x + + +6x +6x + + +3x +8x + + + + + + + +5x +1x + +19x + + + + + + +5x +2x + + + + + + + + + +1x + + +6x +3x + + + +4x + + + + + + + + +37x + + + + +6x + + + +24x + + +31x + + +1x +1x + + | import * as TableHintLimited from './table-hint-limited.js'
+import and from './and.js'
+import assign from './assign.js'
+import assignObject from './assign-object.js'
+import auto from './auto.js'
+import between from './between.js'
+import columns from './columns.js'
+import delete_ from './delete.js'
+import demargin from './demargin.js'
+import distinct from './distinct.js'
+import eq from './eq.js'
+import exists from './exists.js'
+import fallback from './fallback.js'
+import falseValue from './false-value.js'
+import gt from './gt.js'
+import gte from './gte.js'
+import identifier from './identifier.js'
+import identifiers from './identifiers.js'
+import in_ from './in.js'
+import indentTail from './indent-tail.js'
+import inlineTableOfColumn from './inline-table-of-column.js'
+import inlineTableOfObjects from './inline-table-of-objects.js'
+import insertIgnore from './insert-ignore.js'
+import insertNotMatched from './insert-not-matched.js'
+import insertObject from './insert-object.js'
+import insertObjects from './insert-objects.js'
+import interpolate from './interpolate.js'
+import interpolate1 from './interpolate1.js'
+import is from './is.js'
+import isNull from './is-null.js'
+import isString from './is-string.js'
+import json from './json.js'
+import jsonModify from './json-modify.js'
+import jsonPath from './json-path.js'
+import jsonPathExists from './json-path-exists.js'
+import jsonQuery from './json-query.js'
+import jsonValue from './json-value.js'
+import keysOfObjects from './keys-of-objects.js'
+import like from './like.js'
+import limitedHintsIdentifier from './limited-hints-identifier.js'
+import line from './line.js'
+import lines from './lines.js'
+import list from './list.js'
+import logicalFalse from './logical-false.js'
+import logicalTrue from './logical-true.js'
+import lt from './lt.js'
+import lte from './lte.js'
+import marginOfFirstLine from './margin-of-first-line.js'
+import marginOfLastLine from './margin-of-last-line.js'
+import maybeLine from './maybe-line.js'
+import maybeLines from './maybe-lines.js'
+import merge1n from './merge-1n.js'
+import modifyJsons from './modify-jsons.js'
+import ne from './ne.js'
+import ng from './ng.js'
+import nl from './nl.js'
+import not from './not.js'
+import notBetween from './not-between.js'
+import notDistinct from './not-distinct.js'
+import notIn from './not-in.js'
+import now from './now.js'
+import nstring from './nstring.js'
+import null_ from './null.js'
+import number_ from './number.js'
+import objectId from './object-id.js'
+import or from './or.js'
+import orderBy from './order-by.js'
+import pick from './pick.js'
+import quotedNstring from './quoted-nstring.js'
+import randomIdentifier from './random-identifier.js'
+import raw from './raw.js'
+import replaceObjects from './replace-objects.js'
+import row from './row.js'
+import rowset from './rowset.js'
+import Sanitised from './sanitised.js'
+import SanitisedIdentifier from './sanitised-identifier.js'
+import select from './select.js'
+import star from './star.js'
+import template from './template.js'
+import top from './top.js'
+import trueValue from './true-value.js'
+import type { Where } from './where.js'
+import unique from './unique.js'
+import unix from './unix.js'
+import update from './update.js'
+import updateObjects from './update-objects.js'
+import upsertObjects from './upsert-objects.js'
+import where from './where.js'
+
+export {
+ and,
+ assign,
+ assignObject,
+ auto,
+ between,
+ columns,
+ delete_ as delete,
+ demargin,
+ distinct,
+ eq,
+ exists,
+ fallback,
+ falseValue,
+ gt,
+ gte,
+ identifier,
+ identifiers,
+ in_ as in,
+ indentTail,
+ inlineTableOfColumn,
+ inlineTableOfObjects,
+ insertIgnore,
+ insertNotMatched,
+ insertObject,
+ insertObjects,
+ interpolate,
+ interpolate1,
+ is,
+ isNull,
+ isString,
+ json,
+ jsonModify,
+ jsonPath,
+ jsonPathExists,
+ jsonQuery,
+ jsonValue,
+ keysOfObjects,
+ like,
+ limitedHintsIdentifier,
+ line,
+ lines,
+ list,
+ logicalFalse,
+ logicalTrue,
+ lt,
+ lte,
+ marginOfFirstLine,
+ marginOfLastLine,
+ maybeLine,
+ maybeLines,
+ merge1n,
+ modifyJsons,
+ ne,
+ ng,
+ nl,
+ not,
+ notBetween,
+ notDistinct,
+ notIn,
+ now,
+ nstring,
+ null_ as null,
+ number_ as number,
+ objectId,
+ or,
+ orderBy,
+ pick,
+ quotedNstring,
+ randomIdentifier,
+ raw,
+ replaceObjects,
+ row,
+ rowset,
+ Sanitised,
+ SanitisedIdentifier,
+ select,
+ star,
+ TableHintLimited,
+ template,
+ top,
+ trueValue,
+ unique,
+ unix,
+ update,
+
+ updateObjects,
+ upsertObjects,
+ where,
+ type Where,
+
+ // Aliases
+ identifier as id,
+ identifiers as ids,
+ Sanitised as S,
+ SanitisedIdentifier as Sid
+}
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 | 22x +22x +22x + + +22x + + + + + + + +22x +4x + + +4x +4x +11x +4x + + + + + + +22x + | import id from './identifier.js'
+import list from './list.js'
+import row from './row.js'
+import type S from './sanitised.js'
+import type Sid from './sanitised-identifier.js'
+import tsql from './template.js'
+
+/**
+ * @returns single column literal table from provided array of values.
+ *
+ * @throws {Error} if provided values array is empty.
+ */
+export const inlineTableOfColumn =
+ (table: Sid | string, column: Sid | string, values: unknown[]): S => {
+ Iif (values.length === 0) {
+ throw new Error(`Can't generate literal table ${table} using column ${column} with an empty array of values.`)
+ }
+ const table_ = id(table)
+ const column_ = id(column)
+ const values_ = list(values.map(_ => row([ _ ])), undefined, ',\n')
+ return tsql`
+ (values
+ ${values_}
+ ) as ${table_} (${column_})
+ `
+ }
+
+export default inlineTableOfColumn
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 | 22x +22x +22x +22x +22x + + +22x + + + + + + + +22x +15x +15x +15x +3073x +15x + + + + + +22x + | import auto from './auto.js'
+import id from './identifier.js'
+import keysOfObjects from './keys-of-objects.js'
+import list from './list.js'
+import row from './row.js'
+import type S from './sanitised.js'
+import type Sid from './sanitised-identifier.js'
+import tsql from './template.js'
+
+/**
+ * @returns literal table from provided array of records.
+ *
+ * @throws {Error} if provided values array is empty.
+ */
+export const inlineTableOfObjects =
+ (table: Sid | string, objects: readonly Record<string, unknown>[], maybeKeys?: string[]): S => {
+ const table_ = id(table)
+ const keys = maybeKeys || keysOfObjects(objects)
+ const columns_ = row(keys.map(id))
+ const values_ = list(objects.map(object => row(keys.map(key => auto(object[key])))), undefined, ',\n')
+ return tsql`
+ (values
+ ${values_}
+ ) as ${table_} ${columns_}`
+ }
+
+export default inlineTableOfObjects
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 | 22x +22x +22x +22x +22x +22x +22x +22x + + + + + +22x +10x + + +22x +20x + + + + + + + + + +22x + + + + + + + + + +10x + + + +10x + + + +10x +10x +10x + +10x + + + + + + + + +22x + | import and from './and.js'
+import eq from './eq.js'
+import id from './identifier.js'
+import id_ from './limited-hints-identifier.js'
+import inlineTableOfObjects from './inline-table-of-objects.js'
+import keysOfObjects from './keys-of-objects.js'
+import row from './row.js'
+import tsql from './template.js'
+import type { TableHintLimited } from './table-hint-limited.js'
+import type S from './sanitised.js'
+import type Sid from './sanitised-identifier.js'
+
+export const sourcePrefixed =
+ (_: Sid | string): Sid =>
+ id([ 'Source', _ ])
+
+export const targetPrefixed =
+ (_: Sid | string): Sid =>
+ id([ 'Target', _ ])
+
+/**
+ * @returns insert DML ignoring existing rows.
+ *
+ * If provided array of objects is empty, returns SELECT 0.
+ *
+ * Optional hits can be provided. Defaults to SERIALIZABLE hint.
+ */
+export const insertIgnore =
+ (
+ table: Sid | string,
+ onKeys: string[],
+ objects: Record<string, unknown>[],
+ maybeObjectKeys?: string[],
+ { hints = [ 'serializable' ] }: {
+ hints?: TableHintLimited[]
+ } = {}
+ ): S => {
+
+ Iif (!Array.isArray(objects)) {
+ throw new TypeError(`Expected array of values, got ${objects}.`)
+ }
+
+ Iif (objects.length === 0) {
+ return tsql`select 0;`
+ }
+
+ const objectKeys = maybeObjectKeys || keysOfObjects(objects)
+ const on_ = and(...onKeys.map(_ => eq(sourcePrefixed(_), targetPrefixed(_))))
+ const where_ = and(...onKeys.map(_ => eq(targetPrefixed(_), null)))
+
+ return tsql`
+ insert into ${id_(table, hints)} ${row(objectKeys.map(id))}
+ select Source.*
+ from ${inlineTableOfObjects('Source', objects, objectKeys)}
+ left join ${id(table)} as Target on ${on_}
+ where ${where_}
+ `
+ }
+
+export default insertIgnore
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 | 22x +22x +22x +22x +22x +22x +22x +22x + + + + + +22x + + + +22x + + + + + + + + + + + + +22x + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +22x + | import and from './and.js'
+import eq from './eq.js'
+import id from './identifier.js'
+import inlineTableOfObjects from './inline-table-of-objects.js'
+import keysOfObjects from './keys-of-objects.js'
+import limitedHintsIdentifier from './limited-hints-identifier.js'
+import row from './row.js'
+import tsql from './template.js'
+import type { TableHintLimited } from './table-hint-limited.js'
+import type S from './sanitised.js'
+import type Sid from './sanitised-identifier.js'
+
+export const sourcePrefixed =
+ (_: Sid | string): Sid =>
+ id([ 'Source', _ ])
+
+export const targetPrefixed =
+ (_: Sid | string): Sid =>
+ id([ 'Target', _ ])
+
+/**
+ * @returns merge DML that runs insert operations on target table from the result of a join with source table.
+ *
+ * Already existing records are skipped.
+ *
+ * This DML is using MERGE statement.
+ *
+ * @see insertIgnore for DML based on INSERT and LEFT JOIN.
+ */
+export const insertNotMatched =
+ (
+ table: Sid | string,
+ onKeys: string[],
+ objects: Record<string, unknown>[],
+ maybeObjectKeys?: string[],
+ { hints = [ 'serializable' ] }: {
+ hints?: TableHintLimited[]
+ } = {}
+ ): S => {
+
+ Iif (!Array.isArray(objects)) {
+ throw new TypeError(`Expected array of values, got ${objects}.`)
+ }
+
+ Iif (objects.length === 0) {
+ return tsql`select 0;`
+ }
+
+ const table_ = limitedHintsIdentifier(table, hints)
+ const objectKeys = maybeObjectKeys || keysOfObjects(objects)
+ const on_ = and(...onKeys.map(_ => eq(sourcePrefixed(_), targetPrefixed(_))))
+
+ return tsql`
+ merge ${table_} as ${id('Target')}
+ using ${inlineTableOfObjects('Source', objects, objectKeys)}
+ on ${on_}
+ when not matched by target then
+ insert ${row(objectKeys.map(id))}
+ values ${row(objectKeys.map(sourcePrefixed))};
+ `
+ }
+
+export default insertNotMatched
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 | 22x +22x +22x +22x +22x + + + + + + + + + + + +22x +10x +10x +10x + + +10x +10x +23x +10x + + + + +22x + | import auto from './auto.js'
+import defined from './defined.js'
+import id from './identifier.js'
+import list from './list.js'
+import tsql from './template.js'
+import type S from './sanitised.js'
+import type Sid from './sanitised-identifier.js'
+
+/**
+ * @returns insert DML for single row.
+ *
+ * `undefined` entries are filtered out.
+ *
+ * @throws {TypeError} if there are no non-`undefined` entries.
+ */
+export const insertObject =
+ (table: Sid | string, object: Record<string, unknown>, output?: S): S => {
+ const object_ = defined(object)
+ const keys = Object.keys(object_)
+ Iif (keys.length === 0) {
+ throw new TypeError(`Expected object with keys, got ${object_}.`)
+ }
+ const table_ = id(table)
+ const keys_ = list(keys.map(id))
+ const values_ = list(keys.map(_ => object_[_]).map(auto))
+ return output ?
+ tsql`insert into ${table_} (${keys_}) output ${output} values (${values_})` :
+ tsql`insert into ${table_} (${keys_}) values (${values_})`
+ }
+
+export default insertObject
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 | 22x +22x +22x +22x +22x +22x +22x + + + + + + + + + + + +22x + + + + + +7x + + + +7x +1x + + +6x +6x +6x + +6x +2x + + + + + + +1107x +4x + + + + + +22x + | import auto from './auto.js' +import id from './identifier.js' +import inlineTableOfObjects from './inline-table-of-objects.js' +import keysOfObjects from './keys-of-objects.js' +import list from './list.js' +import row from './row.js' +import tsql from './template.js' +import type S from './sanitised.js' +import type Sid from './sanitised-identifier.js' + +/** + * @returns multiple row insert DML. + * + * @see insertIgnore for DML which ignores existing rows. + * + * @see insertNotMatched for DML which ignores existing rows using MERGE statement. + */ +export const insertObjects = + ( + table: Sid | string, + objects: Record<string, unknown>[], + maybeKeys?: string[] + ): S => { + + Iif (!Array.isArray(objects)) { + throw new TypeError(`Expected array of values, got ${objects}.`) + } + + if (objects.length === 0) { + return tsql`select 0;` + } + + const table_ = id(table) + const keys = maybeKeys ?? keysOfObjects(objects) + const keys_ = list(keys.map(id)) + + if (objects.length > 1000) { + return tsql` + insert into ${table_} (${keys_}) + select Source.* + from ${inlineTableOfObjects('Source', objects, keys)} + ` + } + + const values_ = list(objects.map(object => row(keys.map(key => auto(object[key]))))) + return tsql` + insert into ${table_} (${keys_}) + values ${values_} + ` + } + +export default insertObjects + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 +65 | +22x + + + + + + + + + +1816x + + +1816x + + +1816x +1816x +2025x + + + +1816x + + +1816x + + +1816x +1816x + + + + + + + +22x +406x + + +406x + + +406x + + +406x +406x + +406x +1816x +1816x + +406x +406x +705x +705x + +406x + + +406x + | import type S from './sanitised.js'
+import indentTail from './indent-tail.js'
+
+type Margin = {
+ column: number,
+ open: boolean
+}
+
+function updateMargin(mutableMargin: Margin, value: string) {
+
+ // Locate start of last line.
+ const start = value.lastIndexOf('\n') + 1
+
+ // New value has multiple lines.
+ const multiline = start > 0
+
+ // Span of margin on the last line.
+ let end = start
+ while (end < value.length && value[end] === ' ') {
+ end++
+ }
+
+ // Margin's column.
+ const column = end - start
+
+ // Last line is full of blanks.
+ const blanks = end === value.length
+
+ // Update margin.
+ mutableMargin.column = multiline ? column : mutableMargin.column + (mutableMargin.open ? column : 0)
+ mutableMargin.open = (mutableMargin.open || multiline) && blanks
+}
+
+/**
+ * @returns interpolated array `xs` with values from `ys`; empty array if both arrays are empty.
+ * @throws if `xs.length - 1 !== ys.length`
+ */
+export const interpolate =
+ (xs: TemplateStringsArray, ys: S[]): string[] => {
+ Iif (!Array.isArray(xs) || !Array.isArray(ys)) {
+ throw new TypeError(`Expected xs and ys to be an array, got ${xs} and ${ys}.`)
+ }
+ Iif ((xs.length === 0) && (ys.length === 0)) {
+ return []
+ }
+ Iif (xs.length - 1 !== ys.length) {
+ throw new TypeError(`Expected xs and ys length to be correct, got ${xs.length} and ${ys.length}.`)
+ }
+ const margin = { column: 0, open: true }
+ const rs: string[] = []
+ const push =
+ (value: string) => {
+ rs.push(value)
+ updateMargin(margin, value)
+ }
+ push(xs[0])
+ for (let i = 0; i < ys.length; i++) {
+ push(indentTail(ys[i].toString(), ' '.repeat(margin.column)))
+ push(xs[i + 1])
+ }
+ return rs
+ }
+
+export default interpolate
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 | + +22x +78x + + +78x + + +78x +78x +27x +27x + +78x + + +78x + | /** @returns interpolated array with `y` elements. */ +export const interpolate1 = + <T, I>(xs: T[], y: I): (T | I)[] => { + Iif (!Array.isArray(xs)) { + throw new TypeError(`Expected xs to be an array, got ${xs}.`) + } + Iif (xs.length === 0) { + return [] + } + const rs: (T | I)[] = [ xs[0] ] + for (let i = 1; i < xs.length; i++) { + rs.push(y) + rs.push(xs[i]) + } + return rs + } + +export default interpolate1 + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 | 22x + + + + + + + +90x +127x +13x + +114x +114x + +114x + + + + | import { isObject } from './is-object.js'
+
+export type Defined<T> =
+ T extends undefined ?
+ never :
+ T
+
+/** @returns true if values propagates to undefined, false otherwise. */
+export function isDefined<T>(value: T): value is Defined<T> {
+ if (typeof value === 'undefined') {
+ return false
+ }
+ if (isObject(value)) {
+ return Object
+ .values(value)
+ .some(_ => typeof _ !== 'undefined')
+ }
+ return true
+}
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 | 22x + + + +22x +69x + + +69x + | import Sanitised from './sanitised.js'
+
+/** @returns `true` if value is `null` or sanitised null, `false` otherwise. */
+export const isNull =
+ (value: unknown) =>
+ value === null ||
+ (value instanceof Sanitised && value.toString() === 'null')
+
+export default isNull
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 | 263x +263x + + + + + + | export function isObject(value: unknown): value is Record<string, unknown> {
+ return (
+ typeof value === 'object' &&
+ value !== null &&
+ !Array.isArray(value)
+ )
+}
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 | + + + +22x +4685x + +4685x + | // TODO: Remove this, this is dangerous. +export const isString = + + // eslint-disable-next-line @typescript-eslint/ban-types + (value: unknown): value is string | String => + typeof value === 'string' || value instanceof String + +export default isString + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 | + + + + + + + + + + +22x +6x +6x + +22x + | /**
+ * @returns where clause comparision combinator.
+ *
+ * Usage:
+ *
+ * ```ts
+ * Tsql.where({ foo: Tsql.is(Tsql.gt, 3) })
+ * ```
+ *
+ */
+const is =
+ <Lhs, Rest extends unknown[], R>(f: (lhs: Lhs, ...args: Rest) => R, ...args: Rest): ((lhs: Lhs) => R) =>
+ (lhs: Lhs): R =>
+ f(lhs, ...args)
+
+export default is
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 | 22x +22x +22x +22x + + + +22x +3x +3x +6x +2x +2x + + + + + + + + + + + +4x + + + + + + + + + +22x + | import auto from './auto.js'
+import jsonPath from './json-path.js'
+import trueValue from './true-value.js'
+import tsql from './template.js'
+import type S from './sanitised.js'
+
+export const jsonModify =
+ (target: S, kvs: Record<string, unknown>): S => {
+ const paths = Object.keys(kvs)
+ return paths.reduce((result, path) => {
+ if (path.startsWith('force ')) {
+ const path_ = path.slice('force '.length)
+ return tsql`
+ json_modify(
+ json_modify(
+ ${result},
+ ${'lax ' + jsonPath(path_)},
+ ${trueValue}
+ ),
+ ${'strict ' + jsonPath(path_)},
+ ${auto(kvs[path])}
+ )
+ `
+ }
+ return tsql`
+ json_modify(
+ ${result},
+ ${jsonPath(path)},
+ ${auto(kvs[path])}
+ )
+ `
+ }, target)
+ }
+
+export default jsonModify
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 | 22x +22x + | import { jsonPathExists } from './identifier.js'
+export default jsonPathExists
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 | +22x + + + +22x +20x +5x + +15x +15x +2x + +15x +1x + +15x +2x + +13x + + +22x + | +export const re = /^\s*((append|lax|strict)\s+)*\$\./i + +/** @returns `[append] [lax | strict] $.<path>` json path from simplified path. */ +export const jsonPath = + (path: string, { mode, append }: { append?: boolean, mode?: 'lax' | 'strict' } = {}): string => { + if (re.test(path)) { + return path + } + const parts: string[] = [] + if (append) { + parts.push('append') + } + if (mode) { + parts.push(mode) + } + if (parts.length > 0) { + return `${parts.join(' ')} $.${path}` + } + return `$.${path}` + } + +export default jsonPath + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 | 22x +22x + | import { jsonQuery } from './identifier.js'
+export default jsonQuery
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 | 22x +22x + | import { jsonValue } from './identifier.js'
+export default jsonValue
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 | 22x +22x + + + + + + + + +22x +8x + + + +22x + | import null_ from './null.js' +import nstring from './nstring.js' +import type S from './sanitised.js' + +/** + * @returns stringified json. + * + * `undefined` value is serialised as NULL. + */ +export const json = + (x: unknown): S => + typeof x === 'undefined' ? + null_ : + nstring(JSON.stringify(x)) + +export default json + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 | + +22x +4152x + + + + + + + +22x +21x + + +21x + + +21x +21x +4124x +4124x + + + + + +21x + + +22x + | /** @returns `true` if boths string arrays are the same. */ +export const same = + (xs: string[], ys: string[]): boolean => + xs.length === ys.length && xs.every((x, i) => x === ys[i]) + +/** + * @returns keys of all objects in array + * @throws if objects have different keys. + * @throws if an array is empty. + */ +export const keysOfObjects = + (objects: readonly Record<string, unknown>[]): string[] => { + Iif (!Array.isArray(objects)) { + throw new TypeError(`Expected array, got ${objects}.`) + } + Iif (objects.length === 0) { + throw new TypeError('Expected non empty array.') + } + const keys = Object.keys(objects[0]).sort() + for (let i = 1; i < objects.length; i++) { + const keys_ = Object.keys(objects[i]).sort() + Iif (!same(keys, keys_)) { + throw new TypeError(`Expected same keys on all objects, got ${keys} and ${keys_} at ${i} index.`) + } + } + + // Return naturally ordered keys. + return Object.keys(objects[0]) + } + +export default keysOfObjects + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 +65 +66 +67 +68 +69 +70 +71 +72 +73 +74 +75 +76 +77 +78 +79 +80 +81 +82 +83 +84 +85 +86 +87 +88 +89 +90 +91 +92 +93 +94 +95 +96 +97 +98 +99 +100 +101 +102 +103 +104 +105 +106 +107 +108 +109 +110 +111 +112 +113 +114 +115 +116 +117 +118 +119 +120 +121 +122 +123 +124 +125 +126 +127 +128 +129 +130 +131 +132 +133 +134 +135 +136 +137 +138 +139 +140 +141 +142 +143 +144 +145 +146 +147 +148 +149 +150 +151 +152 +153 +154 +155 +156 +157 +158 +159 +160 +161 +162 +163 +164 +165 +166 +167 +168 +169 +170 +171 +172 +173 +174 +175 +176 +177 +178 +179 +180 +181 +182 +183 +184 +185 +186 +187 +188 +189 +190 +191 +192 +193 +194 +195 +196 +197 +198 +199 +200 +201 +202 +203 +204 +205 +206 +207 +208 +209 +210 +211 +212 +213 +214 +215 +216 +217 +218 +219 +220 +221 +222 +223 +224 +225 +226 +227 +228 +229 +230 +231 +232 +233 +234 +235 +236 +237 +238 +239 +240 +241 +242 +243 +244 +245 +246 +247 +248 +249 +250 +251 +252 +253 +254 +255 +256 +257 +258 +259 +260 +261 +262 +263 +264 +265 +266 +267 +268 +269 +270 +271 +272 +273 +274 +275 +276 +277 +278 +279 +280 +281 +282 +283 +284 +285 +286 +287 +288 +289 +290 +291 +292 +293 +294 +295 +296 +297 +298 +299 +300 +301 +302 +303 +304 +305 +306 +307 +308 +309 +310 +311 +312 +313 +314 +315 +316 +317 +318 +319 +320 +321 +322 +323 +324 +325 +326 +327 +328 +329 +330 +331 +332 +333 +334 +335 +336 +337 +338 +339 +340 +341 +342 +343 +344 +345 +346 +347 +348 +349 +350 +351 +352 +353 +354 +355 +356 +357 +358 +359 +360 +361 +362 +363 +364 +365 +366 +367 +368 +369 +370 +371 +372 +373 +374 +375 +376 +377 +378 +379 +380 +381 +382 +383 +384 +385 +386 +387 +388 +389 +390 +391 +392 +393 +394 +395 +396 +397 +398 +399 +400 +401 +402 +403 +404 +405 +406 +407 +408 +409 +410 +411 +412 +413 +414 +415 +416 +417 +418 +419 +420 +421 +422 +423 +424 +425 +426 +427 +428 +429 +430 +431 +432 +433 +434 +435 +436 +437 +438 +439 +440 +441 +442 +443 +444 +445 +446 +447 +448 +449 +450 +451 +452 +453 +454 +455 +456 +457 +458 +459 +460 +461 +462 +463 +464 +465 +466 +467 +468 +469 +470 +471 +472 +473 +474 +475 +476 +477 +478 +479 +480 +481 +482 +483 +484 +485 +486 +487 +488 +489 +490 +491 +492 +493 +494 +495 +496 +497 +498 +499 +500 +501 +502 +503 +504 +505 +506 +507 +508 +509 +510 +511 +512 +513 +514 +515 +516 +517 +518 +519 +520 +521 +522 +523 +524 +525 +526 +527 +528 +529 +530 +531 +532 +533 +534 +535 +536 +537 +538 +539 +540 +541 +542 +543 +544 +545 +546 +547 +548 +549 +550 +551 +552 +553 +554 +555 +556 +557 +558 +559 +560 +561 +562 +563 +564 +565 +566 +567 +568 +569 +570 +571 +572 +573 +574 +575 +576 +577 +578 +579 +580 +581 +582 +583 +584 +585 +586 +587 +588 +589 +590 +591 +592 +593 +594 +595 +596 +597 +598 +599 +600 +601 +602 +603 +604 +605 +606 +607 +608 +609 +610 +611 +612 +613 +614 +615 +616 +617 +618 +619 +620 +621 +622 +623 +624 +625 +626 +627 +628 +629 +630 +631 +632 +633 +634 +635 +636 +637 +638 +639 +640 +641 +642 +643 +644 +645 +646 +647 +648 +649 +650 +651 +652 +653 +654 +655 +656 +657 +658 +659 +660 +661 +662 +663 +664 +665 +666 +667 +668 +669 +670 +671 +672 +673 +674 +675 +676 +677 +678 +679 +680 +681 +682 +683 +684 +685 +686 +687 +688 +689 +690 +691 +692 +693 +694 +695 +696 +697 +698 +699 +700 +701 +702 +703 +704 +705 +706 +707 +708 +709 +710 +711 +712 +713 +714 +715 +716 +717 +718 +719 +720 +721 +722 +723 +724 +725 +726 +727 +728 +729 +730 +731 +732 +733 +734 +735 +736 +737 +738 +739 +740 +741 +742 +743 +744 +745 +746 +747 +748 +749 +750 +751 +752 +753 +754 +755 +756 +757 +758 +759 +760 +761 +762 +763 +764 +765 +766 +767 +768 +769 +770 +771 +772 +773 +774 +775 +776 +777 +778 +779 +780 +781 +782 +783 +784 +785 +786 +787 +788 +789 +790 +791 +792 +793 +794 +795 +796 +797 +798 +799 +800 +801 +802 +803 +804 +805 +806 +807 +808 +809 +810 +811 +812 +813 +814 +815 +816 +817 +818 +819 +820 +821 +822 +823 +824 +825 +826 +827 +828 +829 +830 +831 +832 +833 +834 +835 +836 +837 +838 +839 +840 +841 +842 +843 +844 +845 +846 +847 +848 +849 +850 +851 +852 +853 +854 +855 +856 +857 +858 +859 +860 +861 +862 +863 +864 +865 +866 +867 +868 +869 +870 +871 +872 +873 +874 +875 +876 +877 +878 +879 +880 +881 +882 +883 +884 +885 +886 +887 +888 +889 +890 +891 +892 +893 +894 +895 +896 +897 +898 +899 +900 +901 +902 +903 +904 +905 +906 +907 +908 +909 +910 +911 +912 +913 +914 +915 +916 +917 +918 +919 +920 +921 +922 +923 +924 +925 +926 +927 +928 +929 +930 +931 +932 +933 +934 +935 +936 +937 +938 +939 +940 +941 +942 +943 +944 +945 +946 +947 +948 +949 +950 +951 +952 +953 +954 +955 +956 +957 +958 +959 +960 +961 +962 +963 +964 +965 +966 +967 +968 +969 +970 +971 +972 +973 +974 +975 +976 +977 +978 +979 +980 | 22x + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +21362x + +424x + | const keywords_ = [
+ 'abort_after_wait',
+ 'abort',
+ 'absent',
+ 'absolute',
+ 'accent_sensitivity',
+ 'acceptable_cursopt',
+ 'acp',
+ 'action',
+ 'activation',
+ 'add',
+ 'address',
+ 'admin',
+ 'aes_128',
+ 'aes_192',
+ 'aes_256',
+ 'affinity',
+ 'after',
+ 'aggregate',
+ 'algorithm',
+ 'all_constraints',
+ 'all_errormsgs',
+ 'all_indexes',
+ 'all_levels',
+ 'all_results',
+ 'all',
+ 'allow_connections',
+ 'allow_dup_row',
+ 'allow_encrypted_value_modifications',
+ 'allow_page_locks',
+ 'allow_row_locks',
+ 'allow_snapshot_isolation',
+ 'alter',
+ 'altercolumn',
+ 'always',
+ 'and',
+ 'anonymous',
+ 'ansi_defaults',
+ 'ansi_null_default',
+ 'ansi_null_dflt_off',
+ 'ansi_null_dflt_on',
+ 'ansi_nulls',
+ 'ansi_padding',
+ 'ansi_warnings',
+ 'any',
+ 'appdomain',
+ 'append',
+ 'application',
+ 'apply',
+ 'arithabort',
+ 'arithignore',
+ 'as',
+ 'asc',
+ 'assembly',
+ 'asymmetric',
+ 'asynchronous_commit',
+ 'at',
+ 'atan2',
+ 'atomic',
+ 'attach_force_rebuild_log',
+ 'attach_rebuild_log',
+ 'attach',
+ 'audit',
+ 'auth_realm',
+ 'authentication',
+ 'authorization',
+ 'auto_cleanup',
+ 'auto_close',
+ 'auto_create_statistics',
+ 'auto_shrink',
+ 'auto_update_statistics_async',
+ 'auto_update_statistics',
+ 'auto',
+ 'automated_backup_preference',
+ 'automatic',
+ 'autopilot',
+ 'availability_mode',
+ 'availability',
+ 'backup_priority',
+ 'backup',
+ 'base64',
+ 'basic',
+ 'batches',
+ 'batchsize',
+ 'before',
+ 'begin',
+ 'between',
+ 'bigint',
+ 'binary',
+ 'binding',
+ 'bit',
+ 'block',
+ 'blocksize',
+ 'bmk',
+ 'break',
+ 'broker_instance',
+ 'broker',
+ 'browse',
+ 'bucket_count',
+ 'buffer',
+ 'buffercount',
+ 'bulk_logged',
+ 'bulk',
+ 'by',
+ 'call',
+ 'caller',
+ 'card',
+ 'cascade',
+ 'case',
+ 'catalog',
+ 'catch',
+ 'cert',
+ 'certificate',
+ 'change_retention',
+ 'change_tracking_context',
+ 'change_tracking',
+ 'changes',
+ 'char',
+ 'character_set',
+ 'character',
+ 'check_expiration',
+ 'check_policy',
+ 'check',
+ 'checkconstraints',
+ 'checkindex',
+ 'checkpoint',
+ 'cleanup_policy',
+ 'clear_port',
+ 'clear',
+ 'close',
+ 'clustered',
+ 'coalesce',
+ 'codepage',
+ 'collate',
+ 'collection',
+ 'column_encryption_key',
+ 'column_master_key',
+ 'column',
+ 'columnstore_archive',
+ 'columnstore',
+ 'colv_100_to_80',
+ 'colv_80_to_100',
+ 'commit_differential_base',
+ 'commit',
+ 'committed',
+ 'compatibility_level',
+ 'compress_all_row_groups',
+ 'compression_delay',
+ 'compression',
+ 'compute',
+ 'concat_null_yields_null',
+ 'concatenate',
+ 'configuration',
+ 'connect',
+ 'constraint',
+ 'contains',
+ 'containstable',
+ 'continue_after_error',
+ 'continue',
+ 'contract_name',
+ 'contract',
+ 'control',
+ 'conversation_group_id',
+ 'conversation_handle',
+ 'conversation',
+ 'convert',
+ 'copy_only',
+ 'copy',
+ 'count_rows',
+ 'counter',
+ 'create',
+ 'credential',
+ 'cross',
+ 'cryptographic_provider',
+ 'cryptographic',
+ 'cube',
+ 'current_date',
+ 'current_time',
+ 'current_timestamp',
+ 'current_user',
+ 'current',
+ 'cursor_close_on_commit',
+ 'cursor_default',
+ 'cursor',
+ 'data_compression',
+ 'data_flush_interval_seconds',
+ 'data_mirroring',
+ 'data_purity',
+ 'data_source',
+ 'data',
+ 'database_name',
+ 'database_snapshot',
+ 'database',
+ 'datafiletype',
+ 'date_correlation_optimization',
+ 'date_format',
+ 'date',
+ 'datefirst',
+ 'dateformat',
+ 'datetime',
+ 'datetime2',
+ 'datetimeoffset',
+ 'days',
+ 'db_chaining',
+ 'dbcc',
+ 'dbid',
+ 'dbidexec',
+ 'dbo_only',
+ 'deadlock_priority',
+ 'deallocate',
+ 'dec',
+ 'decimal',
+ 'declare',
+ 'decrypt_a',
+ 'decrypt',
+ 'decryption',
+ 'default_database',
+ 'default_language',
+ 'default_logon_domain',
+ 'default_schema',
+ 'default',
+ 'definition',
+ 'delay',
+ 'delayed_durability',
+ 'delete',
+ 'delimitedtext',
+ 'density_vector',
+ 'deny',
+ 'dependent',
+ 'des',
+ 'desc',
+ 'description',
+ 'desired_state',
+ 'desx',
+ 'differential',
+ 'digest',
+ 'disable_broker',
+ 'disable_def_cnst_chk',
+ 'disable',
+ 'disabled',
+ 'disk',
+ 'distinct',
+ 'distributed',
+ 'distribution',
+ 'double',
+ 'drop_existing',
+ 'drop',
+ 'dts_buffers',
+ 'dump',
+ 'durability',
+ 'dynamic',
+ 'edition',
+ 'elements',
+ 'else',
+ 'emergency',
+ 'empty',
+ 'enable_broker',
+ 'enable',
+ 'enabled',
+ 'encoding',
+ 'encrypted_value',
+ 'encrypted',
+ 'encryption_type',
+ 'encryption',
+ 'end',
+ 'endpoint_url',
+ 'endpoint',
+ 'enhancedintegrity',
+ 'entry',
+ 'errlvl',
+ 'error_broker_conversations',
+ 'errorfile',
+ 'escape',
+ 'estimateonly',
+ 'event',
+ 'except',
+ 'exec',
+ 'executable',
+ 'execute',
+ 'exists',
+ 'exit',
+ 'expand',
+ 'expiredate',
+ 'expiry_date',
+ 'explicit',
+ 'external_access',
+ 'external',
+ 'failover_mode',
+ 'failover',
+ 'failure_condition_level',
+ 'fast_forward',
+ 'fast',
+ 'fastfirstrow',
+ 'federated_service_account',
+ 'fetch',
+ 'field_terminator',
+ 'fieldterminator',
+ 'file_format',
+ 'file',
+ 'filegroup',
+ 'filelistonly',
+ 'filename',
+ 'filestream_log',
+ 'filestream_on',
+ 'filestream',
+ 'filetable',
+ 'fillfactor',
+ 'filter',
+ 'fips_flagger',
+ 'fire_triggers',
+ 'first_row',
+ 'first',
+ 'firstrow',
+ 'float',
+ 'flush_interval_seconds',
+ 'fmtonly',
+ 'following',
+ 'for',
+ 'force_failover_allow_data_loss',
+ 'force_service_allow_data_loss',
+ 'force',
+ 'forced',
+ 'forceplan',
+ 'foreign',
+ 'format_options',
+ 'format_type',
+ 'formatfile',
+ 'formsof',
+ 'forward_only',
+ 'free_cursors',
+ 'free_exec_context',
+ 'freetext',
+ 'freetexttable',
+ 'from',
+ 'full',
+ 'fullscan',
+ 'fulltext',
+ 'fulltextall',
+ 'fulltextkey',
+ 'function',
+ 'generated',
+ 'geography',
+ 'geometry',
+ 'get',
+ 'global',
+ 'go',
+ 'goto',
+ 'governor',
+ 'grant',
+ 'group',
+ 'guid',
+ 'hadoop',
+ 'hardening',
+ 'hash',
+ 'hashed',
+ 'having',
+ 'header_limit',
+ 'headeronly',
+ 'health_check_timeout',
+ 'hidden',
+ 'hierarchyid',
+ 'histogram_steps',
+ 'histogram',
+ 'hits_cursors',
+ 'hits_exec_context',
+ 'holdlock',
+ 'hours',
+ 'http',
+ 'identity_insert',
+ 'identity_value',
+ 'identity',
+ 'identitycol',
+ 'if',
+ 'ifnull',
+ 'ignore_constraints',
+ 'ignore_dup_key',
+ 'ignore_dup_row',
+ 'ignore_triggers',
+ 'image',
+ 'immediate',
+ 'implicit_transactions',
+ 'in',
+ 'include_null_values',
+ 'include',
+ 'index',
+ 'inflectional',
+ 'init',
+ 'initiator',
+ 'inner',
+ 'insensitive',
+ 'insert',
+ 'instead',
+ 'int',
+ 'integer',
+ 'integrated',
+ 'intermediate',
+ 'intersect',
+ 'interval_length_minutes',
+ 'into',
+ 'inuse_cursors',
+ 'inuse_exec_context',
+ 'io',
+ 'is',
+ 'isabout',
+ 'iso_week',
+ 'isolation',
+ 'job_tracker_location',
+ 'join',
+ 'json',
+ 'keep_nulls',
+ 'keep_replication',
+ 'keep',
+ 'keepdefaults',
+ 'keepfixed',
+ 'keepidentity',
+ 'keepnulls',
+ 'kerberos',
+ 'key_path',
+ 'key_source',
+ 'key_store_provider_name',
+ 'key',
+ 'keyset',
+ 'kill',
+ 'kilobytes_per_batch',
+ 'label',
+ 'labelonly',
+ 'langid',
+ 'language',
+ 'last',
+ 'lastrow',
+ 'left',
+ 'legacy_cardinality_estimation',
+ 'length',
+ 'level',
+ 'lifetime',
+ 'like',
+ 'lineage_100_to_80',
+ 'lineage_80_to_100',
+ 'lineno',
+ 'listener_ip',
+ 'listener_port',
+ 'load',
+ 'loadhistory',
+ 'lob_compaction',
+ 'local_service_name',
+ 'local',
+ 'locate',
+ 'location',
+ 'lock_escalation',
+ 'lock_timeout',
+ 'lockres',
+ 'login_type',
+ 'login',
+ 'loop',
+ 'manual',
+ 'mark_in_use_for_removal',
+ 'masked',
+ 'master',
+ 'matched',
+ 'max_duration',
+ 'max_outstanding_io_per_volume',
+ 'max_plans_per_query',
+ 'max_queue_readers',
+ 'max_storage_size_mb',
+ 'maxdop',
+ 'maxerrors',
+ 'maxlength',
+ 'maxtransfersize',
+ 'mediadescription',
+ 'medianame',
+ 'mediapassword',
+ 'memogroup',
+ 'memory_optimized',
+ 'merge',
+ 'message_forward_size',
+ 'message_forwarding',
+ 'message',
+ 'microsecond',
+ 'millisecond',
+ 'minutes',
+ 'mirror_address',
+ 'misses_cursors',
+ 'misses_exec_context',
+ 'mixed',
+ 'modify',
+ 'money',
+ 'move',
+ 'multi_user',
+ 'must_change',
+ 'name',
+ 'namespace',
+ 'nanosecond',
+ 'national',
+ 'native_compilation',
+ 'native',
+ 'nchar',
+ 'ncharacter',
+ 'never',
+ 'new_account',
+ 'new_broker',
+ 'newname',
+ 'next',
+ 'no_browsetable',
+ 'no_checksum',
+ 'no_compression',
+ 'no_infomsgs',
+ 'no_triggers',
+ 'no_truncate',
+ 'no',
+ 'nocheck',
+ 'nocount',
+ 'noexec',
+ 'noexpand',
+ 'noformat',
+ 'noinit',
+ 'nolock',
+ 'nonatomic',
+ 'nonclustered',
+ 'nondurable',
+ 'none',
+ 'norecompute',
+ 'norecovery',
+ 'noreset',
+ 'norewind',
+ 'noskip',
+ 'not',
+ 'notification',
+ 'nounload',
+ 'now',
+ 'nowait',
+ 'ntext',
+ 'ntlm',
+ 'null',
+ 'nullif',
+ 'numeric_roundabort',
+ 'numeric',
+ 'nvarchar',
+ 'object',
+ 'objid',
+ 'oem',
+ 'of',
+ 'off',
+ 'offline',
+ 'offsets',
+ 'old_account',
+ 'on',
+ 'online',
+ 'open',
+ 'opendatasource',
+ 'openjson',
+ 'openquery',
+ 'openrowset',
+ 'openxml',
+ 'operation_mode',
+ 'optimistic',
+ 'option',
+ 'or',
+ 'orc',
+ 'order',
+ 'out',
+ 'outer',
+ 'output',
+ 'over',
+ 'override',
+ 'owner',
+ 'ownership',
+ 'pad_index',
+ 'page_checksum',
+ 'page_verify',
+ 'page',
+ 'pagecount',
+ 'paglock',
+ 'param',
+ 'parameter_sniffing',
+ 'parameter_type_expansion',
+ 'parameterization',
+ 'parquet',
+ 'parseonly',
+ 'partial',
+ 'partition',
+ 'partner',
+ 'password',
+ 'path',
+ 'pause',
+ 'percent',
+ 'percentage',
+ 'period',
+ 'permission_set',
+ 'persisted',
+ 'physical_only',
+ 'pivot',
+ 'plan_forcing_mode',
+ 'plan',
+ 'policy',
+ 'pool',
+ 'population',
+ 'ports',
+ 'preceding',
+ 'precision',
+ 'predicate',
+ 'presume_abort',
+ 'primary_role',
+ 'primary',
+ 'print',
+ 'prior',
+ 'priority_level',
+ 'priority',
+ 'private',
+ 'proc',
+ 'procedure_name',
+ 'procedure',
+ 'profile',
+ 'provider',
+ 'public',
+ 'query_capture_mode',
+ 'query_governor_cost_limit',
+ 'query_optimizer_hotfixes',
+ 'query_store',
+ 'queue',
+ 'quoted_identifier',
+ 'raiserror',
+ 'range',
+ 'raw',
+ 'rc2',
+ 'rc4_128',
+ 'rc4',
+ 'rcfile',
+ 'rdbms',
+ 'read_committed_snapshot',
+ 'read_only',
+ 'read_write',
+ 'read',
+ 'readcommitted',
+ 'readcommittedlock',
+ 'readonly',
+ 'readpast',
+ 'readtext',
+ 'readuncommitted',
+ 'readwrite',
+ 'real',
+ 'rebuild',
+ 'receive',
+ 'recmodel_70backcomp',
+ 'recompile',
+ 'reconfigure',
+ 'recovery',
+ 'recursive_triggers',
+ 'recursive',
+ 'redo_queue',
+ 'references',
+ 'reject_sample_value',
+ 'reject_type',
+ 'reject_value',
+ 'relative',
+ 'remote_data_archive',
+ 'remote_proc_transactions',
+ 'remote_service_name',
+ 'remote',
+ 'remove',
+ 'removed_cursors',
+ 'removed_exec_context',
+ 'reorganize',
+ 'repeat',
+ 'repeatable',
+ 'repeatableread',
+ 'replica',
+ 'replicated',
+ 'replication',
+ 'replnick_100_to_80',
+ 'replnickarray_100_to_80',
+ 'replnickarray_80_to_100',
+ 'required_cursopt',
+ 'required',
+ 'resample',
+ 'reset',
+ 'resource_manager_location',
+ 'resource',
+ 'restart',
+ 'restore',
+ 'restrict',
+ 'restricted_user',
+ 'resume',
+ 'retaindays',
+ 'retention',
+ 'return',
+ 'returns',
+ 'revert',
+ 'revoke',
+ 'rewind',
+ 'rewindonly',
+ 'right',
+ 'robust',
+ 'role',
+ 'rollback',
+ 'rollup',
+ 'root',
+ 'round_robin',
+ 'route',
+ 'row_terminator',
+ 'row',
+ 'rowcount',
+ 'rowdump',
+ 'rowguidcol',
+ 'rowlock',
+ 'rows_per_batch',
+ 'rows',
+ 'rowsets_only',
+ 'rowterminator',
+ 'rowversion',
+ 'rsa_1024',
+ 'rsa_2048',
+ 'rsa_3072',
+ 'rsa_4096',
+ 'rsa_512',
+ 'rule',
+ 'safe',
+ 'safety',
+ 'sample',
+ 'save',
+ 'schema',
+ 'schemabinding',
+ 'scoped',
+ 'scroll_locks',
+ 'scroll',
+ 'sddl',
+ 'secexpr',
+ 'secondary_only',
+ 'secondary_role',
+ 'secondary',
+ 'secret',
+ 'security',
+ 'securityaudit',
+ 'select',
+ 'selective',
+ 'self',
+ 'semantickeyphrasetable',
+ 'semanticsimilaritydetailstable',
+ 'semanticsimilaritytable',
+ 'send',
+ 'sent',
+ 'sequence',
+ 'serde_method',
+ 'serializable',
+ 'server',
+ 'service_broker',
+ 'service_name',
+ 'service_objective',
+ 'service',
+ 'session_timeout',
+ 'session_user',
+ 'session',
+ 'sessions',
+ 'set',
+ 'seterror',
+ 'setopts',
+ 'sets',
+ 'setuser',
+ 'shard_map_manager',
+ 'shard_map_name',
+ 'sharded',
+ 'shared_memory',
+ 'show_statistics',
+ 'showplan_all',
+ 'showplan_text',
+ 'showplan_xml_with_recompile',
+ 'showplan_xml',
+ 'shrinkdb',
+ 'shutdown',
+ 'sid',
+ 'signature',
+ 'simple',
+ 'single_blob',
+ 'single_clob',
+ 'single_nclob',
+ 'single_user',
+ 'singleton',
+ 'site',
+ 'size_based_cleanup_mode',
+ 'skip',
+ 'smalldatetime',
+ 'smallint',
+ 'smallmoney',
+ 'snapshot_import',
+ 'snapshot',
+ 'snapshotrestorephase',
+ 'soap',
+ 'softnuma',
+ 'some',
+ 'sort_in_tempdb',
+ 'sorted_data_reorg',
+ 'sorted_data',
+ 'source',
+ 'spatial',
+ 'sql_bigint',
+ 'sql_binary',
+ 'sql_bit',
+ 'sql_char',
+ 'sql_date',
+ 'sql_decimal',
+ 'sql_double',
+ 'sql_float',
+ 'sql_guid',
+ 'sql_handle',
+ 'sql_longvarbinary',
+ 'sql_longvarchar',
+ 'sql_numeric',
+ 'sql_real',
+ 'sql_smallint',
+ 'sql_time',
+ 'sql_timestamp',
+ 'sql_tinyint',
+ 'sql_tsi_day',
+ 'sql_tsi_frac_second',
+ 'sql_tsi_hour',
+ 'sql_tsi_minute',
+ 'sql_tsi_month',
+ 'sql_tsi_quarter',
+ 'sql_tsi_second',
+ 'sql_tsi_week',
+ 'sql_tsi_year',
+ 'sql_type_date',
+ 'sql_type_time',
+ 'sql_type_timestamp',
+ 'sql_varbinary',
+ 'sql_varchar',
+ 'sql_variant',
+ 'sql_wchar',
+ 'sql_wlongvarchar',
+ 'sql',
+ 'ssl_port',
+ 'ssl',
+ 'standard',
+ 'standby',
+ 'start_date',
+ 'start',
+ 'started',
+ 'stat_header',
+ 'state',
+ 'statement',
+ 'static',
+ 'statistics_incremental',
+ 'statistics_norecompute',
+ 'statistics_only',
+ 'statistics',
+ 'statman',
+ 'stats_stream',
+ 'status',
+ 'stop_on_error',
+ 'stop',
+ 'stopat',
+ 'stopatmark',
+ 'stopbeforemark',
+ 'stoplist',
+ 'stopped',
+ 'string_delimiter',
+ 'subject',
+ 'supplemental_logging',
+ 'supported',
+ 'suspend',
+ 'symmetric',
+ 'synchronous_commit',
+ 'synonym',
+ 'sysname',
+ 'system_time',
+ 'system_user',
+ 'system_versioning',
+ 'system',
+ 'table',
+ 'tableresults',
+ 'tablesample',
+ 'tablock',
+ 'tablockx',
+ 'take',
+ 'tape',
+ 'target_index',
+ 'target_partition',
+ 'target',
+ 'tcp',
+ 'temporal_history_retention',
+ 'text',
+ 'textimage_on',
+ 'textsize',
+ 'then',
+ 'thesaurus',
+ 'throw',
+ 'time',
+ 'timeout',
+ 'timestamp',
+ 'tinyint',
+ 'to',
+ 'top',
+ 'torn_page_detection',
+ 'track_columns_updated',
+ 'tran',
+ 'transaction',
+ 'transfer',
+ 'trigger',
+ 'triple_des_3key',
+ 'triple_des',
+ 'truncate',
+ 'trustworthy',
+ 'try_convert',
+ 'try',
+ 'tsequal',
+ 'tsql',
+ 'type_desc',
+ 'type_warning',
+ 'type',
+ 'tzoffset',
+ 'uid',
+ 'unbounded',
+ 'uncommitted',
+ 'union',
+ 'unique',
+ 'uniqueidentifier',
+ 'unlimited',
+ 'unload',
+ 'unlock',
+ 'unpivot',
+ 'unsafe',
+ 'update',
+ 'updatetext',
+ 'updlock',
+ 'url',
+ 'use_type_default',
+ 'use',
+ 'useplan',
+ 'user',
+ 'useroptions',
+ 'using',
+ 'utcdatetime',
+ 'valid_xml',
+ 'validation',
+ 'value',
+ 'values',
+ 'varbinary',
+ 'varchar',
+ 'varying',
+ 'verbose',
+ 'verifyonly',
+ 'version',
+ 'view_metadata',
+ 'view',
+ 'virtual_device',
+ 'visiblity',
+ 'waitfor',
+ 'webmethod',
+ 'weekday',
+ 'weight',
+ 'well_formed_xml',
+ 'when',
+ 'where',
+ 'while',
+ 'widechar_ansi',
+ 'widechar',
+ 'widenative',
+ 'windows',
+ 'with',
+ 'within',
+ 'without_array_wrapper',
+ 'without',
+ 'witness',
+ 'workload',
+ 'writetext',
+ 'wsdl',
+ 'xact_abort',
+ 'xlock',
+ 'xml',
+ 'xmlschema',
+ 'xquery',
+ 'xsinil',
+ 'zone'
+]
+
+/** An array of MSSQL keywords. */
+const keywords: Record<string, undefined | true> =
+ keywords_.reduce((r, _) => ({ ...r, [_]: true }), {})
+
+export default keywords
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 | 22x +22x +22x +22x +22x + + + +22x +1x + + + + + + + + + +22x +1x + + + +22x + | import fallback from './fallback.js' +import id from './identifier.js' +import isNull from './is-null.js' +import nstring from './nstring.js' +import tsql from './template.js' +import type S from './sanitised.js' + +const rhsLike = + (rhs: unknown): S => + isNull(rhs) ? + tsql`is null` : + tsql`like ${nstring(String(rhs))}` + +/** + * @returns LIKE operator. + * + * `undefined` is propagated. + */ +export const like = + (lhs: S | string, rhs: unknown): undefined | S => + typeof rhs === 'undefined' ? + undefined : + tsql`${fallback(lhs, id)} ${rhsLike(rhs)}` + +export default like + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 | 22x +22x +22x +22x + + + + +22x +20x + + + +22x + | import * as TableHintLimited from './table-hint-limited.js'
+import identifier from './identifier.js'
+import list from './list.js'
+import template from './template.js'
+import type S from './sanitised.js'
+
+/** @returns identifier with optional, [limited hints](https://docs.microsoft.com/en-us/sql/t-sql/queries/hints-transact-sql-table). */
+const limitedHintsIdentifier =
+ (table: Parameters<typeof identifier>[0], hints?: TableHintLimited.t[]): S =>
+ hints && hints.length > 0 ?
+ template`${identifier(table)} with (${list(hints, TableHintLimited.sanitized)})` :
+ identifier(table)
+
+export default limitedHintsIdentifier
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 | 22x +22x + + + + + + + + + + + + +22x +26x +26x + + +22x + | import auto from './auto.js'
+import raw from './raw.js'
+import type S from './sanitised.js'
+
+/**
+ * @returns space delimited line constructed from provided elements.
+ *
+ * `undefined` values are filtered out.
+ *
+ * Empty list returns sanitized empty string.
+ *
+ * @see maybeLine for variant which propagates emtpy list to undefined.
+ */
+export const line =
+ (...elements: unknown[]): S => {
+ const elements_ = elements.filter(_ => typeof _ !== 'undefined')
+ return raw(elements_.map(auto).map(_ => _.toString().trim()).join(' '))
+ }
+
+export default line
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 | 22x + + + + + + + +22x +5x +5x +2x + +3x + + +22x + | import maybeLines from './maybe-lines.js'
+import type S from './sanitised.js'
+
+/**
+ * @returns lines joined with provided separator.
+ * @throws if there are no lines on output.
+ */
+export const lines =
+ <T>(inputs: readonly T[], separator = '\n'): S => {
+ const output = maybeLines(inputs, separator)
+ if (typeof output === 'undefined') {
+ throw new Error('Expected at least one line.')
+ }
+ return output
+ }
+
+export default lines
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 | 22x +22x + + + + + + + + + + +22x +4274x +8524x +8512x +8512x +4274x + + + + +4274x + | import auto from './auto.js'
+import raw from './raw.js'
+import type S from './sanitised.js'
+
+/**
+ * @returns comma separated list of values.
+ *
+ * If there are no `undefined` values, `undefined` is propagated.
+ *
+ * Optional element to sanitised string mapping can be provided (defaults to auto-sanitation).
+ */
+export const list =
+ <T>(values: readonly T[], sanitise: (value: T) => undefined | S = auto, separator = ', '): undefined | S => {
+ const values_ = values
+ .filter(_ => typeof _ !== 'undefined')
+ .map(_ => sanitise(_)?.toString().trim())
+ .filter(_ => typeof _ !== 'undefined')
+ return values_.length > 0 ?
+ raw(values_.join(separator)) :
+ undefined
+ }
+
+export default list
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 | +22x + + + + + + + + + + + +22x + +22x + | import type S from './sanitised.js'
+import raw from './raw.js'
+
+/**
+ * Simulated logical false – 0=1.
+ *
+ * Logical booleans can be used in condition expressions, ie. WHERE clause.
+ *
+ * Value booleans can be used in assignment statements, ie. UPDATE SET clause.
+ *
+ * @see falseValue for value boolean variant.
+ */
+export const logicalFalse: S =
+ raw('0=1')
+
+export default logicalFalse
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 | +22x + + + + + + + + + + + +22x + +25x + | import type S from './sanitised.js'
+import raw from './raw.js'
+
+/**
+ * Simulated logical true – 1=1.
+ *
+ * Logical booleans can be used in condition expressions, ie. WHERE clause.
+ *
+ * Value booleans can be used in assignment statements, ie. UPDATE SET clause.
+ *
+ * @see trueValue for value boolean variant.
+ */
+export const logicalTrue: S =
+ raw('1=1')
+
+export default logicalTrue
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 | 22x + + + + + + + + +22x +2x + +22x + | import op from './op.js'
+import type S from './sanitised.js'
+
+/**
+ * @returns lower than expression.
+ *
+ * `undefined` RHS is propagated.
+ */
+export const lt =
+ (l: S | string, r: unknown): undefined | S =>
+ op(l, '<', r)
+
+export default lt
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 | 22x + + + + + + + + +22x +2x + +22x + | import op from './op.js'
+import type S from './sanitised.js'
+
+/**
+ * @returns lower than or equal expression.
+ *
+ * `undefined` RHS is propagated.
+ */
+export const lte =
+ (l: S | string, r: unknown): undefined | S =>
+ op(l, '<=', r)
+
+export default lte
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 | + +24x +14x +14x +16x +6x + + +14x + + +24x + | /** @returns whitespace margin (spaces/tabs) for single/first line. */
+const marginOfFirstLine =
+ (line: string): string => {
+ let i = 0
+ for (; i < line.length; i++) {
+ if (line[i] !== ' ' && line[i] !== '\t') {
+ break
+ }
+ }
+ return line.slice(0, i)
+ }
+
+export default marginOfFirstLine
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 | 23x + + +23x +8x + +23x + | import marginOfFirstLine from './margin-of-first-line.js'
+
+const marginOfLastLine =
+ (linesString: string): string =>
+ marginOfFirstLine(linesString.substr(1 + linesString.lastIndexOf('\n')))
+
+export default marginOfLastLine
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 | 22x +22x + + + + + + + + + + +22x + + + + + + +22x + | import auto from './auto.js' +import raw from './raw.js' +import type S from './sanitised.js' + +/** + * @returns space delimited line constructed from provided elements. + * + * `undefined` values are filtered out. + * + * Empty list (after filtering out `undefined`) propagates `undefined`. + */ +export const maybeLine = + (...elements: unknown[]): undefined | S => { + const elements_ = elements.filter(_ => typeof _ !== 'undefined') + return elements_.length > 0 ? + raw(elements_.map(auto).map(_ => _.toString().trim()).join(' ')) : + undefined + } + +export default maybeLine + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 | 22x +22x + + + + +22x + +5x +10x +7x +7x +7x +5x +2x + +3x + + +22x + | import auto from './auto.js' +import raw from './raw.js' +import type S from './sanitised.js' + +/** @returns lines joined with provided separator or undefined if there are no lines. */ +export const maybeLines = + <T>(inputs: readonly T[], separator = '\n'): undefined | S => { + const outputs = + inputs + .filter(_ => typeof _ !== 'undefined') + .map(_ => auto(_)) + .filter(_ => typeof _ !== 'undefined') + .map(_ => _.toString().trim()) + if (outputs.length === 0) { + return + } + return raw(outputs.join(separator)) + } + +export default maybeLines + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 | 22x +22x +22x +22x +22x + + + + + + +22x + + + + + + + + +5x +5x +5x +5x + + +5x +1x + +4x + + + + + + + + + + + + + + +22x + | import id from './identifier.js'
+import inlineTable from './inline-table-of-column.js'
+import limitedHintsIdentifier from './limited-hints-identifier.js'
+import row from './row.js'
+import tsql from './template.js'
+import type { TableHintLimited } from './table-hint-limited.js'
+import type S from './sanitised.js'
+import type Sid from './sanitised-identifier.js'
+
+/** @returns MERGE DML synchronising 1-n relation. */
+export const merge1n =
+ (
+ table: Sid | string,
+ [ lcolumn, rcolumn ]: [ Sid | string, Sid | string ],
+ lid: unknown,
+ values: unknown[],
+ { hints = [ 'serializable' ] }: {
+ hints?: TableHintLimited[]
+ } = {}
+ ): S => {
+ const table_ = limitedHintsIdentifier(table, hints)
+ const lcolumn_ = id(lcolumn)
+ const rcolumn_ = id(rcolumn)
+ Iif (!Array.isArray(values)) {
+ throw new TypeError(`Expected array of values, got ${values}.`)
+ }
+ if (values.length === 0) {
+ return tsql`delete from ${table_} where ${lcolumn_} = ${lid};`
+ }
+ return tsql`
+ merge ${table_} as ${id('Target')}
+ using ${inlineTable('Source', 'id', values)}
+ on (
+ ${id([ 'Target', lcolumn ])} = ${lid} and
+ ${id([ 'Target', rcolumn ])} = ${id([ 'Source', 'id' ])}
+ )
+ when not matched by target then
+ insert ${row([ lcolumn_, rcolumn_ ])}
+ values ${row([ lid, id('Source.id') ])}
+ when not matched by source and ${id([ 'Target', lcolumn ])} = ${lid} then
+ delete;
+ `
+ }
+
+export default merge1n
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 | 22x +22x +22x +22x +22x +22x + + +22x +22x + + + + + +22x +7x + + +22x +6x + + +22x +2x + + + +5x + + + +22x + + + + +2x + + + +2x +2x +4x +4x +2x +4x +2x + + +2x + +2x + + + + + + + + +22x + | import and from './and.js' +import eq from './eq.js' +import id from './identifier.js' +import inlineTableOfObjects from './inline-table-of-objects.js' +import keysOfObjects from './keys-of-objects.js' +import tsql from './template.js' +import type S from './sanitised.js' +import type Sid from './sanitised-identifier.js' +import list from './list.js' +import assign from './assign.js' + +export type Where = Record<string, unknown> +export type Update = Record<string, Record<string, unknown>> + +export const sourcePrefixed = + (_: Sid | string): Sid => + id([ 'Source', _ ]) + +export const targetPrefixed = + (_: Sid | string): Sid => + id([ 'Target', _ ]) + +export const modify = + (column: string, jsonKeys: string[]): S => + assign( + targetPrefixed(column), + + // eslint-disable-next-line sonarjs/no-nested-template-literals + jsonKeys.reduce((_, jsonKey) => tsql`json_modify(${_}, ${`$.${jsonKey}`}, json_query(${sourcePrefixed(column)}, ${`$.${jsonKey}`}))`, targetPrefixed(column) as S) + ) as S + +/** @returns MERGE DML for json columns, multiple rows via JSON_MODIFY and JSON_QUERY. */ +export const modifyJsons = ( + table: Sid | string, + entries: readonly Record<string, unknown>[] +): S => { + + Iif (entries.length === 0) { + return tsql`select 0;` + } + + const table_ = id(table) + const objectKeys = keysOfObjects(entries) + const onKeys = objectKeys.filter(_ => !_.endsWith('Json')) + const jsonColumns = objectKeys.filter(_ => _.endsWith('Json')) + const update_ = list(jsonColumns.map(jsonColumn => { + const jsonKeys = keysOfObjects(entries.map(_ => _[jsonColumn] as Record<string, unknown>)) + return modify(jsonColumn, jsonKeys) + })) + + const on_ = and(...onKeys.map(_ => eq(sourcePrefixed(_), targetPrefixed(_)))) + + return tsql` + merge ${table_} as ${id('Target')} + using ${inlineTableOfObjects('Source', entries, objectKeys)} + on ${on_} + when matched then + update set ${update_}; + ` +} + +export default modifyJsons + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 | 22x +22x +22x + +22x + + +22x +1x + + +1x +1x + + + + +22x + | import fallback from './fallback.js' +import id from './identifier.js' +import isNull from './is-null.js' +import type S from './sanitised.js' +import tsql from './template.js' + +export const ne = + (lhs: S | string, rhs: unknown): undefined | S => { + Iif (typeof rhs === 'undefined') { + return undefined + } + const l_ = fallback(lhs, id) + return isNull(rhs) ? + tsql`${l_} is not null` : + tsql`${l_} <> ${rhs}` + } + +export default ne + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 | 22x + + + +22x +1x + +22x + | import op from './op.js'
+import type S from './sanitised.js'
+
+export const ng =
+ (lhs: S | string, rhs: unknown): undefined | S =>
+ op(lhs, '!>', rhs)
+
+export default ng
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 | 22x + + + +22x +1x + +22x + | import op from './op.js'
+import type S from './sanitised.js'
+
+export const nl =
+ (lhs: S | string, rhs: unknown): undefined | S =>
+ op(lhs, '!<', rhs)
+
+export default nl
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 | 22x +22x +22x + + + +22x +1x + + + +22x + | import fallback from './fallback.js' +import id from './identifier.js' +import tsql from './template.js' +import type S from './sanitised.js' + +export const notBetween = + <T>(l: string | S, r: undefined | null | [beginExpression: T, endExpression: T]): undefined | S => + typeof l === 'undefined' || r == null ? + undefined : + tsql`${fallback(l, id)} not between ${r[0]} and ${r[1]}` + +export default notBetween + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 | 22x +22x +22x + + + +22x + + + + + + + +44x + | import fallback from './fallback.js' +import id from './identifier.js' +import template from './template.js' +import type S from './sanitised.js' + +export const notDistinct = + (lhs: S | string, rhs: unknown): undefined | S => { + Iif (typeof lhs === 'undefined' || typeof rhs === 'undefined') { + return undefined + } + const lhs_ = fallback(lhs, id) + return template`(not (${lhs_} <> ${rhs} or ${lhs_} is null or ${rhs} is null) or (${lhs_} is null and ${rhs} is null))` + } + +export default notDistinct + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 | 22x +22x +22x +22x +22x + + + +22x +1x + + + + + +44x + | import fallback from './fallback.js' +import id from './identifier.js' +import isNull from './is-null.js' +import row from './row.js' +import tsql from './template.js' +import type S from './sanitised.js' + +export const notIn = + (l: S | string, r: undefined | null | unknown[]): undefined | S => + typeof r === 'undefined' ? + undefined : + r && !isNull(r) && (r.length > 0) ? + tsql`${fallback(l, id)} not in ${row(r)}` : + tsql`${fallback(l, id)} is not null` + +export default notIn + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 | 22x + + + +22x + | import { not } from './where.js'
+
+export { not }
+
+export default not
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 | 22x + + +22x + +22x + | import raw from './raw.js' + +export const now = + raw('sysdatetimeoffset()') + +export default now + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 | 22x +22x + + + +22x +4264x + + + + + +4264x + | import quotedNstring from './quoted-nstring.js' +import S from './sanitised.js' + +// TODO: Add SanitisedValue type? +export const nstring = + (value: undefined | null | string | S): S => + value instanceof S ? + value : + value == null ? + new S('null') : + new S(quotedNstring(String(value))) + +export default nstring + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 | 22x + + +22x + +22x + | import raw from './raw.js'
+
+export const null_ =
+ raw('null')
+
+export default null_
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 | 22x + + + +22x +75x + + +75x + + +75x + | import raw from './raw.js' +import type S from './sanitised.js' + +export const number = + (x: number): S => { + Iif (!Number.isFinite(x)) { + throw new TypeError(`Expected finite number, got ${x}.`) + } + return raw(x.toString(10)) + } + +export default number + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 | +22x + + +22x + + +22x + | import type S from './sanitised.js' +import tsql from './template.js' + +export const objectId = + (name: string): S => + tsql`object_id(${name})` + +export default objectId + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 | 22x +22x +22x + +22x + + + + + + +22x +12x + + + +22x + | import fallback from './fallback.js' +import id from './identifier.js' +import raw from './raw.js' +import type S from './sanitised.js' +import tsql from './template.js' + +/** + * @internal + * @param op_ can leak unsanitised string if misused, hence internal. + */ +export const op = + (l: S | string, op_: S | string, r: unknown): undefined | S => + typeof r === 'undefined' ? + undefined : + tsql`${fallback(l, id)} ${fallback(op_, raw)} ${r}` + +export default op + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 | 22x + + + +22x + | import { or } from './where.js'
+
+export { or }
+
+export default or
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 | 22x +22x +22x + + +22x +4x + +22x + | import id, { type Identifier } from './identifier.js'
+import list from './list.js'
+import raw from './raw.js'
+
+const orderBy =
+ (terms: [identifier: undefined | Identifier, direction: 'asc' | 'desc'][]) =>
+ list(terms.map(_ => _?.[0] != null ? raw(`${id(_[0])} ${_[1]}`) : undefined))
+
+export default orderBy
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 | + + +22x + + + + + + + + + +22x + | +/** @returns an object with picked keys; `null` is used when value is not defined. */ +export const pick = + (object: Record<string, unknown>, keys: string[]): Record<string, unknown> => { + const result: Record<string, unknown> = {} + for (const key of keys) { + result[key] = typeof object[key] === 'undefined' ? + null : + object[key] + } + return result + } + +export default pick + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 | + +22x + + +22x +4267x + + +22x +4265x +4263x + +2x + + + +22x +4264x +4263x + +1x + + + +22x +4264x + + +4264x + + +4264x + | /* eslint-disable @typescript-eslint/ban-types */
+
+import isString from './is-string.js'
+
+const quoted =
+ (value: string | String): string =>
+ 'N\'' + (value.indexOf('\'') !== -1 ? value.replace(/'/g, '\'\'') : value) + '\''
+
+const quotedLf =
+ (value: string | String): string => {
+ if (value.indexOf('\n') === -1) {
+ return quoted(value)
+ }
+ return 'concat_ws(nchar(10), ' + value.split('\n').map(quoted).join(', ') + ')'
+ }
+
+const quotedCrLf =
+ (value: string | String): string => {
+ if (value.indexOf('\r\n') === -1) {
+ return quotedLf(value)
+ }
+ return 'concat_ws(nchar(13) + nchar(10), ' + value.split('\r\n').map(quotedLf).join(', ') + ')'
+ }
+
+export const quotedNstring =
+ (value: string | String): string => {
+ Iif (!isString(value)) {
+ throw new TypeError(`Expected string while trying to quote, got ${value}.`)
+ }
+ return quotedCrLf(value)
+ }
+
+export default quotedNstring
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 | 22x + + +22x + + +22x +32x +32x + + + +22x +32x + +22x + | import identifier from './identifier.js'
+import type Sid from './sanitised-identifier.js'
+
+const alphabet = 'abcdefghijklmnopqrstuvwxyABCDEFGHIJKLMNOPQRSTUVWXYZ'
+
+const randomLetter =
+ (): string => {
+ const index = Math.min(alphabet.length - 1, Math.floor(Math.random() * alphabet.length))
+ return alphabet[index]
+ }
+
+const randomIdentifier =
+ (prefix = '', length = 32): Sid =>
+ identifier([ prefix, Array.from(Array(length), () => randomLetter()).join('') ].join(''))
+
+export default randomIdentifier
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 | 22x + + + +22x +9282x + +9282x + | import S from './sanitised.js'
+
+/** @returns force `x` string to be sanitised; no sanitation of any kind is performed. */
+export const raw =
+ (x: string): S =>
+ new S(x)
+
+export default raw
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 | 22x +22x +22x +22x +22x +22x +22x +22x +22x +22x + + + + +22x +22x + + + +22x + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +22x + | import and from './and.js'
+import assign from './assign.js'
+import eq from './eq.js'
+import id from './identifier.js'
+import inlineTableOfObjects from './inline-table-of-objects.js'
+import keysOfObjects from './keys-of-objects.js'
+import limitedHintsIdentifier from './limited-hints-identifier.js'
+import list from './list.js'
+import row from './row.js'
+import tsql from './template.js'
+import type { TableHintLimited } from './table-hint-limited.js'
+import type S from './sanitised.js'
+import type Sid from './sanitised-identifier.js'
+
+const sourcePrefixed = (_: string): Sid => id([ 'Source', _ ])
+const targetPrefixed = (_: string): Sid => id([ 'Target', _ ])
+
+/** @returns merge dml that replaces target table with inlined source table. */
+export const replaceObjects =
+ (
+ table: string | Sid,
+ onKeys: string[],
+ objects: readonly Record<string, unknown>[],
+ maybeObjectKeys?: string[],
+ maybeUpdateKeys?: string[],
+ maybeInsertKeys?: string[],
+ { hints }: {
+ hints?: TableHintLimited[]
+ } = {}
+ ): S => {
+
+ Iif (!Array.isArray(objects)) {
+ throw new TypeError(`Expected array of values, got ${objects}.`)
+ }
+
+ const table_ = limitedHintsIdentifier(table, hints)
+
+ Iif (objects.length === 0) {
+ return tsql`delete from ${table_};`
+ }
+
+ const objectKeys = maybeObjectKeys || keysOfObjects(objects)
+ const updateKeys = maybeUpdateKeys || objectKeys
+ const insertKeys = maybeInsertKeys || objectKeys
+ const update_ = list(updateKeys.map(_ => assign(_, sourcePrefixed(_))))
+ const on_ = and(...onKeys.map(_ => eq(sourcePrefixed(_), targetPrefixed(_))))
+
+ return tsql`
+ merge ${table_} as Target
+ using ${inlineTableOfObjects('Source', objects, objectKeys)}
+ on ${on_}
+ when not matched by source then
+ delete
+ when matched then
+ update set ${update_}
+ when not matched by target then
+ insert ${row(insertKeys.map(id))}
+ values ${row(insertKeys.map(sourcePrefixed))};
+ `
+ }
+
+export default replaceObjects
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 | 22x +22x +22x + + + + +22x +4191x + +4191x + | import auto from './auto.js'
+import list from './list.js'
+import raw from './raw.js'
+import type S from './sanitised.js'
+
+/** @returns sanitised */
+export const row =
+ <T>(xs: T[], f: (_: T) => S = auto): S =>
+ raw('(' + String(list(xs, f)) + ')')
+
+export default row
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 | 22x + + + +22x + + + + + + +22x + | import row from './row.js' +import type S from './sanitised.js' + +export const rowset = + <T>(values: T[][]): S => { + Iif (!Array.isArray(values)) { + throw new TypeError(`Expected array, got ${values}.`) + } + return row(values, row) + } + +export default rowset + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 | 22x + +22x + + + + + + +970x + | import S from './sanitised.js'
+
+const tag = Symbol()
+
+export class SanitisedIdentifier extends S {
+ // @ts-expect-error This tag ensures the class is not forgeable
+ private readonly [tag]: 'SanitisedIdentifier'
+}
+
+export default SanitisedIdentifier
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 | 22x + + + + + + +31625x + | const tag = Symbol()
+
+export class Sanitised extends String {
+ // @ts-expect-error This tag ensures the class is not forgeable
+ private readonly [tag]: 'Sanitised'
+}
+
+export default Sanitised
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 | 22x +22x +22x +22x +22x + +22x + + +22x + + + +22x + + + + + + + + + + + + +22x + | import fallback from './fallback.js' +import id from './identifier.js' +import line from './line.js' +import list from './list.js' +import S from './sanitised.js' +import type Sid from './sanitised-identifier.js' +import tsql from './template.js' + +export const ids = + (xs: (S | string)[]): S[] => + xs.map(_ => _ instanceof S ? _ : id(_)) + +export const select = + (what: S | (S | string)[], { from, where }: { from?: Sid | string, where?: unknown } = {}): S => { + const what_ = fallback(what, _ => list(ids(_))) + Iif (typeof what_ === 'undefined') { + throw new Error('Empty projection.') + } + const from_ = from != null ? id(from) : undefined + return line( + tsql`select ${what_}`, + tsql`from ${from_}`, + where != null ? tsql`where ${where}` : undefined + ) + } + +export default select + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 | 22x + + +22x + + +22x + + + + +22x + | import id from './identifier.js' +import type S from './sanitised.js' +import type Sid from './sanitised-identifier.js' +import tsql from './template.js' + +export const star = + (table?: Sid | string): S => + table != null ? + tsql`${id(table)}.*` : + tsql`*` + +export default star + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 | 22x + + + + + + + + + + + + + + + + + + + + + + + + + +22x + + + + + + + + + + + + + + + + + + + + + +18x +22x +18x + + +18x + + | import raw from './raw.js' +import type S from './sanitised.js' + +export type TableHintLimited = + | 'keepidentity' + | 'keepdefaults' + | 'holdlock' + | 'ignore_constraints' + | 'ignore_triggers' + | 'nolock' + | 'nowait' + | 'paglock' + | 'readcommitted' + | 'readcommittedlock' + | 'readpast' + | 'repeatableread' + | 'rowlock' + | 'serializable' + | 'snapshot' + | 'tablock' + | 'tablockx' + | 'updlock' + | 'xlock' + +export type t = TableHintLimited + +export const values = new Set<TableHintLimited>([ + 'keepidentity', + 'keepdefaults', + 'holdlock', + 'ignore_constraints', + 'ignore_triggers', + 'nolock', + 'nowait', + 'paglock', + 'readcommitted', + 'readcommittedlock', + 'readpast', + 'repeatableread', + 'rowlock', + 'serializable', + 'snapshot', + 'tablock', + 'tablockx', + 'updlock', + 'xlock' +]) + +export const sanitized = + (value: string): S => { + Iif (!(values as Set<string>).has(value)) { + throw new TypeError(`Expected limited table hint, got ${value}.`) + } + return raw(value) + } + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 | 22x +22x +22x +22x + + + +22x +406x + +406x + | import auto from './auto.js'
+import demargin from './demargin.js'
+import interpolate from './interpolate.js'
+import raw from './raw.js'
+import type S from './sanitised.js'
+
+export const template =
+ (ts: TemplateStringsArray, ...vs: unknown[]): S =>
+ raw(demargin(interpolate(ts, vs.map(auto)).join('')))
+
+export default template
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 +65 +66 +67 +68 +69 +70 +71 +72 +73 +74 +75 +76 +77 +78 +79 +80 +81 +82 +83 +84 +85 +86 +87 +88 +89 +90 +91 +92 +93 +94 +95 +96 +97 +98 +99 +100 +101 +102 +103 +104 +105 +106 +107 +108 +109 +110 +111 +112 +113 +114 +115 +116 +117 +118 +119 +120 +121 +122 +123 +124 +125 +126 +127 +128 +129 +130 +131 +132 +133 +134 +135 +136 +137 +138 +139 +140 +141 +142 +143 +144 | 2x +2x +2x + +2x + + + + + + + + + + + + +4x + + + + + + + + + + + + + +2x +2x +2x + + + + + + + + + +2x +2x +2x + + + +4x +4x +4x + + + + + +4x + + + +69x +69x + + + +69x +69x +69x + + +69x +50x +95x + + +69x + +69x + + + + +25x + + + +11x + + + +10x +10x + + + +9x + + + +13x + + + +2x + + + +10x + + + +7x + + + +7x + + + + + + + + + + + + + + + +4x + + + + + + +1x + + + + | import { Connection, Request } from 'tedious'
+import * as Tsql from '../index.js'
+import randomIdentifier from '../random-identifier.js'
+
+export default class Client {
+
+ connection: Connection
+
+ constructor({
+ database = 'test',
+ userName = 'sa',
+ password = 'yourStrong(!)Password'
+ }: {
+ database?: string,
+ userName?: string,
+ password?: string
+ } = {}) {
+ this.connection = new Connection({
+ server: process.env.MSSQL_HOST ?? 'localhost',
+ options: {
+ database,
+ trustServerCertificate: true,
+ rowCollectionOnDone: true,
+ rowCollectionOnRequestCompletion: true,
+ useColumnNames: true
+ },
+ authentication: { type: 'default', options: { userName, password } }
+ })
+ }
+
+ static async createDatabase(database: string) {
+ const sql = await new Client({ database: 'master' }).connect()
+ await sql.rows`create database ${Tsql.id(database)}`
+ sql.close()
+ }
+
+ static async dropDatabase(database: string) {
+ const sql = await new Client({ database: 'master' }).connect()
+ await sql.rows`drop database ${Tsql.id(database)}`
+ sql.close()
+ }
+
+ static async random() {
+ const database = randomIdentifier('test_', 16).toString()
+ await this.createDatabase(database)
+ return new Client({ database }).connect()
+ }
+
+ async connect(): Promise<this> {
+ return new Promise((resolve, reject) => {
+ this.connection.connect((err: unknown) => {
+ err != null ? reject(err) : resolve(this)
+ })
+ })
+ }
+
+ close() {
+ this.connection.close()
+ }
+
+ async query<T>(sql: undefined | Tsql.S): Promise<undefined | (T[])> {
+ return new Promise((resolve, reject) => {
+ Iif (typeof sql === 'undefined') {
+ resolve(undefined)
+ return
+ }
+ const sqlString = sql.toString()
+ const request = new Request(sqlString, (err, _rowCount, rows) => {
+ Iif (err != null) {
+ reject(new Error(err.message + `; ${sqlString}`))
+ }
+ for (const row of rows) {
+ for (const key in row) {
+ row[key] = row[key].value
+ }
+ }
+ resolve(rows)
+ })
+ this.connection.execSql(request)
+ })
+ }
+
+ async rows<T>(tsa: TemplateStringsArray, ...rest: unknown[]) {
+ return this.query<T>(Tsql.template(tsa, ...rest))
+ }
+
+ async row<T>(tsa: TemplateStringsArray, ...rest: unknown[]) {
+ return this.rows<T>(tsa, ...rest).then(_ => _?.[0])
+ }
+
+ async value<T>(tsa: TemplateStringsArray, ...rest: unknown[]) {
+ const row = await this.row<Record<string, T>>(tsa, ...rest)
+ return row?.[Object.keys(row)[0]]
+ }
+
+ async count(table: Tsql.Sid | string, where: Tsql.Where = Tsql.logicalTrue) {
+ return this.value`select count(*) from ${Tsql.id(table)} where ${Tsql.where(where)}`
+ }
+
+ async delete(table: Tsql.Sid | string, where: Tsql.Where = Tsql.logicalTrue) {
+ await this.query(Tsql.delete(table, where))
+ }
+
+ async dropTable(table: Tsql.Sid | string) {
+ await this.query(Tsql.template`drop table ${Tsql.id(table)};`)
+ }
+
+ async insertIgnore(...args: Parameters<typeof Tsql['insertIgnore']>) {
+ return this.query(Tsql.insertIgnore(...args))
+ }
+
+ async insertObject(table: Tsql.Sid | string, object: Record<string, unknown>, output?: Tsql.S) {
+ return this.query(Tsql.insertObject(table, object, output))
+ }
+
+ async insertObjects(table: Tsql.Sid | string, objects: Record<string, unknown>[], maybeKeys?: string[]) {
+ return this.query(Tsql.insertObjects(table, objects, maybeKeys))
+ }
+
+ async update(table: Tsql.Sid | string, where: Tsql.Where, object: Record<string, unknown>) {
+ return this.query(Tsql.update(table, where, object))
+ }
+
+ async merge1n(
+ table: Tsql.Sid | string,
+ [ lcolumn, rcolumn ]: [ Tsql.Sid | string, Tsql.Sid | string ],
+ lid: unknown,
+ values: unknown[],
+ { hints = [ 'serializable' ] }: {
+ hints?: Tsql.TableHintLimited.t[]
+ } = {}
+ ) {
+ return this.query(Tsql.merge1n(table, [ lcolumn, rcolumn ], lid, values, { hints }))
+ }
+
+ async modifyJsons(
+ table: Tsql.Sid | string,
+ entries: readonly Record<string, unknown>[]
+ ) {
+ return this.query(Tsql.modifyJsons(table, entries))
+ }
+
+}
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| File | ++ | Statements | ++ | Branches | ++ | Functions | ++ | Lines | ++ |
|---|---|---|---|---|---|---|---|---|---|
| client.ts | +
+
+ |
+ 84.44% | +38/45 | +64.28% | +9/14 | +91.66% | +22/24 | +84.09% | +37/44 | +
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 | 22x +22x +22x +22x + + + + + + + + + + +22x + + + + + + + + + + + + + + +22x + | import auto from './auto.js'
+import line from './line.js'
+import number from './number.js'
+import raw from './raw.js'
+import type S from './sanitised.js'
+
+/**
+ * @returns top expression.
+ * @example top(1, raw('with ties'))
+ * @example top(1, star)
+ * @example top(0.1, star) // value in <0,1> range returns percent, ie. `top 10 percent`.
+ * @example top(1, ids('foo', 'bar', 'baz'))
+ */
+export const top =
+ (x = 1, ...rest: S[]): S => {
+ Iif (x <= 0) {
+ throw new TypeError(`Expected positive value in top, got ${x}.`)
+ }
+ const [ x_, percent ] = x < 1 ?
+ [ Math.round(x * 100), true ] :
+ [ Math.round(x), false ]
+ return line(
+ raw('top'),
+ number(x_),
+ percent ? raw('percent') : undefined,
+ ...rest.map(auto)
+ )
+ }
+
+export default top
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 | +22x + + + + + + + + + + + +22x + +22x + | import type S from './sanitised.js'
+import raw from './raw.js'
+
+/**
+ * Value boolean true – 1 casted as BIT.
+ *
+ * Logical booleans can be used in condition expressions, ie. WHERE clause.
+ *
+ * Value booleans can be used in assignment statements, ie. UPDATE SET clause.
+ *
+ * @see trueValue for value boolean variant.
+ */
+export const trueValue: S =
+ raw('cast(1 as bit)')
+
+export default trueValue
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 | + + + +78x +78x +78x +108x +108x +105x +105x + + +78x + + +78x + | import S from './sanitised.js'
+
+/** @returns deduplicated values. */
+export function unique(values: S[]): S[] {
+ const set = new Set<string>
+ const result: S[] = []
+ for (const value of values) {
+ const stringValue = value.toString()
+ if (!set.has(stringValue)) {
+ set.add(stringValue)
+ result.push(value)
+ }
+ }
+ return result
+}
+
+export default unique
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 | 22x + + +22x + +22x + | import tsql from './template.js'
+
+const unix =
+ tsql`datediff(s, '1970-01-01 00:00:00', getutcdate())`
+
+export default unix
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 | 22x +22x +22x +22x +22x +22x +22x +22x +22x + + + + + +22x + + + +22x + + + + +22x + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +22x + | import and from './and.js'
+import assign from './assign.js'
+import eq from './eq.js'
+import id from './identifier.js'
+import inlineTableOfObjects from './inline-table-of-objects.js'
+import keysOfObjects from './keys-of-objects.js'
+import limitedHintsIdentifier from './limited-hints-identifier.js'
+import list from './list.js'
+import tsql from './template.js'
+import type { TableHintLimited } from './table-hint-limited.js'
+import type S from './sanitised.js'
+import type Sid from './sanitised-identifier.js'
+
+export const sourcePrefixed =
+ (_: Sid | string): Sid =>
+ id([ 'Source', _ ])
+
+export const targetPrefixed =
+ (_: Sid | string): Sid =>
+ id([ 'Target', _ ])
+
+/** @returns update dml that runs update operations on target table from the result of a join with source table. */
+export const updateObjects =
+ (
+ table: Sid | string,
+ onKeys: string[],
+ objects: Record<string, unknown>[],
+ maybeObjectKeys?: string[],
+ maybeUpdateKeys?: string[],
+ { hints = [ 'repeatableread' ] }: {
+ hints?: TableHintLimited[]
+ } = {}
+ ): S => {
+
+ Iif (!Array.isArray(objects)) {
+ throw new TypeError(`Expected array of values, got ${objects}.`)
+ }
+
+ Iif (objects.length === 0) {
+ return tsql`select 0;`
+ }
+
+ const table_ = limitedHintsIdentifier(table, hints)
+ const objectKeys = maybeObjectKeys || keysOfObjects(objects)
+ const updateKeys = maybeUpdateKeys || objectKeys
+ const update_ = list(updateKeys.map(_ => assign(_, sourcePrefixed(_))))
+ const on_ = and(...onKeys.map(_ => eq(sourcePrefixed(_), targetPrefixed(_))))
+
+ return tsql`
+ merge ${table_} as Target
+ using ${inlineTableOfObjects('Source', objects, objectKeys)}
+ on ${on_}
+ when matched then
+ update set ${update_};
+ `
+ }
+
+export default updateObjects
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 | 22x +22x +22x +22x +22x + + + +22x + + + +22x + + + + + + + +6x +1x + +5x +5x +5x +5x +1x + +4x + + + + + + + +22x + | import assignObject from './assign-object.js'
+import fallback from './fallback.js'
+import limitedHintsIdentifier from './limited-hints-identifier.js'
+import logicalTrue from './logical-true.js'
+import tsql from './template.js'
+import type { TableHintLimited } from './table-hint-limited.js'
+import type S from './sanitised.js'
+import type Sid from './sanitised-identifier.js'
+import whereOf from './where.js'
+
+/** @returns UPDATE DML. */
+export const update =
+ (
+ table: Sid | string,
+ where: S | Record<string, unknown>,
+ object: Record<string, unknown>,
+ { hints = [ 'repeatableread' ] }: {
+ hints?: TableHintLimited[]
+ } = {}
+ ): undefined | S => {
+ if (Object.keys(object).length === 0) {
+ return
+ }
+ const table_ = limitedHintsIdentifier(table, hints)
+ const where_ = fallback(where, whereOf) ?? logicalTrue
+ const object_ = assignObject(object)
+ if (typeof object_ === 'undefined') {
+ return
+ }
+ return tsql`
+ update ${table_}
+ set
+ ${object_}
+ where ${where_}
+ `
+ }
+
+export default update
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 +65 +66 +67 +68 +69 +70 +71 | 22x +22x +22x +22x +22x +22x +22x +22x +22x +22x + + + + + +22x + + + +22x + + + + + + + + + + +22x + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +22x + | import and from './and.js'
+import assign from './assign.js'
+import eq from './eq.js'
+import id from './identifier.js'
+import inlineTableOfObjects from './inline-table-of-objects.js'
+import keysOfObjects from './keys-of-objects.js'
+import limitedHintsIdentifier from './limited-hints-identifier.js'
+import list from './list.js'
+import row from './row.js'
+import tsql from './template.js'
+import type { TableHintLimited } from './table-hint-limited.js'
+import type S from './sanitised.js'
+import type Sid from './sanitised-identifier.js'
+
+export const sourcePrefixed =
+ (_: Sid | string): Sid =>
+ id([ 'Source', _ ])
+
+export const targetPrefixed =
+ (_: Sid | string): Sid =>
+ id([ 'Target', _ ])
+
+/**
+ * @returns MERGE DML.
+ *
+ * Updates existing rows.
+ *
+ * Inserts unmatched rows.
+ */
+export const upsertObjects =
+ (
+ table: Sid | string,
+ onKeys: string[],
+ objects: Record<string, unknown>[],
+ maybeObjectKeys?: string[],
+ maybeUpdateKeys?: string[],
+ maybeInsertKeys?: string[],
+ { hints = [ 'serializable' ] }: {
+ hints?: TableHintLimited[]
+ } = {}
+ ): S => {
+
+ Iif (!Array.isArray(objects)) {
+ throw new TypeError(`Expected array of values, got ${objects}.`)
+ }
+
+ Iif (objects.length === 0) {
+ return tsql`select 0;`
+ }
+
+ const table_ = limitedHintsIdentifier(table, hints)
+ const objectKeys = maybeObjectKeys || keysOfObjects(objects)
+ const updateKeys = maybeUpdateKeys || objectKeys
+ const insertKeys = maybeInsertKeys || objectKeys
+ const update_ = list(updateKeys.map(_ => assign(_, sourcePrefixed(_))))
+ const on_ = and(...onKeys.map(_ => eq(sourcePrefixed(_), targetPrefixed(_))))
+
+ return tsql`
+ merge ${table_} as Target
+ using ${inlineTableOfObjects('Source', objects, objectKeys)}
+ on ${on_}
+ when matched then
+ update set ${update_}
+ when not matched by target then
+ insert ${row(insertKeys.map(id))}
+ values ${row(insertKeys.map(sourcePrefixed))};
+ `
+ }
+
+export default upsertObjects
+ |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 +65 +66 +67 +68 +69 +70 +71 +72 +73 +74 +75 +76 +77 +78 +79 +80 +81 +82 +83 +84 +85 +86 +87 +88 +89 +90 +91 +92 +93 +94 +95 +96 +97 +98 +99 +100 +101 +102 +103 +104 +105 +106 +107 +108 +109 +110 +111 +112 +113 +114 +115 +116 +117 +118 +119 +120 +121 +122 +123 +124 +125 +126 +127 +128 +129 +130 +131 +132 +133 +134 +135 +136 +137 +138 +139 +140 +141 +142 +143 +144 +145 +146 +147 +148 +149 +150 +151 +152 +153 +154 +155 +156 +157 +158 +159 +160 +161 +162 +163 +164 +165 +166 +167 +168 +169 +170 +171 +172 +173 +174 +175 +176 +177 +178 +179 +180 +181 +182 +183 +184 +185 +186 +187 +188 +189 +190 +191 +192 +193 +194 | 22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x +22x + + + + + +22x + + + + + +22x + + + + + + + + + + + + + + + + + + + + + +22x + + + + + + + + +103x +27x + + +76x +80x +74x +74x + +6x + +70x + + + +53x +6x + +47x +47x +17x +17x + + +2x + + +2x + + +2x + + + +2x + + +2x + + +2x + +13x + + + + + + + + +30x + + + +170x +114x + +56x +56x +49x +49x +8x + + +8x + +41x +2x + + +46x +53x +46x + + + + + + + + + + +139x + + + + + + + + + + + +22x +79x +79x +6x + +73x + + + + + + + + + +22x +9x +9x +4x + +5x + + +22x +2x + + + + +42x + | import { isDefined } from './is-defined.js'
+import { isObject } from './is-object.js'
+import auto from './auto.js'
+import between from './between.js'
+import distinct from './distinct.js'
+import eq from './eq.js'
+import gt from './gt.js'
+import gte from './gte.js'
+import in_ from './in.js'
+import interpolate1 from './interpolate1.js'
+import like from './like.js'
+import logicalFalse from './logical-false.js'
+import logicalTrue from './logical-true.js'
+import lt from './lt.js'
+import lte from './lte.js'
+import ne from './ne.js'
+import ng from './ng.js'
+import nl from './nl.js'
+import notBetween from './not-between.js'
+import notDistinct from './not-distinct.js'
+import notIn from './not-in.js'
+import raw from './raw.js'
+import S from './sanitised.js'
+import template from './template.js'
+import unique from './unique.js'
+
+export type Where = S | Record<string, unknown>
+
+export type t = Where
+
+const unary = {
+ $not: not
+} as const
+
+type Unary = typeof unary
+
+const binary = {
+ $between: between,
+ $distinct: distinct,
+ $eq: eq,
+ $gt: gt,
+ $gte: gte,
+ $in: in_,
+ $like: like,
+ $lt: lt,
+ $lte: lte,
+ $ne: ne,
+ $ng: ng,
+ $nl: nl,
+ $notBetween: notBetween,
+ $notDistinct: notDistinct,
+ $ndistinct: notDistinct,
+ $notIn: notIn,
+ $nin: notIn
+} as const
+
+type Binary = typeof binary
+
+const logical = {
+ $and: and,
+ $or: or
+} as const
+
+type Logical = typeof logical
+
+/** @returns single key in object iff object has single key, `undefined` otherwise. */
+function single(value: unknown): undefined | string {
+ if (!isObject(value)) {
+ return undefined
+ }
+ let result: undefined | string
+ for (const key in value) {
+ if (result === undefined) {
+ result = key
+ continue
+ }
+ return undefined
+ }
+ return result
+}
+
+function visitEntry(key: string, value: unknown): undefined | S {
+ if (typeof value === 'function') {
+ return value(key)
+ }
+ const key_ = single(value)
+ if (key_ && key_ in binary) {
+ const value_ = (value as Record<string, unknown>)[key_]
+ switch (key_) {
+ case '$between':
+ case '$notBetween':
+ Iif (value_ == null) {
+ return binary[key_](key, value_)
+ }
+ Iif (!Array.isArray(value_) || value_.length > 2) {
+ throw new TypeError(`Invalid ${key_} parameters.`)
+ }
+ return binary[key_](key, [ value_[0], value_[1] ])
+ case '$in':
+ case '$nin':
+ case '$notIn':
+ Iif (value_ == null) {
+ return binary[key_](key, value_)
+ }
+ Iif (!Array.isArray(value_)) {
+ throw new TypeError(`Invalid ${key_} parameters.`)
+ }
+ return binary[key_](key, value_)
+ default:
+ return binary[key_ as Exclude<keyof Binary,
+ | '$between'
+ | '$notBetween'
+ | '$in'
+ | '$nin'
+ | '$notIn'
+ >](key, value_)
+ }
+ }
+ return eq(key, value)
+}
+
+export function visit(value: unknown): S {
+ if (value instanceof S) {
+ return value
+ }
+ const key = single(value)
+ if (key) {
+ const value_ = (value as Record<string, unknown>)[key]
+ if ((key in logical) && Array.isArray(value_)) {
+ Iif (typeof logical[key as keyof Logical] !== 'function') {
+ console.log('ERROR', key, Object.keys(logical), logical[key as keyof Logical], logical)
+ }
+ return logical[key as keyof Logical](...value_.map(visit))
+ }
+ if ((key in unary)) {
+ return unary[key as keyof Unary](visit(value_)) as S
+ }
+ }
+ if (isObject(value)) {
+ const entries = Object.entries(value).map(_ => visitEntry(..._))
+ return and(...entries)
+ }
+ return auto(value)
+}
+
+/**
+ * @returns WHERE clause.
+ *
+ * Supports MondoDB-like query.
+ */
+export function where(value: Where): S {
+ return visit(value)
+}
+
+/**
+ * @returns terms joined with AND operator.
+ *
+ * `undefined` terms are filtered out.
+ *
+ * An empty list of terms returns logical true (1=1).
+ *
+ * Terms are deduplicated.
+ */
+export function and(...xs: (undefined | Where)[]): S {
+ const xs_ = xs.filter(isDefined)
+ if (xs_.length === 0) {
+ return logicalTrue
+ }
+ return template`(${raw(interpolate1(unique(xs_.map(where)), raw(' and ')).join(''))})`
+}
+
+/**
+ * @returns terms joined with OR operator.
+ *
+ * `undefined` terms are filtered out.
+ *
+ * An empty list of terms returns logical false (0=1).
+ */
+export function or(...xs: (undefined | Where)[]): S {
+ const xs_ = xs.filter(isDefined)
+ if (xs_.length === 0) {
+ return logicalFalse
+ }
+ return template`(${raw(interpolate1(unique(xs_.map(where)), raw(' or ')).join(''))})`
+}
+
+export function not(rhs: undefined | Where): undefined | S {
+ return isDefined(rhs) ?
+ template`not (${where(rhs)})` :
+ undefined
+}
+
+export default where
+ |