@hyperframes/sdk 0.8.196 → 0.8.198

package/dist/session.js

@@ -28,8 +28,18 @@ import { createPersistQueue } from "./persist-queue.js";
 function escapeRegExp(s) {
     return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
+function isProduction() {
+    try {
+        return process.env.NODE_ENV === "production";
+    }
+    catch {
+        return false; // no process in a browser without a bundler define
+    }
+}
 class CompositionImpl {
-    parsed;
+    parsedDoc;
+    disposed = false;
+    warnedDisposedRead = false;
     persist;
     preview;
     /** Accumulated override-set — T3 embedded mode fold contract. */
@@ -63,7 +73,7 @@ class CompositionImpl {
     /** Override-set state at outermost batch entry — restored if the batch throws. */
     batchOverridesSnapshot = {};
     constructor(parsed, opts, baseVariableDefaults = {}) {
-        this.parsed = parsed;
+        this.parsedDoc = parsed;
         this.persist = opts.persist;
         this.preview = opts.preview;
         this.overrides = { ...(opts.overrides ?? {}) };
@@ -692,6 +702,18 @@ class CompositionImpl {
         this.changeHandlers.forEach((h) => h());
     }
     // ── Lifecycle ────────────────────────────────────────────────────────────────
+    /** The single read path; a read after dispose means a stale reference is still in use. */
+    get parsed() {
+        if (this.disposed)
+            this.warnDisposedRead();
+        return this.parsedDoc;
+    }
+    warnDisposedRead() {
+        if (this.warnedDisposedRead || isProduction())
+            return;
+        this.warnedDisposedRead = true;
+        console.warn(`[hyperframes] a disposed Composition was read and answered from an empty document; something still holds the stale session.\n${new Error().stack}`);
+    }
     async flush() {
         await this.persistQueueModule?.flush();
     }
@@ -707,6 +729,13 @@ class CompositionImpl {
         this.selectionHandlers = [];
         this.patchHandlers = [];
         this.errorHandlers = [];
+        // A disposed session is still referenced by stale closures; without this each
+        // one keeps its whole parsed document alive.
+        this.elementsCache = null;
+        this.rootsCache = null;
+        if (!this.disposed)
+            this.parsedDoc = parseMutable("");
+        this.disposed = true;
     }
 }
 /** Declared defaults across the composition's carriers, the root winning a shared id as in the runtime. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/sdk",
-  "version": "0.8.196",
+  "version": "0.8.198",
   "description": "Headless, framework-neutral HyperFrames composition editing engine",
   "repository": {
     "type": "git",
@@ -44,8 +44,8 @@
   },
   "dependencies": {
     "linkedom": "^0.18.12",
-    "@hyperframes/core": "0.8.196",
-    "@hyperframes/parsers": "0.8.196"
+    "@hyperframes/core": "0.8.198",
+    "@hyperframes/parsers": "0.8.198"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",