doix-db 1.0.23 → 1.0.26

package/index.js

@@ -4,6 +4,7 @@ module.exports = {
 	DbClient:       require ('./lib/DbClient.js'),
 	DbPool:         require ('./lib/DbPool.js'), 
 	DbLang:         require ('./lib/DbLang.js'),
+	DbCsvPrinter:   require ('./lib/DbCsvPrinter.js'),
 	DbColumn:       require ('./lib/model/DbColumn.js'),
 	DbReference:    require ('./lib/model/DbReference.js'),
 	DbObjectMerger: require ('./lib/model/DbObjectMerger.js'),
@@ -23,6 +24,8 @@ module.exports = {
 	DbTypeArithmeticFloat: require ('./lib/model/types/DbTypeArithmeticFloat.js'),
 	DbTypeArithmeticInt:   require ('./lib/model/types/DbTypeArithmeticInt.js'),
 	DbTypeCharacter:       require ('./lib/model/types/DbTypeCharacter.js'),
+	DbTypeDate:            require ('./lib/model/types/DbTypeDate.js'),
+	DbTypeTimestamp:       require ('./lib/model/types/DbTypeTimestamp.js'),
 
 	DbMigrationPlan:require ('./lib/migration/DbMigrationPlan.js'),
 	DbQuery:        require ('./lib/query/DbQuery.js'),

package/lib/DbClient.js

@@ -1,6 +1,7 @@
 const EventEmitter    = require ('events')
 const {randomUUID}    = require ('crypto')
 
+const DbCsvPrinter    = require ('./DbCsvPrinter.js')
 const DbCall          = require ('./DbCall.js')
 const DbQuery         = require ('./query/DbQuery.js')
 const DbMigrationPlan = require ('./migration/DbMigrationPlan.js')
@@ -33,6 +34,22 @@ class DbClient extends EventEmitter {
 		this.uuid = randomUUID ()
 	
 	}
+
+	async createTempTable (table, options) {
+
+		if (typeof table === 'string') table = this.model.find (table)
+
+		return this.do (this.lang.genCreateTempTable (table, options))
+
+	}
+
+	toCsv (options) {
+
+		const {lang} = this
+
+		return new DbCsvPrinter ({...options, lang})
+
+	}
 	
 	createMigrationPlan () {
 	

package/lib/DbCsvPrinter.js

@@ -0,0 +1,239 @@
+const DbColumn = require ('./model/DbColumn.js')
+const DbTypeArithmetic =      require ('./model/types/DbTypeArithmetic.js')
+const DbTypeArithmeticInt =   require ('./model/types/DbTypeArithmeticInt.js')
+const DbTypeArithmeticFixed = require ('./model/types/DbTypeArithmeticFixed.js')
+const DbTypeCharacter =       require ('./model/types/DbTypeCharacter.js')
+const DbTypeTemporal =        require ('./model/types/DbTypeTemporal.js')
+const DbTypeDate =            require ('./model/types/DbTypeDate.js')
+const DbTypeTimestamp =       require ('./model/types/DbTypeTimestamp.js')
+const {Transform} = require ('stream')
+const stringEscape = require ('string-escape-map')
+const CH_QQ = '"', QQ_ESC = new stringEscape ([[CH_QQ, CH_QQ + CH_QQ]])
+
+const FMT_ISO_DATE = new Intl.DateTimeFormat ('sv', {
+	year: 'numeric',
+	month: '2-digit',
+	day: '2-digit',
+})
+
+const FMT_ISO_TIMESTAMP = new Intl.DateTimeFormat ('sv', {
+	year: 'numeric',
+	month: '2-digit',
+	day: '2-digit',
+	hour: '2-digit',
+	minute: '2-digit',
+	second: '2-digit',
+	fractionalSecondDigits: 3
+})
+
+class DbCsvPrinter extends Transform {
+
+	constructor (options = {}) {
+
+		let {table, columns, lang, NULL} = options
+
+		super ({writableObjectMode: true})
+
+		this.NULL = typeof NULL === 'string' ? NULL : ''
+
+		if (!columns) {
+			if (!table) throw Error (`Either table or columns must be defined`)
+			columns = Object.values (table.columns)
+		}		
+
+		if (lang) {
+
+			this.lang = lang
+
+		} 
+		else {
+
+			if (table) {
+				this.lang = table.model.lang
+			}
+			else {
+				throw Error (`Lang not defined`)
+			}
+
+		}
+
+		if (!Array.isArray (columns)) columns = Object.entries (columns).map (([name, def]) => {
+
+			const col = new DbColumn (def)
+
+			col.name = name
+
+			return col
+
+		})
+
+		const {length} = columns; for (let i = 0; i < length; i ++) {
+
+			const col = columns [i];
+				
+			if (typeof col === 'string') {
+
+				if (!table) throw Error ('To pass columns by name only, the table must be provided')
+
+				if (!(col in table.columns)) throw Error (`${table.name}.${col} not found`)
+	
+				columns [i] = table.columns [col]
+
+			}
+
+			if (!('typeDef' in columns [i])) columns [i].setLang (this.lang)
+		
+		}
+
+		this.columns = columns
+
+	}
+
+	_transform (r, _, callback) {
+
+		const {columns} = this, {length} = columns
+
+		try {
+
+			let s = ''; for (let i = 0; i < length; i ++) {
+
+				if (i !== 0) s += ','
+
+				const column = columns [i], {name, typeDef} = column
+
+				const value = r [name], v = value == null ? column.default : value
+
+				switch (v) {
+					case Number.POSITIVE_INFINITY:
+					case Number.NEGATIVE_INFINITY:
+						throw Error (`${column.name}: infinite values not supported`)
+				}
+
+				if (v == null) {
+
+					if (!column.nullable) throw Error (`${name} doesn't allow null values`)
+
+					s += this.NULL
+
+				}
+				else if (typeof v === 'boolean') {
+
+					s += v ? '1' : '0'
+
+				}
+				else if (typeDef instanceof DbTypeCharacter) {
+
+					s += CH_QQ
+					s += QQ_ESC.escape (String (v))
+					s += CH_QQ
+
+				}
+				else if (typeDef instanceof DbTypeArithmetic) {
+
+					const n = Number (v)
+
+					if (typeDef instanceof DbTypeArithmeticInt) {
+
+						if (!Number.isInteger (Number (v))) throw Error (`${column.name} must be integer, found ${value}`)
+
+						s += v
+
+					}
+					else if (typeDef instanceof DbTypeArithmeticFixed) {
+
+						if (!Number.isFinite (n)) throw Error (`${column.name} must be a finite number, found ${value}`)
+
+						s += n.toFixed (column.scale)
+
+					}
+					else {
+
+						if (Number.isNaN (n)) throw Error (`${column.name} must be a number, found ${value}`)
+
+						s += v
+							
+					}
+
+				}
+				else if (typeDef instanceof DbTypeTemporal) {
+
+					const isDate = typeDef instanceof DbTypeDate; if (!isDate && !(typeDef instanceof DbTypeTimestamp)) throw Error (`Don't know how to format ${column.name}`)
+
+					let d; if (typeof v === 'string') {
+
+						d = v
+
+					}
+					else if (v instanceof Date) {
+
+						d = (isDate ? FMT_ISO_DATE : FMT_ISO_TIMESTAMP).format (v)
+
+					}
+					else {
+
+						throw Error (`${column.name} must be a date/time, found ${value}`)
+
+					}
+
+					if (isDate) {
+
+						const {length} = d
+
+						if (length < 10) {
+							throw Error (`${column.name} must be a date, found ${value}`)
+						}
+						else if (length === 10) {
+							s += d
+						}
+						else {
+							s += d.slice (0, 10)
+						}
+
+					}
+					else {
+
+						const {length} = d, {scale} = column
+
+						if (length < 19) {
+
+							throw Error (`${column.name} must be a timestamp, found ${value}`)
+
+						}
+						else {
+
+							s += d.slice (0, 19)
+
+							if (scale > 0 && length > 20) {
+
+								s += '.'
+								s += d.slice (20, 20 + scale)
+
+							}
+							
+						}
+
+					}
+
+				}
+				else {
+
+					throw Error (`Don't know how to format ${column.name}`)
+
+				}
+
+			}
+
+			s += '\n'; callback (null, s)
+
+		}
+		catch (err) {
+
+			callback (err)
+
+		}
+
+	}
+
+}
+
+module.exports = DbCsvPrinter

package/lib/DbLang.js

@@ -7,11 +7,12 @@ const DbProcedure = require ('./model/DbProcedure.js')
 const DbFunction  = require ('./model/DbFunction.js')
 
 const DbType =                require ('./model/types/DbType.js')
-const DbTypeArithmetic =      require ('./model/types/DbTypeArithmetic.js')
 const DbTypeArithmeticFixed = require ('./model/types/DbTypeArithmeticFixed.js')
 const DbTypeArithmeticFloat = require ('./model/types/DbTypeArithmeticFloat.js')
 const DbTypeArithmeticInt =   require ('./model/types/DbTypeArithmeticInt.js')
 const DbTypeCharacter =       require ('./model/types/DbTypeCharacter.js')
+const DbTypeDate =            require ('./model/types/DbTypeDate.js')
+const DbTypeTimestamp =       require ('./model/types/DbTypeTimestamp.js')
 
 const CH_Q = "'", CH_QQ = '"'
 
@@ -27,13 +28,15 @@ const DELIM_UPDATE = [',', ' AND ']
 
 class DbLang {
 
-	static TP_SMALLINT = new DbTypeArithmeticInt   ({name: 'SMALLINT', bytes: 2})
-	static TP_INT      = new DbTypeArithmeticInt   ({name: 'INT',      bytes: 4})
-	static TP_BIGINT   = new DbTypeArithmeticInt   ({name: 'BIGINT',   bytes: 8})
-	static TP_REAL     = new DbTypeArithmeticFloat ({name: 'REAL'})
-	static TP_NUMERIC  = new DbTypeArithmeticFixed ({name: 'NUMERIC'})
-	static TP_CHAR     = new DbTypeCharacter       ({name: 'CHAR'})
-	static TP_VARCHAR  = new DbTypeCharacter       ({name: 'VARCHAR'})
+	static TP_SMALLINT  = new DbTypeArithmeticInt   ({name: 'SMALLINT', bytes: 2})
+	static TP_INT       = new DbTypeArithmeticInt   ({name: 'INT',      bytes: 4})
+	static TP_BIGINT    = new DbTypeArithmeticInt   ({name: 'BIGINT',   bytes: 8})
+	static TP_REAL      = new DbTypeArithmeticFloat ({name: 'REAL'})
+	static TP_NUMERIC   = new DbTypeArithmeticFixed ({name: 'NUMERIC'})
+	static TP_CHAR      = new DbTypeCharacter       ({name: 'CHAR'})
+	static TP_VARCHAR   = new DbTypeCharacter       ({name: 'VARCHAR'})
+	static TP_DATE      = new DbTypeDate            ({name: 'DATE'})
+	static TP_TIMESTAMP = new DbTypeTimestamp       ({name: 'TIMESTAMP'})
 
 	getTypeDefinition (name) {
 
@@ -64,6 +67,12 @@ class DbLang {
 			case 'REAL':
 				return DbLang.TP_REAL
 
+			case 'DATE':
+				return DbLang.TP_DATE
+			
+			case 'TIMESTAMP':
+				return DbLang.TP_TIMESTAMP
+
 		}
 
 		return new DbType ({name})
@@ -467,6 +476,16 @@ class DbLang {
 
 	}
 	
+	genCreateTempTable ({qName, columns}, options = {}) {
+
+		let sql = 'CREATE TEMPORARY TABLE '
+
+		if (options.onlyIfMissing) sql += 'IF NOT EXISTS '
+
+		return sql + qName + ' (' + Object.values (columns).map (c => this.genColumnDefinition (c)) + ')'
+
+	}
+
 	getTriggerName (table, i) {
 
 		return table.name + '__trg_' + i.toString ().padStart ((table.triggers.length - 1).toString ().length, '0')

package/lib/model/types/DbTypeDate.js

@@ -0,0 +1,13 @@
+const DbTypeTemporal = require ('./DbTypeTemporal.js')
+
+class DbTypeDate extends DbTypeTemporal {
+
+	constructor (o) {
+	
+		super (o)
+	
+	}
+
+}
+
+module.exports = DbTypeDate

package/lib/model/types/DbTypeTemporal.js

@@ -0,0 +1,13 @@
+const DbType = require ('./DbType.js')
+
+class DbTypeTemporal extends DbType {
+
+	constructor (o) {
+	
+		super (o)
+	
+	}
+
+}
+
+module.exports = DbTypeTemporal

package/lib/model/types/DbTypeTimestamp.js

@@ -0,0 +1,13 @@
+const DbTypeTemporal = require ('./DbTypeTemporal.js')
+
+class DbTypeTimestamp extends DbTypeTemporal {
+
+	constructor (o) {
+	
+		super (o)
+	
+	}
+
+}
+
+module.exports = DbTypeTimestamp

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "doix-db",
-  "version": "1.0.23",
+  "version": "1.0.26",
   "description": "Shared database related code for doix",
   "main": "index.js",
   "files": [