foxhound 2.0.23 → 2.0.25

package/README.md

@@ -89,6 +89,8 @@ When a schema is attached, FoxHound automatically manages special columns:
 | `UpdateDate` / `UpdateIDUser` | Auto-populated on insert and update |
 | `DeleteDate` / `DeleteIDUser` | Auto-populated on soft delete |
 | `Deleted` | Soft-delete flag — auto-filtered in reads |
+| `JSON` | Structured JSON data — serialized to `TEXT` on write, parsed on read |
+| `JSONProxy` | JSON stored in a different SQL column — uses `StorageColumn` for SQL, virtual name for objects |
 
 ## Filter Operators
 

package/docs/_sidebar.md

@@ -50,5 +50,6 @@
 - Advanced
 
   - [Schema Integration](schema.md)
+  - [JSON Columns](json-columns.md)
   - [Query Overrides](query-overrides.md)
   - [Configuration Reference](configuration.md)

package/docs/filters.md

@@ -166,6 +166,34 @@ The operator codes are:
 | `LE` | `<=` |
 | `LK` | `LIKE` |
 
+## JSON Path Filtering
+
+When a schema is attached and contains `JSON` or `JSONProxy` columns, you can filter on nested JSON properties using dot notation:
+
+```javascript
+// Filter where Metadata.habitat equals 'forest'
+tmpQuery.addFilter('Metadata.habitat', 'forest');
+
+// Filter where Metadata.weight is greater than 100
+tmpQuery.addFilter('Metadata.weight', 100, '>');
+
+// Nested paths work too
+tmpQuery.addFilter('Metadata.dimensions.height', 50, '>=');
+```
+
+FoxHound detects the dot notation, resolves the base column against the schema, and generates the appropriate JSON path expression for the active dialect:
+
+| Dialect | Single-Level | Nested |
+|---------|-------------|--------|
+| MySQL | `JSON_EXTRACT(col, '$.key')` | `JSON_EXTRACT(col, '$.key1.key2')` |
+| PostgreSQL | `col->>'key'` | `col#>>'{key1,key2}'` |
+| SQLite | `json_extract(col, '$.key')` | `json_extract(col, '$.key1.key2')` |
+| MSSQL | `JSON_VALUE(col, '$.key')` | `JSON_VALUE(col, '$.key1.key2')` |
+
+For `JSONProxy` columns, the storage column name is used in the SQL expression automatically. For example, if `Preferences` is a `JSONProxy` with `StorageColumn: 'PreferencesJSON'`, filtering on `Preferences.theme` produces `json_extract(PreferencesJSON, '$.theme')` in SQLite.
+
+All standard comparison operators (`=`, `!=`, `>`, `>=`, `<`, `<=`, `LIKE`) work with JSON path filters.
+
 ## Soft-Delete Auto-Filter
 
 When a schema with a `Deleted` column type is present and delete tracking is not disabled, FoxHound automatically appends a `WHERE Deleted = 0` filter to all Read and Count queries.  If you explicitly add a filter on the `Deleted` column, the automatic filter is suppressed.

package/docs/json-columns.md

@@ -0,0 +1,145 @@
+# JSON Column Support
+
+> Automatic serialization and JSON path filtering for structured data columns
+
+FoxHound provides schema-aware handling of JSON data types. When a schema with `JSON` or `JSONProxy` columns is attached, FoxHound automatically serializes object values on write and generates dialect-specific JSON path expressions for filtering.
+
+## Schema Types
+
+### JSON
+
+The SQL column and JavaScript property share the same name.
+
+```javascript
+{ Column: 'Metadata', Type: 'JSON' }
+```
+
+### JSONProxy
+
+The SQL column differs from the JavaScript property. The `StorageColumn` specifies the actual SQL column.
+
+```javascript
+{ Column: 'Preferences', Type: 'JSONProxy', StorageColumn: 'PreferencesJSON' }
+```
+
+## Write Operations (Create / Update)
+
+On CREATE and UPDATE, FoxHound automatically calls `JSON.stringify` on JSON column values:
+
+```javascript
+tmpQuery.query.schema = [
+	{ Column: 'IDProduct', Type: 'AutoIdentity' },
+	{ Column: 'Name', Type: 'String' },
+	{ Column: 'Metadata', Type: 'JSON' },
+	{ Column: 'Preferences', Type: 'JSONProxy', StorageColumn: 'PreferencesJSON' }
+];
+
+tmpQuery.addRecord({
+	Name: 'Widget',
+	Metadata: { color: 'blue' },
+	Preferences: { theme: 'dark' }
+});
+tmpQuery.setDialect('MySQL').buildCreateQuery();
+```
+
+Generated SQL:
+
+```sql
+INSERT INTO Product (Name, Metadata, PreferencesJSON)
+VALUES (:Name_0, :Metadata_1, :Preferences_2);
+```
+
+Parameters:
+
+```javascript
+{
+	Name_0: 'Widget',
+	Metadata_1: '{"color":"blue"}',          // JSON.stringify'd
+	Preferences_2: '{"theme":"dark"}'         // JSON.stringify'd, stored in PreferencesJSON
+}
+```
+
+Key behaviors:
+- **JSON**: Column name in SQL matches the property name. Value is serialized.
+- **JSONProxy**: `StorageColumn` is used as the SQL column name. Value is serialized from the virtual property.
+- If a value is already a string, it is passed through without double-serialization.
+
+## JSON Path Filtering
+
+FoxHound supports filtering on nested JSON properties using dot notation in column names. When a filter column contains a dot and the base name matches a JSON or JSONProxy schema entry, FoxHound generates a JSON path expression.
+
+### Usage
+
+```javascript
+tmpQuery
+	.addFilter('Metadata.color', 'blue')
+	.addFilter('Metadata.weight', 100, '>')
+	.addFilter('Metadata.dimensions.height', 50, '>=');
+```
+
+### Dialect Output
+
+#### MySQL
+
+```sql
+WHERE JSON_EXTRACT(`Metadata`, '$.color') = :Metadata_color_w0
+  AND JSON_EXTRACT(`Metadata`, '$.weight') > :Metadata_weight_w1
+  AND JSON_EXTRACT(`Metadata`, '$.dimensions.height') >= :Metadata_dimensions_height_w2
+```
+
+#### PostgreSQL
+
+Single-level paths use the `->>` operator; nested paths use `#>>`:
+
+```sql
+WHERE "Metadata"->>'color' = :Metadata_color_w0
+  AND "Metadata"->>'weight' > :Metadata_weight_w1
+  AND "Metadata"#>>'{dimensions,height}' >= :Metadata_dimensions_height_w2
+```
+
+#### SQLite
+
+```sql
+WHERE json_extract(`Metadata`, '$.color') = :Metadata_color_w0
+  AND json_extract(`Metadata`, '$.weight') > :Metadata_weight_w1
+  AND json_extract(`Metadata`, '$.dimensions.height') >= :Metadata_dimensions_height_w2
+```
+
+#### MSSQL
+
+```sql
+WHERE JSON_VALUE([Metadata], '$.color') = @Metadata_color_w0
+  AND JSON_VALUE([Metadata], '$.weight') > @Metadata_weight_w1
+  AND JSON_VALUE([Metadata], '$.dimensions.height') >= @Metadata_dimensions_height_w2
+```
+
+### JSONProxy Resolution
+
+For `JSONProxy` columns, the storage column name is automatically used in the generated SQL. Filtering on `Preferences.theme` when `Preferences` has `StorageColumn: 'PreferencesJSON'`:
+
+```sql
+-- MySQL
+WHERE JSON_EXTRACT(`PreferencesJSON`, '$.theme') = :Preferences_theme_w0
+
+-- PostgreSQL
+WHERE "PreferencesJSON"->>'theme' = :Preferences_theme_w0
+```
+
+### Supported Operators
+
+All standard filter operators work with JSON path expressions: `=`, `!=`, `>`, `>=`, `<`, `<=`, `LIKE`.
+
+### ALASQL Limitation
+
+ALASQL does not support JSON path functions. JSON columns work for basic CRUD (values are serialized/deserialized), but JSON path filtering is not available.
+
+## Database Requirements
+
+JSON path filtering requires these minimum database versions:
+
+| Database | Minimum Version | Function Used |
+|----------|----------------|---------------|
+| MySQL | 5.7 | `JSON_EXTRACT` |
+| PostgreSQL | 9.3 | `->>` / `#>>` |
+| SQLite | 3.38 | `json_extract` |
+| SQL Server | 2016 | `JSON_VALUE` |

package/docs/schema.md

@@ -13,6 +13,8 @@ tmpQuery.query.schema = [
     {Column: 'Title', Type: 'String'},
     {Column: 'Author', Type: 'String'},
     {Column: 'PublishedYear', Type: 'Integer'},
+    {Column: 'Metadata', Type: 'JSON'},
+    {Column: 'Extras', Type: 'JSONProxy', StorageColumn: 'ExtrasJSON'},
     {Column: 'CreateDate', Type: 'CreateDate'},
     {Column: 'CreatingIDUser', Type: 'CreateIDUser'},
     {Column: 'UpdateDate', Type: 'UpdateDate'},
@@ -41,6 +43,57 @@ tmpQuery.query.schema = [
 | `Decimal` | Decimal data | parameterized | included | parameterized | — | — |
 | `Boolean` | Boolean data | parameterized | included | parameterized | — | — |
 | `DateTime` | Date/time data | parameterized | included | parameterized | — | — |
+| `JSON` | Structured JSON data | `JSON.stringify` | included | `JSON.stringify` | — | — |
+| `JSONProxy` | JSON with different SQL column name | `JSON.stringify` to `StorageColumn` | included | `JSON.stringify` to `StorageColumn` | — | — |
+
+## JSON and JSON Proxy Types
+
+FoxHound supports two schema types for structured JSON data stored as `TEXT` in SQL databases.
+
+### JSON
+
+The `JSON` type marks a column whose value should be serialized with `JSON.stringify` on write and deserialized with `JSON.parse` on read. The SQL column name matches the object property name.
+
+```javascript
+{ Column: 'Metadata', Type: 'JSON' }
+```
+
+On CREATE and UPDATE, FoxHound automatically calls `JSON.stringify` on the value. If the value is already a string, it is passed through as-is.
+
+### JSON Proxy
+
+The `JSONProxy` type stores JSON in a SQL column with a different name than the JavaScript property. The `StorageColumn` property specifies the actual SQL column name.
+
+```javascript
+{ Column: 'Preferences', Type: 'JSONProxy', StorageColumn: 'PreferencesJSON' }
+```
+
+On CREATE and UPDATE, FoxHound:
+- Uses `StorageColumn` (`PreferencesJSON`) as the column name in the SQL statement
+- Calls `JSON.stringify` on the value from the `Column` property (`Preferences`)
+
+On READ, the Meadow provider layer handles deserialization: the raw `PreferencesJSON` text column is parsed and mapped to the `Preferences` property, and the storage column is hidden from the result object.
+
+### JSON Path Filtering
+
+You can filter on nested JSON properties using dot notation in `addFilter`:
+
+```javascript
+tmpQuery
+    .addFilter('Metadata.habitat', 'forest')
+    .addFilter('Metadata.weight', 100, '>');
+```
+
+FoxHound generates dialect-specific JSON path expressions:
+
+| Dialect | Generated SQL |
+|---------|---------------|
+| MySQL | `JSON_EXTRACT(Metadata, '$.habitat') = :Metadata_habitat_w0` |
+| PostgreSQL | `Metadata->>'habitat' = :Metadata_habitat_w0` |
+| SQLite | `json_extract(Metadata, '$.habitat') = :Metadata_habitat_w0` |
+| MSSQL | `JSON_VALUE(Metadata, '$.habitat') = :Metadata_habitat_w0` |
+
+Nested paths are supported (e.g., `Metadata.dimensions.width`). JSON Proxy columns are automatically resolved to their storage column in the SQL expression.
 
 ## How Schema Affects Each Operation
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "foxhound",
-    "version": "2.0.23",
+    "version": "2.0.25",
     "description": "A Database Query generation library.",
     "main": "source/FoxHound.js",
     "scripts": {
@@ -48,7 +48,7 @@
     },
     "homepage": "https://github.com/stevenvelozo/foxhound",
     "devDependencies": {
-        "quackage": "^1.0.60"
+        "quackage": "^1.0.63"
     },
     "dependencies": {
         "fable": "^3.1.63",

package/source/dialects/ALASQL/FoxHound-Dialect-ALASQL.js

@@ -112,6 +112,27 @@ var FoxHoundDialectALASQL = function(pFable)
 		return tmpFieldList;
 	};
 
+	var resolveJsonColumnPath = function(pColumnName, pSchema)
+	{
+		if (!Array.isArray(pSchema) || pSchema.length < 1) return null;
+		var tmpParts = pColumnName.replace(/`/g, '').replace(/"/g, '').split('.');
+		for (var tmpStartIdx = 0; tmpStartIdx < Math.min(tmpParts.length - 1, 2); tmpStartIdx++)
+		{
+			var tmpBaseColumn = tmpParts[tmpStartIdx];
+			for (var s = 0; s < pSchema.length; s++)
+			{
+				if (pSchema[s].Column === tmpBaseColumn &&
+					(pSchema[s].Type === 'JSON' || pSchema[s].Type === 'JSONProxy'))
+				{
+					var tmpActualColumn = (pSchema[s].Type === 'JSONProxy') ? pSchema[s].StorageColumn : tmpBaseColumn;
+					var tmpJsonPath = '$.' + tmpParts.slice(tmpStartIdx + 1).join('.');
+					return { column: tmpActualColumn, path: tmpJsonPath };
+				}
+			}
+		}
+		return null;
+	};
+
 	/**
 	* Generate a query from the array of where clauses
 	*
@@ -372,6 +393,20 @@ var FoxHoundDialectALASQL = function(pFable)
 					// Set the query parameter
 					pParameters.query.parameters[tmpColumnParameter] = pParameters.query.IDUser;
 					break;
+				case 'JSON':
+					var tmpJSONUpdateParam = tmpColumn+'_'+tmpCurrentColumn;
+					tmpUpdate += ' '+tmpColumn+' = :'+tmpJSONUpdateParam;
+					pParameters.query.parameters[tmpJSONUpdateParam] = (typeof tmpRecords[0][tmpColumn] === 'string')
+						? tmpRecords[0][tmpColumn]
+						: JSON.stringify(tmpRecords[0][tmpColumn] || {});
+					break;
+				case 'JSONProxy':
+					var tmpProxyUpdateParam = tmpSchemaEntry.StorageColumn+'_'+tmpCurrentColumn;
+					tmpUpdate += ' '+tmpSchemaEntry.StorageColumn+' = :'+tmpProxyUpdateParam;
+					pParameters.query.parameters[tmpProxyUpdateParam] = (typeof tmpRecords[0][tmpColumn] === 'string')
+						? tmpRecords[0][tmpColumn]
+						: JSON.stringify(tmpRecords[0][tmpColumn] || {});
+					break;
 				default:
 					var tmpColumnDefaultParameter = tmpColumn+'_'+tmpCurrentColumn;
 					tmpUpdate += ' '+escapeColumn(tmpColumn, pParameters)+' = :'+tmpColumnDefaultParameter;
@@ -667,6 +702,20 @@ var FoxHoundDialectALASQL = function(pFable)
 						pParameters.query.parameters[tmpColumnParameter] = pParameters.query.IDUser;
 					}
 					break;
+				case 'JSON':
+					var tmpJSONCreateParam = tmpColumn+'_'+tmpCurrentColumn;
+					tmpCreateSet += ' :'+tmpJSONCreateParam;
+					pParameters.query.parameters[tmpJSONCreateParam] = (typeof tmpRecords[0][tmpColumn] === 'string')
+						? tmpRecords[0][tmpColumn]
+						: JSON.stringify(tmpRecords[0][tmpColumn] || {});
+					break;
+				case 'JSONProxy':
+					var tmpProxyCreateParam = tmpColumn+'_'+tmpCurrentColumn;
+					tmpCreateSet += ' :'+tmpProxyCreateParam;
+					pParameters.query.parameters[tmpProxyCreateParam] = (typeof tmpRecords[0][tmpColumn] === 'string')
+						? tmpRecords[0][tmpColumn]
+						: JSON.stringify(tmpRecords[0][tmpColumn] || {});
+					break;
 				default:
 					buildDefaultDefinition();
 					break;
@@ -727,6 +776,20 @@ var FoxHoundDialectALASQL = function(pFable)
 			}
 			switch (tmpSchemaEntry.Type)
 			{
+				case 'JSON':
+					if (tmpCreateSet != '')
+					{
+						tmpCreateSet += ',';
+					}
+					tmpCreateSet += ' '+tmpColumn;
+					break;
+				case 'JSONProxy':
+					if (tmpCreateSet != '')
+					{
+						tmpCreateSet += ',';
+					}
+					tmpCreateSet += ' '+tmpSchemaEntry.StorageColumn;
+					break;
 				default:
 					if (tmpCreateSet != '')
 					{

package/source/dialects/MicrosoftSQL/FoxHound-Dialect-MSSQL.js

@@ -195,6 +195,27 @@ var FoxHoundDialectMSSQL = function(pFable)
 		}
 	}
 
+	var resolveJsonColumnPath = function(pColumnName, pSchema)
+	{
+		if (!Array.isArray(pSchema) || pSchema.length < 1) return null;
+		var tmpParts = pColumnName.replace(/`/g, '').replace(/"/g, '').split('.');
+		for (var tmpStartIdx = 0; tmpStartIdx < Math.min(tmpParts.length - 1, 2); tmpStartIdx++)
+		{
+			var tmpBaseColumn = tmpParts[tmpStartIdx];
+			for (var s = 0; s < pSchema.length; s++)
+			{
+				if (pSchema[s].Column === tmpBaseColumn &&
+					(pSchema[s].Type === 'JSON' || pSchema[s].Type === 'JSONProxy'))
+				{
+					var tmpActualColumn = (pSchema[s].Type === 'JSONProxy') ? pSchema[s].StorageColumn : tmpBaseColumn;
+					var tmpJsonPath = '$.' + tmpParts.slice(tmpStartIdx + 1).join('.');
+					return { column: tmpActualColumn, path: tmpJsonPath };
+				}
+			}
+		}
+		return null;
+	};
+
 	/**
 	* Generate a query from the array of where clauses
 	*
@@ -313,8 +334,16 @@ var FoxHoundDialectMSSQL = function(pFable)
 			else
 			{
 				tmpColumnParameter = tmpFilter[i].Parameter+'_w'+i;
-				// Add the column name, operator and parameter name to the list of where value parenthetical
-				tmpWhere += ' ['+tmpFilter[i].Column+'] '+tmpFilter[i].Operator+' @'+tmpColumnParameter;
+				var tmpSchema = Array.isArray(pParameters.query.schema) ? pParameters.query.schema : [];
+				var tmpJsonRef = resolveJsonColumnPath(tmpFilter[i].Column, tmpSchema);
+				if (tmpJsonRef)
+				{
+					tmpWhere += ' JSON_VALUE(['+tmpJsonRef.column+"], '"+tmpJsonRef.path+"') "+tmpFilter[i].Operator+' :'+tmpColumnParameter;
+				}
+				else
+				{
+					tmpWhere += ' ['+tmpFilter[i].Column+'] '+tmpFilter[i].Operator+' @'+tmpColumnParameter;
+				}
 				pParameters.query.parameters[tmpColumnParameter] = tmpFilter[i].Value;
 				generateMSSQLParameterTypeEntry(pParameters, tmpColumnParameter, tmpFilter[i].Parameter)
 			}
@@ -523,6 +552,22 @@ var FoxHoundDialectMSSQL = function(pFable)
 					pParameters.query.parameters[tmpColumnParameter] = pParameters.query.IDUser;
 					generateMSSQLParameterTypeEntry(pParameters, tmpColumnParameter, tmpColumn)
 					break;
+				case 'JSON':
+					var tmpJSONUpdateParam = tmpColumn+'_'+tmpCurrentColumn;
+					tmpUpdate += ' ['+tmpColumn+'] = @'+tmpJSONUpdateParam;
+					pParameters.query.parameters[tmpJSONUpdateParam] = (typeof tmpRecords[0][tmpColumn] === 'string')
+						? tmpRecords[0][tmpColumn]
+						: JSON.stringify(tmpRecords[0][tmpColumn] || {});
+					generateMSSQLParameterTypeEntry(pParameters, tmpJSONUpdateParam, {Type:'String'});
+					break;
+				case 'JSONProxy':
+					var tmpProxyUpdateParam = tmpSchemaEntry.StorageColumn+'_'+tmpCurrentColumn;
+					tmpUpdate += ' ['+tmpSchemaEntry.StorageColumn+'] = @'+tmpProxyUpdateParam;
+					pParameters.query.parameters[tmpProxyUpdateParam] = (typeof tmpRecords[0][tmpColumn] === 'string')
+						? tmpRecords[0][tmpColumn]
+						: JSON.stringify(tmpRecords[0][tmpColumn] || {});
+					generateMSSQLParameterTypeEntry(pParameters, tmpProxyUpdateParam, {Type:'String'});
+					break;
 				default:
 					var tmpColumnDefaultParameter = tmpColumn+'_'+tmpCurrentColumn;
 					tmpUpdate += ' ['+tmpColumn+'] = @'+tmpColumnDefaultParameter;
@@ -822,6 +867,22 @@ var FoxHoundDialectMSSQL = function(pFable)
 						generateMSSQLParameterTypeEntry(pParameters, tmpColumnParameter, tmpSchemaEntry)
 					}
 					break;
+				case 'JSON':
+					var tmpJSONCreateParam = tmpColumn+'_'+tmpCurrentColumn;
+					tmpCreateSet += ' @'+tmpJSONCreateParam;
+					pParameters.query.parameters[tmpJSONCreateParam] = (typeof tmpRecords[0][tmpColumn] === 'string')
+						? tmpRecords[0][tmpColumn]
+						: JSON.stringify(tmpRecords[0][tmpColumn] || {});
+					generateMSSQLParameterTypeEntry(pParameters, tmpJSONCreateParam, {Type:'String'});
+					break;
+				case 'JSONProxy':
+					var tmpProxyCreateParam = tmpColumn+'_'+tmpCurrentColumn;
+					tmpCreateSet += ' @'+tmpProxyCreateParam;
+					pParameters.query.parameters[tmpProxyCreateParam] = (typeof tmpRecords[0][tmpColumn] === 'string')
+						? tmpRecords[0][tmpColumn]
+						: JSON.stringify(tmpRecords[0][tmpColumn] || {});
+					generateMSSQLParameterTypeEntry(pParameters, tmpProxyCreateParam, {Type:'String'});
+					break;
 				default:
 					buildDefaultDefinition();
 					break;
@@ -893,6 +954,20 @@ var FoxHoundDialectMSSQL = function(pFable)
 						tmpCreateSet += ' ['+tmpColumn+']';
 					}
 					continue;
+				case 'JSON':
+					if (tmpCreateSet != '')
+					{
+						tmpCreateSet += ',';
+					}
+					tmpCreateSet += ' ['+tmpColumn+']';
+					break;
+				case 'JSONProxy':
+					if (tmpCreateSet != '')
+					{
+						tmpCreateSet += ',';
+					}
+					tmpCreateSet += ' ['+tmpSchemaEntry.StorageColumn+']';
+					break;
 				default:
 					if (tmpCreateSet != '')
 					{

package/source/dialects/MySQL/FoxHound-Dialect-MySQL.js

@@ -131,6 +131,30 @@ var FoxHoundDialectMySQL = function(pFable)
 		return "`" + cleanseQuoting(pFieldNames[0]) + "`";
 	}
 
+	var resolveJsonColumnPath = function(pColumnName, pSchema)
+	{
+		if (!Array.isArray(pSchema) || pSchema.length < 1) return null;
+
+		// Check for dot notation indicating JSON path: e.g. "Metadata.key" or "FableTest.Metadata.key"
+		var tmpParts = pColumnName.replace(/`/g, '').split('.');
+
+		for (var tmpStartIdx = 0; tmpStartIdx < Math.min(tmpParts.length - 1, 2); tmpStartIdx++)
+		{
+			var tmpBaseColumn = tmpParts[tmpStartIdx];
+			for (var s = 0; s < pSchema.length; s++)
+			{
+				if (pSchema[s].Column === tmpBaseColumn &&
+					(pSchema[s].Type === 'JSON' || pSchema[s].Type === 'JSONProxy'))
+				{
+					var tmpActualColumn = (pSchema[s].Type === 'JSONProxy') ? pSchema[s].StorageColumn : tmpBaseColumn;
+					var tmpJsonPath = '$.' + tmpParts.slice(tmpStartIdx + 1).join('.');
+					return { column: tmpActualColumn, path: tmpJsonPath };
+				}
+			}
+		}
+		return null;
+	};
+
 	/**
 	* Generate a query from the array of where clauses
 	*
@@ -247,8 +271,18 @@ var FoxHoundDialectMySQL = function(pFable)
 			else
 			{
 				tmpColumnParameter = tmpFilter[i].Parameter+'_w'+i;
-				// Add the column name, operator and parameter name to the list of where value parenthetical
-				tmpWhere += ' '+tmpFilter[i].Column+' '+tmpFilter[i].Operator+' :'+tmpColumnParameter;
+				// Check for JSON path references (e.g. Metadata.habitat)
+				var tmpSchema = Array.isArray(pParameters.query.schema) ? pParameters.query.schema : [];
+				var tmpJsonRef = resolveJsonColumnPath(tmpFilter[i].Column, tmpSchema);
+				if (tmpJsonRef)
+				{
+					tmpWhere += ' JSON_EXTRACT(`'+tmpJsonRef.column+"`, '"+tmpJsonRef.path+"') "+tmpFilter[i].Operator+' :'+tmpColumnParameter;
+				}
+				else
+				{
+					// Add the column name, operator and parameter name to the list of where value parenthetical
+					tmpWhere += ' '+tmpFilter[i].Column+' '+tmpFilter[i].Operator+' :'+tmpColumnParameter;
+				}
 				pParameters.query.parameters[tmpColumnParameter] = tmpFilter[i].Value;
 			}
 		}
@@ -441,6 +475,20 @@ var FoxHoundDialectMySQL = function(pFable)
 					// Set the query parameter
 					pParameters.query.parameters[tmpColumnParameter] = pParameters.query.IDUser;
 					break;
+				case 'JSON':
+					var tmpJSONUpdateParam = tmpColumn+'_'+tmpCurrentColumn;
+					tmpUpdate += ' '+tmpColumn+' = :'+tmpJSONUpdateParam;
+					pParameters.query.parameters[tmpJSONUpdateParam] = (typeof tmpRecords[0][tmpColumn] === 'string')
+						? tmpRecords[0][tmpColumn]
+						: JSON.stringify(tmpRecords[0][tmpColumn] || {});
+					break;
+				case 'JSONProxy':
+					var tmpProxyUpdateParam = tmpSchemaEntry.StorageColumn+'_'+tmpCurrentColumn;
+					tmpUpdate += ' '+tmpSchemaEntry.StorageColumn+' = :'+tmpProxyUpdateParam;
+					pParameters.query.parameters[tmpProxyUpdateParam] = (typeof tmpRecords[0][tmpColumn] === 'string')
+						? tmpRecords[0][tmpColumn]
+						: JSON.stringify(tmpRecords[0][tmpColumn] || {});
+					break;
 				default:
 					var tmpColumnDefaultParameter = tmpColumn+'_'+tmpCurrentColumn;
 					tmpUpdate += ' '+tmpColumn+' = :'+tmpColumnDefaultParameter;
@@ -733,6 +781,20 @@ var FoxHoundDialectMySQL = function(pFable)
 						pParameters.query.parameters[tmpColumnParameter] = pParameters.query.IDUser;
 					}
 					break;
+				case 'JSON':
+					var tmpJSONCreateParam = tmpColumn+'_'+tmpCurrentColumn;
+					tmpCreateSet += ' :'+tmpJSONCreateParam;
+					pParameters.query.parameters[tmpJSONCreateParam] = (typeof tmpRecords[0][tmpColumn] === 'string')
+						? tmpRecords[0][tmpColumn]
+						: JSON.stringify(tmpRecords[0][tmpColumn] || {});
+					break;
+				case 'JSONProxy':
+					var tmpProxyCreateParam = tmpColumn+'_'+tmpCurrentColumn;
+					tmpCreateSet += ' :'+tmpProxyCreateParam;
+					pParameters.query.parameters[tmpProxyCreateParam] = (typeof tmpRecords[0][tmpColumn] === 'string')
+						? tmpRecords[0][tmpColumn]
+						: JSON.stringify(tmpRecords[0][tmpColumn] || {});
+					break;
 				default:
 					buildDefaultDefinition();
 					break;
@@ -793,6 +855,20 @@ var FoxHoundDialectMySQL = function(pFable)
 			}
 			switch (tmpSchemaEntry.Type)
 			{
+				case 'JSON':
+					if (tmpCreateSet != '')
+					{
+						tmpCreateSet += ',';
+					}
+					tmpCreateSet += ' '+tmpColumn;
+					break;
+				case 'JSONProxy':
+					if (tmpCreateSet != '')
+					{
+						tmpCreateSet += ',';
+					}
+					tmpCreateSet += ' '+tmpSchemaEntry.StorageColumn;
+					break;
 				default:
 					if (tmpCreateSet != '')
 					{

package/source/dialects/PostgreSQL/FoxHound-Dialect-PostgreSQL.js

@@ -128,6 +128,27 @@ var FoxHoundDialectPostgreSQL = function(pFable)
 		return '"' + cleanseQuoting(pFieldNames[0]) + '"';
 	}
 
+	var resolveJsonColumnPath = function(pColumnName, pSchema)
+	{
+		if (!Array.isArray(pSchema) || pSchema.length < 1) return null;
+		var tmpParts = pColumnName.replace(/`/g, '').replace(/"/g, '').split('.');
+		for (var tmpStartIdx = 0; tmpStartIdx < Math.min(tmpParts.length - 1, 2); tmpStartIdx++)
+		{
+			var tmpBaseColumn = tmpParts[tmpStartIdx];
+			for (var s = 0; s < pSchema.length; s++)
+			{
+				if (pSchema[s].Column === tmpBaseColumn &&
+					(pSchema[s].Type === 'JSON' || pSchema[s].Type === 'JSONProxy'))
+				{
+					var tmpActualColumn = (pSchema[s].Type === 'JSONProxy') ? pSchema[s].StorageColumn : tmpBaseColumn;
+					var tmpJsonPath = '$.' + tmpParts.slice(tmpStartIdx + 1).join('.');
+					return { column: tmpActualColumn, path: tmpJsonPath };
+				}
+			}
+		}
+		return null;
+	};
+
 	/**
 	* Generate a query from the array of where clauses
 	*
@@ -234,7 +255,24 @@ var FoxHoundDialectPostgreSQL = function(pFable)
 			else
 			{
 				tmpColumnParameter = tmpFilter[i].Parameter+'_w'+i;
-				tmpWhere += ' '+generateSafeFieldName(tmpFilter[i].Column)+' '+tmpFilter[i].Operator+' :'+tmpColumnParameter;
+				var tmpSchema = Array.isArray(pParameters.query.schema) ? pParameters.query.schema : [];
+				var tmpJsonRef = resolveJsonColumnPath(tmpFilter[i].Column, tmpSchema);
+				if (tmpJsonRef)
+				{
+					var tmpPathParts = tmpJsonRef.path.replace('$.', '').split('.');
+					if (tmpPathParts.length === 1)
+					{
+						tmpWhere += ' "'+tmpJsonRef.column+'"'+"->>'"+tmpPathParts[0]+"' "+tmpFilter[i].Operator+' :'+tmpColumnParameter;
+					}
+					else
+					{
+						tmpWhere += ' "'+tmpJsonRef.column+'"'+"#>>'{"+tmpPathParts.join(',')+"}' "+tmpFilter[i].Operator+' :'+tmpColumnParameter;
+					}
+				}
+				else
+				{
+					tmpWhere += ' '+generateSafeFieldName(tmpFilter[i].Column)+' '+tmpFilter[i].Operator+' :'+tmpColumnParameter;
+				}
 				pParameters.query.parameters[tmpColumnParameter] = tmpFilter[i].Value;
 			}
 		}
@@ -394,6 +432,20 @@ var FoxHoundDialectPostgreSQL = function(pFable)
 					tmpUpdate += ' '+generateSafeFieldName(tmpColumn)+' = :'+tmpColumnParameter;
 					pParameters.query.parameters[tmpColumnParameter] = pParameters.query.IDUser;
 					break;
+				case 'JSON':
+					var tmpJSONUpdateParam = tmpColumn+'_'+tmpCurrentColumn;
+					tmpUpdate += ' '+generateSafeFieldName(tmpColumn)+' = :'+tmpJSONUpdateParam;
+					pParameters.query.parameters[tmpJSONUpdateParam] = (typeof tmpRecords[0][tmpColumn] === 'string')
+						? tmpRecords[0][tmpColumn]
+						: JSON.stringify(tmpRecords[0][tmpColumn] || {});
+					break;
+				case 'JSONProxy':
+					var tmpProxyUpdateParam = tmpSchemaEntry.StorageColumn+'_'+tmpCurrentColumn;
+					tmpUpdate += ' '+generateSafeFieldName(tmpSchemaEntry.StorageColumn)+' = :'+tmpProxyUpdateParam;
+					pParameters.query.parameters[tmpProxyUpdateParam] = (typeof tmpRecords[0][tmpColumn] === 'string')
+						? tmpRecords[0][tmpColumn]
+						: JSON.stringify(tmpRecords[0][tmpColumn] || {});
+					break;
 				default:
 					var tmpColumnDefaultParameter = tmpColumn+'_'+tmpCurrentColumn;
 					tmpUpdate += ' '+generateSafeFieldName(tmpColumn)+' = :'+tmpColumnDefaultParameter;
@@ -646,6 +698,20 @@ var FoxHoundDialectPostgreSQL = function(pFable)
 						pParameters.query.parameters[tmpColumnParameter] = pParameters.query.IDUser;
 					}
 					break;
+				case 'JSON':
+					var tmpJSONCreateParam = tmpColumn+'_'+tmpCurrentColumn;
+					tmpCreateSet += ' :'+tmpJSONCreateParam;
+					pParameters.query.parameters[tmpJSONCreateParam] = (typeof tmpRecords[0][tmpColumn] === 'string')
+						? tmpRecords[0][tmpColumn]
+						: JSON.stringify(tmpRecords[0][tmpColumn] || {});
+					break;
+				case 'JSONProxy':
+					var tmpProxyCreateParam = tmpColumn+'_'+tmpCurrentColumn;
+					tmpCreateSet += ' :'+tmpProxyCreateParam;
+					pParameters.query.parameters[tmpProxyCreateParam] = (typeof tmpRecords[0][tmpColumn] === 'string')
+						? tmpRecords[0][tmpColumn]
+						: JSON.stringify(tmpRecords[0][tmpColumn] || {});
+					break;
 				default:
 					buildDefaultDefinition();
 					break;
@@ -697,6 +763,20 @@ var FoxHoundDialectPostgreSQL = function(pFable)
 			}
 			switch (tmpSchemaEntry.Type)
 			{
+				case 'JSON':
+					if (tmpCreateSet != '')
+					{
+						tmpCreateSet += ',';
+					}
+					tmpCreateSet += ' '+generateSafeFieldName(tmpColumn);
+					break;
+				case 'JSONProxy':
+					if (tmpCreateSet != '')
+					{
+						tmpCreateSet += ',';
+					}
+					tmpCreateSet += ' '+generateSafeFieldName(tmpSchemaEntry.StorageColumn);
+					break;
 				default:
 					if (tmpCreateSet != '')
 					{

package/source/dialects/SQLite/FoxHound-Dialect-SQLite.js

@@ -115,6 +115,27 @@ var FoxHoundDialectSQLite = function(pFable)
 		return tmpFieldList;
 	};
 
+	var resolveJsonColumnPath = function(pColumnName, pSchema)
+	{
+		if (!Array.isArray(pSchema) || pSchema.length < 1) return null;
+		var tmpParts = pColumnName.replace(/`/g, '').replace(/"/g, '').split('.');
+		for (var tmpStartIdx = 0; tmpStartIdx < Math.min(tmpParts.length - 1, 2); tmpStartIdx++)
+		{
+			var tmpBaseColumn = tmpParts[tmpStartIdx];
+			for (var s = 0; s < pSchema.length; s++)
+			{
+				if (pSchema[s].Column === tmpBaseColumn &&
+					(pSchema[s].Type === 'JSON' || pSchema[s].Type === 'JSONProxy'))
+				{
+					var tmpActualColumn = (pSchema[s].Type === 'JSONProxy') ? pSchema[s].StorageColumn : tmpBaseColumn;
+					var tmpJsonPath = '$.' + tmpParts.slice(tmpStartIdx + 1).join('.');
+					return { column: tmpActualColumn, path: tmpJsonPath };
+				}
+			}
+		}
+		return null;
+	};
+
 	/**
 	* Generate a query from the array of where clauses
 	*
@@ -243,8 +264,16 @@ var FoxHoundDialectSQLite = function(pFable)
 			else
 			{
 				tmpColumnParameter = tmpFilter[i].Parameter+'_w'+i;
-				// Add the column name, operator and parameter name to the list of where value parenthetical
-				tmpWhere += ' '+escapeColumn(tmpFilter[i].Column, pParameters)+' '+tmpFilter[i].Operator+' :'+tmpColumnParameter;
+				var tmpSchema = Array.isArray(pParameters.query.schema) ? pParameters.query.schema : [];
+				var tmpJsonRef = resolveJsonColumnPath(tmpFilter[i].Column, tmpSchema);
+				if (tmpJsonRef)
+				{
+					tmpWhere += ' json_extract(`'+tmpJsonRef.column+"`, '"+tmpJsonRef.path+"') "+tmpFilter[i].Operator+' :'+tmpColumnParameter;
+				}
+				else
+				{
+					tmpWhere += ' '+escapeColumn(tmpFilter[i].Column, pParameters)+' '+tmpFilter[i].Operator+' :'+tmpColumnParameter;
+				}
 				pParameters.query.parameters[tmpColumnParameter] = tmpFilter[i].Value;
 			}
 		}
@@ -392,6 +421,20 @@ var FoxHoundDialectSQLite = function(pFable)
 					// Set the query parameter
 					pParameters.query.parameters[tmpColumnParameter] = pParameters.query.IDUser;
 					break;
+				case 'JSON':
+					var tmpJSONUpdateParam = tmpColumn+'_'+tmpCurrentColumn;
+					tmpUpdate += ' '+tmpColumn+' = :'+tmpJSONUpdateParam;
+					pParameters.query.parameters[tmpJSONUpdateParam] = (typeof tmpRecords[0][tmpColumn] === 'string')
+						? tmpRecords[0][tmpColumn]
+						: JSON.stringify(tmpRecords[0][tmpColumn] || {});
+					break;
+				case 'JSONProxy':
+					var tmpProxyUpdateParam = tmpSchemaEntry.StorageColumn+'_'+tmpCurrentColumn;
+					tmpUpdate += ' '+tmpSchemaEntry.StorageColumn+' = :'+tmpProxyUpdateParam;
+					pParameters.query.parameters[tmpProxyUpdateParam] = (typeof tmpRecords[0][tmpColumn] === 'string')
+						? tmpRecords[0][tmpColumn]
+						: JSON.stringify(tmpRecords[0][tmpColumn] || {});
+					break;
 				default:
 					var tmpColumnDefaultParameter = tmpColumn+'_'+tmpCurrentColumn;
 					tmpUpdate += ' '+escapeColumn(tmpColumn, pParameters)+' = :'+tmpColumnDefaultParameter;
@@ -687,6 +730,20 @@ var FoxHoundDialectSQLite = function(pFable)
 						pParameters.query.parameters[tmpColumnParameter] = pParameters.query.IDUser;
 					}
 					break;
+				case 'JSON':
+					var tmpJSONCreateParam = tmpColumn+'_'+tmpCurrentColumn;
+					tmpCreateSet += ' :'+tmpJSONCreateParam;
+					pParameters.query.parameters[tmpJSONCreateParam] = (typeof tmpRecords[0][tmpColumn] === 'string')
+						? tmpRecords[0][tmpColumn]
+						: JSON.stringify(tmpRecords[0][tmpColumn] || {});
+					break;
+				case 'JSONProxy':
+					var tmpProxyCreateParam = tmpColumn+'_'+tmpCurrentColumn;
+					tmpCreateSet += ' :'+tmpProxyCreateParam;
+					pParameters.query.parameters[tmpProxyCreateParam] = (typeof tmpRecords[0][tmpColumn] === 'string')
+						? tmpRecords[0][tmpColumn]
+						: JSON.stringify(tmpRecords[0][tmpColumn] || {});
+					break;
 				default:
 					buildDefaultDefinition();
 					break;
@@ -747,6 +804,20 @@ var FoxHoundDialectSQLite = function(pFable)
 			}
 			switch (tmpSchemaEntry.Type)
 			{
+				case 'JSON':
+					if (tmpCreateSet != '')
+					{
+						tmpCreateSet += ',';
+					}
+					tmpCreateSet += ' '+tmpColumn;
+					break;
+				case 'JSONProxy':
+					if (tmpCreateSet != '')
+					{
+						tmpCreateSet += ',';
+					}
+					tmpCreateSet += ' '+tmpSchemaEntry.StorageColumn;
+					break;
 				default:
 					if (tmpCreateSet != '')
 					{