@aethervtt/shard-runtime 0.0.1 → 0.2.0

package/dist/write-check.js

@@ -0,0 +1,54 @@
+import { allResources, isPlainObject } from "@aethervtt/shard-core";
+const CHECK_MS = 1e3;
+function hashOf(value) {
+  if (!isPlainObject(value)) return void 0;
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return void 0;
+  }
+}
+class ResourceWriteCheck {
+  snapshots = /* @__PURE__ */ new Map();
+  timer;
+  world;
+  log;
+  quiet;
+  /** `quiet`: still idle with no frame requested, so a change nobody announced is a bug. */
+  constructor(world, log, quiet) {
+    this.world = world;
+    this.log = log;
+    this.quiet = quiet;
+  }
+  /** The app went idle: remember what the resources hold, and check them every second. */
+  start() {
+    this.snapshots.clear();
+    for (const def of allResources()) {
+      if (!def.hostWritable) continue;
+      const hash = hashOf(this.world.tryResource(def));
+      if (hash !== void 0) this.snapshots.set(def, hash);
+    }
+    this.timer ??= setInterval(() => this.verify(), CHECK_MS);
+  }
+  /** A frame is running (or the loop stopped): writes are fine again. */
+  stop() {
+    if (this.timer !== void 0) clearInterval(this.timer);
+    this.timer = void 0;
+  }
+  verify() {
+    if (!this.quiet()) return;
+    for (const [def, before] of this.snapshots) {
+      const now = hashOf(this.world.tryResource(def)) ?? "";
+      if (now === before) continue;
+      this.snapshots.set(def, now);
+      this.log?.log("warn", `Resource "${def.name}" changed without waking the app`, {
+        code: "runtime/unmarked-resource-write",
+        path: def.name,
+        hint: "Outside a frame, write resources with world.patchResource or world.touchResource (or call app.requestFrame())."
+      });
+    }
+  }
+}
+export {
+  ResourceWriteCheck
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aethervtt/shard-runtime",
-  "version": "0.0.1",
+  "version": "0.2.0",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,
@@ -8,6 +8,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "default": "./dist/testing.js"
     }
   },
   "files": [
@@ -16,7 +20,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@aethervtt/shard-core": "0.0.1"
+    "@aethervtt/shard-core": "0.2.0"
   },
   "repository": {
     "type": "git",
@@ -28,6 +32,6 @@
     "provenance": true
   },
   "shard": {
-    "buildSha": "d6c5c6aef4675575c878b02cf2c8f738b4190229"
+    "buildSha": "32c22a3944ed23f5d1baa90bf7cc9fae724f5fd8"
   }
 }