meadow-connection-mssql 1.0.10 → 1.0.12

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

@@ -193,10 +193,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,12 @@
+services:
+  mssql-test:
+    image: mcr.microsoft.com/mssql/server:2022-latest
+    platform: linux/amd64
+    container_name: meadow-connection-mssql-test
+    environment:
+      ACCEPT_EULA: "Y"
+      MSSQL_SA_PASSWORD: "Retold1234567890!"
+    ports:
+      - "21433:1433"
+    volumes:
+      - ./test/docker-init:/docker-init

package/docs/retold-catalog.json

@@ -1,5 +1,5 @@
 {
-	"Generated": "2026-02-15T22:23:43.301Z",
+	"Generated": "2026-02-18T03:44:10.088Z",
 	"GitHubOrg": "stevenvelozo",
 	"DefaultBranch": "master",
 	"Groups": [
@@ -37,6 +37,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",
@@ -73,6 +92,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/package.json

@@ -1,16 +1,19 @@
 {
     "name": "meadow-connection-mssql",
-    "version": "1.0.10",
+    "version": "1.0.12",
     "description": "Meadow MSSQL Plugin",
     "main": "source/Meadow-Connection-MSSQL.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 -R spec",
+        "coverage": "npx quack coverage",
+        "test": "npx quack test",
+        "docker-mssql-start": "bash ./start-mssql.sh",
+        "docker-mssql-stop": "bash ./stop-mssql.sh",
+        "test-docker": "bash ./start-mssql.sh && npm test; bash ./stop-mssql.sh",
         "docker-dev-build": "docker build ./ -f Dockerfile_LUXURYCode -t retold/meadow-connection-mssql:local",
         "docker-dev-run": "docker run -it -d --name retold-meadow-connection-mssql-dev -p 38001:8080 -v \"$PWD/.config:/home/coder/.config\"  -v \"$PWD:/home/coder/meadow-connection-mssql\" -u \"$(id -u):$(id -g)\" -e \"DOCKER_USER=$USER\" retold/meadow-connection-mssql:local",
         "docker-dev-shell": "docker exec -it retold-meadow-connection-mssql-dev /bin/bash",
         "start": "node source/Meadow-Connection-MSSQL.js",
-        "tests": "npx mocha -u tdd --exit -R spec --grep",
+        "tests": "npx quack test -g",
         "build": "npx quack build"
     },
     "mocha": {
@@ -45,10 +48,11 @@
     },
     "homepage": "https://github.com/stevenvelozo/meadow-connection-mssql",
     "devDependencies": {
-        "quackage": "^1.0.48"
+        "fable": "^3.1.55",
+        "quackage": "^1.0.58"
     },
     "dependencies": {
-        "fable-serviceproviderbase": "^3.0.16",
+        "fable-serviceproviderbase": "^3.0.19",
         "mssql": "^9.1.1"
     }
 }

package/start-mssql.sh

@@ -0,0 +1,25 @@
+#!/bin/bash
+# Start the MSSQL test server in Docker
+# Uses port 21433 to avoid conflicts with any local MSSQL instance
+# Uses linux/amd64 platform (runs under Rosetta on Apple Silicon)
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+echo "Starting MSSQL test server on port 21433..."
+docker compose -f "${SCRIPT_DIR}/docker-compose.yml" up -d
+
+echo "Initializing database (will retry until MSSQL is ready)..."
+node "${SCRIPT_DIR}/test/docker-init/init-db.js"
+
+if [ $? -ne 0 ]; then
+	echo "ERROR: Database initialization failed"
+	exit 1
+fi
+
+echo ""
+echo "MSSQL test server is ready on port 21433"
+echo "  Host: 127.0.0.1"
+echo "  Port: 21433"
+echo "  User: sa"
+echo "  Password: Retold1234567890!"
+echo "  Database: bookstore"

package/stop-mssql.sh

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

package/test/MSSQL_tests.js

@@ -33,9 +33,9 @@ const _FableConfig = (
 		"MSSQL":
 			{
 				"server": "localhost",
-				"port": 14333,
+				"port": 21433,
 				"user": "sa",
-				"password": "1234567890abc.",
+				"password": "Retold1234567890!",
 				"database": "bookstore",
 				"ConnectionPoolLimit": 20
 			}
@@ -76,8 +76,8 @@ suite
 									(pError, pRows, pFields) =>
 									{
 										Expect(pRows.recordset).to.be.an('array');
-										//Expect(pRows.length).to.equal(10);
-										//Expect(pRows[0].Title).to.equal(`Harry Potter and the Philosopher's Stone`);
+										Expect(pRows.recordset.length).to.equal(10);
+										Expect(pRows.recordset[0].Title).to.equal(`The Hunger Games`);
 										return fDone();
 									});
 							}

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

@@ -0,0 +1,135 @@
+-- Bookstore schema and seed data for meadow-connection-mssql tests
+
+CREATE DATABASE bookstore;
+GO
+
+USE bookstore;
+GO
+
+-- [ FableTest ] - Simple table used by the basic connection test
+CREATE TABLE [dbo].[FableTest]
+    (
+        [IDFableTest] INT NOT NULL IDENTITY PRIMARY KEY,
+        [Title] VARCHAR(200) DEFAULT '',
+        [Value] VARCHAR(200) DEFAULT ''
+    );
+GO
+
+-- [ Book ]
+CREATE TABLE [dbo].[Book]
+    (
+        [IDBook] INT NOT NULL IDENTITY PRIMARY KEY,
+        [GUIDBook] VARCHAR(36) DEFAULT '00000000-0000-0000-0000-000000000000',
+        [CreateDate] DATETIME,
+        [CreatingIDUser] INT NOT NULL DEFAULT 0,
+        [UpdateDate] DATETIME,
+        [UpdatingIDUser] INT NOT NULL DEFAULT 0,
+        [Deleted] TINYINT DEFAULT 0,
+        [DeleteDate] DATETIME,
+        [DeletingIDUser] INT NOT NULL DEFAULT 0,
+        [Title] VARCHAR(200) DEFAULT '',
+        [Type] VARCHAR(32) DEFAULT '',
+        [Genre] VARCHAR(128) DEFAULT '',
+        [ISBN] VARCHAR(64) DEFAULT '',
+        [Language] VARCHAR(12) DEFAULT '',
+        [ImageURL] VARCHAR(254) DEFAULT '',
+        [PublicationYear] INT NOT NULL DEFAULT 0
+    );
+GO
+
+-- [ BookAuthorJoin ]
+CREATE TABLE [dbo].[BookAuthorJoin]
+    (
+        [IDBookAuthorJoin] INT NOT NULL IDENTITY PRIMARY KEY,
+        [GUIDBookAuthorJoin] VARCHAR(36) DEFAULT '00000000-0000-0000-0000-000000000000',
+        [IDBook] INT NOT NULL DEFAULT 0,
+        [IDAuthor] INT NOT NULL DEFAULT 0
+    );
+GO
+
+-- [ Author ]
+CREATE TABLE [dbo].[Author]
+    (
+        [IDAuthor] INT NOT NULL IDENTITY PRIMARY KEY,
+        [GUIDAuthor] VARCHAR(36) DEFAULT '00000000-0000-0000-0000-000000000000',
+        [CreateDate] DATETIME,
+        [CreatingIDUser] INT NOT NULL DEFAULT 0,
+        [UpdateDate] DATETIME,
+        [UpdatingIDUser] INT NOT NULL DEFAULT 0,
+        [Deleted] TINYINT DEFAULT 0,
+        [DeleteDate] DATETIME,
+        [DeletingIDUser] INT NOT NULL DEFAULT 0,
+        [Name] VARCHAR(200) DEFAULT ''
+    );
+GO
+
+-- [ BookPrice ]
+CREATE TABLE [dbo].[BookPrice]
+    (
+        [IDBookPrice] INT NOT NULL IDENTITY PRIMARY KEY,
+        [GUIDBookPrice] VARCHAR(36) DEFAULT '00000000-0000-0000-0000-000000000000',
+        [CreateDate] DATETIME,
+        [CreatingIDUser] INT NOT NULL DEFAULT 0,
+        [UpdateDate] DATETIME,
+        [UpdatingIDUser] INT NOT NULL DEFAULT 0,
+        [Deleted] TINYINT DEFAULT 0,
+        [DeleteDate] DATETIME,
+        [DeletingIDUser] INT NOT NULL DEFAULT 0,
+        [Price] DECIMAL(8,2),
+        [StartDate] DATETIME,
+        [EndDate] DATETIME,
+        [Discountable] TINYINT DEFAULT 0,
+        [CouponCode] VARCHAR(16) DEFAULT '',
+        [IDBook] INT NOT NULL DEFAULT 0
+    );
+GO
+
+-- [ Review ]
+CREATE TABLE [dbo].[Review]
+    (
+        [IDReviews] INT NOT NULL IDENTITY PRIMARY KEY,
+        [GUIDReviews] VARCHAR(36) DEFAULT '00000000-0000-0000-0000-000000000000',
+        [CreateDate] DATETIME,
+        [CreatingIDUser] INT NOT NULL DEFAULT 0,
+        [UpdateDate] DATETIME,
+        [UpdatingIDUser] INT NOT NULL DEFAULT 0,
+        [Deleted] TINYINT DEFAULT 0,
+        [DeleteDate] DATETIME,
+        [DeletingIDUser] INT NOT NULL DEFAULT 0,
+        [Text] TEXT,
+        [Rating] INT NOT NULL DEFAULT 0,
+        [IDBook] INT NOT NULL DEFAULT 0
+    );
+GO
+
+-- Seed data for FableTest
+INSERT INTO FableTest (Title, Value) VALUES
+    ('The Hunger Games', 'Test Value 1'),
+    ('Harry Potter and the Philosopher''s Stone', 'Test Value 2'),
+    ('Twilight', 'Test Value 3'),
+    ('To Kill a Mockingbird', 'Test Value 4'),
+    ('The Great Gatsby', 'Test Value 5'),
+    ('The Fault in Our Stars', 'Test Value 6'),
+    ('The Hobbit', 'Test Value 7'),
+    ('The Catcher in the Rye', 'Test Value 8'),
+    ('Angels & Demons', 'Test Value 9'),
+    ('Pride and Prejudice', 'Test Value 10'),
+    ('The Kite Runner', 'Test Value 11'),
+    ('Divergent', 'Test Value 12');
+GO
+
+-- Seed data for Book
+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);
+GO

package/test/docker-init/init-db.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+/**
+ * Initialize the MSSQL test database from the host.
+ * Uses the mssql npm package to connect and run schema + seed SQL.
+ */
+const libMSSQL = require('mssql');
+const libFS = require('fs');
+const libPath = require('path');
+
+const MSSQL_CONFIG = {
+	server: '127.0.0.1',
+	port: 21433,
+	user: 'sa',
+	password: 'Retold1234567890!',
+	requestTimeout: 30000,
+	connectionTimeout: 10000,
+	options: {
+		trustServerCertificate: true
+	}
+};
+
+const MAX_CONNECT_RETRIES = 30;
+const RETRY_DELAY_MS = 3000;
+
+async function connectWithRetry(pConfig)
+{
+	for (let i = 1; i <= MAX_CONNECT_RETRIES; i++)
+	{
+		try
+		{
+			let tmpPool = await libMSSQL.connect(pConfig);
+			return tmpPool;
+		}
+		catch (pError)
+		{
+			if (i >= MAX_CONNECT_RETRIES)
+			{
+				throw pError;
+			}
+			console.log(`  Connection attempt ${i}/${MAX_CONNECT_RETRIES} failed, retrying in ${RETRY_DELAY_MS / 1000}s...`);
+			await new Promise((fResolve) => setTimeout(fResolve, RETRY_DELAY_MS));
+		}
+	}
+}
+
+async function run()
+{
+	let tmpPool;
+	try
+	{
+		// Connect to master to create the database
+		console.log('Connecting to MSSQL...');
+		tmpPool = await connectWithRetry(Object.assign({}, MSSQL_CONFIG, { database: 'master' }));
+		console.log('Connected to MSSQL.');
+
+		// Check if bookstore database already exists
+		let tmpResult = await tmpPool.query`SELECT name FROM sys.databases WHERE name = 'bookstore'`;
+		if (tmpResult.recordset.length > 0)
+		{
+			console.log('Database "bookstore" already exists, skipping initialization.');
+			await tmpPool.close();
+			process.exit(0);
+		}
+
+		// Read the SQL file and split on GO statements
+		let tmpSQLPath = libPath.join(__dirname, '01-schema.sql');
+		let tmpSQL = libFS.readFileSync(tmpSQLPath, 'utf8');
+
+		// Split on GO lines (MSSQL batch separator)
+		let tmpBatches = tmpSQL.split(/^\s*GO\s*$/mi).filter((pBatch) => pBatch.trim().length > 0);
+
+		console.log(`Running ${tmpBatches.length} SQL batches...`);
+		for (let i = 0; i < tmpBatches.length; i++)
+		{
+			let tmpBatch = tmpBatches[i].trim();
+			if (tmpBatch.length === 0)
+			{
+				continue;
+			}
+
+			// After CREATE DATABASE, reconnect to bookstore
+			if (tmpBatch.toUpperCase().indexOf('CREATE DATABASE') >= 0)
+			{
+				await tmpPool.query(tmpBatch);
+				console.log(`  Batch ${i + 1}: CREATE DATABASE bookstore`);
+				await tmpPool.close();
+				// Delay for database to be ready (especially under Rosetta emulation)
+				await new Promise((fResolve) => setTimeout(fResolve, 3000));
+				tmpPool = await connectWithRetry(Object.assign({}, MSSQL_CONFIG, { database: 'bookstore' }));
+				continue;
+			}
+
+			// Skip USE statements (we already connected to the right DB)
+			if (tmpBatch.toUpperCase().indexOf('USE BOOKSTORE') >= 0)
+			{
+				continue;
+			}
+
+			try
+			{
+				await tmpPool.query(tmpBatch);
+				console.log(`  Batch ${i + 1}: OK`);
+			}
+			catch (pError)
+			{
+				console.error(`  Batch ${i + 1}: ERROR - ${pError.message}`);
+				console.error(`  SQL: ${tmpBatch.substring(0, 100)}...`);
+			}
+		}
+
+		console.log('Database initialization complete.');
+	}
+	catch (pError)
+	{
+		console.error(`Fatal error: ${pError.message}`);
+		process.exit(1);
+	}
+	finally
+	{
+		if (tmpPool)
+		{
+			await tmpPool.close();
+		}
+	}
+}
+
+run();