@quenty/nevermore-test-runner 1.0.1-canary.656.79f7d10.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## 1.0.1-canary.656.79f7d10.0 (2026-02-13)
+
+
+### Features
+
+* Add CI/CD batch unit testing ([016a366](https://github.com/Quenty/NevermoreEngine/commit/016a3663509c8fffa518b07cfc49ebecba2a1fa6))

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2014-2026 James Onnen (Quenty)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,23 @@
+## NevermoreTestRunner
+
+<div align="center">
+  <a href="http://quenty.github.io/NevermoreEngine/">
+    <img src="https://github.com/Quenty/NevermoreEngine/actions/workflows/docs.yml/badge.svg" alt="Documentation status" />
+  </a>
+  <a href="https://discord.gg/mhtGUS8">
+    <img src="https://img.shields.io/discord/385151591524597761?color=5865F2&label=discord&logo=discord&logoColor=white" alt="Discord" />
+  </a>
+  <a href="https://github.com/Quenty/NevermoreEngine/actions">
+    <img src="https://github.com/Quenty/NevermoreEngine/actions/workflows/build.yml/badge.svg" alt="Build and release status" />
+  </a>
+</div>
+
+Unified test runner service for Nevermore packages
+
+<div align="center"><a href="https://quenty.github.io/NevermoreEngine/api/NevermoreTestRunnerUtils">View docs →</a></div>
+
+## Installation
+
+```
+npm install @quenty/nevermoretestrunner --save
+```

package/default.project.json

@@ -0,0 +1,14 @@
+{
+  "name": "nevermore-test-runner",
+  "globIgnorePaths": [
+    "**/.package-lock.json",
+    "**/.pnpm",
+    "**/.pnpm-workspace-state-v1.json",
+    "**/.modules.yaml",
+    "**/.ignored",
+    "**/.ignored_*"
+  ],
+  "tree": {
+    "$path": "src"
+  }
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@quenty/nevermore-test-runner",
+  "version": "1.0.1-canary.656.79f7d10.0",
+  "description": "Unified test runner service for Nevermore packages",
+  "keywords": [
+    "Roblox",
+    "Nevermore",
+    "Lua",
+    "Testing"
+  ],
+  "bugs": {
+    "url": "https://github.com/Quenty/NevermoreEngine/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Quenty/NevermoreEngine.git",
+    "directory": "src/nevermore-test-runner/"
+  },
+  "funding": {
+    "type": "patreon",
+    "url": "https://www.patreon.com/quenty"
+  },
+  "license": "MIT",
+  "scripts": {
+    "preinstall": "npx only-allow pnpm"
+  },
+  "contributors": [
+    "Quenty"
+  ],
+  "dependencies": {
+    "@quenty/loader": "10.9.3",
+    "@quentystudios/jest-lua": "https://github.com/quentystudios/jest-lua.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "79f7d102f6f6406100008c84163d68b0a4e1b7c1"
+}

package/src/Server/NevermoreTestRunnerUtils.lua

@@ -0,0 +1,75 @@
+--!strict
+--[=[
+	@class NevermoreTestRunnerUtils
+
+	Unified test runner utilities for Nevermore packages.
+	Handles both smoke tests (game boot) and Jest unit tests.
+
+	- If a jest.config is found under the given root, runs Jest tests
+	- If no jest.config is found, boot success is the test (smoke test)
+	- Detects Open Cloud execution via OpenCloudService to control behavior
+]=]
+
+local require = require(script.Parent.loader).load(script)
+
+local Jest = (require :: any)("Jest")
+
+local NevermoreTestRunnerUtils = {}
+
+--[=[
+	Returns true if running inside an Open Cloud Luau Execution context.
+]=]
+function NevermoreTestRunnerUtils.isOpenCloud(): boolean
+	local success, _ = pcall(function()
+		return game:GetService("OpenCloudService")
+	end)
+
+	return success
+end
+
+--[=[
+	Runs Jest tests if a jest.config is found under root. Otherwise treats
+	boot success as the test (smoke test).
+
+	@param root -- The instance to scan for jest.config (e.g. the package folder in ServerScriptService)
+]=]
+function NevermoreTestRunnerUtils.runTestsIfNeededAsync(root: Instance)
+	assert(typeof(root) == "Instance", "Bad root")
+
+	local isOpenCloud = NevermoreTestRunnerUtils.isOpenCloud()
+
+	if isOpenCloud then
+		print("[NevermoreTestRunner] Running in Open Cloud execution context")
+	end
+
+	local config = root:FindFirstChild("jest.config", true)
+	if not config or not config.Parent then
+		print("[NevermoreTestRunner] No jest.config found — smoke test passed (boot success)")
+		return
+	end
+
+	local projectRoot = config.Parent
+	print("[NevermoreTestRunner] Running Jest tests from:", projectRoot:GetFullName())
+	local status, result = (Jest :: any)
+		.runCLI(projectRoot, {
+			verbose = true,
+			ci = true,
+		}, { projectRoot })
+		:awaitStatus()
+
+	if status == "Rejected" then
+		local message = "Jest run failed"
+		if typeof(result) == "table" and result.message then
+			message = result.message
+		elseif typeof(result) == "string" then
+			message = result
+		end
+		error("[NevermoreTestRunner] " .. message)
+	end
+
+	if typeof(result) == "table" and result.numFailedTests and result.numFailedTests > 0 then
+		error(string.format("[NevermoreTestRunner] %d test(s) failed", result.numFailedTests))
+	end
+end
+
+return NevermoreTestRunnerUtils

package/src/node_modules.project.json

@@ -0,0 +1,7 @@
+{
+  "name": "node_modules",
+  "globIgnorePaths": [ "**/.package-lock.json" ],
+  "tree": {
+    "$path": { "optional": "../node_modules" }
+  }
+}

package/test/default.project.json

@@ -0,0 +1,22 @@
+{
+  "name": "NevermoreTestRunnerTest",
+  "globIgnorePaths": [
+    "**/.package-lock.json",
+    "**/.pnpm",
+    "**/.pnpm-workspace-state-v1.json",
+    "**/.modules.yaml",
+    "**/.ignored",
+    "**/.ignored_*"
+  ],
+  "tree": {
+    "$className": "DataModel",
+    "ServerScriptService": {
+      "$properties": {
+        "LoadStringEnabled": true
+      },
+      "nevermore-test-runner": {
+        "$path": ".."
+      }
+    }
+  }
+}