meadow 2.0.23 → 2.0.26

package/scripts/mongodb-test-db.sh

@@ -0,0 +1,98 @@
+#!/bin/bash
+# MongoDB Test Database Management Script
+#
+# Usage:
+#   ./scripts/mongodb-test-db.sh start   - Start MongoDB container and wait for readiness
+#   ./scripts/mongodb-test-db.sh stop    - Stop and remove the container
+#   ./scripts/mongodb-test-db.sh status  - Check if the container is running
+#
+# The container settings match the test configuration in
+# test/Meadow-Provider-MongoDB_tests.js:
+#   Host: 127.0.0.1, Port: 37017, Database: meadow_test
+
+CONTAINER_NAME="meadow-mongodb-test"
+MONGODB_PORT="37017"
+MONGODB_IMAGE="mongo:7"
+
+start_mongodb() {
+	# Check if container already exists
+	if docker ps -a --format '{{.Names}}' | grep -q "^${CONTAINER_NAME}$"; then
+		if docker ps --format '{{.Names}}' | grep -q "^${CONTAINER_NAME}$"; then
+			echo "MongoDB test container is already running."
+			return 0
+		else
+			echo "Removing stopped container..."
+			docker rm "${CONTAINER_NAME}" > /dev/null 2>&1
+		fi
+	fi
+
+	echo "Starting MongoDB test container..."
+	docker run -d \
+		--name "${CONTAINER_NAME}" \
+		-p "${MONGODB_PORT}:27017" \
+		"${MONGODB_IMAGE}"
+
+	if [ $? -ne 0 ]; then
+		echo "ERROR: Failed to start MongoDB container."
+		exit 1
+	fi
+
+	echo "Waiting for MongoDB to be ready..."
+	RETRIES=30
+	until docker exec "${CONTAINER_NAME}" mongosh --eval "db.adminCommand('ping')" > /dev/null 2>&1; do
+		RETRIES=$((RETRIES - 1))
+		if [ $RETRIES -le 0 ]; then
+			echo "ERROR: MongoDB failed to become ready in time."
+			docker logs "${CONTAINER_NAME}" 2>&1 | tail -20
+			exit 1
+		fi
+		echo "  ...waiting (${RETRIES} retries left)"
+		sleep 2
+	done
+
+	echo ""
+	echo "MongoDB test database is ready!"
+	echo "  Container: ${CONTAINER_NAME}"
+	echo "  Host:      127.0.0.1:${MONGODB_PORT}"
+	echo "  Database:  meadow_test"
+	echo ""
+	echo "Run tests with: npm run test-mongodb"
+}
+
+stop_mongodb() {
+	if docker ps -a --format '{{.Names}}' | grep -q "^${CONTAINER_NAME}$"; then
+		echo "Stopping and removing MongoDB test container..."
+		docker stop "${CONTAINER_NAME}" > /dev/null 2>&1
+		docker rm "${CONTAINER_NAME}" > /dev/null 2>&1
+		echo "MongoDB test container removed."
+	else
+		echo "No MongoDB test container found."
+	fi
+}
+
+status_mongodb() {
+	if docker ps --format '{{.Names}}' | grep -q "^${CONTAINER_NAME}$"; then
+		echo "MongoDB test container is running."
+		docker ps --filter "name=${CONTAINER_NAME}" --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"
+	elif docker ps -a --format '{{.Names}}' | grep -q "^${CONTAINER_NAME}$"; then
+		echo "MongoDB test container exists but is stopped."
+	else
+		echo "MongoDB test container is not running."
+	fi
+}
+
+case "${1}" in
+	start)
+		start_mongodb
+		;;
+	stop)
+		stop_mongodb
+		;;
+	status)
+		status_mongodb
+		;;
+	*)
+		echo "Usage: $0 {start|stop|status}"
+		exit 1
+		;;
+esac

package/scripts/postgresql-test-db.sh

@@ -0,0 +1,124 @@
+#!/bin/bash
+# PostgreSQL Test Database Management Script
+#
+# Usage:
+#   ./scripts/postgresql-test-db.sh start   - Start PostgreSQL container, load schema and seed data
+#   ./scripts/postgresql-test-db.sh stop    - Stop and remove the container
+#   ./scripts/postgresql-test-db.sh status  - Check if the container is running
+#
+# The container settings match the test configuration in
+# test/Meadow-Provider-PostgreSQL_tests.js and meadow-connection-postgresql:
+#   Host: 127.0.0.1, Port: 35432, User: postgres
+#   Password: testpassword, Database: bookstore
+
+CONTAINER_NAME="meadow-postgresql-test"
+POSTGRES_USER="postgres"
+POSTGRES_PASSWORD="testpassword"
+POSTGRES_DATABASE="bookstore"
+POSTGRES_PORT="35432"
+POSTGRES_IMAGE="postgres:16"
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SEED_SQL="${SCRIPT_DIR}/bookstore-seed-postgresql.sql"
+
+start_postgresql() {
+	# Check if container already exists
+	if docker ps -a --format '{{.Names}}' | grep -q "^${CONTAINER_NAME}$"; then
+		if docker ps --format '{{.Names}}' | grep -q "^${CONTAINER_NAME}$"; then
+			echo "PostgreSQL test container is already running."
+			return 0
+		else
+			echo "Removing stopped container..."
+			docker rm "${CONTAINER_NAME}" > /dev/null 2>&1
+		fi
+	fi
+
+	echo "Starting PostgreSQL test container..."
+	docker run -d \
+		--name "${CONTAINER_NAME}" \
+		-e POSTGRES_USER="${POSTGRES_USER}" \
+		-e POSTGRES_PASSWORD="${POSTGRES_PASSWORD}" \
+		-e POSTGRES_DB="${POSTGRES_DATABASE}" \
+		-p "${POSTGRES_PORT}:5432" \
+		"${POSTGRES_IMAGE}"
+
+	if [ $? -ne 0 ]; then
+		echo "ERROR: Failed to start PostgreSQL container."
+		exit 1
+	fi
+
+	echo "Waiting for PostgreSQL to be ready..."
+	RETRIES=30
+	until docker exec "${CONTAINER_NAME}" pg_isready -U "${POSTGRES_USER}" 2>/dev/null; do
+		RETRIES=$((RETRIES - 1))
+		if [ $RETRIES -le 0 ]; then
+			echo "ERROR: PostgreSQL failed to become ready in time."
+			docker logs "${CONTAINER_NAME}" 2>&1 | tail -20
+			exit 1
+		fi
+		echo "  ...waiting (${RETRIES} retries left)"
+		sleep 2
+	done
+
+	# Load bookstore schema and seed data
+	if [ -f "${SEED_SQL}" ]; then
+		echo "Loading bookstore schema and seed data..."
+		docker cp "${SEED_SQL}" "${CONTAINER_NAME}:/tmp/bookstore-seed.sql"
+		docker exec "${CONTAINER_NAME}" psql -U "${POSTGRES_USER}" -d "${POSTGRES_DATABASE}" -f /tmp/bookstore-seed.sql
+		if [ $? -ne 0 ]; then
+			echo "WARNING: Failed to load seed data. Tests requiring pre-populated data may fail."
+		else
+			echo "Bookstore schema and seed data loaded successfully."
+		fi
+	else
+		echo "WARNING: Seed file not found at ${SEED_SQL}. Skipping schema/data loading."
+	fi
+
+	echo ""
+	echo "PostgreSQL test database is ready!"
+	echo "  Container: ${CONTAINER_NAME}"
+	echo "  Host:      127.0.0.1:${POSTGRES_PORT}"
+	echo "  User:      ${POSTGRES_USER}"
+	echo "  Password:  ${POSTGRES_PASSWORD}"
+	echo "  Database:  ${POSTGRES_DATABASE}"
+	echo ""
+	echo "Run tests with: npm test"
+}
+
+stop_postgresql() {
+	if docker ps -a --format '{{.Names}}' | grep -q "^${CONTAINER_NAME}$"; then
+		echo "Stopping and removing PostgreSQL test container..."
+		docker stop "${CONTAINER_NAME}" > /dev/null 2>&1
+		docker rm "${CONTAINER_NAME}" > /dev/null 2>&1
+		echo "PostgreSQL test container removed."
+	else
+		echo "No PostgreSQL test container found."
+	fi
+}
+
+status_postgresql() {
+	if docker ps --format '{{.Names}}' | grep -q "^${CONTAINER_NAME}$"; then
+		echo "PostgreSQL test container is running."
+		docker ps --filter "name=${CONTAINER_NAME}" --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"
+	elif docker ps -a --format '{{.Names}}' | grep -q "^${CONTAINER_NAME}$"; then
+		echo "PostgreSQL test container exists but is stopped."
+	else
+		echo "PostgreSQL test container is not running."
+	fi
+}
+
+case "${1}" in
+	start)
+		start_postgresql
+		;;
+	stop)
+		stop_postgresql
+		;;
+	status)
+		status_postgresql
+		;;
+	*)
+		echo "Usage: $0 {start|stop|status}"
+		exit 1
+		;;
+esac

package/scripts/solr-test-db.sh

@@ -0,0 +1,135 @@
+#!/bin/bash
+# Solr Test Database Management Script
+#
+# Usage:
+#   ./scripts/solr-test-db.sh start   - Start Solr container, create core, and wait for readiness
+#   ./scripts/solr-test-db.sh stop    - Stop and remove the container
+#   ./scripts/solr-test-db.sh status  - Check if the container is running
+#
+# The container settings match the test configuration in
+# test/Meadow-Provider-Solr_tests.js:
+#   Host: 127.0.0.1, Port: 38983, Core: meadow_test
+
+CONTAINER_NAME="meadow-solr-test"
+SOLR_PORT="38983"
+SOLR_CORE="meadow_test"
+SOLR_IMAGE="solr:9"
+
+start_solr() {
+	# Check if container already exists
+	if docker ps -a --format '{{.Names}}' | grep -q "^${CONTAINER_NAME}$"; then
+		if docker ps --format '{{.Names}}' | grep -q "^${CONTAINER_NAME}$"; then
+			echo "Solr test container is already running."
+			return 0
+		else
+			echo "Removing stopped container..."
+			docker rm "${CONTAINER_NAME}" > /dev/null 2>&1
+		fi
+	fi
+
+	echo "Starting Solr test container..."
+	docker run -d \
+		--name "${CONTAINER_NAME}" \
+		-p "${SOLR_PORT}:8983" \
+		"${SOLR_IMAGE}"
+
+	if [ $? -ne 0 ]; then
+		echo "ERROR: Failed to start Solr container."
+		exit 1
+	fi
+
+	echo "Waiting for Solr to be ready..."
+	RETRIES=30
+	until curl -sf "http://localhost:${SOLR_PORT}/solr/admin/info/system" > /dev/null 2>&1; do
+		RETRIES=$((RETRIES - 1))
+		if [ $RETRIES -le 0 ]; then
+			echo "ERROR: Solr failed to become ready in time."
+			docker logs "${CONTAINER_NAME}" 2>&1 | tail -20
+			exit 1
+		fi
+		echo "  ...waiting (${RETRIES} retries left)"
+		sleep 2
+	done
+
+	# Create the test core
+	echo "Creating Solr core '${SOLR_CORE}'..."
+	docker exec "${CONTAINER_NAME}" solr create_core -c "${SOLR_CORE}" > /dev/null 2>&1
+	if [ $? -ne 0 ]; then
+		# Core might already exist, check if it's accessible
+		if curl -sf "http://localhost:${SOLR_PORT}/solr/${SOLR_CORE}/admin/ping" > /dev/null 2>&1; then
+			echo "Solr core '${SOLR_CORE}' already exists."
+		else
+			echo "WARNING: Failed to create Solr core '${SOLR_CORE}'."
+		fi
+	else
+		echo "Solr core '${SOLR_CORE}' created successfully."
+	fi
+
+	# Define schema fields as single-valued types for proper sorting and filtering
+	echo "Configuring Solr schema..."
+	curl -sf -X POST "http://localhost:${SOLR_PORT}/solr/${SOLR_CORE}/schema" \
+		-H 'Content-type: application/json' \
+		-d '{
+			"add-field": [
+				{"name": "IDAnimal", "type": "plong", "stored": true, "indexed": true, "multiValued": false},
+				{"name": "GUIDAnimal", "type": "string", "stored": true, "indexed": true, "multiValued": false},
+				{"name": "CreateDate", "type": "pdate", "stored": true, "indexed": true, "multiValued": false},
+				{"name": "CreatingIDUser", "type": "plong", "stored": true, "indexed": true, "multiValued": false},
+				{"name": "UpdateDate", "type": "pdate", "stored": true, "indexed": true, "multiValued": false},
+				{"name": "UpdatingIDUser", "type": "plong", "stored": true, "indexed": true, "multiValued": false},
+				{"name": "Deleted", "type": "plong", "stored": true, "indexed": true, "multiValued": false},
+				{"name": "DeletingIDUser", "type": "plong", "stored": true, "indexed": true, "multiValued": false},
+				{"name": "DeleteDate", "type": "string", "stored": true, "indexed": true, "multiValued": false},
+				{"name": "Name", "type": "string", "stored": true, "indexed": true, "multiValued": false},
+				{"name": "Type", "type": "string", "stored": true, "indexed": true, "multiValued": false},
+				{"name": "seq", "type": "plong", "stored": true, "indexed": true, "multiValued": false}
+			]
+		}' > /dev/null 2>&1
+	echo "Solr schema configured."
+
+	echo ""
+	echo "Solr test instance is ready!"
+	echo "  Container: ${CONTAINER_NAME}"
+	echo "  Host:      127.0.0.1:${SOLR_PORT}"
+	echo "  Core:      ${SOLR_CORE}"
+	echo ""
+	echo "Run tests with: npm run test-solr"
+}
+
+stop_solr() {
+	if docker ps -a --format '{{.Names}}' | grep -q "^${CONTAINER_NAME}$"; then
+		echo "Stopping and removing Solr test container..."
+		docker stop "${CONTAINER_NAME}" > /dev/null 2>&1
+		docker rm "${CONTAINER_NAME}" > /dev/null 2>&1
+		echo "Solr test container removed."
+	else
+		echo "No Solr test container found."
+	fi
+}
+
+status_solr() {
+	if docker ps --format '{{.Names}}' | grep -q "^${CONTAINER_NAME}$"; then
+		echo "Solr test container is running."
+		docker ps --filter "name=${CONTAINER_NAME}" --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"
+	elif docker ps -a --format '{{.Names}}' | grep -q "^${CONTAINER_NAME}$"; then
+		echo "Solr test container exists but is stopped."
+	else
+		echo "Solr test container is not running."
+	fi
+}
+
+case "${1}" in
+	start)
+		start_solr
+		;;
+	stop)
+		stop_solr
+		;;
+	status)
+		status_solr
+		;;
+	*)
+		echo "Usage: $0 {start|stop|status}"
+		exit 1
+		;;
+esac

package/source/Meadow.js

@@ -137,6 +137,11 @@ var Meadow = function()
 			'MySQL': require(`./providers/Meadow-Provider-MySQL.js`),
 			'MSSQL': require(`./providers/Meadow-Provider-MSSQL.js`),
 			'SQLite': require(`./providers/Meadow-Provider-SQLite.js`),
+			'PostgreSQL': require(`./providers/Meadow-Provider-PostgreSQL.js`),
+			'MongoDB': require(`./providers/Meadow-Provider-MongoDB.js`),
+			'DGraph': require(`./providers/Meadow-Provider-DGraph.js`),
+			'Solr': require(`./providers/Meadow-Provider-Solr.js`),
+			'RocksDB': require(`./providers/Meadow-Provider-RocksDB.js`),
 			'None': require(`./providers/Meadow-Provider-None.js`),
 		});
 		var setProvider = function(pProviderName)