meadow-connection-mysql 1.0.7 → 1.0.9

package/CONTRIBUTING.md

@@ -0,0 +1,50 @@
+# Contributing to Retold
+
+We welcome contributions to Retold and its modules. This guide covers the expectations and process for contributing.
+
+## Code of Conduct
+
+The Retold community values **empathy**, **equity**, **kindness**, and **thoughtfulness**. We expect all participants to treat each other with respect, assume good intent, and engage constructively. These values apply to all interactions: pull requests, issues, discussions, and code review.
+
+## How to Contribute
+
+### Pull Requests
+
+Pull requests are the preferred method for contributing changes. To submit one:
+
+1. Fork the module repository you want to change
+2. Create a branch for your work
+3. Make your changes, following the code style of the module you are editing
+4. Ensure your changes have test coverage (see below)
+5. Open a pull request against the module's main branch
+
+**Submitting a pull request does not guarantee it will be accepted.** Maintainers review contributions for fit, quality, and alignment with the project's direction. A PR may be declined, or you may be asked to revise it. This is normal and not a reflection on the quality of your effort.
+
+### Reporting Issues
+
+If you find a bug or have a feature suggestion, open an issue on the relevant module's repository. Include enough detail to reproduce the problem or understand the proposal.
+
+## Test Coverage
+
+Every commit must include test coverage for the changes it introduces. Retold modules use Mocha in TDD style. Before submitting:
+
+- **Write tests** for any new functionality or bug fixes
+- **Run the existing test suite** with `npm test` and confirm all tests pass
+- **Check coverage** with `npm run coverage` if the module supports it
+
+Pull requests that break existing tests or lack coverage for new code will not be merged.
+
+## Code Style
+
+Follow the conventions of the module you are working in. The general Retold style is:
+
+- **Tabs** for indentation, never spaces
+- **Plain JavaScript** only (no TypeScript)
+- **Allman-style braces** (opening brace on its own line)
+- **Variable naming:** `pVariable` for parameters, `tmpVariable` for temporaries, `libSomething` for imports
+
+When in doubt, match what the surrounding code does.
+
+## Repository Structure
+
+Each module is its own git repository. The [retold](https://github.com/stevenvelozo/retold) repository tracks module organization but does not contain module source code. Direct your pull request to the specific module repository where your change belongs.

package/README.md

@@ -189,10 +189,15 @@ Run with coverage:
 npm run coverage
 ```
 
+## Related Packages
+
+- [meadow](https://github.com/stevenvelozo/meadow) - Data access and ORM
+- [fable](https://github.com/stevenvelozo/fable) - Application services framework
+
 ## License
 
-MIT - See [LICENSE](LICENSE) for details.
+MIT
 
-## Author
+## Contributing
 
-Steven Velozo - [steven@velozo.com](mailto:steven@velozo.com)
+Pull requests are welcome. For details on our code of conduct, contribution process, and testing requirements, see the [Retold Contributing Guide](https://github.com/stevenvelozo/retold/blob/main/docs/contributing.md).

package/docker-compose.yml

@@ -0,0 +1,19 @@
+version: '3.8'
+
+services:
+  mysql-test:
+    image: mysql:8
+    container_name: meadow-connection-mysql-test
+    environment:
+      MYSQL_ROOT_PASSWORD: "1234567890"
+      MYSQL_DATABASE: bookstore
+    ports:
+      - "23306:3306"
+    volumes:
+      - ./test/docker-init:/docker-entrypoint-initdb.d
+    healthcheck:
+      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p1234567890"]
+      interval: 5s
+      timeout: 5s
+      retries: 20
+      start_period: 10s

package/docs/retold-catalog.json

@@ -1,5 +1,5 @@
 {
-	"Generated": "2026-02-15T22:16:49.979Z",
+	"Generated": "2026-02-18T03:39:19.680Z",
 	"GitHubOrg": "stevenvelozo",
 	"DefaultBranch": "master",
 	"Groups": [
@@ -57,6 +57,25 @@
 				}
 			]
 		},
+		{
+			"Name": "Docs",
+			"Key": "docs",
+			"Description": "",
+			"Modules": [
+				{
+					"Name": "css",
+					"Repo": "css",
+					"Group": "docs",
+					"Branch": "master",
+					"HasDocs": true,
+					"HasCover": false,
+					"Sidebar": [],
+					"DocFiles": [
+						"css/docuserve.css"
+					]
+				}
+			]
+		},
 		{
 			"Name": "Retold-harness",
 			"Key": "retold-harness",
@@ -93,6 +112,23 @@
 					"DocFiles": []
 				}
 			]
+		},
+		{
+			"Name": "Test",
+			"Key": "test",
+			"Description": "",
+			"Modules": [
+				{
+					"Name": "docker-init",
+					"Repo": "docker-init",
+					"Group": "test",
+					"Branch": "master",
+					"HasDocs": false,
+					"HasCover": false,
+					"Sidebar": [],
+					"DocFiles": []
+				}
+			]
 		}
 	]
 }

package/docs/retold-keyword-index.json

@@ -1,5 +1,5 @@
 {
-	"Generated": "2026-02-15T22:16:50.065Z",
+	"Generated": "2026-02-18T03:39:19.765Z",
 	"DocumentCount": 0,
 	"LunrIndex": {
 		"version": "2.3.9",

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "meadow-connection-mysql",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Meadow MySQL Plugin",
   "main": "source/Meadow-Connection-MySQL.js",
   "scripts": {
-    "coverage": "./node_modules/istanbul/lib/cli.js cover ./node_modules/mocha/bin/_mocha -- -u tdd -R spec",
-    "test": "./node_modules/mocha/bin/_mocha -u tdd --exit -R spec",
+    "coverage": "npx quack coverage",
+    "test": "npx quack test",
+    "docker-mysql-start": "bash ./start-mysql.sh",
+    "docker-mysql-stop": "bash ./stop-mysql.sh",
+    "test-docker": "bash ./start-mysql.sh && npm test; bash ./stop-mysql.sh",
     "docker-dev-build": "docker build ./ -f Dockerfile_LUXURYCode -t retold/meadow-connection-mysql:local",
     "docker-dev-run": "docker run -it -d --name retold-meadow-connection-mysql-dev -p 38001:8080 -v \"$PWD/.config:/home/coder/.config\"  -v \"$PWD:/home/coder/meadow-connection-mysql\" -u \"$(id -u):$(id -g)\" -e \"DOCKER_USER=$USER\" retold/meadow-connection-mysql:local",
     "docker-dev-shell": "docker exec -it retold-meadow-connection-mysql-dev /bin/bash"
@@ -42,25 +45,12 @@
   },
   "homepage": "https://github.com/stevenvelozo/meadow-connection-mysql",
   "devDependencies": {
-    "@babel/core": "^7.23.2",
-    "@babel/preset-env": "^7.23.2",
-    "browserify": "^17.0.0",
-    "chai": "4.3.10",
-    "fable": "^3.1.53",
-    "gulp": "^4.0.2",
-    "gulp-babel": "^8.0.0",
-    "gulp-env": "^0.4.0",
-    "gulp-sourcemaps": "^3.0.0",
-    "gulp-terser": "^2.1.0",
+    "fable": "^3.1.55",
     "gulp-util": "^3.0.8",
-    "mocha": "10.2.0",
-    "nyc": "^15.1.0",
-    "quackage": "^1.0.48",
-    "vinyl-buffer": "^1.0.1",
-    "vinyl-source-stream": "^2.0.0"
+    "quackage": "^1.0.58"
   },
   "dependencies": {
-    "fable-serviceproviderbase": "^3.0.16",
+    "fable-serviceproviderbase": "^3.0.19",
     "mysql2": "^3.6.3"
   }
 }

package/start-mysql.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+# Start the MySQL test server in Docker
+# Uses port 23306 to avoid conflicts with any local MySQL instance
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+echo "Starting MySQL test server on port 23306..."
+docker compose -f "${SCRIPT_DIR}/docker-compose.yml" up -d
+
+echo "Waiting for MySQL to be ready..."
+until docker compose -f "${SCRIPT_DIR}/docker-compose.yml" exec -T mysql-test mysqladmin ping -h localhost -u root -p1234567890 --silent 2>/dev/null; do
+	sleep 2
+	echo "  ...still waiting"
+done
+
+echo "MySQL test server is ready on port 23306"
+echo "  Host: 127.0.0.1"
+echo "  Port: 23306"
+echo "  User: root"
+echo "  Password: 1234567890"
+echo "  Database: bookstore"

package/stop-mysql.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+# Stop and remove the MySQL test server Docker container
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+echo "Stopping MySQL test server..."
+docker compose -f "${SCRIPT_DIR}/docker-compose.yml" down -v
+
+echo "MySQL test server stopped and volumes removed."

package/test/MySQL_tests.js

@@ -33,11 +33,9 @@ const _FableConfig = (
 		"MySQL":
 			{
 				"Server": "127.0.0.1",
-				// October 2025 - updated this to match retold harness running locally either in docker or natively
-				"Port": 31306,
-				//"Port": 3306,
+				"Port": 23306,
 				"User": "root",
-				"Password": "123456789",
+				"Password": "1234567890",
 				"Database": "bookstore",
 				"ConnectionPoolLimit": 20
 			}
@@ -70,12 +68,12 @@ suite
 						_Fable.MeadowMySQLProvider.connect();
 
 						// We should now have a fully charged MySQL connection pool utensil
-						_Fable.MeadowMySQLProvider.pool.query(`SELECT * FROM Book LIMIT 10`,
+						_Fable.MeadowMySQLProvider.pool.query(`SELECT * FROM Book ORDER BY IDBook ASC LIMIT 10`,
 							(pError, pRows, pFields) =>
 							{
 								Expect(pRows).to.be.an('array');
 								Expect(pRows.length).to.equal(10);
-								Expect(pRows[0].Title).to.equal(`Angels & Demons`);
+								Expect(pRows[0].Title).to.equal(`The Hunger Games`);
 								return fDone();
 							});
 					}
@@ -95,7 +93,7 @@ suite
 						_Fable.MeadowMySQLProvider.connect();
 
 						// We should now have a fully charged MySQL connection pool utensil
-						_Fable.MeadowMySQLProvider.pool.query(`SELECT * FROM Book LIMIT 10`,
+						_Fable.MeadowMySQLProvider.pool.query(`SELECT * FROM Book ORDER BY IDBook ASC LIMIT 10`,
 							(pError, pRows, pFields) =>
 							{
 								Expect(pRows).to.be.an('array');
@@ -121,7 +119,7 @@ suite
 							function (pError, pConnectionPool)
 							{
 							// We should now have a fully charged MySQL connection pool utensil
-							_Fable.MeadowMySQLProvider.pool.query(`SELECT * FROM Book LIMIT 10`,
+							_Fable.MeadowMySQLProvider.pool.query(`SELECT * FROM Book ORDER BY IDBook ASC LIMIT 10`,
 								(pError, pRows, pFields) =>
 								{
 									Expect(pRows).to.be.an('array');
@@ -148,7 +146,7 @@ suite
 						Expect(_Fable.MeadowMySQLProvider).to.be.an('object');
 
 						// We should now have a fully charged MySQL connection pool utensil
-						_Fable.MeadowMySQLProvider.pool.query(`SELECT * FROM Book LIMIT 10`,
+						_Fable.MeadowMySQLProvider.pool.query(`SELECT * FROM Book ORDER BY IDBook ASC LIMIT 10`,
 							(pError, pRows, pFields) =>
 							{
 								Expect(pRows).to.be.an('array');

package/test/docker-init/01-schema.sql

@@ -0,0 +1,115 @@
+-- Bookstore schema and seed data for meadow-connection-mysql tests
+
+USE bookstore;
+
+-- [ Book ]
+CREATE TABLE IF NOT EXISTS
+    Book
+    (
+        IDBook INT UNSIGNED NOT NULL AUTO_INCREMENT,
+        GUIDBook CHAR(36) NOT NULL DEFAULT '00000000-0000-0000-0000-000000000000',
+        CreateDate DATETIME,
+        CreatingIDUser INT NOT NULL DEFAULT '0',
+        UpdateDate DATETIME,
+        UpdatingIDUser INT NOT NULL DEFAULT '0',
+        Deleted TINYINT NOT NULL DEFAULT '0',
+        DeleteDate DATETIME,
+        DeletingIDUser INT NOT NULL DEFAULT '0',
+        Title CHAR(200) NOT NULL DEFAULT '',
+        Type CHAR(32) NOT NULL DEFAULT '',
+        Genre CHAR(128) NOT NULL DEFAULT '',
+        ISBN CHAR(64) NOT NULL DEFAULT '',
+        Language CHAR(12) NOT NULL DEFAULT '',
+        ImageURL CHAR(254) NOT NULL DEFAULT '',
+        PublicationYear INT NOT NULL DEFAULT '0',
+
+        PRIMARY KEY (IDBook)
+    ) DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+-- [ BookAuthorJoin ]
+CREATE TABLE IF NOT EXISTS
+    BookAuthorJoin
+    (
+        IDBookAuthorJoin INT UNSIGNED NOT NULL AUTO_INCREMENT,
+        GUIDBookAuthorJoin CHAR(36) NOT NULL DEFAULT '00000000-0000-0000-0000-000000000000',
+        IDBook INT NOT NULL DEFAULT '0',
+        IDAuthor INT NOT NULL DEFAULT '0',
+
+        PRIMARY KEY (IDBookAuthorJoin)
+    ) DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+-- [ Author ]
+CREATE TABLE IF NOT EXISTS
+    Author
+    (
+        IDAuthor INT UNSIGNED NOT NULL AUTO_INCREMENT,
+        GUIDAuthor CHAR(36) NOT NULL DEFAULT '00000000-0000-0000-0000-000000000000',
+        CreateDate DATETIME,
+        CreatingIDUser INT NOT NULL DEFAULT '0',
+        UpdateDate DATETIME,
+        UpdatingIDUser INT NOT NULL DEFAULT '0',
+        Deleted TINYINT NOT NULL DEFAULT '0',
+        DeleteDate DATETIME,
+        DeletingIDUser INT NOT NULL DEFAULT '0',
+        Name CHAR(200) NOT NULL DEFAULT '',
+
+        PRIMARY KEY (IDAuthor)
+    ) DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+-- [ BookPrice ]
+CREATE TABLE IF NOT EXISTS
+    BookPrice
+    (
+        IDBookPrice INT UNSIGNED NOT NULL AUTO_INCREMENT,
+        GUIDBookPrice CHAR(36) NOT NULL DEFAULT '00000000-0000-0000-0000-000000000000',
+        CreateDate DATETIME,
+        CreatingIDUser INT NOT NULL DEFAULT '0',
+        UpdateDate DATETIME,
+        UpdatingIDUser INT NOT NULL DEFAULT '0',
+        Deleted TINYINT NOT NULL DEFAULT '0',
+        DeleteDate DATETIME,
+        DeletingIDUser INT NOT NULL DEFAULT '0',
+        Price DECIMAL(8,2),
+        StartDate DATETIME,
+        EndDate DATETIME,
+        Discountable TINYINT NOT NULL DEFAULT '0',
+        CouponCode CHAR(16) NOT NULL DEFAULT '',
+        IDBook INT NOT NULL DEFAULT '0',
+
+        PRIMARY KEY (IDBookPrice)
+    ) DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+-- [ Review ]
+CREATE TABLE IF NOT EXISTS
+    Review
+    (
+        IDReviews INT UNSIGNED NOT NULL AUTO_INCREMENT,
+        GUIDReviews CHAR(36) NOT NULL DEFAULT '00000000-0000-0000-0000-000000000000',
+        CreateDate DATETIME,
+        CreatingIDUser INT NOT NULL DEFAULT '0',
+        UpdateDate DATETIME,
+        UpdatingIDUser INT NOT NULL DEFAULT '0',
+        Deleted TINYINT NOT NULL DEFAULT '0',
+        DeleteDate DATETIME,
+        DeletingIDUser INT NOT NULL DEFAULT '0',
+        Text TEXT,
+        Rating INT NOT NULL DEFAULT '0',
+        IDBook INT NOT NULL DEFAULT '0',
+
+        PRIMARY KEY (IDReviews)
+    ) DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+-- Seed data: 12 books (tests require at least 10)
+INSERT INTO Book (Title, Type, Genre, ISBN, Language, PublicationYear) VALUES
+    ('The Hunger Games', 'Paper', 'UNKNOWN', '439023483', 'eng', 2008),
+    ('Harry Potter and the Philosopher''s Stone', 'Paper', 'UNKNOWN', '439554934', 'eng', 1997),
+    ('Twilight', 'Paper', 'UNKNOWN', '316015849', 'en-US', 2005),
+    ('To Kill a Mockingbird', 'Paper', 'UNKNOWN', '61120081', 'eng', 1960),
+    ('The Great Gatsby', 'Paper', 'UNKNOWN', '743273567', 'eng', 1925),
+    ('The Fault in Our Stars', 'Paper', 'UNKNOWN', '525478817', 'eng', 2012),
+    ('The Hobbit', 'Paper', 'UNKNOWN', '618260307', 'en-US', 1937),
+    ('The Catcher in the Rye', 'Paper', 'UNKNOWN', '316769177', 'eng', 1951),
+    ('Angels & Demons', 'Paper', 'UNKNOWN', '1416524797', 'en-CA', 2000),
+    ('Pride and Prejudice', 'Paper', 'UNKNOWN', '679783261', 'eng', 1813),
+    ('The Kite Runner', 'Paper', 'UNKNOWN', '1594480001', 'eng', 2003),
+    ('Divergent', 'Paper', 'UNKNOWN', '62024035', 'eng', 2011);