meadow 2.0.23 → 2.0.27

package/docs/soft-deletes.md

@@ -0,0 +1,224 @@
+# Soft Deletes
+
+Meadow supports soft deletes (logical deletion) out of the box. When enabled, deleting a record marks it as deleted rather than removing it from the database. This preserves data for audit trails, recovery, and referential integrity.
+
+## The Deleted Column
+
+Soft deletes are activated by including a column with type `'Deleted'` in your schema:
+
+```javascript
+var tmpSchema =
+[
+	{ Column: 'IDBook', Type: 'AutoIdentity' },
+	{ Column: 'GUIDBook', Type: 'AutoGUID' },
+	{ Column: 'Title', Type: 'String', Size: '255' },
+	{ Column: 'CreateDate', Type: 'CreateDate' },
+	{ Column: 'CreatingIDUser', Type: 'CreateIDUser' },
+	{ Column: 'UpdateDate', Type: 'UpdateDate' },
+	{ Column: 'UpdatingIDUser', Type: 'UpdateIDUser' },
+	{ Column: 'Deleted', Type: 'Deleted' },
+	{ Column: 'DeleteDate', Type: 'DeleteDate' },
+	{ Column: 'DeletingIDUser', Type: 'DeleteIDUser' }
+];
+```
+
+The `Deleted` column should be an integer (typically `TINYINT` in MySQL) with a default value of `0`. A value of `0` means the record is active; `1` means it is deleted.
+
+The corresponding default object should initialize `Deleted` to `0`:
+
+```javascript
+var tmpDefault =
+{
+	IDBook: null,
+	GUIDBook: '',
+	Title: '',
+	CreateDate: false,
+	CreatingIDUser: 0,
+	UpdateDate: false,
+	UpdatingIDUser: 0,
+	Deleted: 0,
+	DeleteDate: false,
+	DeletingIDUser: 0
+};
+```
+
+## How doDelete Generates UPDATE Instead of DELETE
+
+When FoxHound detects a `Deleted` column in the schema, the `buildDeleteQuery` method generates an `UPDATE` statement instead of a `DELETE` statement. For example, calling `doDelete` with a filter on `IDBook = 1` produces SQL equivalent to:
+
+```sql
+UPDATE Book
+SET Deleted = 1, DeleteDate = NOW(), DeletingIDUser = :IDUser
+WHERE IDBook = :IDBook
+```
+
+This means the record remains in the database but is flagged as deleted.
+
+```javascript
+tmpBookDAL.setIDUser(42);
+
+var tmpQuery = tmpBookDAL.query
+	.addFilter('IDBook', 1);
+
+tmpBookDAL.doDelete(tmpQuery,
+	function (pError, pQuery, pResult)
+	{
+		// The record is not removed from the database.
+		// Instead: Deleted = 1, DeleteDate = NOW(), DeletingIDUser = 42
+		console.log('Affected rows:', pResult);
+	});
+```
+
+## Automatic Query Filtering
+
+When a schema contains a `Deleted` column, FoxHound automatically appends `WHERE Deleted = 0` to all read queries. This means soft-deleted records are invisible by default:
+
+```javascript
+// This query automatically excludes deleted records
+tmpBookDAL.doReads(tmpBookDAL.query.setCap(100),
+	function (pError, pQuery, pRecords)
+	{
+		// pRecords contains only records where Deleted = 0
+	});
+```
+
+The same automatic filtering applies to `doRead`, `doReads`, and `doCount` operations. You do not need to add `Deleted = 0` filters manually.
+
+## Viewing Deleted Records
+
+To include soft-deleted records in your results, disable delete tracking on the query with `setDisableDeleteTracking(true)`:
+
+```javascript
+var tmpQuery = tmpBookDAL.query
+	.setDisableDeleteTracking(true)
+	.setCap(100);
+
+tmpBookDAL.doReads(tmpQuery,
+	function (pError, pQuery, pRecords)
+	{
+		// pRecords includes both active and soft-deleted records
+		for (var i = 0; i < pRecords.length; i++)
+		{
+			var tmpStatus = pRecords[i].Deleted ? 'DELETED' : 'ACTIVE';
+			console.log(tmpStatus, '-', pRecords[i].Title);
+		}
+	});
+```
+
+To retrieve only deleted records, combine `setDisableDeleteTracking` with a filter on the `Deleted` column:
+
+```javascript
+var tmpQuery = tmpBookDAL.query
+	.setDisableDeleteTracking(true)
+	.addFilter('Deleted', 1);
+
+tmpBookDAL.doReads(tmpQuery,
+	function (pError, pQuery, pRecords)
+	{
+		// pRecords contains only soft-deleted records
+		console.log('Deleted books:', pRecords.length);
+	});
+```
+
+## Restoring Deleted Records with doUndelete
+
+The `doUndelete` method restores a soft-deleted record by setting `Deleted` back to `0`. FoxHound generates an `UPDATE` statement equivalent to:
+
+```sql
+UPDATE Book
+SET Deleted = 0
+WHERE IDBook = :IDBook
+```
+
+```javascript
+var tmpQuery = tmpBookDAL.query
+	.addFilter('IDBook', 1);
+
+tmpBookDAL.doUndelete(tmpQuery,
+	function (pError, pQuery, pResult)
+	{
+		console.log('Restored record, affected rows:', pResult);
+		// The record is now visible in normal queries again
+	});
+```
+
+After undelete, the record appears in standard queries that have the default `Deleted = 0` filter.
+
+## DeleteDate and DeletingIDUser Columns
+
+For a complete audit trail of deletions, include `DeleteDate` and `DeletingIDUser` columns alongside the `Deleted` column:
+
+| Column Type | Purpose | Value on Delete | Value on Undelete |
+|------------|---------|-----------------|-------------------|
+| `Deleted` | Deletion flag | `1` | `0` |
+| `DeleteDate` | When the record was deleted | `NOW()` | Not changed |
+| `DeleteIDUser` | Who deleted the record | Current user ID | Not changed |
+
+Note that `doUndelete` does not clear `DeleteDate` or `DeletingIDUser`. These columns retain their values from the last delete operation, providing a historical record even after restoration.
+
+```javascript
+// Full schema with delete tracking
+var tmpSchema =
+[
+	{ Column: 'IDBook', Type: 'AutoIdentity' },
+	{ Column: 'GUIDBook', Type: 'AutoGUID' },
+	{ Column: 'Title', Type: 'String', Size: '255' },
+	{ Column: 'Deleted', Type: 'Deleted' },
+	{ Column: 'DeleteDate', Type: 'DeleteDate' },
+	{ Column: 'DeletingIDUser', Type: 'DeleteIDUser' }
+];
+```
+
+## Hard Delete (No Deleted Column)
+
+If your schema does not include a column with type `'Deleted'`, then `doDelete` performs a true SQL `DELETE` statement. The record is permanently removed from the database:
+
+```javascript
+// Schema without a Deleted column
+var tmpSchema =
+[
+	{ Column: 'IDLog', Type: 'AutoIdentity' },
+	{ Column: 'GUIDLog', Type: 'AutoGUID' },
+	{ Column: 'Message', Type: 'String', Size: '1024' },
+	{ Column: 'CreateDate', Type: 'CreateDate' }
+];
+
+var tmpLogDAL = libMeadow.new(_Fable, 'Log')
+	.setProvider('MySQL')
+	.setDefaultIdentifier('IDLog')
+	.setSchema(tmpSchema);
+
+var tmpQuery = tmpLogDAL.query
+	.addFilter('IDLog', 500);
+
+tmpLogDAL.doDelete(tmpQuery,
+	function (pError, pQuery, pResult)
+	{
+		// The record is permanently removed from the database.
+		// This is a true DELETE FROM statement.
+		console.log('Permanently deleted, affected rows:', pResult);
+	});
+```
+
+With hard deletes:
+
+- There is no automatic `Deleted = 0` filter on read queries.
+- `doUndelete` has no meaningful effect (there is nothing to restore).
+- Deleted data cannot be recovered through Meadow.
+
+## Choosing Between Soft and Hard Deletes
+
+Use **soft deletes** when:
+
+- You need audit trails showing who deleted what and when.
+- Users should be able to recover accidentally deleted records.
+- Referential integrity depends on records existing even when "removed".
+- Compliance requirements mandate data retention.
+
+Use **hard deletes** when:
+
+- Storage space is a concern and deleted data has no value.
+- Privacy regulations require actual data removal (e.g., GDPR right to erasure).
+- The table is for transient data (logs, sessions, caches) that has no recovery need.
+
+Most Retold applications use soft deletes for business entities and hard deletes for ephemeral data.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "meadow",
-  "version": "2.0.23",
+  "version": "2.0.27",
   "description": "A data access library.",
   "main": "source/Meadow.js",
   "scripts": {
@@ -8,7 +8,7 @@
     "coverage": "npx quack coverage",
     "test": "npx quack test",
     "tests": "npx quack test -g",
-    "build": "npx quack build --full-paths",
+    "build": "npx quack build",
     "docker-dev-build": "docker build ./ -f Dockerfile_LUXURYCode -t retold/meadow:local",
     "docker-dev-run": "docker run -it -d --name meadow-dev -p 12342:8080 -p 12106:3306 -v \"$PWD/.config:/home/coder/.config\"  -v \"$PWD:/home/coder/meadow\" -u \"$(id -u):$(id -g)\" -e \"DOCKER_USER=$USER\" retold/meadow:local",
     "docker-dev-shell": "docker exec -it meadow-dev /bin/bash",
@@ -22,8 +22,29 @@
     "docker-mssql-status": "./scripts/mssql-test-db.sh status",
     "test-mssql": "./scripts/mssql-test-db.sh start && npx quack test -g Meadow-Provider-MSSQL",
     "test-mssql-all": "./scripts/mssql-test-db.sh start && npx mocha -u tdd --exit -R spec",
-    "test-all-providers": "./scripts/mysql-test-db.sh start && ./scripts/mssql-test-db.sh start && npx mocha -u tdd --exit -R spec",
-    "docker-cleanup": "./scripts/meadow-test-cleanup.sh"
+    "docker-postgresql-start": "./scripts/postgresql-test-db.sh start",
+    "docker-postgresql-stop": "./scripts/postgresql-test-db.sh stop",
+    "docker-postgresql-status": "./scripts/postgresql-test-db.sh status",
+    "test-postgresql": "./scripts/postgresql-test-db.sh start && npx quack test -g Meadow-Provider-PostgreSQL",
+    "test-postgresql-all": "./scripts/postgresql-test-db.sh start && npx mocha -u tdd --exit -R spec",
+    "docker-mongodb-start": "./scripts/mongodb-test-db.sh start",
+    "docker-mongodb-stop": "./scripts/mongodb-test-db.sh stop",
+    "docker-mongodb-status": "./scripts/mongodb-test-db.sh status",
+    "test-mongodb": "./scripts/mongodb-test-db.sh start && npx quack test -g Meadow-Provider-MongoDB",
+    "docker-solr-start": "./scripts/solr-test-db.sh start",
+    "docker-solr-stop": "./scripts/solr-test-db.sh stop",
+    "docker-solr-status": "./scripts/solr-test-db.sh status",
+    "test-solr": "./scripts/solr-test-db.sh start && npx quack test -g Meadow-Provider-Solr",
+    "docker-dgraph-start": "./scripts/dgraph-test-db.sh start",
+    "docker-dgraph-stop": "./scripts/dgraph-test-db.sh stop",
+    "docker-dgraph-status": "./scripts/dgraph-test-db.sh status",
+    "test-dgraph": "./scripts/dgraph-test-db.sh start && npx quack test -g Meadow-Provider-DGraph",
+    "test-alasql": "npx quack test -g Meadow-Provider-ALASQL",
+    "test-sqlite-browser": "npx quack test -g Meadow-Provider-SQLiteBrowser",
+    "test-sqlite-browser-headless": "npx mocha -u tdd --exit --timeout 60000 test/Meadow-Provider-SQLiteBrowser-Headless_tests.js",
+    "test-all-providers": "./scripts/mysql-test-db.sh start && ./scripts/mssql-test-db.sh start && ./scripts/postgresql-test-db.sh start && ./scripts/mongodb-test-db.sh start && ./scripts/solr-test-db.sh start && ./scripts/dgraph-test-db.sh start && npx mocha -u tdd --exit -R spec",
+    "docker-cleanup": "./scripts/meadow-test-cleanup.sh",
+    "test-cleanup": "./scripts/meadow-test-cleanup.sh"
   },
   "mocha": {
     "diff": true,
@@ -58,19 +79,29 @@
   },
   "homepage": "https://github.com/stevenvelozo/meadow",
   "devDependencies": {
-    "alasql": "^4.1.10",
+    "alasql": "^4.17.0",
     "better-sqlite3": "^12.6.2",
-    "fable": "^3.1.53",
+    "dgraph-js-http": "^21.3.0",
+    "fable": "^3.1.63",
     "gulp-util": "^3.0.8",
-    "meadow-connection-mssql": "^1.0.10",
-    "meadow-connection-mysql": "^1.0.7",
-    "meadow-connection-sqlite": "file:../meadow-connection-sqlite",
-    "mysql2": "^3.6.3",
-    "quackage": "^1.0.58"
+    "meadow-connection-dgraph": "^1.0.2",
+    "meadow-connection-mongodb": "^1.0.2",
+    "meadow-connection-mssql": "^1.0.15",
+    "meadow-connection-mysql": "^1.0.13",
+    "meadow-connection-postgresql": "^1.0.1",
+    "meadow-connection-rocksdb": "^0.0.2",
+    "meadow-connection-solr": "^1.0.2",
+    "meadow-connection-sqlite": "^1.0.17",
+    "meadow-connection-sqlite-browser": "^1.0.0",
+    "mongodb": "^6.12.0",
+    "mysql2": "^3.18.2",
+    "puppeteer": "^24.38.0",
+    "quackage": "^1.0.60",
+    "solr-client": "^0.9.0"
   },
   "dependencies": {
-    "async": "3.2.5",
-    "foxhound": "^2.0.18",
+    "async": "3.2.6",
+    "foxhound": "^2.0.22",
     "is-my-json-valid": "2.20.6",
     "simple-get": "^4.0.1"
   }

package/scripts/bookstore-seed-postgresql.sql

@@ -0,0 +1,135 @@
+-- Bookstore Schema and Seed Data for Meadow PostgreSQL Tests
+-- PostgreSQL variant of bookstore-seed.sql
+
+-- Schema
+
+CREATE TABLE IF NOT EXISTS
+    Book
+    (
+        IDBook SERIAL PRIMARY KEY,
+        GUIDBook CHAR(36) NOT NULL DEFAULT '00000000-0000-0000-0000-000000000000',
+        CreateDate TIMESTAMP,
+        CreatingIDUser INT NOT NULL DEFAULT 0,
+        UpdateDate TIMESTAMP,
+        UpdatingIDUser INT NOT NULL DEFAULT 0,
+        Deleted SMALLINT NOT NULL DEFAULT 0,
+        DeleteDate TIMESTAMP,
+        DeletingIDUser INT NOT NULL DEFAULT 0,
+        Title VARCHAR(200) NOT NULL DEFAULT '',
+        Type VARCHAR(32) NOT NULL DEFAULT '',
+        Genre VARCHAR(128) NOT NULL DEFAULT '',
+        ISBN VARCHAR(64) NOT NULL DEFAULT '',
+        Language VARCHAR(12) NOT NULL DEFAULT '',
+        ImageURL VARCHAR(254) NOT NULL DEFAULT '',
+        PublicationYear INT NOT NULL DEFAULT 0
+    );
+
+CREATE TABLE IF NOT EXISTS
+    BookAuthorJoin
+    (
+        IDBookAuthorJoin SERIAL PRIMARY KEY,
+        GUIDBookAuthorJoin CHAR(36) NOT NULL DEFAULT '00000000-0000-0000-0000-000000000000',
+        IDBook INT NOT NULL DEFAULT 0,
+        IDAuthor INT NOT NULL DEFAULT 0
+    );
+
+CREATE TABLE IF NOT EXISTS
+    Author
+    (
+        IDAuthor SERIAL PRIMARY KEY,
+        GUIDAuthor CHAR(36) NOT NULL DEFAULT '00000000-0000-0000-0000-000000000000',
+        CreateDate TIMESTAMP,
+        CreatingIDUser INT NOT NULL DEFAULT 0,
+        UpdateDate TIMESTAMP,
+        UpdatingIDUser INT NOT NULL DEFAULT 0,
+        Deleted SMALLINT NOT NULL DEFAULT 0,
+        DeleteDate TIMESTAMP,
+        DeletingIDUser INT NOT NULL DEFAULT 0,
+        Name VARCHAR(200) NOT NULL DEFAULT ''
+    );
+
+CREATE TABLE IF NOT EXISTS
+    BookPrice
+    (
+        IDBookPrice SERIAL PRIMARY KEY,
+        GUIDBookPrice CHAR(36) NOT NULL DEFAULT '00000000-0000-0000-0000-000000000000',
+        CreateDate TIMESTAMP,
+        CreatingIDUser INT NOT NULL DEFAULT 0,
+        UpdateDate TIMESTAMP,
+        UpdatingIDUser INT NOT NULL DEFAULT 0,
+        Deleted SMALLINT NOT NULL DEFAULT 0,
+        DeleteDate TIMESTAMP,
+        DeletingIDUser INT NOT NULL DEFAULT 0,
+        Price DECIMAL(8,2),
+        StartDate TIMESTAMP,
+        EndDate TIMESTAMP,
+        Discountable SMALLINT NOT NULL DEFAULT 0,
+        CouponCode VARCHAR(16) NOT NULL DEFAULT '',
+        IDBook INT NOT NULL DEFAULT 0
+    );
+
+CREATE TABLE IF NOT EXISTS
+    Review
+    (
+        IDReviews SERIAL PRIMARY KEY,
+        GUIDReviews CHAR(36) NOT NULL DEFAULT '00000000-0000-0000-0000-000000000000',
+        CreateDate TIMESTAMP,
+        CreatingIDUser INT NOT NULL DEFAULT 0,
+        UpdateDate TIMESTAMP,
+        UpdatingIDUser INT NOT NULL DEFAULT 0,
+        Deleted SMALLINT NOT NULL DEFAULT 0,
+        DeleteDate TIMESTAMP,
+        DeletingIDUser INT NOT NULL DEFAULT 0,
+        Text TEXT,
+        Rating INT NOT NULL DEFAULT 0,
+        IDBook INT NOT NULL DEFAULT 0
+    );
+
+-- Seed Data: First 20 books from books.csv
+
+INSERT INTO Book (Title, Type, Genre, ISBN, Language, ImageURL, PublicationYear, CreateDate, CreatingIDUser, UpdateDate, UpdatingIDUser) VALUES
+('The Hunger Games', 'Paper', 'UNKNOWN', '439023483', 'eng', 'https://images.gr-assets.com/books/1447303603m/2767052.jpg', 2008, NOW(), 99999, NOW(), 99999),
+('Harry Potter and the Philosopher''s Stone', 'Paper', 'UNKNOWN', '439554934', 'eng', 'https://images.gr-assets.com/books/1474154022m/3.jpg', 1997, NOW(), 99999, NOW(), 99999),
+('Twilight', 'Paper', 'UNKNOWN', '316015849', 'en-US', 'https://images.gr-assets.com/books/1361039443m/41865.jpg', 2005, NOW(), 99999, NOW(), 99999),
+('To Kill a Mockingbird', 'Paper', 'UNKNOWN', '61120081', 'eng', 'https://images.gr-assets.com/books/1361975680m/2657.jpg', 1960, NOW(), 99999, NOW(), 99999),
+('The Great Gatsby', 'Paper', 'UNKNOWN', '743273567', 'eng', 'https://images.gr-assets.com/books/1490528560m/4671.jpg', 1925, NOW(), 99999, NOW(), 99999),
+('The Fault in Our Stars', 'Paper', 'UNKNOWN', '525478817', 'eng', 'https://images.gr-assets.com/books/1360206420m/11870085.jpg', 2012, NOW(), 99999, NOW(), 99999),
+('The Hobbit or There and Back Again', 'Paper', 'UNKNOWN', '618260307', 'en-US', 'https://images.gr-assets.com/books/1372847500m/5907.jpg', 1937, NOW(), 99999, NOW(), 99999),
+('The Catcher in the Rye', 'Paper', 'UNKNOWN', '316769177', 'eng', 'https://images.gr-assets.com/books/1398034300m/5107.jpg', 1951, NOW(), 99999, NOW(), 99999),
+('Angels & Demons', 'Paper', 'UNKNOWN', '1416524797', 'en-CA', 'https://images.gr-assets.com/books/1303390735m/960.jpg', 2000, NOW(), 99999, NOW(), 99999),
+('Pride and Prejudice', 'Paper', 'UNKNOWN', '679783261', 'eng', 'https://images.gr-assets.com/books/1320399351m/1885.jpg', 1813, NOW(), 99999, NOW(), 99999),
+('The Kite Runner', 'Paper', 'UNKNOWN', '1594480001', 'eng', 'https://images.gr-assets.com/books/1484565687m/77203.jpg', 2003, NOW(), 99999, NOW(), 99999),
+('Divergent', 'Paper', 'UNKNOWN', '62024035', 'eng', 'https://images.gr-assets.com/books/1328559506m/13335037.jpg', 2011, NOW(), 99999, NOW(), 99999),
+('Nineteen Eighty-Four', 'Paper', 'UNKNOWN', '451524934', 'eng', 'https://images.gr-assets.com/books/1348990566m/5470.jpg', 1949, NOW(), 99999, NOW(), 99999),
+('Animal Farm: A Fairy Story', 'Paper', 'UNKNOWN', '452284244', 'eng', 'https://images.gr-assets.com/books/1424037542m/7613.jpg', 1945, NOW(), 99999, NOW(), 99999),
+('Het Achterhuis: Dagboekbrieven 14 juni 1942 - 1 augustus 1944', 'Paper', 'UNKNOWN', '553296981', 'eng', 'https://images.gr-assets.com/books/1358276407m/48855.jpg', 1947, NOW(), 99999, NOW(), 99999),
+('Män som hatar kvinnor', 'Paper', 'UNKNOWN', '307269752', 'eng', 'https://images.gr-assets.com/books/1327868566m/2429135.jpg', 2005, NOW(), 99999, NOW(), 99999),
+('Catching Fire', 'Paper', 'UNKNOWN', '439023491', 'eng', 'https://images.gr-assets.com/books/1358273780m/6148028.jpg', 2009, NOW(), 99999, NOW(), 99999),
+('Harry Potter and the Prisoner of Azkaban', 'Paper', 'UNKNOWN', '043965548X', 'eng', 'https://images.gr-assets.com/books/1499277281m/5.jpg', 1999, NOW(), 99999, NOW(), 99999),
+('The Fellowship of the Ring', 'Paper', 'UNKNOWN', '618346252', 'eng', 'https://images.gr-assets.com/books/1298411339m/34.jpg', 1954, NOW(), 99999, NOW(), 99999),
+('Mockingjay', 'Paper', 'UNKNOWN', '439023513', 'eng', 'https://images.gr-assets.com/books/1358275419m/7260188.jpg', 2010, NOW(), 99999, NOW(), 99999);
+
+-- Seed Data: Authors for the first 20 books
+
+INSERT INTO Author (Name, CreateDate, CreatingIDUser, UpdateDate, UpdatingIDUser) VALUES
+('Suzanne Collins', NOW(), 99999, NOW(), 99999),
+('J.K. Rowling', NOW(), 99999, NOW(), 99999),
+('Mary GrandPré', NOW(), 99999, NOW(), 99999),
+('Stephenie Meyer', NOW(), 99999, NOW(), 99999),
+('Harper Lee', NOW(), 99999, NOW(), 99999),
+('F. Scott Fitzgerald', NOW(), 99999, NOW(), 99999),
+('John Green', NOW(), 99999, NOW(), 99999),
+('J.R.R. Tolkien', NOW(), 99999, NOW(), 99999),
+('J.D. Salinger', NOW(), 99999, NOW(), 99999),
+('Dan Brown', NOW(), 99999, NOW(), 99999),
+('Jane Austen', NOW(), 99999, NOW(), 99999),
+('Khaled Hosseini', NOW(), 99999, NOW(), 99999),
+('Veronica Roth', NOW(), 99999, NOW(), 99999),
+('George Orwell', NOW(), 99999, NOW(), 99999),
+('Erich Fromm', NOW(), 99999, NOW(), 99999),
+('Anne Frank', NOW(), 99999, NOW(), 99999),
+('Eleanor Roosevelt', NOW(), 99999, NOW(), 99999),
+('B.M. Mooyaart-Doubleday', NOW(), 99999, NOW(), 99999),
+('Stieg Larsson', NOW(), 99999, NOW(), 99999),
+('Reg Keeland', NOW(), 99999, NOW(), 99999),
+('Rufus Beck', NOW(), 99999, NOW(), 99999);

package/scripts/dgraph-test-db.sh

@@ -0,0 +1,144 @@
+#!/bin/bash
+# DGraph Test Database Management Script
+#
+# Usage:
+#   ./scripts/dgraph-test-db.sh start   - Start DGraph container, apply schema, and wait for readiness
+#   ./scripts/dgraph-test-db.sh stop    - Stop and remove the container
+#   ./scripts/dgraph-test-db.sh status  - Check if the container is running
+#
+# The container settings match the test configuration in
+# test/Meadow-Provider-DGraph_tests.js:
+#   Host: 127.0.0.1, Port: 38080 (HTTP), 39080 (gRPC)
+
+CONTAINER_NAME="meadow-dgraph-test"
+DGRAPH_HTTP_PORT="38080"
+DGRAPH_GRPC_PORT="39080"
+DGRAPH_IMAGE="dgraph/standalone:latest"
+
+start_dgraph() {
+	# 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 "DGraph test container is already running."
+			return 0
+		else
+			echo "Removing stopped container..."
+			docker rm "${CONTAINER_NAME}" > /dev/null 2>&1
+		fi
+	fi
+
+	echo "Starting DGraph test container..."
+	docker run -d \
+		--name "${CONTAINER_NAME}" \
+		-p "${DGRAPH_HTTP_PORT}:8080" \
+		-p "${DGRAPH_GRPC_PORT}:9080" \
+		"${DGRAPH_IMAGE}"
+
+	if [ $? -ne 0 ]; then
+		echo "ERROR: Failed to start DGraph container."
+		exit 1
+	fi
+
+	echo "Waiting for DGraph to be ready..."
+	RETRIES=30
+	until curl -sf "http://localhost:${DGRAPH_HTTP_PORT}/health" > /dev/null 2>&1; do
+		RETRIES=$((RETRIES - 1))
+		if [ $RETRIES -le 0 ]; then
+			echo "ERROR: DGraph 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
+
+	# Apply schema predicates for the FableTest type and MeadowCounter type
+	# Note: FableTest fields use unscoped predicate names to match FoxHound DGraph dialect output
+	echo "Applying DGraph schema..."
+	curl -sf "http://localhost:${DGRAPH_HTTP_PORT}/alter" -d '
+IDAnimal: int @index(int) .
+GUIDAnimal: string .
+CreateDate: string .
+CreatingIDUser: int .
+UpdateDate: string .
+UpdatingIDUser: int .
+Deleted: int @index(int) .
+DeleteDate: string .
+DeletingIDUser: int .
+Name: string @index(exact, term) .
+Type: string @index(exact, term) .
+MeadowCounter.scope: string @index(exact) .
+MeadowCounter.sequence: int .
+
+type FableTest {
+	IDAnimal
+	GUIDAnimal
+	CreateDate
+	CreatingIDUser
+	UpdateDate
+	UpdatingIDUser
+	Deleted
+	DeleteDate
+	DeletingIDUser
+	Name
+	Type
+}
+
+type MeadowCounter {
+	MeadowCounter.scope
+	MeadowCounter.sequence
+}
+' > /dev/null 2>&1
+
+	if [ $? -ne 0 ]; then
+		echo "WARNING: Failed to apply DGraph schema. Tests may fail."
+	else
+		echo "DGraph schema applied successfully."
+	fi
+
+	echo ""
+	echo "DGraph test instance is ready!"
+	echo "  Container: ${CONTAINER_NAME}"
+	echo "  HTTP:      127.0.0.1:${DGRAPH_HTTP_PORT}"
+	echo "  gRPC:      127.0.0.1:${DGRAPH_GRPC_PORT}"
+	echo ""
+	echo "Run tests with: npm run test-dgraph"
+}
+
+stop_dgraph() {
+	if docker ps -a --format '{{.Names}}' | grep -q "^${CONTAINER_NAME}$"; then
+		echo "Stopping and removing DGraph test container..."
+		docker stop "${CONTAINER_NAME}" > /dev/null 2>&1
+		docker rm "${CONTAINER_NAME}" > /dev/null 2>&1
+		echo "DGraph test container removed."
+	else
+		echo "No DGraph test container found."
+	fi
+}
+
+status_dgraph() {
+	if docker ps --format '{{.Names}}' | grep -q "^${CONTAINER_NAME}$"; then
+		echo "DGraph 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 "DGraph test container exists but is stopped."
+	else
+		echo "DGraph test container is not running."
+	fi
+}
+
+case "${1}" in
+	start)
+		start_dgraph
+		;;
+	stop)
+		stop_dgraph
+		;;
+	status)
+		status_dgraph
+		;;
+	*)
+		echo "Usage: $0 {start|stop|status}"
+		exit 1
+		;;
+esac

package/scripts/meadow-test-cleanup.sh

@@ -1,7 +1,7 @@
 #!/bin/bash
 # Meadow Test Database Cleanup Script
 #
-# Stops and removes both MySQL and MSSQL test containers.
+# Stops and removes all meadow test database containers.
 #
 # Usage:
 #   ./scripts/meadow-test-cleanup.sh
@@ -13,6 +13,10 @@ echo ""
 
 "${SCRIPT_DIR}/mysql-test-db.sh" stop
 "${SCRIPT_DIR}/mssql-test-db.sh" stop
+"${SCRIPT_DIR}/postgresql-test-db.sh" stop
+"${SCRIPT_DIR}/mongodb-test-db.sh" stop
+"${SCRIPT_DIR}/solr-test-db.sh" stop
+"${SCRIPT_DIR}/dgraph-test-db.sh" stop
 
 echo ""
 echo "Cleanup complete."