isaacscript-common 1.2.80 → 1.2.81

package/dist/features/saveDataManager/load.lua

@@ -3,8 +3,8 @@ local ____lualib = require("lualib_bundle")
 local __TS__StringTrim = ____lualib.__TS__StringTrim
 local ____exports = {}
 local readSaveDatFile, tryLoadModData, DEFAULT_MOD_DATA
-local ____json = require("functions.json")
-local jsonDecode = ____json.jsonDecode
+local ____jsonHelpers = require("functions.jsonHelpers")
+local jsonDecode = ____jsonHelpers.jsonDecode
 local ____log = require("functions.log")
 local log = ____log.log
 local ____debug = require("features.saveDataManager.debug")

package/dist/features/saveDataManager/save.lua

@@ -7,8 +7,8 @@ local getAllSaveDataToWriteToDisk
 local ____deepCopy = require("functions.deepCopy")
 local deepCopy = ____deepCopy.deepCopy
 local SerializationType = ____deepCopy.SerializationType
-local ____json = require("functions.json")
-local jsonEncode = ____json.jsonEncode
+local ____jsonHelpers = require("functions.jsonHelpers")
+local jsonEncode = ____jsonHelpers.jsonEncode
 local ____log = require("functions.log")
 local log = ____log.log
 function getAllSaveDataToWriteToDisk(self, saveDataMap, saveDataConditionalFuncMap)

package/dist/functions/jsonHelpers.d.ts

@@ -0,0 +1,16 @@
+/// <reference types="typescript-to-lua/language-extensions" />
+/**
+ * Converts a Lua table to a JSON string.
+ * In most cases, this function will be used for writing data to a "save#.dat" file.
+ * If encoding fails, it will throw an error to prevent writing a blank string or corrupted data to
+ * a user's "save#.dat" file.
+ */
+export declare function jsonEncode(table: unknown): string;
+/**
+ * Converts a JSON string to a Lua table.
+ * In most cases, this function will be used for reading data from a "save#.dat" file.
+ * If decoding fails, it will return a blank Lua table instead of throwing an error.
+ * (This allows execution to continue in cases where users have no current save data or have
+ * manually removed their existing save data.)
+ */
+export declare function jsonDecode(jsonString: string): LuaTable;

package/dist/functions/jsonHelpers.lua

@@ -0,0 +1,28 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+local tryEncode, tryDecode
+local json = require("@NoResolution:json")
+local ____log = require("functions.log")
+local log = ____log.log
+function tryEncode(____table)
+    return json.encode(____table)
+end
+function tryDecode(jsonString)
+    return json.decode(jsonString)
+end
+function ____exports.jsonEncode(self, ____table)
+    local ok, jsonStringOrErrMsg = pcall(tryEncode, ____table)
+    if not ok then
+        error("Failed to convert the Lua table to JSON: " .. jsonStringOrErrMsg)
+    end
+    return jsonStringOrErrMsg
+end
+function ____exports.jsonDecode(self, jsonString)
+    local ok, luaTableOrErrMsg = pcall(tryDecode, jsonString)
+    if not ok then
+        log("Failed to convert the JSON string to a Lua table: " .. jsonString)
+        return {}
+    end
+    return luaTableOrErrMsg
+end
+return ____exports

package/dist/index.d.ts

@@ -29,7 +29,7 @@ export * from "./functions/flying";
 export * from "./functions/globals";
 export * from "./functions/gridEntity";
 export * from "./functions/input";
-export * from "./functions/json";
+export * from "./functions/jsonHelpers";
 export * from "./functions/jsonRoom";
 export * from "./functions/language";
 export * from "./functions/log";

package/dist/index.lua

@@ -243,7 +243,7 @@ do
     end
 end
 do
-    local ____export = require("functions.json")
+    local ____export = require("functions.jsonHelpers")
     for ____exportKey, ____exportValue in pairs(____export) do
         if ____exportKey ~= "default" then
             ____exports[____exportKey] = ____exportValue

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.2.80",
+  "version": "1.2.81",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",