@quenty/studio-bridge 0.21.1 → 0.22.0

package/templates/studio-bridge-plugin/src/Vendor/png.lua

@@ -529,7 +529,10 @@ local FIXED_LIT = {
 									-- assert table.insert(nil) is a no-op, the until
 									-- loop never reaches litsCount, and decoding spins
 									-- forever.
-									assert(litLength ~= nil, "deflate: code 16 cannot be the first dynamic Huffman symbol")
+									assert(
+										litLength ~= nil,
+										"deflate: code 16 cannot be the first dynamic Huffman symbol"
+									)
 									repeatCount = readBits(2) + 3
 								elseif code == 17 then
 									litLength = 0
@@ -552,7 +555,10 @@ local FIXED_LIT = {
 								if code <= 15 then
 									distLength = code
 								elseif code == 16 then
-									assert(distLength ~= nil, "deflate: code 16 cannot be the first dynamic Huffman symbol")
+									assert(
+										distLength ~= nil,
+										"deflate: code 16 cannot be the first dynamic Huffman symbol"
+									)
 									repeatCount = readBits(2) + 3
 								elseif code == 17 then
 									distLength = 0

package/test/default.project.json

@@ -0,0 +1,41 @@
+{
+  "name": "StudioBridgePluginTest",
+  "tree": {
+    "$className": "DataModel",
+    "ServerScriptService": {
+      "$properties": {
+        "LoadStringEnabled": true
+      },
+      "studiobridge": {
+        "$className": "Folder",
+        "jest.config": {
+          "$path": "jest.config.lua"
+        },
+        "Shared": {
+          "$path": "../templates/studio-bridge-plugin/src/Shared"
+        },
+        "commands": {
+          "$path": "../src/commands"
+        },
+        "node_modules": {
+          "$className": "Folder",
+          "@quenty": {
+            "$className": "Folder",
+            "nevermore-test-runner": {
+              "$path": "../node_modules/@quenty/nevermore-test-runner"
+            }
+          },
+          "@quentystudios": {
+            "$className": "Folder",
+            "Jest": {
+              "$path": "../node_modules/@quentystudios/jest-lua"
+            }
+          }
+        }
+      },
+      "Script": {
+        "$path": "scripts/Server"
+      }
+    }
+  }
+}

package/test/jest.config.lua

@@ -0,0 +1,3 @@
+return {
+	testMatch = { "**/*.spec" },
+}

package/test/scripts/Server/ServerMain.server.lua

@@ -0,0 +1,10 @@
+--!nonstrict
+local ServerScriptService = game:GetService("ServerScriptService")
+
+local root = ServerScriptService.studiobridge
+local loader = root:FindFirstChild("LoaderUtils", true).Parent
+local require = require(loader).bootstrapGame(root)
+
+local NevermoreTestRunnerUtils = require("NevermoreTestRunnerUtils")
+
+return NevermoreTestRunnerUtils.runTestsIfNeededAsync(root)

package/tsconfig.json

@@ -10,6 +10,7 @@
   "references": [
     { "path": "../cli-output-helpers" },
     { "path": "../nevermore-cli-helpers" },
+    { "path": "../nevermore-deploy" },
     { "path": "../nevermore-template-helpers" }
   ],
   "include": ["src/**/*", "test/**/*"]

package/templates/studio-bridge-plugin/src/Shared/Protocol.lua

@@ -1,132 +0,0 @@
---[[
-	Protocol module for encoding and decoding studio-bridge wire protocol messages.
-
-	This module is a pure serialization layer with no Roblox dependencies. It uses
-	Lune's serde library for JSON and is testable outside of Studio.
-
-	Wire protocol envelope (all messages):
-	  { type: string, sessionId: string, payload: object }
-
-	Extended fields (optional):
-	  { requestId?: string }
-]]
-
-local serde = require("@lune/serde")
-
-local Protocol = {}
-
--- ---------------------------------------------------------------------------
--- Known message types
--- ---------------------------------------------------------------------------
-
-local KNOWN_TYPES: { [string]: boolean } = {
-	-- Plugin -> Server
-	register = true,
-	scriptComplete = true,
-	stateResult = true,
-	screenshotResult = true,
-	dataModelResult = true,
-	logsResult = true,
-	stateChange = true,
-	heartbeat = true,
-	subscribeResult = true,
-	unsubscribeResult = true,
-
-	-- Server -> Plugin
-	execute = true,
-	shutdown = true,
-	queryState = true,
-	captureScreenshot = true,
-	queryDataModel = true,
-	queryLogs = true,
-	subscribe = true,
-	unsubscribe = true,
-
-	-- Bidirectional
-	error = true,
-}
-
--- ---------------------------------------------------------------------------
--- encode
--- ---------------------------------------------------------------------------
-
---[[
-	Encode a message table to a JSON string.
-
-	@param message - Table with required fields: type, sessionId, payload.
-	                 Optional fields: requestId.
-	@return JSON string representation of the message.
-]]
-function Protocol.encode(message: {
-	type: string,
-	sessionId: string,
-	payload: { [string]: any },
-	requestId: string?,
-}): string
-	local envelope: { [string]: any } = {
-		type = message.type,
-		sessionId = message.sessionId,
-		payload = message.payload,
-	}
-
-	if message.requestId ~= nil then
-		envelope.requestId = message.requestId
-	end
-
-	return serde.encode("json", envelope)
-end
-
--- ---------------------------------------------------------------------------
--- decode
--- ---------------------------------------------------------------------------
-
---[[
-	Decode a JSON string to a message table.
-
-	@param raw - JSON string to decode.
-	@return (message, nil) on success; (nil, errorString) on failure.
-]]
-function Protocol.decode(raw: string): ({ [string]: any }?, string?)
-	local ok, parsed = pcall(serde.decode, "json" :: any, raw)
-	if not ok then
-		return nil, "invalid JSON: " .. tostring(parsed)
-	end
-
-	if type(parsed) ~= "table" then
-		return nil, "expected JSON object, got " .. type(parsed)
-	end
-
-	-- Validate required fields
-	if type(parsed.type) ~= "string" then
-		return nil, "missing or invalid field: type"
-	end
-
-	if type(parsed.sessionId) ~= "string" then
-		return nil, "missing or invalid field: sessionId"
-	end
-
-	if type(parsed.payload) ~= "table" then
-		return nil, "missing or invalid field: payload"
-	end
-
-	-- Validate known message type
-	if not KNOWN_TYPES[parsed.type] then
-		return nil, "unknown message type: " .. parsed.type
-	end
-
-	-- Build result with required fields
-	local result: { [string]: any } = {
-		type = parsed.type,
-		sessionId = parsed.sessionId,
-		payload = parsed.payload,
-	}
-
-	-- Pass through optional fields when present
-	if type(parsed.requestId) == "string" then
-		result.requestId = parsed.requestId
-	end
-
-	return result, nil
-end
-
-return Protocol